Crie o token
Solicite a chave sandbox e configure escopos por recurso, como despesas, colaboradores, centros de custo e webhooks.
terminal
API para desenvolvedores
Integre despesas, reembolsos e aprovações ao seu stack
Use endpoints REST, webhooks HTTPS e payloads JSON para conectar o ReciGo ao seu ERP, CRM, BI ou sistema financeiro sem redigitação manual.
- Formato
- JSON
- Auth
- Bearer token
- Eventos
- Webhooks HTTPS
{
"data": [{
"id": "des_8f2a1b9c",
"status": "aprovado",
"valor": 189.50,
"moeda": "BRL",
"colaborador": {
"id": "usr_1042",
"cpf": "12345678900"
},
"centro_custo": "CC-MKT-01",
"comprovante_url": "https://cdn.recigo..."
}],
"next_cursor": "eyJwYWdlIjoyfQ"
}
sync_alt
Sincronização bidirecional
Importe cadastros e exporte despesas aprovadas para o financeiro.
verified_user
Ambientes separados
Use sandbox para validar integrações antes de liberar produção.
notifications_active
Eventos em tempo real
Receba notificações quando relatórios forem aprovados ou pagos.
bolt
QUICKSTART
Da primeira chamada ao fluxo homologado
Um caminho direto para times que precisam integrar o ReciGo a ERPs, CRMs, bases internas ou rotinas de contas a pagar.
Teste as rotas
Valide autenticação, paginação, filtros e tratamento de erros antes de conectar o fluxo real da empresa.
Assine eventos
Cadastre URLs HTTPS para receber aprovações, pagamentos e mudanças cadastrais assim que acontecerem.
Publique em produção
Após homologação, a integração passa a operar com monitoramento, retentativas e trilhas de auditoria.
code
EXEMPLOS
Copie a chamada e adapte ao seu serviço.
Os exemplos usam o mesmo endpoint de consulta de despesas aprovadas. Troque o token e combine filtros de status, período, colaborador ou centro de custo conforme o seu processo.
curl --request GET \
--url "https://api.recigo.com.br/v1/despesas?status=aprovado" \
--header "Authorization: Bearer RECIGO_API_KEY" \
--header "Accept: application/json"const response = await fetch(
"https://api.recigo.com.br/v1/despesas?status=aprovado",
{
headers: {
Authorization: `Bearer ${process.env.RECIGO_API_KEY}`,
Accept: "application/json"
}
}
);
const despesas = await response.json();import os
import requests
response = requests.get(
"https://api.recigo.com.br/v1/despesas",
params={"status": "aprovado"},
headers={
"Authorization": f"Bearer {os.environ['RECIGO_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
despesas = response.json()
account_tree
REFERÊNCIA
Endpoints mais usados em integrações
Rotas pensadas para conciliar cadastros, aprovações e pagamentos com os sistemas que sua empresa já usa.
GET
/v1/despesas
Lista despesas e relatórios por status, período, centro de custo ou colaborador.
- Paginação por cursor
- Filtros por data de aprovação
- Links de comprovantes anexados
POST
/v1/colaboradores
Cria ou atualiza usuários do aplicativo a partir do cadastro oficial da empresa.
- Controle de permissões
- Vínculo com centro de custo
- Status ativo ou bloqueado
POST
/v1/centros-custo
Sincroniza estruturas contábeis para classificar despesas no momento do lançamento.
- Códigos externos do ERP
- Hierarquia por filial ou projeto
- Validação antes do reembolso
GET
/v1/relatorios/{id}
Consulta o detalhe consolidado de um relatório aprovado, incluindo despesas e aprovações.
- Histórico de aprovação
- Total por categoria
- Dados para contas a pagar
webhook
WEBHOOKS
Eventos para automatizar o backoffice
Cadastre uma URL HTTPS e receba payloads assinados quando um evento relevante ocorrer. Seu serviço pode provisionar pagamentos, atualizar status no ERP ou alimentar um data warehouse.
relatorio.aprovado
Disparado quando o gestor aprova um relatório completo.
reembolso.pago
Disparado quando o financeiro marca o reembolso como liquidado.
colaborador.atualizado
Disparado quando permissões, status ou dados cadastrais mudam.
shield_lock
SEGURANÇA
Projetado para operar em ambiente corporativo
Controle acesso por escopo, mantenha ambientes separados e trate falhas de integração com respostas previsíveis.
key
Tokens por ambiente
Separe sandbox e produção e rotacione chaves sem interromper toda a integração.
policy
Escopos de permissão
Conceda acesso apenas aos recursos que cada serviço realmente precisa consumir.
history
Auditoria de chamadas
Rastreie chamadas, eventos e respostas para facilitar suporte técnico e conciliação.
error
Erros padronizados
Respostas HTTP e mensagens estruturadas simplificam retry, logs e alertas.
Precisa integrar o ReciGo ao seu sistema?
Solicite acesso sandbox e receba as credenciais para validar endpoints, webhooks e payloads com seu time técnico.
Solicitar acesso sandbox