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

4PS业务

4PS接单管理API
4PS任务作业API
4PS仓库管理API
4ps仓库库存
4PS商品管理API
异常码自查工具
suning.fourps.celstoragesub.query 商品退库预约信息批量查询
￥免费

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

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNo String N 1 页码。页码。默认值：1。页码和每页条数成对出现
pageSize String N 10 每页条数。每页条数。最大值：50。默认值：10。页码和每页条数成对出现
appointStatus String N 0 退库预约单状态。0 预约成功 1预约失败 2已取消 3已退库
refundType String N 0 退库类型。0代表良品；1代表不良品
warehouseCode String N 100 仓库ID。预约的苏宁仓库ID，如果不输入则默认查询全部仓库的预约信息
appointStartTime String N 2014-11-21 18:00:00 查询开始时间（预约退库）。查询开始时间（预约退库）
appointEndTime String N 2014-11-21 21:00:00 查询结束时间（预约退库）。查询结束时间（预约退库）
startTime String N 2014-11-20 18:00:00 查询开始时间（退库预约创建时间）。查询开始时间（退库预约创建时间）
endTime String N 2014-11-20 21:00:00 查询结束时间（退库预约创建时间）。查询结束时间（退库预约创建时间）
响应参数
名称 类型 示例值 描述
appointOrderId String 2000000000036 退库预约单号。
purchaseOrderId String 1111111 采购订单号。
customerId String 1111111 客选订单号。
appointStatus String 1 退库预约单状态。0 预约成功 1预约失败 2已取消 3已退库
warehouseCode String L300 仓库ID。预约的苏宁仓库ID
warehouseName String 1 仓库名称。仓库中文名称
refundType String 1 退库类型。0代表良品，1代表不良品
createDate String 2015-06-04 退库预约创建日期。
createTime String 18:57 退库预约创建时间。
appointDate String 2015-06-04 预约退库日期。
appointTime String 15:00 预约退库时间。
contacts String 1 承运人。
supplierPhone String 11111111111 联系电话。
supplierCode String 70057314 商户编码
commodityCode String 11111111 苏宁商品编码。商品编码
commodityName String 1 商品名称。
commodityCount String 11 退库商品数量。
colorId String 1 色号。
batchId String 1 批次号。
supplierCommodityCode String 100020001 商家商品编码。
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
	<sn_body>
		<queryCelStorageSub>
			<pageNo>1</pageNo>
			<pageSize>10</pageSize>
			<appointStatus>01</appointStatus>
			<refundType>1</refundType>
			<warehouseCode>L025</warehouseCode>
			<appointStartDate>2014-11-20 21:00:00</appointStartDate>
			<appointEndDate>2014-11-20 21:00:00</appointEndDate>
			<startTime>2014-11-20 21:00:00</startTime>
			<endTime>2014-11-20 21:00:00</endTime>
		</queryCelStorageSub>
	</sn_body>
</sn_request>
			
                                
                                
