tpPint na NF-e: tipo de pintura e limite de um caractere
<tpPint>det › prod › veicProd › tpPintRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
tpPint identifica o tipo de pintura do veículo novo. Ele é um campo diferente da cor: xCor descreve a cor, cCor guarda o código da montadora e cCorDENATRAN a codificação nacional. O tipo de pintura exige sua própria identificação documental.
O caminho no XML processado é /nfeProc/NFe/infNFe/det/prod/veicProd/tpPint. Sem o envelope nfeProc, a leitura começa em NFe. O namespace é http://www.portalfiscal.inf.br/nfe; consultas XPath precisam associá-lo a um prefixo.
- Pintura não é a cor do veículo
- O que o XSD realmente valida
- Exemplo somente da forma estrutural
- Como tratar erro ou informação ausente
Pintura não é a cor do veículo
“Prata” é uma descrição de cor e, sozinha, não determina o conteúdo de tpPint. O campo J18 é denominado tipo de pintura no MOC e no XSD; nenhuma dessas duas fontes consultadas apresenta uma tabela completa de códigos e significados materiais para essa tag.
Por isso não há fundamento nessas fontes para afirmar universalmente que 1 corresponde a pintura sólida, metálica ou outro acabamento. Uma tabela de um sistema emissor pode representar seu próprio cadastro e precisa de correspondência documental antes de ser usada no XML. Não transporte a codificação 01–16 de cores nacionais para o tipo de pintura.
O que o XSD realmente valida
O schema 010f usa TString de comprimento exatamente 1. Essa restrição estabelece forma, não uma lista de tipos de pintura. Um caractere que passe no XSD pode continuar desconhecido ou incorreto para a documentação do veículo. Não use a permissividade da string como licença para escolher uma letra ou número qualquer.
A aplicação é restrita ao detalhamento de veículo novo, no grupo veicProd do item. Dentro desse grupo, o campo ocorre uma vez e é obrigatório; a ausência do grupo em uma operação diferente não torna este filho exigível isoladamente. A regra J01-10, mensagem 736, rejeita o grupo em NFC-e e em NF-e com DANFE Simplificado Tipo 2 (tpImp=6). A ampliação consta da NT 2026.002, com produção prevista em 03/08/2026; ela restringe o grupo inteiro, não o conteúdo deste campo.
Confirme o tipo e o código de pintura na informação técnica/cadastral fornecida para o veículo. A origem do código e o mapeamento do emissor precisam ser identificáveis; uma descrição sem correspondência de código é dado ainda insuficiente para concluir o preenchimento.
Exemplo somente da forma estrutural
O elemento sintético abaixo demonstra apenas um caractere no campo:
<tpPint xmlns="http://www.portalfiscal.inf.br/nfe">1</tpPint>
Não se atribui um significado de acabamento ao valor 1 neste exemplo. Ele não é um código padrão recomendado. tpPint aparece depois de anoFab e antes de tpVeic; os outros filhos obrigatórios foram omitidos. O recorte não comprova adequação material nem constitui nota pronta para envio.
Como tratar erro ou informação ausente
Se o XML contém “METÁLICA”, por exemplo, o texto excede o comprimento; não basta cortá-lo para M. Confirme o código correto na documentação de origem e sua correspondência com o gerador. Se contém um dígito, mas não há fonte que explique esse código para o veículo, a passagem pelo XSD não resolve a lacuna.
Compare o chassi, o dado recebido do fornecedor, o cadastro e a saída XML. Se só houver descrição de cor, obtenha a identificação do tipo de pintura separadamente. Não complete com 1 nem reutilize cCor para satisfazer a obrigatoriedade. Corrija somente o mapeamento ou conteúdo comprovadamente divergente; a rejeição 736 trata do uso do grupo por modelo/DANFE e não determina outro acabamento.
Campos relacionados
Fontes oficiais
- MOC 7.0, Anexo I — 7.00, novembro de 2020: p. 22: grupo JA, campo J18 (tpPint); p. 96 J01-10, complementada pela NT 2026.002.
- Schemas XML NF-e, PL_010f_v1.04 — 010f v.1.04, publicado em 31/08/2026: declaração veicProd e seus 24 filhos; escolha exclusiva; campos 1-1 na sequência.
- NT 2026.002, DANFE Simplificado Tipo 2 — 1.11, setembro 2026, catálogo 01/10/2026: p. 3 cronograma; p. 12 J01-10/736.
- Tipos básicos do schema NF-e — PL_010f_v1.04: tipo TString: whiteSpace preserve e padrão sem espaços nas extremidades.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/prod/veicProd/tpPint- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 1–1 no contexto do elemento pai
- Tipo
- inline:TString · TString
- Preenchimento no catálogo
- Condicional
A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.
- length
1- pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}- whiteSpace
preserve