下发订单拦截指令接口
注意:该接口只是用来下发拦截指令,实际能否拦截成功要看实操端,并不保证一定能拦截成功,只能在揽收后调用基本信息
请求方式 | Post application/x-www-form-urlencoded |
---|---|
功能描述 | 商家在包裹揽收后请求edi下发拦截指令 |
编码 | UTF-8 |
入参
项目 | 名称 | 类型 | 必填 | 描述 |
---|---|---|---|---|
对接码 | logistic_provider_id | String | 是 | 菜鸟侧提供 |
签名 | data_digest | String | 是 | Base64(Md5(logistics_interface+双方约定的secretKey)),0.2 签名方法 |
业务报文 | logistics_interface | String | 是 | JSON |
logistics_interface内容
项目 | 名称 | 类型 | 必填 | 描述 |
---|---|---|---|---|
运单号 | mailNo | String | 是 | 示例:20140804138802 |
扩展信息 | extendFields | List<ExtendField> | 是 | 参考扩展信息组件 |
需要的扩展信息
项目 | 扩展字段key | 必填 | 描述 | 备注 |
---|---|---|---|---|
指令类型 | intercept | 是 | 0-拦截 | |
拦截原因 | interceptReason | 否 | 文字形式描述 |
出参
项目 | 名称 | 类型 | 必填 |
---|---|---|---|
成功标识 | success | boolean | 是 |
错误码 | errorCode | String | 否 |
错误说明 | errorMsg | String | 否 |
示例报文
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediStandardOrderIntercept/ediStandardOrderIntercept/api
请求: 仅供参考,实际测试账号需联系菜鸟速递开发提供
logistic_provider_id: edi_test_gongpei_json
data_digest: a4drgzJuYyrgFwY/BdWRWQ==
logistics_interface:
{
"mailNo": "20140804138802",
"extendFields": [{
"key": "intercept",
"value": "0"
}]
}
返回:
{
"success": true,
"errorCode": "",
"errorMsg": ""
}