Hva er SmartDok API for Autogear?
For at Autogear skal kunne hente eller sende data til SmartDok, må du gi riktig API-tilgang i SmartDok. Tilgangene settes når du oppretter API-nøkkelen (API Token).
Når bør jeg bruke SmartDok API for Autogear?
- Når du ønsker å innhente prosjekter fra SmarrtDok for å knytte det til turer i Autogear, samt sende prosjekt rapporter over kjøring for kostnadsføring direkte inn i SmartDok.
- Når du vil laste inn verktøy registrert SmartDok inn i Autogear for videre knytte de mot Tag for verktøy sporing
- Når du har opprettet geofence knyttet til prosjekter og vil ha de inn i Autogear for automatisk registrering mot prosjekt ved inngang av området eller adresse.
Slik setter du opp SmartDok API:
1. Lag brukernøkkel i SmartDok
https://web.smartdok.no/app/company/api-admin/api-tokens
Du kan bruke valgfritt navn, f.eks Autogear.
Velg hva API nøkkelen skal kunne hente inn og sende mellom SmartDok og Autogear
Prosjektsynk (Project)
-
For å hente prosjekter fra SmartDok må API-nøkkelen ha disse tilgangene:
- Read Projects
- Read Users
Dette gjør at Autogear kan importere prosjekter og se hvem som er knyttet til dem.
Prosjektrapport (Project Report / Goods Consumption)
- Når du vil at Autogear skal sende vareforbruk til SmartDok, kreves følgende rettigheter:
☑️ Read Projects
☑️ Read Users
☑️ Read Goods
☑️ Write Goods
☑️ Read Goods Categories
☑️ Write Goods Categories
☑️ Write Goods Consumption
-
Disse rettighetene brukes til:
- å opprette varekategorier (første gang)
- å opprette varer (første gang)
- å sende inn forbruk til riktig prosjekt (løpende)
Geofence (Prosjektlokasjon)
-
For å hente prosjektets posisjon fra SmartDok kreves:
☑️ Read Projects
☑️ Read Users
☑️ Read Project LocationDette gjør at Autogear kan oppdatere prosjektets geolokasjon automatisk.
-
Verktøy / Utstyr (Tools)
Hvis du ønsker å hente verktøy og utstyr fra SmartDok, trenger API-nøkkelen:
☑️ Read Tools
Dette muliggjør visning av SmartDok-verktøy i Autogear sitt verktøyregister.
Tips og viktige merknader
-
Kombinere
Hvis du aktiverer flere funksjoner samtidig, må API-nøkkelen ha summen av alle nødvendige rettigheter.
Eksempel: Aktiverer du både Prosjekt + Prosjektrapport + Geofence → må du huke av for alle rettighetene listet ovenfor.