Manual Configuração Envio Horario Inicio Viagem No Mdfe

---
title: Manual Configuração Envio Horario Inicio Viagem No Mdfe
slug: configuracao-envio-horario
sistema:
  - Servidor Nota Fiscal Eletrônica
chamado: "0000581111"
categoria: user_manual
tipo: how-to
autor: Mauricio Fujimoto
setor: Qualidade
modulo: Servidor Nota Fiscal Eletrônica
publico: ""
keywords: ["server.ini", "MINUTOS_ATRASO_INICIO_VIAGEM_MDFE", "dhIniViagem", "MDF-e", "averbação", "ATM", "Transportes"]
versao_doc: 01
revisao: Paulo Bley
aprovado_em: outubro de 2026
release: ""
ultima_revisao: "2026-10-19"
versao_pipeline: ia-forja
---

## Visão Geral

Descreve o processo de configuração do envio do horário de início da viagem no Manifesto Eletrônico de Documentos Fiscais (MDF-e). No arquivo XML (Extensible Markup Language), essa informação corresponde à tag `<dhIniViagem>` e é necessária para a averbação do MDF-e na ATM.

- **Quando usar:** quando a averbadora (como a ATM) retornar erro de hora de embarque.
- **Pré-requisitos:** servidor atualizado.

## Localização do arquivo de configuração

### Acessar a pasta de configuração do servidor

No Explorador de Arquivos do Windows, acesse o caminho:

`C:\teorema\javaapp\teoremaee7server\server\config`

### Abrir o arquivo server.ini

Localize e abra o arquivo `server.ini`. Na seção `[TEO_SERVER]`, identifique o parâmetro abaixo. Caso não esteja presente, adicione-o à seção `[TEO_SERVER]`.

```ini
[TEO_SERVER]
#MINUTOS_ATRASO_INICIO_VIAGEM_MDFE=0
```

![Bloco de notas com o arquivo server.ini aberto na pasta config do servidor, mostrando o comentário explicativo do parâmetro e a linha #MINUTOS_ATRASO_INICIO_VIAGEM_MDFE=0 destacada em amarelo](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/avulsos-ia/configuracao-envio-horario/configuracao-envio-horario-01.png)

## Definição do parâmetro

### Habilitar o parâmetro de início da viagem

Remova o caractere `#` do início da linha do parâmetro `MINUTOS_ATRASO_INICIO_VIAGEM_MDFE`.

### Informar a quantidade de minutos

Preencha o valor em minutos no parâmetro `MINUTOS_ATRASO_INICIO_VIAGEM_MDFE`. A demonstração apresentada utiliza o valor de 5 minutos.

> **Nota:** o valor padrão do parâmetro é 0 (zero). Os minutos informados são somados à hora de emissão do MDF-e ao montar a tag `<dhIniViagem>` do XML.

Exemplo de configuração apresentada:

```ini
MINUTOS_ATRASO_INICIO_VIAGEM_MDFE=5
```

![Bloco de notas com o arquivo server.ini mostrando a linha MINUTOS_ATRASO_INICIO_VIAGEM_MDFE=5 sem o caractere #, com anotação em vermelho indicando que o valor corresponde a minutos](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/avulsos-ia/configuracao-envio-horario/configuracao-envio-horario-02.png)

## Inicialização do servidor

### Iniciar o servidor com a configuração ajustada

Após ajustar o arquivo `server.ini` e com o servidor atualizado, inicie-o normalmente.

![Tela do gerenciador do servidor Teorema na aba Principal, com os endereços do container e do WS, o caminho da base de dados e a mensagem "Servidor está Online há 0m", com os botões Iniciar Servidor (desabilitado), Parar, Abrir, Atualizações e Logs](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/avulsos-ia/configuracao-envio-horario/configuracao-envio-horario-03.png)

## Acesso ao módulo Transportes

### Acessar o módulo Transportes

Acesse normalmente o módulo Transportes do sistema Teorema.

![Tela de login do módulo Transportes do sistema Teorema, com o painel do Teorema WMS à esquerda e, à direita, os campos de acesso (empresa, usuário e senha) e o botão Entrar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/avulsos-ia/configuracao-envio-horario/configuracao-envio-horario-04.png)

## Emissão e conferência do MDF-e

### Emitir o MDF-e e verificar a tag de início da viagem

Realize a emissão de um MDF-e conforme o processo habitual. No XML gerado, confira a tag `<dhIniViagem>`. No exemplo apresentado, o horário reflete os 5 minutos informados em `MINUTOS_ATRASO_INICIO_VIAGEM_MDFE`.

![XML do MDF-e exibido na tela Gestão MDF-e, com a tag dhIniViagem destacada (2026-10-08T13:46:42-03:00), 5 minutos após a dhEmi (2026-10-08T13:41:42-03:00)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/avulsos-ia/configuracao-envio-horario/configuracao-envio-horario-05.png)

## Resultado esperado

Após configurar `MINUTOS_ATRASO_INICIO_VIAGEM_MDFE`, o horário de início da viagem é apresentado na tag `<dhIniViagem>` do XML do MDF-e, conforme o valor em minutos informado no parâmetro.

> **Nota:** este documento não descreve procedimentos adicionais de validação na ATM nem critérios para definir o número de minutos.

## Informações do documento

> Autor: Mauricio Fujimoto
>
> Setor: Qualidade
>
> Módulo: Servidor Nota Fiscal Eletrônica
>
> Chamado: 581111
>
> Versão do Sistema:
>
> Versão do documento: 01
>
> Revisão: Paulo Bley
>
> Aprovado em: outubro de 2026


---

> 📎 **Arquivos originais:** [Manual_Configuração_envio_horario_inicio_viagem_no_MDFe.docx](https://drive.google.com/uc?export=download&id=1yjxfVTKp2XG9WiQ0s0JRUi6pzB9iUS-1)