注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 淘宝物流API

alibaba.ascp.logistics.consign.modify (修改物流公司和运单号)

修改物流公司和运单号

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid String 必须 21234 订单id
old_company_code String 可选 POST 原物流公司代码.如"POST"代表中国邮政,"ZJS"代表宅急送。调用 taobao.logistics.companies.get 获取
old_out_sid String 必须 POST1234 原运单号.具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入
new_company_code String 可选 SF 新物流公司代码.如"POST"代表中国邮政,"ZJS"代表宅急送。调用 taobao.logistics.companies.get 获取
new_out_sid String 必须 SF1234 新运单号.具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入
goods TopConsignGoodsRequest 可选 原包裹中的商品信息
  • └ sub_tid
  • String
  • 可选
  • 21234
  • 子订单id
  • └ item_type
  • Number
  • 可选
  • 0
  • 商品类型 0:普通品 1:赠品 2:成分品,默认0
  • └ comp_item_id
  • String
  • 可选
  • 100001
  • 成分品itemId
  • └ comp_sku_id
  • String
  • 可选
  • 100002
  • 成分品skuId
feature String 可选 instantMobilePhoneNumber=12345678910 feature参数格式,KV之间用“=”分隔,多个key之间用”;”分隔 ,范例: instantMobilePhoneNumber=12345678910表示同城配送物流公司的物流订单收货人手机号,支持11位真实号和15位隐私号"12345678910-1234"。

响应参数

名称 类型 示例值 描述
result ResultDTO 异步获取历史数据接口返回结果
  • └ success
  • Boolean
  • true
  • 执行结果
  • └ message
  • String
  • 修改运单号成功,xxx
  • 修改运单号成功的提示文案

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpLogisticsConsignModifyRequest req = new AlibabaAscpLogisticsConsignModifyRequest();
req.setTid("21234");
req.setOldCompanyCode("POST");
req.setOldOutSid("POST1234");
req.setNewCompanyCode("SF");
req.setNewOutSid("SF1234");
AlibabaAscpLogisticsConsignModifyRequest.TopConsignGoodsRequest obj1 = new AlibabaAscpLogisticsConsignModifyRequest.TopConsignGoodsRequest();
obj1.setSubTid("21234");
obj1.setItemType(0L);
obj1.setCompItemId("100001");
obj1.setCompSkuId("100002");
req.setGoods(obj1);
req.setFeature("instantMobilePhoneNumber=12345678910");
AlibabaAscpLogisticsConsignModifyResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ascp_logistics_consign_modify_response>
    <result>
        <success>true</success>
        <message>修改运单号成功,xxx</message>
    </result>
</alibaba_ascp_logistics_consign_modify_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
MODIFY_FORBIDDEN_BY_LOGISTYPE 不支持的订单类型 该订单类型不支持修改
MODIFY_FORBIDDEN_BY_BEYOND_DEADLINE 距最近一次修改已超过50天,禁止继续修改 距最近一次修改已超过50天,禁止继续修改
MODIFY_CP_FAIL_RETRY 订单已处于重新创建状态,请重新发货即可 重新发货即可
CONSIGN_RISK_CONTROL_BLOCK 风控拦截 更换快递公司和运单号
MAIL_NO_NOT_ALLOW_DUPLICATE 运单号重复发货 请更换运单号

API工具

如何获得此API

FAQ

返回
顶部