Emitindo uma NFC-e

POST /v1/nfce/emitir

O fluxo é o mesmo da NF-e — 202 com job_id, acompanhamento por consulta ou webhook, arquivos depois da autorização. As diferenças estão nos pré-requisitos e no conteúdo.

Pré-requisitos

• CSC configurado (PUT /v1/empresas/{cpf_cnpj}/nfce)
• Certificado A1 válido
• Série de NFC-e definida
• Ambiente correto
• Formas de pagamento no payload
• Itens com NCM e CFOP de operação interna

O cupom

O arquivo pdf da NFC-e é o cupom com QR Code, não um DANFE A4:

GET /v1/nfce/{job_id}/file/pdf

O QR Code é gerado a partir do CSC. É por isso que um CSC errado não falha no cadastro — falha na emissão, ou pior, gera um cupom cujo QR Code não valida na consulta pública.

Contingência

Indisponibilidade da SEFAZ é mais sensível no varejo, onde a venda não pode parar. As regras de contingência variam por UF; consulte a legislação estadual do emitente antes de desenhar esse fluxo.

Cancelamento

POST /v1/nfce/cancelar

Mesmas regras da NF-e, com prazos que podem ser mais curtos conforme a UF.