Skip to main content

Engine API

Motor fiscal B2B2B que permite Software Houses integrar emissão de documentos fiscais eletrônicos em suas plataformas via API REST — sem precisar lidar com ACBr, certificados, SOAP ou XML.

Zero infraestrutura fiscal

Sem ACBr, sem Xvfb, sem SOAP. Você envia JSON, nós cuidamos de tudo.

Multitenancy nativo

Gerencie múltiplos CNPJs por parceiro com isolamento completo de dados.

Produção em minutos

Da conta criada à primeira nota autorizada em menos de 10 minutos.

AI-Ready

Qualquer agente de IA — Claude, ChatGPT, Copilot — integra em minutos via llms.txt.

Arquitetura

Diagrama de arquitetura da Engine API — fluxo de parceiros, módulos fiscais, SEFAZ e banco

Documentos Suportados

DocumentoModeloAutorizado porStatus
NFe — Nota Fiscal Eletrônica55SEFAZ EstadualDisponível
NFCe — Nota Fiscal ao Consumidor65SEFAZ EstadualDisponível
CTe — Conhecimento de Transporte57SEFAZ EstadualDisponível
MDFe — Manifesto de Documentos Fiscais58SEFAZ EstadualDisponível
NFSe — Nota Fiscal de ServiçosPrefeitura MunicipalDisponível
BoletoBanco (Sicoob)Disponível
DFe — Distribuição de DocumentosSEFAZ NacionalDisponível

Modelo B2B2B

Jotta Co. (SuperAdmin)
    └── Partner (Software House)
            └── Issuer (Empresa / CNPJ)
                    └── Invoice (NFe, CTe, MDFe, NFSe, Boleto...)
O Partner é a Software House que integra a Engine API em seu produto. Cada parceiro gerencia seus próprios Issuers (CNPJs emissores) de forma totalmente isolada.

Autenticação

A Engine API suporta dois métodos de autenticação:

Bearer JWT

Para sessões de usuário no Dashboard. Obtido via POST /auth/login.

API Key

Para integrações de longa duração. Gerada no Dashboard e enviada via x-api-key.

Fluxo de Emissão

1

Cadastrar empresa emissora

POST /companies com CNPJ, regime tributário e ambiente (produção ou homologação).
2

Fazer upload do certificado digital

POST /companies/{issuerId}/certificate com o arquivo .pfx e a senha.
3

Emitir o documento

POST /nfe/emitir (ou /cte, /mdfe, /nfse, /nfce, /boleto/boletos) com os dados da operação.
4

Receber a resposta

A API retorna status: AUTHORIZED, accessKey (44 dígitos) e URLs para XML e PDF.
5

Receber webhook (opcional)

Configure POST /webhooks para receber eventos em tempo real na sua URL.

Base URLs

AmbienteURL
Produçãohttps://api.engineapi.com.br
Staginghttps://api.staging.engineapi.com.br
Dashboardhttps://app.engineapi.com.br
Docshttps://docs.engineapi.com.br

Próximos passos

Quickstart

Da conta à primeira nota em 5 minutos

Autenticação

JWT e API Keys explicados

Primeira emissão

Guia completo com exemplos reais

SDKs

TypeScript, Python e PHP