用途:该技能用于与 Heartland 数据交互。Heartland 是面向零售、餐饮和酒店业中小企业的支付处理与销售点(POS)解决方案提供商。官方文档:https://developer.heartlandpaymentsystems.com/
主要能力:可操作的对象包括客户、项目、预算、发票、供应商、用户、任务、工时条目、费用报告、付款、日记账分录、账户、税率、账单、贷项通知单、存款、转账、会计科目表、公司设置、报告、附件、备注等。具体动作名称与参数按需使用。
使用方式:先安装 Membrane CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。连接 Heartland:membrane connection ensure "https://www.heartland.us/" --json,用户在浏览器完成认证;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。也可通过代理直接请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query、--pathParam 等选项。任意命令加 --json 可获得机器可读输出。
适用场景:需要读取或写入 Heartland 业务数据、自动化财务与运营工作流时使用。
限制:Membrane 负责认证与凭证刷新,不应向用户索取 API 密钥或令牌;应优先使用预置动作而非原始 API 调用。资料未提供具体动作清单、参数细节、收费与平台支持范围。