Alternatieve product-ID's gebruiken in orders

Leer hoe alternatieve ID-mapping Channable helpt om marketplace-orderregels te koppelen aan de juiste webshopproducten.

Gebruik alternatief-ID-mapping wanneer orderitems niet overeenkomen met producten. Dit gebeurt meestal wanneer marktplaatsen een andere identifier gebruiken dan je webshop.

Wat is een orderkoppeling?

Een orderkoppeling synchroniseert marketplace-orders naar je e-commerceplatform. Om een orderregel aan te maken, moet Channable elk orderitem koppelen aan een product.

Belangrijke termen (zodat de rest van deze pagina logisch is)

• Uniek ID (productidentifier van de webshop): De identifier die je e-commerceplatform gebruikt om naar een product te verwijzen (vaak een SKU, maar niet altijd).

• Alternatief ID: Een andere identifier die op hetzelfde product staat, zoals EAN/GTIN of MPN.

• Marketplace itemidentifier: De identifier die terugkomt in de orderdata. Dit is vaak Seller SKU.

Waarom unieke ID's belangrijk zijn

Unieke ID's koppelen het orderitem aan het juiste webshopproduct. Als de identifier in de order niet bestaat in je webshop, mislukt het aanmaken van de order.

Stel een uniek ID in in Channable

• Wanneer je in Channable een Api voor een marketplace instelt, moet je in de stap Instellingen het veld kiezen dat overeenkomt met het Uniek ID. Deze identifier wordt daarna naar de marketplace gestuurd en gebruikt om producten te koppelen.

• Concreet: wanneer er een order wordt geplaatst op de marketplace, gebruikt Channable dit Uniek ID om het product in de order te koppelen aan het bijbehorende product in je e-commerceplatform.

Uitdagingen met onjuiste of ontbrekende unieke ID's

• Problemen ontstaan als je producten niet oorspronkelijk via Channable op de marketplace zijn geplaatst, of als het Uniek ID afwijkt van het ID dat in je e-commerceplatform wordt gebruikt. In zulke gevallen kan Channable de producten in de orders niet koppelen.

• Deze mismatch zorgt voor een foutmelding dat het product niet kon worden gevonden, waardoor de order niet kan worden aangemaakt.

Daar helpt alternatief-ID-mapping bij.

Hoe alternatief-ID-mapping werkt

Wanneer je je producten in Channable importeert, houden we zowel de primaire identifiers uit je hoofd-importbron (je e-commerceplatform) bij als veelgebruikte alternatieve identifiers zoals EAN-codes en SKU-codes.

Bij het verwerken van een order kan Channable:

1. De identifier uitlezen die binnenkomt in de orderdata van de marketplace.

2. Proberen die waarde te koppelen aan bijgehouden alternatieve ID's (zoals EAN/GTIN).

3. Als er precies één match is, de webshop-orderregel aanmaken voor dat gematchte product.

Zo kun je orders verwerken, ook als marketplace-identifiers afwijken van de hoofdidentifier van je webshop.

Channable ondersteunt momenteel de volgende e-commerceplatforms en hun bijbehorende standaard identifier-velden:

Platform	Identifier-velden
BigCommerce	sku, GTIN
CCVShop	sku_number, ean, ean_number, mpn
Lightspeed Eseries	sku
Lightspeed	sku, article_code, ean
Magento	sku, ean
MijnWebWinkel	sku, uuid
Prestashop	ean13, GTIN, reference
Shopify	sku, GTIN
Shoptrader	sku, ean
Shopware	ean, article_number
Squarespace	sku
WooCommerce	sku

Als je identifier-velden wilt gebruiken die nu nog niet worden ondersteund, neem dan gerust contact op met ons Supportteam. We beoordelen je verzoek en nemen het mee voor toekomstige updates als dat haalbaar is.

