NFER
Visão GeralQuick StartAutenticaçãoAmbientesConfiguração InicialExemplos de RequisiçãoGlossário FiscalChecklist de Go-LiveFAQModelo de DadosCiclo de Vida & FluxoContingência AutomáticaLimites & Rate LimitEvitando DuplicidadeErros e RetransmissãoSplit Fiscal HíbridoNovoConceitosEmissão Passo a PassoConceitosEmissão Passo a PassoConceitosEmissão Passo a PassoCódigos de ServiçoConceitosEmissão Passo a PassoNovoRegimes, CST e CFOPEventos FiscaisVisão Geral & CronogramaNovos Campos na APITabela cClassTribDevoluções & AnulaçõesChecklist de MigraçãoVisão Geral & NSUCorporate+NF-e Recebidas & MD-eCorporate+NFS-e Tomadas (ADN)Corporate+CT-e Fretes & DesacordoCorporate+White-Label & Org APIEmpresaCertificado A1 & CSCHabilitação SEFAZCadastrosNumeraçãoPlanos

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": "processando",
"valorServico": 2500.00,
"created_at": "2026-09-20T18:00:00.000Z"
}

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.pdf",
"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çãoEndpointQuando Utilizar
CancelamentoPOST /v1/nfse/:id/cancelServiço não prestado ou erro total de faturamento.
SubstituiçãoPOST /v1/nfse/:id/substituteCorreção de valor, descrição ou tomador mantendo o vínculo com a nota anterior.

Próximos Passos

AnteriorConceitosPróximoCódigos de Serviço