Referência de campos do CT-e

Todos os campos que o Conota aceita dentro do objeto nota, para CT-e (modelo 57) e CT-e OS (modelo 67), no modal rodoviário.

Esta página é gerada, não escrita

Ela sai de duas fontes, direto do que roda em produção:

o conversor — quais nomes você pode enviar e em que campo do layout cada um vira;
os XSD oficiais — tipo, tamanho, valores permitidos e a descrição de cada campo.

Por isso ela não diverge do sistema: se um campo muda no código, muda aqui. E por isso os textos da coluna "O que é" são os oficiais, não uma reescrita nossa.

São 231 campos em 29 grupos, 131 deles com descrição oficial.

Como ler

O corpo da emissão tem esta forma:

{
  "cpf_cnpj": "11222333000181",
  "nota": {
    "identificacao": { "modelo": 57, "...": "..." },
    "emitente": { "...": "..." },
    "remetente": { "...": "..." },
    "destinatario": { "...": "..." },
    "tomador": { "indice": "0" },
    "prestacao": { "valor_total": "100.00", "componentes": [ { "...": "..." } ] },
    "imposto": { "icms": { "cst": "00", "...": "..." } },
    "carga": { "...": "..." },
    "documentos": { "nfe": [ { "chave_acesso": "..." } ] },
    "rodoviario": { "rntrc": "..." }
  }
}

Cada seção abaixo é um desses blocos. A coluna Vira é o nome do campo no layout oficial, útil quando o fisco devolve uma rejeição citando o nome dele.

Um campo pode aceitar mais de um nome

39 campos aceitam nomes alternativos. Quando existem, aparecem como "também:" na primeira coluna — qualquer um funciona.

Campo com nome errado não dá erro

O conversor repassa chave desconhecida como veio, e o emissor a ignora: um vlrProd no lugar de vProd gera uma nota válida com o produto valendo R$ 0,00.

Antes da primeira emissão, passe o seu payload em POST /v1/nfe/verificar-campos — ele aponta o campo desconhecido e sugere o certo, sem emitir e sem consumir cota.

`nota.null`

Campo	Vira	Tipo	Valores	O que é
`cst`	`CST`	`string`	`00`
`base_calculo`	`vBC`	`string`
`aliquota`	`pICMS`	`string`		Alíquota do ICMS
`valor`	`vICMS`	`string`
`reducao_base`	`pRedBC`	`string`		Percentual de redução da BC

`nota.identificacao`

Campo	Vira	Tipo	Tam.	Valores	O que é
`codigo_uf` também: `uf`	`cUF`	`string`		`11` `12` `13` `14` `15` `16` `17` `21` `22` `23` `24` `25` …
`codigo_ct`	`cCT`	`string`			Código numérico que compõe a Chave de Acesso.
`cfop`	`CFOP`	`string`			Código Fiscal de Operações e Prestações
`natureza_operacao` também: `nat_op`	`natOp`	`TString`	60		Natureza da Operação
`forma_pagamento`	`forPag`				campo do emissor, sem descrição no layout
`modelo`	`mod`	`string`		`64`
`serie`	`serie`	`TSerie`	3
`numero`	`nCT`	`string`
`data_emissao`	`dhEmi`	`TDateTimeUTC`
`tipo_impressao`	`tpImp`	`string`		`1` `2`
`tipo_emissao`	`tpEmis`	`string`		`1` `2`
`tipo_ambiente` também: `ambiente`	`tpAmb`	`string`		`1` `2`
`processo_emissao`	`procEmi`	`string`		`0` `3` `4`
`versao_processo`	`verProc`	`TString`	20		Versão do processo de emissão
`data_contingencia`	`dhCont`	`string`			Data e Hora da entrada em contingência
`justificativa`	`xJust`	`TString`	256		Justificativa da entrada em contingência
`tipo_cte`	`tpCTe`	`TFinGTVe`		`4`
`cte_referenciado`	`refCTe`				campo do emissor, sem descrição no layout
`codigo_municipio_envio`	`cMunEnv`	`string`
`municipio_envio`	`xMunEnv`	`TString`	60
`uf_envio`	`UFEnv`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`modal`	`modal`	`TModTranspGTVe`		`01` `06` `01` `06`
`tipo_servico`	`tpServ`	`string`		`9`	Tipo do Serviço
`codigo_municipio_inicio`	`cMunIni`	`string`			Código do Município de início da prestação
`municipio_inicio`	`xMunIni`	`TString`	60		Nome do Município do início da prestação
`uf_inicio`	`UFIni`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …	UF do início da prestação
`codigo_municipio_fim`	`cMunFim`	`string`			Código do Município de término da prestação
`municipio_fim`	`xMunFim`	`TString`	60		Nome do Município do término da prestação
`uf_fim`	`UFFim`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …	UF do término da prestação
`retira`	`retira`	`string`		`0` `1`	Indicador se o Recebedor retira no Aeroporto, Filial, Porto ou Estação de Destino?
`detalhe_retira`	`xDetRetira`	`TString`	160		Detalhes do retira
`globalizado`	`indGlobalizado`	`string`		`1`	Indicador de CT-e Globalizado
`indicador_ie_tomador`	`indIEToma`	`string`		`1` `2` `9`

