Acessar a tela de Locais

O usuário acessa o menu Cadastro > Locais. O sistema monta a lista de empresas do filtro (as empresas vinculadas ao usuário logado, mais a opção “Sem empresa vinculada” no início da lista) e carrega a grade de locais já cadastrados, organizada em páginas.

Clicar em “Novo”

O usuário clica no botão “Novo” na grade de locais. O sistema abre o formulário de cadastro de um local novo. Nesse momento, o painel de empresas vinculadas ainda não aparece, porque o local recém-aberto ainda não tem identificador.

Preencher o campo Nome

O usuário digita o nome do local no campo “Nome”, respeitando o limite de 100 caracteres. O preenchimento é obrigatório.

Salvar o cadastro

O usuário clica em Salvar. O navegador confere primeiro se o campo Nome foi preenchido corretamente; se não foi, o envio é bloqueado e o usuário precisa corrigir antes de continuar.

Sistema grava o local

Antes de gravar, o sistema confere se já existe outro local com o mesmo nome em qualquer empresa. Se existir, a gravação é interrompida e a mensagem “Já existe um local cadastrado com o nome {nome}” é exibida, com o formulário permanecendo aberto para correção. Se o nome for único, o sistema grava o local com o nome informado.

Sistema cria o vínculo automático com a empresa ativa

Assim que o local é gravado, o sistema cria automaticamente um vínculo entre esse local e a empresa que estava ativa na sessão do usuário no momento do cadastro. Essa empresa nunca é escolhida manualmente em nenhum campo do formulário de novo local; ela é definida pelo contexto da sessão do usuário.

Sistema associa automaticamente os usuários sem restrição por local

No mesmo momento, o sistema associa a esse local, de forma automática, todos os usuários que estão marcados como “sem restrição por local”. Esses usuários passam a enxergar o novo local imediatamente, sem que nenhuma ação manual seja necessária.

Confirmação e retorno à edição do local

O sistema exibe a mensagem “Operação efetuada com sucesso.” e leva o usuário para a tela de edição do local recém-criado, agora já exibindo o identificador atribuído e o painel de Empresas vinculadas.

Vincular o local recém-criado a empresas adicionais (opcional)

Dentro da edição do local, o usuário pode abrir o painel Empresas e clicar em “Novo” para vincular o local a outras empresas. Esse passo está detalhado na Seção 7 (Processo de Edição) e na Seção 5 (campos do modal de vínculo).

Cancelar (alternativa a qualquer momento)

Em qualquer etapa do formulário, o usuário pode clicar em “Cancelar” para voltar à listagem sem gravar nada. Os filtros que estavam aplicados na listagem antes de abrir o cadastro são preservados no retorno.

Permite restringir a listagem de locais às empresas escolhidas pelo usuário. As opções disponíveis são todas as empresas às quais o usuário logado está vinculado, mais uma opção adicional chamada “Sem empresa vinculada”, que representa os locais que não têm nenhuma empresa associada.

O painel de filtros vem recolhido por padrão. A seleção só passa a valer, recarregando a grade, quando o usuário clica no botão “Filtrar”. Se a opção “Sem empresa vinculada” estiver entre as selecionadas, a listagem passa a trazer também os locais sem nenhuma empresa vinculada. Os valores escolhidos ficam guardados no navegador durante a sessão de uso, associados especificamente a esta tela, e são reaproveitados automaticamente quando o usuário volta para a listagem depois de abrir um cadastro ou uma edição.

Define quais locais aparecem na grade de resultados; não afeta nenhum outro cadastro do sistema.

Permite localizar um local digitando parte do nome ou o número do identificador.

A busca só é enviada ao sistema depois que o usuário digita pelo menos 3 caracteres, com uma pequena pausa de meio segundo após parar de digitar; apertar Enter ou limpar o campo dispara a busca imediatamente. Se o texto digitado for totalmente numérico, o sistema busca pelo identificador exato; caso contrário, busca pelo nome do local em qualquer posição do texto, sem diferenciar maiúsculas de minúsculas nem considerar espaços nas pontas.

Define quais locais aparecem na grade de resultados.

Identificador único atribuído pelo sistema a cada local cadastrado.

A grade vem ordenada por esta coluna, do maior para o menor, por padrão; o usuário pode reordenar clicando no cabeçalho da coluna.

Usado como referência em mensagens de confirmação e erro (por exemplo, ao excluir um local) e como chave para localizar o local em outras telas do sistema.

Nome cadastrado para aquele local.

Pode ser usado para reordenar a grade, clicando no cabeçalho da coluna.

