客如云下发配送通知收费
(上行接口)合作方提供此接口,接受客如云商户下发配送的请求(一般是商户通过客如云开放平台对接的其他配送平台或商户自建配送平台)
请求描述
HTTP请求方式:POST
HTTP请求头类型:Content-Type=application/json
URI: 《第三方提供》
业务参数
参数名 |
类型 |
是否必填 |
参数描述 |
serialNumber |
String |
否 |
客如云流水号 |
shopIdenty |
Long |
是 |
客如云门店ID |
bizType |
Int |
是 |
配送业务类型:1餐饮配送,2电商配送,399其他,默认1 |
cityCode |
String |
否 |
商家所在城市区号,如北京010,成都028 |
orderId |
Long |
是 |
客如云订单编号 |
price |
Int |
是 |
订单金额,单位,分 |
isPaid |
Int |
是 |
是否已支付(1已支付,0未支付/货到付款) |
expectedTakeTime |
Long |
否 |
期望取货时间(时间戳,秒),为空则表示期望立即取餐 |
expectedDeliveredTime |
Long |
否 |
期望送达时间(时间戳,秒) ,为空则表示期望立即送达 |
consigneeName |
String |
是 |
收货人名称 |
consigneeSex |
Int |
是 |
收货人性别(1-先生,0-女士,-1未知) |
consigneePhone |
String |
是 |
收货人联系电话,若带有“_”则为收货人虚拟电话(隐私后的非真实电话) |
consigneeContact |
String |
否 |
收货人其他联系方式 |
consigneeAddr |
String |
是 |
收货人地址 |
addrLat |
String |
否 |
收货地址纬度 |
addrLng |
String |
否 |
收货地址经度 |
remark |
String |
否 |
订单备注 |
deliveryName |
String |
否 |
配送联系人姓名 |
deliveryPhone |
String |
否 |
配送联系人电话 |
请求示例代码
{
"shopId":247900001,
"bizType":1,
"cityCode":"028",
"orderId":"84578451814",
"price": 500,
"isPaid":1,
"expectedTakeTime":1481515932,
"expectedDeliveredTime":1481517612,
"consigneeName":"王语嫣",
"consigneeSex":0,
"consigneePhone":"12345678900",
"consigneeAddr":"世纪城世纪花园一栋一单元101号",
"addrLat":"30.554816",
"addrLng":"104.071722",
"pickupCode":"998877",
"remark":"快到小区门口时打电话通知"
}
响应参数
参数名 |
类型 |
是否必填 |
参数描述 |
code |
Int |
是 |
错误码;0:成功;其他详见错误码 |
message |
String |
是 |
错误说明 |
messageUuid |
String |
是 |
消息uuid |
result |
Object |
否 |
返回业务参数 code !=0的情况下不返回业务参数 |
result
参数名 |
类型 |
是否必填 |
参数描述 |
tpOrderId |
String |
是 |
第三方配送单号 |
orderId |
Long |
是 |
客如云订单编号 |
deliverFee |
Int |
否 |
配送费,分 |
discountFee |
Int |
否 |
配送优惠,分 |
actualFee |
Int |
否 |
实付配送费=配送费-配送优惠,分 |
响应示例代码
{
"code":0,
"message":"OK",
"messageUuid":"3337b6f6-9c95-4992-9fd7-dd7e1e1fc453",
"result":{
"tpOrderId":"23445666665",
"orderId":84578451814,
"deliverFee":500
}
}