• Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas
  • Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas

Documentação

  • EasyPAC
    • Aplicativos
      • App Monitoramento
        • Apresentação
          • Tela Principal
          • Download do Aplicativo em Android
          • Download do Aplicativo em iOS
          • Lista de Planilhas
          • Configuração Base
          • Login no Aplicativo
          • Tipos de Planilhas
        • Inclusão de Registros
          • Envio de Registros
          • Inserindo Imagem, Vídeo e Anexos
          • Registros não Conformes com Ações
          • Registros não Conformes e sem Ações
          • Registros sem a Descrição da NC e sem Ações
        • Menu
          • Assinar e Concluídas
          • Configuração do Aplicativo
          • Pendentes e Não Inicializadas
          • Todas e Em Teste
        • Tipos de Agrupadores
          • Agrupador Analítico
          • Agrupador Dinâmico
          • Agrupador Dinâmico Limitado
          • Agrupador Não Sequencial
          • Apontamento Analítico
        • Tipos de Dados e Interface no Aplicativo
          • Cadastro Geral
          • Campo Cálculo
          • Campo Decimal
          • Campo Imagem
          • Campo Inteiro
          • Campo Tempo
          • Campo Texto
            • Coleta de Assinatura
      • App Supervisão
    • Outros Processos
      • Ativação de Planilhas
      • EasyPAC — API de Integração
      • Gestão de Licenças
    • Portal
      • Melhoria Contínua
        • Causa Raiz
      • Supervisão
        • Painel Diário
        • Painel de Alertas
        • Ações Planejadas
        • Matriz Diária
      • Relatórios
        • Customizados
        • Exportar
        • Padrões
        • Solicitações
      • Agendamento
      • BI
      • Registros
      • Assinaturas
      • Fiscalização
      • Cadastros
        • Turnos
        • Locais
        • Funções
        • Grupos
        • Não Conformidades
        • Tipos de Ações
        • Ações
        • Cadastro Geral
        • Programas De Qualidade
        • Dispositivos
      • Configurações
      • Rastreabilidade
        • Áreas
        • Clientes
        • Compras
        • Estrutura do Produto
        • Fornecedores
        • Vendas
      • Gestão De Documentos
        • Dashboard
        • Tipo de Documento
        • Processo Documento
        • Setor
        • Criação
        • Revisão
        • Aprovação
        • Vigentes
        • Arquivados
Nenhum resultado encontrado
Inteligência Atak / Documentação / EasyPAC / Portal / Cadastros

Locais

Criado por Igor Ribeiro em 11 de novembro de 2026
•
Atualizado por Igor Ribeiro em 13 de novembro de 2026
Documentação Técnica

Cadastros – Locais (Portal Easypac)

A tela de Locais, no módulo de Cadastros, mantém o cadastro dos locais físicos (unidades de inspeção, pontos de coleta) que o Easypac usa para organizar e restringir informações por localização; cada local pode ficar vinculado a uma ou mais empresas, cada vínculo com sua própria posição geográfica (latitude, longitude e raio) e status ativo/inativo.

01. VISÃO GERAL

Visão Geral

A tela de Locais, no módulo de Cadastros, mantém o cadastro dos locais físicos (unidades de inspeção, pontos de coleta) que o Easypac usa para organizar e restringir informações por localização; cada local pode ficar vinculado a uma ou mais empresas, cada vínculo com sua própria posição geográfica (latitude, longitude e raio) e status ativo/inativo. Um local cadastrado aqui é o que outras áreas do sistema — como as Planilhas e a associação automática de usuários “sem restrição por local” — usam para restringir onde cada usuário ou processo pode atuar. Esta tela apenas parametriza os locais e seus vínculos com as empresas; nenhuma coleta de dados em campo é feita por aqui.

02. PRÉ-REQUISITOS

