> 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/pt-br/guide/devices-and-settings/connectivity/data-forwarding/unigis.md). # Unigis Encaminhe dados de GPS e telemática do Navixy para a plataforma Unigis TMS, enviando uma posição por minuto por veículo via HTTP. O Unigis é um sistema de gestão de transporte, e o protocolo de encaminhamento de dados do Unigis envia as posições dos veículos da Navixy para ele. Os departamentos de logística de empresas de manufatura e varejo o utilizam para receber dados de suas transportadoras, incluindo fornecedores de redes como Walmart, Home Garagem e Kimberly-Clark. Uma transportadora pode enviar dados ao Unigis sem conceder à empresa receptora acesso à conta da Navixy. A Unigis é mais comum em empresas dos Estados Unidos, México, Colômbia, Chile, Argentina, Brasil e Espanha. No Navixy, selecione **UNIGIS** em **Protocolo** menu suspenso. É assim que a Unigis é nomeada na interface. ## O que o Navixy envia Navixy envia uma solicitação HTTP POST por posição para o `LoginEInserirEvento` método do endpoint do Unigis. O corpo está codificado em Formulário e contém estes campos: | Campo | Conteúdo | | ------------------------------------ | ----------------------------------------------------------------------------------------------- | | `Usuário do sistema` Webhook `Senha` | As credenciais Unigis da configuração do retransmissor, enviadas com cada solicitação | | `Domínio` | O ID Externo do dispositivo, ou o id do dispositivo na Navixy quando o ID Externo estiver vazio | | `Código` | O código de evento da Navixy para esta mensagem | | `Latitud`, `Longitud`, `Altitud` | Posição em graus, altitude em metros | | `Velocidad` | Velocidade | | `Rumbo` | Rumo | | `DataHoraEvento` | Quando o dispositivo registrou a posição, em ISO 8601 | | `DataHoraRecepção` | Quando a Navixy recebeu a mensagem, em ISO 8601 | Eventos como um alarme de porta, um acionamento do Botão do pânico ou o desligamento do motor não são campos separados. Cada um chega como um valor em `Código` na mensagem que o reporta. O Unigis responde a cada solicitação com um código numérico. Um código negativo significa que o Unigis rejeitou a posição, e a Navixy encerra a conexão e tenta novamente. ### Quando a Navixy envia A Navixy envia no máximo uma posição por minuto por dispositivo. Quando um dispositivo reporta com mais frequência do que isso, as posições intermediárias são ignoradas em vez de enfileiradas, então os dados no Unigis são uma amostra de um minuto e não um trajeto completo. Duas regras anulam o limite de um minuto: * Um evento urgente é enviado assim que chega, mesmo que a posição anterior tenha sido enviada há menos de um minuto. * Uma mensagem sem coordenadas válidas nunca é enviada, independentemente do momento. ## Antes de começar Obtenha o seguinte do Unigis: * O endereço e a porta do endpoint. O Unigis opera vários hubs, então confirme qual se aplica à sua conta. * Seu login e senha do Unigis. A Navixy exige ambos e não salvará o retransmissor sem eles. Você também precisa da Placa conforme registrada no lado do Unigis, que vai no campo External ID de cada dispositivo. A Navixy aceita qualquer valor não vazio aqui, então uma placa que não corresponda ao registro do Unigis é aceita no momento de salvar e depois rejeitada pelo Unigis. ## Configurar encaminhamento {% stepper %} {% step %} ### Abra o bloco Encaminhamento de dados Dispositivos e configurações **na barra lateral esquerda.**, selecione um dispositivo e, em seguida, encontre o **Encaminhamento de dados** bloco. {% endstep %} {% step %} ### Abra a lista de protocolos Salvar **Protocolos**, depois clique em **+** para adicionar uma configuração. {% endstep %} {% step %} ### Insira as configurações do Unigis Preencha os campos da seguinte forma: * **Nome**: um rótulo que identifica este retransmissor * **Protocolo**: **UNIGIS** * **Endereço**: o endereço do endpoint do Unigis, por exemplo `http://unigis2.unisolutions.com.ar/HUB/UNIGIS/MAPI/SOAP/GPS/Service.asmx` * **Porta**: a porta do Unigis, normalmente `80` * **Login** Webhook **Senha**: suas credenciais do Unigis Quando você insere um endereço sem um caminho, a Navixy usa `/HUB/UNIGIS/MAPI/SOAP/COMMServer/service.asmx`. Insira o endereço completo que o Unigis forneceu a você, em vez de confiar neste padrão. {% endstep %} {% step %} ### Ative e salve Ative **Ativado**, depois clique em **para salvar o comando. Clique em**. Um retransmissor que não está ativado não envia nada. {% endstep %} {% step %} ### Vincule o retransmissor a um dispositivo No dispositivo **Encaminhamento de dados** bloco, ative o alternador do retransmissor que você criou e, em seguida, clique **para salvar o comando. Clique em**. {% endstep %} {% step %} ### Defina o ID externo Clique no ícone de link à direita da linha do retransmissor e, em seguida, insira a Placa conforme registrada no lado do Unigis. Clique **para salvar o comando. Clique em**. Repita esta etapa e a anterior para cada dispositivo que encaminha para a Unigis. A configuração do retransmissor é compartilhada entre a conta, mas o ID Externo é definido por dispositivo. {% endstep %} {% endstepper %} ## Gerenciar encaminhamento Para alterar ou interromper o encaminhamento para a Unigis: * Clique no ícone de link à direita da linha do retransmissor para alterar o ID externo de um dispositivo. * Desative o alternador para interromper o encaminhamento de um dispositivo e manter a configuração para os outros. * Salvar **Protocolos**, selecione a linha e edite-a para alterar o nome, o endereço ou as credenciais. A alteração se aplica a todos os dispositivos vinculados a este retransmissor. * Exclua a configuração da **Protocolos** lista para interromper o encaminhamento para todos os dispositivos. Confirme na caixa de diálogo. ## Solução de problemas Quando os dados não aparecerem na Unigis, verifique o seguinte na ordem: 1. O retransmissor está ativado e seu alternador está ligado para o dispositivo. 2. O login e a senha correspondem às suas credenciais da Unigis. A Navixy os envia com cada posição, então uma senha incorreta faz com que todas as solicitações falhem, e não apenas a primeira. 3. O endereço inclui o caminho completo fornecido pelo Unigis, e a porta está correta. 4. O ID Externo corresponde à Placa cadastrada no lado da Unigis. 5. O dispositivo informa coordenadas válidas. Posições sem um fix de GPS nunca são encaminhadas. Quando as posições chegam, mas em quantidade menor do que a esperada, isso é o limite de um minuto, e não uma falha. O Unigis recebe uma amostra de um minuto do trajeto. --- # 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/pt-br/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.