API da Snabber para ERPs: como conectar suas finanças a qualquer sistema
Se a sua empresa (ou você) já perdeu tempo exportando extratos em CSV para importar num ERP, ou copiando saldo de conta e fatura de cartão manualmente numa planilha, esse problema agora tem solução: a API da Snabber permite conectar seus dados financeiros — contas, transações, faturas de cartão e categorias — a qualquer ERP, ferramenta interna ou automação, via uma API REST simples e segura. Neste post você entende o que a API oferece, como autenticar, quais endpoints existem e como começar a integrar hoje mesmo.
O que é a API da Snabber
A API da Snabber é uma API REST pública, somente leitura, que dá acesso programático aos seus próprios dados financeiros dentro da plataforma: contas bancárias, cartões de crédito, investimentos, transações e agregações por categoria, conta ou mês. Ela foi pensada para dois públicos:
- Times de produto/TI que querem levar dados da Snabber para dentro de um ERP, BI ou sistema interno (Omie, Bling, Conta Azul, SAP, planilhas, data warehouse — qualquer sistema que fale HTTP).
- Usuários avançados e assistentes de IA, através de um servidor MCP (Model Context Protocol) nativo, que conecta a Snabber diretamente a clientes como Claude.
Importante: por ser somente leitura, nenhuma chamada via API ou MCP cria, edita ou apaga dados na sua conta — o que torna a integração segura para conectar a sistemas de terceiros sem risco de corromper seu histórico financeiro.
Dois jeitos de integrar: API REST e MCP
API REST v1
Endpoints HTTP tradicionais, ideais para integrar com ERPs, scripts de automação (n8n, Zapier, Make) ou o backend do seu próprio sistema:
| Endpoint | O que faz |
|---|---|
GET /api/v1/accounts |
Lista contas (banco, cartão de crédito, investimento) com saldo, limite e datas de fechamento/vencimento. |
GET /api/v1/transactions |
Lista transações com filtros por período, categoria, conta e tipo (receita/despesa), com paginação por cursor. |
GET /api/v1/transactions/aggregate |
Agrega transações por categoria, conta, mês ou descrição — perfeito para dashboards e relatórios em ERPs. |
MCP (Model Context Protocol)
Além da API REST, a Snabber expõe um servidor MCP remoto com as mesmas informações, mas em formato de "ferramentas" que assistentes de IA conseguem chamar diretamente durante uma conversa. As tools disponíveis são:
list_accounts— lista contas e saldoslist_transactions— lista transações com filtrosaggregate_transactions— agrega gastos e receitas por período/categoriaget_credit_card_invoice— consulta a fatura de um cartão de crédito específico
Isso significa que você pode, por exemplo, perguntar ao Claude "quanto gastei em Alimentação nos últimos 3 meses?" e ele consulta a Snabber em tempo real para responder — sem exportar nada manualmente.
Como autenticar: chaves de API
A autenticação é feita por chave de API (formato snb_live_...), gerada na página de Integrações da sua conta. Cada chave fica vinculada a um único workspace, então é possível ter chaves diferentes para empresas ou carteiras diferentes.
O envio é feito no header HTTP padrão Authorization:
curl https://app.snabber.com.br/api/v1/transactions?from=2026-01-01&to=2026-01-31 \
-H "Authorization: Bearer snb_live_xxxxxxxxxxxxxxxx"
Resposta (exemplo simplificado):
{
"data": [
{
"id": "txn_123",
"description": "Fornecedor XPTO",
"amount": -1250.00,
"type": "expense",
"category": "Fornecedores",
"date": "2026-01-14"
}
],
"pagination": { "next_cursor": "eyJ..." },
"meta": { "workspace_id": "wsp_abc" }
}
Casos de uso: por que conectar a Snabber ao seu ERP
- Conciliação automática: em vez de exportar CSV toda semana, seu ERP puxa transações e saldos direto via API, sempre atualizados.
- Relatórios centralizados: use
/transactions/aggregatepara alimentar dashboards de BI (Power BI, Looker, Metabase) sem depender de exportação manual. - Automação com n8n/Make/Zapier: monte fluxos que leem transações novas na Snabber e criam lançamentos, alertas ou notificações em outros sistemas.
- Fechamento de fatura de cartão: puxe programaticamente o valor da fatura do período via MCP, sem entrar no app.
- Assistentes financeiros com IA: conecte o MCP da Snabber ao Claude ou outro cliente compatível e converse com seus próprios dados financeiros em linguagem natural.
Limites de uso (rate limits)
Os limites variam por plano, com headers padrão (X-RateLimit-Limit, X-RateLimit-Remaining) em toda resposta:
| Plano | Requisições/minuto | Requisições/dia |
|---|---|---|
| Basic | 30 | 2.000 |
| Earlybird / Plus | 60 | 5.000 |
| Pro | 120 | 10.000 |
| Master | 240 | 20.000 |
Como começar em 3 passos
- Acesse Integrações na sua conta Snabber.
- Gere uma chave de API para o workspace desejado.
- Use a chave no header
Authorization: Bearerdas suas requisições, ou configure o endpoint MCP no seu cliente de IA preferido.
A documentação técnica completa, com todos os parâmetros e exemplos, está disponível em /developers.
Perguntas frequentes
A API da Snabber tem integração pronta com meu ERP (Omie, Bling, Conta Azul)?
A API é uma API REST aberta e padrão — ela não é uma integração nativa pré-construída para um ERP específico, mas qualquer sistema capaz de fazer requisições HTTP (incluindo Omie, Bling, Conta Azul, SAP ou um ERP próprio) pode se conectar a ela ou ser conectado via uma automação intermediária (n8n, Make, Zapier).
A API consegue alterar ou apagar dados na minha conta?
Não. Todos os endpoints e ferramentas MCP são somente leitura — servem para consultar contas, transações e faturas, nunca para criar, editar ou excluir informações.
Preciso de plano pago para usar a API?
Sim, o acesso à API e ao MCP é um recurso disponível a partir dos planos pagos da Snabber. No plano gratuito, a geração de chaves fica bloqueada até o upgrade.
O que é o MCP e por que ele importa?
MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA, como o Claude, consultem sistemas externos em tempo real durante uma conversa. Com o MCP da Snabber, você pode perguntar sobre seus gastos, saldo ou fatura diretamente para um assistente de IA, sem abrir o app.
Pronto para conectar a Snabber ao seu ERP ou automação? Acesse Integrações e gere sua primeira chave de API.
