Home - 商品管理 登录  
最后修改者: huangyingliang  2026-07-01 17:02:08 

商品管理列表查询

编号  :  029

GET - https://fl.tp6.hyj111.cn/admin/goodsManage/list
headers下token必传
请求参数
参数名 参数类型 必传 缺省值 描述
currentPage int N 1 旧前端当前页，兼容字段；优先使用currentPage
page int N 1 当前页；currentPage为空时使用page
pageSize int N 10 旧前端每页条数，兼容字段；优先使用pageSize
limit int N 10 每页条数；pageSize为空时使用limit
search_goods_name string N 商品名称/规格/商品ID/别名/商品公共名称，模糊查询
search_commonid int N 商品ID或公共商品ID，精确查询
search_store_name int N 商户ID，按share_store_goods.vid查询
company_id int N 平台主体ID，按goods.company的主体ID匹配
cid int N 商品分类ID
search_brand_id int N 品牌ID
search_state int N 商品状态：0=仓库中，1=出售中，10=违规下架
search_verify int N 审核状态：0=未通过，1=通过，10=等待审核
is_points int N 0 商品种类：0=普通商品，1=积分商品，不传默认0
is_plan_off_shelf int N 是否待下架：0=否，1=是
is_yidifa int N 是否异地发：0=否，1=是
inventoryStatus int N 库存状态：1=只查负库存
coefficient float N 系数筛选值，需配合cid使用
performance_goods_rate int N 是否设置过业绩系数：1=只查已设置
promotion_man int N 专享价类型：1=合伙人专享价，2=乐销价
unsalable_time int N 滞销时间范围，单位月
unsalable_num int N 0 滞销阈值，配合unsalable_time使用
unsalable_share_store_id int N 滞销共享仓ID，配合unsalable_time使用
share_store_id int N 共享仓ID
vendor_tag_ids string N 商户标签ID集合，多个用英文逗号分隔
gids string N 商品ID集合，多个用英文逗号分隔
type string N 标签页类型：del=已删除，xiajia=已下架，waitverify=待审核，lockup=违规下架
返回值
{
    "status": 200,
    "msg": "ok",
    "data": {
        "list": [
            {
                "gid": 10001, // 商品SKU ID
                "goods_commonid": 9001, // 商品公共ID
                "goods_commonid2": 9001, // 原商品公共ID回显
                "goods_name": "电动车刹车片", // 商品名称
                "spec_relation": "前刹/黑色", // SKU规格
                "alias": "刹车片A款", // 商品别名
                "goods_image": "goods.jpg", // 公共商品图片
                "sku_goods_image": "sku_goods.jpg", // SKU商品图片
                "goods_image_url": "https://img.hyj111.cn/data/upload/mall/store/goods/1/sku_goods.jpg", // 商品缩略图
                "gc_id": 101, // 分类ID
                "gc_name": "刹车系统", // 分类名称
                "brand_id": 12, // 品牌ID
                "brand_name": "示例品牌", // 品牌名称
                "goods_state": 1, // 商品状态：0=仓库中，1=出售中，10=违规下架，100=已删除
                "goods_state_name": "出售中", // 商品状态文案
                "goods_verify": 1, // 审核状态：0=未通过，1=通过，10=等待审核
                "goods_verify_name": "通过", // 审核状态文案
                "goods_sort": 0, // 排序
                "goods_commend": 0, // 推荐状态
                "is_points": 0, // 商品种类：0=普通商品，1=积分商品
                "stock": 120, // 共享仓可用库存合计
                "share_store_stock_sum": 150, // 共享仓总库存合计
                "goods_kucun": 150, // 库存展示值
                "goods_kucun_name": "库存正常", // 库存状态：库存正常/预警/缺货
                "share_store_goods": [
                    {
                        "goods_id": 10001, // 商品SKU ID
                        "share_store_id": 11, // 共享仓ID
                        "gxc_name": "南通仓", // 共享仓名称
                        "label": "南通仓", // 共享仓展示名
                        "price": "1234.56" // 该共享仓库存成本总价
                    }
                ],
                "city_price": "88.00", // 区域价
                "city_price_as_gift": 99.9, // 礼品价
                "promotion_state": 0, // 专享价是否生效：0=否，1=是
                "region_stock": [
                    {
                        "goods_id": 10001, // 商品SKU ID
                        "region_type": 1, // 区位类型
                        "stock": 20, // 区位库存
                        "rack_num": "A01", // 货架号
                        "rack_detail_num": "01", // 货位号
                        "rack_detail": "A01-01" // 货位详情
                    }
                ]
            }
        ],
        "pagination": {
            "current": 1, // 当前页
            "pageSize": 10, // 每页条数
            "total": 1 // 总条数
        },
        "searchlist": {
            "is_points": 0, // 商品种类筛选回显
            "search_goods_name": "刹车" // 商品关键词筛选回显
        },
        "cost_price_arr": [
            {
                "share_store_id": 11, // 共享仓ID
                "gxc_name": "南通仓", // 共享仓名称
                "price": "12345.67" // 共享仓成本总价
            }
        ],
        "region_stock_cost_price_arr": [
            {
                "share_store_id": 11, // 共享仓ID
                "gxc_name": "南通仓", // 共享仓名称
                "price": "9876.54" // 实际库存成本总价
            }
        ]
    }
}
备注
商品管理列表查询；控制器只接收筛选参数，业务查询在app/common/services/goods/GoodsManageServices与app/common/dao/goods/GoodsManageDao中完成。返回list为商品列表，pagination为分页信息，searchlist为搜索回显，cost_price_arr为共享仓成本总价汇总，region_stock_cost_price_arr为实际库存成本总价汇总。
最后修改者: huangyingliang  2026-07-01 17:02:08 

