cCorDENATRAN na NF-e: tabela de cores de 01 a 16
<cCorDENATRAN>det › prod › veicProd › cCorDENATRANRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
cCorDENATRAN identifica a cor do veículo novo segundo a codificação nacional de pré-cadastro reproduzida no MOC. O nome da tag permanece esse no XML. O campo complementa cCor, da montadora, e xCor, a descrição; não substitui nenhum deles.
O caminho no XML processado é /nfeProc/NFe/infNFe/det/prod/veicProd/cCorDENATRAN. 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.
- Tabela de cores publicada no leiaute
- Formato do XML e origem do código
- Exemplo da cor nacional e da cor da montadora
- Como diagnosticar divergência de cor
Tabela de cores publicada no leiaute
| Código | Cor | Código | Cor |
|---|---|---|---|
| 01 | Amarelo | 09 | Marrom |
| 02 | Azul | 10 | Prata |
| 03 | Bege | 11 | Preta |
| 04 | Branca | 12 | Rosa |
| 05 | Cinza | 13 | Roxa |
| 06 | Dourada | 14 | Verde |
| 07 | Grená | 15 | Vermelha |
| 08 | Laranja | 16 | Fantasia |
Esses são os significados de J24 no MOC, p. 23, também documentados no XSD 010f. A tabela não determina a classificação de uma tonalidade comercial específica. Um nome como “cinza lunar” precisa ser confrontado com o enquadramento de cor efetivamente registrado para o veículo; não se escolhe 10 ou 05 pela aparência ou semelhança do nome.
Formato do XML e origem do código
O XSD admite um ou dois dígitos, enquanto o MOC apresenta os códigos com dois dígitos. As facetas numéricas não enumeram somente 01 a 16; por isso um valor como 99 pode atender ao padrão de caracteres sem representar uma cor prevista na tabela. Formato e significado precisam ser conferidos separadamente. Preserve a codificação oficial recebida, incluindo zeros quando presentes.
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.
Use o registro/documentação do veículo associado ao chassi e confira o mapeamento para a tabela nacional. cCor, por sua vez, pode ter letras e segue a montadora. Copiar seu código para cCorDENATRAN não é uma conversão segura.
Exemplo da cor nacional e da cor da montadora
Assuma documentação que confirme a cor nacional PRATA, código 10. O elemento sintético e parcial é:
<cCorDENATRAN xmlns="http://www.portalfiscal.inf.br/nfe">10</cCorDENATRAN>
O campo ocorre depois de cMod e antes de lota na sequência completa. O exemplo omite os demais filhos obrigatórios e não constitui grupo ou nota pronta para transmissão. Mesmo com o valor 10, o emissor precisa informar separadamente o código próprio da montadora em cCor e a descrição em xCor.
Como diagnosticar divergência de cor
Localize o chassi e compare os três dados de cor no documento de origem e no cadastro. Se o XML traz texto como PRATA nesta tag, há troca de coluna com xCor. Se traz um código alfanumérico de fabricante, confira troca com cCor. Se traz dois dígitos mas a cor correspondente diverge, o erro é de conteúdo ou mapeamento, não de tamanho.
Quando a classificação nacional não estiver confirmada, obtenha o dado documental. Não use 16, “Fantasia”, como substituto de informação ausente: esse código tem significado próprio. A correção deve preservar a cor real e ser verificada na nova geração; passar no XSD não prova a correspondência cadastral.
Campos relacionados
Fontes oficiais
- MOC 7.0, Anexo I — 7.00, novembro de 2020: p. 23: grupo JA, campo J24 (cCorDENATRAN); 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/cCorDENATRAN- 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:xs:string · string
- 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.
- maxLength
2- minLength
1- pattern
[0-9]{1,2}- whiteSpace
preserve