{
	"sn_request": {
		"sn_body": {
			"queryCelStorageSub": {
				"pageNo": "1",
				"pageSize": "10",
				"appointStatus": "01",
				"refundType": "1",
				"warehouseCode": "L025",
				"appointStartDate": "2014-11-20 21:00:00",
				"appointEndDate": "2014-11-20 21:00:00",
				"startTime": "2014-11-20 21:00:00",
				"endTime": "2014-11-20 21:00:00"
			}
		}
	}
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
	<sn_head>
		<pageTotal>3</pageTotal>
		<pageNo>1</pageNo>
		<totalSize>23</totalSize>
		<returnMessage>biz.handler.data-get:success</returnMessage>
	</sn_head>
	<sn_body>
		<queryCelStorageSub>
			<supplierCode>70057314</supplierCode>
			<purchaseOrderId>10000</purchaseOrderId>
			<appointOrderId>2000017661784</appointOrderId>
			<customerId>1</customerId>
			<refundType>0</refundType>
			<appointStatus>3</appointStatus>
			<appointDate>2015-12-25</appointDate>
			<appointTime>15:00:00</appointTime>
			<createDate>2015-12-22</createDate>
			<createTime>17:15:59</createTime>
			<warehouseName>苏宁物流苏州仓库（金螳螂业务）</warehouseName>
			<contacts>陈某</contacts>
			<supplierPhone>18651662631</supplierPhone>
			<warehouseCode>WM10031477</warehouseCode>
			<commodityList>
				<commodityCode>100000392</commodityCode>
				<commodityName>金螳螂商品01</commodityName>
				<commodityCount>10</commodityCount>
				<colorId>SH00001</colorId>
				<batchId>SCPC001</batchId>
				<supplierCommodityCode>100000392</supplierCommodityCode>
			</commodityList>
			<commodityList>
				<commodityCode>100000392</commodityCode>
				<commodityName>金螳螂商品01</commodityName>
				<commodityCount>10</commodityCount>
				<colorId>SH00001</colorId>
				<batchId>SCPC001</batchId>
				<supplierCommodityCode>100000392</supplierCommodityCode>
			</commodityList>
		</queryCelStorageSub>
		<queryCelStorageSub>
<supplierCode>70057314</supplierCode>
			<purchaseOrderId>10000</purchaseOrderId>
			<appointOrderId>2000017661785</appointOrderId>
			<customerId>1</customerId>
			<refundType>0</refundType>
			<appointStatus>3</appointStatus>
			<appointDate>2015-12-27</appointDate>
			<appointTime>15:00:00</appointTime>
			<createDate>2015-12-23</createDate>
			<createTime>09:29:55</createTime>
			<warehouseName>苏宁物流苏州仓库（金螳螂业务）</warehouseName>
			<contacts>陈某</contacts>
			<supplierPhone>18651662631</supplierPhone>
			<warehouseCode>WM10031477</warehouseCode>
			<commodityList>
				<commodityCode>100000392</commodityCode>
				<commodityName>金螳螂商品01</commodityName>
				<commodityCount>5</commodityCount>
				<colorId>SH00001</colorId>
				<batchId>SCPC001</batchId>
				<supplierCommodityCode>100000392</supplierCommodityCode>
			</commodityList>
			<commodityList>
				<commodityCode>100000392</commodityCode>
				<commodityName>金螳螂商品01</commodityName>
				<commodityCount>10</commodityCount>
				<colorId>SH00001</colorId>
				<batchId>SCPC001</batchId>
				<supplierCommodityCode>100000392</supplierCommodityCode>
			</commodityList>
		</queryCelStorageSub>		
	</sn_body>
</sn_responseContent>
			
                              
                              
{
  "sn_responseContent": {
    "sn_head": {
      "pageTotal": "3",
      "pageNo": "1",
      "totalSize": "23",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryCelStorageSub": [
        {
          "supplierCode": "70057314",
          "purchaseOrderId": "10000",
          "appointOrderId": "2000017661784",
          "customerId": "1",
          "refundType": "0",
          "appointStatus": "3",
          "appointDate": "2015-12-25",
          "appointTime": "15:00:00",
          "createDate": "2015-12-22",
          "createTime": "17:15:59",
          "warehouseName": "苏宁物流苏州仓库（金螳螂业务）",
          "contacts": "陈某",
          "supplierPhone": "18651662631",
          "warehouseCode": "WM10031477",
          "commodityList": [
            {
              "commodityCode": "100000392",
              "commodityName": "金螳螂商品01",
              "commodityCount": "10",
              "colorId": "SH00001",
              "batchId": "SCPC001",
              "supplierCommodityCode": "100000392"
            },
            {
              "commodityCode": "100000392",
              "commodityName": "金螳螂商品01",
              "commodityCount": "10",
              "colorId": "SH00001",
              "batchId": "SCPC001",
              "supplierCommodityCode": "100000392"
            }
          ]
        },
        {
          "supplierCode": "70057314",
          "purchaseOrderId": "10000",
          "appointOrderId": "2000017661785",
          "customerId": "1",
          "refundType": "0",
          "appointStatus": "3",
          "appointDate": "2015-12-27",
          "appointTime": "15:00:00",
          "createDate": "2015-12-23",
          "createTime": "09:29:55",
          "warehouseName": "苏宁物流苏州仓库（金螳螂业务）",
          "contacts": "陈某",
          "supplierPhone": "18651662631",
          "warehouseCode": "WM10031477",
          "commodityList": [
            {
              "commodityCode": "100000392",
              "commodityName": "金螳螂商品01",
              "commodityCount": "5",
              "colorId": "SH00001",
              "batchId": "SCPC001",
              "supplierCommodityCode": "100000392"
            },
            {
              "commodityCode": "100000392",
              "commodityName": "金螳螂商品01",
              "commodityCount": "10",
              "colorId": "SH00001",
              "batchId": "SCPC001",
              "supplierCommodityCode": "100000392"
            }
          ]
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.handler.data-get:no-result 查询为空 请输入正确参数。
biz.fourps.querycelstoragesub.invalid.biz.appointstatus 退库预约单状态，0 预约成功 1预约失败 2已取消 3已退库 请输入正确参数。
biz.fourps.querycelstoragesub.invalid.biz.refundtype 退库类型，0 良品 1 不良品 请输入正确参数。
isp.sys.service.unavailable.mims 服务不可用（系统异常） 请联系苏宁技术人员。
biz.fourps.querycelstoragesub.request-params:error 接口参数错误 请输入正确参数。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：商品退库预约信息批量查询接口如何使用？

A：通过接口进行退库预约信息的批量查询。