pos.config.get
read读取 POS 设定、时区、税项、货币、支援付款方式、离线模式及同步策略。
建议先读取
-
治理与审批
唯读，不需要批核。
安全说明
不回传支付密钥、terminal secret 或员工密码。
POS 系统 MCP 工具
POS 系统 MCP 工具按门市营运流程设计，覆盖门店、收银机、硬件、员工权限、商品价格、促销引擎、会员积分、库存同步、O2O 店取、销售付款、退款换货、更份、离线 queue、日结 Z-Report、销售分析及操作 audit。
pos.stores.list
read列出门店、营业状态、分店仓库、O2O 取货能力及目前同步状态。
建议先读取
pos.config.get
治理与审批
唯读，不需要批核。
安全说明
只显示授权门店，不跨品牌输出资料。
pos.store.get
read读取单一门店的收银设定、营业时间、付款设备、库存位置及日结状态。
建议先读取
pos.stores.list
治理与审批
唯读，不需要批核。
安全说明
不暴露完整设备凭证或支付设定 secret。
pos.registers.list
read列出收银机、钱箱、平板登入状态、当前更份及最后同步时间。
建议先读取
pos.store.get
治理与审批
唯读，不需要批核。
安全说明
不回传装置登入 token。
pos.devices.list
read列出打印机、扫描器、钱箱、读卡机、标签机及连线状态。
建议先读取
pos.registers.list
治理与审批
唯读，不需要批核。
安全说明
只显示设备状态与型号，不显示 pairing secret。
pos.staff_sessions.list
read查询员工登入、当前更份、收银机操作状态及未完成交易。
建议先读取
pos.registers.list
治理与审批
唯读，不需要批核。
安全说明
员工个资按角色遮蔽。
pos.permission_rules.get
read读取退款、改价、取消单据、开钱箱、日结提交及离线同步的权限规则。
建议先读取
pos.config.get
治理与审批
唯读，不需要批核。
安全说明
AI 必须遵守权限规则，不可代替经理批核。
pos.products.search
read按条码、SKU、分类、门店、价格、库存或促销状态搜寻 POS 商品。
建议先读取
pos.store.get
治理与审批
唯读，不需要批核。
安全说明
分页回传，不输出供应商成本。
pos.product.get
read读取商品条码、价格、税项、促销、库存、可售门店及同步到收银机状态。
建议先读取
pos.products.search
治理与审批
唯读，不需要批核。
安全说明
只读商品主档与 POS 可售资料。
pos.prices.get
read读取全局价、门店价、周末价、会员价及生效时段。
建议先读取
pos.product.get
治理与审批
唯读，不需要批核。
安全说明
不改价；只供 preview 对比。
pos.promotion_rules.list
read列出买二送一、加价购、折扣、会员优惠及收银提示规则。
建议先读取
pos.prices.get
治理与审批
唯读，不需要批核。
安全说明
不启用或停用任何促销。
pos.members.search
read按手机、会员编号或电邮搜寻会员，用于收银查询、注册或积分兑换。
建议先读取
pos.permission_rules.get
治理与审批
唯读，不需要批核。
安全说明
会员资料按前线权限遮蔽。
pos.member.get
read读取会员状态、积分、等级、网店购买纪录摘要及可用优惠。
建议先读取
pos.members.search
治理与审批
唯读，不需要批核。
安全说明
不显示不必要个人资料或完整网店订单明细。
pos.inventory_status.list
read读取门店、网店、仓库之间的可售库存、预留量及同步差异。
建议先读取
pos.products.search
治理与审批
唯读，不需要批核。
安全说明
只显示授权门店与仓库库存。
pos.online_pickup_orders.list
read列出网店下单、门店取货、待核销、部分取货及异常订单。
建议先读取
pos.store.get
治理与审批
唯读，不需要批核。
安全说明
顾客资料按取货流程需要最小化显示。
pos.sales.list
read按门店、日期、员工、会员、付款方式或状态查询销售单。
建议先读取
pos.store.get
治理与审批
唯读，不需要批核。
安全说明
分页及权限过滤交易资料。
pos.sale.get
read读取销售单明细、付款、折扣、会员、发票、退款及库存扣减状态。
建议先读取
pos.sales.list
治理与审批
唯读，不需要批核。
安全说明
卡资料与支付敏感栏位必须遮蔽。
pos.payments.list
read查询现金、信用卡、FPS、PayMe、QR code 等付款交易与对帐状态。
建议先读取
pos.sales.list
治理与审批
唯读，不需要批核。
安全说明
不显示卡号、完整交易 secret 或 gateway credential。
pos.shifts.list
read查询开更、收更、现金点算、员工、收银机及差异纪录。
建议先读取
pos.registers.list
治理与审批
唯读，不需要批核。
安全说明
只显示授权员工和门店更份。
pos.offline_queue.list
read列出离线期间暂存交易、付款、会员更新及同步冲突。
建议先读取
pos.registers.list
治理与审批
唯读，不需要批核。
安全说明
不自动重放 queue；只读状态和冲突。
pos.daily_close.get
read读取指定门店日结、Z-Report、支付总额、退款、折扣、现金差异及未处理项目。
建议先读取
pos.shifts.list, pos.payments.list
治理与审批
唯读，不需要批核。
安全说明
不提交日结；只读报表。
pos.sales_analytics.get
read读取各分店营收、热卖商品、付款组合、退款率、时段表现及会员销售。
建议先读取
pos.daily_close.get
治理与审批
唯读，不需要批核。
安全说明
报表资料按管理权限聚合。
pos.audit_logs.list
read查询改价、退款、取消单据、日结、离线同步及权限操作 audit log。
建议先读取
pos.permission_rules.get
治理与审批
唯读，不需要批核。
安全说明
Audit log 不可由 AI 修改或删除。
pos.promotion_update.preview
preview预览周末优惠、买二送一、加价购、会员折扣及收银提示对商品和门店的影响。
建议先读取
pos.promotion_rules.list, pos.products.search
治理与审批
Preview 不写入；apply 前必须批核。
安全说明
列出商品、时段、折扣、叠加规则及取消方式。
pos.price_update.preview
preview预览 POS 商品价格、会员价、门店价及生效时段变更。
建议先读取
pos.prices.get
治理与审批
Preview 不写入；改价需要人工批核。
安全说明
高风险大量改价需二次确认。
pos.checkout_cart.preview
preview预览购物车扫码后的价格、折扣、税项、会员积分、付款分拆及库存扣减。
建议先读取
pos.product.get, pos.member.get, pos.promotion_rules.list
治理与审批
Preview 不写入；正式 sale.create 前确认。
安全说明
避免错价、缺货或错误会员优惠。
pos.refund_exchange.preview
preview预览退款、退货、换货、电子收据核对、付款退回及库存回补影响。
建议先读取
pos.sale.get
治理与审批
Preview 不写入；退款或换货需按权限批核。
安全说明
不可对未核实或已全退单据重复退款。
pos.stock_sync.preview
preview预览门市销售、网店库存、店间调拨、离线交易同步后的库存差异。
建议先读取
pos.inventory_status.list, pos.offline_queue.list
治理与审批
Preview 不写入；sync 前需确认差异。
安全说明
标示来源时间，避免旧资料覆盖新库存。
pos.daily_close.preview
preview预览日结提交前的销售、付款、退款、现金差异、未同步交易及 Z-Report。
建议先读取
pos.daily_close.get, pos.offline_queue.list
治理与审批
Preview 不写入；submit 前需要店长或财务批核。
安全说明
有未同步交易或支付差异时不可自动日结。
pos.sale.create
write建立销售单、锁定价格折扣、计算税项、扣减库存并产生收据资料。
建议先读取
pos.checkout_cart.preview
治理与审批
由收银员按权限执行；高风险折扣需经理批核。
安全说明
写入前检查价格、库存、会员及付款状态。
pos.sale.void
write作废未完成或合资格销售单，记录原因、员工、经理批核及库存回复。
建议先读取
pos.sale.get, pos.permission_rules.get
治理与审批
通常需要经理批核。
安全说明
已完成支付或已日结交易需走退款流程，不直接 void。
pos.refund.create
write建立已批核退款，处理付款退回、库存回补、会员积分逆转及电子收据纪录。
建议先读取
pos.refund_exchange.preview
治理与审批
需要有权限员工或经理批核。
安全说明
防止重复退款和金额超出原交易。
pos.exchange.create
write建立换货纪录，处理退回商品、换出商品、差额付款及库存调整。
建议先读取
pos.refund_exchange.preview
治理与审批
按退换货政策批核。
安全说明
不可对不符合政策或未核实单据换货。
pos.payment.capture
write记录或发起现金、卡、FPS、PayMe、QR code 等付款 capture。
建议先读取
pos.checkout_cart.preview
治理与审批
由收银员按支付权限执行。
安全说明
不保存完整卡资料；支付结果需可对帐。
pos.payment_reconciliation.record
write记录付款批次对帐结果、差异原因、财务备注及处理状态。
建议先读取
pos.payments.list, pos.daily_close.preview
治理与审批
财务或店长按差异大小批核。
安全说明
不可改写原始支付交易，只新增对帐纪录。
pos.member.upsert
write在收银流程建立或更新会员基本资料，并同步 CRM / 网店会员记录。
建议先读取
pos.members.search
治理与审批
按会员资料权限执行；重要资料变更需确认。
安全说明
只收集必要资料，并保留同意纪录。
pos.member_points.adjust
write调整会员积分、兑换、撤销或补发，并记录原因和关联销售单。
建议先读取
pos.member.get, pos.permission_rules.get
治理与审批
人工积分调整需授权批核。
安全说明
避免重复派分或未授权扣分。
pos.price_update.apply
write套用已批核的 POS 价格、门店价、会员价或时段价格。
建议先读取
pos.price_update.preview
治理与审批
需要人工批核；大量改价需二次确认。
安全说明
按 diff 写入，保留回滚版本。
pos.promotion_rule.upsert
write新增或更新已批核的促销规则、折扣时段、收银提示及适用门店。
建议先读取
pos.promotion_update.preview
治理与审批
需要人工批核；批核需包含商品、时段、门店和叠加规则。
安全说明
不可启用未批核或互相冲突的促销。
pos.product_sync_to_registers.run
write把商品、条码、价格、促销、税项及收银提示同步到指定收银机。
建议先读取
pos.price_update.preview, pos.promotion_update.preview
治理与审批
需要按门店范围批核。
安全说明
同步前检查收银机在线状态和版本。
pos.inventory_deduction.sync
write同步门市销售、退款、换货、离线交易对网店和仓库库存的扣减或回补。
建议先读取
pos.stock_sync.preview
治理与审批
差异同步需确认来源和时间。
安全说明
避免旧交易覆盖新库存，保留同步批次。
pos.online_pickup.fulfil
write核销网店店取订单，更新取货状态、库存、会员纪录及收据。
建议先读取
pos.online_pickup_orders.list
治理与审批
由门店员工按取货权限执行。
安全说明
需核对订单、顾客凭证及未取货状态。
pos.shift.open
write为员工、收银机及钱箱开更，记录开更现金和设备状态。
建议先读取
pos.registers.list, pos.staff_sessions.list
治理与审批
按员工更份权限执行。
安全说明
同一收银机不可重复开更。
pos.shift.close
write收更并记录现金点算、支付摘要、差异、未完成交易及员工确认。
建议先读取
pos.shifts.list, pos.payments.list
治理与审批
差异超出阈值需店长批核。
安全说明
有未同步交易时不可静默收更。
pos.cash_movement.record
write记录入钱、出钱、找续、 petty cash 或钱箱调整原因。
建议先读取
pos.shifts.list
治理与审批
按现金操作权限；大额需批核。
安全说明
保留员工、时间、金额和原因 audit。
pos.device_pairing.update
write更新收银机与打印机、扫描器、钱箱或支付 terminal 的配对设定。
建议先读取
pos.devices.list
治理与审批
需要管理员批核或设备配对权限。
安全说明
不回传或储存明文 pairing secret。
pos.store_status.update
write更新门店营业、暂停、维护、临时 pop-up 或 O2O 取货状态。
建议先读取
pos.store.get
治理与审批
需要门店管理权限。
安全说明
状态变更需记录原因及影响渠道。
pos.offline_queue.sync
write把离线交易、付款、会员更新及库存扣减同步回云端，并处理冲突。
建议先读取
pos.offline_queue.list, pos.stock_sync.preview
治理与审批
冲突或大额交易需人工确认。
安全说明
按 queue 顺序和 idempotency 执行，避免重复交易。
pos.daily_close.submit
write提交门店日结 Z-Report，锁定销售、付款、退款、现金差异及报表版本。
建议先读取
pos.daily_close.preview, pos.shift.close
治理与审批
需要店长或财务批核。
安全说明
提交前必须没有未处理离线 queue 或重大对帐差异。
pos.action_request.status
status查询 POS 写入、同步、改价、退款、日结或硬件配对 request 的批核和执行状态。
建议先读取
related write endpoint
治理与审批
状态查询不需要批核。
安全说明
只查询状态，不重新执行交易或同步。