Felsökning och vanliga frågor (FAQ)

Här hittar du vanliga fel, kända begränsningar och vanliga frågor om ABAX-integrationen, samt vem du kontaktar för vad.

INNEHÅLLSFÖRTECKNING

Ansvar: Telaris och ABAX
Vanliga fel
Kända begränsningar
Vad modulen inte gör
Vanliga frågor
Ordlista

Ansvar: Telaris och ABAX

Telaris ansvarar för integrationen i Telaris – konfiguration, import av resor och generering av orderrader. Själva körjournalen, GPS-enheterna och data i ABAX ligger hos ABAX. Gäller frågan GPS-enheter, registrering av resor eller ABAX-kontot, kontaktar du ABAX.

OBS: Telaris inhämtar inte och verifierar inte samtycke från förare. Samtyckeskryssrutan i Telaris är endast en teknisk brytare. Det faktiska samtycket, och personuppgiftsansvaret för GPS- och kördata, ligger hos kunden.

Vanliga fel

Problem	Orsak	Lösning
`An error occurred during the OAuth process`	Auktoriseringskoden är ogiltig eller utgången, eller refresh-token saknas	Autentisera på nytt via Administration → Integrationer → ABAX → Autentisera.
`We couldn't authenticate with the integration. Please try re-authenticating`	Upprepade misslyckade autentiseringsförsök	Kontrollera att ABAX-kontot är aktivt och att OAuth-åtkomsten inte har återkallats. Autentisera på nytt.
`An error occurred during the authentication process`	Varken OAuth eller Client Credentials är konfigurerat	Fyll i antingen OAuth-anslutning eller Client Credentials.
`Integration is missing required data`	Reseprodukt eller annan obligatorisk konfiguration saknas	Kontrollera att alla obligatoriska fält är ifyllda.
`An error occurred at Abax' end`	ABAX returnerade ett serverfel	Vänta och försök igen. Kvarstår felet, kontakta ABAX.
`Insufficient permissions`	Åtkomsten saknar nödvändiga scopes mot ABAX-API	Verifiera att ABAX-kontot/-klienten har scopes för trips, vehicles och people. Autentisera på nytt.
`You are looking up expenses for more than 150 trips`	Utgiftsuppslaget översteg gränsen på 150 resor	Begränsa perioden eller antalet resor som visas.
Inga resor visas i körjournalfliken	Inga förare har samtycke aktiverat, eller det finns inga tjänsteresor	Kontrollera att minst en förare har samtycke, och att det finns tjänsteresor (inte privata) i ABAX för perioden.
Fordon visas inte kopplat till objekt	Registreringsnumret matchar inget objekt, eller flera objekt har samma namn	Kontrollera att objektet finns med exakt samma registreringsnummer och rätt objekttyp. Koppla manuellt vid behov.
Förare dyker inte upp i tabellen	Föraren har inte kört en tjänsteresa än, eller importen har inte körts	Vänta på nästa timkörning, eller utlös import genom att öppna körjournalfliken.
Resan kan inte läggas till	Resan är redan slutförd eller borttagen	Endast resor med status «ny» kan läggas till på order.

Kända begränsningar

Max 50 resor per importkörning (utan paginering). Tjänsterese- och samtyckesfiltrering sker på dessa, så antalet importerade är ofta lägre. Vid stor backlogg upprepas importen automatiskt varje timme.
ABAX har en gräns på 60 API-anrop per minut. Vid många samtidiga användare kan det ge tillfälliga fördröjningar.
Utgiftsuppslag är begränsat till 150 resor per förfrågan.
GPS-koordinater importeras inte – endast adresser lagras.
Integrationen hämtar endast data från ABAX; inget skickas tillbaka.
Förare utan koppling till personal får inte resor importerade.
Telaris upprätthåller inte själva samtycket; det är kundens ansvar.

Vad modulen inte gör

Skickar inte data till ABAX – kommunikationen är enkelriktad.
Skapar inte resor eller registrerar körningar – det görs av ABAX:s GPS-enhet.
Hanterar inte privata resor – endast tjänsteresor importeras.
Beräknar inte milersättningssatsen – priset styrs av reseprodukten.
Stöder inte realtidsspårning av fordon.
Inhämtar inte samtycke från förare.

Vanliga frågor

Måste alla förare ge samtycke?

Nej, endast förare vars resor ska importeras. Förare utan samtycke ignoreras helt vid import.

Var sätts samtycket – i ABAX eller i Telaris?

Kryssrutan sätts i Telaris (Administration → Integrationer → ABAX → förartabellen). Det faktiska samtycket måste inhämtas från föraren av kunden i förväg.

Vad händer om en förare inte är kopplad till personal?

Resor för förare utan koppling importeras inte. Kopplingen kan sättas manuellt, eller automatiskt om e-posten matchar en person i Telaris.

Kan jag använda Client Credentials i stället för OAuth?

Ja, om kunden har skapat en egen API-klient hos ABAX. Då krävs ingen användarinloggning. Fyll i ID och hemlighet i konfigurationen.

Vad är skillnaden på test- och produktionsmiljö?

Testmiljön använder ABAX:s sandbox med testdata. Produktionsmiljön hämtar riktiga data från kundens ABAX-konto. Byt till prod när konfigurationen är verifierad.

Hur ofta importeras resor?

Automatiskt varje timme, och manuellt varje gång körjournalfliken öppnas (med en minuts nedkylning).

Kan en resa läggas till på flera order?

Ja, så länge resan har status «ny». Resor som redan är tillagda på den aktuella ordern markeras «Redan tillagd i ordern».

Vad händer med resor som tas bort?

De får status «borttagen» och försvinner från listan, men raderas inte från databasen.

Varför ser jag inte körjournalfliken?

Fliken visas endast när minst en körjournalsintegration är aktiverad. Kontrollera att ABAX är aktiverad under Administration → Integrationer.

Varför kom inte alla resor in på en gång?

Varje körning hämtar max 50 resor, och filtrering sker på dessa. Vid många resor tar det flera körningar. Importen körs varje timme.

Hur är det med privata resor?

De importeras inte alls – hoppas över vid hämtning och lagras aldrig i Telaris.

Ordlista

Begrepp	Förklaring
ABAX	Extern tjänst för körjournal och GPS-spårning av fordon.
Körjournal	En samling registrerade resor i ABAX.
Tjänsteresa	En resa kategoriserad som tjänsteresa i ABAX. Endast denna typ importeras.
Samtycke (Consent)	En teknisk kryssruta per förare i Telaris. Måste vara aktiverad för att resor ska importeras. Det faktiska samtycket inhämtas av kunden.
Lägg till i ordern	En knapp i körjournalfliken som skapar orderrader för körsträcka och utgifter.
Markera slutförd	En knapp som sätter resans status till slutförd och tar bort den från listan.
Ta bort	En knapp som sätter resans status till borttagen. Visas endast för resor som inte är tillagda på en order.
OAuth	En autentiseringsmetod där användaren loggar in via ABAX och ger Telaris åtkomst.
Client Credentials	Alternativ autentisering med API-nycklar, utan användarinloggning.
Nedkylningsperiod	Automatisk väntetid mellan importkörningar för att undvika överbelastning.

Senaste sökningar

Felsökning och vanliga frågor (FAQ)