> 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 dengan pesanan pengiriman yang dikelola di SimpliRoute.

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

Di Navixy, pilih **Rute Sederhana** di **Protokol** menu tarik turun. Begitulah nama SimpliRoute di antarmuka.

## Apa yang dikirim Navixy

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

| Bidang                     | Isi                                                                 |
| -------------------------- | ------------------------------------------------------------------- |
| `idVehiculo`               | VIN kendaraan yang terhubung ke perangkat                           |
| `patent`                   | Nomor registrasi kendaraan, dipendekkan 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 memendekkan nomor registrasi sebelum mengirimkannya: Navixy menghapus spasi dan tanda hubung, lalu hanya menyisakan enam karakter pertama. Nomor pelat yang tercatat sebagai `ABC-1234` dikirim sebagai `ABC123`. Pastikan kendaraan terdaftar di SimpliRoute menggunakan bentuk yang dipendekkan, 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. Demikian pula pesan yang lebih tua dari 15 hari, yang dapat dikirim perangkat setelah menyimpan data secara luring dalam waktu lama.

External ID tidak digunakan oleh protokol ini. Navixy mengidentifikasi kendaraan melalui VIN dan nomor registrasi, bukan melalui itu.

## Sebelum memulai

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

* Sebuah **nomor pajak** di 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.

Konfirmasikan ketiganya sebelum Anda membuat retranslator. Jika salah satunya tidak ada, penerusan gagal secara diam-diam: tidak ada kesalahan pada **Penerusan data** blokir, dan tidak ada data yang mencapai SimpliRoute.

Anda juga memerlukan alamat endpoint dan port dari SimpliRoute.

## Siapkan penerusan

{% stepper %}
{% step %}

### Periksa data kendaraan dan akun

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

{% 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 rute sederhana

Isi kolom-kolom 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 kolom kosong.
{% 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**. Biarkan ID eksternal 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 untuk satu perangkat, dan simpan konfigurasi untuk perangkat lainnya.
* Klik **Protokol**, pilih barisnya, lalu edit untuk mengubah nama, alamat, atau port. Perubahan diterapkan ke setiap perangkat yang terhubung ke retranslator ini.
* Hapus konfigurasi dari **Protokol** daftar untuk menghentikan penerusan untuk semua perangkat. Konfirmasikan di dialog.

## Pemecahan masalah

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

1. Retranslator diaktifkan, dan togglenya 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 disingkat, dengan spasi dan tanda hubung dihapus dan 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 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/simpliroute.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.