Setting up the ABAX integration

Setting up the ABAX integration

The ABAX integration requires that you contact Telaris for activation. You must have an active ABAX account with API access. This guide describes the setup.

TABLE OF CONTENTS

• Prerequisites
• Step by step
• Drivers and consent
• Vehicles
• Settings
• Access and permissions

Prerequisites

• Active ABAX account (test or production environment) with API access.
• Two products in Telaris: one for mileage (price per km) and one for expenses (parking, tolls, ferry).
• Drivers created as personnel in Telaris (the same email as the ABAX user gives an automatic link at first import).
• Vehicles created as tags in Telaris under a dedicated tag type, with the registration number as the tag name (an exact match is used for automatic linking).
• Drivers must have given consent for driving data to be retrieved from ABAX and used in Telaris (obtained by the customer).

Step by step

1. Go to Administration → Integrations in Telaris.
2. Find ABAX in the list and click to open the settings.
3. Select Environment (test for testing, prod for production data).
4. Connect to ABAX – either via OAuth («Authenticate», log in with the ABAX account and approve access), or via Client Credentials (enter the ID and secret created at ABAX; requires no user login).
5. Set the Trip Product – the product for mileage lines. The price should be set per kilometre. Required.
6. Set the Cost Product – the product for expense lines.
7. Set the Vehicle tag type (Tag Type) – the tag type you have created for vehicles. Vehicles from ABAX are matched automatically against tags of this type based on registration number.
8. Optional: add trip administrators – personnel who should be able to see all drivers' trips.
9. Save, and let the first import run (automatically every hour, or trigger it manually by opening the driving log tab on an order).
10. After the first import, drivers and vehicles appear in the tables in the setup. Verify links and tick consent (see below).

After activation, the driving log tab becomes available on all orders.

Drivers and consent

Drivers are discovered automatically at import. New drivers are added with consent denied. If the email address matches a person in the personnel register, the link is set automatically. In the driver table (Administration → Integrations → ABAX), the administrator can select the correct person and tick «Consent / Samtykke» to activate import of the driver's trips.

NOTE: The consent checkbox is a technical switch that controls whether Telaris imports trips for the driver. It is the customer's (administrator's) responsibility to ensure that the driver has actually consented to the registration and use of GPS and driving data before the checkbox is set. The responsibility for processing personal data from ABAX lies with the customer, not with Telaris.

Vehicles

Vehicles are discovered automatically at import. For new vehicles, Telaris looks up tags of the selected vehicle tag type where the tag name is identical to the registration number from ABAX:

• If there is exactly one match, the link is set automatically.
• If there are several matches, or no match, no automatic link is set. Then the administrator links the tag manually in the vehicle table.

The vehicle table shows ABAX ID, alias, registration number and linked tag.

Settings

Access and permissions