> 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/data-forwarding/navixy-ws.md).

# Navixy Web Service

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

#### Tabla de contenido

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. [Administración](#managing)
6. [Solución de problemas](#troubleshooting)

### ¿Qué es Navixy Web Service?

**Navixy Web Service** El protocolo de reenvío de datos transmite datos de flota desde el sistema Navixy a cualquier sistema de terceros. El protocolo es flexible, lo que permite a terceros almacenar datos de flota en sus bases de datos para utilizarlos con cualquier fin 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 de encendido booleano
* `latitud`
* `longitud`
* `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 el dispositivo está utilizando
* `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** la barra lateral izquierda.
2. Seleccione el dispositivo necesario de **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 agregar una nueva retransmisión.
5. En el **Nuevo protocolo de retransmisión** diálogo, introduzca la información requerida. Para el protocolo Navixy Web Service, complete 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 de 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 dirección IP del servidor de destino.<br><strong>Nota</strong>: No se utiliza en 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 en Navixy Web Service; introduzca cualquier número de puerto.</td></tr><tr><td>Usuario</td><td>Un identificador único para esta conexión de retransmisión. Introduzca cualquier usuario que no esté ya en uso por otro retransmisor en su sistema.</td></tr><tr><td>Contraseña</td><td>Código de autenticación para esta conexión de retransmisión. Introduzca una contraseña única para proteger esta configuración de retransmisión.</td></tr></tbody></table>

6. Active el **Habilitado** interruptor para activar la retransmisión de datos. El retransmisor no transmitirá ningún dato mientras esté deshabilitado.
7. El **Gestión del retransmisor** La pantalla debería parecerse a la siguiente, con el usuario 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 ello, active el interruptor con el nombre del retransmisor necesario en el **Reenvío de datos** bloque. No se necesita ID externo 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 activando el interruptor en los ajustes de otros dispositivos.
{% endhint %}

#### Acceso externo:

Parámetros requeridos:

* **Usuario y contraseña**: Estos deben coincidir con las credenciales que configuró en la configuración del retransmisor
* **deviceIDs**: Máximo 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 to 2022-09-01T11:59:59Z

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

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

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

Se debe realizar una solicitud SOAP utilizando una de las páginas WSDL anteriores. La propia solicitud XML es la siguiente, reemplazada con 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 puede 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>
```

#### Administració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 inicio de sesión 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 o deshabilitar un retransmisor para un dispositivo determinado, active o desactive el interruptor con el nombre del retransmisor necesario en los ajustes del dispositivo **Reenvío de datos** .
{% endhint %}

#### Solución de problemas

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

1. Instale Soap UI
2. En 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. US: <https://soap.us.navixy.com/LocationDataService?wsdl>
5. EU: <https://soap.navixy.com/LocationDataService?wsdl>


---

# 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/es/guide/devices-and-settings/data-forwarding/navixy-ws.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.