Serviço de Encerramento Automático de MDF-e – ONIX

O Serviço de Encerramento Automático de MDF-e foi desenvolvido com o objetivo de otimizar e automatizar o processo de encerramento dos Manifestos Eletrônicos de Documentos Fiscais (MDF-e) no sistema Onix.
Atualmente, o encerramento é realizado manualmente pelos usuários, o que tem gerado falhas de operação, encerramentos incorretos e, consequentemente, multas fiscais e retrabalho. Para eliminar esses problemas e garantir maior confiabilidade no processo, foi criado um Windows Service responsável por realizar o encerramento de forma automática e controlada.
Esta página tem como objetivo orientar sobre a instalação, configuração e funcionamento do serviço, além de explicar sua importância dentro do fluxo operacional e fiscal do sistema Onix.

Regras de Encerramento do MDF-e

1. Encerramento Automático

O encerramento automático do MDF-e é realizado após transcorrido o tempo mínimo configurado por estado.

Isso significa que mesmo que o motorista informe no aplicativo que a entrega foi concluída, o sistema não encerra o MDF-e imediatamente.
O encerramento só será efetivado após o prazo mínimo definido para o estado de destino do MDF-e:

EstadoTempo mínimo para encerramento automático
PRImediato (no mesmo dia)
SC, MS, SP, MG, RS1 dia
MT, GO2 dias
Demais estados3 dias

🕒 Exemplo prático

Se o motorista emitiu um MDF-e com destino Goiás (GO) e informou a entrega no app logo após sair para viagem, o sistema aguardará 2 dias após a data de emissão do MDF-e para realizar o encerramento automático.

2. Fretes Únicos

Quando o MDF-e estiver vinculado a apenas um frete, o encerramento automático poderá ser realizado assim que o status da entrega, na plataforma OJO, estiver como “Chegou para entrega” ou “Entrega Finalizada”.

Nesse caso, o sistema identifica que a viagem possui somente uma entrega e, portanto, pode encerrar automaticamente o MDF-e, respeitando o prazo mínimo de encerramento definido para o estado de destino.

3. Viagens com Múltiplos Fretes

Quando o MDF-e estiver vinculado a mais de um frete, o encerramento automático somente ocorrerá após todos os fretes relacionados à viagem receberem o evento de “Chegou para entrega” ou “Entrega finalizada”.

Isso garante que o encerramento seja feito apenas quando todas as entregas vinculadas à viagem tiverem sido concluídas, evitando o encerramento antecipado do MDF-e.

4. Encerramento Manual

A opção de encerramento manual continua disponível para situações específicas, nas quais o MDF-e não é integrado ao OJO (ou seja, quando o controle da viagem não é feito pelo aplicativo).

Nesses casos, o usuário poderá encerrar o MDF-e manualmente pelo sistema, informando os dados necessários

🔍 Observação

Quando toda a viagem tiver sido entregue, o sistema ONIX exibirá automaticamente o status atualizado do MDF-e, indicando que todas as entregas foram concluídas.

Tarefas ⇨ MDFe-Manifesto Eletrônico de Documentos Fiscais ⇨ Encerramento automático via OJO frete

Essa informação aparece de forma clara na tela de acompanhamento, permitindo que o usuário visualize que todas as cargas vinculadas ao MDF-e foram finalizadas.

Download e Extração dos Arquivos de Instalação

1. Download dos Arquivos

Acesse o link abaixo para realizar o download das pastas de instalação:
🔗 https://update.softniels.com.br/INSTALACAO/Services

Na página que será aberta, clique sobre o arquivo MDFeIntegradorService:

2. Extração dos Arquivos

Após o download ser concluído, extraia o conteúdo do arquivo baixado:

  1. Localize o arquivo baixado no seu computador.
  2. Clique com o botão direito do mouse sobre ele.
  3. Selecione a opção “Extrair tudo…”.
  4. Escolha o destino onde os arquivos serão extraídos e clique em “Extrair”.

3. Copiar os Arquivos Extraídos

Após realizar a extração do arquivo:

  1. Abra a pasta extraída.
  2. Selecione todos os arquivos contidos nela.
  3. Clique com o botão direito do mouse sobre os arquivos selecionados e escolha a opção “Copiar”.

💡 Dica: para selecionar todos os arquivos de uma vez, pressione as teclas Ctrl + A no teclado.

4. Criar a Pasta “Service” no Diretório do ONIX

  1. Acesse o caminho:
    Disco Local (C:) ⇨ Softniels ⇨ ONIX
  2. Dentro da pasta ONIX, crie uma nova pasta com o nome “Service”.

Para criar a nova pasta:

  • Clique com o botão direito do mouse em uma área vazia da janela.
  • No menu que será exibido, selecione “Novo” ➜ “Pasta”.
  • Digite o nome Service e pressione Enter.

5. Renomear e Colar os Arquivos

  1. Após concluir os passos para criar a nova pasta, renomeie-a para “Service” (caso ainda não tenha feito).
    • Clique com o botão direito do mouse sobre a pasta criada.
    • Selecione a opção “Renomear”.
    • Digite Service e pressione Enter.
  2. Em seguida, abra a pasta “Service” e cole nela todos os arquivos copiados anteriormente.
    • Para colar, pressione Ctrl + V ou clique com o botão direito em uma área vazia e escolha “Colar”.

6. Configurar o Ambiente de Trabalho

Depois de colar os arquivos na pasta, localize o arquivo de configuração MDFeIntegrador.ini e abra-o.

Esse arquivo permite configurar as informações do ambiente de trabalho.

7. Instalar o Serviço

Após realizar as configurações:

  1. Localize o arquivo InstallService dentro da pasta Service.
  2. Clique com o botão direito do mouse sobre o arquivo.
  3. Selecione a opção “Executar como administrador”.

8. Iniciar o Serviço do Integrador MDF-e

Após a instalação, é necessário iniciar o serviço para que o integrador entre em funcionamento.

  1. Vá até a barra de pesquisa do Windows e digite “Serviços”.
  2. Clique para abrir a janela Serviços.
  3. Localize o serviço com o nome “ONIX MDFe Integrador Service”.
  4. Clique com o botão direito do mouse sobre ele.
  5. Selecione a opção “Iniciar”.

💡 Dica: você pode também configurar o tipo de inicialização como Automático, para que o serviço seja iniciado sempre que o Windows for ligado.

Ciclo de Atualização:

O serviço é executado automaticamente a cada 30 minutos para identificar novas viagens encerradas e realizar a atualização no sistema ONIX.

Desinstalar o Serviço

Caso seja necessário remover o integrador do sistema:

  1. Acesse novamente a pasta Service (em C:\Softniels\ONIX\Service).
  2. Localize o arquivo UninstallService.
  3. Clique com o botão direito do mouse sobre ele e selecione “Executar como administrador”.

⚠️ Atenção: essa ação desinstalará completamente o serviço ONIX MDFe Integrador Service do Windows.
Use essa opção apenas quando precisar reinstalar ou atualizar o integrador.

Esse artigo foi útil?

Comments are closed.