Campos — MDF-e

Listagem completa dos campos aceitos no corpo de POST /v1/mdfe/emit quando mod corresponde a este tipo de documento. Gerado a partir do schema de validação usado pelo motor fiscal — sempre reflete os nomes de campo e descrições reais aceitos pela API.

Isso é referência exaustiva, não um guia — se você só quer emitir um documento, veja Emitir MDF-e, que já cobre os campos essenciais. Use a busca abaixo pra pular direto pro campo que precisa, ou expanda um grupo pra navegar. Campos do tipo array de objeto têm um atalho que abre e rola até o grupo de campos referenciado.

Campos principais54 campos

mod58obrigatório

Modelo do documento fiscal

emitentestring | number

Tipo de Emitente 1: Prestador de serviço de transporte 2: Transportador de Carga Própria 3: Prestador de serviço de transporte que emitirá CT-e Globalizado.

tipo_transportestring | number

Tipo do Transportador 1: ETC 2: TAC 3: CTC

seriestring | number

Série do MDF-e. Deixe em branco para que a API se responsabilize pela numeração automática (recomendado)

numerostring | number

Número do Manifesto. Deixe em branco para que a API se responsabilize pela numeração automática (recomendado)

data_emissaostring | number

Data e hora de emissão.

uf_iniciostring

Sigla da UF de carregamento. Informar 'EX' para as operações com o exterior.

uf_fimstring

Sigla da UF de descarregamento. Informar 'EX' para as operações com o exterior.

municipios_carregamentoarray de objeto

Informações dos Municípios de Carregamento.

percursosarray de objeto

Informações dos Percursos do MDF-e.

data_hora_previsto_inicio_viagemstring | number

Data e hora previstos para o início da viagem

participa_canal_verdestring | number

Indicador de participação do projeto Canal Verde. Preencher com 1 para indicar a participação, caso contrário omitir esta tag.

carregamento_posteriorstring | number

Indicador de carregamento posterior. Preencher com 1 para indicar o carregamento, caso contrário omitir esta tag.

cnpj_emitentestring

CNPJ do emitente.

cpf_emitentestring | number

CPF do emitente.

inscricao_estadual_emitentestring | number

Inscrição Estadual da empresa emitente.

nome_emitentestring

Razão Social ou nome da empresa emitente.

nome_fantasia_emitentestring

Nome fantasia da empresa emitente.

logradouro_emitentestring

Logradouro (rua, avenida, travessa etc.) da empresa emitente.

numero_emitentestring

Número do endereço da empresa emitente.

complemento_emitentestring

Complemento do endereço da empresa emitente.

bairro_emitentestring

Bairro da empresa emitente.

codigo_municipio_emitentestring | number

Código do Município da empresa emitente (7 dígitos), de acordo com a tabela do IBGE. Informar 9999999 para operações com o exterior.

municipio_emitentestring

Município da empresa emitente.

cep_emitentestring | number

CEP da empresa emitente.

uf_emitentestring

UF da empresa emitente.

telefone_emitentestring | number

Telefone da empresa emitente.

email_emitentestring | number

E-Mail da empresa emitente.

municipios_descarregamentoarray de objeto

Informações dos Municípios de Descarregamento.

seguros_cargaarray de objeto

Informações de Seguro da Carga.

tipo_cargastring | number

Tipo da Carga. Conforme Resolução ANTT no. 5.849/2019 01: Granel sólido 02: Granel líquido 03: Frigorificada 04: Conteinerizada 05: Carga Geral 06: Neogranel 07: Perigosa (granel sólido) 08: Perigosa (granel líquido) 09: Perigosa (carga frigorificada) 10: Perigosa (conteinerizada) 11: Perigosa (carga geral) 12: Granel pressurizada

descricao_produtostring

Descrição do produto predominante

codigo_barras_produtostring

GTIN (Global Trade Item Number) do produto, antigo código EAN ou código de barras

codigo_ncm_produtostring

Código NCM do produto predominante

cep_carregamentostring | number

CEP onde foi carregado o MDF-e. Informar somente quando MDF-e for de carga lotação

latitude_carregamentostring | number

Latitude do ponto geográfico onde foi carregado o MDF-e. Informar somente quando MDF-e for de carga lotação

longitude_carregamentostring | number

Longitude do ponto geográfico onde foi carregado o MDF-e. Informar somente quando MDF-e for de carga lotação

cep_descarregamentostring | number

CEP onde foi descarregado o MDF-e. Informar somente quando MDF-e for de carga lotação

latitude_descarregamentostring | number

Latitude do ponto geográfico onde foi descarregado o MDF-e. Informar somente quando MDF-e for de carga lotação

longitude_descarregamentostring | number

Longitude do ponto geográfico onde foi descarregado o MDF-e. Informar somente quando MDF-e for de carga lotação

quantidade_total_ctestring | number

Quantidade total de CT-e relacionados no Manifesto

quantidade_total_nfestring | number

Quantidade total de NF-e relacionados no Manifesto

quantidade_total_mdfe_aquaviariostring | number

Quantidade total de MDF-e relacionados no Manifesto Aquaviário

valor_total_cargastring | number

