> 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 telemetria do Navixy para a plataforma TMS Unigis, enviando uma posição por minuto por veículo via HTTP. A Unigis é um sistema de gestão de transporte, e o protocolo de Encaminhamento de dados da Unigis envia as posições dos veículos da Navixy para ele. Departamentos de logística de empresas de manufatura e varejo usam-no para receber dados de suas transportadoras, incluindo fornecedores de redes como Walmart, Home Garagem e Kimberly-Clark. Uma transportadora pode enviar dados à Unigis sem conceder à empresa destinatária acesso à conta da Navixy. A Unigis é mais comum entre empresas nos Estados Unidos, México, Colômbia, Chile, Argentina, Brasil e Espanha. Na Navixy, selecione **UNIGIS** em **Protocolo** lista suspensa. É assim que a Unigis é denominada na interface. ## O que a Navixy envia A Navixy envia uma solicitação HTTP POST por posição para o `LoginYInsertarEvento` método do endpoint da Unigis. O corpo é codificado como formulário e contém estes campos: | Campo | Conteúdo | | ----------------------------------- | ----------------------------------------------------------------------------------------------- | | `SystemUser` e `Senha` | As credenciais da Unigis da configuração do retransmissor, enviadas com cada solicitação | | `Dominio` | O ID Externo do dispositivo, ou o ID do dispositivo na Navixy quando o ID Externo estiver vazio | | `Codigo` | O código de evento da Navixy para esta mensagem | | `Latitude`, `Longitude`, `Altitude` | Posição em graus, altitude em metros | | `Velocidade` | Velocidade | | `Rumo` | 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 `Codigo` 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 fecha 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; assim, 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 Colete o seguinte do Unigis: * O endereço do ponto de extremidade e a porta. 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 cadastrada no lado do Unigis, e ela vai no campo ID Externo 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 o encaminhamento {% stepper %} {% step %} ### Abrir o bloco de Encaminhamento de dados Acesse **Dispositivos e configurações**, selecione um dispositivo e localize o **Encaminhamento de dados** bloco. {% endstep %} {% step %} ### Abrir a lista de protocolos Clique em **Protocolos**, e depois clique em **+** para adicionar uma configuração. {% endstep %} {% step %} ### Informe 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, geralmente `80` * **Login** e **Senha**: suas credenciais do Unigis Quando você insere um endereço sem um caminho, a Navixy usa `/HUB/UNIGIS/MAPI/SOAP/COMMServer/service.asmx`. Digite o endereço completo que o Unigis forneceu para você em vez de confiar nesse padrão. {% endstep %} {% step %} ### Ativar e salvar Ligar **Ativado**, e depois clique em **Salvar**. Um retransmissor que não está ativado não envia nada. {% endstep %} {% step %} ### Vincular o retransmissor a um dispositivo No **Encaminhamento de dados** bloco do dispositivo, ative a chave do retransmissor que você criou e, em seguida, clique em **Salvar**. {% endstep %} {% step %} ### Definir 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 **Salvar**. Repita esta etapa e a anterior para cada dispositivo que encaminha para o Unigis. A configuração do retransmissor é compartilhada pela conta, mas o ID externo é definido por dispositivo. {% endstep %} {% endstepper %} ## Gerenciar o encaminhamento Para alterar ou interromper o encaminhamento para o Unigis: * Clique no ícone de link à direita da linha do retransmissor para alterar o ID externo de um dispositivo. * Desative a chave para interromper o encaminhamento de um dispositivo e manter a configuração dos demais. * Clique em **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 aparecem no Unigis, verifique o seguinte em ordem: 1. O retransmissor está ativado e sua chave está ligada para o dispositivo. 2. O login e a senha correspondem às suas credenciais do Unigis. A Navixy os envia com cada posição, portanto uma senha incorreta falha em todas as solicitações, e não apenas na primeira. 3. O endereço inclui o caminho completo fornecido pelo Unigis e a porta está correta. 4. O ID externo corresponde à Placa registrada no lado do Unigis. 5. O dispositivo envia coordenadas válidas. Posições sem fix de GPS nunca são encaminhadas. Quando as posições chegam, mas em quantidade menor 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 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/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 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.