RoutIT (KPN)
Inleiding
De integratie met RoutIT brengt enkele unieke uitdagingen met zich mee, vooral rondom de verwerking van licenties. RoutIT levert namelijk orders zonder unieke identificatie op het niveau van individuele licenties of diensten. Dit betekent dat wij geen directe manier hebben om te bepalen welke onderdelen binnen een order nieuw, gewijzigd of verwijderd zijn.
Om dit betrouwbaar te kunnen doen, hebben we een aanpak ontwikkeld waarbij we licentieregels binnen een order zelf uniek identificeren op basis van drie onderdelen: het product (zoals dat vanuit RoutIT komt), en de door de gebruiker ingevoerde velden label en kenmerk.
Uniek maken van licentieregels
Omdat RoutIT geen unieke ID’s per licentieregel levert, maken wij regels uniek op basis van een combinatie van drie velden:
Product: dit komt vanuit RoutIT (bijv. “VoIP Basis”, “Microsoft 365 Business Standard”)
Label: door de gebruiker vrij in te vullen (bijv. een telefoonnummer, klantnaam of interne referentie)
Kenmerk: ook vrij in te vullen (bijv. een e-mailadres, serienummer, of aanvullende omschrijving)
Uniek maken van orderregels
Omdat RoutIT alleen een complete lijst met actieve diensten/orders teruggeeft, en geen aparte identifiers per regel, gebruiken wij de volgende combinatie om regels uniek te maken:
Product: afkomstig uit RoutIT, bijv. “VoIP Basis”, “Microsoft 365 E3”
Label: vrij in te vullen door de gebruiker, vaak een telefoonnummer of klantomschrijving
Kenmerk: ook vrij in te vullen, bijvoorbeeld een e-mailadres, toestelomschrijving of serienummer
Deze combinatie fungeert als een soort “sleutel” om te bepalen of een regel al bestaat, nieuw is, of gewijzigd is.
Voorbeeld:
Product | Label | Kenmerk | Wordt als uniek beschouwd? |
---|---|---|---|
VoIP Basis | 010-1234567 | toestel receptie | ✅ Ja |
VoIP Basis | 010-1234567 | toestel directie | ✅ Ja |
VoIP Basis | 010-1234567 | toestel receptie | ❌ Nee (bestaat al) |
Microsoft 365 Business Basic | jan@bedrijf.nl | ✅ Ja | |
Microsoft 365 Business Basic | jan@bedrijf.nl | ❌ Nee (bestaat al) |
Tip: laat gebruikers duidelijke, consistente labels en kenmerken invullen om verwarring te voorkomen. Denk aan e-mailadressen, telefoonnummers of functieomschrijvingen.
Wat als iets verandert?
Wanneer een van de drie onderdelen verandert (bijvoorbeeld een kenmerk wordt aangepast), dan zien wij dat als een nieuwe regel. Dit zou dan in Inserve aangepast moeten worden naar een nieuwe regel.
Koppeling leggen
RoutIT maakt gebruikt van Grexx voor de API koppeling. De eerste stap is zorgen dat je kunt inloggen op:
https://routit.grexx.today/
Wanneer je hier nog geen account hebt kun je deze aanvragen bij je accountmanager. Wanneer je ingelogd bent ga je naar:
Zorg hier dat je ons IP adressen whitelist:
185.233.175.201
185.233.175.21
Benodigde gegevens in Inserve
Gebruikersnaam | Zie API credentials in de screenshot |
---|---|
Wachwoord | Zie API credentials in de screenshot |
ID uit realtime endpoint | Zie realtime endpoint in de screenshot |