Documentos Fiscais · NFC-e

Emitir NFC-e POST

NFC-e (modelo 65, venda a consumidor final) usa o mesmo endpoint de NF-e -- é o campo ide.modelo: "65" que muda o documento, não uma rota separada. Esta página documenta o fluxo completo com foco nas diferenças reais; o que não é mencionado aqui funciona igual à NF-e.

Quando utilizar

Sempre que seu PDV/ERP precisar emitir uma NFC-e de venda de balcão a consumidor final, identificado ou não. Cada chamada gera exatamente um documento -- para venda B2B com destinatário identificado por CNPJ, normalmente é NF-e (modelo 55) que se aplica, ver NF-e.

Pré-requisitos além dos de NF-e

Tudo que NF-e já exige (contribuinte cadastrado, certificado A1).
CSC (Código de Segurança do Contribuinte) cadastrado -- sem ele a emissão falha antes de tentar montar o XML, porque não dá pra gerar o QR Code obrigatório do NFC-e. Hoje o cadastro do CSC é só pela Área do Cliente (tela de sessão logada) -- não existe endpoint público /v1/... pra isso ainda.

Fluxo da operação

POST /v1/nfe/emissoes (ide.modelo="65")

→

Motor calcula tributos, resolve o CSC, monta o QR Code, assina e transmite pra SEFAZ

→

200 OK · resultado final (mesma chamada)

💡

Síncrono, mesmo padrão de NF-e/CT-e/MDF-e/NFS-e. A própria chamada POST já calcula os tributos, resolve o CSC, monta o QR Code, assina e transmite pra SEFAZ -- a resposta já vem com status final (AUTHORIZED/REJECTED/ERROR/PROCESSING), não um "recebido, consulte depois".

Endpoint

POST https://areacliente.centralfiscal.com.br/v1/nfe/emissoes

⚠️

Cobertura de QR Code hoje: só RS. A URL do QR Code e a URL de consulta por chave variam por UF -- só temos a fórmula e as URLs oficiais confirmadas pra RS. Emitir NFC-e (modelo 65) pra outra UF falha explicitamente (NFCe ainda nao suportada para esta UF/ambiente) em vez de gerar um QR Code com URL genérica ou inventada.

Campos que mudam pra NFC-e

Campo	Diferença
`ide.modelo`	Envie `"65"` -- se omitido, o padrão é `"55"` (NF-e).
`destinatario`	Opcional -- pode omitir inteiro em venda a consumidor final não identificado. Se informar, precisa vir completo (mesma validação da NF-e).
`ide.presenca_comprador`	Importante informar -- o padrão da API é `NAO_PRESENCIAL_OUTROS` (indPres=9), errado pra venda de balcão. Use `PRESENCIAL` pra PDV comum. Ver Enums pros demais valores.
`ide.consumidor_final`	Normalmente `CONSUMIDOR_FINAL` pra NFC-e (o padrão da API é `NORMAL`, que é o certo pra NF-e B2B).

Exemplo mínimo

Venda de balcão, um item com ICMS já retido por ST anteriormente (CST 60) -- comum em PDV de varejo -- veja o código ao lado.

Resposta de sucesso

200 OK -- mesmo formato de resposta da NF-e, mas o detalhes.xml gerado já vem com o grupo infNFeSupl (QR Code + URL de consulta por chave) -- é isso que sua tela de PDV ou impressora fiscal precisa pra montar o DANFCe. O QR Code em si não vem como campo separado no JSON -- extraia o elemento qrCode do XML baixável pela URL em detalhes.

Resposta de erro

Exemplo real: emitir pra uma UF ainda sem cobertura de QR Code -- 400 Bad Request. Catálogo completo de erros: Tratamento de Erros.

Notificação assíncrona

Não existe webhook genérico hoje -- e como a chamada já é síncrona (a resposta já traz o resultado final), normalmente você não precisa de nada além do próprio POST.

Cancelamento

Usa o mesmo POST /v1/nfe/cancelamentos da NF-e (mesmos campos: chave_acesso/protocolo/justificativa com pelo menos 15 caracteres). Mesmo padrão síncrono da emissão: a resposta já vem com o resultado final do evento de cancelamento na SEFAZ. Exemplo de request/resposta: ver na página de NF-e (é o mesmo endpoint, documentar duas vezes só divergiria com o tempo).

