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

Documentação

  • Delivery B2B
    • App
      • Autenticacao
        • Cadastro
        • Confirmação de Cadastro
        • Esqueci Minha Senha
        • Login
      • Carga
        • Captura de DANFE
        • Cross Dock
        • Nova Carga
        • Seleção de Carga
        • Tela Inicial
      • ComprovacaoEntrega
        • Assinatura do Recebedor
        • Câmera de Captura do Canhoto
        • Canhoto da Entrega
        • Canhoto Físico
        • Dados do Recebedor
        • Registro de Evidências
        • Selfie
      • Entrega
        • Cargas
        • Check-in
        • Detalhe da Carga
        • Não Entrega
    • Painel
      • Ajudantes
      • Centros de Distribuição
      • Clientes
      • Configurações
      • Entregas
      • Início
      • Login
        • Esqueci Minha Senha
        • Login
        • Redefinição de Senha
      • Motoristas
      • Rastreio
      • Relatório
      • Roteirizações
      • Veículos
Nenhum resultado encontrado
Inteligência Atak / Documentação / Delivery B2B / Painel

Configurações

Criado por Igor Ribeiro em 30 de setembro de 2026
•
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Documentação Técnica

Configurações — Painel

A tela Configurações é onde a transportadora administra os dados cadastrais da própria empresa, os parâmetros gerais de operação do sistema, os parâmetros de roteirização e os usuários que têm acesso ao Painel (cadastro, permissões por área e preferências de tour de apresentação).

01. VISÃO GERAL

Visão Geral

A tela Configurações é onde a transportadora administra os dados cadastrais da própria empresa, os parâmetros gerais de operação do sistema, os parâmetros de roteirização e os usuários que têm acesso ao Painel (cadastro, permissões por área e preferências de tour de apresentação). É uma tela de administração, não de operação do dia a dia: nela não há listagem de entregas, motoristas ou clientes — apenas os parâmetros que moldam como as demais telas do Painel e o aplicativo do motorista se comportam. A tela é dividida em abas, e cada aba guarda e salva suas próprias informações de forma independente.

02. PRÉ-REQUISITOS

Pré-requisitos

Para a tela Configurações funcionar, é necessário que:

  • o usuário tenha uma sessão autenticada válida no Painel — sem sessão ativa, qualquer ação em qualquer aba retorna erro de sessão expirada (ver Troubleshooting).
  • o perfil do usuário tenha a permissão de área “Configurações” ativa, ou seja administrador da conta — sem essa permissão, uma tentativa de acesso pela URL redireciona automaticamente para a tela Início, sem nenhum aviso, e o item de menu Configurações não é exibido.
  • a aba Usuários só aparece para quem tem a permissão de área “Usuários” ativa (permissão adicional, distinta da permissão de acesso à própria tela Configurações).
  • a aba Roterização só aparece para quem tem a permissão de área “Roteirizações” ativa E cuja empresa tenha a roteirização contratada — as duas condições precisam ser verdadeiras ao mesmo tempo.
  • para alterar qualquer dado desta tela (logo da empresa, parâmetros gerais, parâmetros de roteirização, ou qualquer ação na aba Usuários) é necessária a permissão de EDIÇÃO da área correspondente (“Configurações” para Empresa/Geral/Roterização, “Usuários” para a maior parte das ações da lista de usuários — ver Interface e Comportamentos para a única exceção) — sem ela, os campos e botões continuam visíveis, porém desabilitados.
03. FLUXO OPERACIONAL

Fluxo Operacional

  1. O usuário acessa a tela Configurações pelo menu (item exibido apenas com a permissão correspondente).
  2. A tela abre sempre na aba Empresa, independentemente de qual aba estava selecionada da última vez.
  3. O usuário alterna entre as abas visíveis (Empresa, Usuários, Geral, Roterização) clicando nos botões de aba; cada aba carrega seus próprios dados assim que é exibida pela primeira vez.
  4. Na aba Empresa, o usuário só pode substituir o logo da empresa — os demais dados são somente leitura.
  5. Nas abas Geral e Roterização, o usuário ajusta os parâmetros exibidos e clica em SALVAR para persisti-los.
  6. Na aba Usuários, o usuário cria, edita ou remove contas de acesso ao Painel, e abre janelas modais dedicadas para ajustar as permissões por área e as preferências de tour de apresentação de cada usuário.
04. INTERFACE E COMPORTAMENTOS

Interface e Comportamentos

Aba Empresa

A aba Empresa da tela Configurações exibe os dados cadastrais da própria transportadora: nome, CPF/CNPJ, contato, e-mail, telefone, endereço, validade de acesso ao sistema e, quando a empresa tem roteirização habilitada, o limite diário de veículos contratado. Todos esses campos são somente leitura — a única ação disponível é substituir o logo da empresa, clicando sobre a imagem atual (ou sobre o espaço reservado a ela) para abrir o seletor de arquivo. Enquanto o logo está sendo carregado, um indicador de carregamento é exibido no lugar da imagem.

