API REST
Integração principal
ERP, backend, filas internas
POST /v1/emissions
OpenAPI, idempotência, webhooks `emission.updated`
Financeiro + TI · empresas no Brasil
MCP em construçãoNFS-e pronta para integrar — API, agentes e painel
Emita, consulte e automatize NFS-e com REST v1, webhooks confiáveis e MCP para agentes de IA. Multi-organização — o financeiro opera no painel; a TI automatiza pela API.
- API-first — OpenAPI, idempotência, API keys por organização
- MCP — ferramentas para agentes emitirem e consultarem notas (beta)
- Painel intuitivo — tomadores, emissões, substituição, PDF/XML
Escolha sua interface
Uma plataforma, uma organização — três formas de consumir: integração, agentes ou operação humana.
MCP
Agentes de IA
Cursor, copilots, automações conversacionais
create_emission · get_emission
Ferramentas tipadas sobre a mesma API v1
Painel
Operação humana
Financeiro, fiscal, administradores
Rascunho → fila → PDF/XML
Tomadores, emissões, substituição — sem código
Integração em minutos
Primeira nota em poucas chamadas HTTP. Fila assíncrona, retorno por webhook e consulta de status a qualquer momento.
OpenAPIAPI keysIdempotênciaWebhooksMulti-tenant
Fluxo
Seu sistema → API → fila → governo → webhook
POST /v1/emissions
curl -X POST https://api.exemplo.com/v1/emissions \
-H "Authorization: Bearer <apiKeyId>.<secret>" \
-H "Content-Type: application/json" \
-d '{
"idempotency_key": "pedido-2026-001",
"payload": {
"operation": "emit",
"valor_servico": 1500.00,
"descricao_servico": "Consultoria técnica",
"tomador": {
"cpf_cnpj": "12345678000199",
"razao_social_nome": "Cliente Exemplo Ltda"
}
}
}'Desafios que conhecemos bem
Quem vive NFS-e no dia a dia sabe: o problema não é só emitir — é manter tudo organizado, integrado e corrigir sem dor fiscal.
Notas espalhadas
Planilhas, e-mails e sistemas desconectados geram retrabalho e risco de inconsistência na rotina fiscal.
Correção fiscal complicada
Nota emitida com erro exige substituição oficial — não basta editar. Sem orientação, financeiro e TI perdem tempo no portal.
Vários CNPJs e filiais
Empresas com mais de um emissor precisam de visão única, controle por organização e cadastros reutilizáveis.
Integração manual demais
Financeiro e TI querem eventos confiáveis, API estável e webhooks — sem depender só de processo manual.
O que a plataforma entrega
Do cadastro à substituição fiscal — valor concreto para financeiro e contrato estável para TI.
Emissões
Fila assíncrona, rascunhos, agendamento e histórico claro por status.
Substituição fiscal
Corrija notas com substituição guiada e vínculo oficial entre origem e substituta.
Tomadores
Cadastro reutilizável (CPF/CNPJ, endereço) por organização — menos retrabalho.
Emissores
CNPJs autorizados a emitir, certificado A1 e gestão centralizada.
Webhook
Notifique ERP e cobrança quando a emissão concluir ou falhar.
API keys
Integrações servidor-a-servidor com REST v1, idempotência e rate limit por plano.
Painel quando precisar
Nem todo mundo quer código. O painel cobre cadastro, emissão guiada, substituição fiscal e download de documentos — enquanto a TI automatiza pela API.
Painel
Resumo da sessão, plano e acesso rápido às áreas principais.
Emissões
Lista e filtros por status: rascunho, fila, concluída, falha, substituída.
Tomadores
Formulário e tabela para manter clientes da nota organizados.
Integrações
Chaves para a API e webhook de eventos para o seu backend.
MCP para agentes de IA
Em construçãoEstamos desenvolvendo um servidor MCP para expor emissão, consulta e cancelamento a agentes de IA — Cursor, Claude Desktop e copilots customizados — usando as mesmas regras da API REST.
create_emission
Disparar emissão com idempotência
get_emission
Consultar status e metadados
list_emissions
Filtrar por status ou período
cancel_emission
Solicitar cancelamento fiscal
Autenticação prevista: API key da organização (mesmo formato da REST). Status: beta interno — documentação técnica em breve no repositório.
Como funciona
Três passos para colocar financeiro e TI na mesma base.
- 1
Sua organização
Acesso seguro com equipe e papéis (administrador / membro) via provedor de identidade.
- 2
Cadastros base
Emissores (CNPJ), tomadores e certificado alinhados ao que a NFS-e exige.
- 3
Integrar ou operar
Automatize com API ou MCP, ou use o painel — mesma base de dados, mesma organização.
Para desenvolvedores
Integre pela API
OpenAPI, chaves por organização, webhooks e fila assíncrona. Ideal para ERP, cobrança e middleware fiscal.
Para operação
Use o painel
Tomadores, emissões, substituição e PDF/XML sem escrever código. Mesma organização que a API consome.
Perguntas frequentes
- Preciso usar o painel?
- Não. API REST + webhook bastam para integrações completas. O painel é para quem prefere operação visual no financeiro.
- O que é MCP?
- Model Context Protocol — uma camada para agentes de IA (Cursor, copilots) usarem ferramentas tipadas sobre a mesma API: emitir, consultar emissões, listar tomadores.
- O MCP já está disponível?
- O servidor MCP está em construção (beta interno). A API REST v1 já é o contrato canônico; o MCP será uma camada fina sobre ela.
- Substitui meu ERP?
- Complementa. Integre emissão, consulta e webhooks via API enquanto o financeiro opera no painel quando necessário.
- Como corrigir uma nota já emitida?
- Pela substituição fiscal guiada — nova NFS-e com dados corrigidos e vínculo oficial com a nota de origem. Não é possível simplesmente editar a nota anterior.
- Onde ficam os meus dados?
- A arquitetura separa dados por organização (multi-tenant). Em produção, use ambiente seguro, backups e políticas da sua empresa.