RoboFiscalOperação técnica e resolução de problemas
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.
Fatos e fontes
- O Portal NFS-e publica endereços distintos de produção e produção restrita.Fonte: Portal NFS-e: APIs de produção e produção restrita.
- O manual da API nacional descreve validações de DPS no fluxo de emissão.Fonte: Portal NFS-e: manual da API, v1.2.
- Um certificado digital possui titular, validade e condições de uso.Fonte: ITI: perguntas e respostas sobre certificação digital.
- A RFC 6750 exige proteger tokens usados em requisições autenticadas.Fonte: IETF: RFC 6750, proteção de Bearer tokens.
- O contrato público do RoboFiscal descreve emissão, ambientes e cadastro de certificado.Fonte: RoboFiscal: contrato OpenAPI público.
Nesta página
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
- Selecione uma empresa e confirme seu ambiente de testes.
- Cadastre o A1 e conclua a autorização exigida para o fluxo.
- Configure a chave no servidor de testes.
- Use referências de teste estáveis e cadastros apropriados ao ambiente.
- 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.
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
Revisado em · Equipe RoboFiscal. Versão em texto