Slimme velden voor Shopify

Lees hoe Shopify-kernvelden automatisch en gecontroleerd aan de productstructuur van Nifelo worden gekoppeld.

Wat zijn Shopify Slimme velden?

Shopify levert productdata met een vaste technische structuur. Nifelo koppelt de belangrijkste Shopify-velden automatisch aan de gestandaardiseerde interne productstructuur: de Slimme velden.

Hierdoor kunnen dezelfde productgegevens worden gebruikt voor productoverzicht, categorisatie, AI-verrijking, normalisatie, validatie en verkoopkanalen zonder dat je de Shopify-kernvelden eerst handmatig hoeft te mappen.

De Shopify-kernmapping wordt door Nifelo beheerd en is read-only. Dit voorkomt dat essentiële product- en variantvelden per ongeluk verkeerd worden gekoppeld.

Welke velden worden automatisch gekoppeld?

Het gecontroleerde Shopify-cataloguscontract verwerkt onder andere:

Shopify Product-ID;
Shopify Variant-ID;
titel en beschrijving;
SKU en barcode/EAN;
verkoopprijs en vergelijkingsprijs;
vendor/merk;
producttype;
tags;
product- en variantinformatie die onderdeel is van het ondersteunde contract.

De exacte beschikbare waarden hangen af van wat in Shopify voor het product en de varianten is ingevuld.

Waarom zijn de kernvelden read-only?

Product-ID en Variant-ID bepalen welk Shopify-product en welke variant bij een record horen. Ook prijs, SKU en barcode moeten uit de juiste Shopify-eigenschap komen. Een verkeerde handmatige mapping kan producten verwisselen, varianten verkeerd groeperen of onjuiste gegevens in verdere processen gebruiken.

Daarom toont Nifelo deze mappings als beheerd. Je kunt ze controleren, maar niet vervangen door een willekeurig ander bronveld.

Maak geen tweede Slim veld aan met dezelfde betekenis als een bestaand beheerd Shopify-veld.

Producten en varianten

Een Shopify-product kan meerdere varianten bevatten, bijvoorbeeld verschillende maten of kleuren. Nifelo gebruikt de vaste product- en variant-ID’s om:

varianten bij het juiste hoofdproduct te houden;
SKU, barcode, prijs en voorraad per variant te herkennen;
productgegevens en variantgegevens van elkaar te onderscheiden;
latere updates opnieuw aan hetzelfde Shopify-record te koppelen.

Controleer na de eerste import altijd enkele producten met één variant én enkele producten met meerdere varianten.

Ontbrekende waarden

Automatisch gekoppeld betekent niet dat ieder product een waarde bevat. Wanneer een barcode, SKU, vendor of producttype in Shopify leeg is, blijft het overeenkomstige Slimme veld ook leeg totdat de brondata wordt aangevuld of een toegestane aanvullende verwerking wordt toegepast.

Controleer ontbrekende gegevens daarom eerst in Shopify. Pas daarna beoordeel je of een regel, fallback of verrijking binnen Nifelo wenselijk is.

Tags en producttype

Shopify-tags en het Shopify-producttype kunnen belangrijke context leveren voor categorisatie, filters en regels.

Gebruik producttype voor de inhoudelijke soort of groep van een product wanneer die in Shopify consequent is ingevuld.
Gebruik tags als aanvullende kenmerken of selecties, niet als vervanging van stabiele productidentificatie.

Een inconsistente inrichting in Shopify wordt door de automatische mapping niet automatisch inhoudelijk gecorrigeerd. Daarvoor kun je later normalisatie, regels of categorisatie gebruiken.

Dynamische opties en aanvullende metadata

Shopify-winkels kunnen eigen variantopties en metadata bevatten, zoals maat, kleur of een metafield. Deze velden verschillen per winkel en zijn niet automatisch onderdeel van het ondersteunde Shopify-contract van Nifelo.

Wanneer Nifelo een nog onbekende dynamische optie aantreft, kan deze als kandidaat voor beoordeling worden geregistreerd. Een Nifelo-administrator beoordeelt vervolgens of de informatie:

al bij een bestaand Slim veld hoort;
als nieuw ondersteund Slim veld moet worden toegevoegd;
alleen voor de betreffende aansluiting bruikbaar is;
technisch, dubbel, onduidelijk of niet geschikt is en daarom moet worden genegeerd.

Deze beoordeling voorkomt dat iedere vrije optienaam of technische metadata automatisch een nieuw Slim veld wordt. Zo blijft de productstructuur beheersbaar, betrouwbaar en bruikbaar voor AI, regels, validatie en exports.

Een nieuw of onbekend veld kan tijdens de technische verwerking zichtbaar worden, maar is pas een officieel ondersteund en beheerd Slim veld nadat Nifelo het heeft beoordeeld en goedgekeurd. Vertrouw daarom niet op een nieuw dynamisch veld voor kritieke regels of exports zolang het nog niet als ondersteund veld beschikbaar is.

Niet iedere kandidaat wordt goedgekeurd. Er geldt ook geen garantie dat een winkelspecifiek veld aan het algemene contract wordt toegevoegd. Bij goedkeuring kan Nifelo het veld aan een bestaande betekenis koppelen of gecontroleerd als aanvullend veld beschikbaar maken.

De mapping controleren

Op de pagina Slimme velden zie je de beheerde Shopify-koppelingen. Gebruik het voorbeeldproduct en waar beschikbaar de ruwe brondata om te controleren wat Shopify werkelijk aanlevert.

Controleer minimaal:

Of titel en beschrijving bij het juiste product horen.
Of Product-ID en Variant-ID gevuld zijn.
Of SKU en barcode/EAN op variantniveau correct zijn.
Of prijzen overeenkomen met Shopify.
Of vendor/merk, producttype en tags bruikbare waarden bevatten.
Of varianten met maat of kleur correct gegroepeerd blijven.

Bekijk meerdere producten; één voorbeeld is onvoldoende om de volledige Shopify-catalogus te beoordelen.

Regels en aanvullende verwerking

De beheerde bronkoppeling bepaalt waar de oorspronkelijke waarde vandaan komt. Daarna kun je waar toegestaan aanvullende verwerking gebruiken, bijvoorbeeld voor het uniformeren van merknamen of het afleiden van een waarde uit consistente tags.

Gebruik regels niet om een fundamenteel verkeerde broninrichting te verbergen. Corrigeer structurele fouten bij voorkeur eerst in Shopify, zodat toekomstige imports dezelfde juiste gegevens aanleveren.

Wanneer worden wijzigingen zichtbaar?

Wijzigingen die je in Shopify maakt, worden pas in Nifelo zichtbaar nadat de databron opnieuw is geïmporteerd of verwerkt.

De automatische mapping schrijft geen wijzigingen terug naar Shopify. Terugschrijven gebeurt alleen via een afzonderlijk geconfigureerd verkoopkanaal of een daarvoor bedoelde synchronisatiefunctie.

Aanbevolen eerste controle

Verbind en test eerst de juiste Shopify-winkel.
Voer een eerste handmatige import uit.
Open Slimme velden en controleer de beheerde kernkoppelingen.
Bekijk producten met één en meerdere varianten.
Vergelijk SKU, barcode en prijzen met Shopify.
Controleer vendor, producttype en tags.
Beoordeel pas daarna aanvullende metadata of dynamische opties.
Importeer opnieuw nadat je brondata in Shopify hebt gecorrigeerd.
Controleer de producten voordat je AI, normalisatie of exports gebruikt.