Import

Waarvoor gebruik je Import?

Met Import verwerkt Nifelo de actuele productgegevens uit een databron tot actieve Smart Products. De bron kan bijvoorbeeld een bestand, feed-URL of gekoppelde webshop zijn.

Deze handleiding beschrijft de algemene werking van de importpagina. Open ook Import onder het brontype dat je gebruikt. Wanneer daar een eigen handleiding beschikbaar is, volg je bij verschillen de bronspecifieke uitleg.

Controleer eerst de voorbereiding

Voordat je een import start, controleer je:

1. of de databron bereikbaar is en de juiste gegevens bevat;
2. of de benodigde Slimme velden zijn gekoppeld of centraal worden beheerd;
3. of id of een andere stabiele productidentiteit beschikbaar is;
4. of categorisatie en regels naar wens zijn ingesteld;
5. of je binnen de productlimiet van je abonnement blijft.

Wanneer een noodzakelijke mapping ontbreekt, verwijst Nifelo je eerst naar Slimme velden.

Smart Update Import

Een normale import is een Smart Update Import. Nifelo vergelijkt iedere bronregel met het bestaande Smart Product.

• Nieuwe producten worden toegevoegd.
• Gewijzigde producten worden bijgewerkt.
• Ongewijzigde producten worden herkend en overgeslagen.
• Bestaande AI-verrijkte gegevens blijven behouden volgens het eigenaarschap van het veld.
• Slimme regels worden opnieuw toegepast voordat Nifelo bepaalt of het resultaat is gewijzigd.

Hierdoor hoeft Nifelo niet bij iedere import alle producten volledig opnieuw op te bouwen. Dat maakt vervolgimports sneller en voorkomt dat lokale verbeteringen onnodig verloren gaan.

Hoe beschermt Smart Update bestaande verbeteringen?

Nifelo bewaart per Slim veld waar de actieve waarde vandaan komt. Daardoor hoeft een product niet volledig door de bron óf volledig door Nifelo te worden beheerd. De prioriteit wordt per veld bepaald.

Waarden uit de bron

Een veld dat nog door de bron wordt beheerd, volgt bij een volgende import de nieuwste bronwaarde. Wijzigt bijvoorbeeld de bronprijs en heeft niemand die waarde binnen Nifelo overgenomen, dan verwerkt Smart Update de nieuwe prijs.

Bij een volledige, betrouwbare bronmomentopname kan een lege of verwijderde bronwaarde een bron-beheerde waarde ook leegmaken. Een onvolledige momentopname mag niet bewijzen dat een bestaande waarde werkelijk is verwijderd.

Door AI verbeterde waarden

Een geslaagde AI-verrijking krijgt beschermd eigenaarschap. Een nieuwe import vervangt zo'n waarde niet stilzwijgend door de oorspronkelijke, vaak minder volledige bronwaarde. Dit geldt onder andere voor reguliere AI-verrijking, AI-superextractie en geslaagde contentoptimalisatie.

Hiermee blijft het resultaat van gebruikte AI-credits behouden. Een normale Smart Update hoeft die verrijking niet opnieuw te kopen of opnieuw te genereren. Alleen een afzonderlijk gestarte nieuwe AI-bewerking kan opnieuw credits gebruiken.

Een mislukte AI-bewerking claimt geen eigenaarschap. De bronwaarde kan dan bij een volgende import gewoon worden verwerkt.

Handmatig door de klant aangepaste waarden

Wanneer een klant een productveld werkelijk wijzigt, registreert Nifelo die waarde als een klantwijziging. Alleen het gewijzigde veld krijgt lokale voorrang; andere velden blijven hun eigen bron en beleid volgen.

Bij gewone bestand- en feedbronnen blijft zo'n klantwijziging beschermd tegen een volgende import. Bij rechtstreeks gekoppelde webshops bepaalt het centrale veldcontract wat er daarna gebeurt:

• lokaal leidend: de klantwaarde blijft binnen Nifelo leidend;
• lokaal tot succesvolle export: de klantwaarde blijft beschermd totdat exact die wijziging succesvol naar de webshop is teruggeschreven;
• bron leidend: een technisch of door de webshop beheerd veld mag bij een volgende synchronisatie opnieuw uit de bron worden overgenomen.

Het alleen openen en opnieuw opslaan van een product claimt geen eigenaarschap wanneer de zichtbare waarde niet werkelijk is gewijzigd.

Slimme regels

