Cobrancas de Danos

O sistema de gerenciamento de danos permite que operadores de frota relatem, rastreiem e gerenciem danos em veiculos. Quando um dano e relatado, o sistema cria uma tarefa na fila de gerenciamento de frota para investigacao e resolucao. Este guia cobre como relatorios de danos funcionam e como eles se integram ao sistema de cobranca.

Como o Relatorio de Danos Funciona

Implementacao Atual

O sistema de danos opera como um fluxo de trabalho baseado em tarefas:

Integracao com Tarefas

Relatorios de danos sao armazenados na tabela tasks com:

• Prioridade: critical - garante visibilidade imediata
• Tag: Prefixo [damage] no titulo para filtragem facil
• Status: open - aguardando investigacao
• Link do Veiculo: Vinculado ao veiculo danificado

Fontes de Deteccao de Danos

Danos podem ser detectados atraves de multiplos canais:

Relatando Danos via API

Endpoint

POST /api/damages

Proposito: Cria uma nova tarefa de relatorio de dano para um veiculo

Formato da Requisicao

{
  "vehicle_number": "VEH-123",
  "note": "Guidao esquerdo entortado, possivelmente por colisao"
}

Parametros

Resposta de Sucesso (200)

{
  "ok": true
}

Respostas de Erro

Resolucao de Veiculo

A API de danos aceita multiplos formatos de identificador de veiculo:

Esta flexibilidade permite relatorios de danos de:

• Tecnicos de campo escaneando codigos QR
• Suporte ao cliente com numeros de veiculos
• Sistemas IoT com identificadores IMEI
• Sistemas backend com UUIDs

Fluxo de Trabalho de Danos

Passo 1: Deteccao

Identifique danos atraves de uma das fontes de deteccao. Documente o maximo de detalhes possivel sobre localizacao e gravidade do dano.

Passo 2: Relatorio

Envie o relatorio de dano atraves de:

• O endpoint /api/damages
• Criando uma tarefa diretamente no painel com prefixo [damage]

Passo 3: Investigacao

1. Tarefa aparece no painel em Tarefas ou Operacoes de Frota
2. Prioridade critica garante visibilidade imediata
3. Filtre por tag [damage] para ver todos os relatorios de danos
4. Atribua a um tecnico para investigacao

Passo 4: Avaliacao

O tecnico deve:

1. Localizar e inspecionar o veiculo
2. Documentar o dano com fotos
3. Estimar custos de reparo
4. Determinar se o cliente e responsavel

Passo 5: Resolucao

Com base na avaliacao:

• Dano menor: Registrar na tarefa, fechar como resolvido
• Reparo necessario: Agendar manutencao, atualizar status do veiculo
• Cliente responsavel: Iniciar processo de cobranca

Cobrando Clientes por Danos

Processo de Cobranca Manual

Atualmente, cobrancas de danos sao processadas manualmente atraves do painel:

Debito de Carteira

Para clientes com saldo de carteira, voce pode debitar a carteira diretamente:

1. Navegue ate Clientes e encontre o cliente
2. Visualize seu perfil
3. Crie uma transacao de carteira para o valor do dano
4. Documente o motivo da cobranca

Cobranca Stripe

Para cobrancas diretas no cartao quando a carteira e insuficiente:

1. Navegue ate o perfil do cliente
2. Use a funcao de cobranca com o metodo de pagamento armazenado
3. Adicione uma descricao: "Cobranca de dano: [descricao do dano]"
4. Documente o ID da tarefa e UUID do veiculo para referencia

Termos do Contrato de Servico

O contrato de servico da Levy inclui provisoes para responsabilidade por danos:

Responsabilidades do Cliente

De acordo com o contrato de servico padrao:

• Clientes sao responsaveis por danos durante seu periodo de aluguel
• Cobrancas de danos podem ser aplicadas por uso negligente
• Limites maximos de responsabilidade podem ser aplicados dependendo dos termos do contrato

Categorias de Avaliacao de Danos

Requisitos de Evidencia

Para cobranca de danos bem-sucedida:

1. Prova de data/hora - Quando o dano ocorreu
2. Associacao de viagem - Qual cliente estava com o veiculo
3. Documentacao fotografica - Fotos antes/depois
4. Avaliacao de danos - Avaliacao profissional

Integracao com Painel

Visualizando Relatorios de Danos

1. Navegue ate Painel > Tarefas
2. Filtre por prioridade: Critica
3. Busque por [damage] no titulo
4. Ou use filtro de tag se disponivel

Acoes de Tarefa

Visualizacao de Mapa da Frota

Veiculos danificados podem ser:

• Marcados com indicador de status especial
• Removidos da frota disponivel
• Marcados para recolhimento

Relatorios e Analytics

Encontrando Tendencias de Danos

Monitore padroes de danos para identificar:

• Veiculos problematicos com danos repetidos
• Locais ou zonas de alto dano
• Padroes de horario (fim de semana vs dia de semana)
• Padroes de cliente

Consultas Uteis

Tarefas de Danos dos Ultimos 30 Dias

