> 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 harus melapor kepadanya berdasarkan Keputusan 723 tahun 2014. Protokol ini meneruskan data posisi dan peristiwa yang diperlukan dari Navixy ke server polisi.

Di Navixy, pilih **Mesin Kuning** di **Protokol** menu tarik-turun.

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

## Apa yang dikirim Navixy

Navixy mengirim satu permintaan SOAP per pesan ke `InsertarUbicacion` metode. Permintaan ini memuat 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, dalam `dd/MM/yyyy HH:mm:ss` waktu Kolombia                |
| `PLATITUD`, `PLONGITUD` | Posisi dalam derajat                                                                     |
| `PVELOCIDAD`            | Kecepatan                                                                                |
| `PDIRECCION`            | Arah sebagai mata angin                                                                  |
| `PEVENTO`               | Kode peristiwa kepolisian untuk pesan ini                                                |
| `PIGNICION`             | `1` saat pengapian menyala, `0` saat 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, pelampauan kecepatan, gerakan tanpa izin, baterai cadangan lemah, awal dan akhir idle, kehilangan GPS, percepatan kasar dan pengereman, pemutusan antena, bangun, alarm pintu, dan alarm kelembapan GSM masing-masing dipetakan ke kode kepolisian 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 versi webnya, untuk membuat token dan mendaftarkan mesin Anda.

## Buat token

Token memberi otorisasi pada setiap operasi berikutnya, termasuk penerusan data. Buat token 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 body menjadi raw

Buka **Isi** tab dan pilih **Raw**.
{% endstep %}

{% step %}

### Masukkan kredensial Anda

Ganti tiga nilai berikut di body permintaan:

* **Pengguna**: login perusahaan Anda yang terdaftar di polisi
* **Kata sandi**: kata sandi perusahaan Anda yang terdaftar di polisi
* **Nomor valid**: sebuah 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 di body permintaan</p></figcaption></figure>
{% endstep %}

{% step %}

### Kirim permintaan

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

## Daftarkan mesin dan perangkat

Daftarkan mesin Anda ke polisi sebelum meneruskan data. Posisi dari mesin yang belum terdaftar akan ditolak.

Setiap langkah menggunakan koleksi Postman terpisah. Pada masing-masing koleksi, masukkan login dan token yang Anda buat, beserta detail mesin persis seperti yang dicatat 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 berikut adalah kode kesalahan basis data.          |
| `ER2` | Kesalahan rekaman lainnya. Lima digit berikut adalah kode kesalahan basis data. |
| `ER3` | Pengguna salah, atau token sudah tidak aktif lagi                               |

Mesin terdaftar dengan benar ketika responsnya adalah `002`.

## Setelan penerusan

{% stepper %}
{% step %}

### Buka blok Penerusan data

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

{% step %}

### Buka daftar protokol

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

{% step %}

### Buka pengaturan Maquinaria Amarilla

Isi kolom sebagai berikut:

* **Nama**: label yang mengidentifikasi retranslator ini
* **Protokol**: **Mesin Kuning**
* **Alamat**: `https://logmqa.policia.gov.co/Service1.asmx`
* **Port**: `443`
* **Nama pengguna**: 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 selesai</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 perangkat **Penerusan data** aktifkan sakelar untuk retranslator yang Anda buat, lalu klik **Simpan**.
{% endstep %}

{% step %}

### Atur External ID

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

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

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

## Kelola penerusan

Untuk mengubah atau menghentikan penerusan ke Maquinaria Amarilla:

* Klik ikon tautkan di sebelah kanan baris retranslator untuk mengubah External ID suatu perangkat.
* Matikan sakelar untuk menghentikan penerusan bagi satu perangkat, dan pertahankan konfigurasi untuk perangkat lainnya.
* 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. Konfirmasi di dialog.

## Pemecahan masalah

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

1. Retranslator diaktifkan, dan sakelarnya dinyalakan untuk perangkat.
2. Blok **Kata sandi** kolom tersebut berisi token yang masih aktif, bukan kata sandi polisi Anda.
3. Token belum kedaluwarsa. Token yang kedaluwarsa menghasilkan kesalahan `ER3`.
4. Mesin dan perangkatnya telah didaftarkan ke polisi, dan pendaftaran mengembalikan `002`.
5. Alamat dan port sudah 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.