订单状态及骑手/司机变更回调API-开发文档-美团青云聚信

订单状态及骑手/司机变更回调

方向：配送商系统→青云聚信系统

接口：/api/delivery/statusCallback

用途：面对以下三种场景，配送商系统均需要通过该接口回调青云聚信系统：（1）状态发生变更；（2）状态不变更，但骑手信息发生变更；（3）状态不变更，但费用信息发生变更。如果回调失败，需要配送商进行重试。

注意：
1.从青云发起的授权请求，回调时间间隔不能超过1小时。
2. 由于商流平台有管控规则，配送信息回传不完整将严重影响商家体验，请确保建设在响应失败场景下的重试机制。
3. 当费用信息发生变更时，每次回调把历史费用变更都传给青云。

请求参数：

字段	描述	是否必填	类型	规则
orderId	青云聚信平台订单号	是	string	长度为18-45个字符。可作为唯一识别单号，建议配送商作为商家订单号使用。
carrierDeliveryId	配送商物流单号	是	string	配送商接单成功后返回的物流单号
status	状态	是	int	详细枚举见附录-配送商订单状态Code
riderName	骑手/司机姓名	否	string	可以是隐藏部分文字的骑手姓名。
riderPhone	骑手/司机手机号	否	string	若使用隐私号，须确保商家和收件人在配送完成后48小时内均可通过该电话联系上骑手。
riderPhoneType	骑手/司机电话类型	否	int	0：真实号 1：隐私号
riderPhoneExpireTime	骑手隐私号失效时间	否	int	隐私号距离完成单号失效时间，单位：秒骑手/司机的电话类型是隐私号时，该字段必填
riderLng	骑手/司机经度	否	int	火星坐标，坐标 * （10的六次方），如 116398419
riderLat	骑手/司机纬度	否	int	火星坐标，坐标 * （10的六次方），如 39985005
operateTime	状态变更时间	是	long	时间戳，格式为long，时区为GMT+8，即距离Epoch（1970年1月1日) 以秒计算的时间（unix-timestamp）。
cancelReasonCode	取消原因code	否	int	如果订单为取消状态则必填，见附录-取消原因Code
cancelReasonDesc	订单取消原因描述	否	string	如果订单为取消状态则必填，最长不超过200个字符
cancelFee	取消扣费	否	double	如果未产生费用则传入0
licensePlate	车牌号	否	string	汽车配送必传。含有字母和数字的标识，用于唯一标识一辆车的编号
orderImages	取货、送达照片列表	否	map	订单详情的Map信息，key是业务场景，value是照片的URL组合的List 图片最多不超过5张上传图片参考：上传图片接口
-key	业务场景， pickup：取件; arrived：送达	否	string	上传图片需先通过美团的上传图片接口上报图片信息，然后把每张图片的唯一标示放入该数组中，传递给青云
-value	照片的URL组合的List	否	list	上传图片需先通过美团的上传图片接口上报图片信息，然后把每张图片的唯一标示放入该数组中，传递给青云
actualFee	实际支付金额	否	double	实际支付金额（单位：元）实际支付金额=配送费+保价费+小费金额+过路费+搬运费+等候费+停车费+其他费用-优惠金额
tollFee	过路费，包括高速费、过桥费等	否	double	单位：元
handlingFee	搬运费	否	double	单位：元
waitingFee	等候费	否	double	单位：元
parkingFee	停车费	否	double	单位：元
otherCharges	其他费用	否	map	其他费用的Map信息，key是费用名称，value是具体费用（单位：元）其他费用最多不超过5个
-key	费用名称	否	string
-value	具体费用	否	double

返回参数：

字段	描述	是否必填	类型	示例值	规则
code	结果code	是	int	0	0：成功。非0：失败，详情查看message字段详细枚举见附录-接口返回结果Code
message	失败的描述信息	是	string	成功
data	结果	否		/

联络我们