# Maquinaria Amarilla

### Apa itu Maquinaria Amarilla?

Maquinaria Amarilla adalah protokol keamanan regulatori yang memantau, menyediakan visibilitas, dan menghasilkan laporan tentang operasi alat berat. Navixy menambahkan protokol penerusan data Maquinaria Amarilla untuk digunakan oleh perusahaan-perusahaan di industri Kolombia, yang berdasarkan hukum wajib dipantau oleh Kepolisian Nasional Kolombia.

Maquinaria Amarilla digunakan oleh pemerintah Kolombia untuk memantau alat berat dan mencegah penggunaan ilegal. Kepatuhan terhadap protokol ini wajib berdasarkan Dekret 723 tahun 2014.

### Informasi umum

Protokol Maquinaria Amarilla menggunakan SOAP untuk mengirim data XML setiap 60 menit melalui HTTP ke kepolisian Kolombia.

Data berikut dikirim ke Kepolisian Nasional Kolombia:

* Pelat nomor kendaraan
* Kode peristiwa
* Tanggal
* Alamat
* Lintang
* Bujur
* Ketinggian
* Kecepatan
* Arah perjalanan
* Ignition
* Odometer
* Device ID

### Konfigurasi

#### Parameter yang diperlukan

Parameter berikut diperlukan:

* Pengguna dan kata sandi: Kredensial untuk Maquinaria Amarilla
* ID Eksternal: ID 20 karakter yang mencakup kode penyedia yang diberikan oleh Kepolisian Kolombia
* Token: Diperlukan untuk semua operasi dalam protokol

#### Cara menghasilkan token

Untuk memperoleh token, Anda harus mengirim data XML tertentu.

**Prasyarat**:

* Unduh [koleksi Postman](https://drive.google.com/file/d/1XFe_vi22rHqqIDgLlAiTlcepLBBVPemZ/view)
* Instal **Postman** atau gunakan versi web-nya

{% stepper %}
{% step %}
Buka **Postman**
{% endstep %}

{% step %}
Klik **Impor** dan unggah file XML yang sebelumnya diunduh

<div align="left"><figure><img src="/files/cc1abc51ba17706eb819f291c3ce5dad27658baa" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Pilih panggilan untuk pembuatan token dan buka bagian **ValIngreso** bagian

<div align="left"><figure><img src="/files/ad32e1b44f9942ecf1f7b68b396576b6698a8b07" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Buka tab **Body** dan pilih **Raw**

<figure><img src="/files/69e93d549d597c567e1d68a48a57d0bba5e92be2" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Ubah tiga nilai berikut:

* **Pengguna**: Login perusahaan yang terdaftar pada kepolisian Kolombia
* **Kata sandi**: Kata sandi perusahaan yang terdaftar pada kepolisian Kolombia
* **Nomor valid**: Nomor dalam format contoh `4.1234567890`

<figure><img src="/files/5979ada3a6db4416d6bd025b8816f7f98cb85ef7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Kirim permintaan untuk menghasilkan token
{% endstep %}
{% endstepper %}

#### Cara mendaftarkan objek dan perangkat

Setelah token dibuat, Anda harus mendaftarkan objek dan perangkat untuk menyinkronkannya dengan basis data Kepolisian. Prosesnya mirip dengan memperoleh token, tetapi menggunakan data perangkat dan objek.

{% stepper %}
{% step %}
Tambahkan perangkat GPS

Impor [JSON ini](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) ke dalam Postman.

Masukkan pengguna dan token yang telah dibuat sebelumnya, bersama dengan field persis seperti yang terdaftar dalam file Excel Anda. Sistem akan menghasilkan salah satu kode respons berikut:

```
001 --> MEMULAI PROSES
002 --> REKAMAN BERHASIL DITAMBAHKAN
ER1 XXXXX --> KESALAHAN REKAMAN DUPLIKAT (IDTRAMA) XXXXX = KODE KESALAHAN ORACLE
ER2 XXXXX --> KESALAHAN REKAMAN LAIN XXXXX = KODE KESALAHAN ORACLE
ER3 XXXXXXXXXX --> KESALAHAN PENGGUNA ATAU TOKEN TIDAK AKTIF
```

{% endstep %}

{% step %}
Tambahkan objek

Impor [JSON ini](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) ke dalam Postman

Masukkan pengguna dan token yang telah dibuat sebelumnya, bersama dengan field persis seperti yang terdaftar dalam file Excel Anda. Sistem akan menghasilkan salah satu kode respons yang tercantum di atas.
{% endstep %}

{% step %}
Tautkan objek dengan perangkat

Impor [JSON ini](https://drive.google.com/file/d/1cfj26NXqdTvLIbSHWoeA-QSGDwz29EWk/view?usp=sharing) ke dalam Postman.

Masukkan pengguna dan token yang telah dibuat sebelumnya, bersama dengan field persis seperti yang tercantum dalam file Excel Anda.

Saat mesin terdaftar dengan benar, sistem mengembalikan `002`, yang menunjukkan bahwa mesin berhasil ditambahkan.
{% endstep %}
{% endstepper %}

#### Cara mengonfigurasi penerusan data di Navixy

Untuk mengonfigurasi penerusan data untuk protokol Maquinaria Amarilla:

{% stepper %}
{% step %}
Buka ke bagian **Perangkat dan pengaturan** di panel sisi utama
{% endstep %}

{% step %}
Pilih **Penerusan Data** blok
{% endstep %}

{% step %}
Klik **Protokol**
{% endstep %}

{% step %}
Klik **+** tombol untuk menambahkan protokol retranslasi baru.
{% endstep %}

{% step %}
Masukkan parameter berikut:

* **Nama**: Masukkan nama untuk mengidentifikasi protokol ini
* **Protokol**: Pilih **Maquinaria Amarilla (Yellow Machinery** dalam bahasa Inggris) dari menu dropdown
* **Alamat**: `https://logmqa.policia.gov.co/Service1.asmx`
* **Port**: `443`
* **Login**: Masukkan login yang diberikan oleh Kepolisian Kolombia
* **Kata sandi**: Masukkan kata sandi yang diberikan oleh Kepolisian Kolombia

<figure><img src="/files/69e93d549d597c567e1d68a48a57d0bba5e92be2" alt="" width="270"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Pastikan kotak centang **Enabled** dipilih
{% endstep %}

{% step %}
Klik **Simpan**
{% endstep %}
{% endstepper %}

#### Cara mengelola penerusan data

Untuk mengedit atau menghentikan penerusan data:

* Klik **Edit** di samping entri protokol untuk membuka jendela **Pengeditan protokol** dan mengubah konfigurasinya.
* Klik **Hapus** untuk menghapus protokol dan menghentikan penerusan data. Konfirmasikan perubahan di jendela pop-up.

### Pemecahan masalah

Jika data tidak muncul di sistem **Maquinaria Amarilla** , verifikasi hal berikut:

* Nama pengguna dan token untuk **Maquinaria Amarilla** dimasukkan dengan benar.
* URL dimasukkan dengan benar.
* Pendaftaran perangkat berhasil diselesaikan dengan kepolisian.
* Protokol retranslasi diaktifkan di Navixy.


---

# Agent Instructions: 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:

```
GET https://navixy.com/docs/user/id/guide/devices-and-settings/data-forwarding/maquinaria-amarilla.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