Aparece também no título da tela de edição do local e nas mensagens de confirmação de exclusão.

Nome que identifica o local dentro do sistema, exibido em toda a listagem e nas telas que fazem referência a ele.

Aceita no máximo 100 caracteres. A validação de preenchimento é feita pelo próprio navegador antes do envio: se o campo estiver vazio, o formulário não é enviado. Depois do envio, o sistema também confere se já existe outro local com esse mesmo nome, em qualquer empresa; se existir, exibe a mensagem “Já existe um local cadastrado com o nome {nome}” e mantém o formulário aberto para correção.

Aparece na listagem de locais, no título da tela de edição (“Local: {nome}”), nas mensagens de confirmação e erro, e é usado por outras rotinas do sistema (como Planilha) para identificar o local.

Identificador do vínculo entre aquela empresa e o local em edição.

A grade vem ordenada por esta coluna, do maior para o menor, por padrão.

Não é usado diretamente pelo usuário, mas identifica o vínculo internamente para as ações de editar, excluir e alterar status.

Nome da empresa vinculada ao local.

A busca livre desta grade filtra apenas por esta coluna, considerando o nome digitado em qualquer posição do texto. Também pode ser usada para ordenar a grade, sendo inclusive a ordenação padrão.

Usado nas mensagens de confirmação e erro relacionadas ao vínculo (por exemplo, “Já existe um local… para a empresa…”).

Posição geográfica (latitude) cadastrada para aquele vínculo entre a empresa e o local, quando informada.

Exibe o valor gravado no vínculo; pode ficar em branco se não foi informado.

Usado para posicionar o marcador no mapa do modal de vínculo, ao reabrir o vínculo para edição.

Posição geográfica (longitude) cadastrada para aquele vínculo entre a empresa e o local, quando informada.

Exibe o valor gravado no vínculo; pode ficar em branco se não foi informado.

Usado para posicionar o marcador no mapa do modal de vínculo, ao reabrir o vínculo para edição.

Distância, em metros, que delimita a área de alcance daquele vínculo entre a empresa e o local, quando informada.

Exibe o valor gravado no vínculo, com 2 casas decimais.

[Informação não disponível na documentação de origem, validar com analista responsável] quanto ao uso concreto desse raio em outras rotinas do sistema.

Indica se aquele vínculo entre a empresa e o local está ativo ou inativo no momento.

Um vínculo inativo mostra um ícone de bloqueio, com destaque de alerta, e a dica “Clique para ativar” ao passar o mouse; um vínculo ativo mostra um ícone de confirmação, com destaque de sucesso, e a dica “Clique para desativar”. Clicar no ícone alterna o status imediatamente, mas só depois que o usuário confirma a mensagem “Você está prestes a alterar o status de um relacionamento entre Empresa e Local.” Se o vínculo já tiver sido excluído por outra sessão antes da confirmação, o sistema exibe a mensagem “EmpresaxTurno não encontrado.” Também é possível ordenar a grade por esta coluna.

Um vínculo inativo deixa de valer para as regras de restrição por local que dependem dele em outras rotinas do sistema.

Empresa que será vinculada ao local em edição.

Apresenta uma lista de empresas com um campo de busca para facilitar a localização; ao tentar salvar um vínculo com uma empresa que já está vinculada àquele mesmo local (fora do próprio registro, em caso de edição do vínculo), o sistema rejeita a gravação com a mensagem “Já existe um local “{nome do local}” para a empresa “{nome da empresa}””, mantendo o modal aberto.

Define a empresa que passa a ter acesso àquele local através do vínculo; também é usado no cálculo automático do código QR Code do vínculo (ver Seção 8).

Posição geográfica (latitude) daquele vínculo entre a empresa e o local, usada para localizar o ponto no mapa.

Pode ser digitada diretamente ou preenchida automaticamente ao arrastar o marcador no mapa ou clicar em um ponto do mapa; a posição do marcador e o nível de zoom se atualizam em tempo real conforme o valor muda. Se deixada em branco, é enviada como vazia (nula) ao salvar.

Usada para exibir a posição do local daquela empresa no mapa, quando o vínculo é reaberto para edição.

Posição geográfica (longitude) daquele vínculo entre a empresa e o local, usada para localizar o ponto no mapa.

Mesmo comportamento da Latitude: pode ser digitada, arrastada no mapa ou definida por clique no mapa, atualizando a posição e o zoom em tempo real. Se deixada em branco, é enviada como vazia (nula) ao salvar.

