📚 Documentação do Usuário - Validador Fiscal

Versão: 1.0.2.4

O que é esta aplicação

O Validador Fiscal ajuda a conferir documentos fiscais antes do envio ou da geração de arquivos finais.

Ele trabalha com:

• NF-e
• NFC-e
• CT-e
• CT-e OS
• NFS-e Nacional

Na prática, a aplicação faz três coisas:

• lê o arquivo que você enviou;
• valida a estrutura e as regras do documento;
• oferece ações extras quando o documento permite, como RTC, base da NFS-e e DANFSe.

Como usar a interface web

Passo 1. Abrir a tela do validador

Abra a interface web no navegador.

Passo 2. Colar ou enviar o arquivo

Você pode:

• colar o XML ou JSON no editor;
• clicar em Arquivo para enviar o arquivo;
• arrastar o arquivo para a área de edição.

Na interface principal, o uso esperado é com XML e JSON.

Passo 3. Conferir o tipo detectado

A aplicação identifica o tipo do conteúdo e mostra isso na tela.

Se o arquivo for:

• NF-e ou NFC-e, a validação segue o pacote de schema escolhido;
• CT-e ou CT-e OS, a validação usa o schema de transporte;
• NFS-e Nacional, a aplicação reconhece NFSe ou DPS e muda o fluxo para os recursos de NFS-e.

Passo 4. Escolher o schema, quando necessário

Use o seletor de schema para definir o pacote correto:

• PL_010c, PL_010b ou PL_009q para NF-e e NFC-e;
• PL_CTe_400 para CT-e e CT-e OS.

Para NFS-e Nacional, a detecção é automática.

Passo 5. Validar

Clique em Validar Documento.

A aplicação mostra o resultado em blocos separados:

• Rejeições: impedem o uso do documento;
• Alertas: avisos que não bloqueiam o processo;
• Validações: resumo técnico do que foi conferido.

Passo 6. Usar as ações extras

Dependendo do tipo de documento, aparecem botões adicionais.

• Gerar RTC: disponível para NF-e e NFC-e quando a aplicação consegue calcular os campos da Reforma Tributária.
• Base NFS-e: calcula a base da NFS-e Nacional.
• DANFSe: gera o impresso auxiliar da NFS-e Nacional.

Para essas ações funcionarem, o documento precisa trazer os campos mínimos de cálculo:

• RTC em NF-e/NFC-e: item com valor, CST, cClassTrib, NCM ou NBS, município do fato gerador e data/hora do fato gerador.
• NFS-e Nacional: documento NFSe ou DPS, valor do serviço, prestador identificado, competência e dados do serviço prestado.

Passo 7. Validar de novo e baixar

Se a aplicação alterar o XML:

• valide novamente;
• confira se as rejeições sumiram;
• use Baixar XML para salvar a versão final.

Como cada documento funciona

NF-e e NFC-e

O fluxo mais comum é:

1. enviar o XML;
2. validar;
3. usar Gerar RTC se houver dados suficientes;
4. validar de novo;
5. baixar o XML final.

Se a Calculadora SEFAZ estiver fora do ar, a validação principal continua, mas a parte de RTC aparece como indisponível.

CT-e e CT-e OS

O foco aqui é a validação do conteúdo e do schema.

Se houver erro, a aplicação mostra a mensagem e você precisa ajustar o XML de origem.

NFS-e Nacional

O fluxo da NFS-e é diferente dos demais:

1. envie um XML de NFSe ou DPS;
2. valide o documento;
3. use Base NFS-e para consultar a base de cálculo;
4. use DANFSe para gerar o impresso auxiliar;
5. valide novamente se houver alterações;
6. baixe o XML, se necessário.

Se faltar informação mínima de cálculo, a aplicação ainda pode validar a estrutura, mas não conseguirá concluir a base da NFS-e.

O que você precisa preencher

Para NF-e e NFC-e

• emitente;
• destinatário;
• itens;
• valores corretos;
• códigos fiscais e tributários.

Para CT-e e CT-e OS

• tomador;
• prestador;
• cargas e valores;
• dados de emissão e transporte.

Para NFS-e Nacional

• prestador;
• tomador, quando houver;
• serviço prestado;
• competência;
• valores do serviço;
• campos do NFSe ou da DPS na ordem correta.

Resultado da validação

Quando o documento passa, a tela mostra sucesso.

Quando há problema, a aplicação organiza a saída em:

• rejeições;
• alertas;
• validações técnicas.

Isso ajuda você a saber se o arquivo precisa apenas de ajuste simples ou se há erro que bloqueia a emissão.

Dicas práticas

1. Corrija primeiro a rejeição mais grave.
2. Depois valide novamente.
3. Se o documento for NF-e ou NFC-e, só use Gerar RTC quando os dados mínimos estiverem preenchidos.
4. Se o documento for NFS-e Nacional, use Base NFS-e antes de gerar o DANFSe.
5. Quando a calculadora externa não responder, a parte principal de validação continua funcionando.

Perguntas rápidas

Posso usar a aplicação com arquivo já assinado?

Sim. A validação lê o XML como ele está.

A aplicação transmite para a SEFAZ?

Não. Ela valida, organiza e auxilia na preparação do arquivo.

Preciso saber XML para usar?

Não necessariamente. A tela aceita colar o conteúdo e mostra os erros de forma legível.

O NFS-e Nacional funciona no mesmo lugar que NF-e e NFC-e?

Sim. A interface reúne os documentos no mesmo ambiente, mas os botões e validações mudam conforme o tipo do arquivo.

Resumo final

• NF-e/NFC-e: validar e, se possível, gerar RTC.
• CT-e/CT-e OS: validar o XML e corrigir as rejeições.
• NFS-e Nacional: validar, calcular base e gerar o DANFSe.