Emissão de NFC-e

A NFC-e (Nota Fiscal de Consumidor Eletrônica, modelo 65) é o documento fiscal para venda de produtos a consumidor final, tipicamente em PDV de varejo — o cupom fiscal eletrônico que substituiu o antigo ECF. Use POST /v1/consumer-invoices para esse cenário. Se a operação é entre empresas, ou venda a consumidor que não seja em balcão (ex.: e-commerce B2B, remessa), use Emissão de NF-e.

Assim como a NF-e, a emissão de NFC-e é assíncrona — a resposta 2xx confirma apenas que a nota foi aceita. Veja Síncrono vs assíncrono e Ciclo de vida da nota.

Exemplo de criação

cURL

curl -X POST https://sandbox-api.spedy.com.br/v1/consumer-invoices \
  -H "X-Api-Key: sua-chave-de-api" \
  -H "Content-Type: application/json" \
  -d '{
    "integrationId": "venda-pdv-98765",
    "effectiveDate": "2026-08-03T10:00:00Z",
    "operationNature": "Venda de mercadoria",
    "isFinalCustomer": true,
    "receiver": {
      "name": "Consumidor Final",
      "federalTaxNumber": "11144477735"
    },
    "payments": [
      { "method": "creditCard", "amount": 100.0 }
    ],
    "items": [
      {
        "code": "SKU-001",
        "description": "Produto Exemplo",
        "ncm": "61091000",
        "cfop": 5102,
        "unit": "UN",
        "quantity": 1,
        "unitAmount": 100.0,
        "unitTax": "UN",
        "quantityTax": 1,
        "unitTaxAmount": 100.0,
        "totalAmount": 100.0,
        "taxes": {
          "icms": { "origin": 0, "csosn": 102 },
          "pis": { "cst": 49 },
          "cofins": { "cst": 49 }
        }
      }
    ]
  }'

Exemplo mínimo para empresas do Simples Nacional — a tributação por item (icms.csosn 102, pis/cofins cst 49) tem o mesmo significado da NF-e; veja Emissão de NF-e. A NFC-e ainda exige tokenId/csc configurados na empresa para gerar o QR Code — veja Diferenças em relação à NF-e, abaixo.

Os valores de tributação deste exemplo têm fins didáticos e não substituem a orientação de um contador. A tributação correta depende do seu regime, do produto (NCM), da operação e da UF — valide com o seu contador ou responsável fiscal antes de emitir em produção.

Diferenças em relação à NF-e

O payload de POST /v1/consumer-invoices (CreateConsumerInvoiceDto) tem a mesma forma geral do payload de NF-e — receiver, items, payments, transport, total — mas o uso muda porque o cenário é diferente:

Venda ao consumidor, não B2B. receiver costuma trazer só o CPF (ou nem isso, em venda sem identificação do destinatário), sem inscrição estadual.
Pagamento é obrigatório para autorizar. A SEFAZ exige o grupo de pagamento em toda NFC-e. Em PDV, payments[] com method (money, pix, creditCard, debitCard, foodVoucher etc.) e amount reflete a forma real no caixa. O schema da API não marca payments como obrigatório, mas sem ele a nota é rejeitada.
DANFE-NFC-e tem QR Code, e o QR Code depende de duas credenciais específicas configuradas na empresa, não no payload da nota:
Configuração (consumerInvoice) Uso
tokenId ID do token usado para gerar o QR Code do DANFE-NFC-e.
csc Código de Segurança do Contribuinte (CSC), usado junto com o tokenId para assinar o QR Code.
Sem tokenId/csc configurados corretamente para o ambiente (produção ou homologação), a NFC-e não é autorizada — o QR Code é obrigatório e não pode ser gerado. Configure-os em Configuração inicial.

Configuração (`consumerInvoice`)	Uso
`tokenId`	ID do token usado para gerar o QR Code do DANFE-NFC-e.
`csc`	Código de Segurança do Contribuinte (CSC), usado junto com o `tokenId` para assinar o QR Code.

Contingência offline

NFC-e tem um modo de contingência que NF-e não tem da mesma forma: emissão offline quando a SEFAZ está indisponível. Ele depende de uma configuração explícita:

Configuração (`consumerInvoice`)	Efeito
`allowOfflineContingency`	Habilita a emissão em contingência offline (`tpEmis=9`) quando a SEFAZ está fora do ar. Exige `tokenId`/`csc` válidos, porque o DANFE em contingência é validado pelo QR Code, não por uma resposta síncrona da SEFAZ.

Enquanto em contingência, a nota fica com status: inContingent até a SEFAZ voltar a operar e o lote ser reprocessado — veja Contingência para o comportamento completo e como identificar notas nesse estado.

NFC-e não tem carta de correção. Diferente da NF-e (POST /v1/product-invoices/{id}/corrections), não existe endpoint de correção para consumer-invoices — qualquer erro em uma nota já autorizada só pode ser resolvido por cancelamento (dentro do prazo legal) seguido de nova emissão. Veja Cancelamento, correção e inutilização.

Operações relacionadas

Operação	Endpoint
Listar notas	`GET /v1/consumer-invoices`
Obter a nota (por ID)	`GET /v1/consumer-invoices/{id}`
Baixar PDF (DANFE-NFC-e, com QR Code)	`GET /v1/consumer-invoices/{id}/pdf`
Baixar XML	`GET /v1/consumer-invoices/{id}/xml`
Consultar diretamente na SEFAZ (reconciliar)	`POST /v1/consumer-invoices/{id}/check-status`
Inutilizar faixa de numeração	`POST /v1/consumer-invoices/disablement`
Reenviar e-mail ao destinatário	`POST /v1/consumer-invoices/{id}/resend-email`

Inutilização tem regras de prazo e uso específicas — veja Cancelamento, correção e inutilização.

Próximos passos

Comportamento em queda de SEFAZ: Contingência
Estados possíveis da nota: Ciclo de vida da nota
Cancelamento e inutilização: Cancelamento, correção e inutilização
Configurar tokenId/csc: Configuração inicial

Fundamentos

Emissão

Operações fiscais

Emissão de NFC-e

Exemplo de criação

Diferenças em relação à NF-e

Contingência offline

Operações relacionadas

Próximos passos

​Exemplo de criação

​Diferenças em relação à NF-e

​Contingência offline

​Operações relacionadas

​Próximos passos

Exemplo de criação

Diferenças em relação à NF-e

Contingência offline

Operações relacionadas

Próximos passos