# Integrações de Plataformas de Rastreamento - Cobli

## Introdução

>[!TIP] **Definição - Cobli:**
>A [Cobli](https://www.cobli.co/) é uma plataforma que oferece soluções avançadas de rastreamento e gestão de frota. Ela permite o monitoramento em tempo real dos veículos, promovendo a otimização do uso dos recursos e garantindo maior eficiência no controle e na administração dos automóveis. A Cobli também se destaca por facilitar a tomada de decisões estratégicas, proporcionando dados baseados em dados para uma gestão de frota mais eficaz.

O cadastro de **integrações de plataforma de rastreamento** permite configurar a conexão entre o sistema e serviços externos de rastreamento de veículos. Esta funcionalidade é essencial para empresas que necessitam monitorar sua frota de veículos. A integração possibilita o gerenciamento eficiente da frota, permitindo o monitoramento preciso da localização dos veículos diretamente pelo sistema.

>[!NOTA] **Acesso ao Formulário** 
>**Caminho:** Configurações > Integrações > Integrações de Plataforma de Rastreamento

## Entrega de Valor
- Integração segura com sistemas de rastreamento;
- Monitoramento eficiente de veículos rastreados;
- Otimização de processos logísticos e operacionais;
- Centraliza o gerenciamento de acessos à API de rastreadores;
- Melhora o acompanhamento de veículos rastreados.

## Estrutura do Formulário
O formulário está estruturado em uma grid, que reúne as informações de todas as integrações cadastradas. Esta grid está organizada em linhas e colunas e cada registro individual corresponde ao mesmo formulário que armazena os detalhes das integrações de rastreamento.

Em um registro individual, formulário está estruturado em uma aba principal: **Acessos API rastreadores**. A aba está relacionada ao cadastro da integração, que por sua vez, tem como objetivo viabilizar o monitoramento de veículos no sistema.

### Aba Acessos API rastreadores
A aba **Acessos API Rastreadores** é destinada à configuração da comunicação entre o sistema e a plataforma **Cobli**. Nessa aba, é possível registrar as informações necessárias para integrar o sistema à plataforma, garantindo o monitoramento eficiente dos veículos. Os campos disponíveis para o cadastro são:

| Campo             | Descrição                                                                 | Obrigatório |
| ----------------- | ------------------------------------------------------------------------- | ----------- |
| ID                | Identificador do cadastro                                                 | Sim         |
| API Key           | Chave única para autenticação, criada e armazenada na plataforma da Cobli | Não         |
| Tipo busca        | Selecione o tipo **Rastreador**                                           | Não         |
| Fornecedor da API | Selecione a opção o fornecedor da API de rastreamento que está utilizando | Sim         |
| Status            | Preenchido automaticamente de acordo com o status da integração           | Sim         |

## Como Realizar a Configuração

### Passo 1: Configuração Cobli
Para iniciar o processo, a configuração deve ser realizada inicialmente na plataforma **Cobli**, onde serão extraídos os dados necessários para a posterior configuração no sistema. Para realizar este procedimento, siga os passos a seguir:

1. Acesse o sistema da **Cobli** e siga até a opção **Integrações**, no menu lateral esquerdo;
2. Selecione a opção **APIs** no menu suspenso;
3. Clique sobre o botão **Criar chave de API** na lateral direita;
4. Defina um nome para a chave e clique em **Gerar chave**;
5. Clique em **Concluir** para finalizar o cadastro da chave. Salve esta informação para a inserção no sistema IXC Soft no passo 2.

>[!CAUTION] Atenção:
>Para cada organização adicional em sua plataforma Cobli que necessite de rastreamento, será preciso criar uma integração específica.

### Passo 2: Cadastro dos Dados API no Sistema 
Com a Chave API gerada, configure-a no sistema para estabelecer a comunicação entre as plataformas envolvidas. Para realizar este procedimento, siga os passos a seguir:

1. No sistema IXC, acesse o formulário **Acessos API rastreadores** através do caminho: Configurações > Integrações > Integrações plataforma de rastreamento;
2. Clique em **Novo** para registrar os dados;
3. Preencha os campos conforme apresentados:
	- **API Key:** insira a chave API gerada na plataforma Cobli;
	- **Tipo de busca:** selecione a opção Rastreador;
	- **Fornecedor da API:** selecione a opção Cobli;
	  
4. Após preencher os campos, clique em **Salvar** para validar as modificações e finalizar o cadastro da integração.

### Passo 3: Cadastro de [[veiculos|Veículos]]
Com a integração cadastrada, configuram-se os veículos para realizar o monitoramento de frota efetivamente. Siga os passos abaixo:

>[!nota] **Cobli**:
>Localize, **na Cobli**, a numeração dos veículos para incluí-los no IXC. Para isso, acesse a opção Minha Frota > Veículos > na coluna **N° Cobli**, identifique o **ID** do veículo que irá incluir no sistema e copie-o para prosseguir com as configurações.

1. Acesse o formulário Veículos através do caminho: Sistema > Frota > Veículos;
2. Clique em **Novo** para [[cadastro de veiculos|cadastrar um novo veículo]] ou clique em **Editar** para realizar o ajuste;
3. No cadastro do veículo, no campo IMEI do rastreador, insira o código do veículo que consta cadastrado na Cobli (N° Cobli);
4. Clique em **Salvar** para validar as modificações.

### Passo 4: Configuração da [[tarefa - atualizar dados rastreador (cobli)|Tarefa - Atualizar Dados Rastreador (Cobli)]]
Para manter os dados de rastreamento atualizados, é necessário cadastrar uma tarefa de execução automática programada para ocorrer a cada 2 minutos. Siga os passos abaixo:

1. Acesse o formulário de **Agenda de Tarefas** através do caminho: Ferramentas > Ferramentas > Agenda de tarefas;
2. Clique no botão **Novo;**
3. Na seção Tarefa, no campo **Tarefa**, selecione a tarefa Atualizar dados rastreador(Cobli);
4. Na seção Minuto, no campo **Tipo**, marque a opção **Valor**. No campo **Valor**, insira a seguinte estrutura: `*/2`;
5. Nos demais campos, nas seções Hora, Dia do mês, Mês e Dia da semana, marque a opção **Todos**. Configurando desta forma, o sistema sempre atualizará os dados de rastreamento a cada 2 minutos;
6. Clique em **Salvar** para validar a criação da tarefa. A partir desta configuração, o sistema já irá iniciar a atualização dos dados, permitindo o gerenciamento do monitoramento dos veículos.

## Funcionalidades Principais
- Permite realizar a configuração de integrações de rastreamento com a plataforma Cobli;
- Permite alterar o status da integração já cadastrada (Ativo/Inativo);
- Permite relacionar o uso da integração com o formulário [[veiculos|Veículos]], ao realizar o [[cadastro de veiculos|Cadastro de Veículos]] a partir da comunicação com a integração, apresentando a trajetória percorrida em tempo aproximado do real;
- Permite visualizar o trajeto do veículo em tempo aproximado ao real.


## Fluxo de Trabalho
```mermaid
graph TD
    A[Início] --> B[Criar chave API]
    B --> C[Gerar chave API]
    C --> D[Cadastrar chave no sistema]
    D --> E[Ativar integração]
    E --> F[Cadastrar veículo]
    F --> G[Incluir N° Cobli no cadastro do veículo]
    G --> H[Cadastrar tarefa]
    H --> I[Monitoramento]

```

## Considerações Finais
A integração entre o sistema IXC e a plataforma Cobli representa uma solução completa para o gerenciamento e rastreamento de frotas. Esta integração, quando adequadamente configurada, permite o monitoramento com mínima latência dos veículos, gestão eficiente de rotas e controle preciso das operações da frota. A comunicação estabelecida entre as plataformas oferece dados atualizados e confiáveis para tomada de decisões, contribuindo para a otimização dos recursos e segurança das operações. É fundamental que os usuários responsáveis pela gestão do rastreamento recebam treinamento adequado para aproveitar todas as funcionalidades disponíveis, garantindo assim a máxima eficiência desta integração.

## Etiquetas
#Integracoes #IntegracoesDeRastreamento #Frota  #Rastreamento #Cobli

## Leia também
- [[integracoes|Integrações]]
- [[integracoes plataforma de rastreamento|Integrações Plataforma de Rastreamento]]
- [[veiculos|Veículos]]
- [[cadastro de veiculos|Cadastro de Veículos]]
- [[veiculos - rastreamento|Veículos - Rastreamento]]
- [[guia pratico de suporte|Guia Prático de Suporte]]
- [[integracao com aplicativo de rastreamento - traccar client (modelo teste)|Integração com Aplicativo de Rastreamento - Traccar Client]]
- [[integracao com rastreadores - tk103a e tk103b (modelo teste)|Integrações com Rastreadores - TK103A e TK103B]]