booking.config.get
read读取预约系统时区、预约间隔、最早最迟预约、付款、提醒及改期取消基本设定。
建议先读取
-
治理与审批
只读；可作所有预约写入前的基准设定。
安全说明
不得回传 payment secret、API key 或私人备注。
线上预约系统 MCP 工具
线上预约系统 MCP 工具按预约营运流程设计，覆盖服务、地点、员工、房间设备、时段、封锁规则、客户、预约、订金付款、改期取消政策、套票扣次、提醒通知、候补名单、出席 no-show、容量分析及 audit。
booking.services.list
read列出可预约服务、分类、时长、基本价格、容量、订金及套票扣次规则。
建议先读取
booking.config.get
治理与审批
只读；用于建立可预约时段或客户预约前核对服务规则。
安全说明
只显示启用或授权可见服务，避免泄露内部草稿服务。
booking.service.get
read读取单一服务的时长、缓冲时间、可用资源、价格、订金、取消及改期限制。
建议先读取
booking.services.list
治理与审批
只读；服务调整或预约建立前必须先核对。
安全说明
不得暴露未授权成本、员工佣金或内部利润栏位。
booking.locations.list
read列出分店、服务地点、营业时间、地址、时区及可用服务范围。
建议先读取
booking.config.get
治理与审批
只读；用于按地点搜寻可预约时段。
安全说明
隐藏内部仓库、员工专用地点或未公开地址。
booking.resources.list
read列出员工、房间、设备、容量及可配对服务，支援避免撞期。
建议先读取
booking.services.list, booking.locations.list
治理与审批
只读；开放时段及分配预约前使用。
安全说明
按权限遮蔽员工私人资料及内部资源成本。
booking.staff_schedules.list
read查询员工班表、休假、可接服务、每日上限及已安排预约。
建议先读取
booking.resources.list
治理与审批
只读；用于时段开放、改期及人手调配。
安全说明
只回传工作相关 availability，不暴露薪酬或私人行程。
booking.blackout_rules.list
read读取公众假期、维修、内部活动、临时封锁及最短预约通知规则。
建议先读取
booking.config.get, booking.locations.list
治理与审批
只读；搜寻或开放时段前必须套用。
安全说明
只显示必要原因，避免披露敏感内部安排。
booking.availability.search
read按服务、地点、员工、日期、容量及价格规则搜寻可预约时段。
建议先读取
booking.service.get, booking.staff_schedules.list, booking.blackout_rules.list
治理与审批
只读；客户自助预约及 staff 代客预约前使用。
安全说明
不得显示其他客户姓名；只提供容量和可预约状态。
booking.slot.get
read读取指定时段的服务、资源、容量、已预约数、候补、价格及付款要求。
建议先读取
booking.availability.search
治理与审批
只读；建立、改期、封锁或释放时段前核对。
安全说明
预设不回传完整客户名单，除非 staff 权限允许。
booking.bookings.list
read按日期、服务、员工、地点、状态、付款状态或客户查询预约。
建议先读取
booking.config.get
治理与审批
只读；营运查询、提醒、改期及 no-show 处理前使用。
安全说明
客户 PII 需按角色遮蔽；避免大量汇出。
booking.booking.get
read读取单一预约的客户、服务、时段、资源、付款、提醒、改期及 audit 纪录。
建议先读取
booking.bookings.list
治理与审批
只读；任何取消、改期、退款、扣次或出席更新前必须先读。
安全说明
只向授权 staff 显示联络资料及备注。
booking.customers.search
read按电话、电邮、姓名或会员编号搜寻预约客户。
建议先读取
booking.config.get
治理与审批
只读；代客建立预约或查询历史前使用。
安全说明
搜寻结果需限量并遮蔽部分电话电邮。
booking.customer.get
read读取客户预约历史、偏好、no-show 记录、同意状态及套票馀额摘要。
建议先读取
booking.customers.search
治理与审批
只读；预约、提醒或套票扣次前核对。
安全说明
医疗、未成年人或敏感备注须受额外权限保护。
booking.packages.list
read查询客户套票、剩馀次数、有效期、适用服务及扣次限制。
建议先读取
booking.customer.get, booking.service.get
治理与审批
只读；扣次、预约确认或退款前使用。
安全说明
不得向非授权角色披露付款金额或合约条款。
booking.payment_settings.get
read读取 Stripe、PayMe、FPS、订金比例、退款窗口及付款到期规则。
建议先读取
booking.config.get
治理与审批
只读；付款收取、订金退款及预约确认前使用。
安全说明
不得回传 secret key、完整交易卡资料或银行敏感资料。
booking.payments.list
read查询预约付款、订金、馀额、退款、付款证明及 gateway 状态。
建议先读取
booking.booking.get, booking.payment_settings.get
治理与审批
只读；退款、追款或确认付款前使用。
安全说明
遮蔽交易参考以外的敏感付款资料。
booking.reminder_rules.list
read读取预约确认、改期、取消、服务前提醒及 no-show follow-up 规则。
建议先读取
booking.config.get
治理与审批
只读；发送或更新提醒规则前使用。
安全说明
不得暴露 WhatsApp token 或讯息供应商 secret。
booking.reschedule_policy.get
read读取最迟改期、取消收费、退款、候补及人工批核政策。
建议先读取
booking.service.get, booking.payment_settings.get
治理与审批
只读；改期、取消及退款 preview 前必须套用。
安全说明
政策例外需标示来源，不可自行推断免罚。
booking.waitlist.list
read查询候补名单、偏好时段、通知状态、到期时间及排序原因。
建议先读取
booking.slot.get, booking.customer.get
治理与审批
只读；释放名额或 offer slot 前使用。
安全说明
候补排序需可解释，避免暴露其他客户 PII。
booking.booking_summary.get
read读取预约量、成交、取消率、no-show、收入、订金及退款摘要。
建议先读取
booking.bookings.list, booking.payments.list
治理与审批
只读；营运报告及改善建议使用。
安全说明
报告需聚合处理，不应显示单一客户敏感资料。
booking.capacity_summary.get
read读取热门时段、容量使用率、员工使用率、房间设备负载及等候需求。
建议先读取
booking.availability.search, booking.bookings.list
治理与审批
只读；用于下月时段开放及人手安排。
安全说明
避免以个别员工绩效作公开比较。
booking.audit_logs.list
read查询预约、付款、退款、改期、取消、扣次及提醒的操作纪录。
建议先读取
booking.booking.get
治理与审批
只读；用于追踪争议、错误或审批纪录。
安全说明
audit 只供授权管理员查看，不应公开。
booking.slot_release.preview
preview预览批量开放下月时段后的员工、房间、容量、价格及撞期影响。
建议先读取
booking.services.list, booking.resources.list, booking.staff_schedules.list, booking.blackout_rules.list, booking.capacity_summary.get
治理与审批
必须先 preview；只有批核后才可 open slot。
安全说明
不得自动覆盖封锁日、员工休假或容量限制。
booking.create_booking.preview
preview预览建立预约会否撞期、需要订金、扣套票、加入候补或触发提醒。
建议先读取
booking.slot.get, booking.customer.get, booking.payment_settings.get, booking.packages.list
治理与审批
代客或 AI 建立预约前需确认 preview 结果。
安全说明
不得绕过客户同意、订金要求或黑名单限制。
booking.reschedule.preview
preview预览改期后的旧时段释放、新时段可用性、费用、提醒及候补影响。
建议先读取
booking.booking.get, booking.reschedule_policy.get, booking.availability.search
治理与审批
改期前需取得客户或 staff 批核。
安全说明
不得在政策限制外自动改期；晚改需人工批核。
booking.cancellation.preview
preview预览取消后的退款、订金没收、名额释放、候补通知及提醒取消。
建议先读取
booking.booking.get, booking.reschedule_policy.get, booking.payments.list, booking.waitlist.list
治理与审批
取消及退款动作需按政策或管理员批核。
安全说明
不得自行豁免取消费或退款限制。
booking.deposit_refund.preview
preview预览订金或付款退款金额、gateway 状态、手续费、可退款期限及会计影响。
建议先读取
booking.booking.get, booking.payment_settings.get, booking.payments.list
治理与审批
退款必须经授权角色批核。
安全说明
不得重复退款；必须检查 gateway transaction 状态。
booking.package_deduction.preview
preview预览预约确认或出席后的套票扣次、有效期及馀额变化。
建议先读取
booking.booking.get, booking.packages.list
治理与审批
扣次前需确认服务适用、馀额足够及客户身份。
安全说明
避免重复扣次；需要 idempotency key。
booking.reminders.preview
preview预览确认、改期、取消、服务前提醒及候补通知内容、渠道和收件人。
建议先读取
booking.booking.get, booking.reminder_rules.list, booking.customer.get
治理与审批
大量或客制讯息发送前需确认内容及收件人。
安全说明
遵守同意状态、退订及讯息模板限制。
booking.service.upsert
write新增或更新服务的名称、时长、容量、价格、订金、资源要求及可预约规则。
建议先读取
booking.service.get, booking.payment_settings.get
治理与审批
服务公开资料或价格变更需批核后生效。
安全说明
保留版本纪录；不得影响既有预约价格除非明确指定。
booking.resource_availability.upsert
write新增或更新员工、房间、设备的可预约时间、容量、服务配对及封锁规则。
建议先读取
booking.resources.list, booking.staff_schedules.list, booking.blackout_rules.list
治理与审批
会影响公开时段或既有预约时需批核。
安全说明
不得移除已被预约占用的资源而不提示冲突。
booking.slot_batch.open
write批量开放指定日期范围的可预约时段，套用员工、房间、容量及价格规则。
建议先读取
booking.slot_release.preview
治理与审批
必须基于已批核 preview 执行。
安全说明
需 idempotency；避免重复开放或覆盖封锁日。
booking.slot.block
write封锁指定时段作休息、维修、内部活动或临时不可预约。
建议先读取
booking.slot.get, booking.bookings.list
治理与审批
如已有预约，必须先处理客户通知、改期或退款批核。
安全说明
不得静默取消客户预约。
booking.booking.create
write建立客户预约，锁定时段、服务、资源、订金要求及通知任务。
建议先读取
booking.create_booking.preview
治理与审批
需客户确认或授权 staff 代客确认。
安全说明
检查容量、同意状态、付款要求及 idempotency。
booking.booking.confirm
write确认暂存或待付款预约，更新付款、订金、套票及提醒状态。
建议先读取
booking.booking.get, booking.payments.list, booking.package_deduction.preview
治理与审批
确认前需核对付款或套票扣次。
安全说明
避免 unpaid booking 被错误确认。
booking.booking.reschedule
write将预约改到新时段，释放旧时段，更新资源、费用、提醒及 audit。
建议先读取
booking.reschedule.preview
治理与审批
需客户或授权 staff 批核；晚改期需管理员批核。
安全说明
不可在未确认新时段可用前释放旧时段。
booking.booking.cancel
write取消预约，处理退款、订金没收、时段释放、候补及通知。
建议先读取
booking.cancellation.preview
治理与审批
按政策或管理员批核后执行。
安全说明
取消原因、操作者及退款决策必须留 audit。
booking.booking.check_in
write标记客户到场，触发套票扣次、尾款处理或服务完成流程。
建议先读取
booking.booking.get, booking.package_deduction.preview
治理与审批
前线 staff 可按权限执行；扣次需可追溯。
安全说明
避免同一预约重复 check-in 或重复扣次。
booking.booking.mark_no_show
write标记 no-show，更新客户纪录、订金处理、候补释放及 follow-up 通知。
建议先读取
booking.booking.get, booking.reschedule_policy.get, booking.payments.list
治理与审批
如涉及扣费或封锁客户，需管理员批核。
安全说明
保留 staff 记录及时间，避免误标 no-show。
booking.deposit.capture
write收取或确认预约订金、全额付款或付款证明，并更新预约付款状态。
建议先读取
booking.booking.get, booking.payment_settings.get, booking.payments.list
治理与审批
线下付款确认需授权 staff；online capture 需 gateway 状态确认。
安全说明
不得储存完整卡资料；防止重复收款。
booking.refund.create
write按已批核 preview 建立退款，更新付款、预约及会计纪录。
建议先读取
booking.deposit_refund.preview
治理与审批
必须由授权角色批核退款金额和原因。
安全说明
使用 idempotency，检查 gateway 是否已退款。
booking.package_session.deduct
write为已确认或已出席预约扣减套票次数，记录馀额及扣次来源。
建议先读取
booking.package_deduction.preview
治理与审批
按服务和套票规则执行；例外需批核。
安全说明
必须防止同一 booking 重复扣次。
booking.waitlist.offer_slot
write向候补客户提供释放时段，设定接受期限并暂时锁定名额。
建议先读取
booking.waitlist.list, booking.slot.get, booking.reminders.preview
治理与审批
按候补排序或 staff 批核后发送。
安全说明
不得同时向过多客户永久锁定同一名额。
booking.staff.assign
write为预约指派或更换负责员工，检查资格、班表和撞期。
建议先读取
booking.booking.get, booking.staff_schedules.list, booking.slot.get
治理与审批
更换已确认预约 staff 需按权限或管理员批核。
安全说明
不得指派无资格、休假或已满负荷员工。
booking.reminder.send
write发送预约确认、付款、改期、取消、服务前提醒、候补或 no-show follow-up。
建议先读取
booking.reminders.preview
治理与审批
自动提醒按规则发送；人工或大量发送需确认。
安全说明
遵守同意、退订、频率限制及模板审批。
booking.reminder_rule.upsert
write新增或更新提醒规则、渠道、发送时间、模板及适用服务。
建议先读取
booking.reminder_rules.list, booking.reminders.preview
治理与审批
影响大量客户通知的规则需管理员批核。
安全说明
防止短时间重复发送或违反 template policy。
booking.analytics_snapshot.record
write保存预约量、容量、收入、取消、no-show 及渠道成效的营运快照。
建议先读取
booking.booking_summary.get, booking.capacity_summary.get
治理与审批
只写入聚合报告资料；不改动客户或预约。
安全说明
避免把个人资料写入 analytics snapshot。
booking.action_request.status
status查询预约系统写入请求、批核、执行、失败、重试及 audit 状态。
建议先读取
booking.audit_logs.list
治理与审批
只读状态；用于追踪 slot release、退款、改期及通知。
安全说明
不得透过 status endpoint 重新执行写入。