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-- 金額範囲フィルター (USD)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-- 1ページあたりの結果数 (2～100、デフォルト: 20)start-- ページネーションカーソル: 前ページの最後のエンティティのIDorder_by_date_desc/order_by_date_asc-- 日付で並び替えorder_by_amount_desc/order_by_amount_asc-- 金額で並び替え
例:
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
2. 取引の検索
加盟店名、メモ、またはその他の取引詳細で取引を検索します。
ツール: RAMP_SEARCH_TRANSACTIONS
主要パラメータ:
query(必須) -- 加盟店名、メモ、またはその他の詳細を検索するテキストRAMP_GET_ALL_TRANSACTIONSのすべてのフィルターパラメータも使用可能
例:
Tool: RAMP_SEARCH_TRANSACTIONS
Arguments:
query: "AWS"
from_date: "2026-01-01T00:00:00Z"
page_size: 25
3. 取引詳細の取得
特定の取引の完全な詳細を取得します。加盟店情報、領収書、会計コード、異議申し立て情報などが含まれます。
ツール: RAMP_GET_TRANSACTION
主要パラメータ:
transaction_id(必須) -- 取引のID
例:
Tool: RAMP_GET_TRANSACTION
Arguments:
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-- 1ページあたりの結果数 (2～100、デフォルト: 20)start-- ページネーションカーソル
例:
Tool: RAMP_LIST_REIMBURSEMENTS
Arguments:
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-- 1ページあたりの結果数 (2～100、デフォルト: 20)
例:
Tool: RAMP_LIST_USERS
Arguments:
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 の両パラメータより優先されます。 |
| 金額フィルターはUSD | min_amount と max_amount はUSDです。フィルタリング時に通貨コンテキストが正しいことを確認してください。 |
| 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 | カスタム会計フィールド設定を取得 |
Powered by Composio