Integratie inrichten of wijzigen — benodigde informatie
Op deze pagina leest u welke informatie vereist is bij het indienen van een 03-EDI-ticket voor het inrichten van een nieuwe integratie of het wijzigen van een bestaande integratie op basis van nieuwe eisen. Volledige informatie vooraf voorkomt vertragingen tijdens het proces.
Note
Deze pagina is van toepassing wanneer u een nieuwe integratie opzet of een bestaande uitbreidt — bijvoorbeeld door een nieuw berichttype toe te voegen, een veldmapping aan te passen, een nieuwe handelspartner aan te sluiten of een nieuw extern systeem zoals SAP, Shopify of Exact te koppelen. Als de integratie al bestaat en niet meer werkt, zie dan Bestaande integratie — storingen en fouten.
Waarom deze informatie belangrijk is
Het inrichten of wijzigen van een integratie vereist afstemming tussen 3PL Dynamics en het externe systeem over protocollen, inloggegevens, berichtformaten en veldmappings. Hoe vollediger de informatie bij de start, hoe minder afstemrondes nodig zijn voordat de integratie live kan gaan.
Checklist benodigde informatie
1 — Extern systeem
| Veld | Wat aan te leveren |
|---|---|
| Systeemnaam | Bijv. SAP S/4HANA, Shopify, Exact Globe, WooCommerce, Microsoft Dynamics 365 |
| Versie / release | Het versie- of releasenummer van het externe systeem |
| Nieuwe of bestaande integratie? | Betreft dit een volledig nieuwe inrichting, of een wijziging van een bestaande integratie? |
| Wat wordt gewijzigd? | Voor bestaande integraties: beschrijf wat wordt toegevoegd of aangepast (bijv. nieuw berichttype, gewijzigde veldmapping, nieuwe handelspartner) |
| Omgeving | Productie, test of sandbox |
2 — Protocol en verbinding
| Veld | Wat aan te leveren |
|---|---|
| Protocol | REST API, SOAP, SFTP, FTP, EDIFACT, X12, Webhook, Azure Service Bus, etc. |
| Endpoint / host | De volledige URL, hostnaam of het IP-adres van de verbinding |
| Poort | Het poortnummer (bijv. 443, 22, 21) |
| Authenticatiemethode | API-sleutel, OAuth 2.0, basisauthenticatie, certificaat, IP-whitelist |
3 — Inloggegevens
Important
Vermeld geen inloggegevens in het ticket. Deel API-sleutels, wachtwoorden en certificaten via een beveiligd kanaal, zoals een wachtwoordmanager of versleutelde e-mail. Geef in het ticket aan dat de gegevens beschikbaar zijn en hoe ze worden aangeleverd.
Afhankelijk van de authenticatiemethode, bereid het volgende voor:
| Authenticatietype | Wat is nodig |
|---|---|
| API-sleutel | Naam en waarde van de sleutel |
| OAuth 2.0 | Client ID, client secret, token-endpoint-URL en benodigde scopes |
| Basisauthenticatie | Gebruikersnaam en wachtwoord |
| SFTP / FTP | Host, poort, gebruikersnaam en wachtwoord of privésleutelbestand (.ppk / .pem) |
| Certificaat | Certificaatbestand (.pfx of .pem) en wachtwoordzin |
| IP-whitelist | De IP-adres(sen) die bij de partnerorganisatie op de whitelist moeten worden gezet |
4 — Berichtgegevens
| Veld | Wat aan te leveren |
|---|---|
| Berichtformaat | JSON, XML, CSV, EDIFACT, X12, plat bestand, etc. |
| Richting | Inkomend (extern systeem → 3PL Dynamics) of Uitgaand (3PL Dynamics → extern systeem) |
| Bericht- / transactietype | Bijv. verkooporder, zendingbevestiging, factuur, ASN, voorraadmutatie, labelaanvraag |
| Voorbeeldbestand | Voeg een echt of geanonimiseerd voorbeeldbericht bij (zie tip hieronder) |
Tip
Voeg altijd een voorbeeldbestand bij. Voor EDIFACT of X12: het ruwe EDI-bericht. Voor REST of SOAP: een voorbeeldverzoek en de verwachte respons. Anonimiseer persoons- of bedrijfsgevoelige gegevens waar nodig.
5 — Technisch contactpersoon bij de partner
Geef de contactgegevens van de technische contactpersoon bij de externe partij. Dit stelt het Boltrics-integratieteam in staat direct te coördineren indien nodig.
| Veld | Wat aan te leveren |
|---|---|
| Naam | Volledige naam van de technische contactpersoon |
| Direct e-mailadres | |
| Telefoon | Telefoonnummer (optioneel) |
6 — Documentatie en specificaties
Voeg de volgende documenten bij of verwijs ernaar, indien beschikbaar:
- API-documentatie of integratiegids van de partner
- Veldmappingspecificatie of interface-overeenkomst
- Gegevensstroomdiagram of procesbeschrijving
- Eerdere testresultaten of go-live-rapport
- Bekende beperkingen of uitzonderingen gedocumenteerd door de partner
Ticket indienen
Zodra u alle bovenstaande informatie heeft verzameld, gaat u naar Support- of changeticket aanmaken en selecteert u categorie 03-EDI. Voeg alle relevante bestanden toe in Stap 4 — Bijlagen toevoegen.