Marktplaatsintegratie: bol, Amazon en Zalando vanuit PIM

Een marktplaatsintegratie vanuit PIM (Product Information Management) werkt het best als je per platform één mapping onderhoudt van jouw datamodel naar dat van de marktplaats, met validatie vóór verzending. bol, Amazon en Zalando hebben elk een eigen classificatie, eigen verplichte velden en een eigen controle. Het PIM-systeem blijft de bron voor productinhoud. Prijs, voorraad en orders lopen via ERP of OMS. Voor de marktontwikkeling zelf, zie de marktplaatseconomie.

Wat vragen bol, Amazon en Zalando van je productdata?

De drie platforms delen een basis: een geldige productcode per variant, complete kenmerken per categorie en beelden volgens hun richtlijnen. De uitwerking verschilt sterk.

Bronnen: bol Product Content API en Partnerplatform, Amazon SP-API-modellen, Zalando Partner University. Voor Amazon steunt de regel over GTIN-toetsing op GS1 Australia.

Hoe werkt de bol Product Content API?

De Product Content API van bol (Retailer API v10) maakt of wijzigt content per EAN. Voor een nieuw product geef je de GPC-code mee, het id van de chunk in het bol-datamodel. Dat datamodel is een JSON-bestand dat bol dagelijks bijwerkt, met per chunk de kenmerken, de toegestane waarden (lovs) en het enrichmentLevel. Niveau 0 en 1 zijn verplicht om te publiceren.

De verwerking is asynchroon. Je wacht minstens een uur voordat je het uploadrapport opvraagt, en dat rapport blijft 28 dagen beschikbaar. Per kenmerk en per asset zie je de status PUBLISHED of DECLINED, met een substatus zoals REJECTED. Een update bevat één bestaand product per verzoek.

Let op deze details in je mapping:

1. Beschrijvingen accepteren alleen de HTML-tags b, br, h3, li, ol, ul, p en strong.
2. Beelden krijgen een of twee labels uit de chunk, die de positie in de carrousel bepalen.
3. Video moet een directe bestands-URL zijn; een YouTube-link is ongeldig.
4. In chunks die het vragen, is een geldig CE MARKING-asset verplicht, anders gaat het product offline.
5. De Offers API v10 is deprecated en is vanaf 1 februari 2027 niet meer beschikbaar; bol adviseert v11 voor nieuwe koppelingen.

bol toont de content van de partner met de hoogste contentscore, berekend per categorie. Als merkeigenaar kun je via merkregistratie de content van je eigen merkartikelen beheren.

Hoe werkt de Amazon Selling Partner API voor listings?

Amazon werkt met producttypes. De Product Type Definitions API (versie 2020-09-01) levert per producttype en marktplaats een JSON Schema met alle attributen en eisen. Dat schema gebruik je voor de Listings Items API, de Catalog Items API en JSON-feeds. Met de parameter requirements kies je wat je aanlevert: productfeiten en verkoopvoorwaarden samen (LISTING), alleen productfeiten (LISTING_PRODUCT_ONLY) of alleen het aanbod (LISTING_OFFER_ONLY).

De Listings Items API (versie 2021-08-01) kent de operaties putListingsItem, patchListingsItem, getListingsItem, deleteListingsItem en searchListingsItems. Met mode=VALIDATION_PREVIEW controleert Amazon je data zonder iets op te slaan. De reactie noemt per issue de attribuutnamen, bijvoorbeeld een ontbrekende maat.

Voor een PIM-koppeling betekent dit: haal het schema per producttype op, sla het op als kanaaldefinitie en valideer je export daartegen. Met parentageLevel CHILD of PARENT krijg je een vereenvoudigd schema voor variantkinderen of de parent.

Wat vraagt Zalando bij onboarding?