Pré-requisitos

  • Cadastrar um local exige que o usuário tenha uma empresa ativa na sessão: essa é a empresa vinculada automaticamente ao local no momento da criação; sem uma empresa ativa reconhecível, o vínculo inicial é gravado como “nenhuma empresa”.
  • Vincular um local a empresas adicionais (painel Empresas) exige que o local já esteja salvo — o painel só é exibido depois que o local tem identificador; um local recém-aberto para cadastro (ainda sem salvar) não oferece essa opção.
  • Vincular uma empresa a um local exige que essa empresa já esteja cadastrada e disponível na lista de empresas do usuário logado.
  • Excluir um local exige que ele não esteja referenciado por outros cadastros (por exemplo, itens de Planilha que o utilizem); havendo referência, a exclusão é bloqueada.
  • Excluir um vínculo entre empresa e local exige que esse vínculo não esteja em uso por nenhum item de Planilha daquela empresa associado àquele local; havendo uso, a exclusão é bloqueada.
03. PERMISSÕES E PERFIS DE ACESSO

Permissões e Perfis de Acesso

A tela de Locais não depende de nenhum módulo contratado opcional identificado na análise: o cadastro de locais integra a base do sistema, liberada a todos os clientes, dependendo apenas das permissões de papel descritas a seguir.

Papel — cadastro de local: visualizar a listagem de locais exige a permissão de visualizar local; abrir o cadastro de um local novo exige a permissão de novo local; abrir e salvar a edição de um local existente exige a permissão de editar local; excluir um local exige a permissão de excluir local.

Papel — vínculo Empresa x Local (painel Empresas do cadastro de um local): visualizar a grade de empresas vinculadas exige a permissão de visualizar vínculo empresa-local; criar um novo vínculo exige a permissão de novo vínculo empresa-local; excluir um vínculo exige a permissão de excluir vínculo empresa-local; alterar o status (ativo/inativo) de um vínculo exige a permissão de alterar status de vínculo empresa-local. Existe ainda uma consulta de locais vinculados a uma empresa, em sentido inverso, usada por outra tela do sistema (a tela de Empresas), que exige essa mesma permissão de visualizar vínculo empresa-local, mas não é chamada pelas telas de Locais.

Perfil fiscal: não tem acesso à tela, ou seja, não pode realizar nenhuma das ações citadas anteriormente.

Recorte de dados: o filtro de Empresa da listagem é composto por todas as empresas vinculadas ao usuário logado, mais a opção “Sem empresa vinculada” (representando os locais sem nenhuma empresa associada), inserida no início da lista. No servidor de aplicação (API), a listagem de locais exige apenas que o usuário esteja autenticado, sem checagem de papel nessa camada — todo o controle por permissão de tela (visualizar, incluir, editar, excluir) é feito inteiramente no Portal. A consulta de um local específico usada em telas de seleção (lookup) também não exige nenhuma permissão de papel, apenas autenticação — diferente das demais operações de Locais.

04. FLUXO OPERACIONAL

Fluxo Operacional

O usuário chega à tela de Locais pelo menu Cadastro > Locais. Ao abrir, o portal monta a lista de empresas do filtro (empresas do usuário logado, mais a opção “Sem empresa vinculada” no início) e carrega a grade de locais, paginada e ordenada no servidor. A partir daí o usuário pode:

  1. Abrir o painel de filtros (recolhido por padrão), selecionar uma ou mais empresas e clicar em “Filtrar”, ou navegar pelas páginas e pesquisar por texto na grade.
  2. Clicar em Novo para abrir o cadastro de um local novo, informar o nome e salvar; o local é automaticamente vinculado à empresa ativa da sessão no momento do cadastro.
  3. Clicar em Editar (ou dar duplo clique na linha) para abrir um local existente, alterar o nome e salvar.
  4. Dentro da edição de um local já existente, usar o painel Empresas para vincular o local a empresas adicionais, informando localização (latitude, longitude, raio – opcional) pelo modal com mapa, ou para alterar o status ou excluir um vínculo já existente.
  5. Clicar em Excluir para remover um local pela grade, confirmando a exclusão quando solicitado.
  6. Clicar em Cancelar a qualquer momento, no formulário, para voltar à listagem sem gravar nada, preservando os filtros aplicados anteriormente.
05. INTERFACE E COMPORTAMENTOS DA TELA

Interface e Comportamentos da Tela

Listagem de locais — grade, filtro e ações

