Tipo Ocorrência

Descrição Geral

O módulo "TIPO OCORRÊNCIA" gerencia os tipos de ocorrências relacionadas à roteirização no sistema de gestão de frotas "CONCEPT RASTREAMENTO". É compostO por duas telas principais: uma tela de listagem (grid) que apresenta todos os tipos de ocorrências cadastrados e uma tela de cadastro/edição que permite adicionar novos tipos ou modificar os existentes.

O módulo está focado na categorização e atribuição de responsabilidades para diferentes tipos de ocorrências que podem acontecer durante operações logísticas, permitindo definir se o erro é de responsabilidade do motorista, vendedor ou conferente, além de atribuir um peso numérico para cada tipo de erro.

Para acessar clique no menu ROTEIRIZAÇÃO opção TIPOS DE OCORRÊNCIAS.

Elementos da Interface

Tela de Listagem (Tipo de Ocorrências)

Seção de Filtros

Nome: Campo de texto para filtrar ocorrências pelo nome
Botões de Ação:
- Botão de Pesquisa (ícone de lupa): Executa a pesquisa com base no filtro
- Botão Limpar Filtros (ícone de arquivo): Limpa o campo de filtro
- Botão Novo (ícone de adição): Abre a tela de cadastro para novo registro
- Botão Exportar para CSV (ícone de salvar): Exporta os dados em formato CSV
- Botão Importar: Abre um popup para importação de dados via CSV

Tabela de Dados

Colunas:
- NOME: Nome do tipo de ocorrência
- ERRO MOTORISTA: Indica se a ocorrência é atribuída ao motorista (SIM ou -)
- ERRO VENDEDOR: Indica se a ocorrência é atribuída ao vendedor (SIM ou -)
- ERRO CONFERENTE: Indica se a ocorrência é atribuída ao conferente (SIM ou -)
- PESO MOTORISTA: Valor numérico do peso do erro para o motorista
- PESO VENDEDOR: Valor numérico do peso do erro para o vendedor
- PESO CONFERENTE: Valor numérico do peso do erro para o conferente

Controles de Paginação

Indicador de páginas (ex: "1 - 9 de 9")
Navegação entre páginas com setas e números

Tela de Cadastro/Edição (Tipo de Ocorrência)

Campos de Formulário

Nome: Campo de texto obrigatório para o nome da ocorrência
Erro do Motorista: Checkbox que indica se o erro é atribuído ao motorista
- Campo numérico "Peso Motorista" (visível apenas quando o checkbox está marcado)
Erro do Vendedor: Checkbox que indica se o erro é atribuído ao vendedor
- Campo numérico "Peso Vendedor" (visível apenas quando o checkbox está marcado)
Erro do Conferente: Checkbox que indica se o erro é atribuído ao conferente
- Campo numérico "Peso Conferente" (visível apenas quando o checkbox está marcado)

Botões de Ação

Gravar: Salva o registro atual (habilitado apenas para usuários com permissão)
Excluir: Remove o registro atual (visível apenas ao editar um registro existente)
Voltar: Retorna à tela de listagem

Validações e Regras de Negócio

Campo Nome:
- Obrigatório
- Texto livre
Checkboxes de Erro:
- Pelo menos um tipo de erro deve ser selecionado (Motorista, Vendedor ou Conferente)
Campos de Peso:
- Numéricos com casas decimais (formato 0,00)
- Valor mínimo: 0
- Separador decimal: vírgula
- Separador de milhar: ponto
- Apenas visíveis quando o checkbox correspondente está marcado
Permissões:
- Usuários são classificados como "Acesso Master", "Acesso Grupo" ou "Acesso Individual"
- Os botões Gravar e Excluir são habilitados apenas para:
  - Usuários com "Acesso Master" (sempre)
  - Usuários com "Acesso Grupo" que possuem "capacidadeMaster" ou "grupoPodeSeAlterar"

Fluxo de Trabalho

O fluxo de trabalho desta interface segue um padrão típico de consulta-edição (CRUD):

Na tela de listagem, o usuário pode:
- Visualizar todos os tipos de ocorrência cadastrados
- Filtrar a lista pelo nome da ocorrência
- Selecionar um registro para edição (clicando na linha)
- Adicionar um novo registro (botão Novo)
- Exportar os dados para CSV
- Importar dados de um arquivo CSV
Na tela de cadastro/edição, o usuário pode:
- Preencher/alterar os dados do tipo de ocorrência
- Salvar o registro (botão Gravar)
- Excluir o registro (botão Excluir - apenas registros existentes)
- Retornar à tela de listagem sem salvar (botão Voltar)

