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

4PS业务

4PS接单管理API
4PS任务作业API
4PS仓库管理API
4ps仓库库存
4PS商品管理API
异常码自查工具
suning.fourps.celstoragesub.add 商品退库预约申请
￥免费

通过此接口4PS用户可以进行商品退库的预约申请。 1、 商户可对在苏宁仓库的商品进行退库，退库类型包含退良品和退不良品两种。 2、 申请商品退库的数量不能超过可退库存，当为良品退库时，可退库存为可销售库存与良品库存相比较得出，若可销售库存比良品库存小，则良品的可退库数量最大值为可销售库存；若可销售库存比良品库存大，则良品的可退库数量最大值为良品库存。当为不良品退库时，不良品的可退库存为商品在各仓库的不良品库存。商品的各项时时库存数据，均可在库存查询接口中查询到。 3、 退库日期的选择控制在当前日期后的第三天及第三天之后的一周内，如今天是7月1日，则可选择日期范围为7月4日—7月11日。 4、 退库时间的选择控制在9:00-18:00之间。 5、 一次申请的商品种数最多为450种，超过450种则需要另外再行申请。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
warehouseCode String Y L025 仓库ID。已租用的苏宁仓库ID
refundType String Y 1 退库类型。0代表良品；1代表不良品
purchaseOrderId String N 1 采购订单。
customerId String N 1 客户选品单号。
appointDate String Y 2014-11-24 预约退库库日期。
appointTime String Y 18:00 预约退库库时间。
contacts String Y 陈某 承运人。承运人
supplierPhone String Y 18651662631 联系电话。
note String N Test 备注。
commodityCode String N 100020001 商品编码。商家商品编码、商品编码，二者必填其一
colorId String N 1 色号。
batchId String N 1 批次号。
commodityCount String Y 15 申请退库商品数量。
platformCode String Y 001 所属平台。000良品 901 不良品
supplierCommodityCode String N 100020001 商家商品编码。商家商品编码、商品编码，二者必填其一
响应参数
名称 类型 示例值 描述
appointOrderId String 1 退库预约单号。
result String Y 返回结果。Y成功
workId String W100001234 仓库作业单号
errorDesc String 预约时段已满 失败原因
matchDate String 2016-08-30 推荐退库日期。
matchTime String 10:00 推荐退库时间。
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
	<sn_body>
		<addCelStorageSub>
			<warehouseCode>L025</warehouseCode>
			<refundType>1</refundType>
			<purchaseOrderId>1</purchaseOrderId>
			<customerId>1</customerId>
			<appointDate>2014-11-24</appointDate>
			<appointTime>18:00</appointTime>
			<contacts>陈某</contacts>
			<supplierPhone>18651662631</supplierPhone>
			<note>Test</note>
			<commodityList>
				<commodityCode>100020001</commodityCode>
				<colorId>1</colorId>
				<batchId>1</batchId>
				<commodityCount>15</commodityCount>
				<platformCode>001</platformCode>
				<supplierCommodityCode>100000392</supplierCommodityCode>
			</commodityList>
			<commodityList>
				<commodityCode>100020002</commodityCode>
				<colorId>1</colorId>
				<batchId>1</batchId>
				<commodityCount>20</commodityCount>
				<platformCode>001</platformCode>
				<supplierCommodityCode>100000392</supplierCommodityCode>
			</commodityList>
		</addCelStorageSub>
	</sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addCelStorageSub": {
        "warehouseCode": "L025",
        "refundType": "1",
        "purchaseOrderId": "1",
        "customerId": "1",
        "appointDate": "2014-11-24",
        "appointTime": "18:00",
        "contacts": "陈某",
        "supplierPhone": "18651662631",
        "note": "Test",
        "commodityList": [
          {
            "commodityCode": "100020001",
            "colorId": "1",
            "batchId": "1",
            "commodityCount": "15",
            "platformCode": "001",
            "supplierCommodityCode": "100000392"
          },
          {
            "commodityCode": "100020002",
            "colorId": "1",
            "batchId": "1",
            "commodityCount": "20",
            "platformCode": "001",
            "supplierCommodityCode": "100000392"
          }
        ]
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
	<sn_body>
		<addCelStorageSub>
			<appointOrderId>SN20000000001</appointOrderId>
			<workId>W100001234</workId>
			<result>Y</result>			
		</addCelStorageSub>
	</sn_body>
	<sn_head/>
</sn_responseContent>
			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "addCelStorageSub": {
        "appointOrderId": "SN20000000001",
		"workId": "W100001234",
        "result": "Y"
      }
    },
	"sn_head"{
	}
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.fourps.addcelstoragesub.missing-parameter:* 请求参数为空。*号用请求参数字段名替换 请输入正确参数。
biz.fourps.addcelstoragesub.*:format-error 请求参数格式错误。*号用请求参数字段名替换（字段全小写） 请输入正确参数。
isp.sys.service.unavailable.mims 服务不可用（系统异常） 请联系苏宁技术人员。
biz.fourps.addcelstoragesub.invalid-biz:100 预约失败 请输入正确参数。
biz.fourps.addcelstoragesub.request-params:error 接口参数错误 请输入正确参数。
biz.fourps.addcelstoragesub.invalid-biz:commodityCode 商品编码非法，不存在此商品编码或此商品不属于此用户 请输入正确参数。
biz.fourps.addcelstoragesub.invalid-biz:warehouseCode 仓库id字段值非法，不存在此苏宁仓库或此苏宁仓库未被此用户租用 请输入正确参数。
biz.fourps.addcelstoragesub.invalid-biz:101 同一采购订单预约次数不能超过10次 请输入正确参数。
biz.fourps.addcelstoragesub:supplierCode-illegal 商户编码非法 请输入正确参数。
biz.fourps.addcelstoragesub.outofrange:appointDate 预约日期不在范围内 请输入正确参数。
biz.fourps.addcelstoragesub.outofrange:appointTime 预约时间不在范围内 请输入正确参数。
biz.fourps.addcelstoragesub.length-overlong:supplierPhone 联系电话信息超长 请输入正确参数。
biz.fourps.addcelstoragesub.length-overlong:contacts 联系人信息超长 请输入正确参数。
biz.fourps.addcelstoragesub.enumeration-error:platformCode 所属平台枚举值错误 请输入正确参数。
biz.fourps.addcelstoragesub.invalid-biz:102 供应商选定时间预约失败，但未来三天内有符合预约条件日期，请按提示选择 请输入正确参数。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：商品退库预约申请接口如何使用？

A：通过此接口4PS用户可以进行商品退库的预约申请。