Pular para o conteúdo
Leiaute novo da NFS-e previsto para 01/12/2026. Clientes Go não precisam fazer nada. Ver o calendário
Go Soluções Testar grátis

API de NFS-e Nacional, sem a parte difícil.

Você envia um JSON. A gente assina com o certificado A1, numera sem falhas, conversa com o governo e reenvia quando ele cai.

Emitir é uma chamada.

A emissão é assíncrona: a API responde na hora com a nota "pendente", e você consulta até ela ficar "autorizada".

  • Sem nota duplicadaRepita a chamada com a mesma chave de idempotência e recebe a mesma resposta. Seguro em caso de tempo esgotado.
  • Erros em portuguêsCada recusa vem com código, mensagem e o campo com problema.
  • Leiaute do governo por nossa contaO formato da API não muda quando o governo troca o leiaute da nota.
curl -X POST https://SEU-ENDERECO/api/v1/nfse \
  -H "Authorization: Bearer gnf_SEU_TOKEN" \
  -H "Idempotency-Key: pedido-1042" \
  -H "Content-Type: application/json" \
  -d @nota.json

# 202 Accepted
{ "id": "01a15be7-…", "numero": 42, "status": "pendente" }

As rotas.

Base: https://SEU-ENDERECO/api/v1. Autenticação por token, um por empresa, que pode ser revogado. Limite de 120 chamadas por minuto.

MétodoRotaPara quê
POST/nfseEmitir uma nota (resposta 202, assíncrona)
GET/nfse/{id}Situação e detalhes, com o motivo se o governo recusar
GET/nfseListar por período, situação ou tomador
GET/nfse/{id}/xmlXML autorizado, o documento fiscal
GET/nfse/{id}/pdfPDF da nota (DANFSe)
POST/nfse/{id}/cancelamentoCancelar, com motivo e justificativa
POST/lotesEnviar várias notas num arquivo CSV
GET/lotes/{id}Acompanhar o lote

A vida de uma nota.

Consulte a cada 10 a 30 segundos até a nota sair de pendente, processando ou incerta.

  1. pendentena fila
  2. processandosendo enviada ao governo
  3. incertao governo não respondeu; o sistema confirma sozinho antes de reenviar
  4. autorizadanota válida, com chave de acesso
  5. rejeitadao governo recusou; o motivo vem no detalhe
  6. canceladacancelamento registrado

Teste antes, na homologação.

Liberamos um acesso no ambiente de testes do governo, onde a nota não tem valor fiscal, e uma coleção do Postman pronta para usar.

Integre sua emissão de nota esta semana.

Conte qual é o seu sistema e quantas notas ele emite por mês. A gente libera o acesso de testes e acompanha a integração.