Arquitetura de Processamento e Ambientes

A NFC-e tem uma arquitetura de processamento mais simples que a da NF-e: todos os processos são síncronos. Entender esse modelo e a separação entre os ambientes é o que evita emitir uma nota com valor fiscal durante um teste.

Modelo de processamento

Modelo Síncrono (único): emissão, cancelamento, inutilização e conciliação financeira são síncronos. A SEFAZ é consultada na mesma requisição e a resposta já traz o resultado final — autorizado ou erro_autorizacao —, sem fila e sem polling, diferente da NF-e, a NFC-e não devolve processando_autorizacao
Contingência offline: quando a SEFAZ está indisponível, a emissão continua com forma_emissao=offline. A nota é autorizada localmente e a efetivação na SEFAZ ocorre depois — acompanhe pelos campos contingencia_offline e contingencia_offline_efetivada na resposta.
Webhooks (opcional): mesmo com resposta síncrona, você pode cadastrar webhooks para receber notificações de mudança de status e centralizar o tratamento dos retornos no seu sistema.

📘
Síncrono não quer dizer "sem conferência"
A resposta já vem com o status final, mas sempre leia status, status_sefaz e mensagem_sefaz: uma rejeição (erro_autorizacao) chega na mesma requisição e precisa ser tratada antes de entregar o cupom ao consumidor.

Ambientes

A API oferece dois ambientes. A autenticação ocorre com basic auth, mas com tokens específicos em cada ambiente; além disso, muda a URL base e o efeito fiscal das operações.

Ambiente de Homologação: espelho de testes sem validade jurídica. Use-o para validar regras de schema e integrações antes do go-live. Os cupons emitidos ali não têm validade fiscal nem tributária.
Ambiente de Produção: transmissão oficial, com valor fiscal e jurídico. Use-o somente quando estiver pronto para operar com notas válidas em nome dos seus clientes ou da sua empresa.

📘
Pré-requisito de produção: o CSC
Antes da primeira emissão em produção, a empresa precisa ter o Código de Segurança do Contribuinte (CSC) configurado. Sem ele, a emissão falha com Código CSC não configurado.

Fonte: documentação de referência da API de NFC-e e página "Ambiente" da Focus NFe (v2.0).