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

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

支持卖家发货后修改运单号;支持在线下单和自己联系两种发货方式;使用条件: 1、必须是已发货订单,自己联系发货的必须50天内才可修改;在线下单的,必须下单后物流公司未揽收成功前才可修改; 2、自己联系只能切换为自己联系的公司,在线下单也只能切换为在线下单的物流公司

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid String 必须 21234 订单id
sub_tids String 可选 1,2,3 拆单子订单列表,对应的数据是:子订单号列表。可以不传,但是如果传了则必须符合传递的规则。子订单必须是操作的物流订单的子订单的真子集
consign_pkgs TopConsignPkgRequest [] 必须
  • 最大列表长度:999
  • 包裹包含的运单号及快递公司编号,多包裹时,需要包含所有包裹的运单号等信息
    • └ company_code
    • String
    • 必须
    • POST
    • 物流公司代码.如"POST"代表中国邮政,"ZJS"代表宅急送。调用 taobao.logistics.companies.get 获取
    • └ out_sid
    • String
    • 必须
    • SF1234
    • 运单号.具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入
    feature String 可选 instantMobilePhoneNumber=12345678910 feature参数格式,KV之间用“=”分隔,多个key之间用”;”分隔 ,范例: instantMobilePhoneNumber=12345678910表示同城配送物流公司的物流订单收货人手机号,支持11位真实号和15位隐私号"12345678910-1234"

    响应参数

    名称 类型 示例值 描述
    result ResultDto 异步获取历史数据接口返回结果
    • └ success
    • Boolean
    • true
    • 执行结果

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAscpLogisticsConsignResendRequest req = new AlibabaAscpLogisticsConsignResendRequest();
    req.setTid("21234");
    req.setSubTids("1,2,3");
    List<AlibabaAscpLogisticsConsignResendRequest.TopConsignPkgRequest> list2 = new ArrayList<AlibabaAscpLogisticsConsignResendRequest.TopConsignPkgRequest>();
    AlibabaAscpLogisticsConsignResendRequest.TopConsignPkgRequest obj3 = new AlibabaAscpLogisticsConsignResendRequest.TopConsignPkgRequest();
    list2.add(obj3);
    obj3.setCompanyCode("POST");
    obj3.setOutSid("SF1234");
    req.setConsignPkgs(list2);
    req.setFeature("instantMobilePhoneNumber=12345678910");
    AlibabaAscpLogisticsConsignResendResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_ascp_logistics_consign_resend_response>
        <result>
            <success>true</success>
        </result>
    </alibaba_ascp_logistics_consign_resend_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>

    错误码解释

    错误码 错误描述 解决方案
    CONSIGN_RISK_CONTROL_BLOCK 运单号不符合规则或已经被使用 运单号不符合规则或已经被使用
    MODIFY_CP_FAIL_RETRY 订单已处于重新创建状态,请重新发货即可 订单已处于重新创建状态,请重新发货即可
    MODIFY_FORBIDDEN_BY_LOGISTYPE 不支持的订单类型 不支持的订单类型
    CONSIGN_GOODS_TOTAL_NUM_INVALID 商品种数不合法 商品种数不合法
    MODIFY_FORBIDDEN_BY_ORDERSTATUS 当前订单状态不支持修改 当前订单状态不支持修改
    CONSIGN_FUZZY_QUERY_ORDER_ERROR 查询物流订单失败 查询物流订单失败
    CONSIGN_FAIL 发货系统出现异常,请稍后重试 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    CONSIGN_CAN_NOT_CONFIRM_OPERATE_ORDER 子订单号没有精确匹配 子订单号没有精确匹配
    CONSIGN_LC_CANCLE_ORDER_ERROR 调系统取消订单时出现失败 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    B105 该物流公司不支持这种服务 该物流公司不支持这种服务
    UPDATE_LOGISTIC_STATUS_ERROR 更新物流信息错误 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    OFFLINE_COMPANY_CODE 信息错误,如companycode信息包含中文等,请核实后重新填写。 信息错误,如companycode信息包含中文等,请核实后重新填写。
    CONSIGN_TMS_SEND_UPDATE_ORDER_INSTRUCTION_FAIL 下发更新订单指令给系统失败 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    CONSIGN_QUERY_ORDER_ERROR 获取物流订单数据失败 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    MODIFY_MAILNO_FORBIDDEN_BY_ALLOW_TIMES 运单号修改次数超过允许修改次数 运单号修改次数超过允许修改次数
    PACKAGE_SIZE_NO_EQUALS_REQUEST_MAIL_SIZE 包裹的数量与传入的运单号的数量不一致 包裹的数量与传入的运单号的数量不一致
    B143 无效的联系人,请检查发货人相关信息,如手机号码,电话等 无效的联系人,请检查发货人相关信息,如手机号码,电话等
    SYS_ERROR 系统异常,请稍后重试 系统异常,请稍后重试
    MAIL_NO_NOT_ALLOW_EMPTY 运单号不能为空 运单号不能为空
    MODIFY_CP_FORBIDDEN 禁止修改运单信息 禁止修改运单信息
    LC_CONCURRENT_MODIFY_FAIL 当前订单有其他业务在修改,请稍后重试 当前订单有其他业务在修改,请稍后重试
    LAZADA_NOT_ALLOW_MODIFY 当前订单不支持修改运单号 当前订单不支持修改运单号
    LOC_PACKAGE_QUERY_ERROR 查询包裹信息异常,请稍后重试 查询包裹信息异常,请稍后重试
    OTHER_CONSIGN_FAIL 系统异常,请稍后重试 系统异常,请稍后重试
    CONSIGN_NOT_ORDERED_BIG_FOOD_SJZP_SERVICE 您未订购大食品商家自配服务,不能使用此配送公司发货,查看服务详情 您未订购大食品商家自配服务,不能使用此配送公司发货,查看服务详情
    OFFLINE_OTHER 为了保障消费者及时便捷地查询商品物流信息,平台正在规范商家销售及发货流程,无法选择【其他】物流公司发货,避免商家因无物流数据产生消费者咨询/订单退款/平台处罚等问题。 为了保障消费者及时便捷地查询商品物流信息,平台正在规范商家销售及发货流程,无法选择【其他】物流公司发货,避免商家因无物流数据产生消费者咨询/订单退款/平台处罚等问题。
    CONSIGN_TMS_SEND_UPDATE_ORDER_INSTRUCTION_EXCEPTION TMS下发更新订单指令给CP异常 TMS下发更新订单指令给CP异常

    API工具

    如何获得此API

    FAQ

    返回
    顶部