Outros eventos (mesmos endpoints da NF-e)

Carta de Correção, Ator Interessado, os eventos RTC e a Manifestação do Destinatário também usam exatamente os mesmos endpoints documentados pra NF-e -- não existe rota nem motor separado pra NFC-e, a chave de acesso de 44 dígitos já identifica o modelo (65) sozinha. Tecnicamente qualquer um deles aceita uma chave de NFC-e.

⚠️

Nem todos fazem sentido pra venda de balcão. A CentralFiscal não bloqueia nenhum deles no seu lado -- quem decide se um evento se aplica ao modelo 65 é a SEFAZ, na hora de processar. Na prática:

Carta de Correção e Manifestação do Destinatário normalmente são rejeitados pela SEFAZ pra NFC-e -- venda de balcão em geral não tem destinatário identificado, e a regra de negócio do modelo 65 não prevê esses dois fluxos. Envie só se você já confirmou que a UF em questão aceita.
Ator Interessado e os eventos RTC são cenários de B2B/importação/apuração -- raro fazer sentido numa venda a consumidor final, mas nada nosso impede o envio.

Se a SEFAZ rejeitar por regra de negócio do modelo, o erro vem no mesmo formato de sempre -- ver Rejeições SEFAZ.

O que ainda não existe

Cadastro de CSC via API pública -- só pelo portal, sessão logada.
Cobertura de QR Code fora do RS.

Próximos passos

Baixar o XML (com infNFeSupl) usando a URL em detalhes e extrair o elemento qrCode pra imprimir/exibir no PDV.
Se precisar cancelar, ver POST /v1/nfe/cancelamentos acima.
Reconsultar mais tarde, se precisar: GET /v1/nfe/emissoes/{transmissao_id}.

Exemplo mínimo

curl -X POST https://areacliente.centralfiscal.com.br/v1/nfe/emissoes \
  -H "Authorization: Bearer cf_live_51JqK..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pdv-caixa1-0001" \
  -d '{
    "emitente_documento": "12345678000190",
    "ide": {
      "modelo": "65",
      "serie": "1",
      "numero": "5001",
      "data_emissao": "2026-08-07T14:30:00-03:00",
      "natureza_operacao": "Venda de mercadoria",
      "presenca_comprador": "PRESENCIAL",
      "consumidor_final": "CONSUMIDOR_FINAL",
      "municipio_fato_gerador": 4314902
    },
    "itens": [
      {
        "numero_item": 1,
        "codigo": "SKU-001",
        "descricao": "Refrigerante lata 350ml",
        "ncm": "22021000",
        "cfop": "5102",
        "unidade_comercial": "UN",
        "quantidade_comercial": 2,
        "valor_unitario_comercial": 6.5,
        "valor_produto": 13,
        "tributacao": {
          "icms": {"origem": "0", "cst": "60", "base_calculo": 0, "aliquota": 0, "valor": 0},
          "pis": {"cst": "01", "base_calculo": 13, "aliquota": 1.65, "valor": 0.21},
          "cofins": {"cst": "01", "base_calculo": 13, "aliquota": 7.6, "valor": 0.99}
        }
      }
    ],
    "pagamentos": [{"forma": "DINHEIRO", "valor": 13}]
  }'

using System.Net.Http.Headers;
using System.Net.Http.Json;

var client = new HttpClient { BaseAddress = new Uri("https://areacliente.centralfiscal.com.br") };
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "cf_live_51JqK...");
client.DefaultRequestHeaders.Add("Idempotency-Key", "pdv-caixa1-0001");