Instruções Passo a Passo

Como Consultar Tipos de Ocorrência

Acesse a tela de listagem "Tipo de Ocorrências"
Para filtrar a lista, digite o nome ou parte do nome no campo "Nome"
Clique no botão de pesquisa (ícone de lupa)
A tabela exibirá os resultados conforme o filtro aplicado
Para limpar o filtro, clique no botão "Limpar Filtros" (ícone de arquivo)
Navegue entre as páginas usando os controles de paginação, se necessário

Como Adicionar um Novo Tipo de Ocorrência

Na tela de listagem, clique no botão "Novo" (ícone de adição)
Preencha o campo "Nome" com o nome do tipo de ocorrência
Selecione pelo menos um dos checkboxes:
- "Erro do Motorista?"
- "Erro do Vendedor?"
- "Erro do Conferente?"
Para cada checkbox selecionado, informe o "Peso" correspondente
Clique no botão "Gravar" para salvar o registro
O sistema retornará à tela de listagem e o novo registro estará visível

Como Editar um Tipo de Ocorrência

Na tela de listagem, localize o registro a ser editado
Clique na linha do registro para abrir a tela de edição
Modifique os campos desejados
Clique no botão "Gravar" para salvar as alterações
O sistema retornará à tela de listagem com as alterações aplicadas

Como Excluir um Tipo de Ocorrência

Na tela de listagem, localize o registro a ser excluído
Clique na linha do registro para abrir a tela de edição
Clique no botão "Excluir"
Confirme a exclusão quando solicitado
O sistema retornará à tela de listagem e o registro não estará mais disponível

Como Exportar Dados para CSV

Na tela de listagem, aplique os filtros desejados (opcional)
Clique no botão "Exportar para CSV" (ícone de salvar)
O arquivo CSV será gerado e baixado para o seu computador

Como Importar Dados de um CSV

Na tela de listagem, clique no botão "Importar"
Selecione o arquivo CSV a ser importado
Siga as instruções para mapear as colunas, se necessário
Confirme a importação
Os dados serão importados e exibidos na tabela

Perguntas Frequentes

O que são os "Pesos" associados a cada tipo de erro?

Os pesos são valores numéricos que representam a gravidade ou importância de cada tipo de erro. Eles podem ser utilizados para cálculos de performance, gerar relatórios estatísticos ou para determinar prioridades de resolução de problemas.

É possível atribuir um tipo de ocorrência a mais de um responsável?

Sim, é possível selecionar qualquer combinação de responsáveis (Motorista, Vendedor e Conferente) para um mesmo tipo de ocorrência. No entanto, pelo menos um responsável deve ser selecionado.

Como o sistema utiliza estas informações de tipos de ocorrência?

Estas informações são utilizadas para categorizar e analisar ocorrências durante operações logísticas. O sistema pode gerar relatórios de desempenho com base nos pesos atribuídos a cada tipo de erro, ajudando a identificar áreas problemáticas e oportunidades de melhoria.

Quem tem permissão para criar ou alterar tipos de ocorrência?

Usuários com "Acesso Master" sempre têm permissão. Usuários com "Acesso Grupo" precisam ter a capacidade "capacidadeMaster" ou a permissão "grupoPodeSeAlterar" habilitada. Usuários com "Acesso Individual" não podem criar ou alterar tipos de ocorrência.

É possível ter dois tipos de ocorrência com o mesmo nome?

Embora não haja uma validação explícita na interface, recomenda-se utilizar nomes únicos para facilitar a identificação e evitar confusões. O banco de dados pode ter restrições que impedem nomes duplicados.

O que acontece se eu tentar excluir um tipo de ocorrência que está sendo usado no sistema?

Se o tipo de ocorrência estiver vinculado a registros existentes, o sistema pode impedir a exclusão e exibir uma mensagem de erro. Isso evita inconsistências de dados.

Posso alterar o responsável por um tipo de ocorrência depois de criado?

Sim, é possível editar qualquer aspecto do tipo de ocorrência, incluindo os responsáveis e seus respectivos pesos, desde que o usuário tenha as permissões adequadas.

Como funcionam as importações e exportações via CSV?

A exportação cria um arquivo CSV com todos os dados exibidos na tabela. A importação permite carregar dados de um arquivo CSV, desde que o formato seja compatível com a estrutura esperada pelo sistema.