Import voor Shopify

Synchroniseer Shopify-producten veilig naar Nifelo met bescherming voor handmatige wijzigingen en AI-verrijkte productdata.

Import of synchronisatie?

Bij een Shopify-databron is een import in feite een inkomende synchronisatie: Nifelo haalt de actuele productgegevens rechtstreeks op via de beveiligde Shopify API en verwerkt deze tot Smart Products.

In Nifelo heet de handeling Import starten, omdat Shopify één van de mogelijke databronnen is. Het woord synchronisatie beschrijft hier alleen dat Nifelo de actuele Shopify-gegevens opnieuw ophaalt. De richting is tijdens deze stap altijd van Shopify naar Nifelo.

Een Shopify-import schrijft niets terug naar Shopify. Terugschrijven gebeurt uitsluitend via een afzonderlijk geconfigureerd verkoopkanaal of een expliciete exportactie.

Voorwaarden

Controleer vóór de import:

of de Shopify-verbinding nog geautoriseerd is;
of Nifelo toegang heeft tot de productgegevens;
of de juiste Shopify-winkel aan deze databron is gekoppeld;
of je binnen de productlimiet van je abonnement blijft.

Wanneer Shopify-toegang is ingetrokken, de app is verwijderd of vereiste rechten ontbreken, stopt Nifelo de import voordat een onvolledige winkelsnapshot als geldig resultaat wordt verwerkt.

Welke gegevens haalt Nifelo op?

Nifelo leest de Shopify-productcatalogus via de API. Daarbij worden productgegevens in pagina's opgehaald en waar nodig aangevuld met de volledige set varianten, productmedia en ondersteunde metadata.

De Shopify-kernvelden worden gekoppeld via het centraal beheerde cataloguscontract. Je hoeft deze mappings niet per databron handmatig aan te maken. Voorbeelden zijn titel, beschrijving, SKU, barcode, prijs, beschikbaarheid, voorraad, afbeeldingen, merk en producttype.

Dynamische opties en metadata worden alleen als Slim veld gebruikt wanneer ze door Nifelo zijn herkend en goedgekeurd. Lees hiervoor ook Slimme velden voor Shopify.

Simpele producten en varianten

Shopify heeft technisch altijd minimaal één variant. Nifelo maakt onderscheid tussen:

een simpel product: het Shopify-product met zijn standaardvariant wordt als één Smart Product verwerkt;
een product met echte keuzemogelijkheden: iedere verkoopbare Shopify-variant wordt als afzonderlijk Smart Product verwerkt en blijft gekoppeld aan hetzelfde hoofdproduct.

Hierdoor kan het aantal Smart Products hoger zijn dan het aantal hoofdproducten dat je in Shopify ziet. Dit is normaal en nodig om bijvoorbeeld SKU, barcode, prijs, voorraad, maat of kleur per verkoopbare variant betrouwbaar te verwerken.

Smart Update bij een volgende synchronisatie

Bij iedere volgende import vergelijkt Nifelo de nieuwe Shopify-snapshot met de bestaande Smart Products.

Nieuwe Shopify-producten en varianten worden toegevoegd.
Gewijzigde gegevens worden bijgewerkt.
Ongewijzigde producten worden herkend en overgeslagen.
Bestaande Nifelo-verrijkingen blijven behouden waar Nifelo eigenaar van de verbeterde waarde is.
Door Shopify beheerde bronwaarden worden opnieuw uit de actuele winkelsnapshot gelezen.
Slimme regels worden opnieuw toegepast.

Een overgeslagen product is niet mislukt. Het betekent dat Nifelo geen relevante wijziging hoefde op te slaan.

Welke waarde krijgt voorrang bij Shopify?

Shopify is de bron van de winkelsnapshot, maar niet automatisch de eigenaar van iedere effectieve waarde binnen Nifelo. Smart Update bewaakt het eigenaarschap per Slim veld.

AI-verrijking blijft beschermd

Een geslaagde AI-verrijking, AI-superextractie of contentoptimalisatie wordt niet door een volgende Shopify-import vervangen. Als Shopify nog de oude titel of beschrijving bevat, blijft de verbeterde Nifelo-waarde actief.

Zo gaan eerder gebruikte AI-credits en goedgekeurde verbeteringen niet verloren. Een nieuwe import start niet automatisch dezelfde AI-bewerking opnieuw. Een mislukte AI-bewerking is niet beschermd en mag terugvallen op Shopify-data.

Handmatige klantwijzigingen

Een werkelijk door de klant aangepast veld krijgt de herkomst klant. Voor veel commerciële en inhoudelijke Shopify-velden geldt lokaal tot succesvolle export. Voorbeelden zijn titel, beschrijving, SKU, barcode, prijs, actieprijs, merk, producttype, tags en diverse verzendvelden.

Deze klantwaarde blijft bij nieuwe Shopify-imports behouden zolang zij nog niet succesvol naar Shopify is teruggeschreven. Pas nadat de betreffende export aantoonbaar is geslaagd, kan het veld weer onder bronregie komen. Dit voorkomt zowel verlies van werk als een eindeloze import-exportlus.

Voorraadaantal heeft een afzonderlijk lokaal beleid wanneer de klant die waarde binnen Nifelo overneemt. Voorraadexport gebruikt daarvoor de gespecialiseerde voorraadroute.

