Homologação e produção na nota fiscal: como testar sem emitir nota de verdade

Os sistemas fiscais têm dois ambientes: produção, onde as notas têm valor fiscal, e homologação, onde as notas passam pelas mesmas validações mas não têm valor fiscal. No Sistema Nacional da NFS-e, o ambiente de testes se chama Produção Restrita; na NFC-e, cada SEFAZ tem o seu ambiente de homologação. Use homologação para testar o cadastro, o certificado, o layout e a integração antes de emitir de verdade. No SendNF, a separação é automática: chaves nt_test_ emitem só em homologação, chaves nt_live_ emitem em produção.

Para que serve a homologação

• Testar a integração do seu sistema sem gerar notas reais nem impostos.
• Validar o cadastro da empresa (certificado, inscrições, códigos) antes do primeiro dia de emissão.
• Reproduzir rejeições e ver como o seu sistema reage.
• Treinar a equipe ou a IA a emitir do jeito certo.

O que muda numa nota de homologação

• O campo de ambiente do XML (tpAmb) indica homologação (valor 2) em vez de produção (valor 1).
• Na NFC-e, a SEFAZ exige textos fixos: o primeiro item e o nome do destinatário são substituídos pela frase de que a nota foi emitida em ambiente de homologação, sem valor fiscal.
• Na NFS-e Nacional, o DANFSe de teste traz a indicação de documento sem validade jurídica.
• O CSC da NFC-e é diferente: o de homologação não vale em produção. Veja CSC da NFC-e.
• Em prefeituras com sistema próprio, alguns provedores têm ambiente de testes de verdade; outros só validam o lote, sem gerar nota. Nesses casos, o SendNF gera um espelho marcado como nota de teste.

Erros comuns na passagem para produção

1. Esquecer de trocar a chave ou o ambiente e descobrir semanas depois que nenhuma nota valeu.
2. Misturar numeração: série e número de testes não devem consumir a numeração de produção. No SendNF, cada ambiente tem os próprios contadores.
3. Usar o CSC de homologação em produção (NFC-e).
4. Certificado de teste: certificados não ICP-Brasil não são aceitos pela Receita nem nos testes.

Como o SendNF separa os ambientes

O modo vem da chave de API:

As notas, os webhooks e as listagens de um modo nunca aparecem no outro. No painel, um seletor Teste/Produção faz o mesmo. Assim, o seu ambiente de desenvolvimento usa uma chave de teste, o de produção usa a chave de produção, e não há como misturar por engano.

Além disso, a pré-emissão não transmite nada em nenhum dos ambientes: ela monta, assina e valida a nota no XSD oficial (ou no provedor da prefeitura) e devolve os problemas. É o teste mais rápido de todos, e não conta no plano.

Um roteiro de testes que funciona

1. Cadastre a empresa e envie o certificado.
2. Pré-emita uma nota com dados reais do seu negócio.
3. Emita em homologação e confira o PDF, o XML e o webhook document.authorized.
4. Force uma rejeição (um código de serviço inexistente, por exemplo) e veja o seu sistema tratar document.rejected.
5. Cancele uma nota de teste e confira document.cancelled.
6. Troque a chave para produção e emita a primeira nota real.

Checklist do primeiro dia em produção

1. Certificado de produção instalado: o mesmo A1 serve para os dois ambientes, mas confira a validade.
2. CSC de produção cadastrado (para NFC-e), com o ID do token correto.
3. Série e numeração definidas: comece a numeração de produção do ponto certo, sem reaproveitar números de teste.
4. Webhook de produção cadastrado com a chave de produção e testado.
5. Primeira nota de valor baixo para um cliente que você conhece, conferindo PDF, XML e o recebimento por e-mail.
6. Alguém de olho nas primeiras notas do dia, para agir rápido se algo for rejeitado.

Por que separar por chave, e não por configuração

Muitos sistemas guardam o ambiente numa configuração da empresa: basta alguém esquecer de mudar para emitir notas de teste no dia do lançamento, ou notas reais durante um teste. Separar pela chave de API resolve isso por desenho: o servidor de desenvolvimento simplesmente não tem a chave de produção.

Resumo

• Homologação valida tudo, mas a nota não vale; produção é a nota de verdade.
• No padrão nacional, o ambiente de testes se chama Produção Restrita.
• NFC-e de teste tem textos obrigatórios e CSC próprio.
• No SendNF, a chave define o ambiente e os modos nunca se misturam.