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

tmall.nr.fulfill.logistics.sync (同城配物流信息回传)

同城配业务物流信息回传,通过接口将物流信息同步给天猫

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 NrLogisticsInfoSynReqDto 必须 物流回传参数
  • └ delivery_user_type
  • Number
  • 可选
  • 0
  • 运力类型,0: 第三方快递员, 1:商家自动
  • └ facility_name
  • String
  • 可选
  • 上海市浦东蓝村路投送点
  • 站点名称
  • └ plan_date
  • String
  • 可选
  • 2018-07-02
  • 配送日期,周期送业务必传
  • └ delivery_user_id
  • Number
  • 可选
  • 1122
  • 快递员id
  • └ desc
  • String
  • 可选
  • 浙江省杭州市西湖区上车扫描
  • 流转节点的详细地址及操作描述
  • └ delivery_user_name
  • String
  • 可选
  • 张三
  • 快递员的姓名
  • └ main_biz_order_id
  • Number
  • 必须
  • 1234
  • 淘系交易主订单号
  • └ event_create_time
  • Date
  • 必须
  • 2012-03-15 15:11:23
  • 流转节点发生时间
  • └ cancel_reason
  • String
  • 可选
  • 原因描述
  • 取消配送原因
  • └ mail_cp_name
  • String
  • 必须
  • 如风达
  • 快递公司名称,自配送传入:其他
  • └ city
  • String
  • 可选
  • 北京市
  • 流转节点的当前城市
  • └ mail_no
  • String
  • 必须
  • 762016565903
  • 快递单号。各个快递公司的运单号格式不同。
  • └ cancel_reason_code
  • String
  • 可选
  • NOT_IN_WORK_TIME
  • 取消配送编号
  • └ sub_biz_order_id
  • Number
  • 可选
  • 3432432432
  • 淘宝交易子订单号,周期送业务必传
  • └ delivery_phone
  • String
  • 可选
  • 13589895656
  • 快递业务员联系方式,手机号码或电话。
  • └ event
  • Number
  • 必须
  • 10
  • 事件编码,10:已下发等待接单,20:骑手已接单,待提货,40:揽收,999:妥投,50:拒收,-999:取消
  • └ trace_id
  • String
  • 可选
  • 123
  • 请求编号
  • └ event_oper_type
  • Number
  • 可选
  • 1
  • 操作人类型:1寄件人,3客服小二,4快递员,5CP,6收件人,100系统
  • └ sequence_no
  • Number
  • 可选
  • 1
  • 配送序号
  • └ mail_cp
  • String
  • 可选
  • 运单所属CP
  • 运单所属CP,自配送传入:OTHER
  • └ biz_identity
  • String
  • 必须
  • oneHour
  • 业务类型(oneHour:一小时达,zqs:周期送,dss:定时送,周期送业务:zqs)如果自配送传入:other

响应参数

名称 类型 示例值 描述
result NrResult 返回结果
  • └ result_data
  • Boolean
  • true
  • 成功失败标识,true:成功,false:失败
  • └ error_message
  • String
  • 不合法的查询请求参数
  • 错误描述
  • └ error_code
  • String
  • INVALID_QUERY_PARAM
  • 错误代码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrFulfillLogisticsSyncRequest req = new TmallNrFulfillLogisticsSyncRequest();
TmallNrFulfillLogisticsSyncRequest.NrLogisticsInfoSynReqDto obj1 = new TmallNrFulfillLogisticsSyncRequest.NrLogisticsInfoSynReqDto();
obj1.setDeliveryUserType(0L);
obj1.setFacilityName("上海市浦东蓝村路投送点");
obj1.setPlanDate("2018-07-02");
obj1.setDeliveryUserId(1122L);
obj1.setDesc("浙江省杭州市西湖区上车扫描");
obj1.setDeliveryUserName("张三");
obj1.setMainBizOrderId(1234L);
obj1.setEventCreateTime(StringUtils.parseDateTime("2012-03-15 15:11:23"));
obj1.setCancelReason("原因描述");
obj1.setMailCpName("如风达");
obj1.setCity("北京市");
obj1.setMailNo("762016565903");
obj1.setCancelReasonCode("NOT_IN_WORK_TIME");
obj1.setSubBizOrderId(3432432432L);
obj1.setDeliveryPhone("13589895656");
obj1.setEvent(10L);
obj1.setTraceId("123");
obj1.setEventOperType(1L);
obj1.setSequenceNo(1L);
obj1.setMailCp("运单所属CP");
obj1.setBizIdentity("oneHour");
req.setParam0(obj1);
TmallNrFulfillLogisticsSyncResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nr_fulfill_logistics_sync_response>
    <result>
        <result_data>true</result_data>
        <error_message>不合法的查询请求参数</error_message>
        <error_code>INVALID_QUERY_PARAM</error_code>
    </result>
</tmall_nr_fulfill_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

返回
顶部