# Integração com Rastreadores TK103A e TK103B

## Introdução

> [!TIP] **Definição - Dispositivos TK103A e TK103B:**  
Os dispositivos TK103A e TK103B são rastreadores GPS/GSM amplamente utilizados para o monitoramento veicular, pertencentes à série TK103. Esses equipamentos físicos são instalados diretamente no veículo e operam com o uso de um chip SIM, fornecido por uma operadora de telefonia. A configuração e o gerenciamento desses dispositivos são realizados por meio de comandos SMS, garantindo uma solução eficiente para rastreamento e controle da frota.

O cadastro de rastreadores é uma funcionalidade essencial do Sistema que permite registrar e gerenciar informações detalhadas sobre a frota da empresa, incluindo o monitoramento da geolocalização dos dispositivos. Este módulo, disponível através do formulário de **Veículos**, é fundamental para o controle eficiente da frota, manutenção preventiva e otimização de recursos. Este documento apresenta o processo de configuração e integração dos rastreadores veiculares **TK103A** e **TK103B** com o sistema. Estes dispositivos GPS/GSM são utilizados para monitoramento preciso dos veículos, possibilitando um gerenciamento de frota eficaz através do rastreamento em tempo real, alertas de segurança e histórico detalhado de rotas.

>[!Nota] **Acesso ao Formulário**
>**Caminho**: Sistema > Frota > Vecíulos

## Entrega de Valor
- Monitoramento da localização dos veículos
- Maior segurança e controle da frota
- Otimização de rotas e gestão eficiente de recursos

## Estrutura da Funcionalidade
O formulário de cadastro de veículos está organizado em uma guia composta por cinco abas principais, cada uma projetada para atender aspectos específicos relacionados às informações do veículo:

- **Veículos:** Aba principal destinada ao cadastro de informações essenciais do veículo, como modelo, código RENAVAM, placa, opção para ativar o rastreamento, entre outras.
- **Monitoramento:** Focada em detalhes adicionais dos veículos cadastrados, incluindo dados operacionais e informações sobre manutenção.
- **Rastreadores:** Relacionada ao formulário [[veiculos - rastreamento|Veículos - Rastreamento]], onde são registradas todas as coordenadas recebidas por meio da integração com rastreadores.
- **Arquivos:** Permite anexar documentos e arquivos relevantes, como o Certificado de Registro e Licenciamento do Veículo (CRLV), Certificado de Registro do Veículo (CRV), Documento Único de Transferência (DUT) e outros.
- **Histórico de Despesas:** Apresenta um detalhamento completo das despesas associadas ao veículo, exibidas de forma clara na aba de histórico.

## Configuração do Rastreador TK no Sistema

### Passo 1: Conferência e Liberação de Portas
Nesta etapa, é necessário realizar a conferência do estado das portas necessárias para a comunicação do rastreador com o servidor. Para verificar se as portas estão liberadas, insira os comandos abaixo diretamente na barra de pesquisa do navegador:

#### 1. Validação inicial do servidor
Inicialmente, será inserido o IP do seu servidor associado à requisição de validação de rastreamento, conforme a estrutura demonstrada abaixo. Copie a estrutura a seguir e substitua `ipdosistema`pelo IP do seu servidor.

> [!EXAMPLE] Estrutura:
> http://ipdosistema/monitoramento_gps/server.php

Após utilizar esta URL, o navegador irá apresentar as portas disponíveis para cada modelo de rastreador:
- Porta 10001  - Android;
- Porta 10002 - Android Cliente Traccar;
- Porta 10000 - GPS **TK103a, TK103B**

#### 2. Conferência da porta para os dispositivos TK103A/TL103B
Após validar a porta utilizada para cada equipamento, verifique se a porta 10000 está liberada em sua rede inserindo o comando a seguir no navegador, substituindo a estrutura `ip do sistema`pelo IP do servidor de seu sistema.

> [!EXAMPLE] Estrutura:
 http://ipdosistema:10000

- Se a porta estiver aberta, o navegador retornará **OK**.
- Caso contrário, será necessário liberar a porta na configuração da rede.

>[!TIP] **Importante:**  
A porta 10000 é utilizada exclusivamente para os equipamentos TK103A e TK103B. Certifique-se de configurá-la corretamente.

### Passo 2: Configuração do IMEI 

> [!INFO] **IMEI**:
> O IMEI é um número único que identifica cada dispositivo móvel. Para os equipamentos TK103A e TK103B, o IMEI é atribuído ao chip de rede móvel inserido no rastreador.

Para configurar os equipamentos TK103A e TK103B no sistema, é necessário liberar o IMEI do chip. Siga as orientações abaixo e envie os comandos via SMS na ordem indicada:

1. **Comando de reset e ativação:** Utilize um dispositivo móvel com saldo disponível para o envio de SMS e envie uma mensagem para o número registrado no chip do equipamento com os comandos de reset e ativação, conforme abaixo:
	
	- `begin123456`
	  