A grade de locais desta tela exibe as colunas ID e Nome, com 20 registros por página e ordenação inicial pela coluna ID em ordem decrescente; a busca livre da grade só dispara uma nova consulta ao servidor a partir de 3 caracteres digitados (ou imediatamente ao apertar Enter ou ao limpar o campo), com um atraso de 500ms após o usuário parar de digitar. O painel de filtros (recolhido por padrão) tem apenas o campo Empresa, de seleção múltipla; as opções são todas as empresas do usuário logado, mais a opção “Sem empresa vinculada” inserida no início da lista. O filtro selecionado é enviado ao servidor a cada atualização da grade, mas só passa a valer, recarregando os resultados, quando o usuário clica no botão “Filtrar”. Os valores aplicados no filtro ficam guardados no navegador, por sessão, sob uma chave própria desta tela; esse cache só é reaproveitado quando a listagem é reaberta com o indicador “?ss” na URL — por exemplo, ao voltar do cadastro ou da edição de um local para a listagem.

A grade oferece os botões Novo (abre o cadastro de um local novo) e Editar (abre o local selecionado); o duplo clique em uma linha também abre a edição. Antes de excluir um local pela grade, é exibido o diálogo de confirmação com o id e o nome do local (ver Feedbacks ao Usuário); a exclusão só é enviada ao servidor se o usuário confirmar.

Formulário de cadastro e edição de local

O mesmo formulário de Locais atende tanto o cadastro de um local novo quanto a edição de um existente. O título da tela exibe o nome do local ao lado do rótulo “Local:”. O campo Nome é de preenchimento obrigatório, limitado a 100 caracteres, validado no navegador antes do envio — como em qualquer formulário do Portal, o envio só ocorre se passar na validação nativa do navegador; o formulário de Locais não tem campo de data, mas segue a mesma regra geral de bloquear o envio quando a validação falhar.

No cadastro de um local novo, o painel de empresas vinculadas não é exibido, porque o local ainda não tem identificador. Ao abrir a edição de um local existente, o portal busca o nome atual do local, monta a lista de empresas do usuário logado com uma opção “Selecione” em branco inserida no início, e passa a exibir o painel de empresas vinculadas, já que o identificador existe.

O botão Cancelar sempre retorna à listagem sem gravar nada, reaproveitando os filtros aplicados anteriormente (pelo mesmo indicador “?ss” na URL de retorno). Ao salvar, se o local ainda não tem identificador, a gravação segue pelo fluxo de “novo local”; se já tem identificador, segue pelo fluxo de “editar local” (que, no servidor, é a mesma rotina de criação — ver Regras de Negócio).

Grade de Empresas vinculadas ao local

Exibida somente na edição de um local já salvo, esta grade mostra as colunas ID, Empresa, Latitude, Longitude, Raio e Status, paginada e ordenada no servidor, com 20 registros por página e ordenação inicial pela coluna ID em ordem decrescente. A busca livre desta grade filtra apenas pelo nome da empresa; a ordenação aceita as colunas Status e Nome da Empresa, com Nome da Empresa como ordenação padrão. Na coluna Status: um vínculo inativo mostra um ícone de bloqueio, com destaque de alerta, e a dica “Clique para ativar”; 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, mediante confirmação (ver Feedbacks ao Usuário). O botão Novo desta grade abre o modal de vínculo em branco, com o mapa centralizado na posição padrão; selecionar um registro e clicar em Editar (ou dar duplo clique) abre o modal preenchido com os dados daquele vínculo.

Modal de vínculo Empresa x Local

O campo Empresa do modal é obrigatório, de seleção única com busca; os campos Latitude e Longitude são numéricos livres; o campo Raio (em metros) é texto, limitado a 6 caracteres, com máscara que aceita apenas dígitos e aplica automaticamente 2 casas decimais separadas por vírgula enquanto o usuário digita (por exemplo, digitar “12345” vira “123,45”). O modal exibe um mapa que inicia centralizado numa posição padrão fixa do sistema, com o zoom bem afastado, quando nenhuma posição prévia é informada; ao digitar latitude e longitude, ou ao arrastar e soltar o marcador no mapa, ou ao clicar diretamente no mapa, a posição do marcador é atualizada em tempo real e o zoom passa a um nível mais próximo. Ao salvar, o valor do Raio é convertido de vírgula para ponto antes do envio; latitude e longitude vazias são enviadas como nulas; se o vínculo é novo, o identificador enviado ao servidor é 0. Ao fechar o modal por qualquer meio, os campos do formulário (empresa, latitude, longitude, raio) são limpos.

