NFC-e (Consumidor)

Emitir NFC-e

Cria o cupom fiscal de consumidor eletrônico (modelo 65) com apuração tributária automática e QR Code SEFAZ. Suporta emissão direta em 1 passo ("transmitir": true) ou modo rascunho em 2 passos para conferência prévia. Consulte também o guia de Emissão de NFC-e.

Fluxo de Emissão Direta no Ponto de Venda:
1.
Envio da Requisição (`POST /v1/nfce`): Envie o JSON com "transmitir": true (ou aliases "transmit": true / "emitir": true). Caso não envie os impostos calculados, o motor fiscal da NFER resolve automaticamente CFOP, ICMS e regras fiscais com base no cadastro do produto ou no perfil fiscal informado.
2.
Retorno Imediato (`201 Created`): O cupom é criado com número fiscal reservado e enfileirado na transmissão assíncrona da SEFAZ com status "processando".
3.
Resiliência e Contingência: Se a SEFAZ estadual estiver indisponível ou instável, o Circuit Breaker da NFER comuta automaticamente o cupom para contingência offline (tpEmis: 9) em menos de 150ms, evitando que a fila do caixa trave.
4.
Webhook de Autorização (`nfe.autorizada` ou `nfe.contingencia`): Em milissegundos seu PDV recebe a chave de 44 dígitos, o QR Code de consulta da SEFAZ, o comando de impressão térmica ESC/POS e o link direto do DANFCE em PDF pronto para entrega ao cliente.
POST
https://api.nfer.me
/v1/nfce

Authorizations

X-API-Key
string
header
required

Chave de API emitida no painel NFER enviada no header da requisição.

Content-Type
string
header
required

application/json

Body

application/json
transmitir
boolean
opcional
default:false
Define o modo de emissão da NFC-e:
•
true: Emissão Direta — o NFER valida, grava e enfileira imediatamente a transmissão para a SEFAZ estadual (retorna HTTP 201 Created com status "processando"), dispensando chamar o endpoint POST /v1/nfce/:id/send. Ideal para pontos de venda (PDV), e-commerce e checkouts de alta velocidade.
•
false ou omitido (padrão): Modo Rascunho — grava a nota e realiza o cálculo tributário automático em ~50ms com status "rascunho", sem queimar numeração na SEFAZ e permitindo conferência e transmissão posterior via POST /v1/nfce/:id/send.

Aliases aceitos em inglês para integrações internacionais: transmit (ou emitir).

Exemplo:true
environment
"homologacao" | "producao"
opcional
default:da empresa

Sobrepõe o ambiente salvo da conta para esta emissão ("homologacao" ou "producao"). Se omitido, utiliza a configuração da empresa.

Exemplo:homologacao
enviarEmail
boolean
opcional
default:da empresa

Controla o envio automático de e-mail ao consumidor contendo o DANFE NFC-e e o XML após a autorização na SEFAZ. Se true, força o envio para o e-mail do destinatário. Se false, suprime o envio para este cupom. Se omitido, respeita a preferência global cadastrada na NFER.

Exemplo:true
naturezaOperacao
string
opcional
default:VENDA AO CONSUMIDOR

Natureza da operação fiscal (padrão: "VENDA AO CONSUMIDOR").

Exemplo:VENDA AO CONSUMIDOR
serie
integer
opcional
default:1

Série fiscal da NFC-e.

indPres
integer
opcional
default:9

Indicador de presença: 1 (Presencial), 4 (Delivery), 9 (Outros - padrão).

destinatarioId
string<uuid>
opcional

ID do cliente cadastrado (alias aceito: customerId).

destinatario
object
opcional

Identificação inline do consumidor final (opcional na NFC-e para vendas anônimas de balcão).

itens
object[]
required

Lista de produtos da venda do cupom fiscal (ao menos 1 item).

Exemplo:[{"descricao":"Café Expresso Especial 50ml","ncm":"09012100","cfop":"5102","quantidade":2,"valorUnitario":7.5}]
pagamentos
object[]
required

Formas de pagamento da venda no ponto de venda. A soma deve corresponder ao total da nota.

Exemplo:[{"forma":"01","valor":15.0}]

Response

application/json

NFC-e criada com sucesso. Suporta Emissão Direta ("transmitir": true -> status "processando" com número reservado e transmissão SEFAZ enfileirada) ou Modo Rascunho ("transmitir": false -> status "rascunho" com apuração fiscal em ~50ms sem queimar numeração). Em ambos os casos, retorna o ID gerado e a apuração dos itens.

id
string

Identificador único do recurso.

Exemplo:cf_9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d
numero
integer

Número da nota fiscal.

Exemplo:1089
serie
integer

Série da nota fiscal.

Exemplo:1
modelo
string

Modelo fiscal (55 para NF-e, 65 para NFC-e).

Exemplo:65
status
string

Status atual do processamento da nota.

Exemplo:processando
natureza_operacao
string

Natureza da operação fiscal.

Exemplo:VENDA AO CONSUMIDOR
valor_total
integer

Valor total da nota fiscal.

Exemplo:24
created_at
string<date-time>

Data e hora de criação do registro.

Exemplo:2026-09-20T21:00:00.000Z
curl --request POST \
  --url https://api.nfer.me/v1/nfce \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "transmitir": true,
  "naturezaOperacao": "VENDA AO CONSUMIDOR",
  "serie": 1,
  "indPres": 1,
  "itens": [
    {
      "descricao": "Café Expresso Especial 50ml",
      "ncm": "09012100",
      "cfop": "5102",
      "unidade": "UN",
      "quantidade": 2,
      "valorUnitario": 7.5,
      "valorLiquidoUnitario": 7.5,
      "valorLiquido": 15,
      "impostos": {
        "icms": {
          "cst": "102",
          "origem": 0
        }
      }
    },
    {
      "descricao": "Pão de Queijo Tradicional",
      "ncm": "19059090",
      "cfop": "5102",
      "unidade": "UN",
      "quantidade": 1,
      "valorUnitario": 9,
      "valorLiquidoUnitario": 9,
      "valorLiquido": 9,
      "impostos": {
        "icms": {
          "cst": "102",
          "origem": 0
        }
      }
    }
  ],
  "pagamentos": [
    {
      "forma": "17",
      "valor": 24
    }
  ]
}'
{
  "id": "cf_9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "numero": 1089,
  "serie": 1,
  "modelo": "65",
  "status": "processando",
  "natureza_operacao": "VENDA AO CONSUMIDOR",
  "valor_total": 24,
  "created_at": "2026-09-20T21:00:00.000Z"
}