开放平台接口文档
  • 基础

    • 调用方法
    • 关于鉴权
    • 业务建议
    • 文字符号
    • 返回信息代码含义
  • 物流接口

    • 预报订单
    • 获取面单
    • 费用查询
    • 取消订单
    • 批量取消订单
    • 订单轨迹
    • 预上网推送
    • 获取订单列表
    • 获取用户信息
    • 获取物流服务列表
  • 仓库接口

    • 出库业务流程
    • 创建出库订单
    • 获取出库订单
    • 获取仓库列表
    • 拦截出库订单
    • 获取库存信息
    • 入库业务流程
    • 创建商品
      • 请求参数
      • 返回信息
        • 创建成功
        • 创建失败
    • 更新商品
    • 获取商品列表
    • 创建入库订单
    • 取消入库订单
    • 获取入库订单
    • 获取箱唛文件
  • 基础
  • 仓库接口
Admin
2025-08-05
目录

创建商品

POST /wms/goodsAdd

# 请求参数

请求参数列表:

参数名称 必须 描述 类型
goods_sku 是 商品SKU String
goods_img 否 商品图片URL String
en_name 是 商品英文名称 String
cn_name 是 商品中文名称 String
goods_des 否 商品描述 String
declare_value 是 申报价值 String
good_weight1 是 商品重量(磅) String
good_weight2 是 商品重量(盎司) String
goods_length 是 商品长度(英寸) String
goods_width 是 商品宽度(英寸) String
goods_height 是 商品高度(英寸) String
goods_unit 是 商品单位(1为个) Number
hscode 否 海关编码 String
coo 否 原产国代码 String
brand 否 品牌 String
is_take_battery 否 是否含电池(0:否,1:是) Number
min_stock_warning 否 最低库存预警数量 Number
product_sell_url 否 商品销售链接 String
goods_cate_id 否 商品分类ID Number

请求示例:

{
    "goods_sku": "SKU123456",
    "goods_img": "",
    "en_name": "Test Product EN",
    "cn_name": "测试商品",
    "goods_des": "这是测试商品描述",
    "declare_value": "100",
    "good_weight1": "1.2",
    "good_weight2": "19.2",
    "goods_length": "10",
    "goods_width": "5",
    "goods_height": "3",
    "goods_unit": 1,
    "hscode": "123456",
    "coo": "CN",
    "brand": "TestBrand",
    "is_take_battery": 0,
    "min_stock_warning": 5,
    "product_sell_url": "https://product.example.com",
    "goods_cate_id": 12
}

# 返回信息

接口返回创建商品结果的json数据

响应参数列表:

参数名称 描述
code 状态码
msg 返回信息
goods_id 商品ID

# 创建成功

完整响应数据示例:

{
    "code": 200,
    "msg": "添加成功",
    "goods_id": "191"
}

# 创建失败

完整响应数据示例:

{
    "code": 100,
    "msg": "SKU已存在,请检查"
}
入库业务流程
更新商品

← 入库业务流程 更新商品→

  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式