pos.config.get
read讀取 POS 設定、時區、稅項、貨幣、支援付款方式、離線模式及同步策略。
建議先讀取
-
治理與審批
唯讀，不需要批核。
安全說明
不回傳支付密鑰、terminal secret 或員工密碼。
POS 系統 MCP 工具
POS 系統 MCP 工具按門市營運 workflow 設計，覆蓋門店、收銀機、硬件、員工權限、商品價格、促銷引擎、會員積分、庫存同步、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
治理與審批
狀態查詢不需要批核。
安全說明
只查詢狀態，不重新執行交易或同步。