Resposta rápida: para que serve a eNotas API?
Seu sistema envia os dados da empresa, cliente e serviço ao eNotas Gateway. O Gateway processa a emissão com o órgão responsável e devolve identificadores e status para consulta ou notificação por webhook.
Existem duas necessidades diferentes. Se você quer enviar vendas da sua loja ou aplicativo próprio para o eNotas Emissor, consulte a API de Vendas: a documentação oficial exige plano Business ou Enterprise e implementação por desenvolvedor. Se seu ERP ou SaaS precisa oferecer emissão fiscal dentro do próprio produto, avalie o Gateway e sua documentação técnica específica.
O Gateway não decide CNAE, código do serviço, alíquota ou tratamento tributário. Esses dados precisam ser definidos pela empresa e sua contabilidade antes da integração entrar em produção.
eNotas API, Gateway e Emissor: qual é a diferença?
| Solução | Indicada para | Forma de uso |
|---|---|---|
| API de Vendas do Emissor | Empresa com loja ou aplicativo próprio que precisa enviar vendas ao Emissor. | Disponível nos planos Business e Enterprise; requer desenvolvedor e documentação da conta. |
| eNotas Gateway | ERP, SaaS, marketplace e software house que incorporam emissão ao produto. | Integração fiscal conforme a documentação e contratação próprias do Gateway. |
| Emissor com integração nativa | Empresa que vende por uma plataforma já compatível. | Painel visual e conexão com os canais suportados, sem criar integração própria. |
Como funciona a emissão de NFS-e via API?
Obtenha o acesso
Contrate o produto adequado, gere a credencial e mantenha a API key apenas no servidor.
Cadastre a emissora
Envie CNPJ, inscrição municipal, regime e demais dados exigidos para a empresa emissora.
Aguarde liberação
O cadastro pode depender de homologação e compatibilidade com o município.
Solicite a emissão
Envie um identificador externo, dados do tomador, serviço e valor da operação.
Acompanhe o status
Consulte pelo identificador ou receba notificações no webhook configurado.
Entregue os arquivos
Após autorização, disponibilize PDF, XML ou link ao usuário conforme o retorno.
O que a API permite fazer?
Os recursos variam conforme a versão e o tipo de documento. Para NFS-e, a documentação oficial apresenta o fluxo abaixo.
| Operação | Uso no produto | Cuidado |
|---|---|---|
| Cadastrar empresa | Ativar um CNPJ emissor dentro do sistema. | Campos e homologação podem variar por município. |
| Emitir NFS-e | Transformar uma venda ou cobrança em solicitação fiscal. | Evite duplicidade usando um id externo estável. |
| Consultar nota | Exibir status, número e motivo de rejeição. | Não trate o recebimento inicial como autorização final. |
| Cancelar | Solicitar cancelamento de documento autorizado. | Prazo e autorização dependem do órgão emissor. |
| Baixar PDF/XML | Entregar o documento ao cliente e à contabilidade. | O XML depende da disponibilidade no padrão utilizado. |
Boas práticas para integrar sem perder notas
- Guarde a API key somente no back-end e nunca dentro do navegador ou aplicativo público.
- Use id externo idempotente para impedir que a mesma venda gere duas notas.
- Persista o identificador retornado pelo Gateway para consultas posteriores.
- Valide a assinatura e a origem dos webhooks antes de atualizar o status interno.
- Prepare retentativas com limite e registre respostas para auditoria.
- Separe ambiente de teste e produção quando a versão utilizada oferecer essa opção.
- Monitore estados intermediários, rejeições e cancelamentos negados.
- Não registre certificados, documentos pessoais ou chaves completas em logs abertos.
Você realmente precisa do Gateway?
Quer emitir automaticamente sem construir uma API?
Conheça o eNotas Emissor pela oferta da Hotmart. Para projetos de Gateway e revenda, confirme contratação e condições diretamente nos canais oficiais da API.
Conhecer o eNotas Emissor Link de afiliado. A oferta pode não incluir o produto Gateway; confirme o produto antes de contratar.Perguntas frequentes sobre eNotas API e Gateway
O que é a eNotas API?
O nome pode se referir a integrações diferentes. A API de Vendas do Emissor envia vendas ao eNotas e requer plano Business ou Enterprise. O Gateway atende sistemas que incorporam a emissão fiscal ao próprio produto.
Qual é a diferença entre eNotas Gateway e eNotas Emissor?
O Gateway é voltado a ERPs, SaaS e outros sistemas que oferecem emissão aos usuários. O Emissor oferece painel e integrações prontas; sua API de Vendas conecta lojas ou aplicativos próprios nos planos elegíveis.
A API do eNotas emite NFS-e?
Sim. A documentação oficial apresenta uma API v1 para NFS-e, com endpoints de emissão, consulta, cancelamento e download de PDF ou XML.
A emissão pela API é síncrona?
Não. O processamento fiscal é assíncrono. O sistema acompanha o status por consulta ou webhook até chegar a um estado final.
Preciso da API se vendo pela Hotmart ou Kiwify?
Normalmente não. Para canais já integrados, o eNotas Emissor pode receber as vendas e automatizar as notas sem desenvolvimento próprio.
Continue a pesquisa
Integrações eNotas
Confira os canais de venda e meios de pagamento presentes na lista oficial.
Funcionalidades do Emissor
Veja o que a solução pronta oferece sem uma integração desenvolvida do zero.
eNotas vale a pena?
Compare critérios antes de decidir entre sistema pronto, ERP e API.
Planos do eNotas
Consulte limites, elegibilidade e condições comerciais atuais.