Toda Nota Fiscal Eletrônica é transmitida para a SEFAZ em um formato digital chamado XML, que é basicamente um “arquivo de dados estruturado”.
Esse arquivo segue um padrão técnico definido pelo governo, conhecido como schema (ou XSD), que funciona como um modelo de referência: ele dita quais campos devem existir, em que ordem, e quais valores são válidos em cada um deles.
Quando ocorre uma “falha no schema”, significa que o arquivo XML gerado pelo sistema não está exatamente no formato exigido pela SEFAZ.
Em outras palavras: a estrutura ou o conteúdo do arquivo não bate com o modelo oficial
Esse tipo de erro é puramente estrutural, ou seja, a SEFAZ nem chega a analisar as informações fiscais da nota, porque o arquivo é rejeitado antes mesmo da validação do conteúdo.
A seguir citaremos as rejeições mas comuns e como corrigi-las.
Como validar
No modulo de vendas, localize a nota com erro, clique com o botão direito sobre ela e localize a opção colunas
No menu que abrir na lateral direita, habilite a coluna XML
Habilitada a coluna, clique sobre a nota com erro e utilizando a tecla de navegação da direita localize a coluna XML e clique duas vezes sobre o campo. Na mensagem Validar Schema, clique em Sim.
Você será direcionado para página do portal da NF-e do RS, clique com o botão direito no campo “Conteúdo da mensagem a ser validada” e vá na opção colar.
Em seguida clique em Validar e o portal da NFE vai retornar com a mensagem de erro.
pDevol
O campo pDevol (percentual de devolução) faz parte do grupo de informações de devolução de mercadoria (<retTrib> ou <impostoDevol>).
O correto seria um valor menor ou igual a 100, representando a porcentagem da mercadoria devolvida.
Então:
100.0000→ devolução total (100%) ✅50.0000→ devolução parcial de 50% ✅166.67→ inválido, excede o limite permitido ❌
Por isso o schema quebra na validação.
Nesse caso, é preciso conferir a quantidade do produto que aparece na nota de compra original e comparar com a quantidade informada na nota de devolução, para garantir que os valores estejam corretos.
Compra:
Devolução:
É necessário devolver a mesma quantidade para que o percentual de devolução feche em 100%. Ajuste as quantidades e faça novamente o envio.
enderDest
Quando o retorno da SEFAZ indica falha no campo enderDest, quer dizer que há algum problema com as informações do endereço do destinatário no XML.
Dentro desse campo, o sistema registra várias informações obrigatórias, como:
<enderDest>
<xLgr>Rua das Flores</xLgr> ← Logradouro
<nro>123</nro> ← Número
<xBairro>Centro</xBairro> ← Bairro
<cMun>4106902</cMun> ← Código do município (IBGE)
<xMun>Curitiba</xMun> ← Nome do município
<UF>PR</UF> ← Estado
<CEP>80010000</CEP> ← CEP
</enderDest>No retorno acima, a ordem dos campos dentro do endereço do destinatário está incorreta no XML.
O campo <cMun> (código do município) foi inserido antes de <xCpl> (complemento) e <xBairro> (bairro), o que não segue o padrão exigido pela SEFAZ.
Neste caso, precisamos abrir o cadastro do cliente lançado em nota e verificar qual a informação faltante. Conforme o print abaixo, o erro estava no bairro que se encontra em branco.
As informações obrigatórias no cadastro do cliente são:
xLgr – Logradouro (nome da rua, avenida, etc.)
nro – Número do endereço
xBairro – Bairro
xMun – Nome do município
UF – Sigla do estado (exemplo: PR, SP, RS)
CEP – Código postal com 8 dígitos
Lembrando que, no Small, o campo de endereço deve ser preenchido com o número após a vírgula, conforme o exemplo: Rodovia José Carlos Daux Sala 104, 4150.
