Introdução
engineAPI: Motor fiscal SaaS para Software Houses. Emita NFe, NFCe e NFSe via API REST simples.
engineAPI
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 certificados, SOAP ou XML.
Documentos Suportados
| Documento | Modelo | Autorizado por | Status |
|---|---|---|---|
| NFe (Nota Fiscal Eletrônica) | 55 | SEFAZ Estadual | Disponível |
| NFCe (Nota Fiscal ao Consumidor) | 65 | SEFAZ Estadual | Disponível |
| CTe (Conhecimento de Transporte) | 57 | SEFAZ Estadual | 🗓 Roadmap |
| MDFe (Manifesto de Documentos Fiscais) | 58 | SEFAZ Estadual | 🗓 Roadmap |
| NFSe (Nota Fiscal de Serviços) | - | Prefeitura Municipal | Disponível |
| DFe (Distribuição de Documentos) | - | SEFAZ Nacional | 🗓 Roadmap |
Reforma Tributária: desde 03/08/2026, por obrigação federal (Ato Conjunto
RFB/CGIBS nº 4/2026), o IBS/CBS é obrigatório na regra geral de NF-e e NFC-e: a
engineAPI já emite. A NFS-e tem prazo próprio (01/10/2026) e já aceita o bloco
ibsCbs na DPS, ainda sem emissão exercitada contra a SEFIN
(issue #465). Datas
por documento, alíquotas de teste e o mecanismo de alíquotas até 2033 estão em
Reforma Tributária: datas que importam.
Modelo B2B2B
graph TD
A["engineAPI<br/>Plataforma Fiscal"] --> B["Partner<br/>Software House / Integrador"]
B --> C1["Issuer A<br/>CNPJ: 11.222.333/0001-44"]
B --> C2["Issuer B<br/>CNPJ: 55.666.777/0001-88"]
C1 --> D1["NFe"]
C1 --> D2["NFCe / NFSe"]
C2 --> D3["NFe / NFSe"]
O Partner é a Software House que integra a engineAPI em seu produto. Cada parceiro gerencia seus próprios Issuers (CNPJs emissores) de forma totalmente isolada.
Autenticação
A engineAPI suporta dois métodos de autenticação:
Fluxo de Emissão
Cadastrar empresa emissora
POST /v1/companies com CNPJ e dados cadastrais. Todo emissor nasce em homologação.
Fazer upload do certificado digital
POST /v1/companies/{issuerId}/certificate com o arquivo .pfx (campo file) e a senha.
Emitir o documento
POST /v1/nfe (ou /v1/nfce, /v1/nfse) com os dados da operação.
Receber a resposta
A API retorna { data: { id, status: "AUTHORIZED", accessKey, protocol, downloads, ... }, meta }: ver Primeira Emissão.
Receber webhook (opcional)
Configure PATCH /v1/webhooks/config para receber eventos em tempo real na sua URL.
Base URLs
| Ambiente | URL |
|---|---|
| Produção | https://api.engineapi.com.br |
| Dashboard | https://app.engineapi.com.br |
| Docs | https://docs.engineapi.com.br |