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.
A documentação atual descreve a API v1 de NFS-e como REST, com JSON como formato principal e API key para autenticação. Existem operações para cadastrar empresa emissora, solicitar emissão, consultar status, cancelar e recuperar PDF ou XML quando disponíveis.
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 |
|---|---|---|
| eNotas Gateway | ERP, SaaS, marketplace, software house e sistema interno. | Integração por API para incorporar emissão fiscal ao próprio produto. |
| eNotas API | É o meio técnico usado para conversar com o Gateway. | Requisições REST, autenticação, endpoints, consultas e webhooks. |
| eNotas Emissor | Empresa que vende online e quer uma solução pronta. | Painel visual e integrações com Hotmart, Kiwify, Stripe e outros canais. |
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?
É a API REST do eNotas Gateway para integrar sistemas próprios à emissão e gestão de documentos fiscais. A comunicação principal usa JSON e autenticação por API key.
Qual é a diferença entre eNotas Gateway e eNotas Emissor?
O Gateway é voltado a ERPs, SaaS, marketplaces e sistemas internos. O Emissor oferece uma interface pronta e integrações com plataformas de venda para empresas que não querem desenvolver o fluxo fiscal.
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.