Pular para o conteúdo
Veltra Ajuda
Manual da APIPlaybookEntrar

Trilha · Módulo 2

Filiais e motoristas

Filiais e motoristas

Neste módulo você cadastra as filiais da sua transportadora, cadastra os motoristas e liga o celular de cada motorista ao Veltra com um código de ativação. Ao final, o motorista consegue abrir o app e receber cargas.

Antes de começar#

  • Você precisa estar logado no portal. Cadastrar uma filial nova é permitido ao administrador. Cadastrar motorista, gerar o código de ativação e desativar aparelho são permitidos ao administrador e ao operador da torre; quem só tem perfil de leitura apenas consulta.
  • Se o seu usuário tem escopo de filial, você só enxerga e só cadastra motoristas das filiais que são suas. É de propósito: o cadastro de um motorista de outra filial responde "sem permissão" ou simplesmente não aparece.
Usuários da transportadora e seus perfis de acesso.
Usuários da transportadora e seus perfis de acesso.
Veículos cadastrados com placa, modelo e capacidade.
Veículos cadastrados com placa, modelo e capacidade.

Cadastrar uma filial#

A filial é o ponto físico da transportadora (base, terminal). O manifesto que chega do seu sistema cita a filial pela sigla externa, por isso ela precisa ser igual à usada no seu sistema.

Abra a lista de filiais

No menu do portal, entre em Filiais e use o botão Nova filial.

Filiais cadastradas, com sigla, endereço e situação.
Filiais cadastradas, com sigla, endereço e situação.

Preencha nome e sigla externa

O Nome e a Sigla externa são obrigatórios. A sigla identifica a filial nos manifestos e não pode se repetir dentro da sua transportadora.

Informe o endereço e localize no mapa

Digite o Endereço e use o botão para localizar. O portal sugere um ponto no mapa; é só uma sugestão. Se o endereço não for encontrado, marque o local no mapa manualmente ou digite um endereço mais completo.

Formulário para cadastrar uma filial com endereço e raio de chegada.
Formulário para cadastrar uma filial com endereço e raio de chegada.

Ajuste o raio da geofence

O Raio da geofence é a distância, em metros, ao redor da filial usada para saber se o motorista chegou ao local. Se você não alterar, o padrão é 200 metros. O valor aceito vai de 10 a 50.000 metros.

Salve

Use Cadastrar filial. Para mudar depois, abra a filial e use Salvar alterações. A lista de filiais mostra se cada uma está Ativa ou Inativa.

Dados de uma filial já cadastrada.
Dados de uma filial já cadastrada.

Cadastrar um motorista#

Abra a lista de motoristas

Entre em Motoristas no menu do portal e use o botão Novo motorista para abrir o formulário.

Motoristas cadastrados, com a filial e a situação do aparelho.
Motoristas cadastrados, com a filial e a situação do aparelho.

Preencha os dados

Informe Nome, CPF, Telefone e a Filial (a lista começa em "Sem filial"). Nome e CPF são obrigatórios. O CPF é a chave do cadastro: se você cadastrar de novo um CPF que já existe na sua transportadora, o motorista é atualizado em vez de duplicado.

Diálogo para cadastrar um motorista.
Diálogo para cadastrar um motorista.

Salve

Use Cadastrar motorista. O motorista nasce como "pendente de ativação", porque ainda não tem celular ligado ao Veltra.

Para tirar um motorista de circulação, abra o cadastro dele e marque Motorista desativado (não recebe cargas); para voltar, desmarque. Ao reativar, ele volta a "pendente de ativação". O status "ativo" não é escolhido no portal: ele só acontece quando o motorista ativa o app com o código.

Gerar o código de ativação e ativar o celular#

O código liga um celular a um motorista. Cada motorista tem um aparelho ativo por vez.

Gere o código

Na linha do motorista, use Gerar código de ativação. Antes de gerar, o portal confere o aparelho atual do motorista. Se ele já tiver um aparelho ativo, o portal mostra um aviso e pergunta se você quer Gerar mesmo assim.

Passe o código ao motorista

O código aparece uma única vez na tela, com a hora em que vence. Ele serve uma única vez e vale por pouco tempo. Exemplo fictício de como ele é mostrado: ABC123 (não use, é só um exemplo).

Código de uso único gerado para o motorista; o valor é ocultado neste exemplo.
Código de uso único gerado para o motorista; o valor é ocultado neste exemplo.

O motorista ativa no celular

No app, o motorista abre Ativar aparelho, digita o código e toca em Ativar. A explicação passo a passo do lado do motorista está no módulo 3.

Pontos importantes:

  • Ativar um celular novo desativa o celular anterior do mesmo motorista. Por isso trocar de aparelho exige um código novo.
  • Código errado, vencido ou já usado devolve sempre a mesma mensagem genérica, sem dizer qual foi o motivo. Se o motorista errar, gere outro código.
  • Há um limite de tentativas seguidas; passou do limite, é preciso esperar um pouco antes de tentar de novo.

Ver e desativar o aparelho de um motorista#

Na ficha do motorista, o bloco Aparelho mostra quando o celular foi ativado, a última sincronização, se as notificações estão ativas e quantos itens o aparelho ainda tem para enviar. Se não houver aparelho, aparece "Nenhum aparelho ativo".

Se o celular foi perdido ou roubado, use Desativar aparelho e depois Confirmar desativação. O motorista precisará de um código novo para voltar a usar o app. O que já estava guardado no celular desativado fica lá, esperando.

Avisos ao gerar o código#

Em alguns casos o portal não gera o código e explica por quê. Estes são os avisos, pelo nome que o sistema usa:

AvisoO que significaO que fazer
CONFIRMAR_CELULAR_EXCEDENTEO novo celular passa do número de aparelhos do seu contrato. O aviso mostra quantos aparelhos o contrato prevê, quantos estão ativos e uma estimativa do novo valor mensal.Se concordar, confirme e gere de novo. O valor por aparelho é o mostrado na página de preços.
LIMITE_DE_APARELHOS_DO_TESTEDurante o período de teste existe um limite de aparelhos e ele foi atingido.Desative um aparelho que não usa mais ou contrate o plano.
TESTE_ENCERRADOO período de teste acabou.Contrate pelo portal para voltar a ativar celulares.
ATIVACAO_BLOQUEADA_PELO_VELTRAO Veltra bloqueou a ativação de celular novo na sua conta.Fale com o suporte do Veltra.

Nenhum desses avisos tira o seu portal do ar nem apaga dados. Para entender o teste grátis e a cobrança mensal por aparelho, veja os módulos de cadastro e de plano e pagamento.

Pronto para o próximo passo#

Com filial, motorista e celular ativado, o motorista já pode receber cargas.

Próximo módulo: App do motorista.