O CPF/CNPJ é exibido formatado: documentos de até 11 caracteres são exibidos como CPF, no formato `XXX.XXX.XXX-XX`; documentos com mais de 11 caracteres são exibidos como CNPJ, no formato `XX.XXX.XXX/XXXX-XX` (a máscara aceita letras e números nessa segunda posição, compatível com o novo formato alfanumérico de CNPJ). A data de validade de acesso é reformatada de “ano-mês-dia” para “dia/mês/ano”. O telefone de contato é reformatado conforme a quantidade de dígitos: 8 dígitos viram `XXXX-XXXX`; 9 dígitos viram `XXXXX-XXXX`; 10 dígitos viram `(XX) XXXX-XXXX`; 11 dígitos viram `(XX) XXXXX-XXXX`, ou, se o primeiro dígito for zero, `X (XX) XXXX-XXXX`; 13 dígitos viram `+XX (XX) XXXXX-XXXX`; qualquer outra quantidade de dígitos é exibida sem máscara, exatamente como está cadastrada. Quando o endereço, o nome de contato, o e-mail de contato ou o telefone de contato vêm vazios, o campo mantém o texto de espera “…” em vez de ficar em branco.

Aba Usuários — Lista de Usuários

A aba Usuários lista todos os usuários cadastrados com acesso ao Painel da transportadora, em uma tabela com as colunas Nome, E-mail, Administrador (exibido como “Sim” ou “Não”) e Status (exibido como “Ativo” ou “Inativo”). Um botão “ADICIONAR” no topo abre o modal de cadastro de um novo usuário.

Cada linha da tabela tem até quatro botões de ação, cuja visibilidade depende de quem está vendo a tela e de quem é o usuário da linha. O botão de editar usuário e o botão de editar tours seguem a mesma regra: ficam visíveis se quem está vendo a tela é administrador, ou se o usuário da linha não é administrador, ou se o usuário da linha é o próprio usuário logado. O botão de editar permissões é mais restrito: só fica visível se o usuário da linha não é administrador e não é o próprio usuário logado (não é possível editar permissões de um administrador nem as próprias permissões por esta tela). Já o botão de remover usuário fica visível se quem está vendo a tela é administrador, ou se o usuário da linha não é administrador e não é o próprio usuário logado.

Note que, para quem vê a tela sendo administrador, o botão Remover fica visível inclusive em linhas de outros administradores (e na própria linha) — a única barreira nesse caso é o aviso exibido ao clicar (ver Regras de Negócio e Troubleshooting).

Cadastro e Edição de Usuário

Ao clicar em “ADICIONAR” ou em “Editar usuário”, abre-se um modal com os campos Nome, E-mail, Senha e, quando o usuário editado não é administrador nem o próprio usuário logado, um seletor de Status (Ativo/Inativo) e uma opção “Administrador”. Ao editar um usuário existente, o campo Senha é rotulado “Senha (deixe em branco para manter)” — deixá-lo vazio preserva a senha atual. Ao editar um usuário existente (não na criação), o modal também exibe a foto de perfil do usuário, com um botão sobreposto para trocá-la.

Ao salvar a edição de um usuário existente, o sistema envia apenas os campos que realmente mudaram em relação ao valor carregado; se nada mudou, nenhuma alteração é enviada, e o modal apenas informa que nada foi alterado e se fecha. Se o e-mail de acesso do PRÓPRIO usuário logado for alterado, o sistema pede confirmação antes de prosseguir, avisando que a sessão atual será encerrada e será necessário fazer login novamente; se o usuário recusar, uma segunda confirmação pergunta se deseja salvar as demais alterações mantendo o e-mail atual — recusando também essa segunda confirmação, nada é salvo. Ao confirmar a troca do próprio e-mail e salvar com sucesso, o sistema avisa que a sessão será encerrada e efetua o logout automaticamente.

Permissões do Usuário

O botão “Editar permissões” de uma linha abre um modal com uma lista de áreas do sistema (Clientes, Centros de Distribuição, Motoristas, Veículos, Roteirizações, Entregas, Ajudantes, Rastreio, Relatório, Configurações, Usuários), cada uma com uma chave “ativo” e, quando ativa, três marcações independentes: Leitura, Alteração e Administrador.

Ativar uma área concede automaticamente Leitura e desmarca Alteração e Administrador (o usuário passa a poder apenas visualizar aquela área, até que Alteração ou Administrador sejam marcados manualmente); desativar uma área desmarca as três permissões daquela área. Dentro de uma área já ativa: desmarcar Leitura desativa a área inteira (e some com Alteração/Administrador); marcar Alteração enquanto Leitura já está marcada promove automaticamente para Administrador também; desmarcar Alteração remove Administrador; marcar Administrador marca Leitura e Alteração automaticamente; desmarcar Administrador remove apenas Alteração (Leitura permanece).

Duas áreas têm uma regra cruzada especial: ativar a área Usuários ativa automaticamente (com Leitura) a área Configurações, caso ainda não estivesse ativa — não é possível ter acesso a Usuários sem ter também acesso, ao menos de leitura, a Configurações. Na direção contrária, desativar a área Configurações desativa completamente a área Usuários (as três permissões).

