> 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/unigis.md). # Unigis Envíe datos GPS y telemáticos desde Navixy a la plataforma TMS de Unigis, enviando una posición por minuto por vehículo mediante HTTP. Unigis es un sistema de gestión de transporte, y el protocolo de reenvío de datos de Unigis entrega las posiciones de los vehículos desde Navixy a este sistema. Los departamentos de logística de empresas de fabricación y venta minorista lo utilizan para recibir datos de sus transportistas, incluidos los proveedores de cadenas como Walmart, Home Garaje y Kimberly-Clark. Un transportista puede enviar datos a Unigis sin dar a la empresa receptora acceso a la cuenta de Navixy. Unigis es más común en empresas de Estados Unidos, México, Colombia, Chile, Argentina, Brasil y España. En Navixy, seleccione **UNIGIS** en la **Protocolo** desplegable. Así es como se denomina Unigis en la interfaz. ## Lo que envía Navixy Navixy envía una solicitud HTTP POST por posición a la `Iniciar sesión y insertar evento` método del endpoint de Unigis. El cuerpo está codificado como Formulario y contiene estos campos: | Campo | Contenido | | ------------------------------------ | ------------------------------------------------------------------------------------------------ | | `Usuario del sistema` y `Contraseña` | Las credenciales de Unigis de la configuración del retransmisor, enviadas con cada solicitud | | `Dominio` | El ID externo del dispositivo, o el ID del dispositivo de Navixy cuando el ID externo está vacío | | `Código` | El código de evento de Navixy para este mensaje | | `Latitud`, `Longitud`, `Altitud` | Posición en grados, altitud en metros | | `Velocidad` | Velocidad | | `Rumbo` | Rumbo | | `FechaHoraEvento` | Cuándo registró el dispositivo la posición, en ISO 8601 | | `FechaHoraRecepcion` | Cuando Navixy recibió el mensaje, en ISO 8601 | Los eventos, como una alarma de puerta, una pulsación del Botón de pánico o un apagado del motor, no son campos separados. Cada uno llega como un valor en `Código` el mensaje que lo reporta. Unigis responde a cada solicitud con un código numérico. Un código negativo significa que Unigis rechazó la posición, y Navixy cierra la conexión e intenta nuevamente. ### Cuando Navixy envía Navixy envía como máximo una posición por minuto por dispositivo. Cuando un dispositivo reporta con más frecuencia que eso, las posiciones intermedias se omiten en lugar de ponerse en cola, por lo que los datos en Unigis son una muestra de un minuto y no un recorrido completo. Dos reglas prevalecen sobre el límite de un minuto: * Un evento urgente se envía tan pronto como llega, incluso si la posición anterior se envió hace menos de un minuto. * Un mensaje sin coordenadas válidas nunca se envía, independientemente de cuándo ocurra. ## Antes de comenzar Recopile lo siguiente de Unigis: * La dirección y el puerto del endpoint. Unigis opera varios centros, así que confirme cuál corresponde a su cuenta. * Su usuario y contraseña de Unigis. Navixy requiere ambos y no guardará el retransmisor sin ellos. También necesita la Matrícula tal como está registrada en Unigis, la cual se coloca en el campo ID externo de cada dispositivo. Navixy acepta aquí cualquier valor no vacío, por lo que una matrícula que no coincida con el registro de Unigis se acepta al guardar y luego Unigis la rechaza. ## Configurar el reenvío {% stepper %} {% step %} ### Abra el bloque Reenvío de datos Vaya a **Dispositivos**, seleccione un dispositivo y luego encuentre el **Reenvío de datos** bloque. {% endstep %} {% step %} ### Abra la lista de protocolos Haga clic en **Protocolos**, luego haga clic en **+** para agregar una configuración. {% endstep %} {% step %} ### Introduzca la configuración de Unigis Complete los campos de la siguiente manera: * **Nombre**: una etiqueta que identifica este retransmisor * **Protocolo**: **UNIGIS** * **Dirección**: la dirección del endpoint de Unigis, por ejemplo `http://unigis2.unisolutions.com.ar/HUB/UNIGIS/MAPI/SOAP/GPS/Service.asmx` * **Puerto**: el puerto de Unigis, normalmente `80` * **Usuario** y **Contraseña**: sus credenciales de Unigis Cuando introduce una dirección sin una ruta, Navixy utiliza `/HUB/UNIGIS/MAPI/SOAP/COMMServer/service.asmx`. Ingrese la dirección completa que le proporcionó Unigis en lugar de confiar en este valor predeterminado. {% endstep %} {% step %} ### Habilite y guarde Active **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 **Reenvío de datos** bloque del dispositivo, active el interruptor del retransmisor que creó y luego haga clic en **Guardar**. {% endstep %} {% step %} ### Establezca el ID externo Haga clic en el ícono del enlace a la derecha de la fila del retransmisor, luego ingrese la Matrícula tal como está registrada en la parte de Unigis. Haga clic **Guardar**. Repita este paso y el anterior para cada dispositivo que reenvía a Unigis. 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 Unigis: * Haga clic en el ícono 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 conserve la configuración para 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 todos los dispositivos vinculados 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 Unigis, revise lo siguiente en este orden: 1. El retransmisor está habilitado y su interruptor está activado para el dispositivo. 2. El nombre de usuario y la contraseña coinciden con sus credenciales de Unigis. Navixy los envía con cada posición, por lo que una contraseña incorrecta hace que falle cada solicitud, no solo la primera. 3. La dirección incluye la ruta completa que Unigis le proporcionó, y el puerto es correcto. 4. El ID externo coincide con la Matrícula registrada en la parte de Unigis. 5. El dispositivo reporta coordenadas válidas. Las posiciones sin una fijación GPS nunca se reenvían. Cuando llegan posiciones pero hay menos de las esperadas, eso se debe al límite de un minuto y no a una falla. Unigis recibe una muestra de un minuto del recorrido. --- # 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/connectivity/data-forwarding/unigis.md?ask=&goal= ``` `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.