06. FEEDBACKS AO USUÁRIO

Feedbacks ao Usuário

Nas operações de Locais e de vínculo Empresa x Local, quando a falha não trouxer uma mensagem estruturada do servidor, o portal exibe o texto bruto da resposta em vez de um texto de negócio.

Feedbacks — listagem e exclusão de local

SituaçãoFeedbackTexto exato
Confirmar exclusão de um local pela gradeConfirmação antes de enviar“Você está prestes a remover o local: {id} – {nome}”
Exclusão concluída com sucessoNotificação, grade atualizada“Operação efetuada com sucesso.”
Excluir um local referenciado por outros cadastrosNotificação de erro“Não é possível deletar este local devido a ligação com alguns itens….”

Feedbacks — cadastro e edição de local

SituaçãoFeedbackTexto exato
Salvar (cadastro ou edição) concluído com sucessoNotificação, redireciona para a edição do local salvo“Operação efetuada com sucesso.”
Salvar com um nome já usado por outro localNotificação de erro, formulário permanece aberto“Já existe um local cadastrado com o nome {nome}”

Feedbacks — vínculo Empresa x Local

SituaçãoFeedbackTexto exato
Confirmar alteração de status do vínculoConfirmação antes de enviar“Você está prestes a alterar o status de um relacionamento entre Empresa e Local.”
Confirmar exclusão do vínculoConfirmação antes de enviar“Você está prestes a remover um relacionamento entre Empresa e Local.”
Salvar vínculo (novo ou edição) com sucessoNotificação, grade atualizada, modal fechado“Operação efetuada com sucesso.”
Vincular a mesma empresa duas vezes ao mesmo localNotificação de erro, modal permanece aberto“Já existe um local \”{nome do local}\” para a empresa \”{nome da empresa}\””
Excluir vínculo em uso por item de PlanilhaNotificação de erro“Não foi possível efetuar a exclusão, pois o Empresa x Local está sendo utilizado”
Alterar status de vínculo que já não existe maisNotificação de erro“EmpresaxTurno não encontrado.”
Ícone de status inativo na grade de Empresas do localDica ao passar o mouse (tooltip)“Clique para ativar”
Ícone de status ativo na grade de Empresas do localDica ao passar o mouse (tooltip)“Clique para desativar”
07. PROCESSAMENTO PELO BACKEND

Processamento pelo Backend

Ao carregar a listagem de locais, o servidor recebe a busca textual, o filtro de empresa, a ordenação e a paginação exatamente como enviados pela grade. Aplica a busca textual e o filtro de empresa (ver Regras de Negócio), remove as repetições que apareceriam quando o filtro seleciona mais de uma empresa vinculada ao mesmo local, ordena pela coluna pedida — respeitando o limite de colunas ordenáveis — e só então pagina o resultado.

Ao abrir a edição de um local, o portal busca o local diretamente pelo identificador informado na rota, trazendo apenas identificador e nome (ver Regras de Negócio), e monta a lista de empresas do usuário logado para o painel de vínculos.

Ao salvar (cadastro ou edição), o portal envia os dados ao mesmo ponto de gravação em ambos os casos; o servidor decide entre inserir e atualizar exclusivamente pelo identificador recebido (ver Regras de Negócio). Antes de gravar, valida a unicidade do nome do local; se a validação falhar, a operação é interrompida com a mensagem correspondente e nada é alterado. Se for um cadastro novo, o servidor grava o local, cria o vínculo com a empresa ativa da sessão e dispara a associação automática dos usuários sem restrição por local (ver Regras de Negócio); se for uma edição, apenas atualiza o nome, sem tocar nos vínculos de empresa.

Ao excluir um local, o servidor verifica se existem outros cadastros que o referenciem; havendo referência, interrompe a exclusão sem remover nada (ver Regras de Negócio).