Ao salvar, o sistema grava de uma vez todas as permissões da lista e informa, através de uma janela de aviso bloqueante, que as alterações só entram em vigor no próximo login do usuário afetado — a sessão já aberta desse usuário continua com as permissões antigas até ele sair e entrar novamente.

Tours do Usuário

O botão “Editar tours” de uma linha abre um modal com uma marcação por seção do sistema, controlando se o tutorial guiado daquela seção deve ser exibido automaticamente para aquele usuário. A seção Início está sempre disponível para qualquer usuário; as demais seções (Clientes, Centros de Distribuição, Motoristas, Veículos, Roteirizações, Entregas, Rastreio, Relatório, Configurações) só aparecem no modal se o usuário editado tiver a permissão de área correspondente ativa — sendo que Centros de Distribuição, Veículos e Roteirizações aparecem apenas se a empresa também tiver a roteirização habilitada. Se o usuário editado for administrador, todas as seções ficam disponíveis para marcação, independentemente de permissões individuais.

Aba Geral — Parâmetros Gerais

A aba Geral reúne parâmetros gerais de operação do sistema: o filtro de monitoramento de entregas exibido ao motorista no aplicativo (Notas Fiscais / Pedidos / Ambos), se o motorista pode reordenar a sequência de entrega da carga no aplicativo, o tempo mínimo de permanência do motorista numa região para que ela seja demarcada no mapa de rastreio, o tamanho do raio dessa região de permanência, se o motorista recebe atualização por e-mail sobre a situação da entrega, o separador padrão do arquivo .CSV de exportação e, quando a empresa permite check-in por proximidade, o tamanho da cerca eletrônica (distância mínima do endereço do cliente exigida para o motorista fazer check-in). Um botão SALVAR grava as alterações.

Aba Roterização — Parâmetros de Roteirização

A aba Roterização reúne os parâmetros usados pelo motor de roteirização ao montar os roteiros: horário inicial e final do turno, horário inicial e final do intervalo de almoço, velocidade média dos veículos, tempo/peso de descarregamento (por minuto de peso ou tempo médio fixo por cliente — apenas um dos dois deve ser informado), e o tipo padrão de entregas exibidas para roteirização (Nota Fiscal / Pedido / Todos). Quando a empresa está integrada ao sistema ERP Atak, campos adicionais aparecem: URL da API do sistema integrado, se o campo Percurso deve vir pré-preenchido com o percurso padrão na sincronização de cargas, se o código da carga deve ser gerado automaticamente ao finalizar um roteiro, o código do motorista padrão e da transportadora padrão para a sincronização, o tipo de frete, o código do tipo de movimento (TMV) usado para identificar pontos de parada obrigatórios, os códigos TMV que não devem ser sincronizados, e o nome padrão do cliente sincronizado (Razão Social ou Nome Fantasia). Um botão SALVAR grava as alterações, após validação dos campos preenchidos (ver Regras de Negócio e Troubleshooting).

05. FEEDBACKS AO USUÁRIO

Feedbacks ao Usuário

Aba Empresa

SituaçãoFeedbackMensagem
Falha de comunicação ao carregar os dados da empresaNotificação de erro“Não foi possível obter as informações.”
Servidor não retorna nenhum dado ao carregar os dados da empresaNotificação de erro“Não foi possível obter a lista.”
Servidor retorna um erro de negócio ao carregar os dados da empresaNotificação de erromensagem devolvida pelo servidor
Sessão expirada ao carregar os dados da empresa ou ao enviar o logoNotificação de erro; a sessão é encerrada automaticamente 2 segundos depois“Desculpe, sua sessão expirou.”
Falha de comunicação ao carregar o logoNotificação de erro“Não foi possível obter o logo.”
Falha de comunicação ao enviar o novo logoNotificação de erro“Não foi possível enviar o novo logo.”
Servidor recusa o arquivo enviado como logoNotificação de erromensagem devolvida pelo servidor (“Erro no envio.” ou “Imagem inválida.”)
Logo enviado com sucessoNotificação de sucesso“Enviado com sucesso.”

Aba Usuários — Lista e Exclusão

SituaçãoFeedbackMensagem
Falha ao carregar a lista de usuáriosNotificação de erromensagem devolvida pelo servidor
Antes de excluir um usuárioCaixa de diálogo de confirmação“Tem certeza que deseja excluir o usuário?”
Usuário-alvo é administrador, ao tentar excluirNotificação de erro (não impede a continuação — ver Troubleshooting)“Você não pode excluir um usuário administrador.”
Falha do servidor ao excluir um usuárioNotificação de erromensagem devolvida pelo servidor

Cadastro e Edição de Usuário — Validações

SituaçãoFeedbackMensagem
Nome não informado ao criar um usuárioNotificação de erro“Nome é obrigatório.”
E-mail não informado ao criar um usuárioNotificação de erro“Email é obrigatório.”
E-mail em formato inválidoNotificação de erro“Informe um e-mail válido.”
E-mail já usado por outro usuárioNotificação de erro“Email já cadastrado.”
Senha não informada ao criar um usuárioNotificação de erro“Senha é obrigatória.”
Senha com menos de 8 caracteresNotificação de erro“A senha deve conter pelo menos 8 caracteres.”
Senha sem nenhum númeroNotificação de erro“A senha deve conter pelo menos um número.”
Senha sem nenhuma letraNotificação de erro“A senha deve conter pelo menos uma letra”
Tentativa de alterar o status de um usuário administradorNotificação de erro“Você não pode desabilitar um usuário administrador.”

