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

Exemplos Prontos de Requisição

Chamadas cURL funcionais com payload e retorno para NF-e, NFC-e, NFS-e e CT-e.

Exemplos mínimos e funcionais de requisição cURL para emissão de cada documento suportado pelo NFER. Todas as chamadas exigem o cabeçalho de autenticação X-API-Key e enviam dados em JSON.

Valores reais e calculados

O NFER calcula automaticamente o somatório de itens, bases de cálculo e totais da nota. Os payloads abaixo representam a estrutura mínima para obter uma emissão válida.

1. NF-e — Nota Fiscal Eletrônica (Modelo 55)

Criação de rascunho de venda mercantil B2B ou e-commerce com cliente e item inline:

curl -s -X POST https://api.nfer.me/v1/nfe \
-H "X-API-Key: $NFER_KEY" \
-H "Content-Type: application/json" \
-d '{
"naturezaOperacao": "VENDA DE MERCADORIA",
"tipoOperacao": "1",
"finalidade": 1,
"serie": 1,
"destinatario": {
"tipoPessoa": "J",
"cpfCnpj": "00000000000191",
"nome": "EMPRESA DESTINATARIA LTDA",
{
"id": "7b8f9e12-3456-4abc-9def-123456789abc",
"numero": 105,
"serie": 1,
"modelo": "55",
"status": "rascunho",
"valor_total": 250.00,
"created_at": "2026-09-20T18:00:00.000Z"
}

Em seguida, enfileire a transmissão da NF-e para a SEFAZ:

curl -s -X POST https://api.nfer.me/v1/nfe/7b8f9e12-3456-4abc-9def-123456789abc/send \
-H "X-API-Key: $NFER_KEY"

2. NFC-e — Cupom Fiscal Eletrônico (Modelo 65)

Venda presencial no balcão (PDV) com identificação do consumidor via CPF e forma de pagamento:

curl -s -X POST https://api.nfer.me/v1/nfce \
-H "X-API-Key: $NFER_KEY" \
-H "Content-Type: application/json" \
-d '{
"naturezaOperacao": "VENDA AO CONSUMIDOR",
"indPres": "1",
"serie": 1,
"destinatario": {
"cpf": "12345678901",
"nome": "Consumidor Final"
},
"itens": [
curl -s -X POST https://api.nfer.me/v1/nfce/e4c5b6a7-8901-4def-1234-56789abcdef0/send \
-H "X-API-Key: $NFER_KEY"

Assim que autorizada pela SEFAZ, a consulta GET /v1/nfce/:id ou o webhook nfe.autorizada retorna os links de impressão:

{
"id": "e4c5b6a7-8901-4def-1234-56789abcdef0",
"numero": 304,
"serie": 1,
"modelo": "65",
"status": "autorizada",
"chave_acesso": "35260900000000000191650010000003041000003045",
"protocolo": "135260000987654",
"danfe_url": "https://danfe.nfer.me/35260900000000000191650010000003041000003045",
"escpos_url": "https://api.nfer.me/v1/nfe/e4c5b6a7-8901-4def-1234-56789abcdef0/escpos?largura=80"
}

3. NFS-e — Nota Fiscal de Serviço (Padrão Nacional ADN)

Declaração de Prestação de Serviços (DPS) transmitida ao Ambiente de Dados Nacional em fluxo de 2 etapas (rascunho + envio):

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 e suporte em nuvem",
"valorServico": 1500.00,
"cLocPrestacao": "3550308",
"tribIssqn": 1
}'
curl -s -X POST https://api.nfer.me/v1/nfse/5f6e7d8c-9b0a-4123-8456-7890abcdef12/send \
-H "X-API-Key: $NFER_KEY"

4. CT-e — Conhecimento de Transporte Eletrônico (Modelo 57)

Emissão de CT-e Rodoviário vinculado a NF-e originária com cálculo de frete e carga:

curl -s -X POST https://api.nfer.me/v1/cte \
-H "X-API-Key: $NFER_KEY" \
-H "Content-Type: application/json" \
-d '{
"modal": "01",
"cfop": "5353",
"ufIni": "SP",
"xMunIni": "São Paulo",
"ufFim": "RJ",
"xMunFim": "Rio de Janeiro",
"valorTotal": 850.00,
"destinatario": {
curl -s -X POST https://api.nfer.me/v1/cte/3c4d5e6f-7a8b-4901-8234-567890abcdef/send \
-H "X-API-Key: $NFER_KEY"

Próximos Passos

AnteriorConfiguração InicialPróximoGlossário Fiscal