name: Ramp自动化 description: “Ramp自动化:通过Ramp平台管理企业卡交易、报销、用户和费用跟踪” requires: mcp: [rube]
Ramp自动化
自动化Ramp企业财务操作,包括检索交易、管理报销、搜索费用、查看卡片详情和列出用户,用于费用管理和会计工作流。
工具文档: composio.dev/toolkits/ramp
设置
此技能需要连接到 https://rube.app/mcp 的 Rube MCP 服务器。
在执行任何工具之前,确保存在 ramp 工具包的活跃连接。如果没有活跃连接,请通过 RUBE_MANAGE_CONNECTIONS 启动一个。
核心工作流
1. 列出所有交易
检索所有企业卡交易,并提供全面的筛选选项。
工具: RAMP_GET_ALL_TRANSACTIONS
关键参数:
from_date– 此日期之后的交易(ISO 8601 日期时间)to_date– 此日期之前的交易(ISO 8601 日期时间,默认:今天)user_id– 按用户 UUID 筛选card_id– 按物理卡 UUID 筛选department_id– 按部门 UUID 筛选merchant_id– 按商户 UUID 筛选entity_id– 按业务实体 UUID 筛选min_amount/max_amount– 金额范围筛选(美元)state– 交易状态;设置为"ALL"以包含被拒绝的交易approval_status– 按审批状态筛选sync_status– 按 ERP 同步状态筛选(覆盖sync_ready和has_no_sync_commits)has_no_sync_commits–true表示未同步的交易sync_ready–true表示准备同步到 ERP 的交易requires_memo–true表示缺少必要备忘录的交易include_merchant_data–true以包含来自商户的完整购买数据page_size– 每页结果数(2–100,默认:20)start– 分页游标:上一页最后一个实体的 IDorder_by_date_desc/order_by_date_asc– 按日期排序order_by_amount_desc/order_by_amount_asc– 按金额排序
示例:
工具: RAMP_GET_ALL_TRANSACTIONS
参数:
from_date: "2026-02-01T00:00:00Z"
to_date: "2026-02-11T23:59:59Z"
page_size: 50
order_by_date_desc: true
2. 搜索交易
通过商户名称、备忘录或其他交易详情搜索交易。
工具: RAMP_SEARCH_TRANSACTIONS
关键参数:
query(必需)-- 搜索商户名称、备忘录或其他详情的文本- 所有来自
RAMP_GET_ALL_TRANSACTIONS的筛选参数也可用
示例:
工具: RAMP_SEARCH_TRANSACTIONS
参数:
query: "AWS"
from_date: "2026-01-01T00:00:00Z"
page_size: 25
3. 获取交易详情
检索特定交易的完整详情,包括商户详情、收据、会计代码和争议信息。
工具: RAMP_GET_TRANSACTION
关键参数:
transaction_id(必需)-- 交易的 ID
示例:
工具: RAMP_GET_TRANSACTION
参数:
transaction_id: "txn_abc123def456"
4. 管理报销
列出和检索报销记录,用于审批工作流和费用分析。
工具:
RAMP_LIST_REIMBURSEMENTS– 列出报销并筛选RAMP_GET_REIMBURSEMENT– 获取特定报销的完整详情
RAMP_LIST_REIMBURSEMENTS 的关键参数:
user_id– 按员工 UUID 筛选entity_id– 按业务实体 UUID 筛选from_date/to_date– 创建日期的范围from_submitted_at/to_submitted_at– 提交日期的范围from_transaction_date/to_transaction_date– 底层交易日期的范围awaiting_approval_by_user_id– 筛选待特定审批人的报销sync_status– 按 ERP 同步状态筛选has_no_sync_commits–true表示未同步的报销sync_ready–true表示准备同步的报销direction–"BUSINESS_TO_USER"(默认)或"USER_TO_BUSINESS"(还款)page_size– 每页结果数(2–100,默认:20)start– 分页游标
示例:
工具: RAMP_LIST_REIMBURSEMENTS
参数:
from_date: "2026-02-01T00:00:00Z"
sync_ready: true
page_size: 50
5. 列出用户和获取我的交易
查看组织用户和个人交易历史。
工具:
RAMP_LIST_USERS– 列出用户,按部门、角色、位置、实体筛选RAMP_GET_MY_TRANSACTIONS– 获取认证用户的交易
RAMP_LIST_USERS 的关键参数:
department_id– 按部门 UUID 筛选role– 按用户角色筛选email– 按电子邮件地址筛选employee_id– 按员工 ID 筛选entity_id– 按业务实体 UUID 筛选location_id– 按位置 UUID 筛选page_size– 每页结果数(2–100,默认:20)
示例:
工具: RAMP_LIST_USERS
参数:
role: "ADMIN"
page_size: 50
6. 查看卡片详情和会计字段
检索卡片信息和自定义会计字段配置。
工具:
RAMP_GET_CARD– 获取详细卡片信息(消费限额、持卡人、履行状态)RAMP_FETCH_CUSTOM_ACCOUNTING_FIELD– 获取自定义会计字段定义
已知陷阱
| 陷阱 | 详情 |
|---|---|
| 需要分页 | 所有列表端点返回分页结果。使用 start 参数与上一页最后一个实体的 ID 来迭代。 |
| 日期格式 | 所有日期参数必须是 ISO 8601 日期时间格式(例如,"2026-02-11T00:00:00Z")。纯日期字符串将失败。 |
| sync_status 优先级 | 当设置 sync_status 时,它覆盖 has_no_sync_commits 和 sync_ready 参数。 |
| 金额筛选以美元计 | min_amount 和 max_amount 以美元计。筛选时确保正确的货币上下文。 |
| state=ALL 包含被拒绝交易 | 默认情况下,被拒绝的交易被排除。设置 state: "ALL" 以在结果中包含它们。 |
| page_size 范围 | 必须在 2 到 100 之间。默认是 20。超出此范围的值会导致错误。 |
快速参考
| 工具标识 | 描述 |
|---|---|
RAMP_GET_ALL_TRANSACTIONS |
列出所有交易并筛选 |
RAMP_SEARCH_TRANSACTIONS |
通过文本查询搜索交易 |
RAMP_GET_TRANSACTION |
获取特定交易的详情 |
RAMP_GET_MY_TRANSACTIONS |
获取认证用户的交易 |
RAMP_LIST_REIMBURSEMENTS |
列出报销并筛选 |
RAMP_GET_REIMBURSEMENT |
获取特定报销的详情 |
RAMP_LIST_USERS |
列出组织用户 |
RAMP_GET_CARD |
获取卡片详情 |
RAMP_FETCH_CUSTOM_ACCOUNTING_FIELD |
获取自定义会计字段配置 |
由 Composio 提供支持