Referência de campos do MDF-e

Todos os campos que o Conota aceita dentro do objeto nota para o MDF-e (modelo 58), 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 85 campos em 18 grupos, 58 deles com descrição oficial.

Como ler

O corpo da emissão tem esta forma:

{
  "cpf_cnpj": "11222333000181",
  "nota": {
    "identificacao": {
      "tipo_emitente": 1,
      "uf_inicio": "MG", "uf_fim": "SP",
      "municipios_carregamento": [ { "codigo": "...", "municipio": "..." } ],
      "percurso": [ { "uf": "GO" } ]
    },
    "emitente": { "...": "..." },
    "rodoviario": {
      "rntrc": "...",
      "veiculo": { "placa": "...", "...": "..." },
      "condutores": [ { "nome": "...", "cpf": "..." } ]
    },
    "descarregamento": [
      { "codigo": "3550308", "municipio": "SAO PAULO",
        "cte": [ { "chave": "..." } ] }
    ],
    "produto_predominante": { "...": "..." },
    "totais": { "...": "..." }
  }
}

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

19 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.ide`

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` …
`tipo_emitente`	`tpEmit`	`string`		`1` `2` `3`	Tipo do Emitente
`modelo`	`mod`	`string`		`58`	Modelo do Manifesto Eletrônico
`serie`	`serie`	`string`	3
`numero`	`nMDF`	`string`			Número do Manifesto
`codigo_mdf`	`cMDF`	`string`			Código numérico que compõe a Chave de Acesso.
`modal`	`modal`	`string`		`1` `2` `3` `4`	Modalidade de transporte
`data_emissao`	`dhEmi`	`string`			Data e hora de emissão do Manifesto
`tipo_emissao`	`tpEmis`	`string`		`1` `2` `3`	Forma de emissão do Manifesto
`processo_emissao`	`procEmi`	`TProcEmi`		`0` `4`	Identificação do processo de emissão do Manifesto
`versao_processo`	`verProc`	`TString`	20		Versão do processo de emissão
`uf_inicio`	`UFIni`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …	Sigla da UF do Carregamento
`uf_fim`	`UFFim`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …	Sigla da UF do Descarregamento
`data_inicio_viagem`	`dhIniViagem`	`string`			Data e hora previstos de inicio da viagem
`tipo_transportador`	`tpTransp`	`string`		`1` `2` `3`	Tipo do Transportador
`canal_verde`	`indCanalVerde`	`string`		`1`	Indicador de participação do Canal Verde
`carregamento_posterior`	`indCarregaPosterior`	`string`		`1`	Indicador de MDF-e com inclusão da Carga posterior a emissão por evento de inclusão de DF-e