var payload = new
{
    emitente_documento = "12345678000190",
    ide = new
    {
        modelo = "65",
        serie = "1",
        numero = "5001",
        data_emissao = "2026-08-07T14:30:00-03:00",
        natureza_operacao = "Venda de mercadoria",
        presenca_comprador = "PRESENCIAL",
        consumidor_final = "CONSUMIDOR_FINAL",
        municipio_fato_gerador = 4314902
    },
    itens = new[]
    {
        new
        {
            numero_item = 1,
            codigo = "SKU-001",
            descricao = "Refrigerante lata 350ml",
            ncm = "22021000",
            cfop = "5102",
            unidade_comercial = "UN",
            quantidade_comercial = 2,
            valor_unitario_comercial = 6.5,
            valor_produto = 13,
            tributacao = new
            {
                icms = new { origem = "0", cst = "60", base_calculo = 0, aliquota = 0, valor = 0 },
                pis = new { cst = "01", base_calculo = 13, aliquota = 1.65, valor = 0.21 },
                cofins = new { cst = "01", base_calculo = 13, aliquota = 7.6, valor = 0.99 }
            }
        }
    },
    pagamentos = new[] { new { forma = "DINHEIRO", valor = 13 } }
};

var response = await client.PostAsJsonAsync("/v1/nfe/emissoes", payload);
var resultado = await response.Content.ReadFromJsonAsync();
Console.WriteLine(resultado.GetProperty("chave").GetString());

const response = await fetch("https://areacliente.centralfiscal.com.br/v1/nfe/emissoes", {
  method: "POST",
  headers: {
    "Authorization": "Bearer cf_live_51JqK...",
    "Content-Type": "application/json",
    "Idempotency-Key": "pdv-caixa1-0001",
  },
  body: JSON.stringify({
    emitente_documento: "12345678000190",
    ide: {
      modelo: "65",
      serie: "1",
      numero: "5001",
      data_emissao: "2026-08-07T14:30:00-03:00",
      natureza_operacao: "Venda de mercadoria",
      presenca_comprador: "PRESENCIAL",
      consumidor_final: "CONSUMIDOR_FINAL",
      municipio_fato_gerador: 4314902,
    },
    itens: [
      {
        numero_item: 1,
        codigo: "SKU-001",
        descricao: "Refrigerante lata 350ml",
        ncm: "22021000",
        cfop: "5102",
        unidade_comercial: "UN",
        quantidade_comercial: 2,
        valor_unitario_comercial: 6.5,
        valor_produto: 13,
        tributacao: {
          icms: { origem: "0", cst: "60", base_calculo: 0, aliquota: 0, valor: 0 },
          pis: { cst: "01", base_calculo: 13, aliquota: 1.65, valor: 0.21 },
          cofins: { cst: "01", base_calculo: 13, aliquota: 7.6, valor: 0.99 },
        },
      },
    ],
    pagamentos: [{ forma: "DINHEIRO", valor: 13 }],
  }),
});

const resultado = await response.json();
console.log(resultado.chave, resultado.status);

interface NfeEmissaoResponse {
  transmissao_id: string;
  status: "RECEIVED" | "PROCESSING" | "AUTHORIZED" | "REJECTED" | "ERROR";
  chave: string | null;
  numero_documento: string | null;
  protocolo: string | null;
  mensagem: string;
}

const response = await fetch("https://areacliente.centralfiscal.com.br/v1/nfe/emissoes", {
  method: "POST",
  headers: {
    Authorization: "Bearer cf_live_51JqK...",
    "Content-Type": "application/json",
    "Idempotency-Key": "pdv-caixa1-0001",
  },
  body: JSON.stringify({
    emitente_documento: "12345678000190",
    ide: {
      modelo: "65",
      serie: "1",
      numero: "5001",
      data_emissao: "2026-08-07T14:30:00-03:00",
      natureza_operacao: "Venda de mercadoria",
      presenca_comprador: "PRESENCIAL",
      consumidor_final: "CONSUMIDOR_FINAL",
      municipio_fato_gerador: 4314902,
    },
    itens: [
      {
        numero_item: 1,
        codigo: "SKU-001",
        descricao: "Refrigerante lata 350ml",
        ncm: "22021000",
        cfop: "5102",
        unidade_comercial: "UN",
        quantidade_comercial: 2,
        valor_unitario_comercial: 6.5,
        valor_produto: 13,
        tributacao: {
          icms: { origem: "0", cst: "60", base_calculo: 0, aliquota: 0, valor: 0 },
          pis: { cst: "01", base_calculo: 13, aliquota: 1.65, valor: 0.21 },
          cofins: { cst: "01", base_calculo: 13, aliquota: 7.6, valor: 0.99 },
        },
      },
    ],
    pagamentos: [{ forma: "DINHEIRO", valor: 13 }],
  }),
});

