> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/devices-and-settings/connectivity/data-forwarding/maquinaria-amarilla.md).
# Maquinaria Amarilla
Cumpra o Decreto Colombiano 723 encaminhando dados GPS de máquinas pesadas do Navixy para a Polícia Nacional por meio do protocolo SOAP Maquinaria Amarilla.
Maquinaria Amarilla é o protocolo que a Polícia Nacional da Colômbia usa para monitorar máquinas pesadas e evitar seu uso ilícito. Empresas que operam máquinas pesadas na Colômbia devem reportá-lo conforme o Decreto 723 de 2014. Este protocolo encaminha os dados de posição e evento exigidos do Navixy para os servidores da polícia.
No Navixy, selecione **Maquinaria Amarela** no **Protocolo** menu suspenso.
A configuração tem três etapas, e elas devem ser feitas na ordem: gerar um token, registrar suas máquinas com a polícia e, em seguida, configurar o encaminhamento de dados no Navixy. As duas primeiras etapas acontecem fora do Navixy.
## O que a Navixy envia
O Navixy envia uma solicitação SOAP por mensagem para o `InsertarUbicacion` método. A solicitação contém estes campos:
| Campo | Conteúdo |
| ----------------------- | ---------------------------------------------------------------------------------------------------- |
| `PUSUARIO` | O login cadastrado com a Polícia Colombiana |
| `PTOKEN` | O token, obtido do **Senha** campo do retransmissor |
| `PIDUNIDAD` | O identificador da máquina, a partir do External ID |
| `PFECHAGPS` | Quando o dispositivo registrou a posição, como `dd/MM/yyyy HH:mm:ss` no horário colombiano |
| `PLATITUD`, `PLONGITUD` | Posição em graus |
| `PVELOCIDAD` | Velocidade |
| `PDIRECCION` | Rumo como direção da bússola |
| `PEVENTO` | O código de evento policial para esta mensagem |
| `PIGNICION` | `1` quando a ignição está ligada, `0` quando está desligada |
| `PODOMETRO` | Distância percorrida |
| `PSTATUS` | `1` para uma posição em tempo real, `9` para uma que o dispositivo armazenou e enviou posteriormente |
O Navixy envia cada mensagem, inclusive mensagens sem posição.
O Navixy converte seus próprios códigos de evento nos códigos que a polícia espera. Identificação do motorista, SOS, ignição ligada e desligada, excesso de velocidade, movimento não autorizado, bateria de backup fraca, início e fim do motor ocioso, perda de GPS, aceleração brusca e frenagem brusca, desconexão da antena, ativação, alarme de porta e alarme de umidade GSM correspondem, cada um, ao seu código policial. Qualquer outra mensagem é relatada como uma posição de monitoramento de rotina.
## Antes de começar
Você precisa do seguinte da Polícia Colombiana:
* O login e a senha da sua empresa, conforme registrados junto à polícia.
* O código do provedor que faz parte do identificador da máquina.
Você também precisa de **Postman**, instalado ou na versão web, para gerar o token e registrar suas máquinas.
## Gerar um token
O token autoriza todas as operações posteriores, inclusive o encaminhamento de dados. Gere-o antes de registrar máquinas.
Baixe a [coleção do Postman](https://drive.google.com/file/d/1XFe_vi22rHqqIDgLlAiTlcepLBBVPemZ/view) primeiro.
{% stepper %}
{% step %}
### Importar a coleção
Abra o Postman, clique em **Import**e carregue o arquivo que você baixou.
Importando a coleção para o Postman
{% endstep %}
{% step %}
### Abrir a solicitação do token
Selecione a chamada de geração do token e depois vá para a **ValIngreso** seção.
A chamada de geração do token
{% endstep %}
{% step %}
### Altere o corpo para raw
Vá para a **Body** guia e selecione **Raw**.
{% endstep %}
{% step %}
### Inserir suas credenciais
Substitua estes três valores no corpo da solicitação:
* **Usuário**: o login da sua empresa, conforme cadastrado junto à polícia
* **Senha**: a senha da sua empresa, conforme cadastrada junto à polícia
* **Número válido**: um número no formato `4.1234567890`
Os três valores a substituir no corpo da solicitação
{% endstep %}
{% step %}
### Enviar a solicitação
Envie a solicitação. Guarde o token da resposta, porque você o informará no Navixy mais tarde.
{% endstep %}
{% endstepper %}
## Registrar máquinas e dispositivos
Registre suas máquinas com a polícia antes de encaminhar dados. Uma posição de uma máquina não registrada é rejeitada.
Cada etapa usa uma coleção separada do Postman. Em cada uma, insira o login e o token que você gerou, junto com os detalhes da máquina exatamente como registrados na sua planilha de cadastro.
{% stepper %}
{% step %}
### Adicionar os dispositivos GPS
Import [a coleção de dispositivos](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) no Postman e envie a solicitação.
{% endstep %}
{% step %}
### Adicionar as máquinas
Import [a coleção de máquinas](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) no Postman e envie a solicitação.
{% endstep %}
{% step %}
### Vincular as máquinas aos dispositivos
Import [a coleção de vinculação](https://drive.google.com/file/d/1cfj26NXqdTvLIbSHWoeA-QSGDwz29EWk/view?usp=sharing) no Postman e envie a solicitação.
{% endstep %}
{% endstepper %}
Cada solicitação retorna um destes códigos:
| Código | Significado |
| ------ | ----------------------------------------------------------------------------------------- |
| `001` | O processo foi iniciado |
| `002` | O registro foi inserido com sucesso |
| `ER1` | Registro duplicado. Os cinco dígitos a seguir são o código de erro do banco de dados. |
| `ER2` | Outro erro de registro. Os cinco dígitos a seguir são o código de erro do banco de dados. |
| `ER3` | O usuário está incorreto ou o token não está mais ativo |
Uma máquina é registrada corretamente quando a resposta é `002`.
## Configurar encaminhamento
{% stepper %}
{% step %}
### Abra o bloco de Encaminhamento de dados
Acesse **Dispositivos e configurações**, selecione um dispositivo e localize o **Encaminhamento de dados** bloco.
{% endstep %}
{% step %}
### Abra a lista de protocolos
Clique em **Protocolos**, depois clique em **+** para adicionar uma configuração.
{% endstep %}
{% step %}
### Acessar as configurações de Maquinaria Amarilla
Preencha os campos da seguinte forma:
* **Nome**: um rótulo que identifica este retransmissor
* **Protocolo**: **Maquinaria Amarela**
* **Endereço**: `https://logmqa.policia.gov.co/Service1.asmx`
* **Porta**: `443`
* **Login**: o login fornecido pela Polícia Colombiana
* **Senha**: o token que você gerou, não a sua senha da polícia
A configuração concluída de Maquinaria Amarilla
{% endstep %}
{% step %}
### Ativar e salvar
Ligue **Ativado**, depois clique em **Salvar**. Um retransmissor que não está ativado não envia nada.
{% endstep %}
{% step %}
### Vincular o retransmissor a um dispositivo
No bloco do **Encaminhamento de dados** dispositivo, ative a chave do retransmissor que você criou e depois clique em **Salvar**.
{% endstep %}
{% step %}
### Definir o ID externo
Clique no ícone de link à direita da linha do retransmissor e, em seguida, informe o identificador da máquina que inclui o seu código do provedor. Ele pode ter até 20 caracteres, usando apenas letras maiúsculas e dígitos.
Repita esta etapa e a anterior para cada máquina que reporta à polícia.
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
O token expira. Quando isso acontece, o encaminhamento de dados é interrompido e os servidores da polícia respondem com o erro `ER3`. Gere um novo token e insira-o no **Senha** campo do retransmissor para retomar.
{% endhint %}
## Gerenciar encaminhamento de dados
Para alterar ou interromper o encaminhamento de dados para Maquinaria Amarilla:
* Clique no ícone de link à direita da linha do retransmissor para alterar o ID externo de um dispositivo.
* Desative a chave para interromper o encaminhamento de um dispositivo e manter a configuração dos demais.
* Clique em **Protocolos**, selecione a linha e edite-a para alterar o nome, o endereço ou o token. A alteração se aplica a todos os dispositivos vinculados a este retransmissor.
* Exclua a configuração da **Protocolos** lista para interromper o encaminhamento de todos os dispositivos. Confirme na caixa de diálogo.
## Solução de problemas
Quando os dados não aparecem no sistema Maquinaria Amarilla, verifique o seguinte nesta ordem:
1. O retransmissor está ativado e sua chave está ligada para o dispositivo.
2. O **Senha** campo contém um token atual, não sua senha da polícia.
3. O token não expirou. Um token expirado produz o erro `ER3`.
4. A máquina e seu dispositivo foram registrados com a polícia, e o registro retornou `002`.
5. O endereço e a porta estão corretos.
6. External ID corresponde ao identificador da máquina registrado com a polícia, incluindo o código do provedor.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://navixy.com/docs/user/pt-br/guide/devices-and-settings/connectivity/data-forwarding/maquinaria-amarilla.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