Cadastro e Edição de Usuário — Resultado da Operação e Foto de Perfil

SituaçãoFeedbackMensagem
Nenhum campo alterado ao editar um usuárioNotificação de sucesso; o modal se fecha sem enviar nada“Nunhuma informação alterada.”
Confirmação antes de alterar o próprio e-mail de acessoCaixa de diálogo de confirmação (título “AVISO”)“Devido a alteração do e-mail de acesso, você será desconectado e precisará fazer o login novamente. Deseja continuar?”
Segunda confirmação ao recusar a troca do próprio e-mailCaixa de diálogo de confirmação (título “AVISO”)“O seu e-mail de acesso não será alterado, deseja salvar as demais informações?”
Alterações salvas com sucessoNotificação de sucesso“Informações salvas com sucesso.”
Aviso final após trocar o próprio e-mail com sucessoJanela de aviso bloqueante, seguida de encerramento automático da sessão“Você será desconectado agora”
Falha ao enviar a foto de perfilNotificação de erromensagem devolvida pelo servidor
Foto de perfil enviada com sucessoNotificação de sucesso“Enviado com sucesso.”

Permissões e Tours do Usuário

SituaçãoFeedbackMensagem
Tentativa de alterar as permissões de um administradorNenhuma — falha internamente sem exibir mensagem (ver Troubleshooting)Nenhuma
Falha de comunicação ao salvar permissõesNenhuma — falha internamente sem exibir mensagem (ver Troubleshooting)Nenhuma
Permissões salvas com sucessoJanela de aviso bloqueante, seguida de notificação de sucesso“Essas alterações entrarão em efeito após o próximo login do usuário.” / “Permissões salvas com sucesso.”
Falha de comunicação ou do servidor ao salvar toursNenhuma — falha internamente sem exibir mensagem (ver Troubleshooting)Nenhuma
Tours salvos com sucessoNotificação de sucessomensagem devolvida pelo servidor

Aba Geral — Validação dos Parâmetros

SituaçãoFeedbackTexto exato
Tempo mínimo de permanência informado abaixo de 10 minutosNotificação de erro; salvamento não é enviado“O tempo de premanência deve ser maior ou igual a 10 min.”
Raio da região de permanência informado abaixo de 50 metrosNotificação de erro; salvamento não é enviado“O tamanho da área de marcação deve ser maior ou igual a 50 metros.”

Aba Geral — Resultado ao Salvar

SituaçãoFeedbackMensagem
Falha do servidor ao salvar os parâmetros geraisNotificação de erro, seguida (indevidamente — ver Troubleshooting) de uma notificação de sucessomensagem devolvida pelo servidor
Parâmetros gerais salvos com sucessoDuas notificações de sucesso em sequência“Enviado com sucesso.” / “Configurações salvas com sucesso.”

Aba Roterização — Validação de Horários

SituaçãoFeedbackTexto exato
Horário inicial maior ou igual ao horário finalNotificação de erro; salvamento não é enviado“Horário de inicio não pode ser maior, ou igual, ao Horário de término.”
Horário inicial preenchido sem horário finalNotificação de erro; salvamento não é enviado“Horário de término não preenchido.”
Horário final preenchido sem horário inicialNotificação de erro; salvamento não é enviado“Horário de início não preenchido.”
Horário inicial do almoço maior ou igual ao final do almoçoNotificação de erro; salvamento não é enviado“Horário de inicio do almoço não pode ser maior, ou igual, ao Horário de término do almoço.”
Horário inicial do almoço preenchido sem horário final do almoçoNotificação de erro; salvamento não é enviado“Horário de término do almoço não preenchido.”
Horário final do almoço preenchido sem horário inicial do almoçoNotificação de erro; salvamento não é enviado“Horário de início do almoço não preenchido.”
Horário inicial do turno maior ou igual ao horário inicial do almoçoNotificação de erro; salvamento não é enviado“Horário de inicio não pode ser maior, ou igual, ao Horário de início do almoço.”
Horário inicial do turno maior ou igual ao horário final do almoçoNotificação de erro; salvamento não é enviado“Horário de inicio não pode ser maior, ou igual, ao Horário de término do almoço.”
Horário final do turno menor ou igual ao horário inicial do almoçoNotificação de erro; salvamento não é enviado“Horário de término não pode ser menor, ou igual, ao Horário de início do almoço.”
Horário final do turno menor ou igual ao horário final do almoçoNotificação de erro; salvamento não é enviado“Horário de término não pode ser menor, ou igual, ao Horário de término do almoço.”

Aba Roterização — Validação de Velocidade, Descarregamento e TMV