Opmerking: Als je een tweede import toevoegt (zoals een CSV) en een identifierwaarde overschrijft, kunnen orders mislukken. Alternatief-ID-mapping is gebaseerd op identifiers die zijn vastgelegd uit je hoofd-importbron bij het koppelen van orderitems.

Wanneer je alternatief-ID-mapping gebruikt

Alternatief-ID-mapping is vooral handig in verschillende situaties om een nauwkeurige orderverwerking te garanderen. Veelvoorkomende situaties waarin deze functie nuttig is:

• Meerdere identifiers in gebruik

  • Situatie: je productvermeldingen op marketplaces gebruiken een mix van EAN-codes en SKU-codes als hoofdidentifier.

  • Voordeel: alternatief-ID-mapping helpt ervoor te zorgen dat orders correct worden gekoppeld aan de bijbehorende producten in je e-commerceplatform, ongeacht welke identifier de marketplace gebruikt.

• Verouderde systemen met verschillende ID-structuren

  • Situatie: je e-commerceplatform of ordermanagementsysteem gebruikt een andere ID-structuur dan wat de marketplace vereist.

  • Voordeel: met alternatief-ID-mapping kan Channable de kloof tussen verschillende ID-systemen overbruggen, zodat orders aan de juiste producten worden gekoppeld zonder handmatige tussenkomst.

• Overstappen tussen systemen

  • Situatie: je stapt over naar een nieuw e-commerceplatform of je ID-systeem wordt aangepast, en in die periode kunnen je producten zowel oude als nieuwe identifiers hebben.

  • Voordeel: alternatief-ID-mapping maakt het mogelijk om naadloos door te werken door beide sets identifiers te herkennen, waardoor verstoringen in de orderverwerking worden voorkomen.

Voordat je de functie inschakelt, controleer je de vastgelegde ID-mapping van je project. Zie de volgende sectie om deze gegevens te openen.

ID-mappinggegevens openen

Er zijn twee manieren om de ID-mappinggegevens te bekijken.

1

ID-mapping voor alle items bekijken

Op deze pagina kun je controleren welke ID-mappings Channable bijhoudt voordat je de functie activeert. Door deze gegevens te bekijken, kun je zeker weten dat alles goed is gemapt. Deze stap is belangrijk om mogelijke problemen te voorkomen die kunnen ontstaan als de functie wordt geactiveerd zonder goede controle.

Om een volledig overzicht te krijgen van eerdere en huidige ID-mappinggegevens voor alle items (dus niet alleen orders):

• Ga in je project naar Setup > Orders.

• Klik op de knop Alternatief-ID-mapping. Er verschijnt een pop-up met alle eerdere en huidige records van gemapte ID's voor je producten.

Overzicht alternatief-ID-mapping (alle items).

• Gebruik het zoekveld rechtsboven in de pop-up om de records te filteren op ID, Titel of andere criteria, zodat je makkelijker navigeert.

Filter mappingrecords op ID, titel of andere velden.

2

ID-mapping voor items die in orders worden gebruikt bekijken

Om eerdere en huidige records van items die in orders worden gebruikt te bekijken:

• Ga in je project naar de pagina Orders en klik op Alternatief-ID-mapping.

• Bekijk zowel eerdere als huidige ID-mappingrecords voor alle items die in orders worden gebruikt.

Alternatief-ID-mappingrecords gebruikt in orders.

Uitleg van de kolommen in de ID-mappinginterface

• Uniek ID: de identifier die je e-commerceplatform gebruikt om naar het product te verwijzen.

• Alternatief ID: het type identifier dat Channable bijhoudt, zoals SKU of EAN/GTIN.

• Waarde: de daadwerkelijke waarde van het alternatief ID (bijvoorbeeld de specifieke SKU- of EAN-code).

• Aangemaakt: de datum en tijd waarop het mappingrecord is aangemaakt.

• Status: geeft aan of de mapping momenteel actief of inactief is.

Voordat je alternatief-ID-mapping inschakelt

