跳到主要内容

清空商品字段

接口描述​

根据商品编码清空指定的商品字段。

系统相关界面​

"界面路径：【商品】----【商品档案V2】----【编辑】"

请求地址​

环境服务地址(HTTP/HTTPS)
V2正式环境（推荐）https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key，统一使用V2正式环境的请求地址：https://gw.superboss.cc/router

公共参数​

调用任何一个API都必须传入的参数，目前支持的公共参数有：

参数名称参数类型是否必须参数描述
methodstring是API接口名称
appKeystring是分配给应用的AppKey
timestampstring是时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
formatstring否响应格式。默认为json格式，可选值：json
versionstring是API协议版本 可选值：1.0
sign_methodstring否签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。
signstring是签名
sessionstring是授权会话信息 （即access_token，由系统分配）

请求头​

全部展开
参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded;charset=UTF-8
必填

API接口地址​

全部展开
参数名
类型
描述
必填
method
string
erp.item.clear.field
必填

请求参数​

全部展开
参数名
类型
描述
必填
outerId
string
商品编码
必填
fieldName
string
需要清空的商品字段名称，多个字段逗号分隔
必填

请求示例​

{
  "outerId": "ITEM-001",
  "fieldName": "barcode"
}

响应参数​

全部展开
参数名
类型
描述
必填
success
boolean
请求是否成功
必填
trace_id
string
请求ID，用于问题排查
必填

响应示例​

{
  "success": true,
  "trace_id": "3553483395407017"
}

异常示例​

{
  "code": "25",
  "msg": "服务方法(erp.item.clear.field:1.0)的签名无效",
  "success": false,
  "trace_id": "3553483395423660"
}

错误码解释​

错误码错误信息解决方案
25签名无效请检查签名参数和签名生成方式
32待清除的商品字段名称不能为空请检查fieldName是否有值
33系统商品编码必传或不支持清除指定商品字段请检查outerId和fieldName是否正确