cilin na NF-e: cilindradas do motor em centímetros cúbicos
<cilin>det › prod › veicProd › cilinRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
cilin representa a cilindrada do motor do veículo novo, expressa em centímetros cúbicos (CC) na documentação do XSD da NF-e. É uma medida de capacidade do motor, diferente da potência informada em pot, cujo referencial é cavalo-vapor (CV).
O caminho no XML processado é /nfeProc/NFe/infNFe/det/prod/veicProd/cilin. 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.
- Cilindrada não é potência
- Dado de origem, formato e aplicação
- Exemplo de leitura de cilindrada
- Como conferir valor e unidade
Cilindrada não é potência
cilin, campo J07, e pot, J06, ficam próximos no XML, mas contêm grandezas diferentes. Não copie um valor de CV para cilin e não calcule potência a partir da cilindrada: não há fórmula desse tipo no leiaute.
Há uma divergência textual que merece cuidado. A tabela do MOC 7.0, p. 22, intitula J07 como “Cilindradas”, porém sua coluna de observação repete a descrição de potência em CV. A documentação da declaração cilin no XSD oficial 010f identifica a capacidade do motor em centímetros cúbicos. Essa observação deslocada no manual não deve transformar a tag em um segundo campo de potência. Schema oficial 010f, declaração cilin.
Dado de origem, formato e aplicação
O contrato estrutural é TString de um a quatro caracteres. Não é uma faceta decimal de imposto nem uma enumeração de cilindradas possíveis. A aceitação de uma string não autoriza informar qualquer texto: o conteúdo continua sendo a cilindrada documental do motor em CC, sem escrever a unidade dentro da tag.
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 a especificação do fabricante associada ao motor e à versão do veículo. Um nome comercial como “1.6” não prova, sozinho, a cilindrada exata em CC; ele pode ser uma designação arredondada. Se a origem fornecer outra unidade, confira a grandeza e a medida exata antes da conversão. Não substitua ausência por zero, nem derive a medida do combustível ou do modelo comercial.
Exemplo de leitura de cilindrada
Assuma, para este exemplo sintético, uma especificação que declare exatamente 1600 CC. O recorte parcial é:
<cilin xmlns="http://www.portalfiscal.inf.br/nfe">1600</cilin>
O campo ocorre depois de pot e antes de pesoL. O valor 1600 ilustra uma medida assumida, não uma conversão automática de qualquer motor comercialmente chamado “1.6”. Os outros filhos obrigatórios não aparecem; não é grupo completo nem documento pronto para transmissão.
Como conferir valor e unidade
Compare a especificação original, a coluna de cilindrada do cadastro e a string enviada. Se o XML contém 120 e a ficha traz 120 CV e 1600 CC, investigue se o mapeamento trocou pot por cilin. Se contém “1600 CC”, o sufixo e o comprimento precisam ser revistos no gerador, preservando a medida verdadeira. Se a informação ultrapassar o limite da tag, não corte dígitos: confirme o dado e o tratamento oficial aplicável à configuração real.
Uma aprovação no XSD não confirma a cilindrada do motor. A rejeição 736, por outro lado, limita o uso do grupo conforme modelo e DANFE; ela não resolve a unidade de cilin. Para um veículo cuja motorização não forneça essa grandeza, obtenha orientação documental específica antes de preencher um substituto.
Campos relacionados
Fontes oficiais
- MOC 7.0, Anexo I — 7.00, novembro de 2020: p. 22: grupo JA, campo J07 (cilin); 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/cilin- 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.
- maxLength
4- minLength
1- pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}- whiteSpace
preserve