inRiver koppeling met je webshop: complete productdata uit inRiver in je shop

Wat is inRiver en wie gebruikt het?

inRiver is een PIM: een centraal systeem voor productinformatie dat als cloudomgeving draait. Merken, fabrikanten en groothandels gebruiken het om productteksten, kenmerken, vertalingen en beelden op één plek bij te houden en naar webshops, marktplaatsen en catalogi te sturen.

Het datamodel ligt niet vast. De entiteitstypen, zoals een product en de artikelen per maat en kleur daaronder, de koppeltypen tussen die entiteiten en de velden per type worden per omgeving ingericht. Elk veld heeft een datatype dat bepaalt wat de koppeling terugkrijgt:

Wat je met inRiver koppelt

inRiver is leidend voor wat een artikel is. Het ERP is leidend voor het artikelnummer, de prijs en de voorraad. De webshop toont wat beide aanleveren.

Een kanaal in inRiver is een selectie van entiteiten in een eigen structuur, bijvoorbeeld het assortiment voor de Nederlandse webshop. De koppeling leest dan alleen wat in dat kanaal staat, met de categorieën uit de knooppunten van het kanaal. Hoe productdata in het algemeen tussen systemen loopt, staat op productdata koppelen.

Hoe inRiver data vrijgeeft

REST API met een sleutel in de header

inRiver heeft een REST API met JSON. Elk verzoek draagt de header X-inRiver-APIKey. Het adres hangt af van de regio van je omgeving, zoals apieuw.productmarketingcloud.com of apiuse.productmarketingcloud.com. Elk endpoint noemt in de documentatie welke rechten nodig zijn, bijvoorbeeld View voor lezen en View, AddEntity en UpdateEntity voor een upsert. De sleutel van de koppeling krijgt alleen die rechten. De API-referentie van inRiver staat als Swagger-pagina online.

Eerst zoeken, dan ophalen

Lezen gaat in twee stappen. POST /query geeft een lijst entity id's terug. De zoekvraag kan filteren op systeemkenmerken:

{
  "systemCriteria": [
    { "type": "EntityTypeId", "value": "Item", "operator": "Equal" },
    { "type": "LastModified", "value": "2026-10-03T09:00:00", "operator": "GreaterThan" },
    { "type": "Completeness", "value": 100, "operator": "Equal" }
  ]
}

Daarna haalt entities:fetchdata de gegevens op voor maximaal 1.000 id's per verzoek. Met objects kies je wat er meekomt, zoals FieldValues, Media en SpecificationValues, en met fieldTypeIds welke velden. De documentatie raadt aan zo weinig mogelijk objecten op te vragen, omdat elk object het antwoord trager maakt.

De rekensom voor een catalogus van 18.000 artikelen:

Een rate limit staat niet in de API-referentie. De koppeling meet de antwoordtijd per verzoek en vraagt bij een volle catalogus de velden per blok op in plaats van alles tegelijk.

Schrijven met upsert

entities:upsert neemt een lijst entiteiten aan met een keyFieldTypeIds: de velden waarop inRiver een bestaande entiteit zoekt, bijvoorbeeld het artikelnummer. Bestaat hij, dan wordt hij bijgewerkt, anders aangemaakt. Het antwoord heeft insertedEntities, updatedEntities, een errors-lijst en errorCount. Een upsert van 500 artikelen met 3 fouten slaagt voor 497. De koppeling leest errorCount bij elk antwoord en zet de 3 op een controlelijst.

Waar het bij inRiver op vastloopt

Koppelingen tussen entiteiten

Een upsert kan ook de koppelingen meesturen, bijvoorbeeld welke artikelen onder welk product vallen. Standaard laat inRiver bestaande koppelingen die niet in het verzoek staan met rust (staleLinkAction: None). Met Unlink worden ze verwijderd, met UnlinkAndDeleteOrphans ook de entiteiten die daarna nergens meer aan hangen. Een ERP-import die per verzoek één maat aanlevert, maakt met Unlink de andere maten los van het product. De koppeling bepaalt per type koppeling welke actie geldt.

Talen

Bij het wijzigen van een LocaleString houdt inRiver de waarde vast voor elke taal die niet in het verzoek staat. Een taal die wel meekomt, wordt bijgewerkt met wat er staat. Stuurt een ERP dat alleen Nederlands kent een leeg Duits veld mee, dan is dat een wijziging van de Duitse omschrijving naar leeg. De koppeling stuurt alleen de talen mee waarvoor de bron leidend is. Meer over dit soort mismatches staat in wat is veldmapping.

Keuzelijsten

Een CVL-waarde heeft een key, een value met het label, optioneel een parentKey en de vlag deactivated. Het artikel bewaart de sleutel, bijvoorbeeld BLK; de webshop moet "Zwart" tonen. De koppeling bouwt per CVL een tabel van sleutel naar label per taal en ververst die bij elke ronde, zodat een nieuw label zonder aanpassing doorkomt. Hoe kenmerken als varianten in de webshop landen staat op varianten.

Platformen die we aan inRiver koppelen

De koppeling wordt gebouwd op jouw model en jouw webshop. Wat het platform aan de ontvangende kant vraagt, staat op de pagina van dat platform:

• Shopify koppeling
• WooCommerce koppeling
• Magento koppeling
• Shopware koppeling
• BigCommerce koppeling

Werk je met een ander PIM, zie dan Akeneo koppeling, Pimcore koppeling of Salsify koppeling. Het overzicht van alle stromen staat op koppelingen.

Wij bouwen de koppeling voor een vaste prijs, en hosten, draaien en bewaken hem daarna voor een vast bedrag per maand. Voor de livegang draait hij als dry run: je ziet per artikel welke velden, labels en beelden er in de webshop zouden komen, zonder dat er iets wijzigt. Vertel welk model en welke webshop je hebt, dan hoor je welke velden en kanalen de koppeling leest en wat een ronde kost.