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

Di Navixy, pilih **Maquinaria Amarilla** 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 untuk setiap pesan ke metode `InsertarUbicacion` metode. Permintaan ini 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 kepolisian 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 nanti |

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 tidak sah, baterai cadangan lemah, awal dan akhir Idle, hilangnya GPS, percepatan kasar dan pengereman keras, pemutusan antena, aktivasi, alarm pintu, dan alarm gangguan GSM masing-masing dipetakan ke kode kepolisian. Pesan lainnya dilaporkan sebagai posisi pelacakan rutin.

## Sebelum Anda memulai

Anda memerlukan hal berikut dari Kepolisian Kolombia:

* Nama pengguna dan kata sandi perusahaan Anda seperti yang terdaftar di kepolisian.
* Kode penyedia yang menjadi bagian dari pengenal mesin.

Anda juga memerlukan **Postman**, terpasang atau dalam 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 **Import**, 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 bagian **ValIngreso** .

<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 tab **Body** dan pilih **Raw**.
{% endstep %}

{% step %}

### Masukkan kredensial Anda

Ganti ketiga nilai ini di isi permintaan:

* **Pengguna**: nama pengguna perusahaan Anda seperti yang terdaftar di kepolisian
* **Kata sandi**: kata sandi perusahaan Anda seperti yang terdaftar di kepolisian
* **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 di 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 meneruskan data. Posisi untuk mesin yang belum terdaftar akan ditolak.

Setiap langkah menggunakan koleksi Postman terpisah. Di masing-masing, masukkan login dan token yang Anda buat, bersama detail mesin persis seperti yang tercatat di lembar kerja pendaftaran Anda.

{% stepper %}
{% step %}

### Tambahkan perangkat GPS

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

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

{% step %}

### Hubungkan mesin ke perangkat

Import [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` | Catatan berhasil dimasukkan                                                 |
| `ER1` | Catatan duplikat. Lima digit yang mengikuti adalah kode galat basis data.   |
| `ER2` | Galat catatan lain. Lima digit yang mengikuti adalah kode galat basis data. |
| `ER3` | Nama pengguna salah, atau token tidak lagi aktif                            |

Sebuah mesin terdaftar dengan benar ketika responsnya adalah `002`.

## Atur penerusan

{% stepper %}
{% step %}

### Buka blok Penerusan data

Buka **Perangkat dan pengaturan**, pilih perangkat, lalu temukan **Penerusan data** blok.
{% 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 pengirim ulang ini
* **Protokol**: **Maquinaria Amarilla**
* **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 kepolisian 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**. Pengirim ulang yang tidak diaktifkan tidak mengirim apa pun.
{% endstep %}

{% step %}

### Tautkan pengirim ulang ke perangkat

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

{% step %}

### Tetapkan External ID

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

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

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

## Kelola penerusan data

Untuk mengubah atau menghentikan penerusan ke Maquinaria Amarilla:

* Klik ikon tautan di sisi kanan baris pengirim ulang untuk mengubah External ID perangkat.
* Matikan sakelar untuk menghentikan penerusan data bagi satu perangkat, dan tetap simpan konfigurasi untuk perangkat lainnya.
* Klik **Protokol**, pilih barisnya, lalu edit untuk mengubah nama, alamat, atau token. Perubahan ini berlaku untuk setiap perangkat yang ditautkan ke retranslator ini.
* Hapus konfigurasi dari **Protokol** daftar untuk menghentikan penerusan data untuk semua perangkat. Konfirmasikan di dialog.

## Pemecahan masalah

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

1. Pengirim ulang diaktifkan, dan sakselnya dinyalakan untuk perangkat.
2. Itu **Kata sandi** kolom memuat token yang masih berlaku, bukan kata sandi kepolisian Anda.
3. Token belum kedaluwarsa. Token yang kedaluwarsa menghasilkan galat `ER3`.
4. Mesin dan perangkatnya telah didaftarkan ke kepolisian, dan pendaftaran mengembalikan `002`.
5. Alamat dan port sudah benar.
6. External ID cocok dengan pengenal mesin yang terdaftar di kepolisian, 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 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/id/guide/devices-and-settings/connectivity/data-forwarding/maquinaria-amarilla.md?ask=<question>&goal=<endgoal>
```

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