De integratie-matrix: meer dan een lijstje endpoints

Waarom een matrix?

Bij het ontwerpen van een koppeling is de eerste vraag altijd: welke data moet er eigenlijk heen en weer? Een klantrecord in systeem A is niet automatisch hetzelfde als in systeem B. De ene kant heeft factuurregels op detailniveau, de andere alleen een totaalbedrag. Zonder die mismatch vooraf in kaart te brengen, loop je halverwege het project tegen verrassingen aan.

Daarom tonen we op elke integratiepagina een data-object-matrix: welke data-types kennen beide systemen, en hoe diep is de ondersteuning per kant?

Hoe werkt het?

Voor elk softwarepakket in onze catalogus hebben we de API geanalyseerd en elk endpoint gekoppeld aan een Nederlandse data_object_type. Denk aan:

• Klant (Customer, Contact, Account)
• Factuur (Invoice, Bill, SalesInvoice)
• Order (Order, SalesOrder, Quote → Order)
• Betaling (Payment, Transaction, Charge)
• Product (Item, SKU, Article)
• Voorraad (Stock, Inventory, StockPosition)

Deze normalisering maakt dat we over platforms heen kunnen vergelijken. Een endpoint POST /customers in Shopify en POST /api/v1/{division}/crm/Accounts in Exact Online mappen beide op Klant.

De kleur-indicatoren

In de matrix zie je per data-object-type een gekleurde indicator:

• Groen — 5+ endpoints beschikbaar (volledige CRUD + sub-resources)
• Oranje — 1-4 endpoints (basis-ondersteuning, mogelijk beperkt)
• Rood — geen endpoints voor dit type

Zo zie je direct of een integratie tussen systeem A en B realistisch is, of dat je work-arounds moet bedenken voor ontbrekende velden.

Wat levert dit op?

Voor onze klanten: geen verrassingen meer halverwege een project. Voor ons: een consistente manier om koppelingen in te schatten en offertes op te stellen.

Kijk zelf op een integratiepagina — alle combinaties van software in de catalogus zijn vooraf uitgewerkt. En mis je een pakket? Laat het ons weten en we voegen het toe.