运单修改收件人信息接口
注意:该接口只支持修改收件人信息,最多只能修改一次,改地址参考1.22运单改地址信息接口基本信息
请求方式 | 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 |
收件人姓名 | receiverName | String | 是 | |
收件手机 | receiverMobile | String | 是 |
出参
项目 | 名称 | 类型 | 必填 |
---|---|---|---|
成功标识 | success | boolean | 是 |
错误码 | errorCode | String | 否 |
错误说明 | errorMsg | String | 否 |
示例报文
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediStandardWaybillModifyReceiver/api
请求: 仅供参考,实际测试账号需联系菜鸟速递开发提供
logistic_provider_id: edi_test_gongpei_json
data_digest: a4drgzJuYyrgFwY/BdWRWQ==
logistics_interface:
{
"mailNo": "TEST12345",
"receiverName":"测试",
"receiverMobile":"13333333333"
}
返回:
{
"success": true,
"errorCode": "",
"errorMsg": ""
}
修改收件人信息失败错误码
注意:修改前后信息相同,会返回“SAME_RECIPIENT”的错误码,不会返回成功
错误码 | 错误原因 |
---|---|
PARAM_ILLEGAL | 您填写的收件人姓名或者电话信息有误,本次修改失败,请检查后重试 |
NO_ORDER | 该包裹还未接单,修改收件人信息失败 |
RECIPIENT_ALREADY_MODIFIED | 该包裹已经成功修改过收件人信息,无法再次发起 |
INVERSE | 该包裹正在回退中,修改收件人信息失败 |
CANCELED | 该包裹已取消,修改收件人信息失败 |
INTERCEPTED | 该包裹正在回退中,修改收件人信息失败 |
SHIFTED | 该包裹目前不支持转寄,修改收件人信息失败 |
SITE_ORDER_STATUS_ERROR/ORDER_PICKED | 包裹正在派送,修改收件人信息失败 |
SIGNED | 该包裹已签收,修改收件人信息失败 |
REJECT | 该包裹已拒收,修改收件人信息失败 |
COLLECTED | 该包裹已代收,修改收件人信息失败 |
LOST | 该包裹已进入丢失认责阶段,修改收件人信息失败 |
CP_REJECT | 该包裹目前不支持修改收件人信息 |
SAME_RECIPIENT | 您修改后的收件人信息与原收件人信息相同,请检查后重试 |