元仓开放平台
首页元仓客户端
首页元仓客户端
  1. 商品
  • 开发者必读
    • 对接说明
    • 枚举描述
  • 授权
    • 授权
      POST
  • 基础资料
    • 国家
      POST
    • 币种
      POST
    • 元仓渠道(物流公司)
      POST
    • 客户开启的元仓渠道(物流公司)
      POST
    • 元仓仓库
      POST
    • 客户开启的元仓仓库
      POST
    • 元仓平台
      POST
    • 文件上传
      POST
  • 商品
    • 商品分类
      POST
    • 商品货物属性
      POST
    • 商品成交单位
      POST
    • 商品新增
      POST
    • 商品修改
      POST
    • 商品作废
      POST
    • 商品打印标签
      POST
    • 商品列表
      POST
    • 商品详情
      POST
    • 商品发货仓库匹配
      POST
  • 入库
    • 预报入库
      • 运输方式
      • 货物属性
      • 入库新增
      • 入库作废
      • 入库确认
      • 入库详情
      • 入库列表
      • 头程物流成本修改
      • 入库箱唛打印标签
      • 入库完结
    • 入库(不带箱唛)
      • 入库新增
      • 入库作废
      • 入库确认
      • 入库详情
      • 入库列表
      • 入库完结
  • 订单
    • 几大平台对应channelCode字段的取值
    • 订单新增
      POST
    • 订单取消
      POST
    • 订单列表
      POST
    • 订单详情
      POST
    • 标记订单是否上网
      POST
    • 更新物流追踪信息
      POST
  • 库存
    • 库存动态列表
    • 库存盘点列表
    • 库存列表
    • 库龄报表(非实时)
  • 换单
    • 新增订单
    • 订单列表
    • 取消订单
  • 退货
    • 退货单新增
    • 退货单列表
    • 退货单作废
    • 退货单详情
    • 退货单决策
  • 订阅
    • 签名推送测试
    • 预报入库/入库(不带箱唛)推送(状态)
    • 预报入库/入库(不带箱唛)推送(上架明细)
    • 订单推送
    • 退货单推送
    • 库存盘点完结推送
  1. 商品

商品新增

POST
/api/openPlatform/product/add

状态码#

状态码描述
000001成功
000400请求失败,详细见描述(msg)
000401鉴权失败 (token已过期或者token无效)
000403无权限访问
000405请求方法不允许
000422请求数据异常
000429请求太频繁
000500程序内部错误
013001客户SKU已存在
013002客户SKU不存在
013003客户SKU状态非法

请求参数

Header 参数
Authorization
string 
必需
例: Bearer 2296|M9DlZJI54pxcbdtdapSOy4wNkzYKijw5jpjJIhS7
默认值:
Bearer {{token}}
Content-Type
string 
必需
默认值:
application/json
Body 参数application/json
categoryId
integer 
分类ID
必需
见分类接口
customerSku
string 
客户商品编码(SKU)
必需
由2-50位的英文字母(大小写) ,数字 , 空格 , 圆括号( ) , 反斜杠\ , 点. , 中斜杠- , 星号* , 加号+, # 组成
ean
string 
EAN码/条形码/第三方提条码
可选
可以作为仓库扫描出库的依据
thirdErpSku
string 
第三方ERP的商品编码
可选
可以作为仓库扫描出库的依据
productRefCode
string 
参考编码
可选
productName
string 
商品英文名称
可选
productCnName
string 
商品中文名称
必需
productDeclareName
string 
商品申报英文名称
可选
productDeclareCnName
string 
商品申报中文名称
可选
productLink
string 
商品链接
可选
productAttr
integer 
货物属性
可选
见属性接口
productType
integer 
货物类型
可选
1包裹,2信封
hasBrand
integer 
是否有品牌
可选
1有,0没有
brandName
string 
品牌名称
可选
当hasBrand=1必填
unitCode
string 
成交单位
可选
见成交单位接口
productModel
string 
型号
可选
productSpecs
object 
规格信息
必需
length
number 
长CM
必需
width
number 
宽CM
必需
height
number 
高CM
必需
weigh
number 
商品重量G
必需
packageLength
number 
打包后长CM
必需
packageWidth
number 
打包后宽CM
必需
packageHeight
number 
打包后高CM
必需
packageWeigh
number 
打包后商品重量G
必需
use
string 
用途
可选
productImages
array[string]
商品图片
可选
图片链接
outProductCustomsInfo
object 
出口海关信息
可选
country
string 
国家编码
可选
price
number 
申报价格USD
可选
inProductCustomsInfo
array [object {2}] 
进口海关信息
可选
country
string 
国家编码
可选
price
number 
申报价格USD
可选
mainWarehouseCode
string 
主仓编码
可选
refCostPrice
number 
参考成本价(CNY)
可选
示例
{
  "categoryId": 1,
  "customerSku": "AM30991",
  "productRefCode": "AM30991-REF",
  "productName": "LAMP",
  "productCnName": "48FT15头2WLED户外防水灯串英规",
  "productDeclareName": "LAMP",
  "productDeclareCnName": "48FT15头2WLED户外防水灯串英规",
  "productLink": "https://www.amazon.com/Eyekepper-Modern-Single-Waterfall-Bathroom/dp/B00KSW5Q8Q/ref=sr_1_2?s=kitchen-bath&ie=UTF8&qid=1487210962&sr=1-2&keywords=Faucet",
  "productAttr": 0,
  "productType": 0,
  "hasBrand": 1,
  "brandName": "华为",
  "unitCode": "pcs",
  "use": "科研",
  "material": "金属",
  "productModel": "无",
  "productSpecs": {
    "length": 1,
    "width": 1.1,
    "height": 1.2,
    "weigh": 1.3,
    "packageLength": 1,
    "packageWidth": 1,
    "packageHeight": 1,
    "packageWeigh": 1
  },
  "productImages": [
    "https://m.media-amazon.com/images/I/41OAUIloxPL._AC_US40_.jpg",
    "https://m.media-amazon.com/images/I/41rZdeJfI-L._AC_US40_.jpg"
  ],
  "outProductCustomsInfo": {
    "country": "CN",
    "price": 1.44
  },
  "inProductCustomsInfo": [
    {
      "country": "MY",
      "price": 1.22
    },
    {
      "country": "SG",
      "price": 1.33
    }
  ],
  "mainWarehouseCode": "301",
  "refCostPrice": 1
}

返回响应

🟢200成功
application/json
Body
state
string 
必需
msg
string 
必需
data
object 
可选
示例
{
  "state": "string",
  "msg": "string",
  "data": {}
}
上一页
商品成交单位
下一页
商品修改
Built with