cCor na NF-e: código da cor da montadora

cCor é o código da cor definido pela montadora para o veículo novo. Ele permite preservar a identificação do fabricante, que pode distinguir acabamentos ou tonalidades além do nome básico da cor. Não se confunde com a descrição xCor nem com a codificação nacional de cCorDENATRAN.

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

• Três campos de cor com origens diferentes
• Formato e aplicação
• Exemplo de correspondência, sem tabela universal
• Como conferir um código desconhecido

Três campos de cor com origens diferentes

O código 10 corresponde a prata na tabela de cCorDENATRAN; isso não permite concluir que todo veículo prata tenha cCor=10. Uma montadora pode usar outro código próprio. Também não há conversão universal que obtenha cCor lendo apenas a palavra “prata”. É necessário saber fabricante e identificação exata da cor do veículo.

Formato e aplicação

cCor, campo J04, é uma string de 1 a 4 caracteres no XSD 010f. O schema não apresenta enumeração de códigos de todas as montadoras. Aceitar estruturalmente um texto de quatro caracteres não comprova que ele exista no catálogo do fabricante. Preserve zeros à esquerda e letras quando integrarem o código verdadeiro; não trate o campo como número a ser recalculado.

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.

Na sequência completa, cCor aparece depois de chassi e antes de xCor. Os três campos de cor são obrigatórios quando o grupo é incluído; preencher a descrição não dispensa o código da montadora.

Exemplo de correspondência, sem tabela universal

Suponha que a documentação de uma montadora fictícia associe o código A1 à descrição PRATA, com cor nacional 10. O recorte sintético é parcial; os demais filhos do grupo foram omitidos:

<ns0:cCor xmlns:ns0="http://www.portalfiscal.inf.br/nfe">A1</ns0:cCor>

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

O cCorDENATRAN correspondente seria 10, na sua posição posterior na sequência. A1 não é um código recomendado nem comprovação de catálogo real; serve para mostrar por que um código alfanumérico da montadora pode coexistir com um código numérico nacional. O recorte não é uma nota pronta para envio.

Como conferir um código desconhecido

Primeiro identifique chassi, fabricante e cor descrita na documentação que originou o cadastro. Compare o código da montadora enviado com essa fonte e confira se houve perda de zeros, corte de caracteres ou troca com a coluna de cor nacional. Se só há o nome da cor, falta a correspondência documental do fabricante; solicite esse dado em vez de criar um código.

Se o problema for comprimento, reveja a origem e o mapeamento, sem truncar um código verdadeiro até “caber”. Se o erro for 736, a causa documentada é a presença do grupo em modelo ou DANFE vedado, não uma cor específica. Corrija o dado ou gerador apenas depois de identificar a divergência e confira a nova geração.

Campos relacionados

• Descrição da cor
• Código nacional da cor

Fontes oficiais

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