Integração com o SGA da Hinova

Agora a plataforma Getrak tambem está integrada com o SGA da Hinova, possibilitando assim a troca de informações com ainda mais agilidade e automação entre os sistemas.
 

1. Como funciona?

A integração entre o SGA e a plataforma Getrak é totalmente unidirecional: todos os dados fluem do SGA para a Getrak, sem qualquer retorno ou sincronização inversa. O processo é disparado automaticamente a cada seis horas, garantindo que as informações na Getrak estejam sempre atualizadas em um ciclo contínuo.

Somente veículos que estejam vinculados ao produto específico (SGA) — cujo ID é informado na criação da integração — são considerados. Para cada veículo, a placa serve como chave única de busca na base Getrak. Se a placa não for encontrada, um novo registro de veículo é criado; se houver duplicidade de placa na Getrak, o processo ignora aquele veículo, sem realizar atualização alguma, evitando inconsistências.
 

⚠️ Caso tenham integração com a Hinova SGR habilitada, não é possível ter as duas funcionando em paralelo, pois pode haver duplicidade na integração.

2. Quais campos do veículo são sincronizados?

São sincronizados os seguintes campos:

• Status (ativo, inativo, inadimplente)
• Descrição
• Chassi
• Renavam
• Marca, modelo, cor e ano
• Nome e telefone do contato

Observação: Quando um veículo está marcado como inativo ou inadimplente no SGA, o status correspondente na Getrak é atualizado automaticamente. Já veículos removidos do SGA não sofrem qualquer alteração na plataforma Getrak, preservando históricos e evitando exclusões indesejadas.

3. Quais são os pré-requisitos para cadastrar a integração SGA?

Os passos abaixo são realizados diretamente na plataforma da Hinova SGA, caso tenha alguma dúvida, favor entrar em contato com o suporte da Hiinova

Usuário e senha:

Para a integração será necessário possuir um usuário com as permissões de visualização dos veículos, associados e produtos. É recomendável que seja um usuário exclusivo para essa integração, para que seja possível desativar facilmente sem que afete sua operação no SGA.
É importante garantir que o acesso desse usuário esteja sem restrições de horários ou dias da semana.

Chave de API:

Na plataforma SGA, vá para: Área do cliente → APIs → Gerenciar APIs e então clique em “Novo”.
Selecione um apelido para token para auxiliar na identificação futura desse token, caso seja necessário desativar ou alterar.
Habilite a opção “Permitir acesso”

Marque todas as opções relacionadas à veículos, produtos e associados.

Ao final do processo, a chave de API estará disponível para ser copiada. Guarde essa chave.

4. Na plataforma Getrak, onde eu cadastro uma Integração?

Para cadastrar uma nova integração, acesse o menu à esquerda e vá em Painel Administrativo → Central → Integrações. Na tela de integrações, é possível:

• Adicionar uma nova integração
• Gerenciar integrações já existentes
• Desativar temporariamente uma integração
   

Para cadastrar a integração com o SGA, clique em Nova integração e preencha os campos solicitados que são:

• Usuário do SGA: Login de usuário da plataforma SGA
• Senha do SGA: Senha referente ao usuário
• Chave de API: Token criado na etapa anterior
• Código do produto: Código do produto vinculado ao veículo no SGA que representa o mesmo tenha rastreador Getrak. Essa opção pode ser coletada na tela de produtos do SGA. Caso não tenha um produto SGA que represente a Getrak, é necessário criar esse produto. Somente veículos com esse produto serão sincronizados na plataforma Getrak.

Ao clicar em conectar, será validado o usuário, senha e token e a integração estará ativa (caso não haja nenhum problema com as credenciais).
 

5. Ocorreu erro, o que pode ser?

Existem dois erros comuns que são:

Erro de credenciais: esse erro está diretamente relacionado ao usuário, senha ou token inválidos ou restritos. Revise as credenciais para solucionar o problema.

Falha ao conectar a integração: erro generalizado, podendo ser instabilidade no sistema. Caso esse erro persista, contacte o suporte da Getrak.