下单回调接口

二、下单回调接口

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

2.1 接口格式

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

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

2.2 请求地址

授权时贵司填入的callbackUrl

请求参数：

字段	类型	说明	备注
taskId	String	任务id
sign	String	签名	下单时填写了salt时会带sign md5(param+salt)
param	param	参数主体

param数据结构：

参数名	是否必填	类型	说明
kuaidicom	是	string	快递公司的编码，一律用小写字母，见《快递公司编码》,选填。
kuaidinum	是	string	快递单号，单号的最大长度是32个字符。
message	是	string	状态描述
orderId	是	string	平台订单ID
status	是	string	订单状态0-下单成功 1-已接单 10-已取货 13-已签收 9-用户主动取消 99-订单已取消
courierName	否	string	快递员姓名
courierMobile	否	string	快递员电话
weight	否	string	重量
freight	否	string	运费

2.3 返回结果

字段	说明	备注
result	提交结果	true提交成功，false失败
returnCode	返回编码
message	返回报文描述

2.4 提供数据内容

入参param例子

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

要求返回结果

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

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

字段名称	字段含义
result	true表示成功，false表示失败。如果提交回调接口的地址失败，30分钟后重新回调，3次仍旧失败的，自动放弃
returnCode	200: 提交成功 500: 服务器错误 其他错误请自行定义
message	返回的提示