Começando

Ambientes

Homologação e Produção são ambientes completamente isolados -- dados diferentes, chaves diferentes, e em documentos fiscais (NF-e/NFC-e/CT-e/MDF-e/NFS-e) a própria SEFAZ/prefeitura trata a transmissão como um teste sem validade fiscal quando o ambiente é homologação.

Ambiente	Uso	Validade fiscal	Custo
Homologação	Desenvolvimento e testes automatizados	Nenhuma -- documentos não têm efeito legal	Gratuito, sem limite de chamadas de teste
Produção	Documentos fiscais reais, com efeito legal	Total	Conforme seu contrato

Como o ambiente é determinado

O ambiente não é um parâmetro no corpo da requisição -- ele é definido pela própria API key usada. Cada contrato pode ter uma chave de homologação e uma chave de produção simultaneamente; a chamada usa o ambiente da chave enviada em Authorization.

✅

Recomendação: sempre valide sua integração inteira em homologação -- inclusive cancelamento e webhooks -- antes de trocar pela chave de produção. Nenhum dado de homologação migra automaticamente para produção.

Certificado digital por ambiente

O certificado A1 do seu cliente final é o mesmo nos dois ambientes (é o certificado real da empresa) -- o que muda é o webservice de destino (homologação ou produção da SEFAZ/prefeitura/ADN), resolvido automaticamente pela CentralFiscal a partir da API key.