(RELATÓRIO 0302) Relatório de Acompanhamento de Checkin e Checkout
Resumo da Nota Técnica
O Relatório de Acompanhamento de Checkin e Checkout tem como objetivo apresentar, de forma consolidada, os registros de checkin e checkout realizados nos atendimentos de ordens de serviço.
O relatório exibe, para cada atendimento, a ordem de serviço, o cliente, o técnico responsável, o endereço do cliente, as datas e horários de checkin e checkout, além da distância em metros entre o endereço cadastrado e as coordenadas registradas no momento do checkin e do checkout.
Com isso, o usuário pode acompanhar a execução dos atendimentos em campo e verificar se o técnico realizou o checkin e o checkout dentro da proximidade esperada do endereço do cliente.
para acessar o relatorio siga o caminho: aplicativos -> Ordens de Serviço -> botão de impressora no canto superior direito da tela -> Acompanhamento de checkin e checkout.
Detalhes da Nota Técnica
Objetivo do relatório O relatório foi desenvolvido para permitir o acompanhamento dos atendimentos de ordens de serviço que possuem registro de checkin e checkout.
Cada linha do relatório representa um atendimento registrado na tabela de atendimentos da ordem de serviço, permitindo visualizar individualmente os horários e a localização de cada registro realizado pelo técnico.
Filtros disponíveis Na geração do relatório, o usuário pode informar os seguintes filtros:
Data inicial — considera atendimentos cuja data de checkin seja igual ou posterior à data informada; Data final — considera atendimentos cuja data de checkin seja igual ou anterior à data informada; Técnico — permite filtrar os atendimentos pelo técnico/representante responsável; quando não informado ou selecionada a opção "Todos", o relatório considera todos os técnicos; Cliente — permite filtrar os atendimentos pelo cliente da ordem de serviço; quando não informado ou selecionada a opção "Todos", o relatório considera todos os clientes. Os filtros aplicados são exibidos no cabeçalho do relatório gerado.
Informações exibidas O relatório apresenta as seguintes colunas:
Coluna Descrição O.S Número da ordem de serviço vinculada ao atendimento Cliente Razão social do cliente Tecnico Nome do técnico/representante responsável pelo atendimento Endereço Endereço principal cadastrado do cliente Data Data do checkin ckin Hora do checkin distancia[m] (checkin) Distância em metros entre o endereço do cliente e as coordenadas do checkin ckout Hora do checkout distancia[m] (checkout) Distância em metros entre o endereço do cliente e as coordenadas do checkout Quando o cliente não possui endereço cadastrado ou não há coordenadas de checkin/checkout registradas, as colunas de endereço e distância permanecem em branco.
Origem dos dados O relatório utiliza as informações registradas nos atendimentos da ordem de serviço, incluindo:
Data e hora inicial e final do atendimento (checkin e checkout); Coordenadas geográficas do checkin e do checkout; Técnico/representante vinculado ao atendimento; Dados da ordem de serviço e do cliente associado. O endereço exibido é obtido a partir do endereço principal cadastrado para o cliente.
Cálculo de distância e situação Para cada atendimento, o relatório calcula a distância em metros entre o endereço do cliente e:
as coordenadas registradas no checkin; as coordenadas registradas no checkout. O cálculo é realizado por meio da fórmula de Haversine, considerando latitude e longitude do endereço e dos pontos registrados.
Internamente, o relatório também classifica a situação do checkin e do checkout conforme a distância calculada:
OK — distância igual ou inferior a 300 metros; Fora — distância superior a 300 metros. Essas informações de situação são utilizadas no processamento do relatório. Na visualização em PDF, são exibidas principalmente as distâncias em metros.
Ordenação e layout Os registros são ordenados por:
Nome do cliente; Nome do técnico; Data e hora do checkin. O relatório é gerado em formato A4 paisagem, com cabeçalho contendo o nome da empresa, o título do relatório e os filtros aplicados na geração.
