开放平台接口文档
  • 基础

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

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

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

获取商品列表

GET /wms/goodsList

# 请求参数

请求参数列表:

参数名称 必须 描述 类型
goods_ids 否 商品ID,多个用逗号分隔 String
sku 否 商品SKU String
limit 否 数据条数,不传默认为20 Number
page 否 页码,不传默认第1页 Number
since 否 起始时间,示例2024-03-20 00:00:00 String
?goods_ids=190,191,192
?sku=SKU123
?limit=10&page=1
?since=2024-08-01 00:00:00

# 返回信息

接口返回商品列表的json数据

响应参数列表:

参数名称 描述
goods_id 商品ID
goods_code 商品代码
goods_sku 商品SKU
cn_name 中文名称
en_name 英文名称
goods_img 商品图片URL
goods_des 商品描述
declare_value 申报价值
goods_length 商品长度(英寸)
goods_width 商品宽度(英寸)
goods_height 商品高度(英寸)
goods_weight 商品重量(磅)
hscode 海关编码
coo 原产国代码
brand 品牌
is_take_battery 是否含电池(0:否,1:是)
min_stock_warning 最低库存预警数量
product_sell_url 商品销售链接
goods_cate_id 商品分类ID
status 商品状态
created_at 创建时间
updated_at 更新时间

完整响应数据示例:

{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "goods_id": 190,
            "goods_code": "SKU123456",
            "goods_sku": "SKU123456",
            "cn_name": "更新产品",
            "en_name": "Updated Product",
            "goods_img": "",
            "goods_des": "这是测试商品描述",
            "declare_value": 100,
            "goods_length": "12.000",
            "goods_width": "6.000",
            "goods_height": "3.000",
            "hscode": "123456",
            "coo": "CN",
            "brand": "NewBrand",
            "is_take_battery": 0,
            "min_stock_warning": 5,
            "product_sell_url": "https://product.example.com",
            "goods_cate_id": 12,
            "created_at": "2025-08-07 04:34:44",
            "updated_at": "2025-08-07 16:34:44",
            "status": 1,
            "goods_weight": 1.5
        }
    ],
    "total": 1,
    "per_page": 20,
    "current_page": 1,
    "last_page": 1
}
更新商品
创建入库订单

← 更新商品 创建入库订单→

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