Actieve Slimme regels worden tijdens iedere import opnieuw toegepast. Een regel kan nieuwe brondata corrigeren of aanvullen, maar doorbreekt geen beschermde AI- of klantwaarde. Zo blijft de ingestelde logica herhaalbaar zonder handmatige of betaalde verbeteringen onbedoeld terug te draaien.

De bescherming geldt per veld

Een beschermde titel blokkeert dus niet automatisch een nieuwe bronprijs. Andersom kan een nieuwe voorraadwaarde worden verwerkt terwijl een door AI verbeterde beschrijving behouden blijft.

In vereenvoudigde vorm gebruikt Smart Update deze volgorde:

1. beschermde AI-, woordenboek- en klantwaarden behouden;
2. actieve regels toepassen waar geen beschermde waarde voorgaat;
3. nieuwe bronwaarden gebruiken voor bron-beheerde velden;
4. metadata en herkomst per veld bijwerken.

Smart Update is geen blinde overschrijving van het volledige product. Het is een gecontroleerde samenvoeging per Slim veld.

Import starten

Klik op Start Import om de verwerking te starten. De import kan op de achtergrond doorgaan. Sluit de pagina alleen wanneer Nifelo aangeeft dat de taak veilig op de achtergrond wordt uitgevoerd.

Start niet meerdere imports tegelijk voor dezelfde databron. Wacht tot de huidige run is voltooid of een duidelijke foutmelding geeft.

Wanneer is een import succesvol?

Een product is succesvol geïmporteerd wanneer de bronregel technisch is verwerkt en als Smart Product is opgeslagen of bijgewerkt. Ontbrekende productvelden of validatiewaarschuwingen maken de import niet ongedaan.

De statuskaart maakt daarom onderscheid tussen:

• Succesvol geïmporteerd: bronregels die technisch zijn verwerkt;
• Niet geïmporteerd: bronregels die door een technische fout niet konden worden verwerkt;
• Actieve Smart Products: de actuele producten die binnen deze databron actief zijn.

Data-aandachtspunten worden afzonderlijk getoond. Een product met zo'n aandachtspunt is dus wel geïmporteerd.

Bronregels en actieve producten

Het aantal bronregels hoeft niet altijd gelijk te zijn aan het aantal actieve Smart Products. Mogelijke oorzaken zijn:

• één bronproduct levert meerdere verkoopbare varianten op;
• meerdere bronregels horen bij één productstructuur;
• een eerder product is niet meer aanwezig in de nieuwste volledige bron;
• een regel mist een bruikbare stabiele identiteit en kan technisch niet worden verwerkt.

Gebruik het importverslag om te zien wat tijdens de geselecteerde run is toegevoegd, bijgewerkt, overgeslagen of niet verwerkt.

Data-aandachtspunten na de import

Na een geslaagde import kan Nifelo nog validatiefouten of waarschuwingen melden, bijvoorbeeld voor ontbrekende GTIN, merk, afbeelding, prijs of beschikbaarheid.

Deze meldingen betekenen niet dat de import is mislukt. Open Coverage & analyse om de dekking en kwaliteit per Slim veld te beoordelen. Gebruik daarna Data Validatie, Slimme velden, regels, AI-verrijking of normalisatie om de gegevens gericht te verbeteren.

Het importverslag lezen

Het importverslag hoort bij één import-run en toont onder andere:

• het totaal aantal verwerkte bronregels;
• nieuwe en bijgewerkte producten;
• ongewijzigde en daardoor overgeslagen producten;
• echte technische uitval;
• de duur en het tijdstip van de run;
• relevante meldingen uit de verwerkingsstappen.

Kies een eerdere run om resultaten te vergelijken. Beoordeel technische fouten altijd eerst voordat je opnieuw importeert.

Wat verandert een import niet?

Een import leest productdata uit de bron en verwerkt die binnen Nifelo. Een import schrijft niet automatisch gegevens terug naar een webshop of verkoopkanaal. Terugschrijven of publiceren gebeurt alleen via een daarvoor geconfigureerd verkoopkanaal of een expliciete exportactie.

Aanbevolen werkwijze

1. Controleer de databron en Slimme velden.
2. Start de import.
3. Controleer of alle bronregels technisch zijn verwerkt.
4. Lees het importverslag bij echte uitval.
5. Open Coverage & analyse voor datakwaliteit en velddekking.
6. Los aandachtspunten op met de daarvoor bedoelde onderdelen.
7. Controleer producten voordat je AI-verrijking of een verkoopkanaal op grote schaal gebruikt.