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-- 동기화되지 않은 거래의 경우truesync_ready-- ERP에 동기화할 준비가 된 거래의 경우truerequires_memo-- 필수 메모가 누락된 거래의 경우trueinclude_merchant_data-- 상점의 전체 구매 데이터를 포함하려면truepage_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-- 동기화되지 않은 환급의 경우truesync_ready-- 동기화할 준비가 된 환급의 경우truedirection--"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-- 맞춤 회계 필드 정의 조회
알려진 문제점
| 문제점 | 설명 |
|---|---|
| 페이지네이션 필요 | 모든 목록 엔드포인트는 페이지네이션된 결과를 반환합니다. 이전 페이지의 마지막 엔티티 ID를 start 파라미터에 사용하여 반복하십시오. |
| 날짜 형식 | 모든 날짜 파라미터는 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 | 맞춤 회계 필드 구성 조회 |
Composio 제공