> 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/id/guide/devices-and-settings/connectivity/data-forwarding/maquinaria-amarilla.md).

# Maquinaria Amarilla

Patuhi Dekret Kolombia 723 dengan meneruskan data GPS alat berat dari Navixy ke Kepolisian Nasional melalui protokol SOAP Maquinaria Amarilla.

Maquinaria Amarilla adalah protokol yang digunakan Kepolisian Nasional Kolombia untuk memantau alat berat dan mencegah penggunaan ilegalnya. Perusahaan yang mengoperasikan alat berat di Kolombia wajib melaporkannya berdasarkan Dekret 723 tahun 2014. Protokol ini meneruskan data posisi dan peristiwa yang diperlukan dari Navixy ke server polisi.

Di Navixy, pilih **Yellow Machinery** di **Protokol** menu tarik-turun.

Penyiapan memiliki tiga tahap, dan harus dilakukan secara berurutan: buat token, daftarkan mesin Anda ke polisi, lalu konfigurasikan penerusan data di Navixy. Dua tahap pertama dilakukan di luar Navixy.

## Yang dikirim Navixy

Navixy mengirim satu permintaan SOAP untuk setiap pesan ke `InsertarUbicacion` metode ini. Permintaan berisi bidang-bidang berikut:

| Bidang                  | Isi                                                                                      |
| ----------------------- | ---------------------------------------------------------------------------------------- |
| `PUSUARIO`              | Login yang terdaftar di Kepolisian Kolombia                                              |
| `PTOKEN`                | Token, diambil dari **Kata sandi** kolom retranslator                                    |
| `PIDUNIDAD`             | Pengenal mesin, dari External ID                                                         |
| `PFECHAGPS`             | Saat perangkat merekam posisi, sebagai `dd/MM/yyyy HH:mm:ss` dalam waktu Kolombia        |
| `PLATITUD`, `PLONGITUD` | Posisi dalam derajat                                                                     |
| `PVELOCIDAD`            | Kecepatan                                                                                |
| `PDIRECCION`            | Arah sebagai mata angin                                                                  |
| `PEVENTO`               | Kode peristiwa polisi untuk pesan ini                                                    |
| `PIGNICION`             | `1` saat pengapian menyala, `0` saat pengapian mati                                      |
| `PODOMETRO`             | Jarak tempuh                                                                             |
| `PSTATUS`               | `1` untuk posisi langsung, `9` untuk posisi yang disimpan perangkat dan dikirim kemudian |

Navixy mengirim setiap pesan, termasuk pesan tanpa posisi.

Navixy mengonversi kode peristiwanya sendiri ke kode yang diharapkan polisi. Identifikasi supir, SOS, pengapian menyala dan mati, kecepatan berlebih, gerakan tanpa izin, baterai cadangan lemah, awal dan akhir idle, hilangnya GPS, percepatan kasar dan pengereman, putusnya antena, aktivasi, alarm pintu, dan alarm redaman GSM masing-masing dipetakan ke kode polisi mereka. Pesan lainnya dilaporkan sebagai posisi pelacakan rutin.

## Sebelum Anda mulai

Anda memerlukan hal berikut dari Kepolisian Kolombia:

* Login dan kata sandi perusahaan Anda yang terdaftar di polisi.
* Kode penyedia yang menjadi bagian dari pengenal mesin.

Anda juga memerlukan **Postman**, yang terpasang atau dalam versi webnya, untuk menghasilkan token dan mendaftarkan mesin Anda.

## Buat token

Token ini mengotorisasi setiap operasi berikutnya, termasuk penerusan data. Buat token tersebut sebelum Anda mendaftarkan mesin.

