RoboFiscalOperação técnica e resolução de problemas
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.
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.Fonte: Portal NFS-e: APIs de produção e produção restrita.
- A DPS informa o ambiente no campo tpAmb: 1 para Produção e 2 para Homologação.Fonte: Portal NFS-e: leiautes e anexos de produção.
- 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.Fonte: Portal NFS-e: atualizações e implantações.
- O manual do ADN disponibiliza uma documentação interativa na Produção Restrita para testes dos contribuintes.Fonte: Portal NFS-e: APIs do ADN para contribuintes.
- No RoboFiscal, a empresa é configurada em Produção Restrita ou Produção, e as emissões seguem o ambiente escolhido.Fonte: RoboFiscal: como testar uma integração de NFS-e.
Nesta página
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
- No cadastro da empresa, escolha o ambiente Produção Restrita.
- Cadastre o certificado A1 da empresa, o mesmo que será usado na produção.
- Emita uma nota de cada combinação que você usa, com valor baixo.
- Confira o retorno: número da NFS-e, XML e PDF, ou a mensagem de rejeição.
- Corrija o cadastro e repita até todas passarem; teste também um cancelamento.
- 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.
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
Revisado em · Equipe RoboFiscal. Versão em texto