退出
热词搜索： 订单API 接口 查询退款订单 6五四三二一 appkey
API接口目录

SWL业务

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

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

公共参数
请求参数
名称 类型 是否必须 示例值 描述
warehouseCode String N L025 仓库ID。已租用的苏宁仓库ID
refundType String N 1 退库类型。0代表良品；1代表不良品
appointDate String N 2014-11-24 预约退库日期
appointTime String N 18:00 预约退库时间
contacts String N 陈某 承运人
supplierPhone String N 18651662631 联系电话
commodityCode String N 100020001 苏宁商品编码。如果商品含有子商品，请用苏宁子商品编码。苏宁商品编码与商家商品编码必填其一，两者都填，以苏宁商品编码为准
supCommCode String N B-10019 商家商品编码。苏宁商品编码与商家商品编码必填其一
refundCount String N 15 申请退库商品数量
commodityCode String N 100020001 苏宁商品编码。如果商品含有子商品，请用苏宁子商品编码。苏宁商品编码与商家商品编码必填其一，两者都填，以苏宁商品编码为准
supCommCode String N B-10019 商家商品编码。苏宁商品编码与商家商品编码必填其一
refundCount String N 15 申请退库商品数量
响应参数
名称 类型 示例值 描述
appointOrderId String SN20000000001 退库预约单号
scheduledDate String 可预约退库的日期
scheduledTime String 可预约退库的时间
result String Y 状态。Y成功；N失败
message String 状态为N时 返回
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                

<sn_request>
		<sn_body>
			<addProductBackStorage>
				<warehouseCode>L025</warehouseCode>
				<refundType>1</refundType>
				<appointDate>2014-11-24</appointDate>
				<appointTime>18:00</appointTime>
				<contacts>陈某</contacts>
				<supplierPhone>18651662631</supplierPhone>
				<commodityList>
					<commodityCode>100020001</commodityCode>
					<supCommCode>B-10019</supCommCode>
					<refundCount>15</refundCount>
				</commodityList>
				<commodityList>
					<commodityCode>100020002</commodityCode>
					<supCommCode>B-10018</supCommCode>
					<refundCount>20</refundCount>
				</commodityList>
			</addProductBackStorage>
		</sn_body>
</sn_request>

			
	  
                                
                                

{
  "sn_request": {
    "sn_body": {
      "addProductBackStorage": {
        "warehouseCode": "L025",
        "refundType": "1",
        "appointDate": "2014-11-24",
        "appointTime": "18:00",
        "contacts": "陈某",
        "supplierPhone": "18651662631",
        "commodityList": [
          {
            "commodityCode": "100020001",
            "supCommCode": "B-10019",
            "refundCount": "15"
          },
          {
            "commodityCode": "100020002",
            "supCommCode": "B-10018",
            "refundCount": "20"
          }
        ]
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              

<sn_responseContent>
		<sn_body>
			<addProductBackStorage>
				<appointOrderId>SN20000000001</appointOrderId>
				<result>Y</result>
			</addProductBackStorage>
		</sn_body>
		<sn_head/>
</sn_responseContent>

			
      
                              
                              

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

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.swl.addproductbackstorage.missing-parameter:warehouseCode 仓库ID为空 请输入正确参数。
biz.swl.addproductbackstorage.missing-parameter:refundType 退库类型为空 请输入正确参数。
biz.swl.addproductbackstorage.missing-parameter:refundCount 申请退库商品数量为空 请输入正确参数。
biz.swl.addproductbackstorage.missing-parameter:appointDate 预约退库日期为空 请输入正确参数。
biz.swl.addproductbackstorage.appointdate:format-error 预约退库日期时间格式错误 请输入正确参数。
biz.swl.addproductbackstorage.missing-parameter:appointTime 预约退库时间为空 请输入正确参数。
biz.swl.addproductbackstorage.appointtime:format-error 预约退库时间格式错误 请输入正确参数。
biz.swl.addproductbackstorage.missing-parameter:contacts 承运人为空 请输入正确参数。
biz.swl.addproductbackstorage.missing-parameter:supplierPhone 联系电话为空 请输入正确参数。
biz.swl.addproductbackstorage.invalid-biz:100 商家商品编码。苏宁商品编码与商家商品编码必填其一 请输入正确参数。
biz.swl.addproductbackstorage.invalid-biz:103 申请退库商品数量超过450 请输入正确参数。
biz.swl.addproductbackstorage.invalid-biz:101 预约失败，请使用推荐日期进行预约 请输入正确参数。
biz.swl.addproductbackstorage.invalid-biz:102 可退数量异常，扣减库存失败 请输入正确参数。
biz.swl.addproductbackstorage.appointtime:outofrange 预约时间不在范围内 请输入正确参数。
biz.swl.addproductbackstorage.appointdate:outofrange 预约日期不在范围内 请输入正确参数。
biz.swl.addproductbackstorage.supplierphone:length-overlong 联系电话字段过长！ 请输入正确参数。
biz.swl.addproductbackstorage.contacts:length-overlong 联系人字段过长！ 请输入正确参数。
biz.swl.addproductbackstorage.commoditycode:value-inexistence 苏宁商品编码值不存在 请输入正确参数。
biz.swl.addproductbackstorage.warehousecode:value-inexistence 仓库ID值不存在 请输入正确参数。
biz.swl.addproductbackstorage.refundcount:format-error 申请退库商品的数量格式错误 请输入正确参数。
biz.swl.addproductbackstorage.refundcount:outofrange 申请退库商品的数量（范围0-999999） 请输入正确参数。
biz.swl.addproductbackstorage.invalid-biz:104 申请退库数量大于可退数量 请输入正确参数。
isp.sys.service.unavailable.mims 服务不可用（系统异常） 请联系苏宁技术人员。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

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

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