inventory.config.get
read读取库存单位、成本方法、条码、离线同步、审批、仓库权限及 audit 设定。
建议先读取
-
治理与审批
只读；按库存/采购权限返回设定。
安全说明
不得暴露成本权限、仓库权限或整合密钥。
进销存系统 MCP 工具
进销存系统 MCP 工具支援商品/SKU、条码、仓库货位、Excel/CSV 初始化、实时库存、出入库 ledger、批次有效期、安全库存、低库存预警、销售速度、补货建议、供应商、采购单、收货、跨仓调拨、手机离线盘点、退货损坏、库存估值及 audit。
inventory.warehouses.list
read查询仓库、门店、启用状态、负责人、多仓同步和权限范围。
建议先读取
inventory.config.get
治理与审批
只读；只返回使用者可见仓库。
安全说明
防止跨仓未授权查看库存。
inventory.locations.list
read读取仓库货位、区域、上架规则、拣货路径及是否可用。
建议先读取
inventory.warehouses.list
治理与审批
只读；仓务权限按仓库限制。
安全说明
货位权限需防止未授权调拨或盘点。
inventory.products.list
read按分类、SKU、条码、供应商、状态及是否批次管理查询商品。
建议先读取
inventory.config.get
治理与审批
只读；成本栏位按权限遮罩。
安全说明
不可向无采购/财务权限者显示成本。
inventory.product.get
read读取单一商品、SKU、条码、供应商、成本、库存规则、批次和有效期设定。
建议先读取
inventory.products.list
治理与审批
只读；成本、供应商条款按角色显示。
安全说明
SKU、条码和批次规则需保持一致。
inventory.categories.list
read查询商品分类、存货属性、预设安全库存及盘点分组。
建议先读取
inventory.config.get
治理与审批
只读；用于商品建立及报告分类。
安全说明
分类变更需避免影响历史报告解读。
inventory.suppliers.list
read查询供应商、联络方式、币种、交货期、MOQ、状态及预设付款条款。
建议先读取
inventory.config.get
治理与审批
只读；敏感商业条款可遮罩。
安全说明
供应商价格和条款需采购权限。
inventory.supplier_terms.list
read读取 SKU 对应供应商价格、币种、汇率、交期、MOQ、包装数量和历史报价。
建议先读取
inventory.suppliers.list, inventory.products.list
治理与审批
只读；采购和管理层可查看完整条款。
安全说明
避免将供应商成本外泄到销售或客户流程。
inventory.barcodes.list
read查询 SKU、条码、替代条码、箱码、扫码设备相容性及重复风险。
建议先读取
inventory.products.list
治理与审批
只读；用于扫码出入库和盘点。
安全说明
条码必须唯一，避免扫错商品。
inventory.stock_levels.list
read按仓库、货位、SKU、批次查询现有、可售、预留、在途及安全库存。
建议先读取
inventory.warehouses.list, inventory.products.list
治理与审批
只读；按仓库权限限制。
安全说明
可售数量需扣除预留与未完成调拨。
inventory.stock_ledger.list
read查询入库、出库、调拨、盘点差异、退货、损坏、预留及释放的 ledger。
建议先读取
inventory.stock_levels.list
治理与审批
只读；ledger 不可直接修改。
安全说明
ledger 应 immutable，只能用相反 movement 修正。
inventory.batches_expiry.list
read查询批次、入库日期、有效期、货位、数量、到期预警及追溯状态。
建议先读取
inventory.product.get, inventory.stock_levels.list
治理与审批
只读；食品/有效期商品需批次追踪。
安全说明
不可忽略到期批次或错误 FIFO/FEFO。
inventory.safety_stock_rules.list
read读取 SKU/仓库安全库存、补货点、最大库存、供应商交期及预警渠道。
建议先读取
inventory.products.list, inventory.warehouses.list
治理与审批
只读；用于低库存预警和补货建议。
安全说明
安全库存规则错误会造成断货或过量库存。
inventory.low_stock_alerts.list
read查询低库存、缺货风险、过期风险、WhatsApp/email 预警及处理状态。
建议先读取
inventory.stock_levels.list, inventory.safety_stock_rules.list
治理与审批
只读；预警不等于自动采购。
安全说明
AI 只能建议补货，不能未批核建立采购。
inventory.sales_velocity.get
read读取 SKU 销售速度、消耗率、季节性、平均日销量及预计可售天数。
建议先读取
inventory.stock_levels.list
治理与审批
只读；用于补货计算。
安全说明
需标示资料来源和分析期间，避免错误预测。
inventory.reorder_suggestions.list
read查询建议补货 SKU、数量、供应商、预计金额、交期、缺货日期及原因。
建议先读取
inventory.sales_velocity.get, inventory.supplier_terms.list
治理与审批
只读；建立采购单前需 preview 和批核。
安全说明
建议需显示计算基础，不可黑箱落单。
inventory.purchase_orders.list
read查询采购单、供应商、币种、金额、审批、发送、收货及到货日期。
建议先读取
inventory.suppliers.list
治理与审批
只读；金额和成本按采购权限。
安全说明
采购金额和供应商条款属敏感资料。
inventory.goods_receipts.list
read查询收货单、采购单关联、收货差异、批次、有效期、货位及入库状态。
建议先读取
inventory.purchase_orders.list
治理与审批
只读；用于入库和差异审批。
安全说明
未审批差异不可直接改变采购完成状态。
inventory.transfers.list
read查询调拨单、来源/目的仓、在途数量、出库、收货、差异及状态。
建议先读取
inventory.warehouses.list, inventory.stock_levels.list
治理与审批
只读；按来源和目的仓权限。
安全说明
在途库存需防止重复可售。
inventory.stocktakes.list
read查询盘点任务、仓库、货位、扫码进度、离线同步、差异及审批状态。
建议先读取
inventory.warehouses.list
治理与审批
只读；盘点结果需提交后才影响库存。
安全说明
盘点差异不可未审批直接写 ledger。
inventory.adjustments.list
read查询库存调整、原因、附件、金额影响、审批人及 ledger。
建议先读取
inventory.stock_ledger.list
治理与审批
只读；高价值或大差异需管理层权限。
安全说明
调整原因和附件需保留 audit。
inventory.reservations.list
read查询订单或内部流程的库存预留、到期、释放及可售影响。
建议先读取
inventory.stock_levels.list
治理与审批
只读；预留来源需可追溯。
安全说明
预留不可永久锁死库存，需到期或释放。
inventory.returns_damage.list
read查询退货、损坏、报废、重新入库、隔离货位、原因及审批状态。
建议先读取
inventory.stock_ledger.list
治理与审批
只读；报废和重新入库需审批。
安全说明
损坏/过期货不可未审核回到可售库存。
inventory.import_jobs.list
read查询 Excel/CSV 商品、SKU、供应商和期初库存汇入工作、错误及完成状态。
建议先读取
inventory.config.get
治理与审批
只读；用于初始化和批量更新追踪。
安全说明
汇入需防止重复 SKU、条码及错误期初库存。
inventory.valuation_report.get
read读取库存估值、成本、多币种换算、滞销、呆货、到期和差异摘要。
建议先读取
inventory.stock_levels.list, inventory.supplier_terms.list
治理与审批
只读；成本与估值只限采购/财务/管理层。
安全说明
估值方法变更不可无声影响财务报告。
inventory.audit_logs.list
read查询商品、采购、收货、出入库、调拨、盘点、调整、离线同步和成本操作纪录。
建议先读取
inventory.config.get
治理与审批
只读；audit 不可由普通使用者改写。
安全说明
每个改变库存的动作都必须可追溯。
inventory.import.preview
preview预览汇入商品、SKU、条码、供应商、期初库存、重复项目及错误列。
建议先读取
inventory.import_jobs.list, inventory.barcodes.list
治理与审批
预览不写入；批量汇入前需确认 mapping。
安全说明
防止错误 Excel 覆盖正式 SKU 或库存。
inventory.purchase_order.preview
preview预览采购单 SKU、供应商、MOQ、币种、金额、交期、低库存理由和审批链。
建议先读取
inventory.reorder_suggestions.list, inventory.supplier_terms.list
治理与审批
建立采购单前需采购负责人确认。
安全说明
防止 AI 未批核自动落单。
inventory.receiving.preview
preview预览收货差异、批次、有效期、货位、成本、在途转入及入库 ledger。
建议先读取
inventory.purchase_orders.list, inventory.goods_receipts.list
治理与审批
差异或成本改变需审批。
安全说明
防止错收货导致库存和成本错误。
inventory.transfer.preview
preview预览跨仓调拨来源、目的地、可用量、在途状态、运送批次及差异处理。
建议先读取
inventory.stock_levels.list, inventory.transfers.list
治理与审批
调拨需来源仓和目的仓权限确认。
安全说明
避免来源仓扣错或目的仓重复收货。
inventory.stocktake_variance.preview
preview预览盘点差异、扫码缺漏、离线冲突、建议调整、金额影响及审批要求。
建议先读取
inventory.stocktakes.list, inventory.stock_levels.list
治理与审批
提交盘点差异前需仓务主管批核。
安全说明
盘点差异不可自动改 ledger。
inventory.adjustment.preview
preview预览库存调整原因、数量、货位、批次、成本影响、附件和审批链。
建议先读取
inventory.adjustments.list, inventory.stock_levels.list
治理与审批
正式调整需按金额/数量门槛批核。
安全说明
高风险调整需附件和双人复核。
inventory.reorder_plan.preview
preview预览补货计划、建议数量、供应商、金额、缺货日期、仓库分配及过量风险。
建议先读取
inventory.reorder_suggestions.list
治理与审批
正式采购前需人手批核。
安全说明
避免单靠销售速度造成过量采购。
inventory.offline_sync.preview
preview预览手机离线扫码的出入库、盘点、调拨记录、冲突、重复提交及时间差。
建议先读取
inventory.stock_ledger.list, inventory.stocktakes.list
治理与审批
冲突记录需仓务主管确认后才写入。
安全说明
防止离线重复同步造成库存倍增或扣减。
inventory.product.upsert
write建立或更新商品、SKU、分类、供应商、成本、批次有效期和库存规则。
建议先读取
inventory.product.get, inventory.import.preview
治理与审批
成本、批次规则或大量商品更新需批核。
安全说明
SKU 和条码需唯一，成本需按权限。
inventory.import_job.create
write建立 Excel/CSV 商品、SKU、供应商和期初库存汇入工作。
建议先读取
inventory.import.preview
治理与审批
需先确认 import preview。
安全说明
汇入不可未审核覆盖正式库存。
inventory.supplier.upsert
write建立或更新供应商、联络方式、币种、交期、MOQ、价格和付款条款。
建议先读取
inventory.suppliers.list, inventory.supplier_terms.list
治理与审批
价格或付款条款变更需采购/管理层批核。
安全说明
供应商条款属商业敏感资料。
inventory.warehouse.upsert
write建立或更新仓库、门店、权限、同步状态及是否可出入库。
建议先读取
inventory.warehouses.list
治理与审批
新仓库或停用仓库需 admin 批核。
安全说明
停用仓库前需检查库存和未完成单据。
inventory.location.upsert
write建立或更新货位、区域、拣货/上架规则、容量和是否隔离货位。
建议先读取
inventory.locations.list
治理与审批
影响既有库存的货位变更需仓务主管批核。
安全说明
避免把可售货和隔离/损坏货混放。
inventory.barcode.assign
write为 SKU 或箱装单位分配、更新或停用条码。
建议先读取
inventory.barcodes.list, inventory.product.get
治理与审批
重用或改动既有条码需批核。
安全说明
防止条码碰撞造成扫错货。
inventory.safety_stock_rule.upsert
write建立或更新 SKU/仓库安全库存、补货点、最大库存、预警渠道和供应商交期。
建议先读取
inventory.safety_stock_rules.list, inventory.reorder_plan.preview
治理与审批
大量或高价 SKU 规则变更需采购/库存负责人批核。
安全说明
错误规则可导致断货或积压。
inventory.purchase_order.create
write根据补货计划或人手输入建立采购单草稿。
建议先读取
inventory.purchase_order.preview
治理与审批
建立后仍需按金额审批。
安全说明
不得未批核直接向供应商发送。
inventory.purchase_order.approve
write批核采购单金额、供应商、SKU、数量、币种及交期。
建议先读取
inventory.purchase_order.preview, inventory.purchase_orders.list
治理与审批
只限指定采购/管理层 approver。
安全说明
防止超权限采购或错价采购。
inventory.purchase_order.send
write将已批核采购单发送给供应商并记录发送渠道和版本。
建议先读取
inventory.purchase_orders.list
治理与审批
只可发送已批核版本。
安全说明
防止发送错误版本、错供应商或错币种。
inventory.goods_receipt.record
write记录收货、批次、有效期、货位、差异、成本和入库 ledger。
建议先读取
inventory.receiving.preview
治理与审批
差异或成本改动需批核。
安全说明
收货会改变库存和估值，需完整 audit。
inventory.transfer.create
write建立跨仓或门店调拨草稿，锁定来源、目的地、SKU、批次及数量。
建议先读取
inventory.transfer.preview
治理与审批
需来源仓可用量和权限确认。
安全说明
防止超可用量调拨。
inventory.transfer.ship
write将调拨单标记为已出库，扣减来源仓并建立在途库存。
建议先读取
inventory.transfers.list, inventory.transfer.preview
治理与审批
出库需仓务权限或主管批核。
安全说明
需防止同一调拨重复出库。
inventory.transfer.receive
write目的仓收货，处理差异、损坏、批次和货位，并完成调拨 ledger。
建议先读取
inventory.transfers.list, inventory.transfer.preview
治理与审批
差异收货需主管批核。
安全说明
防止目的仓重复收货或忽略差异。
inventory.stocktake.create
write建立盘点任务、仓库、货位、SKU 范围、负责人及是否允许离线。
建议先读取
inventory.stocktakes.list, inventory.locations.list
治理与审批
大型或冻结库存盘点需主管批核。
安全说明
盘点期间需清楚处理出入库冻结或冲突。
inventory.stocktake.submit
write提交盘点结果、扫码记录、离线同步和差异，待审批后写入 adjustment。
建议先读取
inventory.stocktake_variance.preview
治理与审批
差异需仓务主管或管理层批核。
安全说明
提交不应立即改库存，除非批核规则允许。
inventory.adjustment.create
write建立库存调整 ledger，包括盘盈、盘亏、损坏、报废或管理调整。
建议先读取
inventory.adjustment.preview
治理与审批
按数量/金额/原因批核。
安全说明
所有调整需原因、附件、批核和 audit。
inventory.reservation.create
write为订单、调拨或内部流程建立库存预留，更新可售数量。
建议先读取
inventory.stock_levels.list, inventory.reservations.list
治理与审批
需指定来源单据和到期日。
安全说明
防止无来源长期锁库存。
inventory.reservation.release
write释放库存预留，恢复可售数量并保留来源和原因。
建议先读取
inventory.reservations.list
治理与审批
可由来源单据完成/取消触发；人工释放需权限。
安全说明
防止释放错误预留导致超卖。
inventory.return_damage.record
write记录退货、损坏、隔离、重新入库、报废及相关库存 ledger。
建议先读取
inventory.returns_damage.list, inventory.adjustment.preview
治理与审批
报废、重新入库或高价损坏需批核。
安全说明
损坏/过期货不可直接变成可售。
inventory.action_request.status
status查询进销存写入动作的 preview、批核、执行、失败、回滚和 audit 状态。
建议先读取
inventory.audit_logs.list
治理与审批
只读状态；不能用此 endpoint 强制批核。
安全说明
库存和采购审批必须可追溯且不可由申请者自行改写。