商品管理列表查询（旧前端兼容）

编号  :  030

GET - https://fl.tp6.hyj111.cn/admin/goodsManage/getGoodsList
headers下token必传
请求参数
参数名 参数类型 必传 缺省值 描述
currentPage int N 1 旧前端当前页，兼容字段；优先使用currentPage
page int N 1 当前页；currentPage为空时使用page
pageSize int N 10 旧前端每页条数，兼容字段；优先使用pageSize
limit int N 10 每页条数；pageSize为空时使用limit
search_goods_name string N 商品名称/规格/商品ID/别名/商品公共名称，模糊查询
search_commonid int N 商品ID或公共商品ID，精确查询
search_store_name int N 商户ID，按share_store_goods.vid查询
company_id int N 平台主体ID，按goods.company的主体ID匹配
cid int N 商品分类ID
search_brand_id int N 品牌ID
search_state int N 商品状态：0=仓库中，1=出售中，10=违规下架
search_verify int N 审核状态：0=未通过，1=通过，10=等待审核
is_points int N 0 商品种类：0=普通商品，1=积分商品，不传默认0
is_plan_off_shelf int N 是否待下架：0=否，1=是
is_yidifa int N 是否异地发：0=否，1=是
inventoryStatus int N 库存状态：1=只查负库存
coefficient float N 系数筛选值，需配合cid使用
performance_goods_rate int N 是否设置过业绩系数：1=只查已设置
promotion_man int N 专享价类型：1=合伙人专享价，2=乐销价
unsalable_time int N 滞销时间范围，单位月
unsalable_num int N 0 滞销阈值，配合unsalable_time使用
unsalable_share_store_id int N 滞销共享仓ID，配合unsalable_time使用
share_store_id int N 共享仓ID
vendor_tag_ids string N 商户标签ID集合，多个用英文逗号分隔
gids string N 商品ID集合，多个用英文逗号分隔
type string N 标签页类型：del=已删除，xiajia=已下架，waitverify=待审核，lockup=违规下架
返回值
{
    "status": 200,
    "msg": "ok",
    "data": {
        "list": [
            {
                "gid": 10001, // 商品SKU ID
                "goods_commonid": 9001, // 商品公共ID
                "goods_commonid2": 9001, // 原商品公共ID回显
                "goods_name": "电动车刹车片", // 商品名称
                "spec_relation": "前刹/黑色", // SKU规格
                "alias": "刹车片A款", // 商品别名
                "goods_image": "goods.jpg", // 公共商品图片
                "sku_goods_image": "sku_goods.jpg", // SKU商品图片
                "goods_image_url": "https://img.hyj111.cn/data/upload/mall/store/goods/1/sku_goods.jpg", // 商品缩略图
                "gc_id": 101, // 分类ID
                "gc_name": "刹车系统", // 分类名称
                "brand_id": 12, // 品牌ID
                "brand_name": "示例品牌", // 品牌名称
                "goods_state": 1, // 商品状态：0=仓库中，1=出售中，10=违规下架，100=已删除
                "goods_state_name": "出售中", // 商品状态文案
                "goods_verify": 1, // 审核状态：0=未通过，1=通过，10=等待审核
                "goods_verify_name": "通过", // 审核状态文案
                "goods_sort": 0, // 排序
                "goods_commend": 0, // 推荐状态
                "is_points": 0, // 商品种类：0=普通商品，1=积分商品
                "stock": 120, // 共享仓可用库存合计
                "share_store_stock_sum": 150, // 共享仓总库存合计
                "goods_kucun": 150, // 库存展示值
                "goods_kucun_name": "库存正常", // 库存状态：库存正常/预警/缺货
                "share_store_goods": [
                    {
                        "goods_id": 10001, // 商品SKU ID
                        "share_store_id": 11, // 共享仓ID
                        "gxc_name": "南通仓", // 共享仓名称
                        "label": "南通仓", // 共享仓展示名
                        "price": "1234.56" // 该共享仓库存成本总价
                    }
                ],
                "city_price": "88.00", // 区域价
                "city_price_as_gift": 99.9, // 礼品价
                "promotion_state": 0, // 专享价是否生效：0=否，1=是
                "region_stock": [
                    {
                        "goods_id": 10001, // 商品SKU ID
                        "region_type": 1, // 区位类型
                        "stock": 20, // 区位库存
                        "rack_num": "A01", // 货架号
                        "rack_detail_num": "01", // 货位号
                        "rack_detail": "A01-01" // 货位详情
                    }
                ]
            }
        ],
        "pagination": {
            "current": 1, // 当前页
            "pageSize": 10, // 每页条数
            "total": 1 // 总条数
        },
        "searchlist": {
            "is_points": 0, // 商品种类筛选回显
            "search_goods_name": "刹车" // 商品关键词筛选回显
        },
        "cost_price_arr": [
            {
                "share_store_id": 11, // 共享仓ID
                "gxc_name": "南通仓", // 共享仓名称
                "price": "12345.67" // 共享仓成本总价
            }
        ],
        "region_stock_cost_price_arr": [
            {
                "share_store_id": 11, // 共享仓ID
                "gxc_name": "南通仓", // 共享仓名称
                "price": "9876.54" // 实际库存成本总价
            }
        ]
    }
}
备注
旧前端兼容入口；等同于/admin/goodsManage/list，内部直接调用同一个lists方法，参数和返回结构完全一致。