tpAjuste
Tipo de ajuste a ser aplicado ao item
Onde fica no arquivo
No documento
-
NF3e/infNF3e/NFdet/det/gAjusteNF3eAnt/tpAjuste
Obrigatório, uma vez
-
nf3eProc/NF3e/infNF3e/NFdet/det/gAjusteNF3eAnt/tpAjuste
Obrigatório, uma vez
O caminho até aqui, nível a nível
- NF3e — Nota Fiscal Eletrônica de Energia Elétrica
- └ infNF3e — Informações da NF3e
- └ NFdet — Detalhamento de Produtos e Serviços
- └ det — Detalhamento de Produtos e Serviços
- └ gAjusteNF3eAnt — Grupo de identificação do ajuste do item de NF3e anterior
- └ tpAjuste — você está aqui
Dentro do grupo gAjusteNF3eAnt , grupo de identificação do ajuste do item de NF3e anterior
O que o arquivo aceita neste campo
- Ocorrência
- 1-1
- Tamanho
- 1
- Tipo no esquema
- TAjusteNF3eAnt
- Formato base
- string
Valores aceitos — 4
- 1
- 2
- 3
- 4
Lista fechada do esquema oficial: qualquer outro valor é recusado na validação do arquivo.
As regras que verificam este campo — 3
O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.
Se tipo de ajuste a ser aplicado ao item (tag: tpAjuste) igual a 1 (Item a ser substituído) ou 3 (item a ser eliminado) deve ser informado o grupo de informações referentes ao item da NF3-e anterior (grupo: detItemAnt)
Mensagem: Detalhamento do item da NF3e anterior deve ser informado para tipos de ajuste 1 e 3
Se tipo de ajuste a ser aplicado ao item (tag: tpAjuste) diferente de 1 (Item a ser substituído) ou 3 (item a ser eliminado) não deve ser informado o grupo de informações referentes a item da NF3-e anterior (grupo: detItemAnt)
Mensagem: Detalhamento do item da NF3e anterior não deve ser informado para tipos de ajuste 2 e 4
Se tipo de ajuste a ser aplicado ao item (tag: tpAjuste) igual 1 (Item a ser substituído), o próximo item (tag: det/nItem) deve ser do tipo de ajuste (tag: tpAjuste) igual a 2 (Item de substituição)
Mensagem: Após um item com tipo de ajuste igual a 1 deve sempre ser informado um item com tipo de ajuste igual a 2
Campos do mesmo grupo — 1
São os campos que ficam ao lado deste no arquivo, dentro de NF3e/infNF3e/NFdet/det/gAjusteNF3eAnt. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo tpAjuste da NF3e?
Tipo de ajuste a ser aplicado ao item No XML ele fica em NF3e/infNF3e/NFdet/det/gAjusteNF3eAnt/tpAjuste. Obrigatório, uma vez, com tamanho 1.
tpAjuste aparece em quantos lugares da NF3e?
Em 2 posições do esquema oficial: NF3e/infNF3e/NFdet/det/gAjusteNF3eAnt/tpAjuste, nf3eProc/NF3e/infNF3e/NFdet/det/gAjusteNF3eAnt/tpAjuste. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.
Quais valores tpAjuste aceita na NF3e?
O esquema oficial restringe a 4 valores: 1, 2, 3, 4. Qualquer outro valor é recusado já na validação do arquivo, antes de qualquer regra de negócio.
Que rejeição tpAjuste pode causar na NF3e?
3 regras do manual citam este campo, disparando os códigos 258, 259, 260. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.
De onde vem esta descrição da NF3e?
Do esquema XML oficial (PL_NF3E_1.00a_NT2026.004_RTC_1.00). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.