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

SWL业务

入库
退库
仓库
异常码自查工具
suning.swl.productstorage.add 商品入库预约申请
￥免费

SWL商户通过接口进行商品入库的预约申请。 1、 只能选择申请租用成功的苏宁仓库，进行商品入库预约。 2、 如果商品含有子商品，只能使用苏宁子商品编码或者苏宁子商品编码进行商品入库预约。 3、 入库日期的选择控制在当前日期的第二天及第二天之后的一周内，如当前日期为7月1日，可选择日期为7月2日—7月9日。 4、 入库时间的选择控制在9:00-18:00之间。 5、 一次申请的商品种数最多为450种，超过450种则需要另外再行申请。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
warehouseCode String N L025 仓库ID。已租用的苏宁仓库ID
storageDate String N 2014-11-24 预约入库日期
storageTime String N 18:00 预约入库时间
carrier String N 陈某 承运人
contactsNumber String N 18651662631 联系电话
waybill String N EMS00129322 运单号
commodityCode String N 100020001 苏宁商品编码。如果商品含有子商品，请用苏宁子商品编码。苏宁商品编码与商家商品编码必填其一，两者都填，以苏宁商品编码为准
supplierCommCode String N B-10019 商家商品编码。苏宁商品编码与商家商品编码必填其一
count String N 15 商品数量。预约入库的商品数量（范围0-999999）
commodityCode String N 100020001 苏宁商品编码。如果商品含有子商品，请用苏宁子商品编码。苏宁商品编码与商家商品编码必填其一，两者都填，以苏宁商品编码为准
supplierCommCode String N B-10019 商家商品编码。苏宁商品编码与商家商品编码必填其一
count String N 15 商品数量。预约入库的商品数量（范围0-999999）
响应参数
名称 类型 示例值 描述
orderId String SN20000000001 入库预约单号
recommendDate String 推荐入库日期
result String N 状态。Y成功；N失败
reason String 状态为N时 返回
state String 预约单状态。生成预约单成功后 才会有Y 成功 N 失败
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                

<sn_request>
		<sn_body>
			<addProductStorage>
				<warehouseCode>L025</warehouseCode>
				<storageDate>2014-11-24</storageDate>
				<storageTime>18:00</storageTime>
				<carrier>陈某</carrier>
				<contactsNumber>18651662631</contactsNumber>
				<waybill>EMS00129322</waybill>
				<commoditys>
					<commodityCode>100020001</commodityCode>
					<supplierCommCode>B-10019</supplierCommCode>
					<count>15</count>
				</commoditys>
				<commoditys>
					<commodityCode>100020002</commodityCode>
					<supplierCommCode>B-10018</supplierCommCode>
					<count>20</count>
				</commoditys>
			</addProductStorage>
		</sn_body>
</sn_request>

			
	  
                                
                                

{
  "sn_request": {
    "sn_body": {
      "addProductStorage": {
        "warehouseCode": "L025",
        "storageDate": "2014-11-24",
        "storageTime": "18:00",
        "carrier": "陈某",
        "contactsNumber": "18651662631",
        "waybill": "EMS00129322",
        "commoditys": [
          {
            "commodityCode": "100020001",
            "supplierCommCode": "B-10019",
            "count": "15"
          },
          {
            "commodityCode": "100020002",
            "supplierCommCode": "B-10018",
            "count": "20"
          }
        ]
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              

<sn_responseContent>
		<sn_body>
			<addProductStorage>
				<orderId>SN20000000001</orderId>
				<result>Y</result>
				<state>Y</state>
			</addProductStorage>
		</sn_body>
		<sn_head/>
</sn_responseContent>

			
      
                              
                              

{
  "sn_responseContent": {
    "sn_body": {
      "addProductStorage": {
        "orderId": "SN20000000001",
        "result": "Y",
        "state": "Y"
      }
    },
	"sn_head":{
	}
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.swl.addproductstorage.missing-parameter:warehouseCode 仓库ID为空 请输入正确参数。
biz.swl.addproductstorage.missing-parameter:storageDate 预约入库日期为空 请输入正确参数。
biz.swl.addproductstorage.storagedate:format-error 预约入库日期格式错误 请输入正确参数。
biz.swl.addproductstorage.storagetime:format-error 预约入库时间时间格式错误 请输入正确参数。
biz.swl.addproductstorage.missing-parameter:storageTime 预约入库时间为空 请输入正确参数。
biz.swl.addproductstorage.missing-parameter:carrier 承运人为空 请输入正确参数。
biz.swl.addproductstorage.missing-parameter:contactsNumber 联系电话为空 请输入正确参数。
biz.swl.addproductstorage.invalid-biz:102 预约入库商品总数超过450 请输入正确参数。
biz.swl.addproductstorage.missing-parameter:count 商品数量为空 请输入正确参数。
biz.swl.addproductstorage.invalid-biz:103 商家商品编码。苏宁商品编码与商家商品编码必填其一 请输入正确参数。
biz.swl.addproductstorage.count:format-error 预约入库的商品数量（范围0-999999） 请输入正确参数。
biz.swl.addproductstorage.storagedate:outofrange 预约入库日期不在范围内 请输入正确参数。
biz.swl.addproductstorage.storagetime:outofrange 预约入库时间不在范围内 请输入正确参数。
biz.swl.addproductstorage.carrier:length-overlong 联系人长度过长 请输入正确参数。
biz.swl.addproductstorage.contactsnumber:length-overlong 联系电话长度过长 请输入正确参数。
biz.swl.addproductstorage.waybill:length-overlong 运单号长度过长 请输入正确参数。
biz.swl.addproductstorage.invalid-biz:100 商户无此商品 请输入正确参数。
biz.swl.addproductstorage.invalid-biz:101 商户商品与仓库大小件不符 请输入正确参数。
biz.swl.addproductstorage.invalid-biz:104 商品数据重复 请输入正确参数。
isp.sys.service.unavailable.mims 服务不可用（系统异常） 请联系苏宁技术人员。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

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

A：通过此接口可商品入库预约申请