Ao vincular uma empresa a um local pelo modal, o servidor valida antes se o mesmo vínculo já existe; se não existir, calcula o código do vínculo (ver Etiquetas e QR Code), grava com status inicial ativo e dispara a mesma associação automática de usuários sem restrição por local. Ao alterar o status de um vínculo, apenas grava o novo valor, validando antes que o vínculo exista. Ao excluir um vínculo, verifica antes se ele está em uso por algum item de Planilha daquela empresa; havendo uso, interrompe a exclusão sem remover nada (ver Regras de Negócio, para as mensagens de cada validação).

A consulta de locais por Planilha substitui a lista de empresas eventualmente recebida do cliente da chamada pelas empresas vinculadas a planilha informada, antes de aplicar os mesmos filtros da listagem comum (ver Regras de Negócio). A consulta de locais para lookup, usada por outras telas do sistema, restringe o resultado às Planilhas que o usuário logado tem permissão de consultar, podendo ainda ser restrita por empresa.

08. REGRAS DE NEGÓCIO

Regras de Negócio

Nome do local é único no sistema inteiro

Ao gravar um local, o servidor rejeita a operação com a mensagem “Já existe um local cadastrado com o nome {nome}” quando já existir qualquer outro local com o mesmo nome, independentemente da empresa vinculada a ele — a unicidade vale para o sistema inteiro, não apenas dentro de uma empresa.

Vínculo automático com a empresa ativa na criação de um novo local

Ao cadastrar um novo local, o local é criado apenas com o nome informado no formulário; em seguida, o servidor cria automaticamente um 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 de novo local — ela vem de um dado de contexto da sessão, lido de um cabeçalho da requisição; se esse dado não puder ser interpretado como um número, a empresa considerada para o vínculo é “nenhuma empresa”.

Associação automática de usuários sem restrição por local

Toda vez 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 nenhuma ação manual — esses usuários passam a enxergar o local desde esse momento. Essa associação nunca gera vínculos duplicados: um usuário que já estava associado ao local é ignorado nessa rotina.

Decisão entre cadastrar e editar um local

O servidor decide entre cadastrar e editar um local exclusivamente pelo identificador recebido: identificador ausente ou igual a zero significa um local novo; qualquer outro valor significa a edição do local com aquele identificador. O Portal chama exatamente a mesma rotina de gravação tanto para o cadastro quanto para a edição, cabendo ao servidor essa decisão — não existe, em uso, uma rotina de atualização separada; existe uma rotina de edição alternativa no sistema, mas ela nunca é acionada por nenhuma tela ou ponto de entrada. Ao editar um local existente, apenas o nome é alterado; nenhum vínculo de empresa é criado, alterado ou removido nessa operação — vínculos de empresa são geridos separadamente, pelo painel Empresas do local.

Exclusão de local e suas restrições

A exclusão de um local é definitiva, removendo o registro; se o local estiver referenciado por outros cadastros que o utilizem (por exemplo, itens de Planilha), a exclusão é rejeitada com a mensagem “Não é possível deletar este local devido a ligação com alguns itens….”.

Filtro de empresa e locais sem empresa vinculada

O filtro de empresa da listagem de locais aceita várias empresas ao mesmo tempo; se o valor que representa “nenhuma empresa” estiver entre as empresas 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 apareceria repetido na listagem; o sistema remove essas repetições antes de paginar, mantendo uma única linha por local.

Busca textual, ordenação e paginação da listagem principal de locais

A busca livre da listagem de locais filtra pelo identificador exato quando o texto digitado é inteiramente numérico, ou pelo nome do local contendo o texto em qualquer posição, ignorando espaços nas pontas e maiúsculas/minúsculas, caso contrário. As únicas colunas ordenáveis são o identificador e o nome; qualquer outra coluna informada é ignorada e a ordenação anterior é mantida. A paginação é aplicada em memória, por último, depois de todos os filtros e da ordenação.

Consulta de locais por Planilha

Existe uma consulta de locais filtrada automaticamente pelas empresas de uma Planilha informada, que recebe filtros extras em formato livre — as empresas usadas no filtro não vêm de nenhuma seleção manual: são obtidas a partir de todas as empresas vinculadas à Planilha informada, substituindo qualquer lista de empresas eventualmente enviada pelo cliente da chamada. Essa consulta exige a mesma permissão de visualizar local da listagem comum, mas não é utilizada pelas telas de Locais — está disponível para outras áreas do sistema que precisem restringir locais por Planilha.