SELECT
  DATE(created_at) as date,
  COUNT(*) as damage_count
FROM tasks
WHERE title LIKE '[damage]%'
  AND created_at > NOW() - INTERVAL '30 days'
GROUP BY DATE(created_at)
ORDER BY date;

Veiculos com Mais Relatorios de Danos

SELECT
  v.vehicle_number,
  v.model,
  COUNT(t.id) as damage_count
FROM vehicles v
JOIN tasks t ON t.vehicle_uuid = v.id
WHERE t.title LIKE '[damage]%'
GROUP BY v.id, v.vehicle_number, v.model
ORDER BY damage_count DESC
LIMIT 20;

Relatorios de Danos Nao Resolvidos

SELECT
  t.id,
  t.title,
  t.created_at,
  v.vehicle_number,
  t.assigned_to
FROM tasks t
JOIN vehicles v ON v.id = t.vehicle_uuid
WHERE t.title LIKE '[damage]%'
  AND t.status IN ('open', 'in_progress')
ORDER BY t.created_at ASC;

Melhores Praticas

Para Tecnicos de Campo

1. Seja descritivo - Inclua localizacao e tipo especifico do dano
2. Inclua estimativas - Registre dificuldade de reparo se conhecida
3. Tire fotos - Documente danos visualmente antes de reparar
4. Aja rapidamente - Prioridade critica significa atencao imediata

Para Gerentes de Frota

1. Revise diariamente - Verifique relatorios de danos todas as manhas
2. Rastreie padroes - Identifique veiculos ou locais problematicos
3. Documente completamente - Mantenha registros para fins de responsabilidade
4. Acompanhe - Garanta que todos os relatorios de danos cheguem a resolucao

Para Suporte ao Cliente

1. Verifique antes de cobrar - Confirme atribuicao de danos
2. Comunique claramente - Explique cobrancas ao cliente
3. Documente disputas - Registre respostas do cliente
4. Escale quando necessario - Encaminhe casos complexos para gerencia

Melhorias Futuras

O sistema de danos esta planejado para melhorias:

Recursos Planejados

1. Tabela de Danos Dedicada

   • Separada de tarefas para melhor rastreamento
   • Incluindo estimativas de custo, fotos, status de responsabilidade
   • Vinculacao a viagens especificas

2. Cobranca Automatizada

   • Cobrancas automaticas baseadas em avaliacao de danos
   • Integracao com sistema de tentativa de pagamento
   • Fluxo de trabalho de notificacao do cliente

3. Analise de Foto por IA

   • Deteccao automatica de danos em fotos de fim de viagem
   • Classificacao de gravidade
   • Comparacao antes/depois

4. Integracao de Seguro

   • Fluxo de trabalho de reclamacao de danos
   • Integracao com API de seguro
   • Rastreamento de cobertura

5. Pontuacao de Danos

   • Pontuacao de historico de danos do veiculo
   • Gatilhos de manutencao preditiva
   • Metricas de saude da frota

Solucao de Problemas

Problemas Comuns

Erro "Veiculo nao encontrado"

Causa: Identificador do veiculo nao corresponde a nenhum registro

Solucoes:

1. Verificar formato do numero do veiculo
2. Verificar se o veiculo existe no banco de dados
3. Tentar identificadores alternativos (QR, IMEI, UUID)

Tarefa Nao Aparece no Painel

Causa: Problema de filtro ou permissao

Solucoes:

1. Limpar filtros de tarefa
2. Verificar acesso a subconta do usuario
3. Verificar se tarefa foi criada (verificar banco de dados)

Cliente Nao Pode Ser Cobrado

Causa: Cliente nao tem metodo de pagamento ou saldo insuficiente

Solucoes:

1. Verificar se cliente tem metodos de pagamento registrados
2. Verificar se ID de cliente Stripe existe
3. Considerar debito de carteira se ha saldo
4. Contatar cliente para adicionar metodo de pagamento

Consultas de Diagnostico

Verificar Se Veiculo Existe

SELECT id, vehicle_number, qr_code, status
FROM vehicles
WHERE vehicle_number = 'VEH-123'
   OR qr_code = 'VEH-123';

Encontrar Tarefas de Dano para um Veiculo

SELECT t.*, v.vehicle_number
FROM tasks t
JOIN vehicles v ON v.id = t.vehicle_uuid
WHERE v.vehicle_number = 'VEH-123'
  AND t.title LIKE '[damage]%'
ORDER BY t.created_at DESC;

Relatorios de Danos Recentes

SELECT
  t.id,
  t.title,
  t.status,
  t.created_at,
  v.vehicle_number
FROM tasks t
JOIN vehicles v ON v.id = t.vehicle_uuid
WHERE t.title LIKE '[damage]%'
ORDER BY t.created_at DESC
LIMIT 20;

Proximos Passos

• Configuracao Stripe - Configurar integracao Stripe
• Metodos de Pagamento - Gerenciar cartoes de clientes
• Reembolsos Automaticos - Como reembolsos automaticos funcionam