taobao.logistics.ordertrace.push (物流订单流转信息推送接口)

卖家使用自己的物流公司发货,可以通过本接口将订单的流转信息推送到淘宝,淘宝保存这些流转信息,并可在页面展示这些流转信息。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
mail_no String 必须 762016565903 快递单号。各个快递公司的运单号格式不同。
company_name String 必须 如风达
  • 最大长度:20
  • 物流公司名称
    occure_time Date 必须 2012-03-15 15:11:23 流转节点发生时间
    operator_name String 可选 张三
  • 最大长度:20
  • 快递业务员名称
    operator_contact String 可选 13589895656
  • 最大长度:20
  • 快递业务员联系方式,手机号码或电话。
    current_city String 可选 北京市
  • 最大长度:20
  • 流转节点的当前城市
    facility_name String 可选 上海市浦东蓝村路投送点
  • 最大长度:100
  • 网点名称
    operate_detail String 必须 浙江省杭州市西湖区上车扫描
  • 最大长度:200
  • 流转节点的详细地址及操作描述
    node_description String 可选 TMS_DELIVERING
  • 最大长度:20
  • 揽收请填写" TMS_ACCEPT ",派送请填写" TMS_DELIVERING ",签收请填写" TMS_SIGN "。

    响应参数

    名称 类型 示例值 描述
    shipping Shipping 返回结果是否成功is_success
    • └ is_success
    • Boolean
    • true
    • 返回发货是否成功。

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    LogisticsOrdertracePushRequest req = new LogisticsOrdertracePushRequest();
    req.setMailNo("762016565903");
    req.setCompanyName("如风达");
    req.setOccureTime(StringUtils.parseDateTime("2012-03-15 15:11:23"));
    req.setOperatorName("张三");
    req.setOperatorContact("13589895656");
    req.setCurrentCity("北京市");
    req.setFacilityName("上海市浦东蓝村路投送点");
    req.setOperateDetail("浙江省杭州市西湖区上车扫描");
    req.setNodeDescription("TMS_DELIVERING");
    LogisticsOrdertracePushResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <logistics_ordertrace_push_response>
        <shipping>
            <is_success>true</is_success>
        </shipping>
    </logistics_ordertrace_push_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.post-trace-info-service-error:P01 快递单号长度超过20个字符 检验快递运单号是否超过20个字符
    isv.post-trace-info-service-error:P02 快递单号不得为空 检验快递单号是否为空
    isv.post-trace-info-service-error:P03 物流公司名称不得为空 检验物流公司名称是否为空
    isv.post-trace-info-service-error:P04 物流公司名称长度不得超过20个字符 检验物流公司名称长度是否超过20个字符
    isv.post-trace-info-service-error:P05 流转节点发生的时间不能为空 检验流转节点发生的时间是否为空
    isv.post-trace-info-service-error:P06 快递业务员姓名不能超过20个字符 检验快递业务员姓名是否超过20个字符
    isv.post-trace-info-service-error:P07 快递业务员联系方式不能超过20个字符 检验快递业务员联系方式是否超过20个字符
    isv.post-trace-info-service-error:P08 城市名称不能超过20个字符 检验城市名称是否超过20个字符
    isv.post-trace-info-service-error:P09 流转信息详细地址和操作描述长度超过200个字符 检验流转信息详细地址和操作描述是否超过200个字符
    isv.post-trace-info-service-error:P10 流转信息详细地址和操作描述不得为空 检查流转信息详细地址和操作描述是否为空
    isv.post-trace-info-service-error:P11 发送信息中包含敏感词汇或非法字符 检验发送信息中是否包含敏感词汇或非法字符
    isv.post-trace-info-service-error:P12 网点名称长度不得超过100个字符 检验网点名称长度是否超过100个字符
    isv.post-trace-info-service-error:P13 节点操作描述长度不得超过20个字符 检查节点操作描述是否超过20个字符
    isv.post-trace-info-service-error:P14 下一网点名称长度不得超过100个字符 检验下一网点名称长度,不要超过100个字符
    isv.post-trace-info-service-error:P15 授权用户与当前卖家不匹配 更换授权账号,用卖家用户来授权,重新推送。
    isv.post-trace-info-service-error:P16 无效快递单号,找不到对应的订单 请检查快递单号,确认快递单号,是否是发货的单号。

    API工具

    如何获得此API

    FAQ

    返回
    顶部