Falhas de schema, versão de layout, codificação UTF-8, cabeçalho SOAP e estrutura do XML.
214 - Tamanho da mensagem excedeu o limite estabelecido
O XML excede o tamanho máximo aceito pela SEFAZ (atualmente 500 KB para a maioria dos serviços, 1 MB para o lote).
Como resolver. Reduza informações dispensáveis: campos opcionais vazios, comentários, espaços extras. Em última hipótese, divida em vários documentos.
215 - Tamanho da mensagem excedeu o limite estabelecido
Falha de schema no XML enviado: tag faltando, ordem incorreta, valor fora do tipo esperado ou fora do enumerado da NT.
Como resolver. Valide o XML contra o XSD da versão de layout em uso (4.00 atualmente). Boa parte dos erros aparece no validador antes mesmo de transmitir.
225 - Falha no Schema XML do lote de NFe
Falha de schema no envelope do lote (enviNFe/envEvento).
Como resolver. Valide o envelope contra o XSD do lote, não só os documentos internos. Confirme versao, idLote e a sequência das tags.
238 - Cabeçalho - Versão do arquivo XML superior a Versão vigente
A versão do layout informada no XML é mais nova do que a vigente para a UF.
Como resolver. Use a versão homologada pela SEFAZ destino. Pré-libere camadas de suporte nas datas de virada de NT, mas nunca antes do prazo oficial.
239 - Cabeçalho - Versão do arquivo XML não suportada
A versão do layout informada já não é mais aceita - a SEFAZ encerrou o suporte a ela.
Como resolver. Atualize para a versão atual (4.00). Layouts antigos são desligados nas datas anunciadas pelas NTs.
242 - Cabeçalho - Falha no Schema XML
Falha de schema no cabeçalho SOAP (nfeCabecMsg). Costuma ser cUF ou versaoDados ausentes/inválidos.
Como resolver. Preencha cUF (UF do autorizador) e versaoDados (mesma versão do XML interno) no cabeçalho SOAP.
243 - XML Mal Formado
O XML está mal formado: tag não fechada, caractere ilegal, encoding incorreto.
Como resolver. Gere o XML com uma biblioteca XML adequada e valide antes de enviar. Não monte o XML por concatenação manual de strings.
299 - XML da área de cabeçalho com codificação diferente de UTF-8
O cabeçalho SOAP está em encoding diferente de UTF-8 (latin-1, ISO-8859-1...).
Como resolver. Salve o cabeçalho em UTF-8 sem BOM e declare <?xml version="1.0" encoding="UTF-8"?> no topo.
402 - XML da área de dados com codificação diferente de UTF-8
A área de dados (XML interno) está em encoding diferente de UTF-8.
Como resolver. Reescreva o XML em UTF-8 sem BOM. Acentos e caracteres especiais devem ser representados corretamente.
404 - Uso de prefixo de namespace não permitido
Foi usado prefixo de namespace além do permitido (ex.: ns2:, tns:). A SEFAZ aceita apenas o namespace padrão.
Como resolver. Use apenas o namespace http://www.portalfiscal.inf.br/nfe sem prefixo (ou com prefixo vazio). Remova xmlns:ns adicionais.
411 - Campo versaoDados inexistente no elemento nfeCabecMsg do SOAP Header
O cabeçalho SOAP foi enviado sem versaoDados.
Como resolver. Inclua <versaoDados> no nfeCabecMsg, com a mesma versão do XML interno (ex.: 4.00).
416 - Falha na descompactação da área de dados
A área de dados foi enviada compactada (gzip), mas a SEFAZ não conseguiu descompactar.
Como resolver. Em geral, transmita sem compactação. Se for usar Content-Encoding: gzip, garanta o cabeçalho HTTP correto e teste o gzip antes.
516 - Falha no schema XML – inexiste a tag raiz esperada para a mensagem
A tag raiz esperada (NFe, enviNFe, consSitNFe etc.) não está no XML.
Como resolver. Confirme que a tag raiz corresponde ao serviço chamado e o namespace está declarado nela.
517 - Falha no schema XML – inexiste atributo versao na tag raiz da mensagem
A tag raiz da mensagem está sem o atributo versao.
Como resolver. Adicione versao="4.00" (ou a versão vigente) no elemento raiz.
545 - Falha no schema XML – versão informada na versaoDados do SOAPHeader diverge da versão da mensagem
O versaoDados do cabeçalho SOAP é diferente da versao da mensagem.
Como resolver. Mantenha as duas iguais (ex.: ambos 4.00).
565 - Falha no schema XML – inexiste a tag raiz esperada para o lote de NF-e
A tag raiz do lote (enviNFe) não foi encontrada.
Como resolver. Confirme que a tag raiz é enviNFe (ou envEvento para eventos) com o namespace correto.
567 - Falha no schema XML – versão informada na versaoDados do SOAPHeader diverge da versão do lote de NF-e
O versaoDados do cabeçalho difere da versao do lote.
Como resolver. Use a mesma versão nos dois lugares; geralmente 4.00.
568 - Falha no schema XML – inexiste atributo versao na tag raiz do lote de NF-e
A tag raiz do lote está sem versao.
Como resolver. Acrescente versao="4.00" no <enviNFe>.
587 - Usar somente o namespace padrão da NF-e
Foi usado um namespace diferente do oficial.
Como resolver. Use exclusivamente http://www.portalfiscal.inf.br/nfe. Remova quaisquer outros namespaces declarados na NF-e.
588 - Não é permitida a presença de caracteres de edição no início/fim da mensagem ou entre as tags da mensagem
Há caracteres de edição (quebra de linha, tabulação, espaços extras) entre tags ou no início/fim do XML.
Como resolver. Gere o XML em uma única linha (sem indentação) ou aplique canonicalização C14N antes de assinar.