Consulta de um local para edição e para seleção (lookup)

A consulta de um local específico usada para preencher o formulário de edição devolve apenas o identificador e o nome do local — nenhuma outra informação, como empresas vinculadas, é trazida por essa consulta. Já a consulta de locais usada em componentes de busca e seleção (lookup) por outras telas do sistema restringe o resultado aos locais vinculados a Planilhas que o usuário logado tem permissão de consultar, podendo ainda ser restrita a uma empresa específica ou a uma lista de empresas; essa consulta também aceita filtrar por um usuário específico, restringindo aos locais das empresas às quais aquele usuário está vinculado — filtro não utilizado pela tela de Locais, que só oferece filtro por empresa.

Consulta de locais vinculados a uma empresa (usada por outra tela do sistema)

Existe uma consulta que lista os locais vinculados a uma empresa específica — sentido inverso da grade de Empresas do local, usada por outra tela do sistema, não pela tela de Locais. Ela aceita busca tanto pelo nome do local (contendo o texto) quanto pelo identificador exato do local; as colunas ordenáveis são o identificador do local, o nome do local, a longitude, a latitude e o raio, com o identificador do local como ordenação padrão.

Vínculo entre Empresa e Local: unicidade e status inicial

Não é permitido vincular a mesma empresa ao mesmo local mais de uma vez: ao tentar criar um vínculo já existente (desconsiderando o próprio registro, em caso de edição), a gravação é rejeitada com a mensagem “Já existe um local \”{nome do local}\” para a empresa \”{nome da empresa}\””. Ao criar um novo vínculo Empresa x Local, o status inicial é sempre ativo.

Exclusão e alteração de status do vínculo Empresa x Local

Um vínculo Empresa x 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”. Alterar o status de um vínculo apenas grava o novo status; se o vínculo não for encontrado, a operação é rejeitada com a mensagem “EmpresaxTurno não encontrado.” — mensagem reaproveitada de outra funcionalidade de vínculo do sistema, exibida também para o vínculo empresa-local.

Lista de empresas oferecida nos filtros e formulários de Locais

A lista de empresas oferecida no filtro da listagem e nos formulários de Locais é composta apenas pelas empresas às quais o usuário logado está vinculado, vindo ordenada por nome da empresa; a empresa marcada como selecionada por padrão é a empresa configurada como padrão para aquele usuário, e cada empresa da lista indica se é essa empresa padrão.

09. QR CODE

QR Code

O vínculo entre Empresa e Local tem um código de QR Code associado, mas ele não é gerado a partir de nenhum campo digitado pelo usuário: a cada criação ou edição de um vínculo Empresa x Local, o servidor recalcula esse código como a concatenação do identificador da empresa, o caractere “|” e o identificador do local. A tela de Locais não exibe nem imprime esse código, a geração e impressão do QR Code fica disponível em outra tela do sistema (Empresas).

10. TROUBLESHOOTING

Troubleshooting

T-01

A opção Locais não aparece no menu Cadastro ou a listagem não carrega

Mensagem exibida: Nenhuma — a opção simplesmente não aparece, ou a tela não carrega a grade.

O que fazer: confirmar se o usuário tem a permissão de visualizar local atribuída ao seu perfil de acesso.

T-02

O botão Novo não aparece ou não abre o cadastro de um local novo

Mensagem exibida: Nenhuma — o botão simplesmente não aparece, ou a ação não responde.

O que fazer: confirmar se o usuário tem a permissão de novo local atribuída ao seu perfil de acesso.

T-03

Não é possível abrir ou salvar a edição de um local existente

Mensagem exibida: Nenhuma — a ação de abrir o formulário ou de salvar não responde ou é bloqueada.

O que fazer: confirmar se o usuário tem a permissão de editar local atribuída ao seu perfil de acesso.

T-04

O botão Excluir não remove o local selecionado

Mensagem exibida: Nenhuma — a ação não responde, ou o diálogo de confirmação não avança.

O que fazer: confirmar se o usuário tem a permissão de excluir local atribuída ao seu perfil de acesso.

