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:

ProductLabelKenmerkWordt als uniek beschouwd?
VoIP Basis010-1234567toestel receptie✅ Ja
VoIP Basis010-1234567toestel directie✅ Ja
VoIP Basis010-1234567toestel receptie❌ Nee (bestaat al)
Microsoft 365 Business Basicjan@bedrijf.nl ✅ Ja
Microsoft 365 Business Basicjan@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

GebruikersnaamZie API credentials in de screenshot
WachwoordZie API credentials in de screenshot
ID uit realtime endpointZie realtime endpoint in de screenshot