# Navixy Web Service

{% hint style="info" %}
**Categoría de protocolo:** Protocolo de consolidación de datos
{% endhint %}

#### Índice

1. [¿Qué es Navixy Web Service?](#what-is-ws)
2. [Información técnica sobre Navixy Web Service](#tech-info-ws)
3. [Configuración de Navixy Web Service](#ws-config)
4. [Configuración](#setting-up)
5. [Gestión](#managing)
6. [Solución de problemas](#troubleshooting)

### ¿Qué es Navixy Web Service?

**Navixy Web Service** El protocolo de reenvío de datos transmite los datos de la flota desde el sistema Navixy a cualquier sistema de terceros. El protocolo es flexible, lo que permite a terceros almacenar los datos de la flota en sus bases de datos para utilizarlos con cualquier propósito o mostrar los datos en recursos web.

Dado que este protocolo de reenvío de datos es independiente de la plataforma, sería la opción ideal para cualquier socio que trabaje con archivos XML.

### Información técnica general de Navixy Web Service

El protocolo Navixy Web Service utiliza SOAP para permitir la extracción de datos XML de los dispositivos de seguimiento como parte de la capa de aplicación del modelo OSI. Los datos se extraen bajo demanda.

Campos de datos que se envían:

* `dateGPS`: Fecha y hora en UTC
* `ignition`: Estado booleano del encendido
* `latitude`
* `longitude`
* `speedGPS`: km/h
* `unitPlate`: Matrícula
* `altitude`: Metros
* `course`: Dirección del vehículo, por ejemplo: **N,S,E,O,NO,NE,SO,SE**
* `deviceId`: IMEI
* `numSat`: Número de satélites GNSS que utiliza el dispositivo
* `odometer`: Distancia recorrida en km
* `eventId`: el código del evento según el [ID de evento de Navixy Generic Protocol](https://www.navixy.com/docs/iot-logic-api/technologies/navixy-generic-protocol/navixy-generic-protocol-10/predefined-event-identifiers)

### Configuración de Navixy Web Service

#### Configuración

Para configurar el reenvío de datos en el protocolo Navixy Web Service:

1. Vaya a **Dispositivos y ajustes** desde la barra lateral izquierda.
2. Seleccione el dispositivo necesario de la **Objetos** lista.
3. Busque el **Reenvío de datos** bloque, expándalo y haga clic en <img src="/files/289b3e35f168990fa06a5543f515a91b81d6a780" alt="" data-size="line">.
4. En la ventana que se abre, haga clic en "+" para añadir una nueva retransmisión.
5. En el cuadro de diálogo **Nuevo protocolo de retransmisión** introduzca la información requerida. Para el protocolo Navixy Web Service, rellene los siguientes campos:

<table><thead><tr><th width="187.8182373046875">Parámetro</th><th>Explicación</th></tr></thead><tbody><tr><td>Nombre</td><td>Una etiqueta descriptiva para identificar esta configuración del protocolo de retransmisión. Introduzca un nombre para que este retransmisor sea fácilmente identificable.</td></tr><tr><td>Protocolo e inicio de sesión</td><td>El protocolo de comunicación utilizado para la retransmisión. Seleccione <strong>Navixy Web Service</strong> en el menú desplegable.</td></tr><tr><td>Dirección</td><td>La URL o la dirección IP del servidor de destino.<br><strong>Nota</strong>: No se utiliza con Navixy Web Service, introduzca cualquier formato de dirección válido.</td></tr><tr><td><strong>Puerto</strong></td><td>El puerto de red para conectarse al servidor de destino.<br><strong>Nota</strong>: No se utiliza con Navixy Web Service, introduzca cualquier número de puerto.</td></tr><tr><td>Inicio de sesión</td><td>Un identificador único para esta conexión de retransmisor. Introduzca cualquier inicio de sesión que no esté siendo utilizado ya por otro retransmisor en su sistema.</td></tr><tr><td>Contraseña</td><td>Código de autenticación para esta conexión de retransmisor. Introduzca una contraseña única para proteger esta configuración del retransmisor.</td></tr></tbody></table>

6. Active el **Enabled** interruptor para activar la retransmisión de datos. El retransmisor no transmitirá ningún dato mientras esté deshabilitado.
7. La **Gestión de retransmisión** la pantalla debería parecerse a lo siguiente, con el inicio de sesión y la contraseña de Navixy Web Service. Asegúrese de que el estado sea **Activo** si desea que este retransmisor envíe datos.\
   ![](/files/6d2ed2661de58f364e653e48432f9841ca732593)
8. A continuación, será necesario vincular el retransmisor al dispositivo. Para hacerlo, active el interruptor con el nombre del retransmisor necesario en el **Reenvío de datos** bloque. External ID no es necesario para el protocolo Navixy Web Service.\
   ![](/files/9be788fce27f597b00ff1892dfe4c772e7eb9b49)

{% hint style="success" %}
Ha creado y habilitado correctamente un nuevo protocolo de retransmisión para este dispositivo. Ahora el retransmisor está disponible para todos los dispositivos de la cuenta; puede habilitarlo cambiando el interruptor en la configuración de otros dispositivos.
{% endhint %}

#### Acceso externo:

Parámetros requeridos:

* **Inicio de sesión y contraseña**: Deben coincidir con las credenciales que configuró en la configuración del retransmisor
* **deviceIDs**: Máx. 100
* **startDate** y **endDate**: Por ejemplo, del 9 de septiembre de 2022 a las 00:00 UTC hasta las 11:59:59
  * UTC: 2022-09-01T00:00:00Z a 2022-09-01T11:59:59Z

La descripción del protocolo en WSDL se puede encontrar a continuación, en relación con la ubicación del servidor:

UE <https://soap.navixy.com/LocationDataService?wsdl>

EE. UU. <https://soap.us.navixy.com/LocationDataService?wsdl>

Debe realizarse una solicitud SOAP utilizando una de las páginas WSDL anteriores. La propia solicitud XML es la siguiente, sustituyéndola por la información asociada:

{% code overflow="wrap" %}

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org">

   <soapenv:Header>
   <tem:authentication>
     <login>username</login>
     <password>password</password>
   </tem:authentication>
   </soapenv:Header>
   <soapenv:Body>
   <tem:dataRequest>
      <!--1 to 100 repetitions:-->
      <deviceIds>IMEI of device</deviceIds>
      <startDate>2022-08-30T00:00:00Z</startDate>
      <endDate>2022-08-31T00:00:00Z</endDate>
   </tem:dataRequest>
   </soapenv:Body>
</soapenv:Envelope>
```

{% endcode %}

Una respuesta de ejemplo podría verse así:

```xml
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns:getLocationDataResponse xmlns:ns="http://tempuri.org">
            <result>
                <dateGps>2019-10-15T08:48:50.000Z</dateGps>
                <ignition>false</ignition>
                <latitude>75.9270866</latitude>
                <longitude>-85.5207616</longitude>
                <speedGps>0.0</speedGps>
                <unitPlate>JRT1550</unitPlate>
                <altitude>284.0</altitude>
                <course>N</course>
                <deviceId>866258048802349</deviceId>
                <numSat>15</numSat>
                <odometer>59845</odometer>
                <eventId>401</eventId>
            </result>
        </ns:getLocationDataResponse>
    </S:Body>
</S:Envelope>
```

#### Gestión

Para editar o detener el reenvío de datos, siga estos pasos:

1. En cualquier **Reenvío de datos** bloque, haga clic en <img src="/files/36bd02675916b5039b42494475f1e4225d48d57d" alt="" data-size="line"> para abrir la lista de protocolos disponibles.
2. Haga clic en <img src="/files/52f1b8d267569f2ca94ee4fb372ab7bec033cfa3" alt="" data-size="line"> para cambiar la configuración del retransmisor, como el nombre, la información de acceso o el estado habilitado.
3. Haga clic en <img src="/files/8d8d66748f54ce489b2f516414f95ebbcb0a10da" alt="" data-size="line"> y confirme para eliminar un retransmisor

Todos los cambios se guardan automáticamente.

{% hint style="info" %}
Para habilitar/deshabilitar un retransmisor para un determinado dispositivo, cambie el interruptor con el nombre del retransmisor necesario en la **Reenvío de datos** .
{% endhint %}

#### Solución de problemas

Para verificar y probar su solicitud SOAP a la plataforma, se recomienda utilizar SoapUI, que puede encontrar aquí: <https://www.soapui.org/downloads/soapui/>

1. Instale Soap UI
2. Desde el menú Archivo, seleccione “New SOAP Project”
3. Pegue la ruta correcta en el campo WSDL según el servidor y seleccione **¿Crear solicitudes de ejemplo para todas las operaciones?**
4. EE. UU.: <https://soap.us.navixy.com/LocationDataService?wsdl>
5. UE: <https://soap.navixy.com/LocationDataService?wsdl>


---

# Agent Instructions: 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:

```
GET https://navixy.com/docs/user/es/guide/devices-and-settings/data-forwarding/navixy-ws.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.