Diferenças principais
Mapeamento de endpoints
Mapeamento de campos
Emitente
Destinatário
Item
O payload de NF-e usa o arrayitems (mínimo 1 item).
Diferenças importantes
Autenticação mudou
Autenticação mudou
O eNotas usa API Key no header
Authorization. A engineAPI usa API Key no header x-api-key para integrações server-to-server (o caso comum de software house); JWT Bearer (via login) é o fluxo do dashboard. Não misture os dois formatos.issuerId vai no body, não na URL
issuerId vai no body, não na URL
No eNotas, a empresa vai na URL (
/empresas/{id}/nfes). Na engineAPI, o issuerId é um campo dentro do body do JSON, opcional com um único emissor, obrigatório a partir do segundo.Webhooks em vez de callbacks
Webhooks em vez de callbacks
O eNotas usa callbacks por polling ou por URL de callback. A engineAPI usa webhooks com payload padronizado e verificação HMAC. Configure em
PATCH /v1/webhooks/config.Resposta de emissão diferente
Resposta de emissão diferente
O eNotas retorna
ref como identificador. A engineAPI retorna id (UUID) e accessKey (chave de acesso de 44 dígitos) diretamente.Checklist de migração
1
Criar conta na engineAPI
Registre-se em app.engineapi.com.br.
2
Cadastrar empresas emissoras
POST /v1/companies para cada CNPJ que emite notas.3
Fazer upload dos certificados
POST /v1/companies/{issuerId}/certificate com o .pfx de cada empresa.4
Testar em homologação
Todo emissor novo já nasce em homologação (
ambienteFiscal: 2). Emita notas de teste sem precisar configurar nada.5
Adaptar a integração
Ajuste os campos do payload conforme a tabela de mapeamento acima.
6
Configurar webhooks
PATCH /v1/webhooks/config com os eventos que precisa receber.7
Migrar para produção
Promover o emissor para produção é self-service, ver Sandbox.
Próximos passos
- Autenticação: JWT e API Keys explicados.
- Webhooks: configurar notificações em tempo real.