退出
热词搜索：
API接口目录

物流业务

苏宁开放物流API
异常码自查工具
suning.custom.logisticsstatus.query 状态信息批量查询服务
￥基础

状态信息批量查询服务

公共参数
请求参数
名称 类型 是否必须 示例值 描述
endTimeStringY2014-08-06 10:24:00查询结束时间(查询的提货日期时间跨度不能大于1天)。格式:yyyy-MM-dd HH:mm:ss
operationStatusStringN1102状态编码（不输入则默认返回所有状态下的记录）
pageNoStringN1页码，默认值：1
pageSizeStringN10每页条数（最大值：50，默认值：10）
startTimeStringY2014-08-05 10:24:00查询开始时间(查询的提货日期时间跨度不能大于1天)。格式:yyyy-MM-dd HH:mm:ss
响应参数
名称 类型 示例值 描述
statusDescriptionString已客户包装状态编码对应的描述信息
siteDescriptionStringL048苏宁物流站点描述
logisticOrderIdStringSNCH0100000074792苏宁物流订单号
logisticsSiteStringL048苏宁物流站点编码
operatorNameString测试人员作业人员姓名
logisticExpressIdString62000000000000000001苏宁物流运单号
operationStatusString1035苏宁物流作业状态编码
telephoneNumberString13589665466联系方式
realCompleteDateString2014-08-02状态的实际完成日期，格式：yyyy-MM-dd
realCompleteTimeString16:00:00状态的实际完成时间，格式：HH:mm:ss
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryLogisticStatus>
      <startTime>2014-08-05 10:24:00</startTime>
      <pageNo>1</pageNo>
      <operationStatus>1102</operationStatus>
      <pageSize>10</pageSize>
      <endTime>2014-08-06 10:24:00</endTime>
    </queryLogisticStatus>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryLogisticStatus": {
        "startTime": "2014-08-05 10:24:00",
        "operationStatus": "1102",
        "pageNo": "1",
        "pageSize": "10",
        "endTime": "2014-08-06 10:24:00"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <queryLogisticStatus>
      <logisticOrderId>SNCH0100000074792</logisticOrderId>
      <siteDescription>L048</siteDescription>
      <statusDescription>已客户包装</statusDescription>
      <logisticsSite>L048</logisticsSite>
      <logisticExpressId>62000000000000000001</logisticExpressId>
      <operatorName>测试人员</operatorName>
      <operationStatus>1035</operationStatus>
      <telephoneNumber>13589665466</telephoneNumber>
      <realCompleteDate>2014-08-02</realCompleteDate>
      <realCompleteTime>16:00:00</realCompleteTime>
    </queryLogisticStatus>
  </sn_body>
  <sn_head>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <totalSize>1</totalSize>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "pageTotal": "1",
      "pageNo": "1",
      "totalSize": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryLogisticStatus": [
        {
          "statusDescription": "已客户包装",
          "siteDescription": "L048",
          "logisticOrderId": "SNCH0100000074792",
          "logisticsSite": "L048",
          "operatorName": "测试人员",
          "logisticExpressId": "62000000000000000001",
          "operationStatus": "1035",
          "telephoneNumber": "13589665466",
          "realCompleteDate": "2014-08-02",
          "realCompleteTime": "16:00:00"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.querylogisticsstatus.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.logistics.querylogisticsstatus.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.lsp 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：苏宁物流状态批量查询如何使用？

A：通过此接口获取苏宁物流状态的信息有：苏宁物流订单号、苏宁物流运单号、完成日期、完成时间、状态编码、状态描述、物流站点、站点描述、作业人员姓名、联系方式、备注等。

Q：苏宁物流状态批量查询接口如何使用？

A：通过此接口批量查询苏宁物流状态信息：苏宁物流订单号、苏宁物流运单号、完成日期、完成时间、状态编码、状态描述、物流站点、站点描述、作业人员姓名、联系方式、备注等。