SituaçãoFeedbackTexto exato
Velocidade média num formato não reconhecidoNotificação de erro; salvamento não é enviado“Velocidade inválida.”
Velocidade média igual ou menor que zeroNotificação de erro; salvamento não é enviado“Velocidade média não pode ser igual ou menor que zero.”
Descarregamento por peso e tempo médio informados ao mesmo tempoNotificação de erro; salvamento não é enviado“É necessário informar somente um dos dois campo, o Descarregamento de peso por minuto ou o Tempo médio de descarregamento.”
Descarregamento de peso por minuto igual ou menor que zeroNotificação de erro; salvamento não é enviado“Descarregamento de peso por minuto não pode ser igual ou menor que zero.”
Descarregamento de peso por minuto num formato não reconhecidoNotificação de erro; salvamento não é enviado“Descarregamento de peso por minuto inválido.”
Tempo médio de descarregamento igual ou menor que zeroNotificação de erro; salvamento não é enviado“Tempo médio de descarregamento não pode ser igual ou menor que zero.”
Tempo médio de descarregamento num formato não reconhecidoNotificação de erro; salvamento não é enviado“Tempo médio de descarregamento inválido.”
Código TMV de parada também presente na lista de códigos não sincronizáveisNotificação de erro; salvamento não é enviado“Código TMV de parada, não pode está na lista de não sincronizáveis.”

Aba Roterização — Resultado ao Salvar

SituaçãoFeedbackMensagem
Falha do servidor ao salvar os parâmetros de roteirizaçãoNotificação de erromensagem devolvida pelo servidor
Parâmetros de roteirização salvos com sucessoNotificação de sucesso“Configurações salvas com sucesso.”
06. REGRAS DE NEGÓCIO

Regras de Negócio

Formatação de Documento e Telefone

O CPF/CNPJ da empresa é formatado conforme o tamanho do valor: até 11 caracteres vira `XXX.XXX.XXX-XX`; mais de 11 caracteres vira `XX.XXX.XXX/XXXX-XX` (aceitando letras nos dois primeiros grupos, compatível com CNPJ alfanumérico). O telefone de contato é formatado conforme a quantidade de dígitos, com máscaras específicas para 8, 9, 10, 11 (com variação para números começando em zero) e 13 dígitos; qualquer outra quantidade de dígitos permanece sem máscara.

Valores Padrão dos Parâmetros da Empresa

Quando um parâmetro nunca foi definido, o sistema assume os seguintes valores padrão: motorista pode reordenar a carga = sim; filtro de monitoramento no aplicativo = “Ambos”; tipo de entregas exibidas para roteirização = “Todos”; separador do arquivo .CSV = ponto e vírgula; fator de correção do roteirizador = 100; tempo mínimo de permanência = 10 minutos; raio da região de permanência = 300 metros; geração automática do código da carga = sim; percurso padrão pré-preenchido = sim; envio de atualização de situação de entrega ao motorista = não; demais parâmetros (URL da API integrada, códigos padrão de motorista/transportadora/tipo de frete/TMV, nome padrão do cliente sincronizado, tamanho da cerca eletrônica de check-in, lista de códigos TMV não sincronizáveis) começam vazios/sem valor.

Quando a empresa está integrada ao sistema ERP Atak, o campo de integração é sempre ajustado para essa integração ao abrir a aba Roterização, independentemente do valor gravado anteriormente (atualmente é a única integração disponível).

Alterar e salvar os parâmetros de uma aba (Geral ou Roterização) não apaga nem altera os parâmetros da outra aba — cada aba preserva os valores que não pertencem a ela.

Cadastro e Edição de Usuários

Ao criar um usuário: nome, e-mail, senha e status são obrigatórios. A senha precisa ter ao menos 8 caracteres, ao menos um número e ao menos uma letra. O e-mail precisa ter formato válido e ser único entre TODOS os usuários do sistema, não apenas os da mesma empresa. Ao editar um usuário existente, todos os campos são opcionais — apenas os campos preenchidos são alterados, e a senha só é atualizada se um novo valor for informado (do contrário, a senha atual é mantida). Ao criar um novo usuário, o sistema concede automaticamente a ele o conjunto padrão de permissões por área e disponibiliza o tour de apresentação de todas as seções do sistema.

Um usuário não pode ter seu status (ativo/inativo) alterado se for administrador. Promover um usuário a administrador concede automaticamente edição e administração em toda área de permissão já ativa para ele; rebaixar um administrador para usuário comum remove a edição e a administração de toda área ativa, mantendo apenas a leitura.

Permissões por Área

Cada área do sistema tem três níveis de permissão independentes — leitura, edição e administração — condicionados a a área estar ativa. Ativar administração implica automaticamente leitura e edição; ativar edição (com leitura já ativa) implica automaticamente administração; desativar leitura desativa a área inteira. A área Usuários depende da área Configurações estar ativa (ativar Usuários ativa Configurações com leitura; desativar Configurações desativa Usuários por completo) — não existe combinação válida com Usuários ativo e Configurações inativo. Um usuário administrador nunca tem suas permissões alteradas por esta tela — a tentativa é sempre rejeitada.

Tours de Apresentação