const resultado: NfeEmissaoResponse = await response.json();

import requests

response = requests.post(
    "https://areacliente.centralfiscal.com.br/v1/nfe/emissoes",
    headers={
        "Authorization": "Bearer cf_live_51JqK...",
        "Idempotency-Key": "pdv-caixa1-0001",
    },
    json={
        "emitente_documento": "12345678000190",
        "ide": {
            "modelo": "65",
            "serie": "1",
            "numero": "5001",
            "data_emissao": "2026-08-07T14:30:00-03:00",
            "natureza_operacao": "Venda de mercadoria",
            "presenca_comprador": "PRESENCIAL",
            "consumidor_final": "CONSUMIDOR_FINAL",
            "municipio_fato_gerador": 4314902,
        },
        "itens": [
            {
                "numero_item": 1,
                "codigo": "SKU-001",
                "descricao": "Refrigerante lata 350ml",
                "ncm": "22021000",
                "cfop": "5102",
                "unidade_comercial": "UN",
                "quantidade_comercial": 2,
                "valor_unitario_comercial": 6.5,
                "valor_produto": 13,
                "tributacao": {
                    "icms": {"origem": "0", "cst": "60", "base_calculo": 0, "aliquota": 0, "valor": 0},
                    "pis": {"cst": "01", "base_calculo": 13, "aliquota": 1.65, "valor": 0.21},
                    "cofins": {"cst": "01", "base_calculo": 13, "aliquota": 7.6, "valor": 0.99},
                },
            }
        ],
        "pagamentos": [{"forma": "DINHEIRO", "valor": 13}],
    },
)
resultado = response.json()
print(resultado["chave"], resultado["status"])

uses System.Net.HttpClient, System.JSON;

var
  Http: THTTPClient;
  Corpo, Ide, Item, Trib, Icms, Pagamento: TJSONObject;
  Itens, Pagamentos: TJSONArray;
  Resposta: IHTTPResponse;
begin
  Http := THTTPClient.Create;
  Http.CustomHeaders['Authorization'] := 'Bearer cf_live_51JqK...';
  Http.CustomHeaders['Idempotency-Key'] := 'pdv-caixa1-0001';

  Icms := TJSONObject.Create;
  Icms.AddPair('origem', '0');
  Icms.AddPair('cst', '60');
  Icms.AddPair('base_calculo', TJSONNumber.Create(0));
  Icms.AddPair('aliquota', TJSONNumber.Create(0));
  Icms.AddPair('valor', TJSONNumber.Create(0));

  Trib := TJSONObject.Create;
  Trib.AddPair('icms', Icms);

  Item := TJSONObject.Create;
  Item.AddPair('numero_item', TJSONNumber.Create(1));
  Item.AddPair('codigo', 'SKU-001');
  Item.AddPair('descricao', 'Refrigerante lata 350ml');
  Item.AddPair('ncm', '22021000');
  Item.AddPair('cfop', '5102');
  Item.AddPair('unidade_comercial', 'UN');
  Item.AddPair('quantidade_comercial', TJSONNumber.Create(2));
  Item.AddPair('valor_unitario_comercial', TJSONNumber.Create(6.5));
  Item.AddPair('valor_produto', TJSONNumber.Create(13));
  Item.AddPair('tributacao', Trib);

  Itens := TJSONArray.Create;
  Itens.AddElement(Item);

  Pagamento := TJSONObject.Create;
  Pagamento.AddPair('forma', 'DINHEIRO');
  Pagamento.AddPair('valor', TJSONNumber.Create(13));

  Pagamentos := TJSONArray.Create;
  Pagamentos.AddElement(Pagamento);

  Ide := TJSONObject.Create;
  Ide.AddPair('modelo', '65');
  Ide.AddPair('serie', '1');
  Ide.AddPair('numero', '5001');
  Ide.AddPair('data_emissao', '2026-08-07T14:30:00-03:00');
  Ide.AddPair('natureza_operacao', 'Venda de mercadoria');
  Ide.AddPair('presenca_comprador', 'PRESENCIAL');
  Ide.AddPair('consumidor_final', 'CONSUMIDOR_FINAL');
  Ide.AddPair('municipio_fato_gerador', TJSONNumber.Create(4314902));

  Corpo := TJSONObject.Create;
  Corpo.AddPair('emitente_documento', '12345678000190');
  Corpo.AddPair('ide', Ide);
  Corpo.AddPair('itens', Itens);
  Corpo.AddPair('pagamentos', Pagamentos);

  Resposta := Http.Post('https://areacliente.centralfiscal.com.br/v1/nfe/emissoes',
    TStringStream.Create(Corpo.ToJSON, TEncoding.UTF8), nil,
    [TNameValuePair.Create('Content-Type', 'application/json')]);

  WriteLn(Resposta.ContentAsString);
