Een API-koppeling tussen een webshop en een fulfilmentsysteem werkt door orderdata automatisch en in realtime door te sturen van het webshopplatform naar het systeem dat de fysieke verwerking aanstuurt. Zodra een klant een bestelling plaatst, communiceert de API direct met het fulfilmentsysteem, zodat zonder handmatige tussenkomst een picklijst, verzendinstructie en voorraadmutatie worden aangemaakt. In dit artikel worden de technische en operationele aspecten van deze integratie stap voor stap behandeld, met specifieke aandacht voor farmaceutische toepassingen.

Wat stuurt een webshop precies door naar een fulfilmentsysteem?

Een webshop stuurt bij elke bestelling een gestructureerd datapakket door naar het fulfilmentsysteem. Dit pakket bevat minimaal het ordernummer, de klantgegevens, de bestelde producten met SKU of artikelcode, de gevraagde hoeveelheden en de gewenste verzendmethode. Afhankelijk van de configuratie worden ook betaalstatus, leverdatum en speciale instructies meegestuurd.

In de praktijk gaat het om een reeks gegevenselementen die het fulfilmentsysteem nodig heeft om de order volledig te kunnen verwerken:

  • Orderidentificatie: uniek ordernummer en tijdstempel
  • Productdata: artikelcode, productnaam, hoeveelheid en eventuele varianten
  • Verzendgegevens: naam, adres, postcode, land en contactinformatie van de ontvanger
  • Verzendvoorkeur: gewenste carrier, serviceniveau of afleverinstructie
  • Betaalstatus: bevestiging dat de betaling is verwerkt of dat de order op rekening gaat

Bij farmaceutisch fulfilment worden hier aanvullende velden aan toegevoegd, zoals batchnummer, lotnummer of specifieke compliancevereisten die voortkomen uit GDP-richtlijnen. Dit maakt de dataoverdracht bij medische webshops complexer dan bij een standaard e-commerceomgeving.

Heeft u vragen over uw farma-logistiek of marketing? Onze experts denken graag met u mee.

Neem contact op

Hoe verwerkt een fulfilmentsysteem een binnenkomende API-aanvraag?

Wanneer een fulfilmentsysteem een API-aanvraag ontvangt, doorloopt het een geautomatiseerde verwerkingsketen. Het systeem valideert eerst de binnenkomende data op volledigheid en juistheid, reserveert daarna de voorraad en genereert vervolgens een picklijst voor het magazijn. Dit hele proces vindt in seconden plaats, zonder menselijke tussenkomst.

Concreet verloopt de verwerking in de volgende stappen:

  1. Validatie: het systeem controleert of alle verplichte velden aanwezig zijn en of de productcodes overeenkomen met de interne artikeldatabase.
  2. Voorraadreservering: de gevraagde producten worden direct gereserveerd, zodat dubbele toewijzing wordt voorkomen.
  3. Aanmaken van werkdocumenten: het systeem genereert een picklijst, pakbon en verzendinstructie.
  4. Statusterugkoppeling: via dezelfde API-verbinding stuurt het fulfilmentsysteem een bevestiging terug naar de webshop, inclusief een trackingnummer zodra het pakket is aangemeld bij de vervoerder.

Bij MSA BV is dit proces gekoppeld aan een digitaal scansysteem. Medewerkers scannen producten tijdens het picken, waardoor locatie, productnaam en batchnummer direct worden geregistreerd in het systeem. Dit zorgt voor een aaneengesloten audittrail, wat binnen medisch fulfilment en direct marketing een essentiële vereiste is.

Wat is het verschil tussen REST API en EDI voor fulfilmentkoppelingen?

REST API en EDI zijn beide methoden om orderdata uit te wisselen tussen een webshop en een fulfilmentsysteem, maar ze verschillen fundamenteel in architectuur en toepassingsgebied. REST API werkt via het internet met lichtgewicht, realtime dataverzoeken, terwijl EDI een gestandaardiseerd berichtenformaat gebruikt dat historisch gezien in batches wordt verstuurd en sterk is ingebed in traditionele supply chains.

De keuze tussen beide heeft directe gevolgen voor de integratie:

  • REST API is flexibel, snel te implementeren en geschikt voor moderne webshopplatformen. Communicatie vindt realtime plaats, waardoor voorraadstatus en orderbevestigingen direct beschikbaar zijn. REST is de standaard voor nieuwe integraties en wordt ondersteund door vrijwel elk modern e-commerceplatform.
  • EDI (Electronic Data Interchange) werkt met vaste berichtstandaarden zoals EDIFACT of ANSI X12. Het is robuust en breed geaccepteerd in grote farmaceutische supply chains en bij groothandelskoppelingen. EDI-berichten worden vaak in batches verwerkt, wat betekent dat de verwerking minder direct is dan bij REST.