Zalando vraagt een geldige EAN van 13 cijfers voor elk artikel. Beelden en content volgen de richtlijnen; beelden die daar niet aan voldoen, worden bij de artikelvalidatie afgekeurd. Nieuwe merken sturen hun merklogo naar de onboarding manager, en je bereidt maatcodes voor per merk en silhouet. Het lanceringsassortiment schat je samen met je Sales Manager per style en kleur.

De beeldrichtlijnen zijn streng: staand formaat 1:1,44, best practice 1801 x 2600 pixels, minimaal 762 x 1100, alleen JPG, maximaal 20 MB, sRGB. Kleding, accessoires en schoenen vragen minimaal drie beelden. AI-gegenereerde beelden moeten uiterlijk december 2026 een onzichtbare markering in metadata of bestand hebben. Per verkoopland gelden GPSR-eisen in de officiële talen en EPR-registraties voor verpakkingen en batterijen. Hoe je kleur en maat als varianten opzet, lees je in de maat-kleurmatrix beheren.

Welke compliancevelden horen erbij?

Sinds 13 december 2024 geldt de GPSR (Verordening (EU) 2023/988). Artikel 19 vraagt bij verkoop op afstand de fabrikantgegevens, bij een fabrikant buiten de EU de verantwoordelijke persoon, een productidentificatie met afbeelding en de waarschuwingen in begrijpelijke taal. bol handhaaft dit: nieuw assortiment zonder fabrikantgegevens gaat sinds 5 maart 2026 niet meer online, zonder verantwoordelijke marktdeelnemer sinds 1 april 2026. Bestaande artikelen haalt bol geleidelijk offline. Dit is algemene informatie, geen juridisch advies.

Leg deze gegevens daarom als gestructureerde attributen vast op merk- of leveranciersniveau en laat ze overerven naar het artikel. Voor energielabels en EPREL-data, zie energielabels en EPREL.

Hoe richt je de koppeling in?

Voorbeeld: een Nederlandse webwinkel in keukenapparatuur met 6.000 SKU's verkoopt via de eigen webshop, bol en Amazon.de. Het team bouwt in het PIM-systeem per kanaal een kanaalprofiel:

1. Het bol-datamodel wordt wekelijks geïmporteerd; elke productfamilie is gekoppeld aan een chunk.
2. Een validatieregel blokkeert export zolang enrichmentLevel 0 of 1 onvolledig is.
3. Voor Amazon haalt een connector het schema per productType op en draait eerst een VALIDATION_PREVIEW.
4. Het uploadrapport van bol en de issues van Amazon komen terug in het PIM-systeem als kanaalstatus per SKU.
5. Prijs en voorraad gaan rechtstreeks van ERP naar de marktplaatsen.

Of je de mapping in het PIM-systeem bouwt of in een feedmanagementtool, hangt af van het aantal kanalen. De afweging staat in PIM vs feedmanagement. Leveranciers bieden hiervoor uiteenlopende routes. Akeneo Activation syndiceert naar meer dan 500 retailers en marktplaatsen, Plytix bouwt feeds voor onder meer bol, Zalando en Amazon, en Productsup heeft een kantoor in 's-Hertogenbosch en koppelingen met bol en Kaufland. De feedkant voor advertentiekanalen staat in productfeeds beheren, het bredere kanaalbeeld in omnichannel productinformatie.

Belangrijkste punten

• Geef elke variant een eigen EAN en leg die per SKU vast; bol en Zalando weigeren content zonder geldige code.
• Importeer het bol-datamodel en de Amazon-producttypeschema's periodiek en map je attributen daarop per kanaal.
• Valideer vóór verzending: blokkeer op enrichmentLevel 0 en 1 bij bol en gebruik VALIDATION_PREVIEW bij Amazon.
• Leg GPSR-gegevens van fabrikant en verantwoordelijke marktdeelnemer gestructureerd vast; bol handhaaft dit sinds maart en april 2026.
• Haal uploadrapporten en issues terug als kanaalstatus in het PIM-systeem, zodat je team per SKU ziet wat ontbreekt.