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

4PS业务

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

通过此接口可添加商品。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
supplierCmCode String Y 102608836 商家商品编码(69码)。商家商品编码
productName String Y IPHONE6S 商品名称。商品名称
gbCode String N 690024411 商品国标码。必须为英文或数字
cmLength String N 15.001 长（含包装）/mm。最多三位小数，且为非负数，单位：mm
cmWidth String N 15.001 宽（含包装）/mm。最多三位小数，且为非负数，单位：mm
cmHeight String N 15.001 高（含包装）/mm。单位：mm
cmVolume String Y 3375.675 体积。单位：cm3
grossWeight String Y 2.002 毛重。单位：kg
netWeight String N 2 净重。单位：kg
shelfLifeFlag String Y 0 是否保质期商品。0是、1否
shelfLife String N 30 保质期。单位：天
packingList String N 30 装箱清单
categoryName1 String N 20 商品一级类目。商品一级类目
categoryName2 String N 20 商品二级类目。商品二级类目
brandName String N 20 品牌。品牌
standard String N 20 规格。规格
model String N 40 型号。型号
categoryCode String Y 20 类目编码
brandCode String Y 20 品牌编码
cmType String Y 40 商品类型
cmTitle String N 商品标题 商品标题
cmArea String Y 00 产地,默认值：国产产地:00 国产 01 进口
响应参数
名称 类型 示例值 描述
succeFlag String Y 是否成功。Y
fpsCode String 13245679 4PS商品编码。13245679
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
	<sn_body>
		<addItem>
			<supplierCmCode>102608836</supplierCmCode>
			<productName>IPHONE6S</productName>
			<gbCode>690024411</gbCode>
			<cmLength>15.001</cmLength>
			<cmWidth>15.001</cmWidth>
			<cmHeight>15.001</cmHeight>
			<cmVolume>3375.675</cmVolume>
			<grossWeight>2.002</grossWeight>
			<netWeight>2</netWeight>
			<shelfLifeFlag>0</shelfLifeFlag>
			<shelfLife>30</shelfLife>
			<packingList>30</packingList>
			<categoryName1>20</categoryName1>
			<categoryName2>20</categoryName2>
			<brandName>20</brandName>
			<standard>20</standard>
			<model>40</model>
			<categoryCode>20</categoryCode>
			<brandCode>8</brandCode>
			<cmType>2</cmType>
			<cmTitle>商品的标题</cmTitle>
			<cmArea>00</cmArea>
		</addItem>
	</sn_body>
</sn_request>
			
                                
                                
{
	"sn_request": {
		"sn_body": {
			"addItem": {
				"supplierCmCode": "102608836",
				"productName": "IPHONE6S",
				"gbCode": "690024411",
				"cmLength": "15.001",
				"cmWidth": "15.001",
				"cmHeight": "15.001",
				"cmVolume": "3375.675",
				"grossWeight": "2.002",
				"netWeight": "2",
				"shelfLifeFlag": "0",
				"shelfLife": "30",
				"packingList": "30",
				"categoryName1": "20",
				"categoryName2": "20",
				"brandName": "20",
				"standard": "20",
				"model": "40",
				"categoryCode": "20",
				"brandCode": "8",
				"cmType": "2",
				"cmTitle": "商品的标题",
				"cmArea": "00"
			}
		}
	}
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
	<sn_body>
		<addItem>
			<succeFlag>Y</succeFlag>
			<fpsCode>1012012</fpsCode>
		</addItem>
	</sn_body>
</sn_responseContent>
			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "addItem": {
        "succeFlag": "Y",
        "fpsCode": "1012012"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.fourps.additem.missing-parameter:* 请求参数为空。*号用请求参数字段名替换 请输入正确参数。
biz.fourps.additem.*:format-error 请求参数格式错误。*号用请求参数字段名替换（字段全小写） 请输入正确参数。
biz.fourps.additem.missing-parameter:suppliercode 商家编码必填 请输入正确参数。
biz.fourps.additem.invalid-biz:suppliercode 商家编码格式为8为数字 请输入正确参数。
biz.fourps.additem.missing-parameter:suppliercmcode 商家商品编码必填 请输入正确参数。
biz.custom.additem.suppliercmcode:length-overlong 商家商品编码长度超过30 请输入正确参数。
biz.custom.additem.suppliercmcode:value-existence 商家商品编码已存在 请输入正确参数。
biz.fourps.additem.missing-parameter:productName 商品名称必填 请输入正确参数。
biz.custom.additem.productname:length-overlong 商品名称超过100位 请输入正确参数。
biz.custom.additem.productname:value-existence 该商品名称存在 请输入正确参数。
biz.fourps.additem.invalid-biz: cmlength 长度无效 请输入正确参数。
biz.fourps.additem.invalid-biz:cmwidth 宽度无效 请输入正确参数。
biz.fourps.additem.invalid-biz:cmheight 高度无效 请输入正确参数。
biz.fourps.additem.invalid-biz:cmvolume 体积无效 请输入正确参数。
biz.fourps.additem.invalid-biz:grossweight 毛重无效 请输入正确参数。
biz.custom.additem.invalid-biz:101 毛重须大于等于净重 请输入正确参数。
biz.fourps.additem.invalid-biz:netweight 净重无效 请输入正确参数。
biz.custom.additem.gbcode:length-overlong 商品国标码超过18 请输入正确参数。
biz.fourps.additem.invalid-biz:gbcode 商品国标码无效 请输入正确参数。
biz.fourps.additem.invalid-biz:shelflifeflag 是否保质期无效 请输入正确参数。
biz.fourps.additem.missing-parameter:shelfLife 保质期为空 请输入正确参数。
biz.fourps.additem.invalid-biz:shelfLife 保质期无效 请输入正确参数。
biz.fourps.additem.invalid-biz:packinglist 装箱清单长度超过60 请输入正确参数。
biz.custom.additem.categoryname1:length-overlong 商品一级类目长度超过20 请输入正确参数。
biz.custom.additem.invalid-biz:102 非金螳螂商家无需商品一级类目 请输入正确参数。
biz.custom.additem.categoryname2:length-overlong 商品二级类目长度超过20 请输入正确参数。
biz.custom.additem.invalid-biz:103 非金螳螂商家无需商品二级类目 请输入正确参数。
biz.custom.additem.brandname:length-overlong 品牌长度超过20 请输入正确参数。
biz.custom.additem.invalid-biz:104 非金螳螂商家无需品牌 请输入正确参数。
biz.custom.additem.standard:length-overlong 规格长度超过20 请输入正确参数。
biz.custom.additem.invalid-biz:105 非金螳螂商家无需规格 请输入正确参数。
biz.custom.additem.model:length-overlong 型号长度超过40 请输入正确参数。
biz.custom.additem.invalid-biz:106 非金螳螂商家无需型号 请输入正确参数。
biz.fourps.additem.invalid-biz:model 型号无效 请输入正确参数。
isp.sys.service.unavailable.mims 服务不可用（系统异常） 请联系苏宁技术人员。
biz.custom.additem.invalid-biz:107 商品标题字段过长 字段长度100以内
biz.custom.additem.invalid-biz:108 商品产地为空 请查看商品产地必填性说明
biz.custom.additem.invalid-biz:109 商品产地数据无效 请查看商品产地的说明信息
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：商品申请接口接口如何使用？

A：通过此接口可添加商品。