Controleer eerst deze punten. Dat scheelt later tijd.

• Controleer welke identifier de marketplace terugstuurt in de orderdata (meestal Seller SKU).

• Controleer of die identifier ergens staat op het overeenkomende webshopproduct.

  • Voorbeeld: de marketplace stuurt EAN, maar bij je webshopproduct is EAN leeg.

• Controleer op duplicaten bij alternatieve ID's.

  • Voorbeeld: twee producten hebben dezelfde EAN/GTIN.

• Controleer of een tweede import identifiers overschrijft die voor matching worden gebruikt.

Gedetailleerde setup-checklist (aanbevolen)

Gebruik deze checklist voordat je de instelling inschakelt. Zo voorkom je de meeste “product niet gevonden”-problemen.

1

1) Kies je matchstrategie

Kies één identifier waarop je orders wilt matchen.

Veelvoorkomende keuzes:

• SKU: het beste als elk verkoopbaar item een stabiele SKU heeft.

• EAN/GTIN: het beste als elk verkoopbaar item een geldige barcode heeft.

Vermijd het mixen van identifiers over verschillende listings, tenzij het echt niet anders kan.

2

2) Controleer of het gekozen ID bestaat op het verkoopbare item (vaak varianten)

Controleer je productcatalogus op het gekozen ID:

• Het moet bestaan op het variant niveau als je varianten verkoopt.

• Het moet ingevuld zijn voor de producten die je op de marketplace verkoopt.

Controleer minstens 10 items steekproefsgewijs:

• 3 eenvoudige producten

• 3 variantproducten (meerdere maten/kleuren)

• 2 bestsellers

• 2 “probleem”-producten die eerder zijn mislukt

3

3) Controleer de consistentie van de opmaak

Matching is exact. Kleine verschillen zorgen ervoor dat het mislukt.

Controleer op:

• Spaties aan het begin/einde

• Andere hoofdletters/kleine letters (vooral relevant voor SKU's)

• Verdwijnende voorloopnullen (vaak bij CSV-exports)

• Andere scheidingstekens (SKU-001 vs SKU001)

Los de opmaak eerst op in je bronsysteem.

4

4) Haal duplicaten weg voor het gekozen alternatieve ID

Duplicaten zorgen voor het scenario “meerdere matches gevonden”. Dan kan Channable niet betrouwbaar één product kiezen.

Controleer in je catalogus op duplicaten voor het gekozen ID:

• Als twee producten dezelfde EAN/GTINdelen, pas dan één waarde aan of verwijder die.

• Als er tijdelijke SKU's bestaan (NA, 0, DEFAULT), vervang ze dan.

Als je niet kunt dedupliceren, kies dan een andere matchstrategie.

5

5) Controleer of je hoofd-import de bron van waarheid is

Alternatief-ID-mapping is gebaseerd op identifiers die zijn vastgelegd uit je hoofd-importbron.

Voor het inschakelen:

• Zorg dat je hoofd-import de juiste SKU/EAN-waarden bevat.

• Voorkom dat je die identifiers overschrijft via een tweede import (zoals CSV-verrijking).

Als je identifiers via CSV moet importeren, houd het dan consistent en houd rekening met een overgangsperiode.

6

6) Controleer de records van alternatief-ID-mapping

Open het mappingoverzicht en controleer wat Channable heeft vastgelegd. Zie ID-mappinggegevens openen.

Waar je op moet letten:

• Ontbrekende alternatieve ID's voor producten die je verkoopt

• Dubbele waarden over verschillende producten heen

• Oude/verouderde waarden na een migratie

7

7) Schakel in en valideer met een kleine steekproef

Schakel Gebruik alternatieve ID's voor orderitems in op de orderkoppeling.

Valideer daarna met minstens één:

• Eerder mislukte order (ideaal), of

• Nieuwe binnenkomende order

Controleer beide:

• De order wordt succesvol aangemaakt.

• De juiste variant wordt gematcht.

