Alles over ChannelEngine

ChannelEngine: Producten naar ChannelEngine sturen

Stuur producten uit je webshop of ERP naar ChannelEngine, inclusief afbeeldingen, categorieën, attributen en voorraad. APIcenter maakt of werkt ze bij.

Bijgewerkt op 9 november 2026

Deze flow stuurt producten uit een andere applicatie, zoals je webshop of ERP, naar ChannelEngine. APIcenter maakt het product aan in ChannelEngine, of werkt het bij als het al bestaat. Daarna werkt APIcenter ook de voorraad bij.

Hoe een product wordt verwerkt

APIcenter controleert of het productnummer (Merchant product number), de naam en de prijs zijn ingevuld. Ontbreekt er één, dan mislukt het product.
APIcenter laat het veld voor het bovenliggende productnummer weg. Elk product wordt dus op zichzelf naar ChannelEngine gestuurd.
APIcenter bouwt de categorie op als pad, met de categorieën gescheiden door >, bijvoorbeeld Kleding>Heren>Jassen. Het pad volgt de bovenliggende categorieën vanaf de laatste categorie die je meestuurt.
De eerste afbeelding wordt de hoofdafbeelding. Elke volgende afbeelding wordt een extra afbeelding.
Elk attribuut wordt in ChannelEngine een extra veld (ExtraData) met de naam als sleutel. Is er geen type opgegeven, dan gebruikt APIcenter het type tekst. Het veld is openbaar.
APIcenter zoekt het product in ChannelEngine op het productnummer. Bestaat het product, dan werkt APIcenter het bij. Bestaat het niet, dan maakt APIcenter het aan. Beide gaan met dezelfde gegevens.
APIcenter werkt de voorraad bij, per locatie. Zie hieronder.

ChannelEngine vervangt bij het bijwerken het hele product door de gegevens die APIcenter stuurt. Een veld dat je niet meestuurt, wordt in ChannelEngine leeggemaakt. Stuur dus altijd alle velden mee die je in ChannelEngine wilt houden.

De voorraad

APIcenter haalt de voorraadlocaties (stock locations) uit ChannelEngine op.
Heeft het product een locatiecode, dan zoekt APIcenter de locatie met dezelfde naam. Is er geen locatiecode of vindt APIcenter geen locatie met die naam, dan gebruikt APIcenter locatie 1.
Per locatie stuurt APIcenter de voorraad naar ChannelEngine.
Vindt APIcenter in ChannelEngine geen voorraadlocaties, dan wordt het product wel verstuurd, maar eindigt de flow met de waarschuwing dat de voorraad niet kan worden bijgewerkt.
Geeft ChannelEngine bij het bijwerken van de voorraad een melding terug, dan eindigt de flow met een waarschuwing met die melding.
Meer dan één voorraadlocatie gebruiken kan alleen als je ChannelEngine-account daarvoor is ingericht. Zie ChannelEngine: advanced order management.

Wat de data mapping omvat

Standaard stuurt APIcenter mee: het productnummer, de naam, de prijs inclusief btw, de omschrijving, het merk, de EAN, de afbeeldingen, de categorieën met hun bovenliggende categorie, de attributen en de voorraad per locatie. Andere velden van ChannelEngine voeg je toe onder Data mapping, zoals de kleur, de maat, de verzendkosten, de verzendtijd, de adviesprijs (MSRP), de inkoopprijs, het btw-type en het productnummer van de fabrikant. Zie Data mapping.

Wat je eerst nodig hebt

ChannelEngine is gekoppeld. Zie ChannelEngine koppelen aan APIcenter.
De andere applicatie van de integratie kan producten versturen, met minimaal een productnummer, een naam en een prijs.
Als je de voorraad wilt bijwerken: minimaal één voorraadlocatie in ChannelEngine.

Tips

Gebruik bij elk product hetzelfde productnummer als in je andere systeem. ChannelEngine herkent een bestaand product aan dat nummer.
Weigert ChannelEngine een product? Dan mislukt het record en staat de reactie van ChannelEngine in de activiteit. Zie ChannelEngine: veelvoorkomende fouten.
Wil je alleen de voorraad bijwerken? Gebruik dan Voorraad naar ChannelEngine sturen.
Staan er negatieve prijzen in je gegevens? Zie Skip negativity flip process.

Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.

Instellingen

De instellingen die je in het dashboard ziet, met wat elke instelling doet.

What to do with a value that cannot be mapped using the mapping table

Attributes & Features

Hier kies je wat er gebeurt met een attribuut dat niet in de mappingtabel staat. Met Waarde gebruiken blijft de oorspronkelijke waarde behouden. Met Waarde negeren wordt het attribuut helemaal weggelaten. De standaardkeuze is Standaardwaarde gebruiken.

Use administration mapping table

General flow setting

Zet dit aan om de administratie om te zetten met een koppeltabel tussen de twee applicaties. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.

What to do with a value that cannot be mapped using the mapping table

General flow setting

Hier kies je wat er gebeurt met een administratie die niet in de koppeltabel staat. Bij Waarde negeren wordt de waarde leeggelaten, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken wordt de standaardwaarde uit Default administration id gebruikt, als je die hebt ingeschakeld. Deze instelling werkt alleen als Use administration mapping table aanstaat. Standaard is Standaardwaarde gebruiken gekozen.

Enrichement level to use as default

Marketplace Settings

Hier bepaal je het niveau van verrijking dat APIcenter standaard gebruikt bij het aanmaken van nieuwe productcontent. Je ziet deze instelling als Make use of a company owned EAN range aan staat. De standaardwaarde is uit.

Notifications Slack webhook

Notifications

Vul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. Er is geen standaardwaarde.

Notifications frequency

Notifications

Kies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.

Only update existing variants and don't create new ones

Product Settings

Deze instelling heeft geen effect voor ChannelEngine. APIcenter laat het veld voor het bovenliggende productnummer weg en maakt of werkt elk product bij op zijn eigen productnummer. Nieuwe producten worden dus altijd aangemaakt, ook als deze instelling aanstaat.

Skip negativity flip process