> 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).

# Maquinário amarelo

Atenda ao Decreto colombiano 723 encaminhando dados de GPS de máquinas pesadas do Navixy para a Polícia Nacional por meio do protocolo SOAP Maquinaria Amarilla.

Maquinaria Amarela é o protocolo que a Polícia Nacional da Colômbia usa para monitorar máquinas pesadas e prevenir seu uso ilícito. As empresas que operam máquinas pesadas na Colômbia devem reportá-lo nos termos do Decreto 723 de 2014. Esse protocolo encaminha os dados obrigatórios de posição e evento da Navixy para os servidores da polícia.

No Navixy, selecione **Maquinaria Amarela** na **Protocolo** lista suspensa.

A configuração tem três etapas, e elas devem ser executadas na ordem: gerar um token, registrar suas máquinas com a polícia e, em seguida, configurar o encaminhamento de dados na Navixy. As duas primeiras etapas ocorrem fora da Navixy.

## O que o Navixy envia

A 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 na 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 da polícia para esta mensagem                                                     |
| `PIGNICION`             | `1` quando a Ignição estiver ligada, `0` quando estiver desligada                                    |
| `PODOMETRO`             | Distância percorrida                                                                                 |
| `PSTATUS`               | `1` para uma posição em tempo real, `9` para uma que o dispositivo armazenou e enviou posteriormente |

A Navixy envia todas as Mensagens, inclusive Mensagens sem posição.

A Navixy converte seus próprios códigos de evento nos códigos esperados pela polícia. A 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, desconexão da antena, ativação, alarme de porta e alarme de umidade GSM mapeiam cada um para seu código policial. Qualquer outra mensagem é registrada como uma posição de rastreamento de rotina.

## Antes de começar

Você precisa do seguinte da Polícia Colombiana:

* O login e a senha da sua empresa, conforme cadastrados na polícia.
* O código do provedor que compõe o identificador da máquina.

Você também precisa de **Postman**, instalado ou em sua 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 %}

### Importe a coleção

Abra o Postman, clique **Importar**, e envie o arquivo que você baixou.

<div align="left"><figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-05666c301892ef9ca37f6be9de650c3cdd82f8b9%2Fimage.png?alt=media" alt="The Postman Import dialog with the Maquinaria Amarilla collection file selected"><figcaption><p>Importando a coleção no Postman</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Abra a solicitação do token

Selecione a chamada de geração do token e, em seguida, vá para a **ValIngreso** seção.

<div align="left"><figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-d364a2215f72954039aa24be82be435cc6e4ae7b%2Fimage.png?alt=media" alt="The ValIngreso section of the token generation request in Postman"><figcaption><p>A chamada de geração do token</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Altere o corpo para a aba raw

Acesse a **Corpo** e selecione **Raw**.
{% endstep %}

{% step %}

### Insira suas credenciais

Substitua estes três valores no corpo da solicitação:

* **Usuário**: o login da sua empresa cadastrado na polícia
* **Senha**: a senha da sua empresa cadastrada na polícia
* **Número válido**: um número no formato `4.1234567890`

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-15bec39ce6c1dc4e4e3a03c69501893cf5faec4a%2Fimage.png?alt=media" alt="The token generation request body with the user, password, and valid number fields filled in"><figcaption><p>Os três valores a substituir no corpo da solicitação</p></figcaption></figure>
{% endstep %}

{% step %}

### Envie a solicitação

Envie a solicitação. Mantenha o token da resposta, porque você o inserirá na Navixy posteriormente.
{% endstep %}
{% endstepper %}

## Registrar máquinas e dispositivos

Registre suas máquinas na 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

Importar [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

Importar [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

Importar [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 que seguem são o código de erro do banco de dados.     |
| `ER2`  | Outro erro de registro. Os cinco dígitos que seguem 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 o encaminhamento

{% stepper %}
{% step %}

### Abra o bloco Encaminhamento de dados

Acesse **Dispositivos e configurações**, selecione um dispositivo e então 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 %}

### Acesse as configurações da Maquinaria Amarela

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

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-b2b7cf251c487757b5d3f494fb82822f2a26fbe1%2Fimage.png?alt=media" alt="The Protocol editing dialog with Yellow Machinery selected and the police endpoint address entered" width="270"><figcaption><p>A configuração concluída da Maquinaria Amarela</p></figcaption></figure>
{% endstep %}

{% step %}

### Ative e salve

Ative **Ativado**, depois clique em **Salvar**. Um retransmissor que não estiver ativado não envia nada.
{% endstep %}

{% step %}

### Vincule o retransmissor a um dispositivo

No bloco do dispositivo **Encaminhamento de dados** bloco, ative a chave do retransmissor que você criou e depois clique **Salvar**.
{% endstep %}

{% step %}

### Definir o External ID

Clique no ícone de link à direita da linha do retransmissor e, em seguida, insira 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 erro `ER3`. Gere um novo token e insira-o no **Senha** campo do retransmissor para retomar.
{% endhint %}

## Gerenciar encaminhamento

Para alterar ou interromper o encaminhamento de dados para a Maquinaria Amarela:

* Clique no ícone de link à direita da linha do retransmissor para alterar o External ID de um dispositivo.
* Desative a chave para interromper o encaminhamento de um dispositivo e manter a configuração para os outros.
* 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 para todos os dispositivos. Confirme na caixa de diálogo.

## Solução de problemas

Quando os dados não aparecem no sistema da Maquinaria Amarela, verifique o seguinte em ordem:

1. O retransmissor está ativado e sua chave está ligada para o dispositivo.
2. O **Senha** o campo contém um token atual, não a sua senha cadastrada na polícia.
3. O token não expirou. Um token expirado gera 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. O 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/pt-br/guide/devices-and-settings/connectivity/data-forwarding/maquinaria-amarilla.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
