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 | Disponível |
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 |