# Como testar minha integração sem emitir uma nota fiscal de verdade?

Configure a empresa em um ambiente de testes antes de chamar a emissão pela API do RoboFiscal. Produção gera documento fiscal real. A produção restrita do governo e a simulação local chamada sandbox têm alcances diferentes: a primeira exercita a integração nacional, enquanto a segunda simula o resultado. Na implementação atual da API, uma nova emissão exige certificado A1 cadastrado, inclusive no sandbox.

Revisado em 10 de outubro de 2026 · Equipe RoboFiscal.

## Fatos e fontes

- O Portal NFS-e publica endereços distintos de produção e produção restrita. [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).
- O manual da API nacional descreve validações de DPS no fluxo de emissão. [Portal NFS-e: manual da API, v1.2](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual/manual-contribuintes-emissor-publico-api-sistema-nacional-nfs-e-v1-2-out2025.pdf).
- Um certificado digital possui titular, validade e condições de uso. [ITI: perguntas e respostas sobre certificação digital](https://www.gov.br/iti/pt-br/acesso-a-informacao/perguntas-frequentes/certificacao-digital).
- A RFC 6750 exige proteger tokens usados em requisições autenticadas. [IETF: RFC 6750, proteção de Bearer tokens](https://www.rfc-editor.org/rfc/rfc6750.html).
- O contrato público do RoboFiscal descreve emissão, ambientes e cadastro de certificado. [RoboFiscal: contrato OpenAPI público](https://robofiscal.com.br/app/api/v1/openapi.yaml).

## Qual ambiente serve para qual teste?

Use a simulação local para exercitar o comportamento do seu aplicativo sem presumir validação fiscal pelo governo. Use produção restrita quando precisar verificar a comunicação e os retornos do ambiente nacional de testes. Uma simulação bem-sucedida não comprova que a mesma configuração será aceita em produção.

## Como impedir que um teste use produção por engano?

Confira a configuração da empresa à qual a chave pertence. No RoboFiscal, não basta mudar um texto no corpo da requisição ou inventar uma URL com “sandbox”. Mantenha credenciais e configuração de teste separadas no seu sistema, com uma verificação explícita de ambiente antes de qualquer chamada que altere documentos.

## O que testar antes da primeira emissão real?

Teste autenticação, cadastro de tomador, campos inválidos, consulta de status, reenvio da mesma referência e recepção de eventos. Inclua falhas de conexão e arquivos temporariamente indisponíveis. Ao concluir, faça uma revisão consciente da configuração que será usada em produção; dados fictícios não devem seguir para a operação fiscal real.

Ambiente | O que representa
--- | ---
sandbox | Simulação local; não comprova validação nacional
producao_restrita | Ambiente nacional de testes
producao | Emissão fiscal real

## Passo a passo

1. Selecione uma empresa e confirme seu ambiente de testes.
2. Cadastre o A1 e conclua a autorização exigida para o fluxo.
3. Configure a chave no servidor de testes.
4. Use referências de teste estáveis e cadastros apropriados ao ambiente.
5. Valide sucesso, rejeições, reenvios e conciliação.

## Erros comuns

- Achar que a palavra sandbox no JSON muda o ambiente da empresa.
- Tratar uma resposta simulada como homologação completa da integração.

## Como o RoboFiscal ajuda

O RoboFiscal permite exercitar a API e os estados do fluxo em ambientes de teste. Confira a exigência atual de certificado da rota antes de iniciar a integração.

Confira os requisitos do ambiente de teste e a documentação da API antes de criar a conta para configurar sua integração. [Criar conta grátis](https://robofiscal.com.br/app/registrar).

[Consultar a documentação da API](https://robofiscal.com.br/app/api/docs).

## Perguntas relacionadas

### Trocar a URL para /sandbox é suficiente?

Não. Use as rotas documentadas e confira o ambiente configurado para a empresa.

### Um teste em produção pode ser apagado depois?

Uma emissão autorizada em produção é documento fiscal real. Eventual correção depende de procedimento fiscal aplicável.

## Continue lendo

- [Como integrar a emissão de NFS-e ao seu sistema por API?](https://robofiscal.com.br/api-nfs-e.html)
- [Como receber e validar webhooks de NFS-e?](https://robofiscal.com.br/docs/webhooks-nfse/)
- [Como evitar NFS-e duplicada ao reenviar uma requisição?](https://robofiscal.com.br/docs/evitar-nfse-duplicada/)

Página: https://robofiscal.com.br/docs/testar-api-nfse/