🎯 Aba Hoje — o que fazer agora
A aba Hoje organiza a sua carteira em 5 prioridades, lado a lado. Cada coluna mostra 5 clientes por vez; quando você registra um card para um deles, ele sai e o próximo da fila entra no lugar. O número no canto da coluna é o tamanho da fila.
| Prioridade | Quem aparece | O que oferecer |
|---|---|---|
| 1️⃣ Preventiva recém-vencida | Chassi com preventiva vencida há até 90 dias que ainda não recebeu card de Preventiva Atrasada. | Agendar a preventiva — é a mais fácil de fechar. |
| 2️⃣ Entrega recente → PMP | Máquina entregue nos últimos 90 dias, ainda sem a 1ª preventiva e sem PMP. | Contrato PMP (ou a 1ª preventiva de 500h). |
| 3️⃣ Vencida há +90 dias | Chassi com preventiva vencida há mais de 90 dias, sem card de Preventiva Atrasada. | Retomar a preventiva. |
| 4️⃣ Relacionamento | Cliente sem preventiva, sem compra registrada e nunca prospectado. | Apresentar a Carmak e entender o parque. |
| 5️⃣ Renovação PMP | PMP que vence em até 30 dias (ou já venceu) e o cliente ainda não foi contatado desde que a janela abriu. | Renovar o contrato PMP. |
Cada card mostra: o motivo (ex.: "1 chassi venceu há 9d"), a próxima preventiva do ciclo, cidade, nº de máquinas e o último contato. Clique no card para abrir a ficha do cliente.
No topo ficam a meta do dia, quantos cards você já lançou e quantos faltam. "Demais clientes da carteira", no fim da página, lista quem não está em nenhuma prioridade, por dias sem contato.
📝 Como registrar uma prospecção (card)
- Clique no cliente (na aba Hoje, Carteira, Prev. Atrasadas ou Recontatos) para abrir a ficha.
- Em Registrar prospecção, escolha o tipo: 🔵 Avulso ou 🟠 Preventiva Atrasada.
- Se for Preventiva Atrasada, marque o(s) chassi(s) na lista de máquinas acima (os vencidos já vêm marcados).
- Escolha a tratativa, o tipo de contato (ligação, WhatsApp, e-mail, visita) e escreva as observações.
- Se precisar voltar a falar com o cliente, preencha Agendar recontato com a data e o lembrete.
- Clique em ✓ Registrar prospecção.
| Tipo | Quando usar |
|---|---|
| 🔵 Avulso | Relacionamento: apresentação, retorno de proposta, visita, qualquer contato que não seja sobre uma preventiva vencida específica. |
| 🟠 Preventiva Atrasada | Contato sobre um chassi com preventiva vencida. É obrigatório marcar o chassi — sem chassi marcado o card conta como Avulso e a máquina continua na fila. |
🔧 Preventivas — vencimento e ciclo
As datas vêm da UIO (base do Protheus). A ferramenta nunca altera datas: elas só mudam quando uma nova UIO é importada.
| Conceito | Regra |
|---|---|
| Vencimento | Última preventiva + 90 dias. |
| Data de entrega | Quando a UIO traz data sem ciclo, é a data da entrega. A 1ª preventiva vence em entrega + 90 dias. |
| Em dia | O vencimento ainda não chegou. |
| Atrasada | Passou do vencimento. Faixas: até 90 dias · 91 a 180 · mais de 180 (crítico). |
| Sem histórico | Máquina sem nenhuma data na UIO. |
Ciclo preventivo:
Nos cards aparece ➡️ Próxima com a preventiva que o cliente deve fazer. Máquina que nunca fez preventiva mostra "1ª preventiva 500h".
A página Prev. Atrasadas lista todos os clientes com chassi vencido, do vencimento mais recente para o mais antigo, com filtro por faixa de atraso e exportação para Excel.
📅 Recontatos
O recontato é um lembrete que você agenda dentro do card ("Agendar recontato").
- No dia agendado (ou se estiver atrasado) ele aparece no topo da aba Hoje e no sino 🔔 de notificações.
- A página Recontatos mostra todos, com filtros (atrasados, hoje, 7 e 30 dias), envio por e-mail e Excel.
- Baixa automática: qualquer novo card lançado para o cliente encerra o recontato anterior. Se o novo card agendar outro recontato, passa a valer o novo.
🔄 Giro de contas
Quando ativado, o servidor confere a carteira todo dia e passa para o próximo consultor da ordem as contas que estão paradas:
- Regra 1: 90 dias sem prospecção (card) e sem venda.
- Regra 2: teve prospecção, mas 180 dias sem venda.
- Conta como venda: venda do Pós-venda (UIO), preventiva realizada e entrega de máquina.
- Não giram: clientes com contrato vigente (PMP ou contrato de manutenção), clientes descartados permanentemente e clientes de consultores que não estão em nenhum rodízio.
- Rodízio por equipe: cada equipe tem o seu rodízio — a conta só passa para outro consultor da mesma equipe (ex.: contas da filial não vão para o time do Sul).
- A contagem começa na data base definida na Administração e reinicia sempre que a conta muda de consultor.
- Quando faltam até 15 dias, o card no Hoje mostra "🔄 Gira em Nd"; na ficha do cliente o aviso aparece com 30 dias.
- O giro fica registrado como transferência, e o report da UIO mantém o consultor novo.
👥 Carteira e ficha do cliente
Cada cliente é um CNPJ. A ficha mostra os dados do cliente, as máquinas, os contatos e o histórico de cards.
Máquinas: cada uma mostra o contrato da UIO, se é Nova ou Usada, o nº de série, a última preventiva, a situação (em dia / atrasada) e a próxima preventiva.
Tipo de manutenção — informe o que você sabe do cliente; isso alimenta o report da UIO para a Toyota:
| Opção | Significado |
|---|---|
| Avulsa | Faz manutenção com a Carmak quando precisa, sem contrato. |
| Contrato PMP | Tem contrato PMP com a Carmak. |
| Contrato | Tem contrato de manutenção com a Carmak. |
| Manutenção própria | O cliente faz a manutenção com equipe própria. |
| Manutenção de terceiros | Faz manutenção com outra empresa. |
| Fora de operação | A máquina está parada / não está em uso. |
Incluir máquina: se o cliente tem uma máquina que não está na lista, clique em + Incluir e informe marca, modelo, chassi/nº de série, ano, localização e tipo de manutenção. Se o chassi já existir em outro cliente, o sistema avisa. Quando ela chegar pela UIO, é conciliada automaticamente.
Contratos com vencimento: PMP e Contrato de Manutenção têm data de vencimento (vem da UIO). A partir de 30 dias antes o cliente entra na Renovação PMP (5); passada a data sem renovação, a máquina vira Manutenção Avulsa automaticamente (aparece "⌛ PMP vencido em…" na ficha). Se renovar, a nova data chega pela UIO e o contrato volta a valer.
Contatos: cadastre nome, cargo, telefone e e-mail das pessoas do cliente.
⛔ Descartar (botão na ficha) tem quatro opções:
- Pausar 30 dias — o cliente sai das suas listas e volta depois de 30 dias.
- Descartar permanentemente — não prospectar mais (ex.: fechou, não opera mais).
- Sem interesse em preventiva — o cliente sai só das prioridades de preventiva (Hoje 1, 2, 3 e 5 e Prev. Atrasadas) por 180 dias. Continua na Carteira para outras prospecções (peças, reforma, locação…) e continua no giro de contas.
- Transferir para outro consultor — quando o cliente não é da sua carteira. A transferência fica registrada e é respeitada nas próximas atualizações da UIO.
Cliente descartado continua acessível: a busca da Carteira encontra o cliente (marcado), a ficha abre normalmente e você pode lançar uma nova prospecção — ao salvar, a ferramenta pergunta se quer reativar o cliente. O botão ↩ Estornar descarte (na ficha ou na lista "Descartados" da aba Hoje) desfaz a pausa, o descarte permanente ou o "sem interesse em preventiva". A transferência não tem estorno.
📊 Dashboard
| Aba | O que mostra |
|---|---|
| 📊 Visão geral | Situação das preventivas por máquina e a análise das prospecções: cards lançados, meta, ritmo do mês × mês anterior, cards por mês e por consultor, tipo de contato, tratativas e conversão. |
| 🚚 Máquinas entregues | Entregas por mês, 1ª preventiva vencida, contato pós-entrega e % de contrato na venda (PMP ou Contrato). |
| 🎯 Potencial | População de máquinas por tipo de manutenção, mapa de calor, cobertura (histórico preventivo ou contrato) e ranking de clientes. |
| ♻️ Recuperação | Máquinas sem PMP/contrato em 4 segmentos, na ordem de esforço: 1º recorrentes que pararam (última preventiva há +180 dias) · 2º entregas dos últimos 12 meses (vender PMP) · 3º sem contrato e sem preventiva (inclui seminovas) · 4º último passo (sem registro na UIO ou máquina antiga). |
| 🔄 Renovação de frota | Máquinas com mais de 10 anos — oportunidade de venda de máquina nova ou Rental. |
🎯 Conversão — a prospecção virou resultado?
A ferramenta mede a conversão sozinha, com os dados da UIO — você não precisa lançar nada a mais.
| Card | Convertido quando… |
|---|---|
| 🔵 Avulso | O cliente teve venda do Pós-venda (peças ou serviços) em até 30 dias depois do card. |
| 🟠 Preventiva Atrasada | Algum chassi marcado no card teve preventiva registrada em até 30 dias depois do card. |
A venda conta para o último card lançado antes dela. "⏳ Em aberto" = os 30 dias ainda não fecharam na última UIO importada. Por isso marcar o chassi no card de preventiva é tão importante: sem ele não dá para medir o resultado.
📖 Glossário
- UIO
- Base de máquinas em operação (Units In Operation) extraída do Protheus. É a fonte das máquinas, datas e contratos.
- Datasul / Chassi
- Identificação da máquina. No sistema aparece como S/N (ex.: T8FG25B-10162).
- Card
- Registro de um contato com o cliente (uma prospecção).
- PMP
- Contrato de manutenção preventiva programada da Carmak.
- Contrato de Manutenção
- Contrato de manutenção da Carmak (diferente do PMP).
- Manutenção Avulsa
- Cliente sem contrato, que compra preventiva/serviço quando precisa.
- Ciclo
- Sequência das preventivas: 500h → 1000h → 1500h → 2000h → reinicia em 500h.
- Cobertura
- Máquina com histórico de preventiva ou com contrato (PMP ou Contrato).
- Seminova
- Máquina entregue 5 anos ou mais depois do ano de fabricação (reformada).
- Recontato
- Lembrete agendado num card para voltar a falar com o cliente.
- Descarte
- Tirar o cliente das listas por 30 dias (pausa) ou de vez (permanente).
- Meta
- Quantidade de cards por dia útil (padrão: 10).
❓ Perguntas frequentes
Se ele está na prioridade 1 ou 3, o chassi vencido precisa ser marcado num card de Preventiva Atrasada. Um card Avulso tira o cliente da tela só naquele dia.
Nenhum chassi foi marcado. Edite o card no Histórico ou lance um novo marcando a máquina.
Na ficha, use ⛔ Descartar → Transferir para outro consultor.
Inclua pela ficha (+ Incluir). Ela vai para a UIO atualizada e é conciliada quando chegar pelo Protheus.
As datas e contratos vêm do Protheus. Avise o backoffice/gestor para corrigir na UIO. O tipo de manutenção você mesmo pode informar na ficha.
Lance um novo card com o recontato — ele substitui o anterior.
Veja o ➡️ Próxima no card ou na ficha (ciclo 500h → 1000h → 1500h → 2000h → 500h).
⚙️ Para gestores — UIO, conflitos e exportação
Importar a UIO (Base de Dados): selecione a planilha → a ferramenta mostra uma prévia (nada é gravado) com tudo o que vai mudar → confira e clique em Confirmar e Aplicar.
| Informação | Regra na importação |
|---|---|
| Datas (preventiva, venda, vencimento PMP) | A UIO atualiza. Preventiva só avança (nunca volta); data futura vai para "Para revisar". |
| Cards, contatos, recontatos, descartes | A UIO nunca mexe. |
| Transferência e UIO com o consultor antigo | Mantém o da ferramenta. |
| Transferência e UIO com um terceiro consultor | ⚠️ Conflito para validar. |
| Tipo de manutenção do consultor × UIO Avulsa/Própria/Terceiros | Mantém o do consultor. |
| UIO com PMP/Contrato com data de vencimento vigente | Atualiza automaticamente (contrato fechado). |
| PMP/Contrato com data de vencimento já passada (+ carência) | Vira Manutenção Avulsa — todo dia e também na importação (a UIO com data antiga não volta o contrato). Aparece em "Contratos vencidos". |
| PMP/Contrato sem data de vencimento | Continua contrato; listado para o backoffice completar a data. |
| UIO com PMP/Contrato sem data de vencimento | ⚠️ Conflito para validar. |
| Máquina incluída pelo consultor que chegou pela UIO | ⚠️ Conflito (padrão: conciliar). |
No bloco de Conflitos, o padrão é sempre manter o que foi atualizado na ferramenta. A decisão fica registrada e é reaplicada nas próximas importações enquanto a UIO trouxer o mesmo valor.
Baixar UIO atualizada: gera a última UIO completa com as alterações da ferramenta (consultor, tipo de manutenção, máquinas incluídas) e as colunas que mostram o que mudou — para o report Toyota e para o backoffice corrigir o Protheus.
E-mail da gestão: cada gestor recebe, em dias úteis, o desempenho da sua equipe no dia útil anterior (cards × meta, avulso × preventiva, clientes, meta do mês, recontatos atrasados, fila da prioridade 1 e renovações, pontos de atenção). A equipe de cada gestor é definida em Administração → Equipes.
E-mail diário: em Administração → Configurações, liga/desliga o envio, horário, quantos clientes por prioridade, link da ferramenta e feriados. Dá para ver a prévia do e-mail de qualquer consultor, receber a prévia no seu e-mail e enviar na hora. Só recebe quem tem e-mail cadastrado no usuário.
Administração: configurações da ferramenta (prazos e regras da aba Hoje, preventivas, ciclo, dashboards e apelidos de consultor na UIO), usuários (criar e editar: perfil, consultor vinculado, e-mail, meta diária e senha), tratativas e e-mail.
| Consultor ↕ | 🟢 Em dia ↕ | Até 3m ↕ | 3–6m ↕ | 6–12m ↕ | +1 ano ↕ | Atrasadas ↕ | Prosp. atrasadas ↕ | Cob. atrasadas ↕ | 🟣 Sem hist. ↕ | Vencem no mês ↕ | Cob. mês ↕ |
|---|
| Consultor | Hoje | Meta/dia | Meta período | Realizado | % Meta | Avulsas | Prev. Atr. | Clientes | Agendamentos | Conv. Avulsa | Conv. Prev. | Recontatos Pend. | Último |
|---|
1. Baixe o arquivo email_server.py (entregue junto com este sistema)
2. Instale as dependências:
pip install flask flask-cors3. Abra o arquivo e defina sua senha em
SMTP_PASSWORD4. Execute:
python email_server.py5. Deixe a janela aberta enquanto usa o sistema
6. Clique em 🧪 Testar conexão para confirmar
⚠️ O servidor precisa estar rodando para os e-mails funcionarem.
2. Selecione o arquivo .xlsx abaixo — o sistema monta uma prévia sem gravar nada
3. Confira o relatório (preventivas atualizadas, máquinas e clientes novos, itens para revisar) e clique em ✅ Confirmar e Aplicar
Entram só máquinas Comercial com consultor (Rental e "Desconsiderar" são ignorados). Preventivas só são atualizadas quando a data da planilha é mais recente. O consultor de cada cliente continua o do sistema.
⚠️ Histórico de prospecções, recontatos e descartes não são apagados.
No fim de cada linha: ATUALIZADO PELA FERRAMENTA, O QUE MUDOU, o valor que estava na UIO, quem alterou e quando. A aba Para atualizar na UIO lista só as alterações.