API RESTful completa para emissão, consulta e gerenciamento de Notas Fiscais de Serviços Eletrônicas (NFS-e) integrada ao Sistema Nacional, com assinatura digital, geração de DANFS-e e gestão de eventos.
Tudo que você precisa para integrar seu sistema com a emissão de NFS-e nacional
Emita notas fiscais de serviço de forma automatizada com validação completa e assinatura digital.
Consulte notas por chave de acesso, número, período ou CNPJ do prestador/tomador.
Cancele notas fiscais dentro do prazo legal com registro automático de eventos.
Substitua notas fiscais mantendo o histórico completo de alterações.
Gere o Documento Auxiliar da NFS-e em formato PDF com layout oficial.
Acesse o XML completo da nota com assinatura digital para arquivamento.
Envie múltiplas DPS em lote para processamento assíncrono.
Acompanhe todos os eventos relacionados às notas fiscais em tempo real.
Escolha a forma que preferir para explorar nossa API
Interface interativa para explorar e testar todos os endpoints da API em tempo real.
Especificação OpenAPI 3.0 para importar em ferramentas como Postman, Insomnia ou gerar SDKs.
Manual completo com exemplos práticos, fluxos de integração e boas práticas.
Acesse o painel para gerenciar contribuintes, certificados digitais, usuários e emissões de NFS-e.
Visão geral dos endpoints disponíveis na API
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /api/auth/login | Autenticação do usuário e obtenção do token Sanctum |
| POST | /api/auth/register | Cadastro de novo usuário (sujeito a aprovação) |
| GET | /api/empresa | Dados da empresa autenticada via API Token |
| GET | /api/nfse | Listagem de NFS-e da empresa |
| POST | /api/nfse | Emissão de NFS-e individual |
| POST | /api/nfse/lote | Emissão de NFS-e em lote |
| GET | /api/nfse/estatisticas | Estatísticas de emissão da empresa |
| GET | /api/nfse/{chaveAcesso} | Consulta de NFS-e por chave de acesso |
| GET | /api/nfse/{chaveAcesso}/xml | Download do XML assinado |
| GET | /api/danfse/{chaveAcesso} | Download do DANFS-e em PDF (público) |
| POST | /api/nfse/{chaveAcesso}/cancelar | Cancelamento de NFS-e |
| POST | /api/nfse/{chaveAcesso}/substituir | Substituição de NFS-e |
| GET | /api/nfse/{chaveAcesso}/eventos | Listagem de eventos vinculados à NFS-e |
| POST | /api/nfse/{chaveAcesso}/eventos | Registro de evento na NFS-e |
| GET | /api/DFe/{ultimoNSU} | Distribuição de DF-e a partir do último NSU |
| GET | /api/lotes | Listagem de lotes processados |
| GET | /api/lotes/{id} | Consulta de status e XML do lote |
| GET | /api/parametros_municipais/{codigoMunicipio} | Parâmetros municipais (alíquotas, regimes, retenções) |
| GET | /api/municipios/conveniados | Listagem de municípios conveniados ao Sistema Nacional |
| GET | /api/health | Health check da API |
A Notas Nacional utiliza dois modelos de autenticação: API Token por empresa (Bearer) para integrações de sistemas e Sanctum para o painel administrativo.
Crie sua conta e aguarde a aprovação por um administrador.
Inclua o CNPJ da empresa, faça upload do certificado digital A1 e gere o API Token.
Envie o token no header Authorization: Bearer nfse_{id}_{hash} ou em X-Api-Token.
// 1. Use o API Token gerado para a empresa no painel
GET /api/empresa
Authorization: Bearer nfse_{id}_{hash}
// Resposta:
{
"sucesso": true,
"dados": {
"id": 1,
"documento": "00000000000000",
"razao_social": "Empresa Exemplo LTDA",
"ambiente": "homologacao"
}
}
// 2. Emissão de NFS-e
POST /api/nfse
Authorization: Bearer nfse_{id}_{hash}
Content-Type: application/jsonEstamos aqui para ajudar você na integração