同城配送下单技术文档

一、同城配送下单

选择快递公司进行下单。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

https://order.kuaidi100.com/sameCity/order

请求参数：

param数据结构：

goods数据结构：

1.3 返回结果

data数据结构

1.4 提供数据内容

请求参数示例

method = order
key = *******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1470304729724
param = {
 	"com": "kfw",
 	"recManName": "测试",
 	"recManMobile": "13800138000",
 	"recManPrintAddr": "深圳市南山区伟易达大夏",
 	"sendManName": "小张",
 	"sendManMobile": "13800138000",
 	"sendManPrintAddr": "深圳市南山区高新南地铁站b口",
 	"serviceType": "火锅",
 	"weight": 1.00,
  	"remark": "测试订单，待会取消",
 	"salt": "123",
 	"callBackUrl": "http://www.baiud.com",
 	"pickupTime": "",
 	"orderSourceNo": "168168168",
 	"orderSourceType": "美团",
 	"storeId": "106396",
 	"additionFee": 1000,
 	"partnerId": "155555555",
 	"partnerKey": "1111111111"
}

​

返回结果示例

{
    "returnCode": "200",
    "result": true,
    "message": "提交成功",
    "data": {
        "taskId": "13F873760DCB4CF28D666A13FDE6B31A",
        "com": "kfw",
        "orderId": "1000090",
        "fee": 5000,
        "distance": 1000,
        "kuaidiNum": "KFWZS1476131277"
    }
} 

1.5 信息代码含义

二、下单回调接口

订单有状态变更是会触发回调，回调后如果没有得到合作方正确返回，会重复回调多2次，即最多回调3次。间隔30分钟。

2.1 接口格式

提供统一格式的HTTP POST,并返回统一格式JSON数据。

请求报头：Content-Type=application/x-www-form-urlencoded;charset=UTF-8

2.2 请求地址

授权时贵司填入的callbackUrl

请求参数：

param数据结构：

2.3 返回结果

2.4 提供数据内容

入参param例子

{
    "courierMobile": "13800138000",
    "courierName": "G师傅",
    "kuaidiCom": "kfw",
    "kuaidiNum": "KFWZS1476130507",
    "message": "订单已取消",
    "orderId": "1000086",
    "status": 99
}

要求返回结果

{
    "returnCode": "200",
    "result": true,
    "message": "成功"
}

2.4 推送响应报文及错误码解释