文档中心 > API类目 > 天猫新零售

tmall.nr.logistics.sync (物流信息回传)

物流信息回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 SyncLogisticsInfoReqDto 可选 入参说明
  • └ desc
  • String
  • 可选
  • 快递员揽收成功
  • 事件详情描述
  • └ delivery_user_name
  • String
  • 可选
  • 张三
  • 快递员的姓名---昵称
  • └ main_biz_order_id
  • Number
  • 可选
  • 32432432432
  • 淘系交易订单号
  • └ event_create_time
  • Date
  • 可选
  • 2018-08-01 00:00:00
  • 事件产生事件
  • └ cancel_reason
  • String
  • 可选
  • 消费者拒收
  • 取消原因
  • └ mail_cp_name
  • String
  • 可选
  • 蜂鸟
  • 运单所属CP比如蜂鸟,点我达,安鲜达
  • └ city
  • String
  • 可选
  • 330100
  • 城市
  • └ mail_no
  • String
  • 可选
  • LPX0002
  • 运单号
  • └ cancel_reason_code
  • String
  • 可选
  • X0001
  • 取消原因的code
  • └ delivery_phone
  • String
  • 可选
  • 18188888888
  • 配送人员手机号
  • └ event
  • Number
  • 可选
  • 10
  • 10已下发,等待骑手接单;20骑手已接单,待骑手取货;30骑手到店,40骑手已提货,待骑手送达;50拒收;-999配送失败;999妥投成功
  • └ event_oper_type
  • Number
  • 可选
  • 5
  • 操作人类型:1寄件人,3客服小二,4快递员,5CP,6收件人,100系统
  • └ mail_cp
  • String
  • 可选
  • FN
  • 对应CPCode,比如蜂鸟FN,圆通ZTO
  • └ biz_identity
  • String
  • 可选
  • dss
  • 业务识别定时送dss,极速达jsd
  • └ predict_arrive_store_time
  • Date
  • 可选
  • 2018-08-01 00:00:00
  • 骑手预计到店时间
  • └ rider_predict_arrival_time
  • String
  • 可选
  • 2018-08-01 00:00:00
  • 预计送达时间

响应参数

名称 类型 示例值 描述
result NewRetailResult result
  • └ error_message
  • String
  • 物流回传服务异常
  • 错误信息提示
  • └ error_code
  • String
  • X0001
  • errorCode
  • └ success_flag
  • Boolean
  • true
  • 调用是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrLogisticsSyncRequest req = new TmallNrLogisticsSyncRequest();
TmallNrLogisticsSyncRequest.SyncLogisticsInfoReqDto obj1 = new TmallNrLogisticsSyncRequest.SyncLogisticsInfoReqDto();
obj1.setDesc("快递员揽收成功");
obj1.setDeliveryUserName("张三");
obj1.setMainBizOrderId(32432432432L);
obj1.setEventCreateTime(StringUtils.parseDateTime("2018-08-01 00:00:00"));
obj1.setCancelReason("消费者拒收");
obj1.setMailCpName("蜂鸟");
obj1.setCity("330100");
obj1.setMailNo("LPX0002");
obj1.setCancelReasonCode("X0001");
obj1.setDeliveryPhone("18188888888");
obj1.setEvent(10L);
obj1.setEventOperType(5L);
obj1.setMailCp("FN");
obj1.setBizIdentity("dss");
obj1.setPredictArriveStoreTime(StringUtils.parseDateTime("2018-08-01 00:00:00"));
obj1.setRiderPredictArrivalTime("2018-08-01 00:00:00");
req.setParam0(obj1);
TmallNrLogisticsSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nr_logistics_sync_response>
    <result>
        <error_message>物流回传服务异常</error_message>
        <error_code>X0001</error_code>
        <success_flag>true</success_flag>
    </result>
</tmall_nr_logistics_sync_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

返回
顶部