Analisando o arquivo XML da NF-e

Atualizado em15 de agosto de 2024

O que é um XML?

Um arquivo XML (eXtensible Markup Language) é um formato de arquivo que define um conjunto de regras para codificar documentos em um formato que é tanto legível por humanos quanto por máquinas. Ele é amplamente utilizado para armazenar e transportar dados de forma estruturada. Aqui estão alguns pontos chave:

Estrutura Hierárquica: os dados são organizados em uma estrutura de árvore com elementos aninhados;
Flexibilidade: permite a criação de tags personalizadas para descrever os dados.;
Interoperabilidade: facilita a troca de dados entre diferentes sistemas e plataformas.

Qual é o conteúdo de um XML de NF-e?

Vamos agrupar pelo conjunto de tags e seus respectivos conteúdos:

NFE: data e hoa da emissão, modelo, número e série, além do valor total;
emit: Identificação básica (Nome, CNPJ, Razão Social), endereço (Inscrição Estadual, e código do município para cálculo do ICMS);
dest: Identificação básica (Nome, CNPJ, Razão Social), endereço (Inscrição Estadual);
prod: quantidades, valores unitários, e uma breve descrição;
total: Valor dos produtos, frete e seguro, base de cálculo, PIS/COFINS/IPI/ICMS;
transp: dados da transportadora e do veículo e volume transportado;
pag: Forma de pagamento e endereço para cobrança.

Como obter o XML de uma NF-e no Uniplus?

Existem duas formas de se obter o XML de uma NF-e, mas isso vai depender se a nota está autorizada ou não.

Se a nota estiver autorizada

Caso a nota esteja autorizada, você pode salvar o XML dessa nota. No Uniplus Web, acesse a tela de Notas Fiscais de Saída, selecione a nota fiscal e clique em: Opções → Download XML:

Observação: caso a nota não esteja autorizada ou não seja uma NF-e (modelo 55), o sistema irá exibir uma mensagem de erro:

No Uniplus Desktop, na tela de notas fiscais de saída, selecione a nota fiscal e no rodapé do sistema, clique em: NF-e → Salvar arquivo xml da NF-e em disco:

Lembrando que se a nota não estiver autorizada ou não for uma NF-e (modelo 55), o sistema irá apresentar uma mensagem de erro:

Se a nota não estiver autorizada

Caso a nota ainda esteja sendo emitida e você precise analisar o XML, seja para verificar alguma falha de schema ou outra situação específica, será necessário validar o XML da NF-e na Sefaz para se obter o XML.

Estrutura do XML:

Analisando falhas de schema na emissão de NF-e

Uma falha de schema de XML na emissão de NF-e (Nota Fiscal Eletrônica) ocorre quando o arquivo XML não está em conformidade com o layout e as regras definidas pela SEFAZ (Secretaria da Fazenda). Isso pode acontecer por vários motivos, incluindo:

Tags mal formadas: falta de fechamento de tags ou tags incorretas;
Conteúdo Inválido: dados que não seguem o formato esperado, como um CNPJ com menos de 14 dígitos;
Conteúdo Incompleto: campos obrigatórios que não foram preenchidos;
Caracteres Especiais: presença de caracteres especiais não permitidos;
Versão do XML: uso de uma versão de XML diferente da esperada pelo web service da SEFAZ.

DICA: uma ferramenta indispensável para analisar uma falha de schema é o Manual do Contribuinte, nele você tem o detalhamento completo do XML e quais informações devem ser preenchidas em cada tag.

Conteúdo Relacionado

Os artigos listados abaixo estão relacionados ao que você acabou de ler:
• Validar XML na SEFAZ
• Antes de Falar com o Suporte Técnico
• Obtendo suporte técnico e ajuda

	Informações Gerais da (NF-e) O primeiro grupo da nota reúne os principais dados: data emissão, número e série da nota fiscal, tipo, finalidade e outras informações.
	Informações do Emitente Os dados cadastrais (CNPJ, I.E, endereço, entre outros) do Emitente, ou seja, a empresa que está realizando a emissão da nota fiscal eletrônica.
	Informações do Destinatário Os dados cadastrais (CNPJ/CPF, I.E/ou não, endereço, entre outros) do Destinatário, ou seja, os dados para quem está sendo feita a emissão.
	Informações dos produtos e impostos Os dados dos produtos como descrição, código de barras, códigos CFOP, NCM e CEST, quantidades e preços. Também é informado o imposto aplicado na operação.
	Informações dos valores totais Após informados todos os produtos e impostos, a NF-e traz a totalização de cada operação.
	Informações do Transportador e Transporte Caso seja preenchido os campos na emissão da nota, aqui estarão os dados da empresa de transporte além dos dados relacionados.
	Informações do Pagamento Caso seja preenchido os campos na emissão da nota, aqui estarão os dados do pagamento.