> 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/unigis.md).

# Unigis

Teruskan data GPS dan telematika dari Navixy ke platform TMS Unigis, mengirim satu posisi per menit per kendaraan melalui HTTP.

Unigis adalah sistem manajemen transportasi, dan protokol Penerusan data Unigis mengirimkan posisi kendaraan dari Navixy ke dalamnya. Departemen logistik di perusahaan manufaktur dan ritel menggunakannya untuk menerima data dari operator mereka, termasuk pemasok untuk jaringan seperti Walmart, Home Depot, dan Kimberly-Clark. Operator dapat mengirim data ke Unigis tanpa memberikan perusahaan penerima akses ke akun Navixy.

Unigis paling umum digunakan oleh perusahaan di Amerika Serikat, Meksiko, Kolombia, Cile, Argentina, Brasil, dan Spanyol.

Di Navixy, pilih **UNIGIS** di **Protokol** daftar tarik-turun. Begitulah Unigis dinamai di antarmuka.

## Apa yang dikirim Navixy

Navixy mengirim satu permintaan HTTP POST per posisi ke `LoginYInsertarEvento` metode endpoint Unigis. Isi permintaan dikodekan sebagai formulir dan berisi bidang-bidang berikut:

| Bidang                           | Isi                                                                                   |
| -------------------------------- | ------------------------------------------------------------------------------------- |
| `SystemUser` dan `Kata sandi`    | Kredensial Unigis dari konfigurasi retranslator, dikirimkan bersama setiap permintaan |
| `Dominio`                        | ID Eksternal perangkat, atau id perangkat Navixy saat External ID kosong              |
| `Codigo`                         | Kode peristiwa Navixy untuk pesan ini                                                 |
| `Latitud`, `Longitud`, `Altitud` | Posisi dalam derajat, ketinggian dalam meter                                          |
| `Velocidad`                      | Kecepatan                                                                             |
| `Rumbo`                          | Arah                                                                                  |
| `FechaHoraEvento`                | Saat perangkat merekam posisi, dalam ISO 8601                                         |
| `FechaHoraRecepcion`             | Waktu Navixy menerima pesan, dalam format ISO 8601                                    |

Peristiwa seperti alarm pintu, penekanan Tombol panik, atau pematian mesin bukan merupakan bidang terpisah. Masing-masing tiba sebagai nilai di `Codigo` pada pesan yang melaporkannya.

Unigis merespons setiap permintaan dengan kode numerik. Kode negatif berarti Unigis menolak posisi tersebut, dan Navixy menutup koneksi lalu mencoba kembali.

### Saat Navixy mengirim

Navixy mengirim paling banyak satu posisi per menit per perangkat. Saat perangkat melaporkan lebih sering dari itu, posisi di antaranya dilewati alih-alih diantrekan, sehingga data di Unigis merupakan sampel satu menit, bukan rekaman perjalanan lengkap.

Dua aturan mengesampingkan batas satu menit:

* Peristiwa mendesak dikirim segera setelah tiba, meskipun posisi sebelumnya dikirim kurang dari satu menit sebelumnya.
* Pesan tanpa koordinat yang valid tidak pernah dikirim, terlepas dari waktunya.

## Sebelum memulai

Kumpulkan hal-hal berikut dari Unigis:

* Alamat endpoint dan port. Unigis mengoperasikan beberapa hub, jadi konfirmasikan hub yang berlaku untuk akun Anda.
* Login dan kata sandi Unigis Anda. Navixy memerlukan keduanya dan tidak akan menyimpan retranslator tanpa keduanya.

Anda juga memerlukan nomor pelat kendaraan sebagaimana terdaftar di sisi Unigis, yang dimasukkan ke bidang ID Eksternal setiap perangkat. Navixy menerima nilai apa pun yang tidak kosong di sini, sehingga pelat yang tidak cocok dengan catatan Unigis diterima saat penyimpanan lalu ditolak oleh Unigis.

## Siapkan 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 %}

### Masukkan pengaturan Unigis

Isi kolom-kolom berikut:

* **Nama**: label yang mengidentifikasi retranslator ini
* **Protokol**: **UNIGIS**
* **Alamat**: alamat endpoint dari Unigis, misalnya `http://unigis2.unisolutions.com.ar/HUB/UNIGIS/MAPI/SOAP/GPS/Service.asmx`
* **Port**: port dari Unigis, umumnya `80`
* **Login** dan **Kata sandi**: kredensial Unigis Anda

Saat Anda memasukkan alamat tanpa jalur, Navixy menggunakan `/HUB/UNIGIS/MAPI/SOAP/COMMServer/service.asmx`. Masukkan alamat lengkap yang diberikan Unigis, alih-alih mengandalkan nilai default ini.
{% endstep %}

{% step %}

### Aktifkan dan simpan

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

{% step %}

### Hubungkan retranslator ke perangkat

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

{% step %}

### Tetapkan External ID

Klik ikon tautan di sebelah kanan baris retranslator, lalu masukkan nomor pelat kendaraan sebagaimana terdaftar di sisi Unigis. Klik **Simpan**.

Ulangi langkah ini dan langkah sebelumnya untuk setiap perangkat yang meneruskan data ke Unigis. Konfigurasi retranslator dibagikan di seluruh akun, tetapi ID Eksternal ditetapkan per perangkat.
{% endstep %}
{% endstepper %}

## Kelola penerusan

Untuk mengubah atau menghentikan penerusan ke Unigis:

* 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 kredensial. Perubahan tersebut berlaku untuk setiap perangkat yang terhubung ke retranslasi ini.
* Hapus konfigurasi dari **Protokol** daftar untuk menghentikan penerusan untuk semua perangkat. Konfirmasikan di dialog.

## Pemecahan masalah

Saat data tidak muncul di Unigis, periksa hal-hal berikut secara berurutan:

1. Retranslator diaktifkan, dan togglenya dinyalakan untuk perangkat.
2. Login dan kata sandi sesuai dengan kredensial Unigis Anda. Navixy mengirimkannya bersama setiap posisi, sehingga kata sandi yang salah menyebabkan setiap permintaan gagal, bukan hanya permintaan pertama.
3. Alamat mencakup jalur lengkap yang diberikan Unigis, dan port sudah benar.
4. ID Eksternal sesuai dengan nomor pelat kendaraan yang terdaftar di sisi Unigis.
5. Perangkat melaporkan koordinat yang valid. Posisi tanpa perbaikan GPS tidak pernah diteruskan.

Saat posisi tiba tetapi jumlahnya lebih sedikit dari yang diharapkan, hal itu disebabkan oleh batas satu menit, bukan kesalahan. Unigis menerima sampel satu menit dari rekaman perjalanan.


---

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