Veículos
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Veículos — Painel
A tela Veículos é onde a transportadora cadastra, edita e remove os veículos da própria frota, e onde configura os atributos que o motor de roteirização usa para calcular rotas (capacidade de peso e volume, tipo de carroceria, velocidade média, quantidade de eixos, ocupação mínima).
Visão Geral
A tela Veículos é onde a transportadora cadastra, edita e remove os veículos da própria frota, e onde configura os atributos que o motor de roteirização usa para calcular rotas (capacidade de peso e volume, tipo de carroceria, velocidade média, quantidade de eixos, ocupação mínima). É uma tela de cadastro com lista paginada e um formulário único de cadastro/edição, e conta ainda com um recurso de sincronização em lote com o sistema ERP Atak, disponível apenas para empresas integradas a esse sistema. Os veículos cadastrados aqui alimentam a lista de veículos disponível para a roteirização e para o vínculo de motorista fixo.
Pré-requisitos
Para a tela Veículos funcionar, é necessário que:
- o usuário tenha uma sessão autenticada válida no Painel — sem sessão ativa, qualquer requisição retorna erro de sessão expirada (ver Troubleshooting).
- o perfil do usuário tenha a permissão de área “Veículos” ativa (ou uma das permissões de área próximas de domínio — Entregas, Roteirização, Motoristas ou Relatório — ativa), ou seja administrador da conta — sem nenhuma dessas permissões, uma tentativa de acesso pela URL redireciona automaticamente para a tela Início, sem nenhum aviso, e o item de menu não é exibido.
- a empresa tenha a roteirização contratada — mesmo com a permissão de área ativa, sem a roteirização contratada o acesso é bloqueado da mesma forma (redirecionamento silencioso para a tela Início).
- para cadastrar, editar ou remover um veículo (não apenas consultar a lista) é necessária a permissão de EDIÇÃO da área “Veículos” — sem ela, os botões ADICIONAR, SINCRONIZAR, editar e remover continuam visíveis, porém desabilitados.
- para usar a sincronização com o sistema Atak, a empresa precisa estar marcada como cliente integrado ao ERP Atak (o botão SINCRONIZAR só aparece nessa condição) e ter o endereço do sistema integrado configurado na tela de Configurações, aba Roteirização — sem esse endereço configurado, o modal de sincronização se fecha automaticamente ao abrir, com uma mensagem de erro.
Fluxo Operacional
- O usuário acessa a tela Veículos pelo menu (item exibido apenas com a permissão de área e a roteirização contratada).
- A tela carrega automaticamente a lista de veículos já cadastrados da empresa (ordenada por Placa), a lista de motoristas vinculados à empresa (para o campo de motorista fixo) e as configurações gerais da empresa (para saber se a sincronização com o Atak está disponível).
- O usuário pode filtrar a lista digitando um termo e pressionando Enter, e pode reordenar a lista clicando nas colunas Placa, Marca, Tipo, Carroceria, Modelo, Cap. Peso, Combustível ou Centro Expandido.
- Para cadastrar um novo veículo, o usuário clica em ADICIONAR, preenche a placa, marca, tipo, carroceria e demais dados, e clica em SALVAR.
- Para editar um veículo existente, o usuário clica no ícone de edição da linha correspondente, ajusta os campos necessários (exceto a placa, que não pode ser alterada) e salva.
- Para remover um veículo, o usuário clica no ícone de remoção da linha correspondente e confirma a exclusão.
- Para empresas integradas ao sistema Atak, o usuário pode clicar em SINCRONIZAR para abrir o modal de sincronização, buscar os veículos cadastrados no sistema integrado, selecionar quais trazer para o Painel e confirmar a sincronização em lote.
Interface e Comportamentos
Lista de Veículos
A lista de Veículos exibe, por registro, Placa, Marca, Tipo, Carroceria, Modelo, Capacidade de Peso, Capacidade de Volume, Combustível, “Centro Expandido (SP)” e “Rodízio (SP)”. Marca, Tipo, Carroceria, Modelo e Combustível são exibidos com uma formatação visual “capitalizada” (aparência de Título Inicial Maiúsculo). Modelo, Capacidade de Volume e Combustível exibem “Não Definido”, em cinza, quando o campo não foi informado no cadastro. A Capacidade de Peso é sempre exibida seguida de “kg”; a Capacidade de Volume, quando informada, é exibida seguida de “m³”.
“Centro Expandido (SP)” mostra “SIM” quando o veículo tem permissão para circular na área de centro expandido de São Paulo, e “NÃO” nos demais casos (incluindo quando o dado não foi informado). “Rodízio (SP)” é calculado apenas para exibição: quando o veículo tem “Centro Expandido (SP)” marcado como SIM, o dia da semana em que o rodízio municipal se aplica é calculado a partir do último dígito da placa (ver Regras de Negócio); quando “Centro Expandido (SP)” é NÃO ou não informado, a coluna sempre mostra “NÃO”.
A lista é paginada (20 registros por página) e mostra o total de resultados encontrados. A busca por texto só é disparada ao pressionar Enter no campo de filtro (não a cada tecla digitada) e volta a lista para a primeira página; o termo digitado é comparado, por correspondência parcial, contra a placa, a marca, o tipo, a carroceria, o modelo e o combustível do veículo — uma correspondência em qualquer um desses campos já retorna o registro. Apenas as colunas Placa, Marca, Tipo, Carroceria, Modelo, Capacidade de Peso, Combustível e Centro Expandido podem ser usadas para reordenar a lista clicando no cabeçalho.
Cada linha tem dois botões de ação — editar e remover — ambos desabilitados sem a permissão de edição da área. O botão ADICIONAR, no topo da lista, segue a mesma regra de habilitação. Para empresas integradas ao ERP Atak, um botão SINCRONIZAR (também desabilitado sem a permissão de edição) abre o modal de sincronização em lote. Um botão de TOUR reabre o tutorial guiado da tela, e um link “ABRIR TUTORIAL” abre, em uma nova aba, um documento PDF de ajuda.
Cadastro e Edição de Veículo
Ao clicar em ADICIONAR ou no ícone de edição de uma linha, abre-se um modal com o título “NOVO VEÍCULO” ou “EDITAR VEÍCULO”, conforme o caso. O modal reúne, em quatro grupos:
- Informações gerais: Placa (obrigatória, com máscara de captura de 7 caracteres no padrão letra-letra-letra-número-letra ou número-número-número, compatível com placa comum e placa Mercosul; não pode ser alterada na edição de um veículo já cadastrado), Marca (obrigatória, lista fixa de fabricantes), Tipo (obrigatório, lista fixa: Carro, Carreta, Moto, Toco, Truck, Utilitário, Van, VUC, Outro), Carroceria (obrigatória, lista fixa de tipos de carroceria) e Modelo (texto livre, opcional).
- Capacidade: Peso (obrigatório, com máscara progressiva terminando em “kg”) e Volume (opcional, com máscara progressiva terminando em “m³”).
- Custos de Pedágio e Combustível: Combustível (opcional, lista fixa: Diesel, Etanol, Gasolina, GNV, Outro), Velocidade Média (opcional, com máscara terminando em “km/h”; a tela indica, na dica de preenchimento, que sem esse valor o motor de roteirização considera por padrão 40 km/h) e Eixos (opcional, um único dígito).
- Regras: Ocupação Mínima (opcional, percentual) e “Centro Expandido (SP)” (caixa de marcação — permissão para circular na área de centro expandido de São Paulo).
- Detalhes: “Retorna a origem?” (caixa de marcação — indica se o veículo deve retornar ao centro de distribuição de origem ao final do roteiro) e Motorista Fixo (lista de seleção, só exibida quando existe ao menos um motorista vinculado à empresa; cada opção mostra o nome do motorista em maiúsculas seguido do CPF formatado).
Ao clicar em SALVAR, o sistema envia os dados; havendo sucesso, o modal fecha e a lista é recarregada.
Sincronização de Veículos com o Sistema Atak
O modal de sincronização (acessível pelo botão SINCRONIZAR, só visível para empresas integradas ao ERP Atak) tem duas telas internas:
- Seleção: ao abrir, o sistema autentica automaticamente com o sistema integrado e busca a lista de veículos cadastrados nele. Cada veículo retornado aparece com Placa, Marca, Tipo, Carroceria, Capacidade e uma “Situação” que indica se o registro está “Pronto para sincronizar” (ainda não existe no Painel), “Pronto para atualizar” (já existe, mas os dados mudaram no sistema integrado), “Veículo já sincronizado e pronto para vincular” (existe no Painel mas está desvinculado da empresa) ou “Já sincronizado” (já existe e está atualizado). Um campo de busca filtra a lista por Placa, Marca, Tipo, Carroceria ou Capacidade; um campo “Exibir veículos” filtra por “Todas os registros”, “Pronto para sincronizar” ou “Com erro”. Um checkbox por linha (e um “selecionar todos” no cabeçalho) marca quais registros serão trazidos; registros com erro não podem ser selecionados. O botão BUSCAR repete a consulta ao sistema integrado; o botão SALVAR avança para a tela de processamento.
- Sincronizado: mostra o progresso da gravação de cada veículo selecionado, um de cada vez, com um indicador de andamento em processamento (ícone girando) e o resultado individual (ícone de sucesso ou de erro, com a mensagem devolvida) ao concluir cada um. Um percentual geral de conclusão é exibido durante o processo. Ao final, os botões FECHAR e VOLTAR ficam disponíveis; VOLTAR retorna à tela de seleção com todos os registros pré-selecionados novamente.
Feedbacks ao Usuário
Lista de Veículos
| Situação | Feedback | Texto exato |
|---|---|---|
| Falha de comunicação ao carregar a lista | Notificação de erro | “Não foi possível obter a lista de veículos.” |
| Sessão expirada ao carregar a lista | Notificação de erro; a sessão é encerrada automaticamente 2 segundos depois | “Desculpe, sua sessão expirou.” |
| Erro de negócio ao carregar a lista | Notificação de erro | mensagem devolvida pelo sistema |
| Nenhum dado retornado ao carregar a lista | Notificação de erro | “Não foi possível obter a lista.” |
| Falha de comunicação ao carregar a lista de motoristas vinculados | Notificação de erro | “Não foi possível obter todas as informações.” |
| Falha de comunicação ao carregar as configurações da empresa | Notificação de erro | “Não foi possível obter todas as informações de configuração.” |
Remoção de Veículo
| Situação | Feedback | Texto exato |
|---|---|---|
| Antes de remover um veículo | Caixa de diálogo de confirmação (título “REMOVER”) | “Deseja mesmo remover o veículo?” |
| Falha de comunicação ao remover | Notificação de erro | “Não foi possível remover o veículo.” |
| Sessão expirada ao remover | Notificação de erro; a sessão é encerrada automaticamente 2 segundos depois | “Desculpe, sua sessão expirou.” |
| Recusa da remoção (registro não encontrado) | Notificação de erro | mensagem devolvida pelo sistema |
| Veículo removido com sucesso | Notificação de sucesso | “Veículo removido com sucesso.” |
| Nenhum resultado retornado ao remover | Notificação de erro | “Não foi possível fazer a remoção.” |
Cadastro e Edição — Resultado
| Situação | Feedback | Texto exato |
|---|---|---|
| Veículo editado com sucesso | Notificação de sucesso | “Veículo alterado com sucesso.” |
| Veículo criado com sucesso | Notificação de sucesso | “Veículo adicionado com sucesso.” |
| Recusa do salvamento (validação) | Uma notificação de erro por mensagem | mensagem(ns) devolvida(s) pelo sistema |
Cadastro e Edição — Validação de Campos
| Situação | Feedback | Texto exato |
|---|---|---|
| Placa não preenchida (novo veículo) | Notificação de erro | “‘PLACA’ deve ser preenchido.” ou “‘PLACA’ não pode ser vazio.” |
| Placa em formato inválido | Notificação de erro | “‘PLACA’ inválido.” |
| Marca não preenchida | Notificação de erro | “‘MARCA’ deve ser preenchido.” ou “‘MARCA’ não pode ser vazio.” |
| Tipo não preenchido | Notificação de erro | “‘TIPO’ deve ser preenchido.” ou “‘TIPO’ não pode ser vazio.” |
| Carroceria não preenchida | Notificação de erro | “‘CARROCERIA’ deve ser preenchido.” ou “‘CARROCERIA’ não pode ser vazio.” |
| Peso não preenchido, inválido ou zerado | Notificação de erro | “‘PESO’ deve ser preenchido.”, “‘PESO’ não pode ser vazio.”, “‘PESO’ inválido.” ou “‘PESO’ não pode ser menor ou igual a 0.” |
| Volume inválido ou zerado (quando informado) | Notificação de erro | “‘VOLUME’ inválido.” ou “‘VOLUME’ não pode ser menor ou igual a 0.” |
| Velocidade Média inválida ou zerada (quando informada) | Notificação de erro | “‘VELOCIDADE MÉDIA’ inválido.” ou “‘VELOCIDADE MÉDIA’ não pode ser menor ou igual a 0.” |
| Eixos zerado ou negativo (quando informado) | Notificação de erro | “‘EIXOS’ não pode ser menor ou igual a 0.” |
| Ocupação Mínima fora da faixa de 0 a 100 | Notificação de erro | “‘OCUPAÇÃO MÍNIMA’ não pode ser menor que 0, ou superior a 100.” |
| Centro Expandido com valor inválido | Notificação de erro | “‘CENTRO EXPANDIDO’ inválido.” |
| Retorno a Origem com valor inválido | Notificação de erro | “‘RETORNO A ORIGEM’ inválido.” |
Cadastro e Edição — Validação do Motorista Fixo
| Situação | Feedback | Texto exato |
|---|---|---|
| Motorista selecionado não encontrado no sistema | Notificação de erro | “‘MOTORISTA’ não encontrado.” |
| Motorista selecionado não vinculado à empresa | Notificação de erro | “‘MOTORISTA’ deve estar vinculado a empresa.” |
| Motorista selecionado já é fixo em outro veículo da empresa | Notificação de erro | “‘MOTORISTA’ já fixo a outro veículo.” |
| Veículo não localizado ao editar | Notificação de erro | “Não foi possível encontrar o Veículo.” ou “Não foi possível identificar o Veículo.” ou “Não foi possível identificar o registro.” |
| Nenhuma informação enviada ao salvar | Notificação de erro | “Informações não enviadas.” |
Sincronização com o Sistema Atak
| Situação | Feedback | Texto exato |
|---|---|---|
| Integração com o Atak não configurada ao abrir o modal | Notificação de erro; o modal se fecha | “Configuração de integração não selecionada em: Configurações -> Roteirização.” |
| Endereço do sistema integrado não configurado ao abrir o modal | Notificação de erro; o modal se fecha | “Endereço da API de integração não informado em: Configurações -> Roteirização.” |
| Falha de comunicação ao autenticar com o sistema integrado | Notificação de erro | “Não foi possível conectar com o sistema integrado.” |
| Sessão expirada durante a autenticação | Notificação de erro; a sessão é encerrada automaticamente 2 segundos depois | “Desculpe, sua sessão expirou.” |
| Sistema integrado recusa a autenticação | Notificação de erro | mensagem descrevendo a falha de autorização junto ao sistema integrado |
| Falha de comunicação ao buscar veículos no sistema integrado | Notificação de erro | “Não foi possível sincronizar os veículos.” |
| Nenhum veículo encontrado no sistema integrado | Notificação de erro; retorna à tela de seleção | “Não foram encontrados registros de veículos.” |
| Nenhum registro selecionado ao confirmar a sincronização | Notificação de erro | “Selecione ao menos um registro.” |
| Falha ao sincronizar um veículo específico | Mensagem individual na lista de processamento | “Não foi possível sincronizar.” |
| Veículo sincronizado com sucesso | Mensagem individual na lista de processamento | “Sincronizado com sucesso.” |
Regras de Negócio
Cadastro Compartilhado de Veículos entre Empresas
O cadastro de um veículo (placa, marca, tipo, carroceria, modelo, capacidade de peso e eixos) é único no sistema, identificado pela placa, e pode ser compartilhado por mais de uma empresa. Se você cadastrar uma placa que já existe no sistema — por exemplo, um veículo também utilizado por outra transportadora — o sistema não recusa o cadastro nem cria uma placa duplicada: ele vincula o veículo já existente à sua empresa, e os dados gerais informados no seu cadastro (marca, tipo, carroceria, modelo e capacidade de peso) passam a valer também para as demais empresas que compartilham aquele mesmo veículo. Os demais dados (capacidade de volume, combustível, velocidade média, ocupação mínima, centro expandido, retorno à origem e motorista fixo) são sempre próprios de cada empresa.
Formatação de Exibição das Capacidades
A Capacidade de Peso é sempre exibida na lista seguida da unidade “kg”. A Capacidade de Volume, quando informada, é exibida seguida da unidade “m³”; quando não informada, exibe “Não Definido”. A mesma regra de “Não Definido” vale para Modelo e Combustível quando não preenchidos.
Centro Expandido e Rodízio Municipal (São Paulo)
Um veículo marcado com “Centro Expandido (SP)” tem permissão para circular na área de centro expandido de São Paulo. Para esses veículos, a tela calcula e exibe (sem gravar) o dia da semana em que o rodízio municipal de caminhões se aplica, a partir do último dígito da placa:
- placa terminada em 1 ou 2 → SEGUNDA-FEIRA
- placa terminada em 3 ou 4 → TERÇA-FEIRA
- placa terminada em 5 ou 6 → QUARTA-FEIRA
- placa terminada em 7 ou 8 → QUINTA-FEIRA
- placa terminada em 9 ou 0 → SEXTA-FEIRA
Para veículos sem “Centro Expandido (SP)” marcado, a coluna de rodízio sempre exibe “NÃO”, independentemente da placa.
Ordenação e Paginação da Lista
A lista de veículos é ordenada, por padrão, por Placa em ordem crescente. O usuário só pode reordenar por Placa, Marca, Tipo, Carroceria, Modelo, Capacidade de Peso, Combustível ou Centro Expandido. A lista é paginada em blocos de 20 registros.
Imutabilidade da Placa após o Cadastro
A placa de um veículo só é aceita e validada no momento do cadastro (criação); na edição de um veículo já existente, o campo Placa aparece desabilitado — não há caminho, por esta tela, para alterar a placa de um veículo já cadastrado.
Motorista Fixo — Exclusividade por Veículo
Um motorista só pode estar vinculado como motorista fixo a um único veículo por vez, dentro da mesma empresa. Ao tentar fixar um motorista já fixo em outro veículo da empresa, o cadastro/edição é recusado; a própria edição de um veículo mantendo o mesmo motorista já fixo nele é permitida normalmente.
Vínculo entre Veículo e Motorista é Desfeito na Remoção
Ao remover um veículo, o vínculo com o motorista fixo associado a ele é desfeito automaticamente.
Acesso Também Liberado por Entregas, Roteirização, Motoristas ou Relatório
Mesmo sem a permissão de área “Veículos” diretamente concedida, um usuário com permissão ativa nas áreas Entregas, Roteirização, Motoristas ou Relatório também consegue acessar as informações desta tela.
Remoção de um Veículo é Imediata e Não Verifica Entregas Vinculadas
A remoção de um veículo é concluída imediatamente após a confirmação. O sistema não verifica nem impede a remoção de um veículo que ainda tenha entregas em andamento vinculadas a ele — confirme, antes de remover, que o veículo não está mais em uso por nenhuma entrega em curso.
Troubleshooting
Lista de veículos não carrega por falha de comunicação
Cenário: o usuário abre a tela Veículos e a lista não aparece.
Mensagem exibida: “Não foi possível obter a lista de veículos.”
O que fazer: verificar a conexão com a internet e recarregar a página; se persistir, contatar o suporte informando o horário da falha.
Sessão expira ao carregar a lista de veículos
Cenário: o usuário estava com a tela aberta havia tempo e a sessão expirou ao tentar recarregar a lista.
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.
Servidor não retorna nenhum dado ao carregar a lista
Cenário: a requisição de carregamento da lista é concluída, mas sem nenhum conteúdo utilizável na resposta.
Mensagem exibida: “Não foi possível obter a lista.”
O que fazer: recarregar a página; se persistir, contatar o suporte informando o horário da falha.
Veículo não é removido por falha de comunicação
Cenário: o usuário confirma a remoção de um veículo e a requisição não é concluída.
Mensagem exibida: “Não foi possível remover o veículo.”
O que fazer: tentar novamente; se persistir, contatar o suporte informando o horário da falha.
Sessão expira ao tentar remover um veículo
Cenário: a sessão expira entre a confirmação da exclusão e a resposta do servidor.
Mensagem exibida: “Desculpe, sua sessão expirou.”
O que fazer: aguardar o redirecionamento automático (2 segundos) e fazer login novamente; repetir a remoção depois de logado.
Remoção de um veículo é recusada pelo servidor
Cenário: o identificador do veículo que está sendo removido não corresponde a um registro vinculado à empresa (por exemplo, se o vínculo já tiver sido removido em outra sessão simultânea).
Mensagem exibida: mensagem devolvida pelo servidor (ex.: “Não foi possível identificar a relação entre o registro e a empresa logada.”)
O que fazer: recarregar a lista antes de tentar novamente.
Salvar ou editar um veículo com falha de comunicação não exibe nenhuma mensagem
Cenário: o usuário clica em SALVAR (cadastro ou edição) e a requisição não é concluída (queda de conexão, tempo esgotado).
Mensagem exibida: Nenhuma — nenhuma notificação aparece, o indicador de carregamento do modal permanece ativo indefinidamente, e o modal não fecha nem retorna ao estado anterior.
O que fazer: recarregar a página inteira e refazer o cadastro ou a edição; verificar antes se o registro não foi de fato salvo, consultando a lista.
Sessão expira ao salvar ou editar um veículo
Cenário: a sessão expira entre o clique em SALVAR e a resposta do servidor.
Mensagem exibida: Nenhuma mensagem compreensível — uma sequência de notificações de um único caractere cada aparece na tela, e a sessão não é encerrada automaticamente como acontece ao carregar a lista ou remover um veículo.
O que fazer: fechar o formulário, recarregar a página manualmente e fazer login novamente antes de repetir o cadastro ou a edição.
Servidor recusa o salvamento por validação de campos
Cenário: um ou mais campos obrigatórios ou com valor inválido foram enviados ao salvar (novo veículo ou edição).
Mensagem exibida: uma ou mais mensagens específicas por campo (ver Feedbacks ao Usuário — Validação de Campos), por exemplo “‘PESO’ não pode ser menor ou igual a 0.”
O que fazer: corrigir o(s) campo(s) apontado(s) e salvar novamente.
Motorista Fixo recusado por já estar vinculado a outro veículo
Cenário: o usuário tenta selecionar, como Motorista Fixo, um motorista que já está fixo em outro veículo da mesma empresa.
Mensagem exibida: “‘MOTORISTA’ já fixo a outro veículo.”
O que fazer: remover o motorista fixo do outro veículo antes de vinculá-lo a este, ou selecionar outro motorista.
Acesso à tela de Veículos é bloqueado silenciosamente
Cenário: o usuário tenta acessar a tela Veículos diretamente pela URL sem ter nenhuma das permissões de área correspondentes ativa, ou a empresa não tem a roteirização contratada.
Mensagem exibida: Nenhuma — o sistema redireciona silenciosamente para a tela Início.
O que fazer: solicitar a um administrador da conta a permissão de área “Veículos” (ou uma permissão de área próxima já suficiente — Entregas, Roteirização, Motoristas ou Relatório), ou confirmar com o suporte se a empresa tem a roteirização contratada.
Botão SINCRONIZAR não aparece ou modal fecha ao abrir por integração não configurada
Cenário: o usuário abre o modal de sincronização com o Atak (empresa integrada), mas a configuração de integração ou o endereço do sistema integrado não foram definidos na tela de Configurações.
Mensagem exibida: “Configuração de integração não selecionada em: Configurações -> Roteirização.” ou “Endereço da API de integração não informado em: Configurações -> Roteirização.”
O que fazer: completar a configuração da integração na tela de Configurações, aba Roteirização, antes de tentar sincronizar novamente.
Falha ao autenticar com o sistema Atak durante a sincronização
Cenário: o modal de sincronização tenta obter autorização do sistema integrado e a requisição falha ou é recusada.
Mensagem exibida: “Não foi possível conectar com o sistema integrado.” (falha de comunicação) ou uma mensagem descrevendo a recusa de autorização do sistema integrado.
O que fazer: verificar as credenciais e a disponibilidade do sistema integrado; tentar novamente com o botão BUSCAR.
Sessão expira durante a sincronização com o sistema Atak
Cenário: a sessão do Painel expira em algum ponto da autenticação com o sistema integrado.
Mensagem exibida: “Desculpe, sua sessão expirou.”
O que fazer: aguardar o redirecionamento automático (2 segundos) e fazer login novamente antes de repetir a sincronização.
Nenhum veículo encontrado no sistema Atak ao sincronizar
Cenário: a busca de veículos no sistema integrado é concluída, mas não retorna nenhum registro.
Mensagem exibida: “Não foram encontrados registros de veículos.”
O que fazer: confirmar, no sistema Atak, que existem veículos cadastrados lá antes de tentar novamente.
Sincronização individual de um veículo falha
Cenário: durante o processamento em lote da sincronização, um veículo específico não é gravado com sucesso.
Mensagem exibida: “Não foi possível sincronizar.”
O que fazer: anotar a placa do veículo com falha e repetir a sincronização somente para ele (usando o filtro “Com erro”); se persistir, contatar o suporte.
Casos de Uso
Caso 1 — Cadastro de um novo veículo
Um usuário com permissão de edição em Veículos clica em ADICIONAR, informa a Placa “ABC1D23”, seleciona Marca “VOLVO”, Tipo “CARRETA” e Carroceria “SIDER”, preenche a Capacidade de Peso “15000 kg” e marca “Centro Expandido (SP)”. Ao clicar em SALVAR, recebe “Veículo adicionado com sucesso.” e a lista passa a mostrar o novo veículo com “Rodízio (SP)” calculado a partir do último dígito da placa.
Caso 2 — Edição de um veículo com troca de motorista fixo
Um usuário abre a lista, localiza um veículo pelo filtro de busca e clica no ícone de edição. O campo Placa aparece desabilitado. O usuário seleciona, em Motorista Fixo, um motorista vinculado à empresa que ainda não está fixo em nenhum outro veículo, e salva, recebendo “Veículo alterado com sucesso.”.
Caso 3 — Remoção de um veículo
Um usuário clica no ícone de remoção de um veículo que não é mais utilizado pela empresa, confirma a exclusão (“Deseja mesmo remover o veículo?”) e recebe a confirmação “Veículo removido com sucesso.”. O motorista que estava fixo nesse veículo é automaticamente desvinculado. O sistema não verifica, no momento da remoção, se existem entregas em andamento vinculadas a esse veículo — vale confirmar antes que ele não está mais em uso.
Caso 4 — Sincronização de veículos com o sistema Atak
Um usuário de uma empresa integrada ao ERP Atak clica em SINCRONIZAR. O modal autentica automaticamente e busca os veículos cadastrados no sistema Atak, exibindo a situação de cada um (“Pronto para sincronizar”, “Pronto para atualizar”, “Já sincronizado” etc.). O usuário filtra por “Pronto para sincronizar”, confere a seleção automática desses registros e clica em SALVAR; a tela de processamento mostra o andamento veículo a veículo até concluir, e o usuário fecha o modal ao final.