`nota.complemento`

Campo	Vira	Tipo	Tam.	O que é
`caracteristica_adicional`	`xCaracAd`	`TString`	15	Característica adicional do transporte
`caracteristica_servico`	`xCaracSer`	`TString`	30	Característica adicional do serviço
`emitido_por`	`xEmi`	`TString`	20
`origem`	`xOrig`	`TString`	60	Sigla ou código interno da Filial/Porto/Estação/ Aeroporto de Origem
`destino`	`xDest`	`TString`	60	Sigla ou código interno da Filial/Porto/Estação/Aeroporto de Destino
`rota`	`xRota`	`TString`	10	Código da Rota de Entrega
`tipo_data`	`TipoData`			campo do emissor, sem descrição no layout
`tipo_hora`	`TipoHora`			campo do emissor, sem descrição no layout
`origem_calculo`	`origCalc`	`TString`	40	Município de origem para efeito de cálculo do frete
`destino_calculo`	`destCalc`	`TString`	40	Município de destino para efeito de cálculo do frete
`observacoes`	`xObs`	`TString`	2000

`nota.emitente`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`	`CNPJ`	`string`			CNPJ do emitente
`inscricao_estadual` também: `ie`	`IE`	`TIeDest`	14		Inscrição Estadual do Emitente
`razao_social` também: `nome`	`xNome`	`TString`	60		Razão social ou Nome do emitente
`nome_fantasia` também: `fantasia`	`xFant`	`TString`	60		Nome Fantasia
`regime_tributario` também: `crt`	`CRT`	`string`	1	`1` `2` `3` `4`	Código do Regime Tributário
`inscricao_suframa`	`ISUFEmit`	`string`	9		Inscrição do emitente da Suframa
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`cep`	`CEP`	`string`			CEP
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`telefone`	`fone`	`string`

`nota.prestacao`

Campo	Vira	Tipo	Tam.	Valores	O que é
`valor_total`	`vTPrest`	`string`			Valor Total da Prestação do Serviço
`valor_receber`	`vRec`	`string`			Valor a Receber

`nota.componentes[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`nome` também: `descricao`	`xNome`	`TString`	60
`valor`	`vComp`	`string`			Valor do componente

`nota.Imp`

Campo	Vira	Tipo	Tam.	O que é
`total_tributos`	`vTotTrib`	`string`		Valor Total dos Tributos
`informacao_fisco`	`infAdFisco`	`TString`	2000	Informações adicionais de interesse do Fisco
`total_dfe`	`vTotDFe`	`string`		Valor total do documento fiscal (vTPrest + total do IBS + total da CBS)

`nota.observacoes_contribuinte[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`campo`	`xCampo`				campo do emissor, sem descrição no layout
`texto`	`xTexto`	`TString`	160		Conteúdo do campo

`nota.observacoes_fisco[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`campo`	`xCampo`				campo do emissor, sem descrição no layout
`texto`	`xTexto`	`TString`	160		Conteúdo do campo

`nota.cobranca`

Campo	Vira	Tipo	Tam.	O que é
`numero_fatura`	`nFat`	`TString`	60	Número da fatura
`valor_original`	`vOrig`	`string`		Valor original da fatura
`desconto`	`vDesc`	`string`		Valor do desconto da fatura
`valor_liquido`	`vLiq`	`string`		Valor líquido da fatura

`nota.responsavel_tecnico`

Campo	Vira	Tipo	Tam.	O que é
`cnpj`	`CNPJ`	`string`
`contato`	`xContato`	`TString`	60	Nome da pessoa a ser contatada
`email`	`email`	`string`	60
`telefone`	`fone`	`string`

`nota.remetente`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`, `cpf`, `documento`	`CNPJCPF`				campo do emissor, sem descrição no layout
`inscricao_estadual` também: `ie`	`IE`	`TIeDest`	14
`razao_social` também: `nome`	`xNome`	`TString`	60
`nome_fantasia` também: `fantasia`	`xFant`	`TString`	60		Nome Fantasia
`telefone`	`fone`	`string`
`email`	`Email`				campo do emissor, sem descrição no layout
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`cep`	`CEP`	`string`			CEP
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`codigo_pais`	`cPais`	`string`			Código do país
`pais`	`xPais`	`TString`	60		Nome do país

`nota.local_coleta`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`, `cpf`, `documento`	`CNPJCPF`				campo do emissor, sem descrição no layout
`inscricao_estadual` também: `ie`	`IE`	`TIeDest`	14
`razao_social` também: `nome`	`xNome`	`TString`	60
`nome_fantasia` também: `fantasia`	`xFant`	`TString`	60		Nome Fantasia
`telefone`	`fone`	`string`
`email`	`Email`				campo do emissor, sem descrição no layout
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`cep`	`CEP`	`string`			CEP
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`codigo_pais`	`cPais`	`string`			Código do país
`pais`	`xPais`	`TString`	60		Nome do país

`nota.expedidor`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`, `cpf`, `documento`	`CNPJCPF`				campo do emissor, sem descrição no layout
`inscricao_estadual` também: `ie`	`IE`	`TIeDest`	14
`razao_social` também: `nome`	`xNome`	`TString`	60
`nome_fantasia` também: `fantasia`	`xFant`	`TString`	60		Nome Fantasia
`telefone`	`fone`	`string`
`email`	`Email`				campo do emissor, sem descrição no layout
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`cep`	`CEP`	`string`			CEP
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`codigo_pais`	`cPais`	`string`			Código do país
`pais`	`xPais`	`TString`	60		Nome do país

`nota.recebedor`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`, `cpf`, `documento`	`CNPJCPF`				campo do emissor, sem descrição no layout
`inscricao_estadual` também: `ie`	`IE`	`TIeDest`	14
`razao_social` também: `nome`	`xNome`	`TString`	60
`nome_fantasia` também: `fantasia`	`xFant`	`TString`	60		Nome Fantasia
`telefone`	`fone`	`string`
`email`	`Email`				campo do emissor, sem descrição no layout
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`cep`	`CEP`	`string`			CEP
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`codigo_pais`	`cPais`	`string`			Código do país
`pais`	`xPais`	`TString`	60		Nome do país

`nota.destinatario`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`, `cpf`, `documento`	`CNPJCPF`				campo do emissor, sem descrição no layout
`inscricao_estadual` também: `ie`	`IE`	`TIeDest`	14
`razao_social` também: `nome`	`xNome`	`TString`	60		Razão Social ou Nome do destinatário
`nome_fantasia` também: `fantasia`	`xFant`	`TString`	60		Nome Fantasia
`telefone`	`fone`	`string`
`email`	`Email`				campo do emissor, sem descrição no layout
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`cep`	`CEP`	`string`			CEP
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`codigo_pais`	`cPais`	`string`			Código do país
`pais`	`xPais`	`TString`	60		Nome do país

`nota.infCarga`

Campo	Vira	Tipo	Tam.	O que é
`valor_carga`	`vCarga`	`string`		Valor total da carga
`produto_predominante`	`proPred`	`TString`	60	Produto predominante
`outras_caracteristicas`	`xOutCat`	`TString`	30	Outras características da carga
`valor_averbacao`	`vCargaAverb`	`string`		Valor da Carga para efeito de averbação

`nota.quantidades[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`unidade`	`cUnid`	`string`		`00` `01` `02` `03` `04` `05`	Código da Unidade de Medida
`tipo_medida`	`tpMed`	`TString`	2	`00` `01` `02` `03` `04` `05` `06` `07` `08` `09` `10` `11` …	Tipo da Medida
`quantidade`	`qCarga`	`string`

`nota.nfe[]`

Campo	Vira	Tipo	Tam.	O que é
`chave_acesso` também: `chave`	`chave`	`string`	44
`pin`	`PIN`	`string`	9	PIN SUFRAMA
`data_prevista`	`dPrev`	`string`		Data prevista de entrega

`nota.rodoviario`

Campo	Vira	Tipo	O que é
`rntrc`	`RNTRC`	`string`
`data_prevista`	`dPrev`	`string`	Data prevista de entrega
`lotacao`	`lota`		campo do emissor, sem descrição no layout

`nota.substituicao`

Campo	Vira	Tipo	Tam.	Valores	O que é
`chave` também: `chave_cte`, `chave_substituido`	`chCte`	`string`	44		Chave de acesso do CT-e a ser substituído (original)
`altera_tomador`	`indAlteraToma`	`string`		`1`	Indicador de CT-e Alteração de Tomador

`nota.tomador`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`, `cpf`, `documento`	`CNPJCPF`				campo do emissor, sem descrição no layout
`inscricao_estadual` também: `ie`	`IE`	`TIeDest`	14
`razao_social` também: `nome`	`xNome`	`TString`	60		Razão Social ou Nome do destinatário
`nome_fantasia` também: `fantasia`	`xFant`	`TString`	60		Nome Fantasia
`telefone`	`fone`	`string`
`email`	`Email`				campo do emissor, sem descrição no layout
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`cep`	`CEP`	`string`			CEP
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`codigo_pais`	`cPais`	`string`			Código do país
`pais`	`xPais`	`TString`	60		Nome do país

`nota.servico`

Campo	Vira	Tipo	Tam.	Valores	O que é
`descricao`	`xDescServ`	`TString`	30		Descrição do Serviço prestado
`quantidade`	`qCarga`	`string`

`nota.documentos_referenciados[]`

Campo	Vira	Tipo	Tam.	O que é
`chave_bpe`	`chBPe`	`TChDFe`	44	Chave de acesso do BP-e que possui eventos excesso de bagagem
`numero`	`nDoc`	`TString`	20
`serie`	`serie`	`TSerie`	3
`data_emissao`	`dEmi`	`string`
`valor`	`vDoc`	`string`		Valor Transportado

`nota.seguros[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`responsavel`	`respSeg`	`string`	1	`4` `5`	Responsável pelo seguro
`seguradora`	`xSeg`	`TString`	30		Nome da Seguradora
`apolice`	`nApol`	`TString`	20		Número da Apólice
`averbacao`	`nAver`				campo do emissor, sem descrição no layout
`valor_carga`	`vCarga`	`string`			Valor total da carga

`nota.rodoviario`

Campo	Vira	Tipo	Tam.	Valores	O que é
`taf`	`TAF`				campo do emissor, sem descrição no layout
`registro_estadual`	`NroRegEstadual`				campo do emissor, sem descrição no layout

`nota.fretamento`

Campo	Vira	Tipo	Tam.	Valores	O que é
`tipo`	`tpFretamento`				campo do emissor, sem descrição no layout
`data_viagem`	`dhViagem`				campo do emissor, sem descrição no layout

`nota.tributos_federais`

Campo	Vira	Tipo	O que é
`pis`	`vPIS`	`string`	Valor do PIS
`cofins`	`vCOFINS`	`string`	Valor COFINS
`ir`	`vIR`	`string`	Valor de Imposto de Renda
`inss`	`vINSS`	`string`	Valor do INSS
`csll`	`vCSLL`	`string`	Valor do CSLL

`nota.tomador`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cnpj` também: `cnpj_cpf`, `cpf`, `documento`	`CNPJCPF`				campo do emissor, sem descrição no layout
`inscricao_estadual` também: `ie`	`IE`	`TIeDest`	14
`razao_social` também: `nome`	`xNome`	`TString`	60		Razão Social ou Nome do destinatário
`nome_fantasia` também: `fantasia`	`xFant`	`TString`	60		Nome Fantasia
`telefone`	`fone`	`string`
`email`	`Email`				campo do emissor, sem descrição no layout
`logradouro`	`xLgr`	`TString`	60		Logradouro
`numero`	`nro`	`TString`	60		Número
`complemento`	`xCpl`	`TString`	60		Complemento
`bairro`	`xBairro`	`TString`	60		Bairro
`codigo_municipio`	`cMun`	`string`
`municipio`	`xMun`	`TString`	60
`cep`	`CEP`	`string`			CEP
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`codigo_pais`	`cPais`	`string`			Código do país
`pais`	`xPais`	`TString`	60		Nome do país

Grupos que passam direto

Em 6 grupos o campo vai para o layout com o mesmo nome, sem tradução: icms_uf_fim · nf[] · outros[] · ordens_coleta[] · null · toma3

São os grupos da Reforma Tributária e do ISSQN. Use os nomes do layout oficial.

O que esta página não cobre

Ela lista quais campos existem e o que cada um aceita. Ela não diz quando cada grupo é exigido — isso depende de UF, município, regime tributário e da operação, e está nos guias de emissão. Um payload que passa por esta referência ainda pode ser rejeitado por regra fiscal.

Como ler​

nota.null​

nota.identificacao​

nota.complemento​

nota.emitente​

nota.prestacao​

nota.componentes[]​

nota.Imp​

nota.observacoes_contribuinte[]​

nota.observacoes_fisco[]​

nota.cobranca​

nota.responsavel_tecnico​

nota.remetente​

nota.local_coleta​

nota.expedidor​

nota.recebedor​

nota.destinatario​

nota.infCarga​

nota.quantidades[]​

nota.nfe[]​

nota.rodoviario​

nota.substituicao​

nota.tomador​

nota.servico​

nota.documentos_referenciados[]​

nota.seguros[]​

nota.rodoviario​

nota.fretamento​

nota.tributos_federais​

nota.tomador​

Grupos que passam direto​

O que esta página não cobre​

Como ler

`nota.null`

`nota.identificacao`

`nota.complemento`

`nota.emitente`

`nota.prestacao`

`nota.componentes[]`

`nota.Imp`

`nota.observacoes_contribuinte[]`

`nota.observacoes_fisco[]`

`nota.cobranca`

`nota.responsavel_tecnico`

`nota.remetente`

`nota.local_coleta`

`nota.expedidor`

`nota.recebedor`

`nota.destinatario`

`nota.infCarga`

`nota.quantidades[]`

`nota.nfe[]`

`nota.rodoviario`

`nota.substituicao`

`nota.tomador`

`nota.servico`

`nota.documentos_referenciados[]`

`nota.seguros[]`

`nota.rodoviario`

`nota.fretamento`

`nota.tributos_federais`

`nota.tomador`

Grupos que passam direto

O que esta página não cobre