Emissão NFS-e Passo a Passo

RPS, conversão em NFS-e, DANFSE PDF e cancelamento municipal.

Guia passo a passo para emissão de NFS-e (Nota Fiscal de Serviços Eletrônica) no Padrão Nacional unificado (ADN / Receita Federal). Emita notas de serviço para qualquer município conveniado utilizando um único contrato JSON, sem necessidade de integrar webservices municipais legados.

BASE URL

https://api.nfer.me/v1

O Padrão Nacional (Ambiente de Dados Nacional — ADN)

Conforme a Resolução CGSN 189/2023, o Brasil unificou a emissão de serviços através da Declaração de Prestação de Serviços (DPS). O NFER assina a DPS com o Certificado Digital A1 da empresa e transmite diretamente aos servidores federais do ADN.

Códigos de Serviço Padronizados

Para emitir no padrão nacional, o campo codigoServico deve ter 6 dígitos numéricos (cTribNac) correspondentes à Lista de Serviços da LC 116/2003. Consulte a tabela completa em Códigos de Serviço NFS-e.

Passo 1: Transmitir a NFS-e (POST /v1/nfse)

Envie os dados do serviço, valor e o tomador vinculado (customerId):

POST/v1/nfse

Cria a DPS, assina com A1 e transmite ao ADN.

curl -s -X POST https://api.nfer.me/v1/nfse \

-H "X-API-Key: $NFER_KEY" \

-H "Content-Type: application/json" \

-d '{

"customerId": "8a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",

"codigoServico": "010701",

"descricao": "Desenvolvimento de software sob encomenda e consultoria técnica em nuvem",

"valorServico": 2500.00,

"cLocPrestacao": "3550308",

"tribIssqn": 1

{

"id": "5f6e7d8c-9b0a-4123-8456-7890abcdef12",

"numero": 42,

"serie": 1,

"status": "rascunho",

"valorServico": 2500.00,

"created_at": "2026-09-20T18:00:00.000Z"

}

Após a gravação do rascunho da DPS com numeração reservada, transmita a nota para validação e assinatura digital no ADN:

POST/v1/nfse/:id/send

Enfileira a DPS para assinatura digital e envio ao ADN.

curl -s -X POST https://api.nfer.me/v1/nfse/5f6e7d8c-9b0a-4123-8456-7890abcdef12/send \

-H "X-API-Key: $NFER_KEY"

{

"message": "NFS-e queued for sending",

"jobId": "job_nfse_882910"

}

Passo 2: Consultar Autorização (GET /v1/nfse/:id)

Para a emissão de NFS-e própria (outbound), consulte o status da nota realizando polling prudente com intervalo de 3 a 5 segundos até a transição para autorizada:

GET/v1/nfse/:id

Retorna status, chave de 50 dígitos e links de DANFSE.

curl -s "https://api.nfer.me/v1/nfse/5f6e7d8c-9b0a-4123-8456-7890abcdef12" \

-H "X-API-Key: $NFER_KEY"

{

"id": "5f6e7d8c-9b0a-4123-8456-7890abcdef12",

"numero": 42,

"serie": 1,

"status": "autorizada",

"chaveAcesso": "35260900000000000191000000000000000000004212345678",

"protocolo": "20260920180012345",

"valorServico": 2500.00,

"danfse_url": "https://api.nfer.me/v1/nfse/5f6e7d8c-9b0a-4123-8456-7890abcdef12/danfse",

"xml_url": "https://api.nfer.me/v1/nfse/5f6e7d8c-9b0a-4123-8456-7890abcdef12/xml"

}

Cancelamento e Substituição de NFS-e

Diferente do cancelamento puro, o Ambiente de Dados Nacional suporta o processo formal de substituição de nota, onde a nota antiga é cancelada e uma nova nota é vinculada automaticamente sem quebrar o histórico fiscal:

Operação	Endpoint	Quando Utilizar
Cancelamento	`POST /v1/nfse/:id/cancel`	Serviço não prestado ou erro total de faturamento.
Substituição	`POST /v1/nfse/:id/substituir`	Correção de valor, descrição ou tomador mantendo o vínculo com a nota anterior.

Próximos Passos

Veja os fundamentos da Resolução CGSN 189 em Conceitos NFS-e Nacional.
Consulte o catálogo de códigos em Códigos de Serviço.