NFC-e modelo 65: configure o CSC, emita o cupom e acompanhe a autorização.

Antes da primeira emissão

IBS/CBS — Reforma Tributária

Quando a regra vigente exigir IBS/CBS, informe o grupo por item em items[].taxes.ibscbs. A API valida a estrutura e calcula os valores usando a base do item após desconto.

"ibscbs": {
  "cst": "000",
  "classification_code": "000001",
  "state_rate": 0.1,
  "municipal_rate": 0,
  "cbs_rate": 0.9
}

O escopo cobre a tributação regular (CST 000), a redução de alíquota (CST 200) e a imunidade / não incidência (CST 410), com 37 cClassTrib liberados em NFC-e pela tabela oficial do IT 2025.002 v1.60 — o par, a vigência, o tipo de alíquota e a permissão para o modelo são validados por ela. Um código aceito em NF-e pode ser vedado em NFC-e; a decisão é da tabela. Na redução, o percentual vem do cClassTrib e não do payload. Classificações que exigem grupos ainda não implementados são bloqueadas com a indicação de qual grupo falta. Confirme as alíquotas aplicáveis à operação com a regra fiscal vigente. A plataforma não aplica defaults tributários fictícios.

Exemplo completo

curl --request POST \
  --url https://fiscal.contora.com.br/api/v1/nfe/drafts \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'X-Company-Document: CNPJ_SEM_MASCARA' \
  --header 'Idempotency-Key: venda-1002-nfce' \
  --data '{
    "document_type": "nfce",
    "series": 1,
    "number": 1002,
    "payload": {
      "nature_operation": "Venda ao consumidor",
      "operation_type": "saida",
      "consumer_final": true,
      "presence_indicator": 1,
      "items": [{
        "code": "SKU-1",
        "name": "Produto de demonstração",
        "ncm": "22030000",
        "cfop": "5102",
        "unit": "UN",
        "quantity": 1,
        "unit_price": 10.00,
        "taxes": {
          "icms": {"code": "102", "origin": 0},
          "pis": {"code": "49", "aliquot": 0},
          "cofins": {"code": "49", "aliquot": 0}
        }
      }],
      "payments": [{"method": "01", "indicator": 0, "amount": 10.00}]
    }
  }'

Destinatário e diferenças para NF-e

Contingência Off-line (tpEmis = 9) no PDV

Quando a SEFAZ estadual estiver indisponível ou houver oscilação de conectividade, a frente de caixa não pode parar. A API Fiscal Contora oferece suporte nativo e automatizado à emissão em contingência off-line para a NFC-e (modelo 65).

1. Criar o rascunho em contingência

Ao criar a NFC-e, inclua o bloco contingency com mode: 9 e uma justificativa explicativa em reason (mínimo de 15 caracteres):

curl --request POST \
  --url https://fiscal.contora.com.br/api/v1/nfe/drafts \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'X-Company-Document: CNPJ_SEM_MASCARA' \
  --data '{
    "document_type": "nfce",
    "series": 1,
    "number": 1003,
    "payload": {
      "model": 65,
      "nature_operation": "Venda ao consumidor",
      "contingency": {
        "mode": 9,
        "reason": "Indisponibilidade de comunicacao com a SEFAZ estadual"
      },
      "consumer_final": true,
      "presence_indicator": 1,
      "items": [{
        "code": "PROD-01",
        "name": "Item Varejo",
        "ncm": "21069090",
        "cfop": "5102",
        "unit": "UN",
        "quantity": 1,
        "unit_price": 20.00,
        "taxes": {
          "icms": {"code": "102", "origin": 0},
          "pis": {"code": "49", "aliquot": 0},
          "cofins": {"code": "49", "aliquot": 0}
        }
      }],
      "payments": [{"method": "01", "amount": 20.00}]
    }
  }'

2. Assinar localmente e gerar o DANFCE imediatamente

Chame o endpoint /build com {"sign": true}. A API assina o XML usando o certificado A1 da empresa, calcula a chave de acesso em contingência (com tpEmis = 9), gera o hash do QR Code offline com o CSC e disponibiliza o PDF do DANFCE:

curl --request POST \
  --url https://fiscal.contora.com.br/api/v1/nfe/drafts/{draft_id}/build \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"sign": true}'

Baixe o PDF imediatamente pelo endpoint de artefatos para impressão no cupom fiscal:

curl --request GET \
  --url https://fiscal.contora.com.br/api/v1/nfe/drafts/{draft_id}/artifacts/pdf_danfe \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --output cupom-nfce.pdf

3. Transmissão manual sob demanda (opcional)

Se o PDV quiser forçar a autorização imediatamente assim que a conexão retornar:

curl --request POST \
  --url https://fiscal.contora.com.br/api/v1/nfe/drafts/{draft_id}/dispatch \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"action": "authorize"}'

Build, autorização e artefatos

1. Crie o rascunho com document_type=nfce.
2. Opcionalmente use /build com {"sign": false} para validar o XML sem transmitir.
3. Envie {"action": "authorize"} para /dispatch; o worker monta e assina automaticamente quando necessário.
4. Acompanhe /status ou os webhooks até o estado final.
5. Quando autorizada, baixe xml_authorized e pdf_danfe.