Unduh [koleksi Postman](https://drive.google.com/file/d/1XFe_vi22rHqqIDgLlAiTlcepLBBVPemZ/view) terlebih dahulu.

{% stepper %}
{% step %}

### Impor koleksi

Buka Postman, klik **Impor**, lalu unggah file yang Anda unduh.

<div align="left"><figure><img src="https://3001559198-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>Mengimpor koleksi ke Postman</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Buka permintaan token

Pilih panggilan pembuatan token, lalu buka **ValIngreso** bagian.

<div align="left"><figure><img src="https://3001559198-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>Panggilan pembuatan token</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Ubah isi ke raw

Buka **Isi** tab, lalu pilih **Raw**.
{% endstep %}

{% step %}

### Masukkan kredensial Anda

Ganti tiga nilai berikut dalam isi permintaan:

* **Pengguna**: login perusahaan Anda yang terdaftar di polisi
* **Kata sandi**: kata sandi perusahaan Anda yang terdaftar di polisi
* **Nomor valid**: nomor dalam format `4.1234567890`

<figure><img src="https://3001559198-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>Tiga nilai yang harus diganti dalam isi permintaan</p></figcaption></figure>
{% endstep %}

{% step %}

### Kirim permintaan

Kirim permintaan. Simpan token dari respons, karena Anda akan memasukkannya di Navixy nanti.
{% endstep %}
{% endstepper %}

## Daftarkan mesin dan perangkat

Daftarkan mesin Anda ke polisi sebelum melakukan penerusan data. Posisi untuk mesin yang belum terdaftar akan ditolak.

Setiap langkah menggunakan koleksi Postman terpisah. Pada masing-masing koleksi, masukkan login dan token yang Anda hasilkan, bersama detail mesin persis seperti yang tercatat dalam spreadsheet pendaftaran Anda.

{% stepper %}
{% step %}

### Tambahkan perangkat GPS

Impor [koleksi perangkat](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) ke Postman dan kirim permintaan.
{% endstep %}

{% step %}

### Tambahkan mesin

Impor [koleksi mesin](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) ke Postman dan kirim permintaan.
{% endstep %}

{% step %}

### Tautkan mesin ke perangkat

Impor [koleksi penautan](https://drive.google.com/file/d/1cfj26NXqdTvLIbSHWoeA-QSGDwz29EWk/view?usp=sharing) ke Postman dan kirim permintaan.
{% endstep %}
{% endstepper %}

Setiap permintaan mengembalikan salah satu kode berikut:

| Kode  | Arti                                                                       |
| ----- | -------------------------------------------------------------------------- |
| `001` | Proses dimulai                                                             |
| `002` | Rekaman berhasil disisipkan                                                |
| `ER1` | Rekaman duplikat. Lima digit berikutnya adalah kode galat basis data.      |
| `ER2` | Galat rekaman lainnya. Lima digit berikutnya adalah kode galat basis data. |
| `ER3` | Pengguna salah, atau token tidak lagi aktif                                |

Mesin terdaftar dengan benar ketika responsnya adalah `002`.

## Atur penerusan

{% stepper %}
{% step %}

### Buka blok Penerusan data

Buka **Perangkat dan pengaturan**, pilih perangkat, lalu temukan blok **Penerusan data** .
{% endstep %}

{% step %}

### Buka daftar protokol

Klik **Protokol**, lalu klik **+** untuk menambahkan konfigurasi.
{% endstep %}

{% step %}

### Buka pengaturan Maquinaria Amarilla

Isi bidang-bidang sebagai berikut:

* **Nama**: label yang mengidentifikasi retranslator ini
* **Protokol**: **Yellow Machinery**
* **Alamat**: `https://logmqa.policia.gov.co/Service1.asmx`
* **Port**: `443`
* **Login**: login yang diberikan oleh Kepolisian Kolombia
* **Kata sandi**: token yang Anda buat, bukan kata sandi polisi Anda

<figure><img src="https://3001559198-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>Konfigurasi Maquinaria Amarilla yang lengkap</p></figcaption></figure>
{% endstep %}

{% step %}

### Aktifkan dan simpan

Nyalakan **Diaktifkan**, lalu klik **Simpan**. Retranslator yang tidak diaktifkan tidak mengirim apa pun.
{% endstep %}

{% step %}

### Tautkan retranslator ke perangkat

Di blok milik perangkat **Penerusan data** , aktifkan sakelar untuk retranslator yang Anda buat, lalu klik **Simpan**.
{% endstep %}

{% step %}

### Setel External ID

Klik ikon tautan di sisi kanan baris retranslator, lalu masukkan pengenal mesin yang mencakup kode penyedia Anda. Panjangnya dapat sampai 20 karakter, hanya menggunakan huruf kapital dan digit.

Ulangi langkah ini dan langkah sebelumnya untuk setiap mesin yang melaporkan ke polisi.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Token kedaluwarsa. Saat itu terjadi, penerusan data berhenti dan server polisi membalas dengan galat `ER3`. Buat token baru dan masukkan ke **Kata sandi** kolom retranslator untuk melanjutkan.
{% endhint %}

## Kelola penerusan

Untuk mengubah atau menghentikan penerusan data ke Maquinaria Amarilla:

* Klik ikon tautan di kanan baris retranslator untuk mengubah External ID suatu perangkat.
* Matikan sakelar untuk menghentikan penerusan bagi satu perangkat, dan pertahankan konfigurasi untuk yang lain.
* Klik **Protokol**, pilih baris tersebut, lalu edit untuk mengubah nama, alamat, atau token. Perubahan berlaku untuk setiap perangkat yang ditautkan ke retranslator ini.
* Hapus konfigurasi dari **Protokol** daftar untuk menghentikan penerusan bagi semua perangkat. Konfirmasikan di dialog.

## Pemecahan masalah

Jika data tidak muncul di sistem Maquinaria Amarilla, periksa hal berikut secara berurutan:

1. Retranslator diaktifkan, dan sakelarnya dinyalakan pada perangkat.
2. Tab **Kata sandi** kolom berisi token yang aktif, bukan kata sandi polisi Anda.
3. Token belum kedaluwarsa. Token yang kedaluwarsa menghasilkan galat `ER3`.
4. Mesin dan perangkatnya telah didaftarkan ke polisi, dan pendaftarannya menghasilkan `002`.
5. Alamat dan port benar.
6. External ID cocok dengan pengenal mesin yang didaftarkan ke polisi, termasuk kode penyedia.


---

# 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/id/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.
