> 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/es/guide/devices-and-settings/connectivity/data-forwarding/ilsp.md).

# ILSP

Reenviar las posiciones de los vehículos y las alarmas de Seguridad desde Navixy a los centros de monitoreo de ILSP en México, usando una API JSON autenticada con OAuth.

ILSP ofrece servicios privados de Seguridad en México, y el protocolo de Reenvío de datos de ILSP entrega las posiciones de los vehículos y las alarmas de seguridad a sus centros de monitoreo. Las empresas que comparten un centro de monitoreo lo utilizan para darle a ILSP visibilidad de sus vehículos, y una cuenta de Navixy puede reenviar a varios clientes de ILSP al mismo tiempo.

En Navixy, seleccione **ILSP** en la **Protocolo** el menú desplegable.

## Lo que envía Navixy

Navixy envía una solicitud HTTP POST por cada mensaje a `/CustomerServices/api/SetLastEvent`, con un cuerpo JSON que contiene estos campos:

| Campo                            | Contenido                                                                                                                             |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `customerId`                     | El número de cliente, tomado de la primera parte de External ID                                                                       |
| `transportLineId`                | El número de la línea de transporte, tomado de la tercera parte de External ID                                                        |
| `Matrículas`                     | La Matrícula, tomada de la segunda parte de External ID                                                                               |
| `generatedEvent`                 | El código del evento: `2` para SOS, `3` para corte de alimentación, `4` para la alarma de humedad GSM y `1` para cada mensaje alterno |
| `Fecha de generación del evento` | Cuando el dispositivo registró el mensaje                                                                                             |
| `latitud` y `longitud`           | Posición en grados                                                                                                                    |
| `velocidad`                      | Velocidad                                                                                                                             |
| `rumbo`                          | Dirección de viaje                                                                                                                    |
| `odómetro`                       | Distancia recorrida, enviada solo cuando el dispositivo la reporta                                                                    |
| `batería`                        | Nivel de batería, enviado solo cuando el dispositivo lo reporta                                                                       |

### Cuando Navixy envía

Navixy envía un mensaje cuando tiene una posición válida, o cuando reporta un SOS, una pérdida de alimentación o una alarma de interferencia GSM. Una alarma se envía incluso sin una posición, por lo que ILSP recibe la alerta. Cualquier otro mensaje sin una posición se omite.

## Antes de comenzar

Recopile lo siguiente de ILSP:

* La dirección del endpoint y el puerto. La dirección suele ser `https://www.ilspservices.com.mx/` en el puerto `443`.
* Su ID de cliente y secreto de cliente. Navixy requiere ambos y no guardará el retransmisor sin ellos.
* El número de cliente, la matrícula y el número de línea de transporte de cada vehículo.

{% hint style="info" %}
ILSP se autentica con OAuth en lugar de con un nombre de usuario y una contraseña. Ingrese el ID de cliente en el **Usuario** campo y el secreto de cliente en el **Contraseña** campo. Navixy solicita un token antes de enviar datos y lo renueva cuando expira. Después de cinco solicitudes de token fallidas, Navixy deshabilita el retransmisor, por lo que un ID de cliente o secreto incorrecto detiene el reenvío en lugar de reintentar indefinidamente.
{% endhint %}

## Configurar el reenvío de datos

{% stepper %}
{% step %}

### Abra el bloque Reenvío de datos

Vaya a **Dispositivos**, seleccione un dispositivo y luego busque el **Reenvío de datos** .
{% endstep %}

{% step %}

### Abra la lista de protocolos

Haga clic en **Protocolos**, luego haga clic en **+** para agregar una configuración.
{% endstep %}

{% step %}

### Ingrese la configuración de ILSP

Complete los campos de la siguiente manera:

* **Nombre**: una etiqueta que identifica este retransmisor
* **Protocolo**: **ILSP**
* **Dirección**: `https://www.ilspservices.com.mx/`
* **Puerto**: `443`
* **Usuario**: su id de cliente de ILSP
* **Contraseña**: su secreto de cliente de ILSP
  {% endstep %}

{% step %}

### Habilitar y guardar

Actívelo **Habilitado**, luego haga clic en **Guardar**. Un retransmisor que no está habilitado no envía nada.
{% endstep %}

{% step %}

### Vincule el retransmisor a un dispositivo

En el bloque del dispositivo **Reenvío de datos** active el interruptor del retransmisor que creó y luego haga clic en **Guardar**.
{% endstep %}

{% step %}

### Establezca el ID externo

Haga clic en el icono de enlace a la derecha de la fila del retransmisor y luego ingrese los tres valores que identifican este vehículo en ILSP, separados por el carácter de barra vertical:

```
customerId|Matrícula|transportLineId
```

Por ejemplo, `4821|ABC-123|17`. Las tres partes son obligatorias. El número de cliente y el número de la línea de transporte deben ser dígitos, y la matrícula puede contener letras mayúsculas, dígitos y guiones.

Repita este paso y el anterior para cada dispositivo que reenvía a ILSP. La configuración del retransmisor se comparte en toda la cuenta, pero el ID externo se establece por dispositivo.
{% endstep %}
{% endstepper %}

## Administrar el reenvío

Para cambiar o detener el reenvío a ILSP:

* Haga clic en el icono de enlace a la derecha de la fila del retransmisor para cambiar el ID externo de un dispositivo.
* Desactive el interruptor para detener el reenvío de un dispositivo y conservar la configuración de los demás.
* Haga clic en **Protocolos**, seleccione la fila y edítela para cambiar el nombre, la dirección o las credenciales. El cambio se aplica a cada dispositivo vinculado a este retransmisor.
* Elimine la configuración de la **Protocolos** lista para detener el reenvío para todos los dispositivos. Confirme en el cuadro de diálogo.

## Solución de problemas

Cuando los datos no aparecen en el sistema ILSP, verifique lo siguiente en orden:

1. El retransmisor está habilitado y su interruptor está activado para el dispositivo.
2. El id de cliente y el secreto de cliente son correctos. Cinco solicitudes de token fallidas deshabilitan el retransmisor, así que corrija las credenciales y luego apáguelo **Habilitado** y vuelva a encenderlo.
3. La dirección y el puerto son correctos.
4. El ID externo tiene las tres partes en el orden correcto, separadas por barras verticales, sin espacios alrededor.
5. El número de cliente, la matrícula y el número de línea de transporte coinciden con los registros en 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/es/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.
