API接口目录

4PS业务

4PS接单管理API
4PS任务作业API
4PS仓库管理API
4ps仓库库存
4PS商品管理API
异常码自查工具
suning.fourps.item.modify 商品修改接口
¥免费

通过此接口可对商品信息进行修改。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
supplierCmCode String N 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 N 3375.675 体积。单位:cm3
grossWeight String N 2.002 毛重。单位:kg
netWeight String N 2 净重。单位:kg
shelfLifeFlag String N 0 是否保质期商品。0是、1否
packingList String N 30 装箱清单
shelfLife 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 N R0000012 类目编码。
brandCode String N B123 品牌编码。
cmType String N 02 商品类型。01常温02恒温03冷藏04冷冻05防潮06防尘
cmTitle String N 商品标题 商品标题
cmArea String N 00 产地,默认值:国产产地:00 国产 01 进口
响应参数
名称 类型 示例值 描述
succeFlag String Y 是否成功。Y
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
	<sn_body>
		<modifyItem>
			<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>R0000012</categoryCode>
			<brandCode>B123</brandCode>
			<cmType>02</cmType>
			<cmTitle>商品的标题</cmTitle>
			<cmArea>00</cmArea>
		</modifyItem>
	</sn_body>
</sn_request>
			
                                
                                
{
	"sn_request": {
		"sn_body": {
			"modifyItem": {
				"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": "R0000012",
				"brandCode": "B123",
				"cmType": "02",
				"cmTitle": "商品的标题",
				"cmArea": "00"
			}	
		}
	}
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
	<sn_body>
		<modifyItem>
			<succeFlag>Y</succeFlag>
		</modifyItem>
	</sn_body>
</sn_responseContent>
			
                              
                              
{
	"sn_responseContent": {
		"sn_body": {
			"modifyItem": { "succeFlag": "Y" }
		}
	}
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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

Q:商品修改接口接口如何使用?

A:通过此接口可对商品信息进行修改。