end;

#include "hbjson.ch"

LOCAL oHttp, cCorpo, oResposta, oCorpo

oCorpo := { ;
    "emitente_documento" => "12345678000190", ;
    "ide" => { ;
        "modelo" => "65", ;
        "serie" => "1", ;
        "numero" => "5001", ;
        "data_emissao" => "2026-08-07T14:30:00-03:00", ;
        "natureza_operacao" => "Venda de mercadoria", ;
        "presenca_comprador" => "PRESENCIAL", ;
        "consumidor_final" => "CONSUMIDOR_FINAL", ;
        "municipio_fato_gerador" => 4314902 }, ;
    "itens" => { { ;
        "numero_item" => 1, ;
        "codigo" => "SKU-001", ;
        "descricao" => "Refrigerante lata 350ml", ;
        "ncm" => "22021000", ;
        "cfop" => "5102", ;
        "unidade_comercial" => "UN", ;
        "quantidade_comercial" => 2, ;
        "valor_unitario_comercial" => 6.5, ;
        "valor_produto" => 13, ;
        "tributacao" => { "icms" => { "origem" => "0", "cst" => "60", ;
            "base_calculo" => 0, "aliquota" => 0, "valor" => 0 } } } }, ;
    "pagamentos" => { { "forma" => "DINHEIRO", "valor" => 13 } } }

cCorpo := hb_jsonEncode( oCorpo )

oHttp := TIPClient():New( "areacliente.centralfiscal.com.br" )
oHttp:SetHeader( "Authorization", "Bearer cf_live_51JqK..." )
oHttp:SetHeader( "Content-Type", "application/json" )
oHttp:SetHeader( "Idempotency-Key", "pdv-caixa1-0001" )

oResposta := oHttp:Post( "/v1/nfe/emissoes", cCorpo )
? oResposta:cBody

Resposta de sucesso -- 200 OK, status AUTHORIZED

{
  "ambiente": "PRODUCTION",
  "documento": "NFC-e",
  "transmissao_id": "9f1e2d3c-4b5a-4c6d-8e7f-1a2b3c4d5e6f",
  "idempotencia": "pdv-caixa1-0001",
  "id_externo": null,
  "status": "AUTHORIZED",
  "operacao": "ISSUE",
  "chave": "43260812345678000190650010000050011000050015",
  "numero_documento": "5001",
  "serie": "1",
  "protocolo": "143260000123456",
  "mensagem": "Autorizado o uso da NFC-e",
  "criada_em": "2026-08-07T14:30:01-03:00",
  "concluida_em": "2026-08-07T14:30:03-03:00",
  "detalhes": {
    "estado_motor": "AUTORIZADA",
    "cstat": "100",
    "xmotivo": "Autorizado o uso da NFC-e",
    "xml_url": "https://areacliente.centralfiscal.com.br/v1/nfe/emissoes/9f1e2d3c.../xml"
  }
}

infNFeSupl (QR Code) dentro do XML autorizado

<infNFeSupl>
  <qrCode>https://www.sefaz.rs.gov.br/NFCE/NFCE-COM.aspx?p=43260812345678000190650010000050011000050015|2|1|1000000000000000000000000000000000000000|3A1F...</qrCode>
  <urlChave>www.sefaz.rs.gov.br/nfce/consulta</urlChave>
</infNFeSupl>

Resposta de erro -- 400 Bad Request (UF sem cobertura de QR Code)

{
  "detail": "NFC-e ainda nao suportada para esta UF/ambiente: URL de QR Code/consulta nao sourceada."
}