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

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

alibaba.ascp.logistics.seller.send (商家配送发货)

该API提供商家配送发货能力,使用该接口发货,交易订单状态会直接变成卖家已发货

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
delivery_mobile String 必须 15617177451 派送员手机号(支持座机号和400)
sender_id Number 可选 123456 卖家联系人地址库ID,可以通过taobao.logistics.address.search接口查询到地址库ID。如果为空,取的卖家的默认取货地址
feature String 可选 identCode=tid:aaa,bbb;machineCode=tid2:aaa;retailStoreId=12345;retailStoreType=STORE 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字段为必填字段
tid String 必须 123456789 淘宝交易ID
sub_tid String 可选 1,2,3 需要拆单发货的子订单集合,针对的是一笔交易下有多个子订单需要分开发货的场景;1次可传人多个子订单号,子订单间用逗号隔开;为空表示不做拆单发货。
delivery_name String 必须 李明 派送员姓名
cancel_id Number 可选 123 卖家联系人地址库ID,可以通过taobao.logistics.address.search接口查询到地址库ID。 如果为空,取的卖家的默认退货地址
mode String 可选 A
  • 默认值:A
  • A(默认,核销签收模式),B(商家回传物流节点模式)

    响应参数

    名称 类型 示例值 描述
    result ResultDTO -
    • └ success
    • Boolean
    • true
    • 执行结果
    • consign
    • ConsignDTO
    • -
    • └ lp_order_id
    • Number
    • 1234567
    • 物流发货单号
    • └ consign_desc
    • String
    • 描述
    • 发货文案描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAscpLogisticsSellerSendRequest req = new AlibabaAscpLogisticsSellerSendRequest();
    req.setDeliveryMobile("15617177451");
    req.setSenderId(123456L);
    req.setFeature("identCode=tid:aaa,bbb;machineCode=tid2:aaa;retailStoreId=12345;retailStoreType=STORE");
    req.setTid("123456789");
    req.setSubTid("1,2,3");
    req.setDeliveryName("李明");
    req.setCancelId(123L);
    req.setMode("A");
    AlibabaAscpLogisticsSellerSendResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_ascp_logistics_seller_send_response>
        <result>
            <success>true</success>
            <consign>
                <lp_order_id>1234567</lp_order_id>
                <consign_desc>描述</consign_desc>
            </consign>
        </result>
    </alibaba_ascp_logistics_seller_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部