Unigis

The Unigis protocol is a vehicle location data forwarding protocol between Navixy and TMS platform developed by Unigis company. The most frequent use cases relate to real-time collection of GPS tracking and vehicle Telematics data by logistics departments of large manufacturing and retail chain companies. Most of these companies are located in the US, Mexico, Colombia, Chile, Argentina, Brazil and Spain.

Protocol Category: Enterprise Compliance

Table of contents

What is Unigis?

Through the Unigis data forwarding protocol, fleet GPS tracking data is streamlined across multiple servers, allowing data retransmission between Navixy and Unigis partners.

Using the Unigis protocol, users can integrate with self-service chains and/or suppliers of products and services within the Unigis network, such as Walmart, Home Depot, and Kimberly-Clark. Fleet data can be transmitted between all parties without requiring access to Navixy's platform.

Unigis general technical information

The Unigis protocol utilizes SOAP to send XML data from tracking devices to Unigis over HTTP as part of the OSI application layer. Data is pushed from the Navixy platform to Unigis every 5 minutes.

Data that’s sent to Unigis:

  • Date and time

  • Longitude

  • Latitude

  • Altitude

  • Speed

  • Inputs events

  • Door Open

  • Panic Button

  • Engine Off

  • Theft

  • External ID (License Plate)

Format: ASCII

Unigis Configuration

Setting up

To initiate data forwarding using the Unigis protocol from Navixy, you will need the following parameters:

Parameter
Explanation

Destination server address and port

URL of endpoint and port that is used by Ungis TMS. Most commonly: * Address: http://unigis2.unisolutions.com.ar/HUB/UNIGIS/MAPI/SOAP/GPS/Service.asmx * Port: 80

Login and password

Your Unigis login and password

External ID

License plate number of an individual vehicle

To set up data forwarding in the Unigis protocol:

  1. Open the device settings from the main menu by pressing the gear icon on the bottom left of the screen.

  2. Click the Data forwarding widget.

  3. Click Protocols.

  4. This will open a pop-up where you will input the required parameters by pressing the + button.

For the Unigis protocol, input the following information:

  1. Name: Enter a name to make this retranslator easily identifiable

  2. Protocol: Select the Unigis protocol from the dropdown

  3. Unigis login and password

  4. Destination server address, e.g. http://unigis2.unisolutions.com.ar/HUB/UNIGIS/MAPI/SOAP/GPS/Service.asmx

  5. Destination port, e.g. 80

A Retranslation management screen should look like the following, with Unigis login and password. Make sure the Enabled button is checked and click the Save button to complete the process.

Next, the retranslator will need to be linked to the device on the Unigis side. To do so, select the Link link image button in the data forwarding widget. Select the retranslator to be connected, and click Link below.

Next, add the ID of the device in the 3rd-party system either by clicking the pencil icon or the external ID field. This value should be the license plate number on the Unigis side. Select Save once completed.

Managing

To edit or stop data from being forwarded, please refer to the following steps:

  1. Select the Pencil icon or click in the associated box to edit the external ID used to point to the device on the 3rd party system.

  2. Click the Trash button to stop the data forwarding.

  3. Acknowledge the change in the pop-up.

  4. Click Protocols to change retranslator settings such as name, login information, or enabled status

  5. This will open the retranslator management window. Select the row to edit and either click the pencil in the top left or double-click the row in question to allow editing. Save any changes.

Troubleshooting

If data does not display on the 3rd-party Unigis system, please make sure that:

  • Username and password for Unigis are correctly entered

  • URL was entered correctly

  • Retranslator is enabled

  • External ID matches the license plate on Unigis

Last updated

Was this helpful?