Verrijking

Vul bestaande Smart Products aan met gegevens uit een extra CSV-, JSON- of XML-bestand.

Waarvoor gebruik je Verrijking?

Met Verrijking voeg je gegevens uit een aanvullend bestand toe aan bestaande Smart Products. Denk aan voorraad uit een magazijnbestand, extra kenmerken van een leverancier, inkoopinformatie of aanvullende teksten die niet in de hoofdbron staan.

Deze functie werkt gelijk voor alle databronnen. Daarom staat de handleiding centraal onder Databronnen → Algemeen → 8. Verrijking en openen de verwijzingen onder de afzonderlijke brontypen hetzelfde artikel.

Verrijking met een bestand is iets anders dan AI-verrijking. Het scherm gebruikt de waarden die je aanlevert en genereert zelf geen productinformatie.

Hoe werkt de koppeling?

Een verrijkingsbestand maakt geen nieuwe producten. Nifelo zoekt voor iedere rij een bestaand Smart Product binnen dezelfde databron. Hiervoor koppel je:

een identificatieveld binnen Nifelo, standaard sku;
de kolom in het aanvullende bestand met dezelfde identiteit.

Wanneer beide waarden exact bij elkaar passen, worden de overige velden uit die rij met het product samengevoegd. Rijen zonder match worden niet aan een product toegevoegd. Controleer daarom hoofdletters, voorloopnullen, spaties en de gebruikte variantidentiteit.

Gebruik een identifier die voor ieder product of iedere variant uniek en stabiel is. SKU is meestal geschikt. Kies alleen een ander Smart Field wanneer dat in beide bestanden betrouwbaar dezelfde waarde bevat.

Ondersteunde bestanden

Je kunt een bestand van maximaal 20 MB uploaden in:

CSV;
JSON;
XML.

De extensie en werkelijke bestandsinhoud moeten overeenkomen. Gebruik een consistente tabelstructuur met één product of variant per rij en duidelijke veldnamen. Het bestand moet minstens een bruikbare identificatiekolom bevatten.

Bestand uploaden

Sleep het bestand naar het uploadvak of klik om het te selecteren. Na de upload staat het bestand eerst klaar om te worden gekoppeld.

Open Koppelen en kies vervolgens:

het Smart Field waarmee Nifelo bestaande producten moet zoeken;
de overeenkomstige kolom uit het bestand;
of het bestand bij toekomstige imports automatisch opnieuw moet worden toegepast.

Klik daarna op starten. Nifelo leest alle rijen, zoekt de overeenkomende producten en toont hoeveel producten zijn bijgewerkt.

Matchresultaat begrijpen

Het totaal is het aantal gelezen rijen. Het aantal gekoppelde of bijgewerkte producten is het aantal rijen waarvoor een bestaande productidentiteit is gevonden.

Een lager aantal matches kan ontstaan door ontbrekende identifiers, verschillende opmaak, dubbele waarden, een verkeerde kolomkeuze, product- tegenover variant-SKU's of producten die nog niet zijn geïmporteerd.

Controleer een onverwacht resultaat eerst met een kleine steekproef. Een verwerkte rij betekent dat de identiteit is gevonden; controleer op de Producten-pagina ook of de bedoelde velden de juiste waarden hebben gekregen.

Welke velden worden toegevoegd?

Naast de identificatiekolom behandelt Nifelo de overige kolommen als aanvullende productgegevens. Gebruik bij voorkeur namen die overeenkomen met bestaande Smart Fields, bijvoorbeeld brand, material, color, stock of een goedgekeurd aanvullend veld.

Onbekende kolomnamen kunnen als aanvullende gegevens worden opgeslagen, maar zijn niet automatisch bruikbaar voor validatie of verkoopkanalen. Richt structurele velden daarom eerst goed in bij Slimme velden.

Voorrang en bescherming van waarden

Verrijking wordt per veld samengevoegd en vervangt niet blind het hele product.

Een echte klantwijziging met lokale voorrang wordt niet door een verrijkingsbestand overschreven.
Beschermde afgeleide waarden, zoals succesvolle AI- of kennisverrijking, worden niet zomaar vervangen.
Een reeds door een regel of afgeleide verwerking gevulde waarde blijft behouden; een lege waarde kan wel worden aangevuld.
Andere bronwaarden kunnen door de nieuwe verrijkingswaarde worden aangevuld of vervangen.

De herkomst wordt bij het veld vastgelegd met de bestandsnaam. Daardoor is op de Producten-pagina onder Verrijking zichtbaar welk bestand heeft bijgedragen.

Gebruik een verrijkingsbestand alleen voor gegevens waarvoor dit bestand een betrouwbare bron is. Zet geen lege of verouderde kolommen in het bestand wanneer die bestaande goede waarden niet mogen beïnvloeden.

Automatisch toepassen bij imports

Schakel Automatisch toepassen in wanneer hetzelfde bestand na iedere volgende hoofdimport opnieuw moet worden verwerkt. Nifelo past actieve verrijkingsbestanden dan na de hoofdbron toe met de opgeslagen identificatiekoppeling.

Dit is nuttig voor een blijvende aanvullende dataset. Let wel op:

Nifelo gebruikt de laatst geüploade inhoud van het bestand;
het bestand wordt niet automatisch vanaf een externe URL vernieuwd;
nieuwe producten krijgen alleen verrijking wanneer hun identiteit in het bestand staat;
wijzigingen in kolomnamen of identifiers vereisen een nieuwe controle van de koppeling.

Laat automatisch toepassen uit voor een eenmalige correctie of een bestand dat snel veroudert.

Koppeling aanpassen en opnieuw verwerken

Met Bewerken kun je het identificatieveld, de bestandskolom en automatisch toepassen wijzigen. Wanneer je opnieuw start, wordt het bestand opnieuw over de actuele producten verwerkt.

Kies niet op goed geluk een andere identifier. Een verkeerde maar toevallig overeenkomende waarde kan gegevens aan het verkeerde product koppelen. Test belangrijke bestanden eerst met een beperkte en controleerbare selectie.

Een verrijkingsbestand verwijderen

Verwijderen wist het opgeslagen uploadbestand en de configuratie voor toekomstige automatische toepassing.

Verwijderen is geen terugdraaiactie. Waarden die eerder in Smart Products zijn geschreven, worden niet automatisch naar hun vorige toestand hersteld.

Moeten bestaande waarden worden hersteld, corrigeer ze dan via de gezaghebbende bron, een gecontroleerd nieuw verrijkingsbestand of een beschikbare veldhistorie. Voer daarna de benodigde import en validatie uit.

Controle na verwerking

Controleer na iedere belangrijke verrijking:

het aantal gelezen en gekoppelde rijen;
enkele gematchte en niet-gematchte identifiers;
de aangepaste velden op de Producten-pagina;
de herkomst onder het tabblad Verrijking van een product;
Data Validatie en Coverage & analyse;
de gevolgen voor een verkoopkanaal voordat je exporteert.

Aanbevolen werkwijze

Importeer eerst de actuele hoofdbron.
Maak een schoon aanvullend bestand met één stabiele identifier per rij.
Gebruik herkenbare Smart-Fieldnamen voor de overige kolommen.
Upload het bestand en controleer de voorgestelde kolommen.
Koppel het juiste Nifelo-identificatieveld aan de juiste bestandskolom.
Schakel automatisch toepassen alleen in voor een blijvende, actuele dataset.
Verwerk het bestand en beoordeel het matchresultaat.
Controleer een steekproef van producten en hun veldherkomst.
Herstel structurele fouten in de bron of mapping.
Controleer validatie en het verkoopkanaal voordat je publiceert.