T-05

O painel de Empresas vinculadas não aparece no cadastro de um local

Cenário: o usuário espera ver o painel de empresas vinculadas logo ao abrir o cadastro de um local novo.

Mensagem exibida: Nenhuma — o painel simplesmente não é exibido.

O que fazer: explicar que esse comportamento é esperado — o painel só aparece depois que o local é salvo pela primeira vez e passa a ter identificador; salvar o cadastro do local antes de tentar vincular empresas a ele.

T-06

A grade de Empresas do local aparece vazia, ou o botão Novo (vínculo) não responde

Mensagem exibida: Nenhuma — a grade não carrega, ou o botão não abre o modal.

O que fazer: confirmar se o usuário tem a permissão de visualizar vínculo empresa-local (para ver a grade) e a permissão de novo vínculo empresa-local (para abrir o modal de cadastro).

T-07

Erro ao salvar um local com nome já usado

Cenário: o usuário cadastra ou renomeia um local para um nome já utilizado por outro local, mesmo de outra empresa.

Mensagem exibida: “Já existe um local cadastrado com o nome {nome}”

O que fazer: escolher outro nome; a verificação de nome duplicado considera todos os locais do sistema, não apenas os da empresa selecionada.

T-08

Erro ao excluir um local referenciado por outros cadastros

Mensagem exibida: “Não é possível deletar este local devido a ligação com alguns itens….”

O que fazer: informar ao suporte que o local está em uso por outro cadastro (por exemplo, um item de Planilha); a exclusão exige remover antes essas referências.

T-09

Erro ao vincular a mesma empresa duas vezes ao mesmo local

Mensagem exibida: “Já existe um local \”{nome do local}\” para a empresa \”{nome da empresa}\””

O que fazer: verificar na grade de Empresas do local se o vínculo já existe antes de cadastrar novamente; se necessário, editar o vínculo existente em vez de criar um novo.

T-10

Erro ao excluir um vínculo Empresa x Local em uso

Mensagem exibida: “Não foi possível efetuar a exclusão, pois o Empresa x Local está sendo utilizado”

O que fazer: informar que o vínculo está em uso por um item de Planilha daquela empresa associado àquele local; a exclusão exige remover antes essa referência.

T-11

Erro ao alterar o status de um vínculo que já não existe mais

Cenário: o usuário tenta ativar ou desativar um vínculo Empresa x Local que foi removido por outra sessão antes da ação.

Mensagem exibida: “EmpresaxTurno não encontrado.”

O que fazer: atualizar a grade de Empresas do local antes de tentar novamente; a mensagem exibida é reaproveitada de outra funcionalidade de vínculo do sistema, mas o efeito é o mesmo — o vínculo não foi encontrado.

T-12

A listagem de Locais aparece vazia ou sem o local esperado, mesmo havendo locais cadastrados

Cenário: o usuário espera ver um local específico na listagem, mas ele não aparece.

Mensagem exibida: Nenhuma — a grade simplesmente não traz o registro esperado.

O que fazer: confirmar o filtro de Empresa aplicado no painel — com uma empresa específica selecionada, só aparecem locais vinculados a ela; com a opção “Sem empresa vinculada” selecionada, só aparecem locais sem nenhuma empresa vinculada. Confirmar também se o filtro guardado da sessão anterior (reaproveitado ao voltar de um cadastro) não está restringindo além do esperado.

T-13

Cliques repetidos no botão Salvar do modal de vínculo Empresa x Local gravam o mesmo vínculo mais de uma vez

Cenário: o usuário clica várias vezes no botão Salvar do modal antes de a primeira gravação terminar.

Mensagem exibida: Nenhuma — cada clique dispara uma gravação, sem impedimento visível.

O que fazer: orientar o usuário a clicar uma única vez e aguardar a confirmação; se vínculos duplicados já tiverem sido gravados, excluir os registros repetidos pela grade de Empresas do local. Encaminhar ao responsável técnico (ver registro técnico de bugs desta feature).

T-14

A tela de Locais é redirecionada de repente para a página de erro 403

Cenário: enquanto qualquer chamada ao servidor está em andamento, a tela exibe a sobreposição “Processando”; se a resposta vier com o status de acesso proibido, o portal redireciona automaticamente para a página de erro correspondente.

