Integration mellem flådestyringspartner og Minuba
Oprettelsesproces for at blive en ny flådestyringspartner i Minuba
- Du sender en mail til Minuba, hvor du angiver ønske om at få de nødvendige adgange, til at bruge Minuba Api‘et og blive registreret som flådestyringspartner i Minuba.
- Du skal også angive et dokument/link, som indeholder hvorledes Minuba-kunden i jeres system aktiverer integrationen. Dokumentet/linket kan angives på et senere tidspunkt, dog inden integrationen gøres tilgængelig for Minuba-kunderne.
- Minuba opretter Api nøgle og opretter dig som ny flådestyringspartner.
- Minuba opretter testbrugere så Api ‘et kan testes.
- Du sender besked til Minuba via mail, når integrationen er komplet.
- Minuba vil gøre flådestyringsintegrationen tilgængelig for Minuba kunder.
Minuba-kunde: Proces for at slå flådestyringsintegrationen til
- Minuba-kunderne kan under Tandhjul –> Integrationer –>Vis flere muligheder –> vælg Flådestyring i venstre side –> vælg det system du ønsker –> tryk Vis - læs vejledningen og ’Aktiver integrationen’ -> sæt nøglen ind
- Minuba-kunden logger ind i jeres flådestyringssystem og aktiverer integrationen ved blandt andet at indsætte deres auth nøgle. Nøglen er nødvendig for at gemme data under Minuba-kundens konto.
- Flådestyringspartneren sender flådestyringsdata over til Minuba Api‘et.
- I Minuba under ’min tid’ kan Minuba-kunden nu se deres kørsel.
Vores kunde, som skal finde deres individuelle auth nøgler, skal gå ind under Administration –> Brugere –> Udvidede indstillinger, her kan man generere en ny nøgle som hører til den enkelte bruger:
Kopiér link til denne sektionLink kopieret!
Minuba-kunde: Opsætningsmuligheder i Minuba
- Minuba-kunder kan under deres side for flådestyringsindstillinger, vælge at opdatere hvilke Gps-enheder der er parret til hvilke brugere.
- Gps-enheder behøver ikke at være tilknyttet til en bruger.
Kopiér link til denne sektionLink kopieret!
Oprettelse af adgang til API
For at oprette adgang til Api‘et og sende flådestyringsspecifikke data til Minuba skal du bruge følgende:
- API nøgle: For at Minuba kan lave en API nøgle har vi brug for følgende information, som du kan sende til support@minuba.dk:
- Virksomhedsnavn.
- Kontaktperson.
- Kontaktmailadresse.
- Kontakttelefonnummer.
- Kort beskrivelse af, hvad Api ‘et skal bruges til.
- Oprettelse som flådestyringspartner i Minuba:
- Inde i mailen med anmodning om API nøgle skal der også angives ønske om at danne flådestyringsintegration til Minuba.
- Auth nøgle
- Auth nøgler gives af Minuba-kunder. Der kræves en auth nøgle per Minuba-kunde.
- Nøglen angives af Minuba-kunden, når de ønsker at slå integrationen til i jeres flådestyringssystem.
Kopiér link til denne sektionLink kopieret!
Oprettelse af nye GPS-enheder og kørsler
For at oprette flådestyringsrelateret data via Minuba Api‘et skal du gøre følgende:
- Under ‘Endpoint’ sektionen i Minuba API‘et skal følgende felter udfyldes:
- API nøgle.
- Auth nøgle.
- ’User Name’ og ’Password’ behøver ikke at blive udfyldt, når auth key angives.
- Under sektionen ’Operation package’ har vi en liste af entiteter, som API ‘et giver adgang til. 3 af entiteterne er nødvendige for at gemme flådestyringsrelateret data:
- User:
- User entiteten bruger vi til at hente alle brugere for en Minuba-kunde. Bruger id´et bruges til at knytte en bruger (user) til en GPS enhed (GpsDevice).
- GpsDevice:
- GpsDevice er den enhed, som kørslen bliver registreret på. Forholdet mellem en bruger og en GPS enhed er én til én. En bruger kan kun have en GPS enhed og en GPS enhed kan kun være tilknyttet til en enkel bruger.
- TripEvent:
- TripEvent er selve kørslen, som blandt andet indeholder start- og slutlokation, start- og sluttid og kørt distance, som angives i km.
- For nærmere information om hvilke data, der kan sendes eller hentes, anbefales det, at kigge på de enkelte metodetyper (GET, POST, DELETE og PATCH) under TripEvent og GpsDevice, samt at der kigges på sektionen ’return type’ for TripEvent, GpsDevice og User på API siden.
- User:
Luk denne sektion