RoboFiscalOperação técnica e resolução de problemas
Minha nota de serviço foi rejeitada. Como descubro o que corrigir?
Para corrigir uma NFS-e rejeitada, leia o código e a mensagem da tentativa, identifique o campo ou requisito indicado e confira os dados da operação. Corrija a causa antes de reenviar. Rejeição de conteúdo, impedimento de cadastro e falha de comunicação pedem tratamentos diferentes. Se o resultado estiver incerto, consulte a nota antes de iniciar outra emissão.
Fatos e fontes
- A API nacional aplica regras de negócio à DPS e retorna o motivo quando a validação falha.Fonte: Portal NFS-e: manual da API, v1.2.
- Os leiautes e anexos oficiais descrevem campos e regras usados na validação.Fonte: Portal NFS-e: leiautes e anexos de produção.
- A classificação do serviço deve corresponder à atividade prevista na legislação aplicável.Fonte: Planalto: Lei Complementar 116/2003.
- Certificados digitais têm titularidade e validade que precisam ser conferidas.Fonte: ITI: perguntas e respostas sobre certificação digital.
- O RoboFiscal permite consultar a situação da nota e acompanhar rejeições por API e eventos.Fonte: RoboFiscal: contrato OpenAPI público.
Nesta página
Por onde começar a investigação?
Guarde horário, identificador da operação e mensagem completa. Confira a empresa e o ambiente selecionados. Procure o dado citado no erro: documento do tomador, código de serviço, tributação, certificado ou habilitação, por exemplo. Corrigir todos os campos ao mesmo tempo torna mais difícil saber qual mudança resolveu a causa.
E se o campo parece correto?
Compare o valor enviado, não apenas o que aparece no cadastro atual. Uma integração pode ter usado informação antiga ou omitido um campo. Confira a versão da documentação aplicável e os parâmetros do município. Se o erro estiver ligado a enquadramento fiscal, peça a confirmação da contabilidade antes de alterar a tributação.
Quando acionar suporte?
Acione o suporte quando o retorno não permitir identificar a causa ou houver divergência entre envio e tela. Informe CNPJ, ambiente, horário, referência e código do erro. Envie apenas os trechos necessários, ocultando senha do certificado, chave de API e dados pessoais que não ajudem no diagnóstico.
| Tipo de problema | Próxima conferência |
|---|---|
| Campo inválido | Valor efetivamente enviado e regra do leiaute |
| Cadastro ou habilitação | CNPJ, município e canal permitido |
| Certificado | Titular, validade e autorização |
| Conexão ou timeout | Situação da operação antes de novo envio |
Passo a passo
- Copie o código e a mensagem da tentativa.
- Confira empresa, ambiente e status atual.
- Identifique o campo ou requisito apontado.
- Corrija a origem do dado e revise a operação.
- Reprocesse conforme o status e confirme a autorização.
Erros comuns
- Repetir o mesmo conteúdo rejeitado sem corrigir a causa.
- Zerar tributos ou trocar códigos aleatoriamente para tentar passar pela validação.
Como o RoboFiscal ajuda
O RoboFiscal apresenta o resultado das emissões e disponibiliza consultas e eventos. Para um problema em uma conta existente, reúna as evidências da tentativa e use o suporte antes de criar outro fluxo de emissão.
Já tem conta e precisa de ajuda? Fale com o atendimento com os identificadores da operação e a mensagem recebida.
Quem já usa o produto deve começar pelo diagnóstico da rejeição. O cadastro é o próximo passo para quem busca um emissor para novas operações.
Perguntas relacionadas
Rejeição significa que o cliente não pagou?
Não. O retorno fiscal trata a emissão do documento; o pagamento deve ser conferido no sistema financeiro.
Toda mensagem de erro significa que nenhuma nota existe?
Não. Falhas de comunicação podem deixar o resultado incerto. Consulte a operação antes de repetir.
Continue lendo
Revisado em · Equipe RoboFiscal. Versão em texto