Integratie tussen wagenparkbeheer en Minuba
Aanmaakproces om een nieuwe wagenparkbeheerpartner te worden in Minuba
- Je stuurt een e-mail naar Minuba waarin je aangeeft dat je toegang wilt krijgen tot het gebruik van de Minuba API en geregistreerd wilt worden als wagenparkbeheerpartner in Minuba.
- Je moet ook een document/link aanleveren waarin staat hoe de Minuba-klant de integratie in jullie systeem activeert. Dit document of deze link kan op een later moment worden aangeleverd, maar wel vóórdat de integratie beschikbaar wordt gesteld aan Minuba-klanten.
- Minuba maakt een API-sleutel aan en registreert je als nieuwe wagenparkbeheerpartner.
- Minuba maakt testgebruikers aan zodat de API getest kan worden.
- Zodra de integratie compleet is, stuur je een bericht naar Minuba via e-mail.
- Minuba stelt de integratie voor wagenparkbeheer vervolgens beschikbaar aan Minuba-klanten.
Minuba-klant: Proces om de wagenparkbeheerintegratie te activeren
- Minuba-klanten kunnen via Tandwiel -> Integraties -> Toon meer opties -> kies ‘Wagenparkbeheer’ aan de linkerkant -> selecteer het gewenste systeem -> klik op ‘Toon’ -> lees de handleiding en klik op ‘Activeer integratie’ -> voer de sleutel in.
- De Minuba-klant logt vervolgens in op jullie wagenparkbeheersysteem en activeert de integratie door onder andere hun auth-sleutel in te voeren. Deze sleutel is nodig om gegevens op te slaan onder het klantaccount in Minuba.
- De wagenparkbeheerpartner stuurt daarna de wagenparkgegevens naar de Minuba API.
- In Minuba, onder ‘mijn tijd’, kan de Minuba-klant nu zijn ritgegevens bekijken.
Onze klant die zijn persoonlijke auth-sleutel wil vinden, moet gaan naar:
Beheer -> Gebruikers -> Uitgebreide instellingen. Daar kan per gebruiker een nieuwe sleutel worden gegenereerd.
Kopieer de link naar deze sectieLink gekopieerd!
Minuba-klant: Instellingsmogelijkheden in Minuba
- Minuba-klanten kunnen op hun pagina voor wagenparkinstellingen aangeven welke GPS-apparaten gekoppeld zijn aan welke gebruikers.
- GPS-apparaten hoeven niet per se aan een gebruiker gekoppeld te zijn.
Kopieer de link naar deze sectieLink gekopieerd!
Aanmaken van toegang tot de API
Om toegang te krijgen tot de API en wagenparkgerelateerde gegevens naar Minuba te verzenden, heb je het volgende nodig:
- API-sleutel: Om een API-sleutel aan te maken heeft Minuba de volgende informatie nodig. Deze stuur je per mail naar support@minuba.nl:
- Bedrijfsnaam
- Contactpersoon
- Contact e-mailadres
- Contact telefoonnummer
- Korte beschrijving van waarvoor de API gebruikt gaat worden
- Registratie als wagenparkbeheerpartner in Minuba:
- In de e-mail met het verzoek om een API-sleutel moet ook vermeld worden dat je een wagenparkintegratie met Minuba wilt opzetten.
- Auth-sleutel:
- Auth-sleutels worden verstrekt door Minuba-klanten. Er is één auth-sleutel nodig per Minuba-klant.
- De klant voert deze sleutel in bij het activeren van de integratie in jullie wagenparkbeheersysteem.
Kopieer de link naar deze sectieLink gekopieerd!
Aanmaken van nieuwe GPS-apparaten en ritten
Meer informatie over de Minuba API vind je hier.
Om wagenparkgegevens via de Minuba API aan te maken, moet je het volgende doen:
- Onder de sectie ‘Endpoint’ in de Minuba API moeten de volgende velden worden ingevuld:
- API sleutel
- Auth sleutel
- ’Gebruikersnaam’ en ’wachtwoord’ hoeven niet ingevuld te worden als de auth-sleutel is ingevoerd.
- Onder de sectie ‘Operation package’ staat een lijst met entiteiten die via de API benaderd kunnen worden. Drie daarvan zijn nodig voor het registreren van wagenparkdata:
- User:
- De ‘User’-entiteit wordt gebruikt om alle gebruikers van een Minuba-klant op te halen. De gebruikers-ID wordt gebruikt om een gebruiker te koppelen aan een GPS-apparaat (GpsDevice).
- GpsDevice:
- GpsDevice is het apparaat waarop de rit wordt geregistreerd. De relatie tussen een gebruiker en een GPS-apparaat is één-op-één: één gebruiker kan slechts één apparaat hebben, en één apparaat kan slechts aan één gebruiker gekoppeld zijn.
- TripEvent:
- TripEvent is de rit zelf, met onder andere de start- en eindlocatie, start- en eindtijd, en de afgelegde afstand in kilometers.
- Voor meer informatie over welke gegevens verzonden of opgehaald kunnen worden, wordt aangeraden om te kijken naar de verschillende methodetypes (GET, POST, DELETE en PATCH) onder TripEvent en GpsDevice, evenals de sectie ‘return type’ voor TripEvent, GpsDevice en User op de API-pagina.
- User:
Sluit deze sectie