API接口目录

4PS业务

4PS仓库管理API
4ps仓库库存
4PS商品管理API
4PS接单管理API
异常码自查工具
suning.fourps.storagesub.query 商品入库预约信息批量查询
¥免费

通过此接口4PS用户可以进行批量商品入库的预约信息的查询。1、 4PS用户可以查询入库预约单状态,以及入库预约商品的相关信息。2、 当预约单的状态为预约失败时,可以对预约单的信息进行修改。当预约单的状态为成功时,可以进行取消。当预约单状态为未预约时,可以进行预约申请。当预约单状态为已入库时,可以查询入库相关信息3、 如果不输入任何查询条件,则默认查询预约创建时间近一个月内,预约商品入库的信息,默认返回第一页,前10条数据。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
applyBeginDateStringN2014-11-20 18:00:00查询开始时间(预约创建时间)。
applyEndDateStringN2014-11-20 21:00:00查询结束时间(预约创建时间)。
orderBeginDateStringN2014-11-21 18:00:00查询开始时间(预约入库)。)
orderEndDateStringN2014-11-21 21:00:00查询结束时间(预约入库)。
orderStateStringN01预约单状态。01 预约成功 02预约失败 03已取消 04已入库
pageNoStringN1 页码。默认值:1。页码和每页条数成对出现
pageSizeStringN10 每页条数。最大值:50。默认值:10。页码和每页条数成对出现
warehouseCodeStringNL025仓库ID。预约的苏宁仓库ID,如果不输入则默认查询全部仓库的预约信息
响应参数
名称 类型 示例值 描述
carrierString陈某承运人
commodityListString
commodityCodeString100020001苏宁商品编码
commodityNameStringIphone6plus商品名称
countString15商品数量
contactsNumberString18651662631联系电话
createTimeString2014-11-21 18:00:00预约创建日期+时间
customerIdString10001客选订单号
orderIdStringSN20000000001预约单号
orderStateString01预约单状态。01 预约成功 02预约失败 03已取消 04已入库
orderStorageDateString2014-11-24 18:00:00预约入库日期+时间
purchaseOrderIdString10000采购订单
warehouseCodeStringL025仓库ID
warehouseNameString南京雨花物流仓仓库名称
waybillStringEMS00129322运单号
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryStorageSub>
      <warehouseCode>L025</warehouseCode>
      <orderState>01</orderState>
      <orderBeginDate>2014-11-21 18:00:00</orderBeginDate>
      <applyBeginDate>2014-11-20 18:00:00</applyBeginDate>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <applyEndDate>2014-11-20 21:00:00</applyEndDate>
      <orderEndDate>2014-11-21 21:00:00</orderEndDate>
    </queryStorageSub>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryStorageSub": {
        "warehouseCode": "L025",
        "orderState": "01",
        "orderBeginDate": "2014-11-21 18:00:00",
        "applyBeginDate": "2014-11-20 18:00:00",
        "pageNo": "1",
        "pageSize": "10",
        "orderEndDate": "2014-11-21 21:00:00",
        "applyEndDate": "2014-11-20 21:00:00"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryStorageSub>
      <warehouseCode>L025</warehouseCode>
      <waybill>EMS00129322</waybill>
      <createTime>2014-11-21 18:00:00</createTime>
      <warehouseName>南京雨花物流仓</warehouseName>
      <orderState>01</orderState>
      <customerId>10001</customerId>
      <purchaseOrderId>10000</purchaseOrderId>
      <contactsNumber>18651662631</contactsNumber>
      <commodityList>
        <count>15</count>
        <commodityName>Iphone6plus</commodityName>
        <commodityCode>100020001</commodityCode>
      </commodityList>
      <carrier>陈某</carrier>
      <orderStorageDate>2014-11-24 18:00:00</orderStorageDate>
      <orderId>SN20000000001</orderId>
    </queryStorageSub>
  </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": {
      "queryStorageSub": [
        {
          "warehouseCode": "L025",
          "warehouseName": "南京雨花物流仓",
          "createTime": "2014-11-21 18:00:00",
          "waybill": "EMS00129322",
          "orderState": "01",
          "customerId": "10001",
          "purchaseOrderId": "10000",
          "contactsNumber": "18651662631",
          "carrier": "陈某",
          "commodityList": [
            {
              "count": "15",
              "commodityName": "Iphone6plus",
              "commodityCode": "100020001"
            }
          ],
          "orderStorageDate": "2014-11-24 18:00:00",
          "orderId": "SN20000000001"
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.fourps.querystoragesub.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.fourps.querystoragesub.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.fpims 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ

Q:商品入库预约信息批量查询接口如何使用?

A:通过此接口可商品入库预约信息批量查询