📘 Como ler o leiaute da NF-e (Ele, Pai, Tipo, Ocor. e Tam.)

💡 Para que serve

Toda rejeição da SEFAZ aponta para um campo do leiaute da NF-e, o manual que define cada tag do XML. Saber ler as colunas desse manual ajuda a achar o erro muito mais rápido.

🧭 As colunas, uma a uma

📘 Como ler o leiaute: o que são Ele, Pai, Tipo, Ocor. e Tam.

🧱 Ele — tipo de elemento

  • E elemento: campo que leva um valor. Ex.: <UF>SP</UF>
  • G grupo: não tem valor, só junta outros campos. Ex.: <dest>…</dest>
  • CE elemento de escolha: vai um ou outro. Ex.: no destinatário, CNPJ ou CPF.
  • CG grupo de escolha: entre vários grupos possíveis, vai só um.
  • A atributo: fica dentro da tag. Ex.: <det nItem="1">

📂 Pai — onde o campo mora

É o ID do grupo que envolve o campo. O campo ISUF (E18) tem Pai E01, que é o grupo dest:

<dest>            ← E01 (o Pai)
  <CNPJ>…</CNPJ>
  <ISUF>12345678</ISUF>  ← E18
</dest>

🔤 Tipo — o que cabe no campo

  • N numérico: só números, sem letras.
  • C caractere: texto livre.
  • D data. Em branco (—) quando é grupo.

🔁 Ocor. — quantas vezes aparece

Lê-se "mínimo-máximo":

  • 1-1 obrigatório, uma vez só.
  • 0-1 opcional; se vier, uma vez só.
  • 1-990 obrigatório, até 990 vezes (ex.: det, os itens da nota).
  • 0-500 opcional, até 500 vezes (ex.: NFref, as notas referenciadas).

📏 Tam. — tamanho do valor

  • 2 exatamente 2 posições (ex.: UF SP).
  • 1 - 60 de 1 a 60 posições.
  • 13v2 até 13 inteiros e 2 decimais: 1500.00.
  • 3v2-4 até 3 inteiros e de 2 a 4 decimais (ex.: alíquota pICMS = 12.5000).

➖ O tracinho (—)

Quer dizer "não se aplica". Grupo não tem tipo nem tamanho, então essas colunas ficam com —.

🧩 Exemplos reais do leiaute

Os mesmos campos, do jeito que aparecem nas páginas de rejeição. Cada cartão traduz as colunas do manual.

ISUFInscrição na SUFRAMAID E18
destISUF
🧱 Campo com valor🔤 Número🔁 Opcional, uma vez só📏 de 8 a 9 dígitos📂 Fica dentro de dest (E01)
  • Obrigatório, nas operações que se beneficiam de incentivos fiscais existentes nas áreas sob controle da SUFRAMA.
  • A omissão desta informação impede o processamento da operação pelo Sistema de Mercadoria Nacional da SUFRAMA e a liberação da Declaração de Ingresso, prejudicando a comprovação do ingresso / internamento da mercadoria nestas áreas.
finNFeFinalidade de emissão da NF-eID B25
idefinNFe
🧱 Campo com valor🔤 Número🔁 Obrigatório, uma vez só📏 1 dígito📂 Fica dentro de ide (B01)
  • 1NF-e normal
  • 2NF-e complementar
  • 3NF-e de ajuste
  • 4Devolução de mercadoria
  • 5Nota de crédito
  • 6Nota de débito
detDetalhamento de Produtos e ServiçosID H01
det
🧱 Grupo (só agrupa outros campos)🔁 Obrigatório, até 990 vezes📂 Fica dentro de infNFe (A01)

Múltiplas ocorrências (máximo = 990)

NFrefInformação de Documentos Fiscais referenciadosID BA01
ideNFref
🧱 Grupo (só agrupa outros campos)🔁 Opcional, até 500 vezes📂 Fica dentro de ide (B01)

Grupo com informações de Documentos Fiscais

pICMSAlíquota do impostoID N16
pICMS
🧱 Campo com valor🔤 Número🔁 Obrigatório, uma vez só📏 até 3 inteiros e de 2 a 4 decimais
📑 Os mesmos campos como estão no manual (tabela)
#IDCampoDescriçãoElePaiTipoOcor.Tam.Observação
29 B25 finNFe Finalidade de emissão da NF-e E B01 N 1-1 1 1=NF-e normal; 2=NF-e complementar; 3=NF-e de ajuste; 4=Devolução de mercadoria. 5=Nota de crédito; 6=Nota de débito.
29x.1 BA01 NFref Informação de Documentos Fiscais referenciados G B01 — 0-500 — Grupo com informações de Documentos Fiscais
79 E18 ISUF Inscrição na SUFRAMA E E01 N 0-1 8 - 9 Obrigatório, nas operações que se beneficiam de incentivos fiscais existentes nas áreas sob controle da SUFRAMA. A omissão desta informação impede o processamento da operação pelo Sistema de Mercadori…
ver tudo
  • Obrigatório, nas operações que se beneficiam de incentivos fiscais existentes nas áreas sob controle da SUFRAMA.
  • A omissão desta informação impede o processamento da operação pelo Sistema de Mercadoria Nacional da SUFRAMA e a liberação da Declaração de Ingresso, prejudicando a comprovação do ingresso / internamento da mercadoria nestas áreas.
  • (v2.0)
98 H01 det Detalhamento de Produtos e Serviços G A01 — 1-990 — Múltiplas ocorrências (máximo = 990)
245.58 N16 pICMS Alíquota do imposto E N12.1 N 1-1 3v2-4 (v2.0)

MOC 7.0 – Anexo I, Leiaute e Regras de Validação da NF-e e da NFC-e

👆 Passe o mouse (ou toque) no título de cada coluna para ver o que ela significa.

❓ Dúvidas frequentes

O que significa Ocor. 0-1 no leiaute da NF-e?

Ocorrência 0-1 quer dizer que o campo é opcional e, se for informado, aparece no máximo uma vez. Já 1-1 é obrigatório, uma vez só.

O que é o Pai no leiaute da NF-e?

Pai é o ID do grupo que envolve o campo dentro do XML. O campo ISUF (ID E18), por exemplo, tem Pai E01, que é o grupo dest (destinatário).

O que significa 13v2 no tamanho do campo?

São até 13 dígitos inteiros e 2 casas decimais, como 1500.00. Já 3v2-4 são até 3 inteiros e de 2 a 4 decimais.

O que é Ele E, G, CG e CE no leiaute?

É o tipo de elemento: E é campo com valor, G é grupo que só junta outros campos, CG é grupo de escolha (vai só um entre vários) e CE é campo de escolha (vai este ou outro, como CNPJ ou CPF).

🚦 Agora, na prática

Busque o código da sua rejeição e veja o campo, a regra oficial e como resolver: Rejeições da NF-e.

Fonte: MOC 7.0 – Anexo I, Leiaute e Regras de Validação da NF-e e da NFC-e, atualizado pela NT 2025.002 v1.52.

Esta página ajudou? 💬 Pergunte aos consultores