Konfigurera ABAX-integrationen

Konfigurera ABAX-integrationen


ABAX-integrationen kräver att man kontaktar Telaris för aktivering. Man måste ha ett aktivt ABAX-konto med API-åtkomst. Den här vägledningen beskriver konfigurationen.



INNEHÅLLSFÖRTECKNING



Förutsättningar


  • Aktivt ABAX-konto (test- eller produktionsmiljö) med API-åtkomst.
  • Två produkter i Telaris: en för körsträcka (pris per km) och en för utgifter (parkering, vägtull, färja).
  • Förare skapade som personal i Telaris (samma e-post som ABAX-användaren ger automatisk koppling vid första importen).
  • Fordon skapade som objekt i Telaris under en dedikerad objekttyp, med registreringsnumret som objektets namn (exakt matchning används för automatisk koppling).
  • Förare måste ha gett samtycke till att kördata hämtas från ABAX och används i Telaris (inhämtas av kunden).



Steg för steg


  1. Gå till Administration → Integrationer i Telaris.
  2. Hitta ABAX i listan och klicka för att öppna inställningarna.
  3. Välj Miljö (test för testning, prod för produktionsdata).
  4. Anslut till ABAX – antingen via OAuth («Autentisera», logga in med ABAX-kontot och godkänn åtkomsten), eller via Client Credentials (fyll i ID och hemlighet skapad hos ABAX; kräver ingen användarinloggning).
  5. Ange Reseprodukt (Trip Product) – produkten för körsträckerader. Priset bör vara satt per kilometer. Obligatoriskt.
  6. Ange Kostnadsprodukt (Cost Product) – produkten för utgiftsrader.
  7. Ange Fordonsobjekttyp (Tag Type) – objekttypen du har skapat för fordon. Fordon från ABAX matchas automatiskt mot objekt av denna typ baserat på registreringsnummer.
  8. Valfritt: lägg till reseadministratörer – personal som ska kunna se alla förares resor.
  9. Spara, och låt den första importen köra (automatiskt varje timme, eller utlös den manuellt genom att öppna körjournalfliken på en order).
  10. Efter den första importen dyker förare och fordon upp i tabellerna i konfigurationen. Verifiera kopplingar och kryssa i samtycke (se nedan).

Efter aktivering blir körjournalfliken tillgänglig på alla order.




Förare och samtycke


Förare upptäcks automatiskt vid import. Nya förare läggs in med samtycke nekat. Matchar e-postadressen en person i personalregistret sätts kopplingen automatiskt. I förartabellen (Administration → Integrationer → ABAX) kan administratören välja rätt person och kryssa i «Consent / Samtykke» för att aktivera import av förarens resor.



OBS: Samtyckeskryssrutan är en teknisk brytare som styr om Telaris importerar resor för föraren. Det är kundens (administratörens) ansvar att säkerställa att föraren faktiskt har samtyckt till registrering och användning av GPS- och kördata innan kryssrutan sätts. Personuppgiftsansvaret för persondata från ABAX ligger hos kunden, inte hos Telaris.



Fordon


Fordon upptäcks automatiskt vid import. För nya fordon slår Telaris upp objekt av den valda fordonsobjekttypen där objektnamnet är identiskt med registreringsnumret från ABAX:

  • Finns exakt en träff sätts kopplingen automatiskt.
  • Finns flera träffar, eller ingen träff, sätts ingen automatisk koppling. Då kopplar administratören objektet manuellt i fordonstabellen.

Fordonstabellen visar ABAX-ID, alias, registreringsnummer och kopplat objekt.



Inställningar


InställningBeskrivning
Miljö (test/prod)Om integrationen använder ABAX:s test- eller produktions-API.
OAuth-anslutningAuktorisering via ABAX-inloggning. «OAuth» för prod, «OAuth Sandbox» för test.
Client CredentialsAlternativ autentisering med API-nycklar (ID + Secret), utan användarinloggning.
Reseprodukt (Trip Product)Produkten för körsträckeraden. Pris per km. Obligatoriskt.
Kostnadsprodukt (Cost Product)Produkten för utgiftsrader (parkering, vägtull, färja).
Fordonsobjekttyp (Tag Type)Objekttypen som representerar fordon, för automatisk matchning på registreringsnummer.
Reseadministratörer (TripAdmin)Personal som kan se alla förares resor.



Åtkomst och behörigheter


RollBehörigheter
Vanlig användare (orderhanterare)Ser endast sina egna resor. Kan lägga resor till order och markera slutförd eller borttagen.
ReseadministratörSer alla förares resor i körjournalfliken. Konfigureras i konfigurationen.
AdministratörÅtkomst till integrationsadministrationen. Konfigurerar OAuth, samtycke per förare, fordonskopplingar och övriga inställningar.






Var artikeln till hjälp?

Toppen!

Tack för din feedback

Vi beklagar att det inte var till hjälp

Tack för din feedback

Berätta för oss hur vi kan förbättra den här artikeln!

Välj minst en av orsakerna
CAPTCHA-verifiering krävs.

Feddback skickat

Vi uppskattar din feedback och uppdaterar artikeln vid behov