文档中心 > API类目 > 千帆计划

tmall.ovs.delivery.order.tracking.node.send (物流单物流轨迹回传)

物流单物流轨迹回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param TrackingNodeRequest 必须 请求参数
  • └ open_user_id
  • String
  • 可选
  • 4353463
  • 集运场景专用,平台买家id 已加密,必传
  • └ platform_order_id
  • String
  • 可选
  • 46573573
  • 平台集运单id
  • └ node_code
  • String
  • 可选
  • 500
  • 出库异常-500, 出库成功500, 退件(国内物流商退,包含库内退件和报关/航空安检退件)600, 开始清关(境内)610, 清关异常(境内)-611, 清关完成(境内)611, 航班起飞620, 航班落地621, 开始清关(境外)677, 清关异常(境外)-678, 清关完成(境外)678, 后续节点如下: 配送方式为:宅配 物流节点包括:(货交末端派送商750, 派送中800, 签收异常-850, 签收成功850)。 配送方式为:自提 物流节点包括:(待取件835, 取件异常-840, 取件成功840) 请按上面节点回传,节点为必传节点。
  • └ node_cn_desc
  • String
  • 必须
  • 出库成功
  • 物流轨迹节点描述(中文) 见mail_node
  • └ occur_time
  • Number
  • 必须
  • 1641365460569
  • 业务发生时间戳 豪秒
  • └ mail_no
  • String
  • 可选
  • 435344252424
  • 物流单号
  • └ send_time
  • Number
  • 必须
  • 1642736836280
  • 推送此次物流轨迹的时间戳 ms
  • └ node_en_desc
  • String
  • 必须
  • Delivery succeeded
  • 物流轨迹节点描述(英文) 见mail_node
  • └ provider_user_code
  • String
  • 可选
  • 535633563
  • 废弃字段
  • └ sub_code
  • String
  • 可选
  • CNSHA
  • 当nodeCode=620时,回传起始地机场/港口代码; 当nodeCode=621时,回传目的地机场/港口代码; 机场/港口编码列表如下: LAX(洛杉矶国际机场), GMP(金浦国际机场), CNSHA (上海)。。。 篇幅有限,详细的最全的编码,请去千帆对接技术方案文档里查看。
  • └ pickup_code
  • String
  • 可选
  • 15-3432
  • 自提点取件码 配送方式为自提时使用

响应参数

名称 类型 示例值 描述
result ResultDO 响应
  • └ success
  • Boolean
  • false
  • 成功失败 true/false
  • └ fail_code
  • String
  • 1100
  • 错误码
  • └ fail_message
  • String
  • 系统异常
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallOvsDeliveryOrderTrackingNodeSendRequest req = new TmallOvsDeliveryOrderTrackingNodeSendRequest();
TmallOvsDeliveryOrderTrackingNodeSendRequest.TrackingNodeRequest obj1 = new TmallOvsDeliveryOrderTrackingNodeSendRequest.TrackingNodeRequest();
obj1.setOpenUserId("4353463");
obj1.setPlatformOrderId("46573573");
obj1.setNodeCode("500");
obj1.setNodeCnDesc("出库成功");
obj1.setOccurTime(1641365460569L);
obj1.setMailNo("435344252424");
obj1.setSendTime(1642736836280L);
obj1.setNodeEnDesc("Delivery succeeded");
obj1.setProviderUserCode("535633563");
obj1.setSubCode("CNSHA");
obj1.setPickupCode("15-3432");
req.setParam(obj1);
TmallOvsDeliveryOrderTrackingNodeSendResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_ovs_delivery_order_tracking_node_send_response>
    <result>
        <success>false</success>
        <fail_code>1100</fail_code>
        <fail_message>系统异常</fail_message>
    </result>
</tmall_ovs_delivery_order_tracking_node_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>

错误码解释

错误码 错误描述 解决方案
OPEN_PARAM_NOD_NULL 入参节点值为空或不合法 集运商检查入参是否缺少参数值,重新回传
OPEN_USER_ID_ERROR 入参用户ID错误 检查该参数正确性
OPEN_NODE_CODE_ERROR 物流轨迹节点不正确 物流轨迹节点不正确
OPEN_DELIVERY_ORDER_NOT_FIND 根据入参查无此集运单 根据入参查无此集运单,ISV检查入参集运单号正确性platform_order_id
OPEN_CRO_CHECK_FAIL 包含了敏感数据触发了平台风控 ISV检查入参不能包含敏感信息

API工具

如何获得此API

FAQ

返回
顶部