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

tmall.nr.fulfill.logistics.query (定时送和极速达配送物流信息查询)

发布定时送&极速达物流信息查询服务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
main_order_id Number 可选 163783004292640 交易主订单号
biz_identity String 可选 dss 业务标识,dss标识定时送业务;jsd表示极速达业务

响应参数

名称 类型 示例值 描述
result NrResult result 返回对象
  • result_data
  • NrTimingFulfillDetailQueryRespDto
  • resultData
  • 返回数据
  • nr_delivery_brief_status_d_t_o
  • NrDeliveryBriefStatusDto
  • nrDeliveryBriefStatusDTO
  • 当前状态
  • └ logistics_time
  • String
  • 2018-04-27 11:22:41
  • 状态产生时间
  • └ fail_code
  • String
  • 1028
  • 取件失败的code
  • └ fail_reason
  • String
  • 缺货
  • 取件失败的原因
  • └ deliverer_phone
  • String
  • 186123450232
  • 快递员电话
  • └ deliverer_name
  • String
  • 张三
  • 快递员姓名
  • └ sp_name
  • String
  • 点我达
  • 服务商的cp
  • └ logistics_status_name
  • String
  • 妥投
  • logisticsStatusName状态的说明包含[下单,接单,取件,妥投,拒收,取消]
  • └ logistics_status
  • String
  • GOT
  • 包含[CREATE,GRASP,GOT,DELIVERYED]
  • nr_delivery_brief_status_d_t_os
  • NrDeliveryBriefStatusDto []
  • nrDeliveryBriefStatusDTOs
  • 历史状态
  • └ logistics_status
  • String
  • CREATE
  • 包含[CREATE,GRASP,GOT,DELIVERYED]
  • └ logistics_status_name
  • String
  • 创建
  • logisticsStatusName状态的说明包含[下单,接单,取件,妥投,拒收,取消]
  • └ sp_name
  • String
  • 点我达
  • spName
  • └ deliverer_name
  • String
  • 张三
  • delivererName
  • └ deliverer_phone
  • String
  • 李四
  • delivererPhone
  • └ fail_reason
  • String
  • 缺货
  • failReason
  • └ fail_code
  • String
  • 1028
  • failCode
  • └ logistics_time
  • String
  • 2018-04-27 11:22:41
  • logisticsTime
  • └ error_message
  • String
  • 天猫订单不存在
  • errorMessage
  • └ error_code
  • String
  • TMALL_ORDER_NOT_EXIST
  • errorCode
  • └ is_success
  • Boolean
  • true
  • isSuccess

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrFulfillLogisticsQueryRequest req = new TmallNrFulfillLogisticsQueryRequest();
req.setMainOrderId(163783004292640L);
req.setBizIdentity("dss");
TmallNrFulfillLogisticsQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nr_fulfill_logistics_query_response>
    <result>
        <result_data>
            <nr_delivery_brief_status_d_t_o>
                <logistics_time>2018-04-27 11:22:41</logistics_time>
                <fail_code>1028</fail_code>
                <fail_reason>缺货</fail_reason>
                <deliverer_phone>186123450232</deliverer_phone>
                <deliverer_name>张三</deliverer_name>
                <sp_name>点我达</sp_name>
                <logistics_status_name>妥投</logistics_status_name>
                <logistics_status>GOT</logistics_status>
            </nr_delivery_brief_status_d_t_o>
            <nr_delivery_brief_status_d_t_os>
                <nr_delivery_brief_status_dto>
                    <logistics_status>CREATE</logistics_status>
                    <logistics_status_name>创建</logistics_status_name>
                    <sp_name>点我达</sp_name>
                    <deliverer_name>张三</deliverer_name>
                    <deliverer_phone>李四</deliverer_phone>
                    <fail_reason>缺货</fail_reason>
                    <fail_code>1028</fail_code>
                    <logistics_time>2018-04-27 11:22:41</logistics_time>
                </nr_delivery_brief_status_dto>
            </nr_delivery_brief_status_d_t_os>
        </result_data>
        <error_message>天猫订单不存在</error_message>
        <error_code>TMALL_ORDER_NOT_EXIST</error_code>
        <is_success>true</is_success>
    </result>
</tmall_nr_fulfill_logistics_query_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

返回
顶部