> 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 Unigis TMS, dengan 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 pengangkut mereka, termasuk pemasok untuk jaringan seperti Walmart, Home Depot, dan Kimberly-Clark. Seorang pengangkut dapat mengirim data ke Unigis tanpa memberi 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** menu tarik-turun. Begitulah Unigis dinamai di antarmuka.

## Apa yang dikirim Navixy

Navixy mengirim satu permintaan HTTP POST untuk setiap posisi ke `LoginYInsertarEvento` metode endpoint Unigis. Isi bodinya berformat formulir, dan berisi bidang-bidang berikut:

| Bidang                           | Isi                                                                                   |
| -------------------------------- | ------------------------------------------------------------------------------------- |
| `SystemUser` dan `Kata sandi`    | Kredensial Unigis dari konfigurasi penerjemah ulang, dikirim dengan setiap permintaan |
| `Dominio`                        | ID Eksternal perangkat, atau ID perangkat Navixy saat ID Eksternal kosong             |
| `Codigo`                         | Kode peristiwa Navixy untuk pesan ini                                                 |
| `Latitud`, `Longitud`, `Altitud` | Posisi dalam derajat, ketinggian dalam meter                                          |
| `Velocidad`                      | Kecepatan                                                                             |
| `Rumbo`                          | Heading                                                                               |
| `FechaHoraEvento`                | Saat perangkat merekam posisi, dalam ISO 8601                                         |
| `FechaHoraRecepcion`             | Saat Navixy menerima pesan, dalam ISO 8601                                            |

Peristiwa seperti alarm pintu, penekanan Tombol panik, atau pematian mesin bukan bidang terpisah. Masing-masing muncul sebagai nilai dalam `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 lagi.

### Saat Navixy mengirim

Navixy mengirim paling banyak satu posisi per menit per perangkat. Ketika perangkat melapor lebih sering dari itu, posisi di antaranya dilewati, bukan diantrekan, sehingga data di Unigis adalah sampel satu menit dan bukan jejak penuh.

Dua aturan mengesampingkan batas satu menit:

* Peristiwa mendesak dikirim segera setelah tiba, bahkan jika posisi sebelumnya dikirim kurang dari satu menit sebelumnya.
* Pesan tanpa koordinat valid tidak pernah dikirim, berapa pun waktunya.

## Sebelum Anda mulai

Kumpulkan hal-hal berikut dari Unigis:

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

Anda juga memerlukan nomor pelat kendaraan seperti yang terdaftar di sisi Unigis, yang dimasukkan ke kolom External ID untuk setiap perangkat. Navixy menerima nilai apa pun yang tidak kosong di sini, jadi pelat yang tidak cocok dengan catatan Unigis diterima saat penyimpanan lalu ditolak oleh Unigis.

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

### Masukkan pengaturan Unigis

Isi kolom sebagai 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, biasanya `80`
* **Nama pengguna** 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 kepada Anda alih-alih mengandalkan nilai bawaan ini.
{% 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 sisi kanan baris penerjemah ulang, lalu masukkan nomor pelat kendaraan seperti yang terdaftar di sisi Unigis. Klik **Simpan**.

Ulangi langkah ini dan langkah sebelumnya untuk setiap perangkat yang meneruskan ke Unigis. Konfigurasi penerjemah ulang dibagikan di seluruh akun, tetapi External ID diatur per perangkat.
{% endstep %}
{% endstepper %}

## Kelola penerusan

Untuk mengubah atau menghentikan penerusan ke Unigis:

* 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 barisnya, lalu edit untuk mengubah nama, alamat, atau kredensial. 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 Unigis, periksa hal-hal berikut secara berurutan:

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

Saat posisi tiba tetapi jumlahnya lebih sedikit dari yang diharapkan, itu adalah batas satu menit, bukan kesalahan. Unigis menerima sampel lintasan satu menit.


---

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