如何利用 AI 自动化管理 Square 支付、订单与发票 #

通过 Rube MCP 集成 Square toolkit，让 AI 具备直接操作 Square 账户的能力，实现支付查询、订单追踪、门店调度及发票管理等业务流程的自动化。

为什么需要这个技能 #

对于使用 Square 进行商业运营的用户，频繁在后台手动切换界面来查询支付状态、核对订单或管理发票非常低效。

通过本技能，你可以将 Square 的能力原子化为 AI 可调用的工具。AI 不再只是提供建议，而是可以直接执行具体操作：例如“列出昨天所有待支付的发票”或“根据订单号更新配送状态”。通过 Rube MCP 的标准化接口，你可以快速构建一套无需编写复杂 API 代码的财务与订单管理工作流。

适用场景 #

• 财务对账：快速获取特定时间段内的所有支付记录并导出分析。
• 订单跟踪：通过特定条件搜索订单，并快速更新订单状态或详情。
• 多店管理：在多个商业地点（Locations）之间快速切换并同步信息。
• 发票自动化：批量检索未支付发票并执行取消或提醒操作。

核心工作流 #

1. 环境初始化 #

在执行任何操作前，必须确保 Rube MCP 已连接且 Square 授权状态为 ACTIVE：

• 添加 MCP 服务器：https://rube.app/mcp。
• 调用 RUBE_MANAGE_CONNECTIONS 激活 square 工具集。
• 务必先运行 RUBE_SEARCH_TOOLS 以获取最新的工具 Schema。

2. 关键操作链路 #

• 支付监控：使用 SQUARE_LIST_PAYMENTS（需符合 RFC 3339 时间格式） $\to$ 根据需要调用 SQUARE_CANCEL_PAYMENT。
• 订单管理：SQUARE_LIST_LOCATIONS 获取门店 ID $\to$ SQUARE_SEARCH_ORDERS 检索 $\to$ SQUARE_UPDATE_ORDER 修改（注意必须携带 version 字段以防止冲突）。
• 发票处理：SQUARE_LIST_LOCATIONS $\to$ SQUARE_LIST_INVOICES $\to$ SQUARE_CANCEL_INVOICE。

3. 避坑指南 #

• ID 解析：大多数操作（如查询订单/发票）都要求先提供 location_id。建议 AI 先调用 SQUARE_LIST_LOCATIONS 并缓存 ID。
• 版本控制：更新订单或取消发票时，必须先通过 RETRIEVE 接口获取当前的 version 字段，否则会触发 409 Conflict 错误。
• 分页处理：当结果集较大时，必须检查响应中的 cursor 字段并在下次请求中传递，直到 cursor 为空。

下载和安装 #

下载 square-automation 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要 #

暂无推荐