Velden waarvoor Shopify leidend blijft

Sommige velden beschrijven de technische of actuele Shopify-toestand en blijven daarom bron-beheerd. Voorbeelden zijn externe Shopify-identiteiten, product- en variantgroepering, valuta, actuele beschikbaarheid, productlinks, hoofdafbeeldingen en bepaalde door Shopify beheerde categorie- of optiegegevens.

Een handmatige wijziging aan zo'n bron-leidend veld kan bij een volgende Shopify-synchronisatie worden vervangen. Dat is bewust: Nifelo moet voor deze velden de werkelijke Shopify-toestand blijven volgen.

Slimme regels en beschermde waarden

Slimme regels worden bij iedere import opnieuw op de actuele brondata toegepast. Een regel blijft daardoor herhaalbaar, maar overschrijft geen veld dat al beschermd eigenaarschap heeft door AI of een geldige klantwijziging.

Voorbeeld

Stel dat Shopify een titel, prijs en beschikbaarheid aanlevert:

Nifelo verbetert de titel met AI: de AI-titel blijft bij de volgende import behouden;
de klant past de prijs handmatig aan: de lokale prijs blijft behouden totdat die wijziging succesvol is geëxporteerd;
Shopify verandert de actuele beschikbaarheid: de nieuwe Shopify-beschikbaarheid wordt verwerkt;
een actieve regel vult een ontbrekend veld aan: de regel wordt bij iedere import opnieuw toegepast zolang geen beschermde waarde voorgaat.

Hetzelfde Smart Product kan dus tegelijk een AI-beheerde titel, klant-beheerde prijs en Shopify-beheerde beschikbaarheid hebben.

Waarom dit AI-credits beschermt

Zonder veld-eigenaarschap zou iedere synchronisatie een verbeterde titel of beschrijving weer kunnen vervangen door de oorspronkelijke Shopify-tekst. Daarna zou opnieuw AI nodig zijn om dezelfde verbetering terug te krijgen.

Nifelo bewaart daarom de verbeterde effectieve waarde én de herkomst. Shopify-data wordt nog steeds opgehaald en beoordeeld, maar krijgt niet automatisch voorrang op een beschermd veld.

Producten die niet meer in Shopify staan

Pas nadat Nifelo een volledige Shopify-snapshot zonder technische rij-uitval heeft verwerkt, kunnen Smart Products die niet meer in die snapshot voorkomen veilig inactief worden gemaakt.

Wanneer de verbinding of verwerking tussentijds mislukt, gebruikt Nifelo die onvolledige run niet om bestaande producten massaal te deactiveren. Controleer de fout en start pas daarna opnieuw een import.

De statuskaart begrijpen

Na de synchronisatie toont de importpagina:

Succesvol geïmporteerd: Shopify-items die technisch zijn verwerkt, ook wanneer ze inhoudelijke aandachtspunten hebben;
Niet geïmporteerd: items die technisch niet verwerkt konden worden;
Totaal bronregels: het aantal verkoopbare items in deze synchronisatieronde;
Actieve Smart Products: de actuele actieve Shopify-items binnen Nifelo.

Validatiefouten en waarschuwingen staan in een apart blok. Ze maken een technisch geslaagde import niet ongedaan.

Waarom kan een gekoppeld veld toch leeg zijn?

Het centrale Shopify-contract kan een veld correct koppelen terwijl Shopify voor een bepaald product geen waarde levert. Een gekoppeld GTIN-veld kan bijvoorbeeld bij slechts een deel van de varianten een barcode bevatten.

Controleer na de import daarom Coverage & analyse. Daar zie je afzonderlijk:

of een veld gekoppeld is;
hoeveel actieve producten een waarde hebben;
welke kwaliteitscontrole aandacht nodig heeft.

Problemen oplossen

De verbinding wordt geweigerd

Controleer of de Shopify-app nog is geïnstalleerd en geautoriseerd. Autoriseer de verbinding opnieuw wanneer Shopify-toegang of rechten zijn gewijzigd.

De import toont technische uitval

Open het importverslag en controleer de foutmelding. Start niet direct meerdere nieuwe runs. Los eerst een verbindings-, identiteits- of verwerkingsfout op.

Producten zijn geïmporteerd maar hebben aandachtspunten

De synchronisatie is dan wel geslaagd. Open Coverage & analyse en verbeter de ontbrekende of ongeldige productgegevens via de bron, Slimme velden, regels, AI-verrijking of normalisatie.

Het aantal wijkt af van Shopify

Controleer of Shopify-producten meerdere verkoopbare varianten hebben. Nifelo telt die varianten afzonderlijk. Vergelijk daarom niet alleen het aantal hoofdproducten, maar ook de variantstructuur.

Aanbevolen werkwijze

Controleer de Shopify-verbinding.
Start de import vanuit Nifelo.
Controleer of Niet geïmporteerd op nul staat.
Vergelijk bronregels en actieve Smart Products met de Shopify-variantstructuur.
Open Coverage & analyse voor dekking en datakwaliteit.
Los aandachtspunten gericht op zonder de import onnodig opnieuw te starten.
Gebruik een verkoopkanaal wanneer gegevens later terug naar Shopify moeten worden geschreven.