{ "generatedAt": "2026-04-18 19:40:53", "generatedAtLocal": "2026-04-18 19:40:53", "source": "remote", "filter": { "platform": { "value": "web", "label": "网页端" }, "project": { "value": "all", "label": "全部" } }, "module": { "name": "商品模块", "key": "stock", "folder": "stock", "interfaceCount": 23 }, "changes": { "fromPreviousSnapshot": { "moduleAdded": false, "moduleRenamed": false, "interfaceChanges": { "addedMethods": [], "deletedMethods": [], "paramsUpdatedMethods": [], "responseUpdatedMethods": [] } } }, "interfaces": [ { "method": "stock.warehouse.list", "title": "仓库商品列表查询(支持 where 条件与分页)", "description": "仓库商品列表查询(支持 where 条件与分页)", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "pagination", "type": "object", "required": false, "description": "pagination 参数" }, { "name": "where", "type": "object", "required": false, "description": "统一 where 条件对象;推荐使用 { operator, value, type } 标准结构,历史简写会在 main 中自动标准化;支持 quickWhere、barcode、prohibited_type 等商品筛选字段。示例:where.barcode={operator:like,value:69}; where.prohibited_type={operator:eq,value:liquid}。" } ], "response": [] }, { "method": "stock.warehouse.getProhibitedType", "title": "查询违禁品类型列表(系统预设+仓库自定义)", "description": "查询违禁品类型列表(系统预设+仓库自定义)", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.getInfo", "title": "查询仓库商品详情", "description": "查询仓库商品详情", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.saveWarehouseStock", "title": "更新仓库商品资料", "description": "更新仓库商品资料", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.createWarehouseStock", "title": "新建仓库商品资料", "description": "新建仓库商品资料", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.getBarcodes", "title": "查询商品条码列表", "description": "查询商品条码列表", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.saveWarehouseStockBarcode", "title": "保存商品条码信息", "description": "保存商品条码信息", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.getStoreStocks", "title": "查询仓库商品与货主关联列表", "description": "查询仓库商品与货主关联列表", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.bindItem", "title": "绑定货主商品关系", "description": "绑定货主商品关系", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.unbindItem", "title": "解绑货主商品关系", "description": "解绑货主商品关系", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.checkItemCodeUnique", "title": "校验商品编码在货主维度唯一性", "description": "校验商品编码在货主维度唯一性", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "item_code", "type": "string", "required": true, "description": "item_code 参数" }, { "name": "store_id", "type": "number", "required": true, "description": "store_id 参数" }, { "name": "id", "type": "number", "required": false, "description": "id 参数" } ], "response": [] }, { "method": "stock.warehouse.queryStockLogs", "title": "查询库存操作日志", "description": "查询库存操作日志", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "warehouseId", "type": "string", "required": false, "description": "warehouseId 参数" } ], "response": [] }, { "method": "stock.warehouse.handleBatchDelete", "title": "批量删除仓库商品资料", "description": "批量删除仓库商品资料", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.deleteUnit", "title": "删除库存单位", "description": "删除库存单位", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.deleteProhibited", "title": "删除违禁品类型", "description": "删除违禁品类型", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.handleBatchChange", "title": "批量修改仓库商品字段", "description": "批量修改仓库商品字段", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.getStockUnits", "title": "查询可用库存单位(系统+仓库)", "description": "查询可用库存单位(系统+仓库)", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.getUnitList", "title": "查询当前仓库自定义单位列表", "description": "查询当前仓库自定义单位列表", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [], "response": [] }, { "method": "stock.warehouse.createProhibited", "title": "新增违禁品类型", "description": "新增违禁品类型", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "name", "type": "string", "required": true, "description": "name 参数" } ], "response": [] }, { "method": "stock.warehouse.createUnit", "title": "新增库存单位", "description": "新增库存单位", "endpoint": "/system", "authRequired": true, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "name", "type": "string", "required": true, "description": "name 参数" } ], "response": [] }, { "method": "stock.warehouse.search", "title": "仓库商品关键字搜索,按 item_code / item_name / goods_code / 条形码模糊匹配,最多返回 50 条", "description": "仓库商品关键字搜索,按 item_code / item_name / goods_code / 条形码模糊匹配,最多返回 50 条", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "keyword", "type": "string", "required": false, "description": "搜索关键字,模糊匹配 item_code、item_name、goods_code 以及关联的 barcode;为空时返回全部(仍受 limit 50 限制)" }, { "name": "store_id", "type": "number", "required": false, "description": "货主ID,传入时仅返回指定货主的商品" }, { "name": "with_stock", "type": "boolean", "required": false, "description": "是否返回关联库存数据(wms_storage),为 true 时每条商品新增 storage[] 字段" }, { "name": "is_batch", "type": "boolean", "required": false, "description": "是否按批次明细返回库存,仅 with_stock=true 时生效。false(默认)按库位分组汇总;true 逐条返回批次明细" } ], "response": [ { "name": "code", "type": "number", "required": false, "description": "业务状态码,200 表示成功" }, { "name": "data", "type": "array", "required": false, "description": "商品列表,每项包含以下字段" }, { "name": "total", "type": "number", "required": false, "description": "本次返回的记录条数(≤50)" } ] }, { "method": "stock.warehouse.getStockDetail", "title": "查询商品的库存明细,返回 wms_storage 表的数据(按库位/批次维度展示库存分布)", "description": "查询商品的库存明细,返回 wms_storage 表的数据(按库位/批次维度展示库存分布)", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "stock_id", "type": "number", "required": true, "description": "商品库存ID(stock_warehouse.id)" }, { "name": "pagination", "type": "object", "required": false, "description": "分页参数,含 page(页码,默认1)和 pageSize(每页条数,默认20)" }, { "name": "group_by_batch", "type": "boolean", "required": false, "description": "是否区分批次。false(默认)时按库位合并数量,批次相关字段(batch_no, production_date, expiry_date, inbound_time, inbound_order_no, supplier_batch_no)置 null;true 时按原逻辑返回每条明细" } ], "response": [ { "name": "stockItem", "type": "object", "required": false, "description": "商品概要信息,含 id, item_code, item_name, sku_property, stock_unit, quantity, locked_quantity" }, { "name": "storageList", "type": "array", "required": false, "description": "库存明细数组,每条含 id, space_id, batch_no, inventory_type, quantity, locked_quantity, available_quantity, production_date, expiry_date, inbound_time, inbound_order_no, supplier_batch_no, created_at,关联 space 对象(id, space_code, custom_name)。当 group_by_batch=false 时,批次相关字段为 null" }, { "name": "pagination", "type": "object", "required": false, "description": "分页信息,含 page, pageSize, total" } ] }, { "method": "stock.stockWarehouse", "title": "仓库商品列表查询兼容入口(等同于 stock.warehouse.list)", "description": "仓库商品列表查询兼容入口(等同于 stock.warehouse.list)", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "pagination", "type": "object", "required": false, "description": "分页参数" }, { "name": "where", "type": "object", "required": false, "description": "筛选条件,写法与 stock.warehouse.list 一致" } ], "response": [] } ] }