运单转寄接口

注意:该接口只支持修改地址,最多只能修改一次,改收件人信息参考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 此件正常运输途中暂无法修改,请在到达下一环节后发起修改