如何用 Ramp 自动化技能按日期和状态筛选公司卡交易并翻页导出
发布时间:2026/9/15 15:40:34 作者:尧图编辑部 阅读量:1,286

如何用 Ramp 自动化技能按日期和状态筛选公司卡交易并翻页导出【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills如果你需要把公司在 Ramp 平台上的公司卡交易按时间范围和交易状态拉出来做对账或归档可以在 Codex 中使用本仓库的 Ramp Automation 技能通过RAMP_GET_ALL_TRANSACTIONS工具按from_date/to_date和state等参数筛选再用start游标逐页取回全部结果。前提条件是本地 Codex 已安装该技能并且 Rube MCP server 已连接、ramptoolkit 存在活跃连接。技能的完整定义见 composio-skills/ramp-automation/SKILL.md其 YAML frontmatter 声明了requires: mcp: [rube]说明该技能依赖 Rube MCP server 运行。准备条件安装技能并确认 Rube MCP 连接安装方式参照 README.md 的 Quickstart。克隆仓库后运行技能安装脚本把composio-skills/ramp-automation装进$CODEX_HOME/skills默认~/.codex/skillsgit clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/ramp-automation脚本成功时会打印Installed ramp-automation to 目标目录技能目录名取自路径末段。也可以手动把composio-skills/ramp-automation整个文件夹复制进$CODEX_HOME/skills/。安装或更新技能后需要重启 Codex让它重新加载技能元数据。验证安装命令来自 README 的 Using Skills in Codex 一节ls ~/.codex/skills head ~/.codex/skills/ramp-automation/SKILL.md能看到ramp-automation目录且SKILL.md开头是name: Ramp Automation的 frontmatter即安装成功。接下来确认 MCP 连接。SKILL.md 的 Setup 一节要求Rube MCP server 连接在https://rube.app/mcp在执行任何工具前确认ramptoolkit 存在活跃连接如果没有通过RUBE_MANAGE_CONNECTIONS发起连接。按日期和状态筛选交易主工具是RAMP_GET_ALL_TRANSACTIONS它Retrieve all corporate card transactions with comprehensive filtering options。与本文场景直接相关的参数如下均出自 SKILL.md参数作用from_date只返回该日期之后的交易ISO 8601 datetimeto_date只返回该日期之前的交易ISO 8601 datetime默认今天state按交易状态筛选设为ALL时包含被拒declined交易approval_status按审批状态筛选sync_status按 ERP 同步状态筛选设置后覆盖sync_ready和has_no_sync_commitspage_size每页条数2–100默认 20start翻页游标上一页最后一个实体的 IDorder_by_date_desc/order_by_date_asc按日期排序工具还支持按user_id、card_id、department_id、merchant_id、min_amount/max_amount等进一步收窄范围本文不展开。SKILL.md 给出的文档示例Tool: RAMP_GET_ALL_TRANSACTIONS Arguments: from_date: 2026-02-01T00:00:00Z to_date: 2026-02-11T23:59:59Z page_size: 50 order_by_date_desc: true按日期加状态筛选时在上例基础上增加state即可。下面是一次完整的筛选调用示意from_date/to_date需替换为你自己的范围格式必须是 ISO 8601 datetimeTool: RAMP_GET_ALL_TRANSACTIONS Arguments: from_date: 2026-02-01T00:00:00Z to_date: 2026-02-11T23:59:59Z state: ALL page_size: 50 order_by_date_desc: true两点筛选行为需要注意都写在 Known Pitfalls 里被拒交易默认不在结果中。只有state: ALL才会把它们包含进来不需要 declined 交易时就不传该参数。日期格式敏感。所有日期参数必须是 ISO 8601 datetime如2026-02-11T00:00:00Z纯日期字符串会失败。用 start 游标翻页取回全部结果SKILL.md 明确所有 list 类端点都返回分页结果翻页方式是用start参数传入上一页最后一个实体的 ID 继续迭代。导出完整数据集的路径就是反复做这一件事用同一组筛选参数调用RAMP_GET_ALL_TRANSACTIONS取回第一页page_size默认 20可选 2–100。记下该页最后一个实体的 ID作为下一次调用的start值。重复调用直到取完目标范围内的全部交易逐页结果汇总即为本次导出的数据。Tool: RAMP_GET_ALL_TRANSACTIONS Arguments: from_date: 2026-02-01T00:00:00Z to_date: 2026-02-11T23:59:59Z state: ALL page_size: 50 order_by_date_desc: true start: 上一页最后一个实体的 ID文档没有规定导出文件的格式翻页取回的各页结果集就是全部数据落盘形式可自行决定。常见报错与限制以下判断标准都来自 SKILL.md 的 Known Pitfalls 表可直接用于定位调用问题现象原因结果不全漏翻页。list 端点全部分页必须用start迭代调用失败日期参数不是 ISO 8601 datetime纯日期字符串会失败结果中多了/少了同步相关的过滤效果设置了sync_status时它同时覆盖has_no_sync_commits和sync_ready看不到被拒交易默认排除 declined需state: ALLpage_size报错取值必须在 2–100 之间默认 20超出范围会出错金额过滤对不上min_amount/max_amount以 USD 计完成上述步骤后你就能按任意日期区间和状态组合取回公司卡交易并逐页导出全部结果。若只需要某一条交易的完整明细商户信息、收据、会计科目、争议信息可再用RAMP_GET_TRANSACTION按transaction_id单独获取见 composio-skills/ramp-automation/SKILL.md 的 Get Transaction Details 一节。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考