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

> O que são os ambientes de homologação e produção na NFS-e e na NFC-e, o que muda na nota de teste, a Produção Restrita do padrão nacional e como separar testes no seu sistema.

Fonte: https://sendnf.com/blog/homologacao-e-producao-nota-fiscal/ · Publicado: 2026-09-14 · SendNF

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](/blog/csc-nfce-como-gerar/).
- 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:

| Chave | Ambiente | Conta no plano? |
|---|---|---|
| `nt_test_…` | Homologação / Produção Restrita | Não, é ilimitada |
| `nt_live_…` | Produção | Sim |

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](/pre-emissao/) 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.

## Perguntas frequentes

### O que é ambiente de homologação na nota fiscal?

É o ambiente de testes dos sistemas fiscais. As notas emitidas nele seguem as mesmas regras de validação, mas não têm valor fiscal. Serve para testar sistemas e integrações.

### Nota emitida em homologação vale?

Não. Ela não tem valor fiscal, não conta para impostos e traz a marcação de documento sem valor fiscal.

### O que é Produção Restrita?

É o nome do ambiente de testes do Sistema Nacional da NFS-e. Funciona como homologação: valida tudo, mas as notas não têm valor fiscal.

### Preciso de certificado para testar em homologação?

Sim, os ambientes de teste também exigem certificado digital para assinar e conectar. O que muda é que as notas não valem.

### Notas de homologação aparecem para o fisco?

Não como documentos fiscais. Elas existem só no ambiente de testes, não geram imposto e não aparecem nas consultas de produção. Mesmo assim, use dados fictícios ou de clientes que sabem do teste, porque o e-mail com a nota pode ser enviado.