Automação Ramp

Automatize operações financeiras corporativas da Ramp, incluindo recuperação de transações, gerenciamento de reembolsos, busca de despesas, visualização de detalhes de cartões e listagem de usuários para fluxos de trabalho de despesas e contabilidade.

Documentação do Toolkit: composio.dev/toolkits/ramp

Configuração

Esta habilidade requer o servidor Rube MCP conectado em https://rube.app/mcp.

Antes de executar qualquer ferramenta, certifique-se de que existe uma conexão ativa para o toolkit ramp. Se nenhuma conexão estiver ativa, inicie uma através de RUBE_MANAGE_CONNECTIONS.

Fluxos de Trabalho Principais

1. Listar Todas as Transações

Recupere todas as transações de cartões corporativos com opções abrangentes de filtragem.

Ferramenta: RAMP_GET_ALL_TRANSACTIONS

Parâmetros Principais:

• from_date -- Transações após esta data (data e hora ISO 8601)
• to_date -- Transações antes desta data (data e hora ISO 8601, padrão: hoje)
• user_id -- Filtrar por UUID do usuário
• card_id -- Filtrar por UUID do cartão físico
• department_id -- Filtrar por UUID do departamento
• merchant_id -- Filtrar por UUID do comerciante
• entity_id -- Filtrar por UUID da entidade comercial
• min_amount / max_amount -- Filtro de intervalo de valor (USD)
• state -- Estado da transação; defina como "ALL" para incluir transações recusadas
• approval_status -- Filtrar por status de aprovação
• sync_status -- Filtrar por status de sincronização com ERP (substitui sync_ready e has_no_sync_commits)
• has_no_sync_commits -- true para transações não sincronizadas
• sync_ready -- true para transações prontas para sincronizar com o ERP
• requires_memo -- true para transações com memorandos obrigatórios ausentes
• include_merchant_data -- true para incluir dados completos da compra do comerciante
• page_size -- Resultados por página (2--100, padrão: 20)
• start -- Cursor de paginação: ID da última entidade da página anterior
• order_by_date_desc / order_by_date_asc -- Ordenar por data
• order_by_amount_desc / order_by_amount_asc -- Ordenar por valor

Exemplo:

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. Buscar Transações

Busque transações por nome do comerciante, memorando ou outros detalhes da transação.

Ferramenta: RAMP_SEARCH_TRANSACTIONS

Parâmetros Principais:

• query (obrigatório) -- Texto de busca para nome do comerciante, memorando ou outros detalhes
• Todos os parâmetros de filtro de RAMP_GET_ALL_TRANSACTIONS também estão disponíveis

Exemplo:

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

3. Obter Detalhes da Transação

Recupere detalhes completos de uma transação específica, incluindo detalhes do comerciante, recibos, códigos contábeis e informações de disputa.

Ferramenta: RAMP_GET_TRANSACTION

Parâmetros Principais:

• transaction_id (obrigatório) -- ID da transação

Exemplo:

Tool: RAMP_GET_TRANSACTION
Arguments:
  transaction_id: "txn_abc123def456"

4. Gerenciar Reembolsos

Liste e recupere registros de reembolso para fluxos de trabalho de aprovação e análise de despesas.

Ferramentas:

• RAMP_LIST_REIMBURSEMENTS -- Listar reembolsos com filtragem
• RAMP_GET_REIMBURSEMENT -- Obter detalhes completos de um reembolso específico

Parâmetros Principais para RAMP_LIST_REIMBURSEMENTS:

• user_id -- Filtrar por UUID do funcionário
• entity_id -- Filtrar por UUID da entidade comercial
• from_date / to_date -- Intervalo de datas para data de criação
• from_submitted_at / to_submitted_at -- Intervalo de datas para data de envio
• from_transaction_date / to_transaction_date -- Intervalo de datas da transação subjacente
• awaiting_approval_by_user_id -- Filtrar por reembolsos pendentes de um aprovador específico
• sync_status -- Filtrar por status de sincronização com ERP
• has_no_sync_commits -- true para reembolsos não sincronizados
• sync_ready -- true para reembolsos prontos para sincronizar
• direction -- "BUSINESS_TO_USER" (padrão) ou "USER_TO_BUSINESS" (reembolsos)
• page_size -- Resultados por página (2--100, padrão: 20)
• start -- Cursor de paginação

Exemplo:

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

5. Listar Usuários e Obter Minhas Transações

Visualize usuários da organização e histórico de transações pessoais.

Ferramentas:

• RAMP_LIST_USERS -- Listar usuários com filtragem por departamento, cargo, localidade, entidade
• RAMP_GET_MY_TRANSACTIONS -- Obter transações para o usuário autenticado

Parâmetros Principais para RAMP_LIST_USERS:

…