Med Autogear API kan et annet system hente data fra Autogear, for eksempel lønnssystemet, et analyseverktøy som Power BI eller et eget fagsystem. Her forklarer vi hvordan dere får tilgang, lager en API-nøkkel og gir den til den som setter opp integrasjonen.
Hva kan API-et brukes til?
- Lønn og regnskap: kjøregodtgjørelse og bompenger rett inn i lønnssystemet.
- Rapportering: turer og kjøretøy i Power BI eller andre analyseverktøy.
- Egne systemer: ERP, vedlikehold eller fagsystem som trenger posisjoner og kjøretøydata.
Bruker dere Tripletex, PowerOffice, Visma, Finago, SmartDok eller Nettlønn, har Autogear en ferdig integrasjon. Da trenger dere ikke API-et. Se Oppsett › Integrasjoner.
Slik fungerer det
- Dere ber om API-tilgang og forteller hva dere skal bruke API-et til.
- Autogear aktiverer API-tilgang for kontoen, vanligvis innen to virkedager.
- Kontoeier eller Admin lager API-nøkkelen og godtar vilkårene for bruk av API på vegne av selskapet.
- Dere gir nøkkelen til den som setter opp integrasjonen, egen utvikler eller en leverandør.
Bare Kontoeier og Admin kan be om tilgang og lage API-nøkler. API-et gir tilgang til kjøredata om de ansatte. Derfor er det en med fullmakt i selskapet som godtar vilkårene. Slik vet dere alltid hvilke systemer som henter data fra kontoen, og hvem som har godkjent det.
Steg 1: Be om API-tilgang
- Logg inn i Autogear og gå til siden API-klienter: https://app.autogear.com/dashboard/account-clients
- Du ser siden API-tilgang må aktiveres med skjemaet Be om API-tilgang. Navn, konto og e-post er fylt ut fra innloggingen din.
- Fyll ut skjemaet: - Hva skal dere bruke integrasjonen til? Beskriv hvilke data dere trenger og hvor ofte, for eksempel «Hente godkjente turer hver måned og overføre kjøregodtgjørelse til lønnssystemet». Minst 10 tegn. - Hvilket system skal kobles til? (valgfritt) - Hvem setter opp integrasjonen? Dere selv eller en leverandør. - Telefon (valgfritt), så kan vi ringe hvis vi lurer på noe.
- Klikk Send forespørsel.
Du ser meldingen Takk, forespørselen er sendt. Vi gir beskjed på e-post når API-tilgangen er aktivert.
Steg 2: Lag en API-klient
Når tilgangen er aktivert, lager du API-klienten på samme side.
- Gå til API-klienter.
- Klikk Ny API-klient.
- Gi klienten et Navn. Bruk navnet på systemet som skal kobles til, for eksempel «Visma lønn». Navnet vises bare i Autogear.
- Huk av for at du har fullmakt til å binde selskapet, og at du godtar vilkårene for bruk av API på vegne av selskapet. Navnet ditt og tidspunktet lagres som dokumentasjon på avtalen.
- Klikk Lagre. Knappen blir aktiv når navnet er fylt ut og avkrysningen er satt.
Autogear lager da en Client ID og en Client Secret. Client Secret er skjult. Klikk Vis for å se den, og Kopier for å kopiere den. I listen ser du hvem som godtok vilkårene for hver API-klient, og når.
Steg 3: Sett opp integrasjonen
Den som setter opp integrasjonen, trenger:
- Client ID og Client Secret fra API-klienten.
- Brukernavn og passord til en bruker i Autogear. Integrasjonen logger inn som denne brukeren, og ser bare de dataene brukeren har tilgang til.
Teknisk dokumentasjon finner utvikleren på https://api.autogear.com/docs. Tekniske spørsmål om API-et kan sendes til api@autogear.com, gjerne på engelsk.
Slik stopper du en integrasjon
Vil du at et system ikke lenger skal hente data fra Autogear, sletter du API-klienten det bruker.
- Gå til API-klienter.
- Klikk på søppelbøtta ved API-klienten.
- Bekreft med Slett API-klient.
Vil du bare endre navnet, klikker du på blyanten. Du trenger ikke godta vilkårene på nytt.
Vanlige spørsmål
Jeg finner ikke knappen for å lage API-nøkkel
Det er to mulige grunner. Enten er API-tilgang ikke slått på for kontoen ennå. Da ser du skjemaet Be om API-tilgang i stedet. Eller så er du ikke Kontoeier eller Admin. Da ser du meldingen «Bare kontoeier og administrator kan administrere API-nøkler.», og en med en av disse rollene må lage nøkkelen.
Kan Autogear lage nøkkelen for oss?
Nei. Den som lager nøkkelen, godtar vilkårene for bruk av API på vegne av selskapet, og det må gjøres av en med fullmakt hos dere. Vi slår på tilgangen og hjelper dere gjerne gjennom stegene.
Vi har bedt om tilgang, men ikke hørt noe
Vi aktiverer vanligvis innen to virkedager. Har dere ikke hørt noe etter sju dager, kan du sende en ny forespørsel fra samme side, eller kontakte kundeservice.
Virker nøklene vi laget tidligere?
Ja. Kontoer som allerede hadde en API-nøkkel, har fått API-tilgang slått på automatisk. Nøkler som ble laget før vilkårene kom, står som Ikke godtatt med teksten «Laget før vilkårene ble innført». De virker som før.
Kan vi koble Autogear til Copilot eller Office 365?
Autogear har ingen ferdig kobling til Copilot eller Office 365. Dere kan bygge en egen kobling på Autogear API, for eksempel en egen connector i Microsoft Copilot Studio. Da følger dere stegene over.
Hvilke vilkår gjelder?
Bruk av API-et følger vilkårene for bruk av API i Avtalevilkår. Du godtar dem når du lager API-klienten.
Denne artikkelen hjelper deg med
- Hvordan får jeg API-nøkkel
- API-tilgang til Autogear
- Hente turer til eget system
- Power BI og Autogear
- Koble Autogear til Copilot eller Office 365
- Client ID og Client Secret
- Finner ikke knappen for å lage API-nøkkel
- API-tilgang må aktiveres
- Stoppe en integrasjon