商家自配送状态推送

(下行接口)第三方合作方调用此接口，推送配送状态给客如云

取消原因

取消原因编码	取消原因
1	配送员取消
2	配送员接单超时(无人接单)
3	商户取消
4	客服取消
99	系统取消(未完成订单状态持续超过24小时)

curl --location --request POST 'https://gldopenapi.keruyun.com/open/v1/delivery/status/push?appKey=&shopIdenty=&brandId=&version=&timestamp=&sign=' \ --header 'Content-Type: application/json' \ --data-raw '{ "bizType": 1, "orderId":"f14cfdb04119451998200d1a83f785da", "tpOrderId":"123433456345234567890456789067", "deliveryStatus":4 }'

请求参数

Query 参数

appKey

string

必需

开发者申请服务客如云分配的appKey

默认值:

shopIdenty

string

必需

客如云门店id （门店维度接口传递门店ID）

默认值:

brandId

string

必需

客如云品牌id（品牌授权的接口传递品牌ID）

默认值:

version

string

必需

版本,默认2.0（1.0版本仍可用）

默认值:

2.0

timestamp

string

必需

时间戳,单位:秒,时间戳校验签名,开放平台校验签名时用此参数和服务器当前时间戳对比不能大于300秒，我方服务器使用阿里云授时中心

默认值:

sign

string

必需

签名，64位长度的字符串，获取规则详见签名规则

默认值:

Body 参数application/json

bizType

integer

必需

配送业务类型:1餐饮配送，2电商配送，399其他

orderId

string

必需

客如云配送订单ID（与外卖下单接口返回的tradeid一致）

tpOrderId

string

第三方配送订单号

必需

deliveryStatus

integer

必需

配送状态：1待处理,2已接单/待取餐,3配送中，4已送达,5已取消

delivererId

string

配送员Id

可选

deliverer

string

配送员姓名

可选

delivererPhone

string

配送员电话

可选

cancelCode

string

可选

取消原因编码,取消时须传

cancelReason

string

可选

取消原因,取消时须传

示例

application/json

Body

code

integer

必需

错误码；0：成功；其他详见错误码

message

string

错误说明

必需

messageUuid

string

消息uuid

必需

商家自配送状态推送

请求参数

返回响应