← Voltar para o blog

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 saldos
  • list_transactions — lista transações com filtros
  • aggregate_transactions — agrega gastos e receitas por período/categoria
  • get_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/aggregate para 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
Basic302.000
Earlybird / Plus605.000
Pro12010.000
Master24020.000

Como começar em 3 passos

  1. Acesse Integrações na sua conta Snabber.
  2. Gere uma chave de API para o workspace desejado.
  3. Use a chave no header Authorization: Bearer das 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.