提供商品新增、修改和编辑功能。
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
operType | String | Y | 00(00:新建 01:审核不通过时修改 02:编辑) | 操作类型 |
applyCode | String | N | 1be9df8f-94fb-43f9-962c-125bfc621a6e | 申请编码 |
productCode | String | N | xxx | 苏宁商品编码 |
storeCode | String | N | xxx | 苏宁门店编码 |
appStoreCode | String | N | xx | 商家门店编码 |
categoryCode | String | Y | xx | 四级类目编码 |
productName | String | Y | xxx | 商品名称 |
brandCode | String | N | xxx | 商品品牌 |
cmBarcode | String | N | xx | 商品条码 |
brgew | String | N | xx | 毛重 |
supplierCmCode | String | N | xxx | 商家商品编码 |
advertise | String | N | xxx | 广告词 |
picUrl | String | Y | http://xx/xx/xx/xx/x1.jpg(逗号隔开共5张) | 商品图片 |
classifyCode | String | Y | xxx | 一级店内分类编码 |
secondClassifyCode | String | N | xxx | 二级店内分类编码 |
sellPrice | String | Y | xxx | 价格 |
packingPrice | String | N | xxx | 餐盒费 |
qty | String | Y | xxx | 库存 |
deliveryAttr | String | N | 01(01-常温 02-恒温 03-冷藏 04-冷冻) | 配送属性 |
purchaseMin | String | Y | 1 | 起购量 |
serviceTime | String | N | 1-24 | 服务时长 |
immediateAppoint | String | N | 01(01:支持 02:不支持) | 立即预约 |
immediateAppointTime | String | N | xxx | 立即预约时长 |
sellStatus | String | Y | 1(1:上架 2:下架) | 上下架状态 |
sellHoursType | String | Y | 01 | 售卖方式 |
standardInfo | String | N | ||
standardName | String | N | 尺寸 | 规格名 |
standardCode | String | N | xxx | 规格编码 |
isMulti | String | N | 0(0:否 1:是) | 是否支持消费者多选 |
choiceInfo | String | N | ||
choiceName | String | N | 大杯 | 选项名称 |
choiceCode | String | N | xxx | 选项编码 |
choicePrice | String | N | 1 | 加价金额 |
attrInfo | String | N | ||
attrName | String | N | 温度 | 属性名称 |
attrCode | String | N | xxx | 属性编码 |
attrIsMulti | String | N | 0(0:否 1:是) | 是否支持多选 |
attrChoiceInfo | String | N | ||
attrChoiceName | String | N | 加冰 | 选项名称 |
attrChoiceCode | String | N | xxx | 选项编码 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
returnFlag | String | Y(Y成功;N失败;) | 结果 |
<sn_request> <sn_body> <createCommodityedit> <sellPrice>xxx</sellPrice> <sellStatus>1(1:上架 2:下架)</sellStatus> <advertise>xxx</advertise> <brgew>xx</brgew> <secondClassifyCode>xxx</secondClassifyCode> <sellHoursType>01</sellHoursType> <standardInfo> <choiceInfo> <choicePrice>1</choicePrice> <choiceCode>xxx</choiceCode> <choiceName>大杯</choiceName> </choiceInfo> <isMulti>0(0:否 1:是)</isMulti> <standardName>尺寸</standardName> <standardCode>xxx</standardCode> </standardInfo> <classifyCode>xxx</classifyCode> <brandCode>xxx</brandCode> <serviceTime>1-24</serviceTime> <deliveryAttr>01(01-常温 02-恒温 03-冷藏 04-冷冻)</deliveryAttr> <operType>00(00:新建 01:审核不通过时修改 02:编辑)</operType> <picUrl>http://xx/xx/xx/xx/x1.jpg(逗号隔开共5张)</picUrl> <immediateAppoint>01(01:支持 02:不支持)</immediateAppoint> <productCode>xxx</productCode> <purchaseMin>1</purchaseMin> <attrInfo> <attrIsMulti>0(0:否 1:是)</attrIsMulti> <attrChoiceInfo> <attrChoiceName>加冰</attrChoiceName> <attrChoiceCode>xxx</attrChoiceCode> </attrChoiceInfo> <attrName>温度</attrName> <attrCode>xxx</attrCode> </attrInfo> <categoryCode>xx</categoryCode> <qty>xxx</qty> <appStoreCode>xx</appStoreCode> <supplierCmCode>xxx</supplierCmCode> <cmBarcode>xx</cmBarcode> <applyCode>1be9df8f-94fb-43f9-962c-125bfc621a6e</applyCode> <immediateAppointTime>xxx</immediateAppointTime> <productName>xxx</productName> <packingPrice>xxx</packingPrice> <storeCode>xxx</storeCode> </createCommodityedit> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "createCommodityedit": { "sellStatus": "1(1:上架 2:下架)", "sellPrice": "xxx", "advertise": "xxx", "brgew": "xx", "sellHoursType": "01", "secondClassifyCode": "xxx", "standardInfo": [ { "choiceInfo": [ { "choicePrice": "1", "choiceCode": "xxx", "choiceName": "大杯" } ], "isMulti": "0(0:否 1:是)", "standardCode": "xxx", "standardName": "尺寸" } ], "classifyCode": "xxx", "brandCode": "xxx", "serviceTime": "1-24", "deliveryAttr": "01(01-常温 02-恒温 03-冷藏 04-冷冻)", "operType": "00(00:新建 01:审核不通过时修改 02:编辑)", "picUrl": "http://xx/xx/xx/xx/x1.jpg(逗号隔开共5张)", "immediateAppoint": "01(01:支持 02:不支持)", "productCode": "xxx", "purchaseMin": "1", "attrInfo": [ { "attrIsMulti": "0(0:否 1:是)", "attrName": "温度", "attrChoiceInfo": [ { "attrChoiceName": "加冰", "attrChoiceCode": "xxx" } ], "attrCode": "xxx" } ], "categoryCode": "xx", "qty": "xxx", "appStoreCode": "xx", "supplierCmCode": "xxx", "cmBarcode": "xx", "applyCode": "1be9df8f-94fb-43f9-962c-125bfc621a6e", "immediateAppointTime": "xxx", "productName": "xxx", "storeCode": "xxx", "packingPrice": "xxx" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.store.createcommodityedit.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
isp.sys.service.unavailable.mcmp | 服务不可用 | 请联系苏宁技术人员 |
biz.store.createcommodityedit.invalid-biz:100 | 该服务商品已经发布,请走编辑场景 | |
biz.store.createcommodityedit.invalid-biz:101 | 该服务商品已发布正在审核中,请耐心等待 | |
biz.store.createcommodityedit.invalid-biz:102 | 服务商家通子码类目,商品编码不能为空! | |
biz.store.createcommodityedit.invalid-biz:103 | 商家编码不能为空! | |
biz.store.createcommodityedit.invalid-biz:104 | 门店编码信息有误! | |
biz.store.createcommodityedit.invalid-biz:105 | 类目编码不能为空! | |
biz.store.createcommodityedit.invalid-biz:106 | 商品名称不能为空! | |
biz.store.createcommodityedit.invalid-biz:107 | 商家编码输入有误! | |
biz.store.createcommodityedit.invalid-biz:108 | 商品名称字段超长! | |
biz.store.createcommodityedit.invalid-biz:109 | 品牌编码不存在! | |
biz.store.createcommodityedit.invalid-biz:110 | 商品修改场景,申请编码不能为空! | |
biz.store.createcommodityedit.invalid-biz:111 | 商家编码与申请编码的关系不存在! | |
biz.store.createcommodityedit.invalid-biz:112 | 商品类目不存在或不是四级类目! | |
biz.store.createcommodityedit.invalid-biz:113 | 没有类目授权! | |
biz.store.createcommodityedit.invalid-biz:114 | 店铺编码和商家编码关系不存在! | |
biz.store.createcommodityedit.invalid-biz:115 | 该类目类型配置的字段列表为空! | |
biz.store.createcommodityedit.invalid-biz:116 | 基本参数必填,不能为空! | |
biz.store.createcommodityedit.invalid-biz:117 | 不存在的商品编码! | |
biz.store.createcommodityedit.invalid-biz:118 | 商家商品编码字段超长! | |
biz.store.createcommodityedit.invalid-biz:119 | 广告词字段超长! | |
biz.store.createcommodityedit.invalid-biz:120 | 配送属性字段值不在可选值范围! | |
biz.store.createcommodityedit.invalid-biz:121 | 最小购买量字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:122 | 最小购买量字段输入不合法! | |
biz.store.createcommodityedit.invalid-biz:123 | 服务时长字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:124 | 服务时长字段值不在可选值范围! | |
biz.store.createcommodityedit.invalid-biz:125 | 立即预约字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:126 | 立即预约字段值不在可选值范围! | |
biz.store.createcommodityedit.invalid-biz:127 | 预约时间字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:128 | 预约时间字段值不在可选值范围! | |
biz.store.createcommodityedit.invalid-biz:129 | 上下架状态字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:130 | 上下架状态字段值不在可选值范围! | |
biz.store.createcommodityedit.invalid-biz:131 | 商品条码只能输入数字、大写字母,最多18位 | |
biz.store.createcommodityedit.invalid-biz:132 | 毛重字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:133 | 毛重字段输入不合法! | |
biz.store.createcommodityedit.invalid-biz:134 | 商品图片字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:135 | 商品图片字段输入不合法! | |
biz.store.createcommodityedit.invalid-biz:136 | 图片域名不正确! | |
biz.store.createcommodityedit.invalid-biz:137 | 图片URL不存在! | |
biz.store.createcommodityedit.invalid-biz:138 | 一级店内分类字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:139 | 售价字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:140 | 售价字段输入不合法! | |
biz.store.createcommodityedit.invalid-biz:141 | 包装费字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:142 | 包装费字段输入不合法! | |
biz.store.createcommodityedit.invalid-biz:143 | 库存字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:144 | 库存字段输入不合法! | |
biz.store.createcommodityedit.invalid-biz:145 | 规格最多5个! | |
biz.store.createcommodityedit.invalid-biz:146 | 规格名字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:147 | 是否支持消费者多选字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:148 | 规格名字段超长! | |
biz.store.createcommodityedit.invalid-biz:149 | 是否支持消费者多选字段值不在可选值范围! | |
biz.store.createcommodityedit.invalid-biz:150 | 规格明细最多6个! | |
biz.store.createcommodityedit.invalid-biz:151 | 规格选项名字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:152 | 加价金额字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:153 | 规格选项名字段超长 | |
biz.store.createcommodityedit.invalid-biz:154 | 加价金额字段输入不合法! | |
biz.store.createcommodityedit.invalid-biz:155 | 规格选项字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:156 | 属性最多5个! | |
biz.store.createcommodityedit.invalid-biz:157 | 属性名字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:158 | 是否支持消费者多选字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:159 | 属性名字段超长! | |
biz.store.createcommodityedit.invalid-biz:160 | 是否支持消费者多选字段值不在可选值范围! | |
biz.store.createcommodityedit.invalid-biz:161 | 属性明细最多6个! | |
biz.store.createcommodityedit.invalid-biz:162 | 属性选项名字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:163 | 属性选项名字段超长! | |
biz.store.createcommodityedit.invalid-biz:164 | 属性选项字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:165 | 商品名称或广告词含有敏感词! | |
biz.store.createcommodityedit.invalid-biz:166 | 报价单收费项内容长度不得大于50! | |
biz.store.createcommodityedit.invalid-biz:167 | 报价单价格不合法 | |
biz.store.createcommodityedit.invalid-biz:168 | 报价单价格字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:169 | 通子码商品子码节点不能为空! | |
biz.store.createcommodityedit.invalid-biz:170 | 子码商品编码不合法! | |
biz.store.createcommodityedit.invalid-biz:171 | 子码条码长度不得超过20! | |
biz.store.createcommodityedit.invalid-biz:172 | 子码商家商品编码长度不得超过40! | |
biz.store.createcommodityedit.invalid-biz:173 | 服务时长字段值不在可选值范围! | |
biz.store.createcommodityedit.invalid-biz:174 | 子码主商品标识长度不得超过2! | |
biz.store.createcommodityedit.invalid-biz:175 | 子码售价字段不能为空! | |
biz.store.createcommodityedit.invalid-biz:176 | 子码售价字段输入不合法! | |
biz.store.createcommodityedit.invalid-biz:177 | 子码销售状态不合法! | |
biz.store.createcommodityedit.invalid-biz:178 | 操作类型不合法! |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |