ComposioHQ/Ramp-Automation

Was macht Ramp-Automation?

Automatisieren Sie Ramp-Unternehmensfinanzvorgänge, einschließlich des Abrufens von Transaktionen, der Verwaltung von Rückerstattungen, der Suche nach Ausgaben, der Ansicht von Kartendetails und der Auflistung von Nutzern für Spesenverwaltungs- und Buchhaltungsworkflows.

Toolkit-Dokumentation: composio.dev/toolkits/ramp

---

Einrichtung

Dieses Skill erfordert den Ruben MCP-Server, der unter https://rube.app/mcp verbunden ist.

Stellen Sie vor der Ausführung von Tools sicher, dass eine aktive Verbindung für das ramp-Toolkit besteht. Ist keine Verbindung aktiv, initiieren Sie eine über RUBE_MANAGE_CONNECTIONS.

---

Kern-Workflows

1. Alle Transaktionen auflisten

Rufen Sie alle Unternehmenskartentransaktionen mit umfangreichen Filteroptionen ab.

Tool: RAMP_GET_ALL_TRANSACTIONS

Wichtige Parameter:

• from_date -- Transaktionen nach diesem Datum (ISO-8601-Datetime)
• to_date -- Transaktionen vor diesem Datum (ISO-8601-Datetime, Standard: heute)
• user_id -- Nach Benutzer-UUID filtern
• card_id -- Nach physischer Karten-UUID filtern
• department_id -- Nach Abteilungs-UUID filtern
• merchant_id -- Nach Händler-UUID filtern
• entity_id -- Nach Geschäftseinheits-UUID filtern
• min_amount / max_amount -- Betragsspanne-Filter (USD)
• state -- Transaktionsstatus; setzen Sie auf "ALL", um abgelehnte Transaktionen einzuschließen
• approval_status -- Nach Genehmigungsstatus filtern
• sync_status -- Nach ERP-Synchronisationsstatus filtern (überschreibt sync_ready und has_no_sync_commits)
• has_no_sync_commits -- true für nicht synchronisierte Transaktionen
• sync_ready -- true für zur Synchronisation bereite Transaktionen
• requires_memo -- true für Transaktionen ohne erforderliche Memos
• include_merchant_data -- true, um vollständige Kaufdaten vom Händler einzuschließen
• page_size -- Ergebnisse pro Seite (2–100, Standard: 20)
• start -- Paginierungs-Cursor: ID des letzten Eintrags der vorherigen Seite
• order_by_date_desc / order_by_date_asc -- Nach Datum sortieren
• order_by_amount_desc / order_by_amount_asc -- Nach Betrag sortieren

Beispiel:

Tool: RAMP_GET_ALL_TRANSACTIONS
Argumente:
  from_date: "2026-02-01T00:00:00Z"
  to_date: "2026-02-11T23:59:59Z"
  page_size: 50
  order_by_date_desc: true

---

2. Transaktionen durchsuchen

Durchsuchen Sie Transaktionen nach Händlername, Memo oder anderen Transaktionsdetails.

Tool: RAMP_SEARCH_TRANSACTIONS

Wichtige Parameter:

• query (erforderlich) -- Suchtext für Händlername, Memo oder andere Details
• Alle Filterparameter von RAMP_GET_ALL_TRANSACTIONS sind ebenfalls verfügbar

Beispiel:

Tool: RAMP_SEARCH_TRANSACTIONS
Argumente:
  query: "AWS"
  from_date: "2026-01-01T00:00:00Z"
  page_size: 25

---

3. Transaktionsdetails abrufen

Rufen Sie vollständige Details einer bestimmten Transaktion ab, einschließlich Händlerdetails, Belege, Buchhaltungscodes und Streitinformationen.

Tool: RAMP_GET_TRANSACTION

Wichtige Parameter:

• transaction_id (erforderlich) -- ID der Transaktion

Beispiel:

Tool: RAMP_GET_TRANSACTION
Argumente:
  transaction_id: "txn_abc123def456"

---

4. Rückerstattungen verwalten

Listen und rufen Sie Rückerstattungsdatensätze für Genehmigungsworkflows und Ausgabenanalysen ab.

Tools:

• RAMP_LIST_REIMBURSEMENTS -- Rückerstattungen mit Filterung auflisten
• RAMP_GET_REIMBURSEMENT -- Vollständige Details einer bestimmten Rückerstattung abrufen

Wichtige Parameter für RAMP_LIST_REIMBURSEMENTS:

• user_id -- Nach Mitarbeiter-UUID filtern
• entity_id -- Nach Geschäftseinheits-UUID filtern
• from_date / to_date -- Datumsbereich für Erstellungsdatum
• from_submitted_at / to_submitted_at -- Datumsbereich für Einreichungsdatum
• from_transaction_date / to_transaction_date -- Datumsbereich der zugrunde liegenden Transaktion
• awaiting_approval_by_user_id -- Nach Rückerstattungen filtern, die auf einen bestimmten Genehmiger warten
• sync_status -- Nach ERP-Synchronisationsstatus filtern
• has_no_sync_commits -- true für nicht synchronisierte Rückerstattungen
• sync_ready -- true für zur Synchronisation bereite Rückerstattungen
• direction -- "BUSINESS_TO_USER" (Standard) oder "USER_TO_BUSINESS" (Rückzahlungen)
• page_size -- Ergebnisse pro Seite (2–100, Standard: 20)
• start -- Paginierungs-Cursor

Beispiel:

Tool: RAMP_LIST_REIMBURSEMENTS
Argumente:
  from_date: "2026-02-01T00:00:00Z"
  sync_ready: true
  page_size: 50

---

5. Nutzer auflisten und eigene Transaktionen abrufen

Zeigen Sie Organisationsnutzer und persönlichen Transaktionsverlauf an.

Tools:

• RAMP_LIST_USERS -- Nutzer mit Filterung nach Abteilung, Rolle, Standort, Einheit auflisten
• RAMP_GET_MY_TRANSACTIONS -- Transaktionen des authentifizierten Nutzers abrufen

Wichtige Parameter für RAMP_LIST_USERS:

• department_id -- Nach Abteilungs-UUID filtern
• role -- Nach Benutzerrolle filtern
• email -- Nach E-Mail-Adresse filtern
• employee_id -- Nach Mitarbeiter-ID filtern
• entity_id -- Nach Geschäftseinheits-UUID filtern
• location_id -- Nach Standort-UUID filtern
• page_size -- Ergebnisse pro Seite (2–100, Standard: 20)

Beispiel:

Tool: RAMP_LIST_USERS
Argumente:
  role: "ADMIN"
  page_size: 50

---

6. Kartendetails und Buchhaltungsfelder anzeigen

Rufen Sie Karteninformationen und benutzerdefinierte Buchhaltungsfeldkonfigurationen ab.

Tools:

• RAMP_GET_CARD -- Detaillierte Karteninformationen abrufen (Ausgabenlimits, Karteninhaber, Erfüllungsstatus)
• RAMP_FETCH_CUSTOM_ACCOUNTING_FIELD -- Benutzerdefinierte Buchhaltungsfelddefinitionen abrufen

---

Bekannte Fallstricke

Fallstrick	Detail
Paginierung erforderlich	Alle Listen-Endpunkte geben paginierte Ergebnisse zurück. Verwenden Sie den Parameter start mit der ID des letzten Eintrags der vorherigen Seite zum Iterieren.
Datumsformat	Alle Datumsparameter müssen im ISO-8601-Datetime-Format vorliegen (z. B. "2026-02-11T00:00:00Z"). Einfache Datumszeichenfolgen schlagen fehl.
sync_status-Priorität	Wenn sync_status gesetzt ist, überschreibt es sowohl has_no_sync_commits als auch sync_ready.
Betragsfilter in USD	min_amount und max_amount sind in USD. Stellen Sie den korrekten Währungskontext beim Filtern sicher.
state=ALL für abgelehnte	Standardmäßig werden abgelehnte Transaktionen ausgeschlossen. Setzen Sie state: "ALL", um sie in die Ergebnisse aufzunehmen.
page_size-Grenzen	Muss zwischen 2 und 100 liegen. Standard ist 20. Werte außerhalb dieses Bereichs verursachen Fehler.

---

Kurzreferenz

Tool-Slug	Beschreibung
RAMP_GET_ALL_TRANSACTIONS	Alle Transaktionen mit Filterung auflisten
RAMP_SEARCH_TRANSACTIONS	Transaktionen nach Textabfrage durchsuchen
RAMP_GET_TRANSACTION	Details einer bestimmten Transaktion abrufen
RAMP_GET_MY_TRANSACTIONS	Transaktionen des authentifizierten Nutzers abrufen
RAMP_LIST_REIMBURSEMENTS	Rückerstattungen mit Filterung auflisten
RAMP_GET_REIMBURSEMENT	Details einer bestimmten Rückerstattung abrufen
RAMP_LIST_USERS	Organisationsnutzer auflisten
RAMP_GET_CARD	Kartendetails abrufen
RAMP_FETCH_CUSTOM_ACCOUNTING_FIELD	Benutzerdefinierte Buchhaltungsfeldkonfiguration abrufen

---

Powered by Composio