====== Transmissor de Dados ======

===== O que é o Transmissor =====

O **Transmissor** é um programa instalado no computador da loja (sistema operacional Windows) que conecta o sistema de gestão ao Ello Dash. Ele lê automaticamente os dados de vendas, movimentos financeiros e estoque do banco de dados local e os envia para o servidor Ello.

**Sem o Transmissor em funcionamento, os dados do painel não são atualizados.**

===== Como instalar o Transmissor =====

A instalação é feita uma única vez em cada computador da loja.

==== 1. Baixe os arquivos necessários ====

Baixe os 3 arquivos a seguir e salve-os na pasta **C:\Ello\Windows** do computador da loja:

  * [[https://dl.ellotecnologia.com/Ferramentas/ElloDash/transmissor_metricas.exe|Transmissor (transmissor_metricas.exe)]]
  * [[https://dl.ellotecnologia.com/Ferramentas/ElloDash/transmissor_config.ini|Arquivo de configuração (transmissor_config.ini)]]
  * [[https://dl.ellotecnologia.com/Ferramentas/ElloDash/AgendadorTarefasTransmissorElloDash.bat|Agendador de tarefas (AgendadorTarefasTransmissorElloDash.bat)]]

==== 2. Configure o arquivo de configuração ====

Abra o arquivo **transmissor_config.ini** no Bloco de Notas e preencha as informações do banco de dados da loja:

  * **nome**: Nome da empresa (ex: Matriz)
  * **hostname**: Endereço do servidor do banco de dados (geralmente: localhost)
  * **porta**: Porta de conexão (padrão: 3050)
  * **username**: Usuário do banco de dados
  * **password**: Senha do banco de dados
  * **database**: Caminho completo do arquivo do banco de dados na loja
  * **ativo**: Mantenha como **sim**

Caso a loja tenha mais de um banco de dados (filiais), cada banco pode ser configurado como uma seção separada no mesmo arquivo.

==== 3. Crie a tarefa agendada ====

Dê um duplo clique no arquivo **AgendadorTarefasTransmissorElloDash.bat**. Ele criará automaticamente a tarefa no Agendador de Tarefas do Windows para executar o Transmissor a cada 5 minutos.

Após esses três passos, o Transmissor estará ativo e enviando dados automaticamente.

===== Envio do histórico dos últimos 3 meses =====

Na primeira instalação, é recomendável enviar os dados dos últimos 3 meses para que o painel seja preenchido com histórico. Para isso:

  - Abra o Prompt de Comando (CMD) do Windows
  - Navegue até a pasta **C:\Ello\Windows**
  - Execute o Transmissor com a opção de envio de histórico (argumento **-t**)

A equipe Ello Tecnologia pode auxiliar nesse processo se necessário.

===== Como o Transmissor funciona no dia a dia =====

  - O Transmissor roda automaticamente a cada **5 minutos** por meio do Agendador de Tarefas do Windows
  - A cada execução, ele coleta os dados mais recentes do banco de dados da loja
  - Os dados são enviados ao servidor em pequenos pacotes para garantir estabilidade mesmo em conexões mais lentas
  - Se algum envio falhar, o Transmissor tenta novamente automaticamente (até 5 tentativas)
  - Os dados enviados ficam disponíveis no servidor por **90 dias**; registros mais antigos são removidos automaticamente

===== Dados que o Transmissor envia =====

A cada execução, o Transmissor coleta e envia os seguintes tipos de informação:

  * Vendas realizadas (por vendedor e meio de pagamento)
  * Ranking de produtos vendidos
  * Situação das notas fiscais emitidas
  * Contas a receber (parcelas)
  * Contas a pagar (parcelas)
  * Saldo das contas financeiras/bancárias
  * Notas de entrada de mercadoria

===== Atualização automática =====

O Transmissor verifica automaticamente se há uma versão mais recente disponível no servidor. Quando uma atualização é encontrada:
  - O novo arquivo é baixado automaticamente
  - O programa se substitui pela versão atualizada
  - Não é necessária nenhuma ação manual

===== Registros de atividade =====

O Transmissor mantém um arquivo de registro de todas as suas atividades. Esse arquivo fica salvo na seguinte pasta do computador da loja:

**C:\Ello\Windows\Log\DASH\**

O arquivo de registro é útil para identificar erros e confirmar que os envios estão ocorrendo normalmente.

===== Problemas comuns =====

==== Os dados no painel não estão atualizando ====

  - Verifique se o computador da loja está **ligado e conectado à internet**
  - Abra o Agendador de Tarefas e confirme que a tarefa do Transmissor está ativa e sem erros
  - Consulte o arquivo de registro para identificar mensagens de erro
  - Confirme que o arquivo de configuração está com as informações corretas

==== O Transmissor apresenta erro de versão incompatível ====

O servidor pode rejeitar dados de uma versão desatualizada do Transmissor. Nesse caso:
  - Verifique se o computador da loja tem acesso à internet para baixar a atualização automática
  - Se o download automático não funcionar, entre em contato com a equipe Ello Tecnologia para receber o arquivo atualizado manualmente

==== Erros de conexão com o banco de dados da loja ====

  - Confirme que o sistema de gestão da loja está funcionando normalmente
  - Verifique se o banco de dados está acessível no computador onde o Transmissor está instalado
  - Entre em contato com a equipe Ello Tecnologia para verificar as configurações