Voor farmaceutische organisaties die een webshop koppelen aan een fulfilmentsysteem is REST API in de meeste gevallen de meest praktische keuze. EDI blijft relevant wanneer de koppeling aansluit op een bestaand ERP-systeem van een grote afnemer of leverancier die al op EDI-standaarden werkt.

Wat gebeurt er met voorraadinformatie bij een live API-koppeling?

Bij een live API-koppeling wordt de voorraadstand in de webshop continu gesynchroniseerd met het fulfilmentsysteem. Zodra een order wordt geplaatst of een product wordt ingeboekt, past het fulfilmentsysteem de beschikbare voorraad aan en stuurt het die bijgewerkte informatie direct terug naar de webshop. Dit voorkomt dat producten worden verkocht die niet op voorraad zijn.

De synchronisatie werkt in twee richtingen. Wanneer het fulfilmentsysteem een levering ontvangt en inboekt, verhoogt de beschikbare voorraad in de webshop automatisch. Wanneer een order wordt gepickt en verzonden, daalt de voorraad dienovereenkomstig. Bij een goed geconfigureerde webshop-fulfilmentsysteemintegratie zijn deze mutaties zichtbaar binnen enkele seconden.

Voor farmaceutische webshops voegt dit een extra dimensie toe. Voorraadmutaties worden hier niet alleen bijgehouden per product, maar ook per batch en lotnummer. Dit is noodzakelijk voor traceerbaarheid en eventuele recalls. Een GDP-gecertificeerd fulfilmentsysteem registreert elke mutatie met tijdstempel en gebruikersidentificatie, zodat de volledige bewegingshistorie van een product te reconstrueren is.

Welke technische vereisten stelt een GDP-compliant fulfilmentsysteem aan een API-koppeling?

Een GDP-compliant fulfilmentsysteem stelt aanvullende technische eisen aan een API-koppeling die verder gaan dan standaard e-commerce-integraties. De verbinding moet beveiligd zijn via HTTPS met sterke versleuteling, alle datatransacties moeten worden gelogd met tijdstempel en gebruikersidentificatie, en de API moet batchnummer- en lotnummerinformatie kunnen ontvangen en verwerken als verplichte velden.

Heeft u vragen over uw farma-logistiek of marketing? Onze experts denken graag met u mee.

Neem contact op

Wanneer is een maatwerk API-koppeling beter dan een standaard plug-in?

Een maatwerk API-koppeling is beter dan een standaard plug-in wanneer de operationele of compliance-eisen van de organisatie verder gaan dan wat een generieke integratie kan bieden. Dit is vrijwel altijd het geval in de farmaceutische sector, waar batchregistratie, GDP-logging en specifieke documentstromen niet standaard worden ondersteund door kant-en-klare plug-ins.

Standaard plug-ins zijn geschikt voor eenvoudige e-commerceomgevingen waarbij producten geen bijzondere traceerbaarheidsvereisten hebben. Ze zijn snel te installeren en vereisen weinig technische kennis. Zodra echter sprake is van de volgende situaties, schiet een standaard plug-in tekort:

  • De webshop verkoopt of distribueert gereguleerde medische producten waarvoor batchnummer- en lotnummerregistratie verplicht is
  • Het fulfilmentsysteem werkt met een eigen ERP of WMS dat geen standaardconnectoren heeft
  • De orderflow vereist aanvullende validatiestappen, zoals een identiteitscontrole voor zorgprofessionals of een autorisatielaag voor specifieke productcategorieën
  • Rapportage en audittrails moeten voldoen aan GDP- of andere farmaceutische kwaliteitsnormen
  • De koppeling moet meerdere systemen tegelijk aansturen, zoals een WMS, een ERP en een extern verzendplatform

MSA BV bouwt voor haar opdrachtgevers maatwerk API-koppelingen die de webshop direct verbinden met het interne Business Central-systeem. Dit maakt het mogelijk om orders automatisch te verwerken, voorraad per batch bij te houden en verzenddocumenten te genereren die voldoen aan de eisen van de farmaceutische distributieketen. Organisaties die op zoek zijn naar een partner die zowel de technische als de compliance-kant van een API-integratie fulfilment beheerst, kunnen terecht bij MSA voor een gesprek over de mogelijkheden.

De keuze voor maatwerk betekent een hogere initiële investering, maar levert een integratie op die volledig aansluit op de specifieke processen van de organisatie en die op lange termijn minder onderhoud en minder risico op complianceproblemen met zich meebrengt. Voor farmaceutische organisaties is dat geen luxe, maar een noodzaak. Meer informatie over de volledige dienstverlening van MSA BV is beschikbaar via de pagina Medical Solutions.

Related Articles