Resposta rápida
Falha de schema XML quer dizer que o arquivo da nota (o XML) não segue o desenho que a Sefaz exige, chamado de leiaute ou schema (XSD). Pode faltar um campo, ter valor no formato errado, texto longo demais ou caractere proibido. Nesse caso a Sefaz recusa a nota antes de olhar as regras fiscais. Primeiro consulte a chave para ver se a nota já foi autorizada. Se não foi, ache o campo com problema, corrija o cadastro e emita de novo.
Antes de tudo: a sua nota foi autorizada?
Às vezes o sistema mostra “rejeitada”, mas a Sefaz já autorizou a nota. Isso acontece, por exemplo, quando a resposta se perde no caminho. Emitir outra nota nessa hora pode gerar venda em duplicidade.
Faça assim:
- Pegue a chave de acesso da nota (são 44 números).
- Consulte a nota no portal da Sefaz do seu estado. Se precisar, peça ajuda ao suporte.
- Se aparecer como autorizada (cStat 100, “Autorizado o uso da NF-e”), não emita outra. Reimprima o documento.
- Se a nota não existir ou estiver rejeitada, siga a correção abaixo.
Dúvida sobre numeração pulada ou inutilização? Prazos e regras dependem do estado. Confirme com o seu contador.
O que a mensagem quer dizer
- Rejeição 215: “Falha no schema XML” da nota.
- Rejeição 225: “Falha no Schema XML do lote de NFe”.
- Falha de schema: a nota quebrou o formato. Isso é diferente de uma rejeição de regra de negócio, em que o formato está certo, mas algo fiscal não bate (NCM inexistente ou CFOP incompatível, por exemplo).
Os códigos e textos oficiais estão no Manual de Orientação do Contribuinte e nas Notas Técnicas da NF-e. Confira a versão vigente no Portal Nacional da NF-e, pois o leiaute muda com o tempo.
Dores do lojista e como resolver
| Dor | Como resolver |
|---|---|
| Cliente esperando no balcão | Veja se a nota foi autorizada. Se não foi, corrija o cadastro e emita de novo. Se não resolver rápido, chame o suporte. |
| A mensagem não diz o campo | Leia o texto completo do retorno. Ele costuma citar a tag. Se não citar, use o diagnóstico por sintoma abaixo. |
| Medo de duplicar a nota | Consulte pela chave antes de emitir de novo. |
| Medo de perder a numeração | Numeração pulada tem regra própria. Confirme com o contador. |
| Cadastro com muitos produtos | Comece pelo produto da venda que falhou. Depois revise os campos fiscais dos demais. |
| O erro voltou depois de uma atualização | Pode ser mudança de leiaute ou nova Nota Técnica. Peça ao suporte para conferir a versão. |
| Linguagem técnica | Conte ao suporte o que aconteceu. Você não precisa saber XML. |
Diagnóstico por sintoma
Pergunte primeiro: quando o erro aparece?
- Só com um produto: o problema está no cadastro desse produto (NCM, CEST, CFOP, CST/CSOSN, unidade, descrição).
- Só com um cliente: o problema está no cadastro do cliente (CPF/CNPJ, endereço, bairro, município, CEP, inscrição estadual).
- Só na NF-e com frete: confira os dados da transportadora e o tipo de frete.
- Com todas as vendas: olhe o cadastro da empresa (CNPJ, inscrição estadual, regime, endereço, município) e o certificado digital.
- Começou depois de uma atualização ou mudança de regra: pode ser leiaute novo. Chame o suporte.
- Só às vezes, sem mudar nada: pode ser instabilidade ou resposta perdida. Consulte a chave antes de qualquer coisa.
Causas comuns: campo, erro e correção
Os tamanhos máximos e as listas permitidas estão no Manual de Orientação do Contribuinte. Veja o essencial:
| Campo | O que costuma dar errado | Errado | Certo |
|---|---|---|---|
| CNPJ/CPF | Pontuação ou dígito faltando | 12.345.678/0001-90 | só números, completos |
| CEP e telefone | Letras, traços ou tamanho fora do padrão | (11) 9999-9999 | só números, com DDD |
| Inscrição estadual | Formato inválido, ou campo vazio quando é obrigatório | texto livre | número da IE ou a indicação correta para isento |
| Município | Nome digitado em vez do cadastro oficial | nome com erro | município escolhido da lista oficial (código IBGE) |
| Descrição do produto | Caractere proibido, espaço no começo ou no fim, texto longo | ” CAMISETA “ | “CAMISETA” |
| NCM | Número incompleto ou com letras | 6109 | 8 dígitos |
| CEST | Faltando quando o produto exige | em branco | código do produto, se aplicável |
| CFOP | Fora do padrão de 4 números | 51 | 4 dígitos, como 5102 |
| CST/CSOSN | Valor que não existe na lista | código inventado | um da lista oficial do seu regime |
| Valores e quantidades | Mais casas decimais do que o leiaute aceita | 10,12345678 | dentro do limite do manual |
| Informações complementares | Texto longo demais ou com símbolos proibidos | texto enorme | texto curto |
Regras gerais:
- O XML tem caracteres reservados, como “&” e “<“. Se você colou um texto de outro lugar, apague e digite de novo.
- Muitos campos de texto não aceitam espaço no começo ou no fim, nem quebra de linha.
- Campo obrigatório em branco também causa falha de schema.
Como ler o retorno da Sefaz
O retorno traz o cStat (código), o xMotivo (texto) e, em muitos casos, a tag com problema. Anote o texto inteiro. Ele ajuda o suporte a achar o campo em minutos.
Se você sabe abrir o XML, procure a tag citada e veja o valor. Se não sabe, não tem problema. Mande o texto do retorno e a chave (ou o número da venda) para o suporte.
Cada documento tem seus erros mais comuns
| Documento | Observação |
|---|---|
| NF-e (modelo 55) | Tem mais campos de cliente e frete. Erros de endereço e de transportadora são comuns. |
| NFC-e (modelo 65) | É a nota da venda de balcão. Os erros costumam estar no produto e na empresa. |
| NFS-e (serviço) | Depende do município. Os códigos de erro são outros. Confirme com a prefeitura e o contador. |
| MDF-e e CT-e | Têm leiaute próprio, cada um com seu manual. |
Casos mais raros
- Schema desatualizado: o sistema usa uma versão antiga do leiaute. Quem resolve é o fornecedor do sistema.
- “Rejeitou, mas autorizou”: confirme pela chave. Se estiver autorizada, use essa nota.
- Problema de certificado ou de conexão: pode aparecer como erro de envio. Veja certificado digital para nota fiscal e computador e internet para pdv.
- Homologação e produção: o ambiente de teste pode se comportar de outro modo. Confirme qual ambiente está configurado.
Reforma tributária e campos novos
A reforma traz novos campos de IBS e CBS nos documentos fiscais. Cada mudança de leiaute exige sistema atualizado. As datas e regras de cada fase mudam por Nota Técnica e por estado. Confirme com o seu contador e acompanhe o assunto em reforma tributária.
Passo a passo: venda no balcão com a nota rejeitada por falha de schema
Este exemplo vale para uma loja que vende no Caixa Ágil e emite NFC-e. O nome dos botões pode variar na sua tela.
- Registre a venda no Caixa Ágil: itens, vendedor, cliente (se houver) e forma de pagamento.
- Finalize e veja se a NFC-e foi autorizada. Se aparecer a falha de schema, não repita a venda.
- Leia a mensagem inteira e anote o código (215 ou 225) e o texto.
- Consulte a nota pela chave no portal da Sefaz. Se estiver autorizada, reimprima o cupom e pronto.
- Se não estiver autorizada, veja o produto: abra o cadastro de cada item da venda e confira NCM, CEST, CFOP, CST/CSOSN, unidade e descrição.
- Veja o cliente (se foi informado): CPF/CNPJ, endereço, bairro, município e CEP.
- Veja a empresa: CNPJ, inscrição estadual, regime, endereço, CSC e certificado digital.
- Corrija o campo e salve.
- Emita de novo pelo caminho que o sistema oferece para a venda.
- Se o erro continuar, chame o suporte do ERPPro e envie as informações da lista abaixo.
O que enviar ao suporte ou ao contador
- Número da venda ou do pedido, com data e hora.
- Chave de acesso, se existir.
- Código e texto completo do retorno (print da tela).
- Qual produto ou cliente estava na venda.
- Se o erro acontece com outros itens também.
- Se algo mudou antes (atualização, cadastro novo, troca de certificado).
Como evitar que o erro volte
- Cadastre os produtos com os dados fiscais completos desde o início. Veja o que é NCM e como funciona o CFOP 5102.
- Digite descrições simples, sem símbolos e sem espaço sobrando.
- Mantenha o certificado digital dentro da validade.
- Revise o cadastro da empresa quando houver mudança de endereço, regime ou inscrição.
- Peça ao contador para revisar os dados fiscais dos produtos que mais vendem.
- Depois de mudanças fiscais, faça uma venda de teste antes do movimento.
O que conferir antes de escolher um sistema
- Ele emite NF-e e NFC-e para o seu tipo de loja?
- Os campos fiscais ficam no cadastro do produto (NCM, CEST, CFOP, CST/CSOSN)?
- Existe suporte humano quando a nota falha?
- O sistema é atualizado quando o leiaute muda?
- Dá para consultar e reimprimir a nota?
- Ele está preparado para os campos de IBS e CBS?
- O plano inclui o que você precisa? Veja planos e preços.
Como o ERPPro ajuda
O ERPPro é um sistema na nuvem, feito por uma empresa fundada em 1998, com mais de 8.000 clientes ativos. Diante de uma falha de schema, ele ajuda assim:
- Emissão no caixa: o Caixa Ágil emite a NFC-e quando a loja tem CNPJ, CSC e certificado digital configurados.
- Cadastro fiscal do produto: NCM, CEST, CFOP e CST/CSOSN ficam no cadastro do produto. Assim você acha e corrige o campo com problema.
- Documentos: o sistema emite NF-e, NFC-e e NFS-e (conforme o município), com cancelamento, carta de correção (CC-e) e DANFE. Conheça o emissor de nota fiscal.
- Reimpressão: você pode reimprimir o cupom e enviar o comprovante da NFC-e pelo WhatsApp.
- IBS e CBS: a nota e o cupom têm campos de IBS e CBS, ligados na configuração de tributação.
- Suporte humano com acesso remoto: se o erro persistir, a equipe olha a tela com você.
Se a sua loja vende sem internet, a venda funciona normalmente. A NFC-e, porém, ainda não pode ser emitida sem conexão. Para saber mais sobre emissão no balcão, veja o programa emissor de cupom fiscal.
Perguntas frequentes
O que é falha de schema XML?
É quando o XML da nota não respeita o leiaute (XSD) da Sefaz. Pode ser campo faltando, formato errado, tamanho excedido ou valor fora da lista. A nota é recusada antes das regras fiscais.
Rejeição 225 e falha de schema são a mesma coisa?
São parecidas. A 215 é “Falha no schema XML” e a 225 é “Falha no Schema XML do lote de NFe”. Nos dois casos o problema é o formato do arquivo. Confira o texto na versão atual do manual oficial.
Como descobrir qual campo está errado?
Leia o texto completo do retorno, que muitas vezes cita a tag. Se não citar, use o diagnóstico por sintoma: só um produto, só um cliente, só com frete ou com todas as vendas.
A nota aparece rejeitada, mas a consulta mostra autorizada. E agora?
Use a nota autorizada e não emita outra. Consulte pela chave de acesso para confirmar. Se tiver dúvida, fale com o contador.
Posso emitir de novo várias vezes?
Só depois de consultar a chave e corrigir o campo. Tentar sem corrigir repete o erro e pode causar duplicidade.
Texto com caracteres especiais pode causar a falha?
Pode. Símbolos reservados do XML, espaços no começo ou no fim e quebras de linha em alguns campos podem fazer a nota ser recusada. Digite o texto de novo, de forma simples.
CPF, CNPJ, CEP e telefone com pontos e traços dão erro?
No XML esses campos levam só números. O sistema costuma tratar isso. Se o dado veio de importação ou cópia, confira se está completo e correto.
Cadastro de produto errado pode gerar falha de schema?
Pode. NCM incompleto, CFOP fora do padrão, CST/CSOSN que não existe e unidade vazia são exemplos. Confirme os dados fiscais com o contador.
A reforma tributária pode causar essa falha?
Pode, se o sistema não estiver com o leiaute atual. Novos campos, como IBS e CBS, exigem atualização. Datas e regras dependem de Nota Técnica e do estado, então confirme com o contador.
Problema no certificado digital vira falha de schema?
Em geral, problemas de certificado geram outras mensagens. Mesmo assim, mantenha o certificado dentro da validade e bem configurado.
A falha de schema depende do estado?
O leiaute é nacional, mas cada Sefaz pode ter regras e prazos próprios. Confirme com o contador.
O que fazer se eu não conseguir resolver?
Chame o suporte e envie o código, o texto do retorno, a chave e o item da venda. Se o tema for fiscal (numeração, inutilização, prazo), fale também com o contador.
Quer emitir nota com menos dor de cabeça?
Teste o ERPPro na sua loja e veja como ficam o cadastro fiscal, o Caixa Ágil e a emissão das notas.