do-add-stock (新增商品)

公共参数

接口地址 http://openapi.mabangerp.com
提交方式 POST
HTTP Header Content-Type: application/json
Authorization: 签名
签名:HTTP Body所有入参的字符串JSON格式和开发者密钥传递给HMAC-SHA256哈希算法来计算签名
HMAC签名函数的输出是二进制字符串。这需要进行十六进制编码以生成签名字符串。
例如:
HTTP Body所有入参的字符串JSON:{"developerId":10000,"timestamp":1592478495,"action":"get-order-list"}
开发者密钥:c5540d632392451a0ad89721d0705ce24cb2
生成的签名: ae6dbd7743e05cafb8b3b17b7f11d4379a2392a8da119acf66082a3262651f96
HTTP Body HTTP正文应仅包含序列化的JSON字符串(所有入参的数据)
请求频率 每分钟300个请求, 在响应头中可查看(限制X-RateLimit-Limit, 剩余X-RateLimit-Remaining)

公共请求参数:

名称 类型 必须 描述
developerId String 开发者账号(需联系客服开通)
timestamp String Unix 时间戳;接口有效时间半小时
action String 方法:do-add-stock

公共响应参数:

名称 类型 必须 描述
code String 请求失败返回的错误码
message String 请求失败返回的错误信息

请求参数

名称
类型
必须
示例值
描述
stockSku
String
true
库存sku
nameCN
String
true
商品名称,建议中文名称
nameEN
String
false
备用商品名称,建议英文名称
status
String
true
1
商品状态:1.自动创建 2.待开发 3.正常 4.清仓 5.停止销售
picture
String
false
商品图片
length
String
false
width
String
false
height
String
false
weight
String
false
重量
originalSku
String
false
原厂sku
parentCategoryName
String
false
一级目录名称
declareEname
String
false
申报英文名称
declareName
String
false
申报中文名称
declareValue
String
false
申报价值
noLiquidCosmetic
String
false
0
0:非液体,2:液体(化妆品),1:非液体(化妆品),3:液体(非化妆品)
declareCode
String
false
报关编码
purchasePrice
String
false
最新采购价
brandName
String
false
品牌名称
hasBattery
String
false
2
带电池 1.是 2.否
isTort
String
false
2
侵权 1.是 2.否
magnetic
String
false
2
带磁 1.是 2.否
powder
String
false
2
粉末 1.是 2.否
categoryName
String
false
二级目录名称
salePrice
String
false
售价
defaultCost
String
false
统一成本价
remark
String
false
商品备注
purchaseRemark
String
false
采购备注
autoCreateSupplier
String
false
1
供应商不存在,是否自动创建供应商,默认2不创建
buyerId
String
false
采购员名称
artDesignerName
String
false
美工1号
美工名称
developerName
String
false
开发1号
开发员名称
salesName
String
false
销售员1号
销售员名称
creatorName
String
false
创建员工
suppliersData
JSON
false
多维
关联供应商信息
warehouseData
JSON
true
多维
仓库信息json格式
labelData
JSON
false
多维
自定义分类json格式
attributesData
JSON
false
多维
多属性json格式
virtualSkus
String
false
虚拟sku,多个英文分号隔开

响应参数

名称
类型
示例值
描述
code
String
0000
999失败;000成功
message
String
新增成功
描述信息
stockId
String
12423434554769
Erp商品编号

异常示例

 {
    "code":999,
    "message":失败原因
}
 

错误码解释

错误码 错误消息
000 成功
999 失败描述