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 強制批核。
安全說明
庫存和採購審批必須可追溯且不可由申請者自行改寫。