`nota.municipios_carregamento[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`codigo` também: `codigo_municipio`	`cMunCarrega`	`string`			Código do Município de Carregamento
`municipio` também: `nome`	`xMunCarrega`	`TString`	60		Nome do Município de Carregamento

`nota.percurso[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`uf` também: `valor`	`UFPer`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …	Sigla das Unidades da Federação do percurso do veículo.

`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`	`TIe`			Inscrição Estadual do emitemte
`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 do emitente
`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`
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …	UF do Emitente
`telefone`	`fone`	`string`
`email`	`email`	`string`	60

`nota.Rodo`

Campo	Vira	Tipo	Tam.	Valores	O que é
`agencia_porto`	`codAgPorto`	`TString`	16		Código de Agendamento no porto

`nota.veiculo`

Campo	Vira	Tipo	Tam.	Valores	O que é
`codigo_interno` também: `cInt`, `codigo`	`clInt`				campo do emissor, sem descrição no layout
`placa`	`placa`	`TPlaca`			Placa do veículo
`renavam` também: `renavan`	`RENAVAN`				campo do emissor, sem descrição no layout
`tara`	`tara`	`string`			Tara em KG
`capacidade_kg`	`capKG`	`string`			Capacidade em KG
`capacidade_m3`	`capM3`	`string`			Capacidade em M3
`tipo_rodado`	`tpRod`	`string`		`01` `02` `03` `04` `05` `06`	Tipo de Rodado
`tipo_carroceria`	`tpCar`	`string`		`00` `01` `02` `03` `04` `05`	Tipo de Carroceria
`uf`	`UF`	`string`		`AC` `AL` `AM` `AP` `BA` `CE` `DF` `ES` `GO` `MA` `MG` `MS` …
`cnpj` também: `cnpj_cpf`, `cpf`	`CNPJCPF`				campo do emissor, sem descrição no layout
`rntrc`	`RNTRC`	`TString`
`proprietario`	`xNome`	`TString`	60
`inscricao_estadual`	`IE`	`TIe`
`uf_proprietario`	`UFProp`				campo do emissor, sem descrição no layout
`tipo_proprietario`	`tpProp`	`string`		`0` `1` `2`	Tipo Proprietário ou possuidor

`nota.condutores[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`cpf` também: `documento`	`CPF`	`string`
`nome`	`xNome`	`TString`	60

`nota.prodPred`

Campo	Vira	Tipo	Tam.	Valores	O que é
`tipo_carga`	`tpCarga`	`string`		`01` `02` `03` `04` `05` `06` `07` `08` `09` `10` `11` `12`	Tipo de Carga
`descricao` também: `produto`	`xProd`	`TString`	120		Descrição do produto
`ean`	`cEAN`	`string`			GTIN (Global Trade Item Number) do produto, antigo código EAN ou código de barras
`ncm`	`NCM`	`string`			Código NCM

`nota.local_carregamento`

Campo	Vira	Tipo
`cep`	`CEP`	`string`
`latitude`	`latitude`	`TString`
`longitude`	`longitude`	`TString`

`nota.local_descarregamento`

Campo	Vira	Tipo
`cep`	`CEP`	`string`
`latitude`	`latitude`	`TString`
`longitude`	`longitude`	`TString`

`nota.totais`

Campo	Vira	Tipo	Valores	O que é
`quantidade_cte`	`qCTe`	`string`		Quantidade total de CT-e relacionados no Manifesto
`quantidade_nfe`	`qNFe`	`string`		Quantidade total de NF-e relacionadas no Manifesto
`quantidade_mdfe`	`qMDFe`	`string`		Quantidade total de MDF-e relacionados no Manifesto Aquaviário
`valor_carga`	`vCarga`	`string`		Valor total da carga / mercadorias transportadas
`quantidade_carga`	`qCarga`	`string`		Peso Bruto Total da Carga / Mercadorias transportadas
`unidade`	`cUnid`	`string`	`01` `02`	Código da unidade de medida do Peso Bruto da Carga / Mercadorias transportadas

`nota.lacres[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`numero` também: `lacre`, `valor`	`nLacre`	`TString`	60		número do lacre

`nota.informacoes_adicionais`

Campo	Vira	Tipo	Tam.	Valores	O que é
`informacao_fisco`	`infAdFisco`	`TString`	2000		Informações adicionais de interesse do Fisco
`informacoes_complementares` também: `observacoes`	`infCpl`	`TString`	5000		Informações complementares de interesse do Contribuinte

`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.vale_pedagio`

Campo	Vira	Tipo	Tam.	Valores	O que é
`categoria`	`categCombVeic`	`string`		`02` `04` `06` `07` `08` `10` `11` `12` `13` `14`	Categoria de Combinação Veicular

`nota.null`

Campo	Vira	Tipo	Tam.	Valores	O que é
`codigo` também: `codigo_municipio`	`cMunDescarga`	`string`			Código do Município de Descarregamento
`municipio` também: `nome`	`xMunDescarga`	`TString`	60		Nome do Município de Descarregamento

`nota.cte[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`chave` também: `chave_acesso`	`chCTe`	`string`	44		Conhecimento Eletrônico - Chave de Acesso
`codigo_barras`	`SegCodBarra`	`string`			Segundo código de barras
`reentrega`	`indReentrega`	`string`		`1`	Indicador de Reentrega
`prestacao_parcial`	`indPrestacaoParcial`	`string`		`1`	Indicador de Prestação parcial

`nota.nfe[]`

Campo	Vira	Tipo	Tam.	Valores	O que é
`chave` também: `chave_acesso`	`chNFe`	`string`	44
`codigo_barras`	`SegCodBarra`	`string`			Segundo código de barras
`reentrega`	`indReentrega`	`string`		`1`	Indicador de Reentrega

Grupos que passam direto

Em 3 grupos o campo vai para o layout com o mesmo nome, sem tradução: null · null · infANTT

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.ide​

nota.municipios_carregamento[]​

nota.percurso[]​

nota.emitente​

nota.Rodo​

nota.veiculo​

nota.condutores[]​

nota.prodPred​

nota.local_carregamento​

nota.local_descarregamento​

nota.totais​

nota.lacres[]​

nota.informacoes_adicionais​

nota.responsavel_tecnico​

nota.vale_pedagio​

nota.null​

nota.cte[]​

nota.nfe[]​

Grupos que passam direto​

O que esta página não cobre​