Mensagem exibida: Nenhuma mensagem própria da tela — a página de erro 403 é exibida no lugar da tela de Locais.

O que fazer: confirmar se a permissão necessária para aquela ação (visualizar, novo, editar ou excluir local; ou os vínculos de Empresa x Local) ainda está atribuída ao usuário — o acesso pode ter sido revogado durante a própria sessão.

11. CASOS DE USO

Casos de Uso

Caso 1 — Cadastro de um novo local vinculado automaticamente à empresa ativa

Um usuário com permissão de novo local, com a empresa “Frigorífico Modelo Ltda” ativa na sessão, abre a listagem de Locais, clica em Novo, informa o nome “Unidade Industrial Sul” e salva. O portal exibe “Operação efetuada com sucesso.” e redireciona para a edição do local recém-criado, já com o identificador atribuído pelo servidor; o local fica automaticamente vinculado à empresa “Frigorífico Modelo Ltda”, sem que o usuário tenha escolhido essa empresa em nenhum campo do formulário.

Caso 2 — Vínculo de um local a uma segunda empresa com posição geográfica

Dentro da edição do local “Unidade Industrial Sul”, o usuário abre o painel Empresas, clica em Novo e vincula a empresa “Distribuidora Sul Ltda”, digitando de forma opcional, a latitude e longitude (ou ajustando a posição no mapa) e informando um raio de 150,00 metros. Ao salvar, o portal exibe “Operação efetuada com sucesso.”, fecha o modal e atualiza a grade de empresas vinculadas, agora com duas linhas — uma para cada empresa — cada uma com seu próprio status, ativo por padrão.

Caso 3 — Tentativa de excluir um local em uso por uma Planilha

Um usuário tenta excluir o local “Unidade Industrial Sul”, que está associado a um item de Planilha vigente. O portal exibe “Não é possível deletar este local devido a ligação com alguns itens….” e o local permanece na listagem, sem nenhuma alteração.

Caso 4 — Filtrar a listagem pela opção “Sem empresa vinculada”

Um usuário abre o painel de filtros, seleciona a opção “Sem empresa vinculada” no campo Empresa e clica em “Filtrar”. A grade recarrega mostrando apenas os locais que ainda não têm nenhuma empresa associada, mesmo que o usuário tenha acesso a várias empresas com locais próprios cadastrados.

NA PÁGINA

  • Visão Geral
  • Pré-requisitos
  • Permissões e Perfis de Acesso
  • Fluxo Operacional
  • Interface e Comportamentos da Tela
  • Feedbacks ao Usuário
  • Processamento pelo Backend
  • Regras de Negócio
  • QR Code
  • Troubleshooting
  • Casos de Uso
NEWSLETTER

Conteúdo para quem vive a indústria de alimentos

Receba conteúdos sobre tecnologia, gestão e inovação para a indústria de alimentos.

Acompanhe novidades, tendências e soluções para melhorar a eficiência da sua operação.

Produtos

  • ERP
  • Frigosoft
  • Força de Vendas
  • Coleta de Resíduos
  • Venda Ambulante
  • Coleta de Leite
  • BI Atak
  • EasyPAC
  • Delivery B2B

Soluções

  • Bovinos
  • Suínos
  • Aves
  • Ovinos
  • Pescados
  • Laticínios
  • Curtumes
  • Charqueadas
  • Distribuidores Entrepostos
  • Indústria de Alimentos em Geral

Conteúdos

  • Blog
  • E-books (em breve)
  • Podcasts (em breve)
  • Webinars (em breve)
  • Depoimentos

Ajuda

  • Dúvidas
  • Documentação (em breve)
  • Manuais (em breve)
  • Avisos (em breve)
  • Novidades (em breve)

Empresa

  • Sobre
  • Carreiras
  • Privacidade
  • Contato
  • llms.txt
  • llms-full.txt

Social

  • LinkedIn
  • Instagram
  • YouTube

© 2026 Atak Sistemas Todos os direitos reservados.

Av. Nildo Ribeiro da Rocha, 5766 Parque Tecnológico, Maringá/PR. CNPJ: 73.500.290/0001-06