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

alibaba.ascp.logistics.offline.send (自己联系物流发货)

用户调用该接口可实现自己联系发货,使用该接口发货,交易订单状态会直接变成卖家已发货

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sender_id Number 可选 123456 卖家联系人地址库ID,可以通过taobao.logistics.address.search接口查询到地址库ID。如果为空,取的卖家的默认取货地址
feature String 可选 identCode=tid:aaa,bbb;machineCode=tid2:aaa;retailStoreId=12345;retailStoreType=STORE;instantMobilePhoneNumber=12345678910 feature参数格式 范例: identCode=tid1:识别码1,识别码2|tid2:识别码3;machineCode=tid3:3C机器号A,3C机器号B identCode为识别码的KEY,machineCode为3C的KEY,多个key之间用”;”分隔 “tid1:识别码1,识别码2|tid2:识别码3”为identCode对应的value。 "|"不同商品间的分隔符。 例1商品和2商品,之间就用"|"分开。 TID就是商品代表的子订单号,对应taobao.trade.fullinfo.get 接口获得的oid字段。(通过OID可以唯一定位到当前商品上) ":"TID和具体传入参数间的分隔符。冒号前表示TID,之后代表该商品的参数属性。 "," 属性间分隔符。(对应商品数量,当存在一个商品的数量超过1个时,用逗号分开)。 具体:当订单中A商品的数量为2个,其中手机串号分别为"12345","67890"。 参数格式:identCode=TIDA:12345,67890。 TIDA对应了A宝贝,冒号后用逗号分隔的"12345","67890".说明本订单A宝贝的数量为2,值分别为"12345","67890"。 当存在"|"时,就说明订单中存在多个商品,商品间用"|"分隔了开来。|"之后的内容含义同上。retailStoreId=12345,发货门店ID或仓信息。retailStoreType=STORE: 发货门店类别,STORE表示门店,WAREHOUSE表示电商仓。对于全渠道订单回传的商家,retailStoreId和retailStoreType字段为必填字段。instantMobilePhoneNumber表示同城配送物流公司的物流订单收货人手机号,支持11位真实号和15位隐私号"12345678910-1234"。
tid String 必须 123 淘宝交易ID
sub_tid String 可选 1,2,3
  • 最大长度:1000
  • 发货的子订单id列表(consign_type = 1、2、3 时不再使用次字段,使用新字段goods代替需要发货的子订单信息)
    consign_pkgs TopConsignPkgRequest [] 可选
  • 最大列表长度:999
  • 包裹信息
    • └ out_sid
    • String
    • 可选
    • 123455
    • 运单号.具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入
    • └ company_code
    • String
    • 可选
    • POST
    • 物流公司代码.如"POST"就代表中国邮政,"ZJS"就代表宅急送.调用 taobao.logistics.companies.get 获取
    • goods
    • TopConsignGoodsRequest []
    • 可选
    • 包裹中商品信息
    • 包裹中商品信息
    • └ sub_tid
    • String
    • 可选
    • 11111
    • 子订单id
    • └ comp_item_id
    • String
    • 可选
    • 100001
    • 成分品itemId
    • └ comp_sku_id
    • String
    • 可选
    • 100002
    • 成分品skuId
    • └ item_type
    • Number
    • 可选
    • 0
    • 品类型 0:标品/平台赠品,1:ERP线下赠品、2:成分品,默认为0
    • └ num
    • Number
    • 可选
    • 1
    • 商品数量,不传默认为子单上的商品数量;支持不传,但不能传0或负值
    • └ sub_out_sid
    • String
    • 可选
    • 11112
    • 快递子单运单号
    cancel_id Number 可选 123456 卖家联系人地址库ID,可以通过taobao.logistics.address.search接口查询到地址库ID。 如果为空,取的卖家的默认退货地址
    consign_status ConsignStatusRequest 可选 子订单发货状态
    • └ sub_tid
    • String
    • 可选
    • 12345678
    • 子订单id(组合品不需要传系统会自动计算)
    • └ is_part_consign
    • Boolean
    • 可选
    • true
    • 子订单是否部分发货,true:部分发货;false:全部发货;周期购、分销订单不支持部分发货
    consign_type Number 可选 1 发货类型 0:普通发货(老链路) 1: 普通发货(新链路,支持子订单部分发货、成分品发货以及ERP线下赠品发货) 2: 将发货状态从"部分发"修改为"全部发" 3:补发;默认为0

    响应参数

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

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAscpLogisticsOfflineSendRequest req = new AlibabaAscpLogisticsOfflineSendRequest();
    req.setSenderId(123456L);
    req.setFeature("identCode=tid:aaa,bbb;machineCode=tid2:aaa;retailStoreId=12345;retailStoreType=STORE;instantMobilePhoneNumber=12345678910");
    req.setTid("123");
    req.setSubTid("1,2,3");
    List<AlibabaAscpLogisticsOfflineSendRequest.TopConsignPkgRequest> list2 = new ArrayList<AlibabaAscpLogisticsOfflineSendRequest.TopConsignPkgRequest>();
    AlibabaAscpLogisticsOfflineSendRequest.TopConsignPkgRequest obj3 = new AlibabaAscpLogisticsOfflineSendRequest.TopConsignPkgRequest();
    list2.add(obj3);
    obj3.setOutSid("123455");
    obj3.setCompanyCode("POST");
    List<AlibabaAscpLogisticsOfflineSendRequest.TopConsignGoodsRequest> list6 = new ArrayList<AlibabaAscpLogisticsOfflineSendRequest.TopConsignGoodsRequest>();
    AlibabaAscpLogisticsOfflineSendRequest.TopConsignGoodsRequest obj7 = new AlibabaAscpLogisticsOfflineSendRequest.TopConsignGoodsRequest();
    list6.add(obj7);
    obj7.setSubTid("11111");
    obj7.setCompItemId("100001");
    obj7.setCompSkuId("100002");
    obj7.setItemType(0L);
    obj7.setNum(1L);
    list4.setGoods(list6);
    obj3.setSubOutSid("11112");
    req.setConsignPkgs(list2);
    req.setCancelId(123456L);
    AlibabaAscpLogisticsOfflineSendRequest.ConsignStatusRequest obj8 = new AlibabaAscpLogisticsOfflineSendRequest.ConsignStatusRequest();
    obj8.setSubTid("12345678");
    obj8.setIsPartConsign(true);
    req.setConsignStatus(obj8);
    req.setConsignType(1L);
    AlibabaAscpLogisticsOfflineSendResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

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

    错误码解释

    错误码 错误描述 解决方案
    B01 不能进行操作,当前状态:等待确认 不能进行操作,当前状态:等待确认
    CD01 系统错误 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    B60 运单号不符合规则或已经被使用 运单号不符合规则或已经被使用
    B150 发货异常,发货请求存在并发情况,请稍后重试 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    CONSIGN_RISK_CONTROL_BLOCK 运单号不符合规则或已经被使用 运单号不符合规则或已经被使用
    CD06 推荐物流的订单状态为关闭状态,无需发货处理 推荐物流的订单状态为关闭状态,无需发货处理
    CD72 运单号为空 运单号为空
    BN02 为了保障消费者及时便捷地查询商品物流信息,平台正在规范商家销售及发货流程,无法选择【其他】物流公司发货,避免商家因无物流数据产生消费者咨询/订单退款/平台处罚等问题。 为了保障消费者及时便捷地查询商品物流信息,平台正在规范商家销售及发货流程,无法选择【其他】物流公司发货,避免商家因无物流数据产生消费者咨询/订单退款/平台处罚等问题。
    B98 订单已存在 订单已存在
    CONSIGN_FUZZY_QUERY_SUB_ORDER_MATCH_NO 物流订单子交易ID匹配不上,请检查子交易ID传的是否正确 物流订单子交易ID匹配不上,请检查子交易ID传的是否正确
    B143 无效的联系人,请检查发货人相关信息,如手机号码,电话等 无效的联系人,请检查发货人相关信息,如手机号码,电话等
    CONSIGN_ORDER_HAS_FORBID_KEY 订单上有禁止发货标记 订单上有禁止发货标记
    CD08 无效的联系人,请检查发货人相关信息,如手机号码,电话等 无效的联系人,请检查发货人相关信息,如手机号码,电话等
    CONSIGN_FUZZY_QUERY_ORDER_ERROR 查询订单系统出现异常,请重试 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    CD69 该物流公司不支持这种服务 该物流公司不支持这种服务
    OFFLINE_COMPANY_CODE 信息错误,如companycode信息包含中文等,请核实后重新填写。 信息错误,如companycode信息包含中文等,请核实后重新填写。
    B05 拆单失败 拆单失败
    CD04 没有权限进行发货 没有权限进行发货,请确认物流订单状态
    CONSIGN_FAIL 发货系统出现异常,请稍后重试 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    BN03 信息错误,如companycode信息包含中文等,请核实后重新填写。 信息错误,如companycode信息包含中文等,请核实后重新填写。
    CD68 该物流单号为无法识别或快递公司未同平台对接 该物流单号为无法识别或快递公司未同平台对接
    AT0112 推荐物流的订单状态为关闭状态,无需发货处理 推荐物流的订单状态为关闭状态,无需发货处理
    SYSTEM_ERROR 系统错误 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    OTHER_CONSIGN_FAIL 发货失败 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    CONSIGN_LC_SPLIT_ORDER_FAIL 系统拆单失败 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    CD17 拆单校验未通过 拆单校验未通过
    MAIL_NO_NOT_ALLOW_EMPTY 运单号不能为空 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    CONSIGN_ACTION_SELECT_CONSIGN_ORDER_UNFIND_CONSIGN_ORDER 选择发货物流订单时,不能找到可以发货的订单 选择发货物流订单时,不能找到可以发货的订单
    DCP_ESB_SERVICE_NOT_SUB 对不起,您尚未成功订购E速宝物流服务 对不起,您尚未成功订购E速宝物流服务
    CONSIGN_QUERY_ORDER_ERROR 获取物流订单数据失败 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    AT0011 物流订单状态不为新建状态,无需发货处理 物流订单状态不为新建状态,无需发货处理
    B105 该物流公司不支持这种服务 该物流公司不支持这种服务
    CD28 收货人市信息不能为空 收货人市信息不能为空
    MAIL_NO_HAS_EXIST 请求数据有相同的运单号,请重新确认 请求数据有相同的运单号,请重新确认
    OFFLINE_OTHER 为了保障消费者及时便捷地查询商品物流信息,平台正在规范商家销售及发货流程,无法选择【其他】物流公司发货,避免商家因无物流数据产生消费者咨询/订单退款/平台处罚等问题。 为了保障消费者及时便捷地查询商品物流信息,平台正在规范商家销售及发货流程,无法选择【其他】物流公司发货,避免商家因无物流数据产生消费者咨询/订单退款/平台处罚等问题。
    CD24 订单空校验,全量订单的订单商品列表为空 订单空校验,全量订单的订单商品列表为空
    CONSIGN_SDC_RESULT_IS_FAIL 调用系统失败 如果长时间一直出现,请联系平台技术,并提供api请求的requestId
    PACKAGE_MAIL_NO_NOT_ALLOW_SAME 多包裹不允许同一交易单含有相同运单号 查看该交易单已发或者正在发的运单号,取消相同的运单号
    CONSIGN_LC_QUERY_SELLER_CONTACT_FROM_TAIR_EXP 查卖家地址时出现异常 请稍后重试
    CD74 未找到该淘系订单 查看传入的交易单是否正确
    CD11 系统错误,获取物流订单数据失败 请稍后重试
    LOC_PACKAGE_ADD_ERROR 添加包裹信息异常 添加包裹信息异常
    CD07 物流订单状态不为新建状态,无需发货处理 物流订单状态不为新建状态,无需发货处理
    CONSIGN_ACTION_TAO_ORDER_VALIDATION_CHECKER_OUT_TRADE_NO_NOT_NUMBER 淘系订单号必须为数字 重新确认下交易单号,淘系的订单号必须为数字,不包含字符
    PKG_NO_GOODS 商品未勾选,不能发货 包裹信息中没有传快递公司或者运单号
    B02 没有权限进行发货 确认是否有权限对该订单进行操作
    RESOURCE_CODE_EMPTY 快递公司不能为空 确认是否录入了快递公司信息
    CONSIGN_CONCURRENT_LOCK_ERROR 不支持主订单下的多个子订单同时发货,请按子订单分批重试调用发货接口 不支持主订单下的多个子订单同时发货,请按子订单分批重试调用发货接口
    CONSIGN_GET_LOCK_ERROR 不支持主订单下的多个子订单同时发货,请按子订单分批重试调用发货接口 不支持主订单下的多个子订单同时发货,请按子订单分批重试调用发货接口
    LC_CONCURRENT_MODIFY_FAIL 当前单据有其他场景在访问,请稍后重试 当前单据有其他场景在访问,请稍后重试
    OVERSEA_NOT_ALLOW_MULTI_PACKAGE 集运仓转运、跨境出海业务暂不支持一个订单多个包裹发货 集运仓转运、跨境出海业务暂不支持一个订单多个包裹发货
    DELAY_CONSIGN 一起团,需要延迟发货,等达到发货时机,才可 一起团,需要延迟发货,等达到发货时机,才可
    P38 拆单校验未通过 拆单校验未通过
    AT0053 当前发货资源不支持自己联系发货 当前发货资源不支持自己联系发货
    CONSIGN_WLB_QUERY_RESOURCE_SERVICE_ERROR 系统异常,请稍后重试 系统异常,请稍后重试
    CONSIGN_LC_SPLIT_ORDER_EXCEPTION 拆单异常 拆单异常
    B54 当前订单不支持自己联系发货 当前订单不支持自己联系发货
    CONSIGN_IDENTCODE_FEATURE_CHECK_EMPTY 机器识别码必填,不能为空 机器识别码必填,不能为空
    P01 参数为空 参数为空
    AT0055 查询用户信息异常,请稍后重试 查询用户信息异常,请稍后重试
    CONSIGN_IDENTCODE_IME_FEATURE_CHECK_EMPTY 发货失败,必须导入手机IMIE号,避免造成不必要的纠纷 发货失败,必须导入手机IMIE号,避免造成不必要的纠纷
    CONSIGN_IDENTCODE_IME_TYPE 输入的字符不符合要求,只支持英文、“,”和数字,请重新上传 输入的字符不符合要求,只支持英文、“,”和数字,请重新上传
    CONSIGN_IDENTCODE_IME_CHECK_LENGTH 识别码个数与商品数量不一致,请检验 识别码个数与商品数量不一致,请检验
    CONSIGN_IDENTCODE_IME_CHECK_DISTINCT 你输入的IMIE有重复,请重新录入 你输入的IMIE有重复,请重新录入
    CONSIGN_IDENTCODE_SN_FEATURE_CHECK_EMPTY 发货失败,必须导入手机SN号,避免造成不必要的纠纷。 发货失败,必须导入手机SN号,避免造成不必要的纠纷。
    CONSIGN_IDENTCODE_SN_TYPE 输入的字符不符合要求,只支持英文、“,”和数字,请重新上传 输入的字符不符合要求,只支持英文、“,”和数字,请重新上传
    CONSIGN_IDENTCODE_SN_CHECK_LENGTH 识别码个数与商品数量不一致,请检验 识别码个数与商品数量不一致,请检验
    CONSIGN_IDENTCODE_SN_CHECK_DISTINCT 你输入的SN有重复,请重新录入 你输入的SN有重复,请重新录入

    API工具

    如何获得此API

    FAQ

    返回
    顶部