Valor total da carga / mercadorias transportadas

codigo_unidade_medida_peso_brutostring | number

Código da Unidade de Medida 01: KG 02: TON

peso_brutostring | number

Peso Bruto Total da Carga / Mercadorias transportadas

lacresarray de objeto

Lacres do MDF-e.

pessoas_autorizadasarray de objeto

Pessoas autorizadas a acessar o XML da MDF-e

informacao_adicional_fiscostring

Informações adicionais de interesse do Fisco

informacao_complementarstring

Informações complementares de interesse do Contribuinte

cnpj_responsavel_tecnicostring

CNPJ da pessoa a ser contatada na empresa desenvolvedora do sistema utilizado na emissão do documento fiscal eletrônico

contato_responsavel_tecnicostring

Nome da pessoa a ser contatada na empresa desenvolvedora do sistema

email_responsavel_tecnicostring

E-mail da pessoa a ser contatada na empresa desenvolvedora do sistema

telefone_responsavel_tecnicostring

Telefone da pessoa a ser contatada na empresa desenvolvedora do sistema

MdfeDataMunicipiosCarregamento2 campos

codigostring | number

Código do Município de Carregamento

nomestring

Nome do Município de Carregamento

MdfeDataPercursos1 campos

uf_percursostring

Sigla das Unidades da Federação do percurso do veículo.

MdfeDataMunicipiosDescarregamento5 campos

codigostring | number

Código do Município de descarregamento

nomestring

Nome do Município de descarregamento

conhecimentos_transportearray de objeto

Conhecimentos de Tranporte - usar este grupo quando for prestador de serviço de transporte

notas_fiscaisarray de objeto

Notas Fiscais Eletrônicas

mdfes_aquaviarioarray de objeto

Manifesto Eletrônico de Documentos Fiscais. Somente para modal Aquaviário (vide regras MOC)

MdfeDataMunicipiosDescarregamentoConhecimentosTransporte5 campos

chave_ctestring | number

Chave da CT-e

segundo_codigo_barrasstring | number

Segundo código de barras

indicador_reentregastring | number

Indicador de Reentrega

unidades_transportearray de objeto

Informações das Unidades de Transporte (Carreta/Reboque/Vagão).

produtos_perigososarray de objeto

Produtos Perigosos. Preenchido quando for transporte de produtos classificados pela ONU como perigosos.

MdfeDataMunicipiosDescarregamentoConhecimentosTransporteUnidadesTransporte5 campos

tipostring | number

Tipo da Unidade de Transporte 1: Rodoviário Tração 2: Rodoviário Reboque 3: Navio 4: Balsa 5: Aeronave 6: Vagão 7: Outros

identificacaostring

Identificação da Unidade de Transporte

lacresarray de objeto

Lacres das Unidades de Transporte

unidades_cargaarray de objeto

Informações das Unidades de Carga (Containeres/ULD/Outros)

quantidade_rateadastring | number

Quantidade rateada (Peso,Volume)

MdfeDataMunicipiosDescarregamentoConhecimentosTransporteUnidadesTransporteLacres1 campos

numero_lacrestring

Número do lacre

MdfeDataMunicipiosDescarregamentoConhecimentosTransporteUnidadesTransporteUnidadesCarga4 campos

tipostring | number

Tipo da Unidade de carga 1: Container 2: ULD 3: Pallet 4: Outros

identificacaostring

Identificação da Unidade de carga

lacresarray de objeto

Informações das Unidades de Carga (Containeres/ULD/Outros).

quantidade_rateadastring | number

Quantidade rateada (Peso,Volume)

MdfeDataMunicipiosDescarregamentoConhecimentosTransporteUnidadesTransporteUnidadesCargaLacres1 campos

numero_lacrestring

Número do Lacre

MdfeDataMunicipiosDescarregamentoConhecimentosTransporteProdutosPerigosos6 campos

numero_onustring

Número ONU/UN

nome_embarque_produtostring

Nome apropriado para embarque do produto

classe_riscostring

Classe ou subclasse/divisão, e risco subsidiário/risco secundário

grupo_embalagemstring

Grupo de Embalagem

quantidade_total_produtosstring

Quantidade total por produto

quantidade_tipo_volumestring

Quantidade e Tipo de volumes

MdfeDataMunicipiosDescarregamentoNotasFiscais5 campos

chave_nfestring

Chave da NF-e

segundo_codigo_barrasstring | number

Segundo código de barras

indicador_reentregastring | number

Indicador de Reentrega

unidades_transportearray de objeto

Informações das Unidades de Transporte (Carreta/Reboque/Vagão).

produtos_perigososarray de objeto

Produtos Perigosos. Preenchido quando for transporte de produtos classificados pela ONU como perigosos.

MdfeDataMunicipiosDescarregamentoNotasFiscaisUnidadesTransporte5 campos

tipostring | number

Tipo da Unidade de Transporte 1: Rodoviário Tração 2: Rodoviário Reboque 3: Navio 4: Balsa 5: Aeronave 6: Vagão 7: Outros

identificacaostring

Identificação da Unidade de Transporte

lacresarray de objeto

Lacres das Unidades de Transporte