2. **Comando de configuração do APN:** Em seguida, indentifique a operadora do chip e envie o comando correspondente:
	- **Chip da Vivo:** `APN123456 zap.vivo.com.br`
	- **Chip M2M da Vivo:** `APN123456 smart.m2m.vivo.com.br`
	- **Chip da Claro:** `APN123456 claro.com.br` ou `APN123456 3g.claro.com.br`
	- **Chip M2M da Claro:** `APN123456 g.claro.com.br` ou `APN123456 generica.claro.com.br`
	- **Chip da Tim:** `APN123456 timbrasil.br`
	- **Chip da Oi:** `APN123456 gprs.oi.com.br`
	  
3. **Comando de acesso à rede:** Envie o comando de configuração do acesso à rede pelo comando:
	- `GPRS123456`
	  
4. **Comando de configuração do IP do servidor:** Envie o comando de configuração do endereço do IP do servidor onde os dados do dispositivo serão enviados:
	- `adminip123456 (IP do IXC) 10000`
	Exemplo: `adminip123456 123.456.789.100 10000`
	  
5. **Comando de intervalo de atualização da localização:** Envie o comando para ajustar o intervalo de atualização da localização:
	- `fix030s***n123456`
	  
6. **Comando de redução de frequência de transmissão de dados:** Envie o comando que ajusta as configurações de acesso à rede, reduzindo a frequência de dados transmitidos: 
	- `less gprs123456`
	  
7. **Comando de ajuste de fuso horário:** Envie o comando que define o fuso horário do dispositivo, indicando em qual horário devem constar as atualizações de localização:
	- `time zone123456 -3`
	  
8. **Comando de consulta de IMEI:** Envie o comando para realizar a consulta do IMEI do dispositivo:
	- `imei123456`
	Este comando retorna o IMEI que será inserido no sistema, na integração do equipamento. 
	
9. Copie o código retornado no SMS para a inserção no sistema.

> [!CAUTION]
> Os dados dos comandos devem ser alterados conforme necessário, considerando o chip utilizado ou o IP do cliente.


### Passo 3: Configuração do Veículo
Após consultar o IMEI do dispositivo, é necessário vinculá-lo a um veículo cadastrado no sistema.

>[!TIP] Guia instrutivo:
>Para realizar o cadastro de um veículo, acesse o material: [[cadastro de veiculos|Cadastro de Veículos]].

1. Acesse o formulário de **Veículos** através do caminho: Sistema > Frota > aba Veículos;
2. Selecione um veículo específico para realizar a associação do rastreador e clique em **Editar**. Caso necessário, realize o [[veiculos|Veículos]];
3. Acesse aba Veículos e localize a seção **Informações adicionais**, e preencha o campo descrito a seguir:
	- **IMEI do rastreador:** insira o código resgatado através dos comandos enviados ao equipamento.
	  
4. Clique no botão **Salvar** para finalizar a integração com o rastreador.

### Passo 4: Conferência da Comunicação
1. Para confirmar a comunicação entre o sistema e o rastreador, acesse a aba [[veiculos - rastreamento|Rastreadores]] para conferir se as coordenadas estão sendo atualizadas no sistema.
2. Acesse a grid de [[veiculos||Veículos]], selecione o veículo configurado com o rastreador e clique no botão **Mostrar Trajeto** > **Imprimir dia atual** para visualizar a localização no mapa.

## Fluxo de Trabalho

```mermaid
graph TD
    A[Instalar Rastreador] --> B[Liberar Portas]
    B --> C[Configurar IMEI do CHIP]
    C --> D[Enviar Comandos de Configuração]
    D --> E[Integrar com o Sistema]
    E --> F[Monitorar Veículos]
```

## Considerações Finais
A integração dos rastreadores TK103A e TK103B oferece uma solução robusta para o monitoramento veicular. Ao seguir cuidadosamente o processo de configuração, as empresas podem aproveitar ao máximo os benefícios dessa tecnologia para melhorar a gestão de suas frotas e aumentar a segurança de seus veículos.

## Etiquetas
#Integracoes #IntegracaoRastreadores #Rastreador #Frota #TK103A #TK103B

## Leia Também
 - [[integracoes|Integrações]]
- [[integracoes plataforma de rastreamento|Integrações Plataforma de Rastreamento]]
- [[integracoes de plataformas de rastreamento - cobli|Integrações Plataforma de Rastreamento - Cobli]]
- [[tarefa - atualizar dados rastreador (cobli)|Tarefa - Atualizar Dados Rastreador (Cobli)]]
- [[integracao com aplicativo de rastreamento - traccar client|Integração com aplicativo de rastreamento - Traccar Client]]
- [[veiculos|Veículos]]
- [[veiculos - rastreamento|Veículos - Rastreamento]]
- [[como anexar documentos no cadastro de veiculo|Como Anexar Documentos no Cadastro de Veículo]]
- [[cadastro de veiculos|Cadastro de Veículos]]