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

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

alibaba.ascp.logistics.seller.writelogisticsnode (商家配送写入物流节点)

商家配送的订单,商家写入物流节点

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
lp_order_id Number 必须 12345 物流发货单号
nodes LogisticsNodeTopDTO [] 必须
  • 最大列表长度:100
  • 物流节点
    • └ action
    • String
    • 必须
    • ACCEPT
    • ACCEPT(已揽收),TRANSPORT(运输中),DELIVERING(派送中),SIGN(已签收),CANCEL(已取消),FAILED(物流异常)
    • └ operate_time
    • Number
    • 必须
    • 1680233454408
    • 操作时间戳,精确到毫秒(ms)
    • delivery
    • DeliveryTopDTO
    • 可选
    • 配送员信息
    • └ phone
    • String
    • 必须
    • 18612345678
    • 配送员电话,支持手机、座机、400电话
    • └ name
    • String
    • 必须
    • 小王
    • 配送员姓名
    • location
    • LocationTopDTO
    • 可选
    • 货物所在的当前位置
    • └ province
    • String
    • 必须
    • 浙江省
    • 省/直辖市
    • └ city
    • String
    • 必须
    • 杭州市
    • 地级市
    • └ district
    • String
    • 必须
    • 余杭区
    • 区/县
    • └ town
    • String
    • 必须
    • 五常街道
    • 乡/镇/街道
    • └ lng
    • String
    • 可选
    • 120.027276
    • 经度,高德地图
    • └ lat
    • String
    • 可选
    • 30.275962
    • 纬度,高德地图

    响应参数

    名称 类型 示例值 描述
    result BatchWriteLogisticsNodeTopResponse result 返回结果
    • └ success
    • Boolean
    • true
    • true成功,false失败

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAscpLogisticsSellerWritelogisticsnodeRequest req = new AlibabaAscpLogisticsSellerWritelogisticsnodeRequest();
    req.setLpOrderId(12345L);
    List<AlibabaAscpLogisticsSellerWritelogisticsnodeRequest.LogisticsNodeTopDTO> list2 = new ArrayList<AlibabaAscpLogisticsSellerWritelogisticsnodeRequest.LogisticsNodeTopDTO>();
    AlibabaAscpLogisticsSellerWritelogisticsnodeRequest.LogisticsNodeTopDTO obj3 = new AlibabaAscpLogisticsSellerWritelogisticsnodeRequest.LogisticsNodeTopDTO();
    list2.add(obj3);
    obj3.setAction("ACCEPT");
    obj3.setOperateTime(1680233454408L);
    AlibabaAscpLogisticsSellerWritelogisticsnodeRequest.DeliveryTopDTO obj5 = new AlibabaAscpLogisticsSellerWritelogisticsnodeRequest.DeliveryTopDTO();
    obj5.setPhone("18612345678");
    obj5.setName("小王");
    list4.setDelivery(obj5);
    AlibabaAscpLogisticsSellerWritelogisticsnodeRequest.LocationTopDTO obj7 = new AlibabaAscpLogisticsSellerWritelogisticsnodeRequest.LocationTopDTO();
    obj7.setProvince("浙江省");
    obj7.setCity("杭州市");
    obj7.setDistrict("余杭区");
    obj7.setTown("五常街道");
    obj7.setLng("120.027276");
    obj7.setLat("30.275962");
    list6.setLocation(obj7);
    req.setNodes(list2);
    AlibabaAscpLogisticsSellerWritelogisticsnodeResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

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

    返回
    顶部