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

# SimpliRoute

Teruskan posisi kendaraan dari Navixy ke SimpliRoute melalui HTTP, menghubungkan data lokasi langsung ke pesanan pengiriman yang dikelola di SimpliRoute.

SimpliRoute adalah layanan manajemen rute pengiriman dan pesanan, dan protokol ini meneruskan posisi kendaraan dari Navixy ke sana. SimpliRoute mencocokkan setiap posisi dengan pesanan yang ditugaskan ke kendaraan tersebut, sehingga dispatcher dapat mengikuti pengiriman berdasarkan rute yang direncanakan. Layanan ini terutama digunakan di Amerika Latin.

Di Navixy, pilih **Rute Sederhana** di **Protokol** dropdown. Begitulah SimpliRoute dinamai di antarmuka.

## Apa yang dikirim Navixy

Navixy mengirim satu permintaan HTTP POST untuk setiap posisi, dengan isi JSON yang memuat bidang berikut:

| Bidang                     | Isi                                                                  |
| -------------------------- | -------------------------------------------------------------------- |
| `idVehiculo`               | VIN kendaraan yang terhubung ke perangkat                            |
| `patent`                   | Nomor registrasi kendaraan, dipersingkat seperti dijelaskan di bawah |
| `empresaProveedoraGps`     | Nomor pajak dari profil akun, yang mengidentifikasi penyedia GPS     |
| `acc`                      | Apakah pengapian menyala                                             |
| `latitude` dan `longitude` | Posisi dalam derajat                                                 |
| `speed`                    | Kecepatan                                                            |
| `datetime`                 | Saat perangkat merekam posisi                                        |

SimpliRoute merespons dengan `GPS ok.` saat menerima posisi.

{% hint style="warning" %}
Navixy mempersingkat nomor registrasi sebelum mengirimkannya: Navixy menghapus spasi dan tanda hubung, lalu mempertahankan enam karakter pertama. Pelat yang tercatat sebagai `ABC-1234` dikirim sebagai `ABC123`. Pastikan kendaraan didaftarkan di SimpliRoute dalam bentuk yang dipersingkat, atau SimpliRoute tidak akan mencocokkan posisi dengan kendaraan.
{% endhint %}

### Saat Navixy mengirim

Navixy mengirim setiap pesan yang memiliki posisi valid dan berusia kurang dari 15 hari. Pesan tanpa posisi dilewati. Begitu juga pesan yang berusia lebih dari 15 hari, yang dapat dikirim perangkat setelah menyimpan data secara luring dalam jangka waktu lama.

External ID tidak digunakan oleh protokol ini. Sebagai gantinya, Navixy mengidentifikasi kendaraan melalui VIN dan nomor registrasinya.

## Sebelum Anda mulai

Protokol ini membaca data kendaraan dan akun, bukan mengambilnya dari konfigurasi retranslator. Ketiga hal berikut harus tersedia, jika tidak retranslator tidak mengirim apa pun sama sekali:

* Sebuah **nomor pajak** pada profil akun. SimpliRoute menggunakannya untuk mengidentifikasi penyedia GPS.
* Sebuah **kendaraan** yang terhubung ke perangkat, dibuat di [Armada](/docs/user/id/guide/fleet-management/vehicles.md).
* Sebuah **VIN** dan sebuah **nomor registrasi** pada kendaraan tersebut.

Pastikan ketiganya sebelum Anda membuat retranslator. Jika salah satunya tidak ada, penerusan gagal tanpa pemberitahuan: tidak ada kesalahan di **Penerusan data** blok, dan tidak ada data yang mencapai SimpliRoute.

Anda juga memerlukan alamat endpoint dan port dari SimpliRoute.

## Setelan penerusan

{% stepper %}
{% step %}

### Periksa data kendaraan dan akun

Konfirmasikan nomor pajak pada profil akun, dan konfirmasikan bahwa perangkat terhubung ke kendaraan yang memiliki VIN dan nomor registrasi.
{% endstep %}

{% step %}

### Buka blok Penerusan data

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

{% step %}

### Buka daftar protokol

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

{% step %}

### Buka pengaturan SimpliRoute

Isi kolom sebagai berikut:

* **Nama**: label yang mengidentifikasi retranslator ini
* **Protokol**: **Rute Sederhana**
* **Alamat**: alamat endpoint dari SimpliRoute
* **Port**: port dari SimpliRoute, biasanya `443`

Protokol ini tidak menggunakan login atau kata sandi. Biarkan kedua bidang kosong.
{% 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**. Biarkan External ID kosong, karena protokol ini tidak menggunakannya.
{% endstep %}
{% endstepper %}

## Kelola penerusan

Untuk mengubah atau menghentikan penerusan ke SimpliRoute:

* Matikan toggle di **Penerusan data** blok untuk menghentikan penerusan bagi satu perangkat, dan pertahankan konfigurasi untuk perangkat lain.
* Klik **Protokol**, pilih barisnya, lalu edit untuk mengubah nama, alamat, atau port. Perubahan diterapkan ke 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 SimpliRoute, periksa hal berikut secara berurutan:

1. Retranslator diaktifkan, dan sakelarnya dinyalakan untuk perangkat.
2. Profil akun memiliki nomor pajak.
3. Perangkat terhubung ke kendaraan, dan kendaraan tersebut memiliki VIN dan nomor registrasi. Nilai yang hilang di sini menghentikan penerusan tanpa kesalahan yang terlihat.
4. Kendaraan terdaftar di SimpliRoute dengan nomor registrasi yang dipersingkat, dengan spasi dan tanda hubung dihapus serta hanya enam karakter pertama yang dipertahankan.
5. Alamat dan port sudah benar.
6. Perangkat melaporkan koordinat yang valid.


---

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