Wat moet ik aanleveren voor een koppeling met een extern systeem?

Wil je een website of webshop koppelen aan een extern systeem? Dan hebben we eerst informatie nodig over het systeem, de gewenste gegevensuitwisseling en de beschikbare technische mogelijkheden.

Met deze informatie kunnen we beoordelen wat er nodig is om de koppeling te realiseren.

Wat hebben we van je nodig?

1. De naam van het externe systeem

Geef aan welk systeem gekoppeld moet worden.

Denk bijvoorbeeld aan een:

• CRM-systeem;

• boekhoudpakket;

• voorraadsysteem;

• reserveringssysteem;

• ERP-systeem;

• andere externe applicatie.

2. Technische documentatie

Vraag de leverancier om de technische documentatie van de beschikbare koppelmogelijkheden.

Dit kan bijvoorbeeld documentatie zijn over:

• een API;

• webhooks;

• feeds;

• import- en exportmogelijkheden;

• een test- of sandboxomgeving.

Met deze documentatie kunnen we beoordelen wat het systeem technisch ondersteunt.

3. De gewenste gegevensstroom

Beschrijf zo concreet mogelijk welke gegevens tussen de systemen moeten worden uitgewisseld.

Bijvoorbeeld:

Extern systeem → website

• producten;

• prijzen;

• voorraad.

Website → extern systeem

• bestellingen;

• aanvragen;

• klantgegevens.

Geef ook aan hoe vaak deze gegevens bijgewerkt moeten worden.

4. Een technische contactpersoon

Heb je bij de leverancier een contactpersoon voor technische vragen? Stuur de contactgegevens dan mee.

Tijdens het ontwikkelen of testen van een koppeling kunnen er vragen ontstaan over de werking of mogelijkheden van het externe systeem.

5. Informatie over een testomgeving

Vraag of de leverancier een test- of sandboxomgeving beschikbaar heeft.

Bij belangrijke koppelingen testen we de gegevensuitwisseling bij voorkeur eerst buiten de liveomgeving.

Moet ik API-gegevens direct meesturen?

Niet altijd.

Voor een koppeling kunnen uiteindelijk bijvoorbeeld API-sleutels, tokens of andere technische toegangsgegevens nodig zijn. Dit zijn gevoelige gegevens.

Stuur deze daarom niet zomaar via een gewone e-mail of supportticket.

Wij geven aan welke toegang daadwerkelijk nodig is en hoe deze veilig kan worden aangeleverd.

Goed om te weten

Dat een extern systeem een API of andere koppelmogelijkheid heeft, betekent niet automatisch dat iedere gewenste gegevensuitwisseling mogelijk is.

De leverancier bepaalt welke gegevens en functies technisch beschikbaar zijn.

Daarom beoordelen we eerst de documentatie voordat we bepalen hoe de koppeling kan worden gebouwd.

Wil je een externe koppeling laten realiseren?

Stuur ons dan:

• de naam van het externe systeem;

• de technische documentatie;

• welke gegevens van systeem A naar systeem B moeten;

• welke gegevens eventueel terug moeten;

• hoe vaak de gegevens bijgewerkt moeten worden;

• informatie over een testomgeving;

• de contactgegevens van een technische contactpersoon bij de leverancier.

Wij beoordelen vervolgens de mogelijkheden en bepalen wat er nodig is voor de koppeling.