Eventos de MDF-e
Os eventos permitem registrar ocorrências após a autorização de um MDF-e, como encerramento, cancelamento, inclusão de condutor ou documentos adicionais. Para acessar, clique em Eventos na tela principal do MDF-e.
Campos Comuns a Todos os Eventos
Todo evento de MDF-e requer o preenchimento dos seguintes campos antes de selecionar o tipo:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Chave de Acesso (chMDFe) | Sim | Chave de 44 dígitos do MDF-e de referência |
| Tipo de Documento | Sim | CNPJ ou CPF |
| CNPJ / CPF | Sim | Documento do emitente do MDF-e |
| UF | Sim | Estado do emitente |
| Tipo de Evento (tpEvento) | Sim | Selecione o evento desejado na lista |
| Número Sequencial (nSeqEvento) | Sim | Sequência do evento (padrão: 1) |
| Ambiente | Sim | Produção ou Homologação (padrão: Homologação) |
Após selecionar o Tipo de Evento, campos adicionais específicos serão exibidos dinamicamente.
Tipos de Eventos Disponíveis
110111 — Cancelamento
Cancela um MDF-e autorizado. Só é possível cancelar antes do encerramento.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Número do Protocolo (nProt) | Sim | Protocolo de autorização do MDF-e (15 dígitos) |
| Justificativa (xJust) | Sim | Motivo do cancelamento (mínimo 15, máximo 255 caracteres) |
110112 — Encerramento
Registra o encerramento do MDF-e após a entrega das mercadorias. Obrigatório ao término de cada viagem.
O Encerramento também pode ser feito diretamente pelo modal de Detalhes do MDF-e na tela principal.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Número do Protocolo (nProt) | Sim | Protocolo de autorização do MDF-e (15 dígitos) |
| Data de Encerramento (dtEnc) | Sim | Data em que o MDF-e foi encerrado |
| UF de Encerramento (cUF) | Sim | Estado onde ocorreu o encerramento |
| Município (cMun) | Sim | Município de encerramento — carregado automaticamente ao selecionar a UF |
| Encerramento por Terceiro (indEncPorTerceiro) | Não | Indica se o encerramento foi realizado por terceiro (Sim/Não) |
110114 — Inclusão de Condutor
Adiciona um novo condutor ao MDF-e já autorizado, quando houver substituição ou adição de motorista durante a viagem.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome do Condutor (condutor_xNome) | Sim | Nome completo (2 a 60 caracteres) |
| CPF do Condutor (condutor_CPF) | Sim | CPF do condutor (11 dígitos, sem pontuação) |
110115 — Inclusão de Documentos Fiscais
Vincula documentos fiscais adicionais (NF-e's) a um MDF-e já autorizado.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Número do Protocolo (nProt) | Sim | Protocolo de autorização do MDF-e (15 dígitos) |
| Cód. Município de Carregamento (cMunCarrega) | Sim | Código IBGE de 7 dígitos |
| Nome do Município de Carregamento (xMunCarrega) | Sim | Nome do município (2 a 60 caracteres) |
Documentos Fiscais (infDoc) — Adicione ao menos uma NF-e:
| Subcampo | Obrigatório | Descrição |
|---|---|---|
| Cód. Município de Descarregamento (cMunDescarga) | Sim | Código IBGE de 7 dígitos |
| Nome do Município de Descarregamento (xMunDescarga) | Sim | Nome do município (2 a 60 caracteres) |
| Chave de Acesso da NF-e (chNFe) | Sim | Chave de acesso completa de 44 dígitos |
110116 — Pagamento Operação de Transporte
Registra as informações de pagamento de uma operação de transporte vinculada ao MDF-e.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Número do Protocolo (nProt) | Sim | Protocolo de autorização do MDF-e (15 dígitos) |
| Quantidade de Viagens (qtdViagens) | Sim | Total de viagens realizadas (5 dígitos) |
| Número da Viagem (nroViagem) | Sim | Número de referência desta viagem (5 dígitos) |
Pagamentos do Frete (infPag) — Adicione ao menos um registro:
| Subcampo | Obrigatório | Descrição |
|---|---|---|
| Nome / Razão Social | Não | Nome do responsável pelo pagamento |
| Tipo de Documento | Sim | CNPJ / CPF / ID Estrangeiro |
| CNPJ / CPF / ID Estrangeiro | Sim | Documento do responsável |
| Componentes do Pagamento (Comp) | Sim | Tipo (01 Vale Pedágio / 02 Impostos / 03 Despesas / 04 Frete / 99 Outros) e valor |
| Valor Total do Contrato (vContrato) | Sim | Valor total acordado no contrato |
| Forma de Pagamento (indPag) | Sim | À Vista ou À Prazo |
| Valor do Adiantamento (vAdiant) | Condicional | Obrigatório quando pagamento À Prazo |
| Concorda com Antecipação | Condicional | Visível quando pagamento À Prazo |
| Dados Bancários | Não | Banco/Agência, CNPJ da instituição de pagamento ou chave PIX |
110117 — Confirmação de Serviço de Transporte
Confirma a prestação do serviço de transporte registrado no MDF-e.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Número do Protocolo (nProt) | Sim | Protocolo de autorização do MDF-e (15 dígitos) |
110118 — Alteração de Pagamento do Serviço de Transporte
Registra alterações nas condições de pagamento do serviço de transporte.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Número do Protocolo (nProt) | Sim | Protocolo de autorização do MDF-e (15 dígitos) |
Tabela Resumo dos Eventos
| Código | Nome | Uso principal |
|---|---|---|
| 110111 | Cancelamento | Cancela o MDF-e antes do encerramento |
| 110112 | Encerramento | Finaliza a viagem após entrega |
| 110114 | Inclusão de Condutor | Adiciona motorista em rota |
| 110115 | Inclusão de Documentos Fiscais | Inclui NF-e's adicionais ao manifesto |
| 110116 | Pagamento Operação de Transporte | Registra pagamento do frete |
| 110117 | Confirmação de Serviço de Transporte | Confirma a prestação do serviço |
| 110118 | Alteração Pagamento Serviço de Transporte | Altera condições de pagamento |
Resultado do Evento
Após transmitir, o sistema exibirá:
- Sucesso: O evento foi registrado pela SEFAZ — número do protocolo de evento gerado
- Erro / Rejeição: A SEFAZ recusou o evento — verifique a mensagem de retorno e os dados informados
Cada tipo de evento possui regras específicas da SEFAZ. Por exemplo, o Cancelamento só é possível antes do encerramento e dentro do prazo regulamentar. O Encerramento deve ser transmitido obrigatoriamente após a conclusão da viagem.