8

8) Rol uit en monitor

Zodra de matching klopt:

• schakel het in bij andere orderkoppelingen (als je die hebt).

• Monitor op “product niet gevonden” en “meerdere matches gevonden”.

Als de foutmeldingen toenemen, los dan eerst de catalogusdata op. Vermijd workarounds die zorgen voor nog meer inconsistentie in identifiers.

Alternatief-ID-mapping inschakelen

1

Vink het selectievakje aan Gebruik alternatieve ID's voor orderitems bij de orderkoppeling die je wilt inschakelen.

Alternatieve ID's gebruiken voor orderitems.

2

Klik op Opslaan. Daarna kun je alternatief-ID-mapping (Setup > Orders) openen om de bijgehouden mappings te controleren.

Wat deze instelling niet doet

Alternatief-ID-mapping helpt orderitems te koppelen aan bestaande webshopproducten. Het doet niet:

• De identifier wijzigen die je naar een marketplace stuurt wanneer je producten plaatst.

• Dubbele EAN/SKU-waarden in je webshopcatalogus oplossen.

• Garanderen dat een order wordt aangemaakt wanneer de marketplace onbekende productidentifiers verstuurt.

Scenario's voor het koppelen van alternatieve identifiers

Alternatieve identifiers zoals EAN- en SKU-codes zijn niet altijd uniek. In je productcatalogus kun je meerdere producten hebben met dezelfde EAN of producten zonder EAN helemaal. Channable koppelt de juiste database-ID van het e-commerceplatform op basis van de alternatieve identifier die van de marketplace wordt ontvangen.

We controleren of er database-ID's van het e-commerceplatform overeenkomen met de product-ID uit de orderdata voor alle alternatieve identifiers die worden bijgehouden. Er kunnen drie scenario's voorkomen:

1

Geen matches gevonden

Channable kan de marketplace-identifier niet koppelen aan een webshopproduct. Channable probeert de order aan te maken met de marketplace-identifier. Dit kan mislukken als je webshop die identifier niet herkent.

Oplossing: voeg het ontbrekende alternatieve ID toe aan het webshopproduct, of pas aan wat de marketplace verstuurt.

2

Exact één match gevonden

Channable vindt één webshopproduct dat overeenkomt met de marketplace-identifier. Channable maakt de orderregel aan voor dat gematchte webshopproduct.

3

Meerdere matches gevonden

• Identieke waarden over identifiers heen: Channable kan meerdere alternatieve identifier-waarden bijhouden voor je e-commerceplatform (bijvoorbeeld zowel SKU als EAN), en beide hebben identieke waarden voor een product. In dat geval is er één database-ID van het e-commerceplatform, en de order wordt aangemaakt met dat ene database-ID. Channable controleert of de database-ID van het e-commerceplatform dat gekoppeld is aan het gematchte SKU- en EAN-record hetzelfde is.

• Meerdere producten met dezelfde identifier: meerdere losse producten in je e-commerceplatform delen dezelfde waarde voor een alternatief ID. Channable kan dan niet de juiste kiezen. Channable valt terug op de marketplace-identifier bij het aanmaken van de order. Dit kan een fout bij het aanmaken van de order in je webshop veroorzaken.

Oplossing: haal dubbele waarden uit je webshop, of wijzig welke identifier de marketplace gebruikt.

Snelle controles voor troubleshooting

Als je na het inschakelen van de instelling nog steeds “product niet gevonden” ziet, is het meestal een van deze oorzaken.

• De waarde van het alternatieve ID is leeg op het webshopproduct.

• De marketplace stuurt een andere identifier dan je verwacht.

  • Voorbeeld: je verwachtte EAN, maar er wordt Seller SKU gestuurd.

• De waarde van het alternatieve ID bestaat, maar is dubbel aanwezig in meerdere producten.

• Een tweede import heeft identifierwaarden overschreven nadat ze waren vastgelegd.