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.