运单转寄接口
注意:该接口只支持修改地址,最多只能修改一次,改收件人信息参考1.23运单改收件人信息接口基本信息
请求方式 | 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 |
收件省份 | receiverProvince | String | 否 | |
收件城市 | receiverCity | String | 否 | |
收件区县 | receiverDistrict | String | 否 | |
收件街道 | receiverTown | String | 否 | |
收件详细地址 | receiverDetailAddress | String | 是 |
出参
项目 | 名称 | 类型 | 必填 |
---|---|---|---|
成功标识 | success | boolean | 是 |
错误码 | errorCode | String | 否 |
错误说明 | errorMsg | String | 否 |
示例报文
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediStandardWaybillForward/api
请求: 仅供参考,实际测试账号需联系菜鸟速递开发提供
logistic_provider_id: edi_test_gongpei_json
data_digest: a4drgzJuYyrgFwY/BdWRWQ==
logistics_interface:
{
"mailNo": "TEST123456",
"receiverDistrict":"西湖区",
"receiverProvince":"浙江省",
"receiverCity":"杭州市",
"receiverDetailAddress":"西溪首座"
}
返回:
{
"success": true,
"errorCode": "",
"errorMsg": ""
}
修改地址失败错误码
注意:修改前后信息相同,会返回“SAME_ADDRESS”的错误码,不会返回成功
错误码 | 错误原因 |
---|---|
DISABLED | 当前转寄能力未开放,转寄失败 |
UN_ORDER_SERVICE | 您未订购转寄相关服务产品,转寄失败 |
ADDRESS_ILLEGAL | 您转寄的新地址无法识别,转寄失败 |
NO_ORDER | 该包裹还未接单,转寄失败 |
ADDRESS_ALREADY_MODIFIED | 该包裹已经成功发起过转寄,无法再次发起 |
INVERSE | 该包裹正在回退中,无法转寄 |
CANCELED | 该包裹已取消发货,无法转寄 |
INTERCEPTED | 该包裹正在回退中,无法转寄 |
SHIFTED | 该包裹目前不支持转寄,转寄失败 |
SIGNED | 该包裹已签收,转寄失败 |
REJECT | 该包裹已拒收,转寄失败 |
COLLECTED | 该包裹已代收,转寄失败 |
LOST | 该包裹已进入丢失认责阶段,转寄失败 |
CP_REJECT | 该包裹目前不支持转寄,转寄失败 |
NET_UNREACHABLE | 该地址暂未开通服务,转寄失败 |
SITE_ORDER_STATUS_ERROR | 包裹正在派送,转寄失败 |
2312 | 包裹正在派送,转寄失败 |
SAME_ADDRESS | 您的新地址与原地址相同,请检查后重试 |
NO_SITE_MATCH_THE_ADDRESS | 该地址超出派件站点派件范围 |
NO_ROUTE_PLAN | 此件正常运输途中暂无法修改,请在到达下一环节后发起修改 |