A disponibilidade de cada tour de apresentação para um usuário reflete as permissões de área desse usuário: o tour de uma seção só pode ser habilitado se o usuário tiver permissão de acesso àquela seção (ou for administrador, caso em que todas as seções ficam disponíveis), e os tours de Centros de Distribuição, Veículos e Roteirizações dependem adicionalmente de a empresa ter a roteirização habilitada. O tour da seção Início está sempre disponível, para qualquer usuário.

07. TROUBLESHOOTING

Troubleshooting

T-01

Sessão expira durante o uso da aba Empresa

Cenário: o usuário estava com a aba Empresa aberta havia tempo e a sessão expirou.

Mensagem exibida: “Desculpe, sua sessão expirou.”

O que fazer: aguardar o redirecionamento automático (ocorre 2 segundos depois da mensagem) e fazer login novamente.

T-02

Sessão expira durante o uso das demais abas de Configurações

Cenário: o usuário estava numa aba diferente de Empresa (Usuários, Geral, Roterização, ou um dos modais de usuário) quando a sessão expirou.

Mensagem exibida: Nenhuma — a tela recarrega abruptamente, sem nenhum aviso prévio.

O que fazer: fazer login novamente; nenhuma informação foi perdida além da alteração que estava em andamento no momento da expiração.

T-03

Acesso direto à URL de Configurações sem a permissão necessária

Cenário: o usuário tenta acessar a tela Configurações diretamente pela URL, sem ter a permissão de área correspondente ativa.

Mensagem exibida: Nenhuma — o sistema redireciona silenciosamente para a tela Início.

O que fazer: solicitar a um administrador da conta que conceda a permissão de área “Configurações”.

T-04

Dados da empresa não carregam na aba Empresa

Cenário: ao abrir a aba Empresa, os campos permanecem com o texto de espera “…” e uma notificação de erro aparece.

Mensagem exibida: “Não foi possível obter as informações.” (falha de comunicação) ou “Não foi possível obter a lista.” (servidor não retornou dados)

O que fazer: tentar novamente; se persistir, contatar o suporte informando o horário da falha.

T-05

Logo da empresa não é enviado

Cenário: o usuário seleciona uma nova imagem para o logo e o envio não é concluído.

Mensagem exibida: “Não foi possível enviar o novo logo.” (falha de comunicação), ou “Erro no envio.”/”Imagem inválida.” (arquivo recusado pelo servidor)

O que fazer: verificar se o arquivo selecionado é realmente uma imagem e tentar novamente; se a mensagem persistir sem motivo aparente, contatar o suporte.

T-06

Logo da empresa fica carregando indefinidamente

Cenário: ao abrir a aba Empresa, o indicador de carregamento do logo nunca é substituído pela imagem, e nenhuma mensagem de erro aparece.

Mensagem exibida: Nenhuma — a tela permanece com o indicador de carregamento girando indefinidamente.

O que fazer: verificar a conexão com a internet e recarregar a página; se persistir, contatar o suporte.

T-07

Exclusão de um usuário administrador aparenta ser bloqueada, mas o usuário é removido mesmo assim

Cenário: um administrador tenta remover, na lista de Usuários, uma conta marcada como administrador (inclusive, potencialmente, a própria conta).

Mensagem exibida: “Você não pode excluir um usuário administrador.” — seguida, se a exclusão for confirmada na caixa de diálogo, pela remoção efetiva do usuário, sem nenhum aviso adicional de que a exclusão foi concluída apesar do alerta.

O que fazer: não confirmar a exclusão quando esse aviso aparecer. Se um administrador tiver sido removido por engano, é necessário recriar a conta manualmente (a conclusão da exclusão não pode ser desfeita pela tela).

T-08

Criação de usuário só aponta campo obrigatório faltante depois de tentar salvar

Cenário: ao criar um novo usuário, o usuário do sistema deixa Nome, E-mail ou Senha em branco — a tela não sinaliza esses campos como obrigatórios antes da tentativa de salvar.

Mensagem exibida: “Nome é obrigatório.” / “Email é obrigatório.” / “Senha é obrigatória.” (conforme o campo faltante)

O que fazer: preencher o campo indicado e salvar novamente. Ao criar um novo usuário, preencha sempre Nome, E-mail e Senha, mesmo que a tela não os destaque como obrigatórios.

T-09

E-mail já cadastrado ao criar ou editar um usuário

Cenário: o e-mail informado já está em uso por outro usuário do sistema (de qualquer empresa, não apenas da mesma transportadora).

Mensagem exibida: “Email já cadastrado.”

O que fazer: usar outro e-mail para o novo usuário, ou confirmar com o suporte se o e-mail já pertence a um cadastro existente que deveria ser reaproveitado.

T-10

E-mail em formato inválido ao criar ou editar um usuário

Cenário: o e-mail informado não corresponde a um formato de e-mail válido.

Mensagem exibida: “Informe um e-mail válido.”

O que fazer: corrigir o formato do e-mail informado.

T-11

Senha recusada ao criar ou editar um usuário

Cenário: a senha informada não atende aos critérios mínimos de segurança.

Mensagem exibida: “A senha deve conter pelo menos 8 caracteres.” / “A senha deve conter pelo menos um número.” / “A senha deve conter pelo menos uma letra”

