# Como testar a emissão de NFS-e na Produção Restrita antes de emitir de verdade?

A Produção Restrita é o ambiente oficial de testes da NFS-e Nacional, com endereços próprios, e a nota autorizada lá não tem valor fiscal. Emita nela uma nota de cada tipo que você usa, com o certificado real da empresa, confira o retorno e só então mude para Produção. Desde 20/10/2026 a Produção Restrita está no leiaute da NT 009, mais novo que o da produção, então uma nota aprovada lá não prova sozinha que o mesmo XML passa na produção. No RoboFiscal, o ambiente é escolhido no cadastro da empresa, e o sistema monta a nota no leiaute de cada um.

Revisado em 30 de outubro de 2026 · Equipe RoboFiscal.

## Fatos e fontes

- O Portal da NFS-e publica endereços separados para a Produção Restrita, identificada como homologação e testes, e para a Produção, tanto da SEFIN Nacional quanto do ADN. [Portal NFS-e: APIs de produção e produção restrita](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/apis-prod-restrita-e-producao).
- A DPS informa o ambiente no campo tpAmb: 1 para Produção e 2 para Homologação. [Portal NFS-e: leiautes e anexos de produção](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual).
- No cronograma oficial, a entrada de 20/10/2026 sobre o reposicionamento dos campos CST e cClassTrib está só na coluna da Produção Restrita. [Portal NFS-e: atualizações e implantações](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/atualizacoes-e-implantacoes).
- O manual do ADN disponibiliza uma documentação interativa na Produção Restrita para testes dos contribuintes. [Portal NFS-e: APIs do ADN para contribuintes](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual/manual-contribuintes-apis-adn-sistema-nacional-nfse.pdf).
- No RoboFiscal, a empresa é configurada em Produção Restrita ou Produção, e as emissões seguem o ambiente escolhido. [RoboFiscal: como testar uma integração de NFS-e](https://robofiscal.com.br/docs/testar-api-nfse/).

## O que a Produção Restrita testa, e o que não testa?

Testa a nota de verdade: a assinatura com o certificado da empresa, a validação do XML pelo esquema e pelas regras da SEFIN e o retorno da NFS-e, com número, XML e chave. Não testa o efeito fiscal: a nota fica no ambiente de testes, não vale como documento e não gera imposto. E, enquanto os leiautes dos dois ambientes forem diferentes, como agora, não garante que o XML da produção esteja certo.

## Por que a Produção Restrita está diferente da produção agora?

Em 20/10/2026 a Produção Restrita passou a exigir o leiaute da NT 009, que muda campos da DPS, como a posição do CST e do cClassTrib e o finNFSe, que passa a ser obrigatório em toda nota. A produção continua no esquema de 09/02/2026, e o cronograma oficial ainda não marcou a data dela. Na prática, a DPS no leiaute antigo é recusada na Produção Restrita, e a do leiaute novo seria recusada na produção. Quem testa hoje precisa montar o XML no leiaute de cada ambiente.

## Que notas emitir no teste?

Uma de cada combinação que você usa de verdade: cada serviço, com o código e o NBS; tomador com CNPJ, com CPF e no exterior, se houver; com e sem retenção; e um cancelamento. Use valor baixo e tomadores que você conheça, como a própria empresa ou um sócio, e anote o retorno de cada nota. Se a nota for recusada, corrija o cadastro e emita de novo até passar.

## Como passar para a produção?

Troque o ambiente da empresa para Produção, confira o certificado e emita a primeira nota real conferindo o resultado. As notas de teste não passam para a produção, e a numeração da NFS-e é própria de cada ambiente. No RoboFiscal, a sequência da DPS é uma só por empresa: as notas de teste usam números dela, e a primeira nota de produção continua a contagem.

Ambiente | Para que serve | Valor fiscal
--- | --- | ---
Produção Restrita | Testar emissão, cancelamento e retorno no ambiente oficial | Não
Produção | Emitir as notas de verdade | Sim
Sandbox do RoboFiscal (só pela API) | Testar a integração sem chamar o ambiente nacional | Não, e não passa pela validação da SEFIN

## Passo a passo

1. No cadastro da empresa, escolha o ambiente Produção Restrita.
2. Cadastre o certificado A1 da empresa, o mesmo que será usado na produção.
3. Emita uma nota de cada combinação que você usa, com valor baixo.
4. Confira o retorno: número da NFS-e, XML e PDF, ou a mensagem de rejeição.
5. Corrija o cadastro e repita até todas passarem; teste também um cancelamento.
6. Mude o ambiente para Produção e acompanhe a primeira nota real.

## Erros comuns

- Esquecer a empresa em Produção Restrita e achar que emitiu de verdade: a nota de teste não vale e precisa ser emitida de novo em Produção.
- Mandar ao cliente o PDF de uma nota de teste: ele não tem valor fiscal.
- Concluir que a produção vai aceitar porque a Produção Restrita aceitou: hoje os leiautes são diferentes.

## Como o RoboFiscal ajuda

O RoboFiscal resolve o teste e a passagem para a produção sem você mexer em XML. O ambiente é um campo no cadastro da empresa, o certificado é o mesmo, e o sistema monta a DPS no leiaute de cada ambiente: o da NT 009 na Produção Restrita e o atual na produção, acompanhando o cronograma oficial para fazer a troca quando a produção virar. O cadastro mostra, ao lado do campo, se a nota terá valor fiscal, e a escolha vale para todas as emissões da empresa, pelo painel, pela API, em lote ou agendadas.

Crie a conta, cadastre a empresa em Produção Restrita e emita a primeira nota de teste. [Criar conta grátis](https://robofiscal.com.br/app/registrar).

[Ver como testar a integração por API](https://robofiscal.com.br/docs/testar-api-nfse/).

## Perguntas relacionadas

### Preciso de outro certificado para testar?

Não. A Produção Restrita usa o certificado A1 da empresa, o mesmo da produção.

### A nota de teste aparece para o meu cliente?

Não como nota fiscal: ela fica no ambiente de testes e não tem valor. Não envie o PDF de teste ao cliente.

## Continue lendo

- [Como testar uma integração de NFS-e antes de emitir notas reais?](https://robofiscal.com.br/docs/testar-api-nfse/)
- [NFS-e rejeitada: como identificar o motivo e corrigir?](https://robofiscal.com.br/docs/nfse-rejeitada/)
- [Qual certificado digital é necessário para usar o RoboFiscal?](https://robofiscal.com.br/docs/certificado-a1-nfse/)

Página: https://robofiscal.com.br/nfse-producao-restrita/