ComposioHQ/Ramp-Automation

Automação Ramp

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

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

---

Configuração

Esta skill requer o servidor MCP Rube 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 via RUBE_MANAGE_CONNECTIONS.

---

Fluxos de Trabalho Principais

1. Listar Todas as Transações

Recupere todas as transações de cartão corporativo com opções abrangentes de filtragem.

Ferramenta: RAMP_GET_ALL_TRANSACTIONS

Parâmetros Principais:

• from_date -- Transações após esta data (datetime ISO 8601)
• to_date -- Transações antes desta data (datetime 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 empresarial
• min_amount / max_amount -- Filtro de faixa 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 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 ERP
• requires_memo -- true para transações sem memorandos obrigatórios
• include_merchant_data -- true para incluir dados completos de 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. Pesquisar Transações

Pesquise 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 pesquisa 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 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 empresarial
• from_date / to_date -- Intervalo de datas para data de criação
• from_submitted_at / to_submitted_at -- Intervalo de datas para data de submissão
• 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 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 pessoal de transações.

Ferramentas:

• RAMP_LIST_USERS -- Listar usuários com filtragem por departamento, função, localização, entidade
• RAMP_GET_MY_TRANSACTIONS -- Obter transações do usuário autenticado

Parâmetros Principais para RAMP_LIST_USERS:

• department_id -- Filtrar por UUID do departamento
• role -- Filtrar por função do usuário
• email -- Filtrar por endereço de e-mail
• employee_id -- Filtrar por ID do funcionário
• entity_id -- Filtrar por UUID da entidade empresarial
• location_id -- Filtrar por UUID da localização
• page_size -- Resultados por página (2--100, padrão: 20)

Exemplo:

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

---

6. Visualizar Detalhes do Cartão e Campos Contábeis

Recupere informações do cartão e configurações de campos contábeis personalizados.

Ferramentas:

• RAMP_GET_CARD -- Obter informações detalhadas do cartão (limites de gastos, titular, status de entrega)
• RAMP_FETCH_CUSTOM_ACCOUNTING_FIELD -- Buscar definições de campos contábeis personalizados

---

Armadilhas Conhecidas

Armadilha	Detalhe
Paginação necessária	Todos os endpoints de listagem retornam resultados paginados. Use o parâmetro start com o ID da última entidade da página anterior para iterar.
Formato de data	Todos os parâmetros de data devem estar no formato datetime ISO 8601 (ex.: "2026-02-11T00:00:00Z"). Strings de data simples falharão.
Prioridade do sync_status	Quando sync_status está definido, ele substitui ambos os parâmetros has_no_sync_commits e sync_ready.
Filtros de valor em USD	min_amount e max_amount estão em USD. Garanta o contexto correto de moeda ao filtrar.
state=ALL para recusadas	Por padrão, transações recusadas são excluídas. Defina state: "ALL" para incluí-las nos resultados.
Limites do page_size	Deve estar entre 2 e 100. O padrão é 20. Valores fora deste intervalo causam erros.

---

Referência Rápida

Slug da Ferramenta	Descrição
RAMP_GET_ALL_TRANSACTIONS	Listar todas as transações com filtragem
RAMP_SEARCH_TRANSACTIONS	Pesquisar transações por consulta de texto
RAMP_GET_TRANSACTION	Obter detalhes de uma transação específica
RAMP_GET_MY_TRANSACTIONS	Obter transações do usuário autenticado
RAMP_LIST_REIMBURSEMENTS	Listar reembolsos com filtragem
RAMP_GET_REIMBURSEMENT	Obter detalhes de um reembolso específico
RAMP_LIST_USERS	Listar usuários da organização
RAMP_GET_CARD	Obter detalhes do cartão
RAMP_FETCH_CUSTOM_ACCOUNTING_FIELD	Buscar configuração de campo contábil personalizado

---

Desenvolvido por Composio