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

# ILSP

Teruskan posisi kendaraan dan alarm keamanan dari Navixy ke pusat pemantauan ILSP di Meksiko, menggunakan API JSON yang diautentikasi OAuth.

ILSP menyediakan layanan keamanan swasta di Meksiko, dan protokol Penerusan data ILSP mengirimkan posisi kendaraan dan alarm keamanan ke pusat pemantauannya. Perusahaan yang berbagi satu pusat pemantauan menggunakannya untuk memberi ILSP visibilitas atas kendaraan mereka, dan satu akun Navixy dapat meneruskan ke beberapa pelanggan ILSP sekaligus.

Di Navixy, pilih **ILSP** di **Protokol** menu tarik-turun.

## Apa yang dikirim Navixy

Navixy mengirim satu permintaan HTTP POST untuk setiap pesan ke `/CustomerServices/api/SetLastEvent`, dengan isi JSON yang memuat bidang berikut:

| Bidang                     | Isi                                                                                                                      |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `customerId`               | Nomor pelanggan, diambil dari bagian pertama External ID                                                                 |
| `transportLineId`          | Nomor jalur transportasi, diambil dari bagian ketiga External ID                                                         |
| `plates`                   | Pelat nomor, diambil dari bagian kedua External ID                                                                       |
| `generatedEvent`           | Kode peristiwa: `2` untuk SOS, `3` untuk kehilangan daya, `4` untuk alarm lembap GSM, dan `1` untuk setiap pesan lainnya |
| `generatedEventDate`       | Saat perangkat merekam pesan                                                                                             |
| `latitude` dan `longitude` | Posisi dalam derajat                                                                                                     |
| `speed`                    | Kecepatan                                                                                                                |
| `heading`                  | Arah perjalanan                                                                                                          |
| `odometer`                 | Jarak tempuh, dikirim hanya saat perangkat melaporkannya                                                                 |
| `battery`                  | Tingkat baterai, dikirim hanya saat perangkat melaporkannya                                                              |

### Saat Navixy mengirim

Navixy mengirim pesan saat memiliki posisi yang valid, atau saat melaporkan SOS, kehilangan daya, atau alarm lembap GSM. Alarm tetap dikirim meski tanpa posisi, sehingga ILSP menerima peringatan. Pesan lain tanpa posisi dilewati.

## Sebelum Anda mulai

Kumpulkan hal berikut dari ILSP:

* Alamat endpoint dan port. Alamatnya biasanya `https://www.ilspservices.com.mx/` pada port `443`.
* ID klien dan rahasia klien Anda. Navixy memerlukan keduanya dan tidak akan menyimpan retranslator tanpa keduanya.
* Nomor pelanggan, pelat nomor, dan nomor jalur transportasi untuk setiap kendaraan.

{% hint style="info" %}
ILSP melakukan autentikasi dengan OAuth, bukan dengan nama pengguna dan kata sandi. Masukkan ID klien di **Nama pengguna** kolom dan rahasia klien di **Kata sandi** kolom. Navixy meminta token sebelum mengirim data, dan memperbaruinya saat kedaluwarsa. Setelah lima permintaan token gagal, Navixy menonaktifkan retranslator, sehingga ID klien atau rahasia yang salah menghentikan penerusan, bukan mencoba lagi tanpa batas.
{% endhint %}

## 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 ILSP

Isi kolom sebagai berikut:

* **Nama**: label yang mengidentifikasi retranslator ini
* **Protokol**: **ILSP**
* **Alamat**: `https://www.ilspservices.com.mx/`
* **Port**: `443`
* **Nama pengguna**: ID klien ILSP Anda
* **Kata sandi**: rahasia klien ILSP Anda
  {% 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 tautkan di sebelah kanan baris retranslator, lalu masukkan tiga nilai yang mengidentifikasi kendaraan ini ke ILSP, yang digabungkan dengan karakter pipa:

```
customerId|licensePlate|transportLineId
```

Misalnya, `4821|ABC-123|17`. Ketiga bagian diperlukan. Nomor pelanggan dan nomor jalur transportasi harus berupa digit, dan pelat nomor dapat berisi huruf kapital, digit, dan tanda hubung.

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

## Kelola penerusan

Untuk mengubah atau menghentikan penerusan ke ILSP:

* 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 sistem ILSP, periksa hal berikut secara berurutan:

1. Retranslator diaktifkan, dan sakelarnya dinyalakan untuk perangkat.
2. ID klien dan rahasia klien sudah benar. Lima permintaan token yang gagal menonaktifkan retranslator, jadi perbaiki kredensialnya lalu **Diaktifkan** matikan dan nyalakan lagi.
3. Alamat dan port sudah benar.
4. External ID memiliki ketiga bagian dalam urutan yang benar, dipisahkan oleh tanda pipa, tanpa spasi di sekelilingnya.
5. Nomor pelanggan, pelat nomor, dan nomor jalur transportasi cocok dengan catatan di sisi ILSP.


---

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