> 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 Reenvíe los datos de GPS y telemática desde Navixy a la plataforma Unigis TMS, 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 hacia él. Los Departamentos de logística en empresas de fabricación y de retail lo usan para recibir datos de sus transportistas, incluidos proveedores de cadenas como Walmart, Home Depot 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 cada posición a la `Iniciar sesión y insertar evento` método del endpoint de Unigis. El cuerpo está codificado en 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 | | `Fecha y hora del evento` | Cuando el dispositivo registró la posición, en ISO 8601 | | `Fecha y hora de recepción` | 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 y vuelve a intentarlo. ### Cuando Navixy envía Navixy envía como máximo una posición por minuto por dispositivo. Cuando un dispositivo reporta con mayor frecuencia que esa, las posiciones intermedias se omiten en lugar de quedar en cola, por lo que los datos en Unigis son una muestra de un minuto y no un recorrido completo. Dos reglas anulan 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, sin importar el momento. ## Antes de comenzar Recopile lo siguiente de Unigis: * La dirección y el puerto del punto de conexión. Unigis opera varios centros, así que confirme cuál corresponde a su cuenta. * Su usuario y contraseña de Unigis. Navixy necesita ambos y no guardará el retransmisor sin ellos. También necesita la Matrícula tal como está registrada del lado de Unigis, la cual va en el campo ID externo de cada dispositivo. Navixy acepta aquí cualquier valor que no esté vacío, así 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 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 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 ingrese una dirección sin una ruta, Navixy usa `/HUB/UNIGIS/MAPI/SOAP/COMMServer/service.asmx`. Ingrese la dirección completa que Unigis le proporcionó en lugar de confiar en este valor predeterminado. {% 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, luego ingrese la Matrícula tal como está registrada del lado de Unigis. Haga clic **Guardar**. Repita este paso y el anterior para cada dispositivo que reenvíe 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 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 Unigis, revise lo siguiente en este orden: 1. El retransmisor está habilitado y su interruptor está activado para el dispositivo. 2. El 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 fallar cada solicitud y 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 Unigis. 5. El dispositivo reporta coordenadas válidas. Las posiciones sin solución GPS nunca se reenvían. Cuando las posiciones llegan pero son menos de las esperadas, eso corresponde al límite de un minuto, 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 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/unigis.md?ask=&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.