API接口目录

电商能力输出业务

商品API
商品API
价格API
订单API
营销API
基础数据API
物流API
促销API
同城帮定制API
优惠券定制业务API
会员API
客服沟通咨询API
三方库存API
账单API
异常码自查工具
suning.online.logistics.get 物流状态和明细查询
¥免费

物流状态和明细查询

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderItemIdStringY123456789平台订单行号
响应参数
名称 类型 示例值 描述
orderItemIdString123456789平台订单行号
statusString1查询结果状态,0:物流暂无结果1:查询成功2:接口出现异常
messageString查询成功查询结果描述
stateString3快递单当前状态,3:签收4:退签7:发货
dataString
timeString2013-03-03 19:24:48跟踪信息时间
contextString到达南京分拨中心跟踪信息描述
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <getLogistics>
      <orderItemId>123456789</orderItemId>
    </getLogistics>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "getLogistics": {
        "orderItemId": "123456789"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <getLogistics>
      <message>物流暂无结果</message>
      <status>0-物流暂无结果;1-查询成功;2-接口出现异常</status>
      <orderItemId>123456789</orderItemId>
      <data>
        <time>2013-03-03 19:24:48</time>
        <context>到达南京分拨中心</context>
      </data>
      <state>3-签收;4-退签;7-发货</state>
    </getLogistics>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "getLogistics": {
        "message": "物流暂无结果",
        "orderItemId": "123456789",
        "status": "0-物流暂无结果;1-查询成功;2-接口出现异常",
        "state": "3-签收;4-退签;7-发货",
        "data": [
          {
            "time": "2013-03-03 19:24:48",
            "context": "到达南京分拨中心"
          }
        ]
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.online.getlogistics.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.poas 服务不可用 请联系苏宁技术人员
biz.online.getlogistics.invalid-biz:101 该订单行尚未在苏宁系统创建 请联系苏宁技术人员
公共异常码
API工具
FAQ