O que fazer: informar uma senha com pelo menos 8 caracteres, contendo ao menos uma letra e um número.

T-12

Alterar o próprio e-mail de acesso força um novo login

Cenário: o usuário logado edita a própria conta e altera o e-mail de acesso.

Mensagem exibida: “Devido a alteração do e-mail de acesso, você será desconectado e precisará fazer o login novamente. Deseja continuar?”, seguida, se confirmada, de “Você será desconectado agora”

O que fazer: confirmar a alteração e, na sequência, fazer login novamente com o novo e-mail; ou, na primeira confirmação, recusar e escolher salvar apenas as demais alterações sem trocar o e-mail.

T-13

Tentativa de alterar o status, as permissões ou o papel de um administrador

Cenário: ao tentar mudar o status de um usuário administrador (na edição de usuário) ou ao tentar abrir/salvar as permissões de um usuário administrador.

Mensagem exibida: “Você não pode desabilitar um usuário administrador.” (edição de status) — para permissões de administrador, a tela nem sequer exibe o botão “Editar permissões” na linha correspondente, e uma tentativa de salvar diretamente é rejeitada sem nenhuma mensagem visível (ver T-16).

O que fazer: o papel e as permissões de um administrador não são alteráveis por esta tela; se necessário, contatar o suporte para rebaixar o usuário a não-administrador primeiro.

T-14

“Nenhuma informação alterada” ao editar um usuário

Cenário: o usuário abre a edição de um usuário e clica em salvar sem alterar nenhum campo.

Mensagem exibida: “Nunhuma informação alterada.”

O que fazer: nenhuma ação necessária — nada foi enviado, e o modal se fecha normalmente.

T-15

Falha ao enviar a foto de perfil de um usuário

Cenário: o usuário tenta trocar a foto de perfil de um usuário (própria ou de outro), a partir do modal de edição de usuário.

Mensagem exibida: mensagem devolvida pelo servidor (“Erro no envio.” ou “Imagem inválida.” quando o arquivo é recusado)

O que fazer: verificar se o arquivo selecionado é realmente uma imagem e tentar novamente.

T-16

Salvar permissões de um usuário não dá nenhum retorno visível quando falha

Cenário: falha de comunicação ao salvar as permissões de um usuário, ou tentativa de salvar permissões de um usuário administrador.

Mensagem exibida: Nenhuma — a tela não exibe nenhuma notificação de erro nesses casos. Na falha de comunicação, os botões do modal também permanecem desabilitados indefinidamente.

O que fazer: se o modal parecer travado (botões desabilitados sem nenhuma mensagem), fechar e reabrir o modal e tentar novamente; se persistir, contatar o suporte.

T-17

Salvar tours de um usuário não dá nenhum retorno visível quando falha

Cenário: falha de comunicação ou erro do servidor ao salvar as preferências de tour de um usuário.

Mensagem exibida: Nenhuma — a tela não exibe nenhuma notificação de erro nesses casos.

O que fazer: fechar e reabrir o modal e tentar novamente; se persistir, contatar o suporte.

T-18

Tempo de permanência abaixo do mínimo, na aba Geral

Cenário: o usuário informa, no campo “Mostrar permanência de motorista maior que”, um valor abaixo de 10 minutos.

Mensagem exibida: “O tempo de premanência deve ser maior ou igual a 10 min.”

O que fazer: informar um valor de 10 minutos ou mais.

T-19

Raio da região de permanência abaixo do mínimo, na aba Geral

Cenário: o usuário informa, no campo “Tamanho do raio da região de permanência”, um valor abaixo de 50 metros.

Mensagem exibida: “O tamanho da área de marcação deve ser maior ou igual a 50 metros.”

O que fazer: informar um valor de 50 metros ou mais.

T-20

Mensagem de sucesso aparece mesmo quando o salvamento da aba Geral falha

Cenário: o servidor recusa o salvamento dos parâmetros gerais (por exemplo, por falha de comunicação ou erro interno) — a notificação de erro correta aparece, mas é seguida por uma notificação de sucesso.

Mensagem exibida: mensagem de erro devolvida pelo servidor, seguida por “Configurações salvas com sucesso.”

O que fazer: não confiar apenas na mensagem final de sucesso; se uma mensagem de erro apareceu antes dela, considerar que o salvamento pode não ter sido concluído e verificar os parâmetros novamente (reabrindo a aba) antes de assumir que foram gravados.

T-21

Parâmetros de roteirização não salvam por causa dos horários informados

Cenário: o usuário preenche os horários de turno e de almoço na aba Roterização de forma incompleta ou fora de ordem (por exemplo, horário final menor que o inicial, ou apenas um dos dois horários de um par preenchido).

Mensagem exibida: uma das dez mensagens de validação de horário listadas em Feedbacks ao Usuário (ex.: “Horário de inicio não pode ser maior, ou igual, ao Horário de término.”)

O que fazer: revisar os quatro campos de horário (início/término do turno e início/término do almoço), preenchendo ambos os campos de cada par e respeitando a ordem cronológica esperada entre eles.

T-22

