I Tripletex kan man opprette to typer API/integrasjonsnøkler: brukernøkkel for sluttbruker og regnskapskontorets brukernøkkel.
Brukernøkkel er det samme som API/integrasjonsnøkkel og er også kalt “Employee token”.
En brukernøkkel kan opprettes mot en ansatt eller en kontakt i selskapet.
Dersom du er regnskapsfører kan du opprette en brukernøkkel for regnskapskontoret, som du kan bruke på flere klienter, se da denne artikkelen her.
1. Aktivere Integrasjoner
Integrasjoner må aktiveres via Selskap -> Mitt abonnement (eventuelt “Vår kundeside”) av enten en kontoadministrator eller brukeradministrator.
Denne tjenesten er tilgjengelig for pakken Smart og oppover. Les gjennom vilkårene og aktiver.
2. Opprett brukernøkkel
Når tilleggstjenesten “Integrasjoner” er aktivert, vil brukeradministrator i selskapet se fanen “API-tilgang” inne på alle kontakt/ansatt.
OBS! En nøkkel kan til enhver tid kun ha samme eller mindre tilgang til systemet enn det brukeren man oppretter den på har.
Om man oppretter en nøkkel på en ansatt med tilgang til kun å logge på og føre timer vil man ikke kunne opprette en nøkkel som kan gjøre noe mer enn dette på vedkommendes ansatt/kontaktkort.
Brukeradministrator kan nå opprette en brukernøkkel på seg selv ved å klikke på profilbilde øverst på høyre hjørne -> Min profil -> API-tilgang -> Ny nøkkel.
I boksen som dukker opp vil du kunne legge inn informasjon om integrasjon.
Applikasjon
I dette feltet skal du kunne velge applikasjonen som du ønsker å ha en integrasjon opp mot i listen.
Finner du ikke applikasjonen i listen? Ta kontakt med integrasjonspartner om “Applikasjonsnavn” dersom du ikke har fått dette fra før.
OBS! Dersom du ikke finner applikasjonen du skal integrere i listen kan du huke på “Tilpasset oppsett” og skrive applikasjonsnavnet manuelt.
Dette navnet kan du få av integrasjonspartner eller integrasjonsutvikler i programmet du ønsker å integrere opp mot.
Tilpasset oppsett
Deretter markerer du for “Tilpasset oppsett”. Her kan du velge tilgangene som integrasjonen skal ha.
“Alle tilganger” gir integrasjonen tilgang til alle tilganger. Manglende tilganger som selve brukeren som nøkkelen opprettes på, vil være låst og utilgjengelig for endring. De kan heller ikke legges til med mindre de tilgangene blir delegert til den ansatte/kontakten det gjelder.
“Gi brukernøkkel denne brukerens tilganger” kopierer tilgangene fra brukeren du oppretter nøkkel på.
“Bestem selv” vil da ikke gi noen tilganger til integrasjonen enda, og du må selv regidere tilgangene på nøkkelen under fanen API-tilgang ved å klikke på applikasjonsnavnet i blått.
Applikasjonsnavn
Dette feltet dukker opp når du har huket på “Tilpasset oppsett”. I dette feltet kan du skrive det samme som står under “Applikasjon” som valg i nedtrekksmenyen.
Gi nøkkelen et navn
Her velger du hva applikasjonen skal hete i brukernøkkeloversikten under fanen API-tilgang.
Eksempel:
3. Brukernøkkelen (Employee token)
Når du har fullført oppsettet for brukernøkkelen så vil en ny dialogboks dukke opp.
Her får du nøkkelen som skal legges inn i integrasjonen. Denne vises kun en gang og vil ikke kunne hentes opp igjen hverken av brukere i Tripletex eller Support.
Det er derfor viktig at denne lagres et trygt sted. Vi anbefaler at nøkkelen sendes til deg selv på e-post slik at du enkelt kan finne tilbake til den.
Denne nøkkelen vil ikke vises igjen. Nøkkelen du får kan avvike i format fra den du ser på skjermbilde under.
Når du har lagret nøkkelen et trygt sted kan du trykke på OK. Applikasjonen vil nå dukke opp i oversikten over API brukernøkler.
Brukernøkkel tilganger
Under feltet “Nøkkel” så vil du finne applikasjonsnavnet i blått. Ved å klikke på applikasjonsnavnet vil du bli tatt videre for tilgangsstyringen for nøkkelen der du kan legge/fjerne tilganger.
Du kan ikke gi nøkkelen tilgang til noe brukeren du har opprettet den på ikke har fra før i Brukertilgang-fanen.
Har du glemt/mistet nøkkel?
Da kan du klikke på “Gjenopprett nøkkel”.
Ved å gjenopprette brukernøkkel så vil den gamle nøkkelen deaktiveres og slettes, og du vil få automatisk en ny nøkkel ferdig satt opp som den gamle.
Brukernøkkelen som du har lagret kan du nå angi i programmet du skal integrere Tripletex opp mot, eller sende den til programmets support i henhold til veiledning som er angitt for oppsett av integrasjonen.
Da er koblingen opp mot integrasjonen satt opp i Tripletex! Følg da nødvendige steg hos integrasjonspartner for å fullføre oppsettet der også.