xCor na NF-e: descrição da cor do veículo novo

xCor contém a descrição da cor do veículo novo no grupo veicProd. É o texto que permite ler a cor, enquanto cCor mantém o código da montadora e cCorDENATRAN a codificação nacional. A descrição não dispensa os dois códigos quando o grupo é informado.

O caminho no XML processado é /nfeProc/NFe/infNFe/det/prod/veicProd/xCor. 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.

• Descrição, código da montadora e código nacional
• Formato e obtenção da descrição
• Exemplo de descrição no XML
• Como diagnosticar descrição cortada ou trocada

Descrição, código da montadora e código nacional

Uma cor pode ter nome comercial detalhado e códigos próprios em catálogos diferentes. O campo J05 guarda a descrição; J04, cCor, guarda o código da montadora; J24, cCorDENATRAN, corresponde à codificação nacional publicada no MOC. Os três devem ser coerentes com os dados do veículo, mas não existe uma regra universal que derive todos lendo apenas o nome da cor.

Por exemplo, a descrição PRATA corresponde ao código nacional 10 no MOC. Isso não determina o código interno da montadora e não autoriza substituir um nome comercial específico por outro só para igualar uma tabela. O tipo de pintura, tpPint, continua sendo informação separada; a palavra PRATA não define acabamento.

Formato e obtenção da descrição

O XSD 010f usa TString de um a 40 caracteres. O texto precisa respeitar também o tipo básico de string do pacote, que não admite espaços nas extremidades como preenchimento do conteúdo. Acentuação e caracteres admitidos pela string devem ser preservados em UTF-8; não há exigência de transformar toda descrição em maiúsculas na faceta deste campo.

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.

Reutilize a descrição comprovada da documentação/cadastro vinculada ao chassi e confira a correspondência com o código da montadora. Não preencha apenas o número do código nacional, não substitua descrição ausente por “OUTROS” e não estime cor pela fotografia do veículo.

Exemplo de descrição no XML

Assuma que a documentação do veículo confirme a descrição PRATA. O elemento parcial e sintético é:

<xCor xmlns="http://www.portalfiscal.inf.br/nfe">PRATA</xCor>

xCor aparece depois de cCor e antes de pot. Os outros filhos obrigatórios foram omitidos; não é grupo completo nem nota pronta para transmissão. O valor demonstra texto de cor, sem atribuir um código fictício de fabricante a um veículo real.

Caracteres reservados precisam de serialização XML adequada: um & no texto, por exemplo, é escrito como &, preservando a descrição decodificada. Essa é uma questão de sintaxe XML; o limite de xCor continua incidindo sobre o conteúdo textual, não sobre o comprimento da entidade escrita.

Como diagnosticar descrição cortada ou trocada

Compare a descrição completa de origem com o cadastro e com o texto decodificado do XML. Se veio apenas 10, confira se a integração usou cCorDENATRAN no lugar de xCor; se veio um código alfanumérico curto, confira troca com cCor. Essas possibilidades dependem de prova do mapeamento.

Se a descrição real exceder 40 caracteres, confirme a denominação apropriada na fonte documental e no contrato aplicável. Não corte texto automaticamente até caber nem apague parte relevante da identificação. Corrija a causa demonstrada, gere novamente e confira tamanho, UTF-8 e coerência dos três campos. Uma mensagem 736 restringe o grupo por modelo/DANFE e não significa que a descrição deva mudar.

Campos relacionados

• Código da montadora
• Código nacional da cor

Fontes oficiais

• MOC 7.0, Anexo I — 7.00, novembro de 2020: p. 22: grupo JA, campo J05 (xCor); 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.