> 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 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 **Protocol** menu tarik-turun.

## Apa yang dikirim Navixy

Navixy mengirim satu permintaan HTTP POST per pesan ke `/CustomerServices/api/SetLastEvent`dengan isi JSON yang memuat kolom berikut:

| Kolom                      | 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 redaman 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 yang ditempuh, hanya dikirim ketika perangkat melaporkannya                                                         |
| `battery`                  | Tingkat baterai, hanya dikirim ketika perangkat melaporkannya                                                             |

### Saat Navixy mengirim

Navixy mengirim pesan ketika memiliki posisi yang valid, atau ketika melaporkan SOS, kehilangan daya, atau alarm redaman GSM. Alarm dikirim bahkan tanpa posisi, sehingga ILSP menerima peringatan tersebut. Pesan lain apa pun tanpa posisi akan dilewati.

## Sebelum 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 retranslasi 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 kolom **Login** dan rahasia klien di kolom **Password** Navixy meminta token sebelum mengirim data, dan memperbaruinya saat kedaluwarsa. Setelah lima permintaan token gagal, Navixy menonaktifkan retranslasi, sehingga ID klien atau rahasia yang salah akan menghentikan penerusan, bukan mencoba lagi tanpa batas.
{% endhint %}

## Atur penerusan

{% stepper %}
{% step %}

### Buka blok Penerusan data

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

{% step %}

### Buka daftar protokol

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

{% step %}

### Masukkan pengaturan ILSP

Isi kolom sebagai berikut:

* **Nama**: label yang mengidentifikasi retranslasi ini
* **Protocol**: **ILSP**
* **Alamat**: `https://www.ilspservices.com.mx/`
* **Port**: `443`
* **Login**: ID klien ILSP Anda
* **Password**: rahasia klien ILSP Anda
  {% endstep %}

{% step %}

### Aktifkan dan simpan

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

{% step %}

### Hubungkan retranslasi ke perangkat

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

{% step %}

### Atur External ID

Klik ikon tautan di sisi kanan baris retranslasi, 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 wajib ada. Nomor pelanggan dan nomor jalur transportasi harus berupa digit, dan pelat nomor boleh berisi huruf kapital, digit, dan tanda hubung.

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

## Kelola penerusan

Untuk mengubah atau menghentikan penerusan ke ILSP:

* Klik ikon tautan di sisi kanan baris retranslasi untuk mengubah External ID suatu perangkat.
* Matikan sakelar untuk menghentikan penerusan bagi satu perangkat, dan pertahankan konfigurasi untuk perangkat lainnya.
* Klik **Protocols**, pilih barisnya, lalu edit untuk mengubah nama, alamat, atau kredensial. Perubahan tersebut berlaku untuk setiap perangkat yang terhubung ke retranslasi ini.
* Hapus konfigurasi dari **Protocols** daftar untuk menghentikan penerusan bagi semua perangkat. Konfirmasikan di dialog.

## Pemecahan masalah

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

1. Retranslasi diaktifkan, dan sarkelarnya dinyalakan untuk perangkat.
2. ID klien dan rahasia klien sudah benar. Lima permintaan token yang gagal menonaktifkan retranslasi, jadi perbaiki kredensial lalu **Enabled** matikan dan nyalakan lagi.
3. Alamat dan port sudah benar.
4. External ID memiliki ketiga bagian dalam urutan yang benar, dipisahkan oleh karakter pipa, tanpa spasi di sekelilingnya.
5. Nomor pelanggan, pelat nomor, dan nomor jalur transportasi sesuai 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 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/ilsp.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.