Usada para exibir a posição do local daquela empresa no mapa, quando o vínculo é reaberto para edição.

Distância, em metros, que delimita a área de alcance considerada válida para aquele vínculo entre a empresa e o local.

Aceita no máximo 6 caracteres e só permite dígitos; o sistema aplica automaticamente 2 casas decimais separadas por vírgula enquanto o usuário digita (por exemplo, digitar “12345” resulta em “123,45”). Ao salvar, esse valor é convertido de vírgula para ponto antes de ser enviado ao servidor.

[Informação não disponível na documentação de origem, validar com analista responsável] quanto ao uso concreto desse raio em outras rotinas do sistema.

Representação visual da posição geográfica do vínculo entre a empresa e o local.

Inicia centralizado numa posição padrão do sistema, com o zoom bem afastado, quando nenhuma posição prévia foi informada. Ao digitar latitude e longitude, arrastar o marcador ou clicar diretamente no mapa, a posição do marcador se atualiza em tempo real e o zoom passa a um nível mais próximo. Ao fechar o modal por qualquer meio, os campos do formulário (Empresa, Latitude, Longitude, Raio) são limpos.

Reflete e alimenta os valores dos campos Latitude e Longitude descritos acima.

Vínculo Automático com a Empresa Ativa

Sempre que um local novo é cadastrado, o sistema cria automaticamente, nos bastidores, o vínculo entre esse local e a empresa que estava ativa na sessão do usuário no momento do cadastro. O usuário não precisa (e nem consegue) escolher essa empresa manualmente nesse momento.

Associação Automática de Usuários Sem Restrição

Toda vez que um local é criado, ou que um vínculo entre empresa e local é criado ou editado, o sistema atualiza automaticamente, sem nenhuma ação manual do usuário, a lista de usuários que enxergam aquele local — especificamente, os usuários marcados como “sem restrição por local” passam a ter acesso ao novo local (ou ao local recém-vinculado) imediatamente. Um usuário que já enxergava aquele local não é duplicado nessa atualização.

Cálculo Automático do Código QR Code do Vínculo

A cada vínculo criado ou editado entre uma empresa e um local, o sistema recalcula, nos bastidores, um código que combina o identificador da empresa e o identificador do local. Esse código não é digitado pelo usuário e não aparece nem pode ser impresso na tela de Locais; a geração visual e a impressão desse código ficam disponíveis em outra tela do sistema (Empresas), fora do escopo desta rotina.

Verificação de Uso Antes de Excluir

Antes de remover um local, o sistema confere se ele está sendo referenciado por outros cadastros (como itens de Planilha); se estiver, a exclusão é bloqueada e nada é removido. O mesmo tipo de verificação acontece antes de excluir um vínculo entre empresa e local, checando se esse vínculo está em uso por algum item de Planilha daquela empresa associado àquele local.

Uso da Mesma Rotina para Cadastrar e Editar

Ao salvar o formulário de Local, o sistema usa o mesmo mecanismo tanto para criar um local novo quanto para atualizar um já existente; a diferença entre as duas situações é decidida automaticamente, pelo próprio sistema, dependendo de o local já ter ou não um identificador.

Indicador de Carregamento e Sessão Expirada

Enquanto qualquer ação da tela está sendo processada pelo sistema (salvar, excluir, filtrar, alterar status, entre outras), aparece uma sobreposição de “Processando” na tela. Se, durante esse processamento, o sistema identificar que o acesso foi negado (por exemplo, porque a permissão do usuário foi revogada durante a própria sessão de uso), o usuário é automaticamente redirecionado para uma página de erro de acesso proibido, sem nenhuma mensagem específica da tela de Locais.

Uso desta Rotina por Outras Partes do Sistema

O cadastro de locais é consultado por outras rotinas do EasyPAC (por exemplo, componentes de seleção de local em outras telas, e consultas relacionadas a Planilha) para restringir informações por local e por empresa. Os detalhes de funcionamento dessas outras rotinas não fazem parte desta documentação: [informação não disponível na documentação de origem desta rotina, consultar a documentação específica de cada uma dessas outras rotinas].

Nome do Local é Único em Todo o Sistema

Não é permitido cadastrar ou renomear um local com um nome já usado por outro local, mesmo que esse outro local pertença a uma empresa diferente. Ao tentar, o sistema recusa a gravação com a mensagem “Já existe um local cadastrado com o nome {nome}”, mantendo o formulário aberto para o usuário corrigir o nome.

Vínculo Automático com a Empresa Ativa na Criação