Velocidade média inválida na aba Roterização

Cenário: o usuário informa uma velocidade média em um formato não reconhecido ou igual/menor que zero.

Mensagem exibida: “Velocidade inválida.” ou “Velocidade média não pode ser igual ou menor que zero.”

O que fazer: informar um valor numérico positivo no campo Velocidade Média.

T-23

Descarregamento inválido ou duplamente preenchido na aba Roterização

Cenário: o usuário preenche os dois campos de descarregamento (peso por minuto e tempo médio) ao mesmo tempo, ou informa um valor igual/menor que zero, ou num formato não reconhecido, em qualquer um dos dois.

Mensagem exibida: “É necessário informar somente um dos dois campo, o Descarregamento de peso por minuto ou o Tempo médio de descarregamento.” ou uma das mensagens específicas de valor inválido listadas em Feedbacks ao Usuário

O que fazer: preencher apenas um dos dois campos de descarregamento, com um valor numérico positivo.

T-24

Código TMV de parada duplicado na lista de códigos não sincronizáveis

Cenário: o código TMV informado no campo “Código TMV para parada” também está presente na lista de “Códigos TMVs não sincronizáveis”.

Mensagem exibida: “Código TMV de parada, não pode está na lista de não sincronizáveis.”

O que fazer: remover o código da lista de não sincronizáveis, ou escolher outro código de parada que não esteja nessa lista.

T-25

Falha de comunicação ao salvar os parâmetros de roteirização

Cenário: o usuário clica em SALVAR na aba Roterização e a requisição não é concluída com sucesso.

Mensagem exibida: mensagem devolvida pelo servidor

O que fazer: tentar novamente; se persistir, contatar o suporte informando o horário da falha.

T-26

Aba Empresa não exibe nenhum dado e não mostra nenhuma mensagem de erro

Cenário: ao abrir a aba Empresa, nenhum dos campos é preenchido (permanecem com o texto de espera “…”) e, diferente de uma falha comum de comunicação, nenhuma notificação de erro aparece — a tela simplesmente não reage.

Mensagem exibida: Nenhuma — quando a empresa vinculada à sessão não é localizada, a resposta chega como sucesso vazio, e o carregamento dos campos falha internamente sem notificar o usuário.

O que fazer: recarregar a página; se o problema persistir, contatar o suporte informando o horário da falha, já que pode indicar uma inconsistência no cadastro da empresa que precisa ser corrigida.

08. CASOS DE USO

Casos de Uso

Caso 1 — Transportadora troca o logo da empresa

Um administrador acessa Configurações, permanece na aba Empresa (padrão de abertura) e clica sobre o espaço do logo atual. Seleciona uma nova imagem no seletor de arquivo do sistema operacional; a tela mostra o indicador de carregamento, envia o arquivo e, ao concluir, exibe “Enviado com sucesso.” e atualiza a imagem exibida.

Caso 2 — Empresa sem roteirização contratada ajusta os parâmetros gerais

Um usuário com permissão de edição em Configurações, de uma empresa sem roteirização habilitada, abre a aba Geral (a aba Roterização não aparece para essa empresa). Altera o filtro “Monitorar no APP” para “Somente Pedidos” e o tempo de permanência para “15 min”, e clica em SALVAR. O sistema valida os valores, grava e exibe as notificações de sucesso.

Caso 3 — Administrador cadastra um novo usuário operacional

Um administrador abre a aba Usuários e clica em “ADICIONAR”. Preenche Nome, E-mail e Senha (sem indicação visual de obrigatoriedade, já que está criando um usuário novo) e clica em salvar. Em seguida, na lista, clica em “Editar permissões” do usuário recém-criado e ativa as áreas Entregas (leitura e edição) e Rastreio (somente leitura), salvando as permissões — que só valerão a partir do próximo login desse usuário.

Caso 4 — Empresa integrada ao ERP Atak ajusta os parâmetros de roteirização

Um administrador de uma empresa integrada ao sistema ERP Atak, com roteirização habilitada, abre a aba Roterização. Além dos campos padrão (horários, velocidade média, descarregamento), preenche os campos específicos da integração: URL da API do sistema integrado, código do motorista padrão, código da transportadora padrão, tipo de frete e o código TMV usado para identificar pontos de parada. Ao tentar salvar com o código TMV de parada igual a um dos códigos já cadastrados como não sincronizável, recebe o aviso de conflito e corrige a lista antes de salvar com sucesso.

Caso 5 — Administrador tenta remover a própria conta por engano

Um administrador, navegando pela lista de Usuários, clica sem perceber no botão Remover da própria linha (visível porque quem está vendo a lista é administrador). O sistema exibe o aviso “Você não pode excluir um usuário administrador.” e, na sequência, a caixa de confirmação “Tem certeza que deseja excluir o usuário?” — se confirmada, a própria conta é efetivamente removida, apesar do aviso anterior (ver Troubleshooting, T-07).

NA PÁGINA

  • Visão Geral
  • Pré-requisitos
  • Fluxo Operacional
  • Interface e Comportamentos
  • Feedbacks ao Usuário
  • Regras de Negócio
  • 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