unidades_cargaarray de objeto

Informações das Unidades de Carga (Containeres/ULD/Outros)

quantidade_rateadastring | number

Quantidade rateada (Peso,Volume)

MdfeDataMunicipiosDescarregamentoNotasFiscaisUnidadesTransporteLacres1 campos

numero_lacrestring

Número do lacre

MdfeDataMunicipiosDescarregamentoNotasFiscaisUnidadesTransporteUnidadesCarga4 campos

tipostring | number

Tipo da Unidade de carga 1: Container 2: ULD 3: Pallet 4: Outros

identificacaostring

Identificação da Unidade de carga

lacresarray de objeto

Informações das Unidades de Carga (Containeres/ULD/Outros).

quantidade_rateadastring | number

Quantidade rateada (Peso,Volume)

MdfeDataMunicipiosDescarregamentoNotasFiscaisUnidadesTransporteUnidadesCargaLacres1 campos

numero_lacrestring

Número do Lacre

MdfeDataMunicipiosDescarregamentoNotasFiscaisProdutosPerigosos6 campos

numero_onustring

Número ONU/UN

nome_embarque_produtostring

Nome apropriado para embarque do produto

classe_riscostring

Classe ou subclasse/divisão, e risco subsidiário/risco secundário

grupo_embalagemstring

Grupo de Embalagem

quantidade_total_produtosstring

Quantidade total por produto

quantidade_tipo_volumestring

Quantidade e Tipo de volumes

MdfeDataMunicipiosDescarregamentoMdfesAquaviario4 campos

chave_mdfestring | number

Chave do MDF-e

indicador_reentregastring | number

Indicador de Reentrega

unidades_transportearray de objeto

Informações das Unidades de Transporte (Carreta/Reboque/Vagão)

produtos_perigososarray de objeto

Produtos Perigosos. Preenchido quando for transporte de produtos classificados pela ONU como perigosos.

MdfeDataMunicipiosDescarregamentoMdfesAquaviarioUnidadesTransporte5 campos

tipostring | number

Tipo da Unidade de Transporte 1: Rodoviário Tração 2: Rodoviário Reboque 3: Navio 4: Balsa 5: Aeronave 6: Vagão 7: Outros

identificacaostring

Identificação da Unidade de Transporte

lacresarray de objeto

Lacres das Unidades de Transporte

unidades_cargaarray de objeto

Informações das Unidades de Carga (Containeres/ULD/Outros)

quantidade_rateadastring | number

Quantidade rateada (Peso,Volume)

MdfeDataMunicipiosDescarregamentoMdfesAquaviarioUnidadesTransporteLacres1 campos

numero_lacrestring

Número do lacre

MdfeDataMunicipiosDescarregamentoMdfesAquaviarioUnidadesTransporteUnidadesCarga4 campos

tipostring | number

Tipo da Unidade de carga 1: Container 2: ULD 3: Pallet 4: Outros

identificacaostring

Identificação da Unidade de carga

lacresarray de objeto

Informações das Unidades de Carga (Containeres/ULD/Outros).

quantidade_rateadastring | number

Quantidade rateada (Peso,Volume)

MdfeDataMunicipiosDescarregamentoMdfesAquaviarioUnidadesTransporteUnidadesCargaLacres1 campos

numero_lacrestring

Número do Lacre

MdfeDataMunicipiosDescarregamentoMdfesAquaviarioProdutosPerigosos6 campos

numero_onustring

Número ONU/UN

nome_embarque_produtostring

Nome apropriado para embarque do produto

classe_riscostring

Classe ou subclasse/divisão, e risco subsidiário/risco secundário

grupo_embalagemstring

Grupo de Embalagem

quantidade_total_produtosstring

Quantidade total por produto

quantidade_tipo_volumestring

Quantidade e Tipo de volumes

MdfeDataSegurosCarga7 campos

responsavel_segurostring | number

Responsável pelo seguro. Dados obrigatórios apenas no modal Rodoviário, depois da lei 11.442/07. Para os demais modais esta informação é opcional. 1: Emitente do MDF-e; 2: Responsável pela contratação do serviço de transporte (contratante)

cnpj_responsavelstring

Número do CNPJ do responsável pelo seguro. Obrigatório apenas se responsável pelo seguro for (2) responsável pela contratação do transporte - Pessoa Jurídica. Caso o responsável seja Pessoa Física informar a tag 'cpf_responsavel' e omitir esta tag.

cpf_responsavelstring | number

Número do CPF do responsável pelo seguro. Obrigatório apenas se responsável pelo seguro for (2) responsável pela contratação do transporte - Pessoa Física. Caso o responsável seja Pessoa Jurídica informar a tag 'cnpj_responsavel' e omitir esta tag.

nome_seguradorastring

Nome da Seguradora

cnpj_seguradorastring

Número do CNPJ da seguradora

numero_apolicestring

Número da Apólice

numero_averbacaostring

Número da Averbação

MdfeDataLacres1 campos

numero_lacrestring

Número do Lacre

MdfeDataPessoasAutorizadas2 campos

cnpjstring

CNPJ autorizado

cpfstring | number

CPF autorizado