• 开发者平台
  • >
  • 餐饮文档中心

客如云下发配送通知收费

(上行接口)合作方提供此接口,接受客如云商户下发配送的请求(一般是商户通过客如云开放平台对接的其他配送平台或商户自建配送平台)

授权方式:门店授权

请求描述

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 客如云订单ID(与外卖下单接口中的tradeid一致)
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
     }
}
目录