food_wholesale.config.get
read讀取食品批發租戶設定，包括溫層、截單、付款、批核、配送及召回基本規則。
建議先讀取
-
治理與審批
No approval required; read-only configuration lookup.
安全說明
Return tenant-scoped configuration only; hide integration secrets and internal credential values.
食品批發系統 MCP
食品批發系統 MCP 工具支援批發客戶、客戶專屬價目表、食品商品、批次有效期、冷鏈規則、庫存可售量、截單時間、訂單檢查、FEFO 批次分配、欠貨、揀貨、配送路線、送貨執行、發票批次、收款、退貨索償、召回追溯、毛利損耗報表及 audit。
food_wholesale.customers.list
read按狀態、客戶組別、送貨區域、帳期或銷售負責人查詢批發客戶。
建議先讀取
food_wholesale.config.get
治理與審批
No approval required; read-only customer lookup.
安全說明
Restrict to permitted customer accounts and redact private contacts when caller lacks permission.
food_wholesale.customer.get
read讀取單一客戶檔案、帳期、信用額、送貨偏好、價目表及未收款摘要。
建議先讀取
food_wholesale.customers.list
治理與審批
No approval required; read-only customer detail.
安全說明
Do not expose credit, balance, or personal contact fields across tenant or permission boundaries.
food_wholesale.customer_price_lists.list
read查詢客戶專屬價目表、折扣、MOQ、有效日期及即將生效的改價。
建議先讀取
food_wholesale.customer.get
治理與審批
No approval required; read-only pricing lookup.
安全說明
Pricing is commercially sensitive; scope by customer and caller role.
food_wholesale.products.list
read按分類、供應商、溫層、可售狀態、包裝規格或有效期規則查詢食品商品。
建議先讀取
food_wholesale.config.get
治理與審批
No approval required; read-only product lookup.
安全說明
Return public product and operational fields only unless caller can view costing.
food_wholesale.product.get
read讀取單一食品 SKU、包裝、單位換算、保存要求、過敏原/處理備註及成本權限摘要。
建議先讀取
food_wholesale.products.list
治理與審批
No approval required; read-only product detail.
安全說明
Cost, supplier, and allergen data must follow role permissions and audit read access where required.
food_wholesale.batches_expiry.list
read按商品、倉庫、批次、有效期、隔離或召回狀態查詢批次庫存。
建議先讀取
food_wholesale.product.get
治理與審批
No approval required; read-only lot and expiry lookup.
安全說明
Separate sellable, reserved, quarantined, expired, damaged, and recalled quantities clearly.
food_wholesale.cold_chain_rules.list
read查詢食品溫層、配送溫度範圍、容許偏差及異常處理規則。
建議先讀取
food_wholesale.config.get
治理與審批
No approval required; read-only cold-chain rule lookup.
安全說明
Do not treat missing temperature rules as safe; surface incomplete setup explicitly.
food_wholesale.stock_levels.list
read讀取按商品、倉庫、批次及有效期拆分的可售、預留、欠貨及隔離數量。
建議先讀取
food_wholesale.products.list, food_wholesale.batches_expiry.list
治理與審批
No approval required; read-only stock lookup.
安全說明
Stock figures must be time-stamped to prevent stale allocation decisions.
food_wholesale.cutoff_windows.list
read查詢送貨日、區域、客戶組別及溫層對應的截單時間與例外規則。
建議先讀取
food_wholesale.config.get, food_wholesale.customer.get
治理與審批
No approval required; read-only cut-off lookup.
安全說明
Flag orders outside cut-off instead of silently accepting late operational changes.
food_wholesale.orders.list
read按客戶、送貨日期、截單批次、狀態、溫層或欠貨情況查詢訂單。
建議先讀取
food_wholesale.customers.list
治理與審批
No approval required; read-only order lookup.
安全說明
Respect customer/account permissions and avoid exposing unrelated customer order values.
food_wholesale.order.get
read讀取訂單明細、客戶價格、批次分配、欠貨、配送要求、發票及收款關聯。
建議先讀取
food_wholesale.orders.list
治理與審批
No approval required; read-only order detail.
安全說明
Show price source, stock timestamp, and allocation state to prevent hidden order drift.
food_wholesale.backorders.list
read查詢客戶、商品、批次、補貨日期、替代品及待確認的欠貨項目。
建議先讀取
food_wholesale.orders.list, food_wholesale.stock_levels.list
治理與審批
No approval required; read-only backorder lookup.
安全說明
Do not promise replenishment dates unless source status is confirmed.
food_wholesale.allocation_plan.get
read讀取某張訂單或截單批次的 FEFO 批次分配建議與替代方案。
建議先讀取
food_wholesale.order.get, food_wholesale.stock_levels.list
治理與審批
No approval required; read-only allocation plan.
安全說明
Mark any manual lot override, short shelf-life risk, or recall/quarantine conflict.
food_wholesale.pick_lists.list
read按送貨日、路線、溫層、倉庫或狀態查詢揀貨單。
建議先讀取
food_wholesale.orders.list, food_wholesale.allocation_plan.get
治理與審批
No approval required; read-only pick list lookup.
安全說明
Pick lists must include lot and expiry data when food traceability is required.
food_wholesale.delivery_routes.list
read查詢配送路線、區域、車輛容量、溫層能力、司機及時間窗。
建議先讀取
food_wholesale.config.get
治理與審批
No approval required; read-only route lookup.
安全說明
Route capacity and temperature capability must be validated before route assignment writes.
food_wholesale.delivery_runs.list
read按日期、路線、司機、車輛、狀態或溫度異常查詢送貨行程。
建議先讀取
food_wholesale.delivery_routes.list
治理與審批
No approval required; read-only delivery run lookup.
安全說明
Do not expose driver private details beyond operational need.
food_wholesale.invoices.list
read按客戶、訂單、送貨日、月結週期、付款狀態或逾期狀態查詢發票。
建議先讀取
food_wholesale.customer.get, food_wholesale.orders.list
治理與審批
No approval required; read-only invoice lookup.
安全說明
Invoice visibility must follow finance permissions and customer account scope.
food_wholesale.collections.list
read查詢收款、部分付款、對帳、逾期提醒及未分配收款記錄。
建議先讀取
food_wholesale.invoices.list
治理與審批
No approval required; read-only collection lookup.
安全說明
Payment references and bank data must be redacted unless finance role permits access.
food_wholesale.returns_claims.list
read查詢短送、錯貨、破損、過期、溫度異常或退貨索償個案。
建議先讀取
food_wholesale.orders.list, food_wholesale.delivery_runs.list
治理與審批
No approval required; read-only claim lookup.
安全說明
Keep claim evidence files scoped to the related customer, delivery, and finance roles.
food_wholesale.recall_trace.get
read按商品批次追蹤受影響訂單、客戶、配送、發票、退貨及通知狀態。
建議先讀取
food_wholesale.batches_expiry.list, food_wholesale.orders.list
治理與審批
No approval required for preview trace; recall action writes require approval.
安全說明
Recall trace must include confidence/source timestamps and never omit quarantined or returned quantities.
food_wholesale.margin_report.get
read讀取按客戶、商品、批次、路線或期間計算的毛利、損耗、到期風險及欠貨摘要。
建議先讀取
food_wholesale.orders.list, food_wholesale.collections.list
治理與審批
No approval required; read-only report.
安全說明
Cost and margin fields require management or finance permissions.
food_wholesale.audit_logs.list
read查詢價格、訂單、批次、配送、收款、退貨、召回及通知的操作紀錄。
建議先讀取
food_wholesale.config.get
治理與審批
No approval required for authorized auditors; read-only audit lookup.
安全說明
Audit logs are immutable and must include actor, source, approval id, before/after, and execution result.
food_wholesale.order_check.preview
preview預覽新訂單或改單會否違反價格、MOQ、信用額、截單、庫存或送貨規則。
建議先讀取
food_wholesale.customer.get, food_wholesale.customer_price_lists.list, food_wholesale.stock_levels.list, food_wholesale.cutoff_windows.list
治理與審批
No approval required; preview only and does not persist the order.
安全說明
Return blocking reasons and warnings separately so operators do not treat risky orders as approved.
food_wholesale.allocation.preview
preview預覽訂單或批次的 FEFO 分配、缺貨、替代品、短效期風險及隔離衝突。
建議先讀取
food_wholesale.order.get, food_wholesale.batches_expiry.list, food_wholesale.stock_levels.list
治理與審批
No approval required; preview only and does not reserve stock.
安全說明
Do not reduce stock or reserve lots during preview; include stock timestamp.
food_wholesale.route_plan.preview
preview預覽送貨路線的容量、時間窗、溫層相容性、成本及遲送風險。
建議先讀取
food_wholesale.delivery_routes.list, food_wholesale.orders.list, food_wholesale.pick_lists.list
治理與審批
No approval required; preview only and does not assign routes.
安全說明
Flag vehicle capacity and temperature mismatches as blockers, not soft notes.
food_wholesale.invoice_batch.preview
preview預覽按送貨、訂單或月結週期批量開票的金額、稅項、折扣及異常。
建議先讀取
food_wholesale.orders.list, food_wholesale.invoices.list, food_wholesale.collections.list
治理與審批
No approval required; preview only and does not create invoices.
安全說明
Show already-invoiced lines and missing delivery completion before invoice creation.
food_wholesale.price_change.preview
preview預覽改價對客戶、未確認訂單、毛利、MOQ 及生效日期的影響。
建議先讀取
food_wholesale.customer_price_lists.list, food_wholesale.orders.list, food_wholesale.margin_report.get
治理與審批
No approval required for preview; applying price changes requires approval.
安全說明
Do not alter active prices during preview; report affected customers and orders explicitly.
food_wholesale.recall_impact.preview
preview預覽某批次召回會影響的庫存、訂單、客戶、配送、發票、通知及替代貨安排。
建議先讀取
food_wholesale.recall_trace.get, food_wholesale.stock_levels.list, food_wholesale.delivery_runs.list
治理與審批
No approval required for preview; recall case creation requires approval.
安全說明
Include confidence and completeness indicators; never auto-notify customers from preview.
food_wholesale.action_request.status
status查詢食品批發寫入動作的審批、執行、失敗、回滾或部分完成狀態。
建議先讀取
action_request_id
治理與審批
No approval required; status lookup for submitted actions.
安全說明
Return only action requests visible to the caller and keep immutable execution logs.
food_wholesale.customer.upsert
write建立或更新批發客戶、帳期、信用額、送貨偏好、聯絡資料及帳戶狀態。
建議先讀取
food_wholesale.customer.get, food_wholesale.customers.list
治理與審批
Approval required when changing credit limit, account status, payment terms, or primary contacts.
安全說明
Validate duplicate customers and keep before/after audit for credit and contact changes.
food_wholesale.price_list.upsert
write建立或更新客戶專屬價格、折扣、MOQ、生效日期及停止日期。
建議先讀取
food_wholesale.customer_price_lists.list, food_wholesale.price_change.preview
治理與審批
Approval required before price lists become active.
安全說明
Prevent retroactive price changes unless explicitly approved and audited.
food_wholesale.product.upsert
write建立或更新食品 SKU、包裝、單位、溫層、保存要求、條碼及處理備註。
建議先讀取
food_wholesale.product.get, food_wholesale.products.list
治理與審批
Approval required when changing sellable status, handling rules, or cost-sensitive fields.
安全說明
Validate unit conversion and cold-chain requirements before making products sellable.
food_wholesale.batch.upsert
write建立或更新食品批次、到期日、入倉數量、可售狀態及隔離備註。
建議先讀取
food_wholesale.product.get, food_wholesale.batches_expiry.list
治理與審批
Approval required when changing expiry date, quantity, quarantine, or recall-related state.
安全說明
Expiry date and lot identity changes must be immutable or corrected through audited adjustment records.
food_wholesale.order.create
write建立食品批發訂單，套用客戶價、MOQ、截單、信用額、送貨及溫層規則。
建議先讀取
food_wholesale.order_check.preview, food_wholesale.customer.get, food_wholesale.stock_levels.list
治理與審批
Approval required when preview returns warnings or when order exceeds credit/cut-off rules.
安全說明
Reject blocked preview results unless an approved override is attached.
food_wholesale.order.update
write更新未鎖定訂單的商品、數量、價格來源、送貨日、特殊要求或備註。
建議先讀取
food_wholesale.order.get, food_wholesale.order_check.preview
治理與審批
Approval required for post-cut-off, price override, credit-risk, or already-picked order changes.
安全說明
Do not update picked, invoiced, or dispatched orders without explicit controlled reversal flow.
food_wholesale.order.confirm
write確認訂單並鎖定價格、截單批次、送貨要求及後續批次分配流程。
建議先讀取
food_wholesale.order.get, food_wholesale.order_check.preview
治理與審批
Approval required if confirmation includes warnings, overrides, or credit/cut-off exceptions.
安全說明
Confirmation must be idempotent and must not double-reserve or double-invoice lines.
food_wholesale.backorder.create
write為缺貨訂單建立欠貨、部分交付、替代品或客戶待確認安排。
建議先讀取
food_wholesale.backorders.list, food_wholesale.allocation.preview
治理與審批
Approval required when substituting products or changing promised delivery dates.
安全說明
Record customer acceptance status and never treat substitutes as accepted automatically.
food_wholesale.allocation.apply
write把已預覽的 FEFO 或指定批次分配套用到訂單並預留庫存。
建議先讀取
food_wholesale.allocation.preview, food_wholesale.order.get
治理與審批
Approval required for manual lot override, short shelf-life allocation, or allocation under shortage.
安全說明
Use optimistic locking against stock timestamp to prevent over-allocation.
food_wholesale.pick_list.create
write按送貨日、路線、溫層及倉庫建立揀貨單，包含批次和有效期資料。
建議先讀取
food_wholesale.allocation_plan.get, food_wholesale.pick_lists.list
治理與審批
Approval required when generating pick lists for unconfirmed or partially allocated orders.
安全說明
Prevent duplicate active pick lists for the same order lines.
food_wholesale.route_plan.create
write建立配送路線計劃，分配訂單、時間窗、車輛、司機及溫層容量。
建議先讀取
food_wholesale.route_plan.preview, food_wholesale.delivery_routes.list
治理與審批
Approval required before committing route plans that affect warehouse or driver workload.
安全說明
Block incompatible temperature bands, over-capacity vehicles, and missing customer delivery windows.
food_wholesale.delivery_run.dispatch
write將送貨行程標記為出車並鎖定訂單、揀貨、車輛、司機及溫度檢查。
建議先讀取
food_wholesale.delivery_runs.list, food_wholesale.pick_lists.list
治理與審批
Approval required for dispatch; operationally locks delivery resources.
安全說明
Do not dispatch runs with incomplete pick lists, unresolved temperature checks, or missing driver assignment.
food_wholesale.delivery_run.complete
write完成送貨行程，記錄簽收、失敗原因、重新配送、短送及溫度異常。
建議先讀取
food_wholesale.delivery_runs.list, food_wholesale.returns_claims.list
治理與審批
Approval required when completion creates claims, redelivery, or temperature exception records.
安全說明
Completion must not auto-invoice failed or disputed deliveries unless policy allows and records exception.
food_wholesale.invoice_batch.create
write按已完成送貨、訂單或月結週期批量建立發票。
建議先讀取
food_wholesale.invoice_batch.preview, food_wholesale.invoices.list
治理與審批
Finance approval required before invoice batch creation or release.
安全說明
Prevent duplicate invoicing and exclude disputed, failed, or uncompleted delivery lines unless approved.
food_wholesale.collection.record
write記錄收款、部分付款、對帳、未分配收款或逾期追收狀態。
建議先讀取
food_wholesale.collections.list, food_wholesale.invoices.list
治理與審批
Finance approval required for payment application, reversal, or write-off.
安全說明
Keep payment references auditable and avoid exposing bank details outside finance roles.
food_wholesale.return_claim.create
write建立退貨或索償個案，連結訂單、送貨、商品、批次、相片證據及財務處理。
建議先讀取
food_wholesale.returns_claims.list, food_wholesale.order.get, food_wholesale.delivery_runs.list
治理與審批
Approval required when claim affects invoice, stock, refund, credit note, or replacement delivery.
安全說明
Evidence uploads and claim reasons must be immutable after approval except through audited amendments.
food_wholesale.recall_case.create
write建立食品召回個案，鎖定批次、受影響客戶、通知清單、退貨及替代安排。
建議先讀取
food_wholesale.recall_impact.preview, food_wholesale.recall_trace.get
治理與審批
Senior approval required before creating recall case or sending customer-facing actions.
安全說明
Recall writes must quarantine affected stock and preserve traceability evidence before notifications.
food_wholesale.notification.send
write向客戶發送訂單確認、欠貨、改價、送貨、收款、退貨或召回通知。
建議先讀取
food_wholesale.customer.get, food_wholesale.order.get, food_wholesale.recall_trace.get
治理與審批
Approval required for bulk, finance, price-change, claim, or recall notifications.
安全說明
Respect consent, channel rules, template approval, and suppress duplicate or unapproved recall notices.