Ao cadastrar um local novo, ele é gravado primeiro apenas com o nome informado; em seguida, o sistema cria automaticamente o vínculo entre esse local e a empresa que estiver ativa na sessão do usuário que está cadastrando. Essa empresa nunca é escolhida em nenhum campo do formulário; se, por qualquer motivo, o sistema não conseguir identificar a empresa ativa da sessão, o vínculo é gravado como “nenhuma empresa”.

Associação Automática de Usuários Sem Restrição

Sempre que um local é criado, ou que um vínculo entre empresa e local é criado ou editado, o sistema associa automaticamente a esse local todos os usuários marcados como “sem restrição por local”, sem qualquer ação manual. Um usuário que já estava associado ao local não é associado novamente (não há duplicidade).

Edição de Local Não Altera Vínculos de Empresa

Ao editar um local existente, apenas o campo Nome é atualizado. Nenhum vínculo de empresa é criado, alterado ou removido nessa operação; os vínculos são geridos exclusivamente pelo painel Empresas do local, dentro da própria tela de edição.

Exclusão de Local Bloqueada Quando Há Referência

A exclusão de um local remove o registro definitivamente, mas só é permitida se esse local não estiver referenciado por outros cadastros do sistema (por exemplo, itens de Planilha). Havendo referência, a exclusão é rejeitada com a mensagem “Não é possível deletar este local devido a ligação com alguns itens….”, e nada é removido.

Filtro “Sem Empresa Vinculada” e Remoção de Duplicidade

O filtro de Empresa da listagem aceita mais de uma empresa selecionada ao mesmo tempo. Se a opção “Sem empresa vinculada” estiver entre as selecionadas, a listagem passa a incluir também os locais que não têm nenhuma empresa vinculada. Quando o filtro seleciona mais de uma empresa vinculada ao mesmo local, esse local é exibido apenas uma vez na listagem, mesmo estando vinculado a mais de uma das empresas escolhidas.

Regras de Busca, Ordenação e Paginação da Listagem

A busca livre da listagem localiza pelo identificador exato quando o texto digitado é totalmente numérico, ou pelo nome do local contendo o texto digitado em qualquer posição (ignorando maiúsculas/minúsculas e espaços nas pontas) nos demais casos. Somente as colunas Identificador e Nome podem ser usadas para ordenar a listagem; qualquer outra coluna informada é ignorada, mantendo a ordenação anterior. A separação em páginas só é aplicada depois de todos os filtros e da ordenação já terem sido considerados.

Vínculo Entre Empresa e Local Não Pode se Repetir

Não é permitido vincular a mesma empresa ao mesmo local mais de uma vez. Ao tentar criar um vínculo que já existe (desconsiderando o próprio registro, em caso de edição do vínculo), o sistema rejeita a gravação com a mensagem “Já existe um local “{nome do local}” para a empresa “{nome da empresa}””. Todo novo vínculo entre empresa e local começa sempre com o status ativo.

Exclusão e Alteração de Status do Vínculo

Um vínculo entre empresa e local não pode ser excluído se estiver em uso: se existir algum item de Planilha daquela empresa associado àquele local, a exclusão é rejeitada com a mensagem “Não foi possível efetuar a exclusão, pois o Empresa x Local está sendo utilizado”. Ao tentar ativar ou desativar um vínculo que já não existe mais (por exemplo, removido por outra sessão de uso pouco antes), o sistema rejeita a operação com a mensagem “EmpresaxTurno não encontrado.” — mensagem reaproveitada de outra funcionalidade de vínculo do sistema, mas que, nesse contexto, indica que o vínculo entre empresa e local não foi encontrado.

Lista de Empresas Restrita ao Usuário Logado

A lista de empresas oferecida no filtro da listagem e nos formulários de Locais traz apenas as empresas às quais o usuário logado está vinculado, ordenadas por nome. A empresa configurada como padrão para aquele usuário vem pré-selecionada nessa lista.

Perfil Fiscal Não Tem Acesso

Usuários com o perfil fiscal não conseguem realizar nenhuma das ações da tela de Locais nem do painel de vínculos Empresa x Local, independentemente de outras permissões que possam ter em outras áreas do sistema.

QR Code do Vínculo é Sempre Recalculado

O código de QR Code associado a cada vínculo entre empresa e local nunca é definido pelo usuário: ele é recalculado automaticamente pelo sistema a cada criação ou edição do vínculo, combinando o identificador da empresa e o identificador do local. A tela de Locais não exibe nem imprime esse código; essa função fica disponível em outra tela do sistema (Empresas).