enotas
title: Migrar do eNotas description: Guia completo de migração do eNotas para Engine API: mapeamento de endpoints, campos e checklist de zero downtime.
Migrar do eNotas
Migre do eNotas para a Engine API mantendo sua operação ativa. A Engine API é compatível com os mesmos conceitos. A diferença está na estrutura de payload e autenticação.
Tempo estimado de migração: 2–4 horas de desenvolvimento
Diferenças Principais
| Aspecto | eNotas | Engine API |
|---------|--------|-----------|
| Autenticação | Authorization: ApiKey {key} | Authorization: Bearer {jwt} ou x-api-key: {key} |
| Multi-tenancy | Empresa no URL | issuerId no body |
| Notificações | Callbacks por request | Webhooks configuráveis |
| Formato de resposta | Próprio | JSON padronizado |
| Ambiente | Header X-Ambiente | Campo environment na empresa |
Mapeamento de Endpoints
| eNotas | Engine API | Notas |
|--------|-----------|-------|
| POST /empresas/{id}/nfes | POST /nfe/emitir | issuerId vai no body |
| GET /empresas/{id}/nfes/{nfeId} | GET /nfe/{id} | — |
| GET /empresas/{id}/nfes | GET /nfe | — |
| POST /empresas/{id}/nfes/{nfeId}/cancelar | POST /nfe/{id}/cancelar | — |
| POST /empresas/{id}/nfes/{nfeId}/carta-correcao | POST /nfe/{id}/carta-correcao | — |
| GET /empresas/{id}/nfes/{nfeId}/xml | GET /nfe/{id}/xml | — |
| GET /empresas/{id}/nfes/{nfeId}/pdf | GET /nfe/{id}/pdf | — |
| POST /empresas | POST /companies | — |
| POST /empresas/{id}/certificado | POST /companies/{id}/certificate | Multipart/form-data |
Mapeamento de Campos
Emitente
| Campo eNotas | Campo Engine API | Notas |
|-------------|-----------------|-------|
| empresa_id (URL) | issuerId (body) | UUID retornado em POST /companies |
Destinatário
| Campo eNotas | Campo Engine API | Notas |
|-------------|-----------------|-------|
| cnpj_cpf | cnpj ou cpf | Campos separados na Engine API |
| razao_social | nome | — |
| indicador_inscricao_estadual | indicadorIE | 1, 2 ou 9 |
| endereco.codigo_municipio | endereco.codigoMunicipio | Mesmo código IBGE |
Item
| Campo eNotas | Campo Engine API | Notas |
|-------------|-----------------|-------|
| item_numero | numero | — |
| codigo_produto | codigo | — |
| descricao | descricao | — |
| codigo_ncm | ncm | — |
| cfop | cfop | — |
| unidade_comercial | unidade | — |
| quantidade_comercial | quantidade | — |
| valor_unitario_comercial | valorUnitario | — |
| valor_total_bruto | valorTotal | — |
Diferenças importantes
Checklist de Migração
Criar conta na Engine API
Registre-se em app.engineapi.com.br.
Cadastrar empresas emissoras
POST /companies para cada CNPJ que emite notas.
Fazer upload dos certificados
POST /companies/{issuerId}/certificate com o .pfx de cada empresa.
Testar em homologação
Configure environment: 2 nas empresas e emita notas de teste.
Adaptar a integração
Ajuste os campos do payload conforme a tabela de mapeamento acima.
Configurar webhooks
POST /webhooks com os eventos que precisa receber.
Migrar para produção
Mude environment: 1 nas empresas e aponte sua aplicação para a Engine API.