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.
Conhecimento de Transporte Eletrônico (modelo 57/67) integrado direto à SEFAZ: status do serviço, consulta e cancelamento, com arquitetura isolada e pronta para emissão.
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 |
| POST | /api/cte | Emissão de CT-e (modelo 57 rodoviário) |
| GET | /api/cte/status-servico | Status do serviço da SEFAZ para CT-e |
| GET | /api/cte/{chave} | Consulta de CT-e por chave de acesso |
| POST | /api/cte/{chave}/cancelar | Cancelamento de CT-e (evento 110111) |
| 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