Productfeeds: XML en CSV koppelen

Productkennis importeren uit XML- of CSV-feeds

Wanneer je een productfeed kiest

Fynd kan productfeeds in XML- of CSV-formaat gebruiken als kennisbron. Een feed is de juiste keuze wanneer je webshop, ERP, PIM, marketplace-koppeling of e-commerceplatform al een gestructureerde catalogus exporteert. Vergeleken met het crawlen van publieke pagina’s geeft een feed meer controle over de records die worden opgenomen en is de bron eenvoudiger te beperken tot producten.

Gebruik een XML- of CSV-feed voor productnamen, beschrijvingen, SKU’s, prijzen, voorraadstatus, URL’s, afbeeldingen, merken, categorieën en andere velden die je export bevat. Gebruik daarnaast een sitemap-crawl wanneer blogberichten of redactionele koopgidsen belangrijk zijn. Productfeeds zijn bedoeld voor catalogusdata; voor publieke artikelpagina’s en hun BlogPosting- of Article JSON-LD is een sitemap-crawl de passende bron.

Bepaal vóór het koppelen welke toepassing eigenaar is van elk productgegeven. Als de feed vanuit je PIM wordt onderhouden, verwacht dan niet dat een handmatig aangepaste productpagina de leidende prijsbron is. Een duidelijke bron per gegeven maakt de resultaten van latere synchronisaties veel makkelijker te begrijpen.

Maak de feed betrouwbaar

De feed moet beschikbaar zijn via een stabiele URL of via de importmethode van je Fynd-workspace. Gebruik per verkoopbaar product of per variant één logisch record, passend bij het catalogusmodel dat je kiest. Meng productrecords niet met promotiebanners, categoriehoofden, vrije notities of HTML-fragmenten die geen artikel beschrijven.

Gebruik bij een CSV-feed een kopregel met duidelijke kolomnamen. Een minimale export kan er zo uitzien:

id,title,description,price,availability,url,image_url
SKU-100,Reisbeker,"Geïsoleerde roestvrijstalen beker",24.95,in_stock,https://voorbeeld.nl/beker,https://voorbeeld.nl/beker.jpg

Gebruik bij XML een consistente itemstructuur. De elementnamen mogen uit je eigen export komen, maar elk item moet de velden bieden die je nodig hebt:

<products>
  <product>
    <id>SKU-100</id>
    <title>Reisbeker</title>
    <description>Geïsoleerde roestvrijstalen beker</description>
    <price>24.95</price>
    <availability>in_stock</availability>
    <url>https://voorbeeld.nl/beker</url>
  </product>
</products>

Fynd heeft leesbare waarden nodig, niet een specifiek formaat van een aanbieder van marketingfeeds. Voorspelbare veldnamen en consistente datatypen verminderen wel de kans op interpretatieproblemen. Houd identifiers stabiel tussen exports. Als het product-ID bij elke generatie verandert, kunnen wijzigingen als nieuwe producten worden gezien in plaats van als updates van een bestaand product.

XML of CSV selecteren

Kies CSV wanneer je catalogus tabelvormig is en geen ingewikkelde geneste structuur heeft. Het formaat is eenvoudig in een spreadsheet te bekijken en komt vaak uit kleinere platforms en voorraadbeheersystemen. Gebruik UTF-8-codering, een vaste scheidingstekeninstelling en aanhalingstekens rond waarden waarin komma’s of regeleinden voorkomen.

Kies XML wanneer je leverancier een geneste feed levert of wanneer producten herhaalde elementen hebben, zoals meerdere afbeeldingen of categorieën. XML komt veel voor in commerce-integraties en kan gestructureerde relaties natuurlijker bewaren dan een platte tabel.

Converteer een formaat niet alleen omdat het technischer lijkt. Gebruik het formaat dat je bronsysteem betrouwbaar genereert. Een directe, stabiele XML-feed is beter dan een handmatig omgezette CSV die ongemerkt kan mislukken.

Koppel de belangrijke velden

Geef bij de inrichting aan welke velden identiteit en klantgerichte productinformatie bevatten. Controleer in elk geval:

• Identifier: SKU, product-ID of een andere stabiele unieke sleutel.
• Titel: de naam die in antwoorden en zoekresultaten moet verschijnen.
• Beschrijving: nuttige productdetails, materiaal, pasvorm, compatibiliteit of onderhoud.
• Product-URL: de bestemming waar klanten actuele informatie kunnen openen.
• Prijs en valuta: als de feed die levert.
• Beschikbaarheid: voor vragen over voorraad.
• Afbeeldings-URL: wanneer je inrichting visuele productcontext ondersteunt.
• Merk en categorie: voor filtering en betere vindbaarheid.

Beschrijvingen moeten feitelijk en specifiek zijn. “Premium kwaliteit” geeft de assistent weinig houvast; “waterafstotende buitenlaag van gerecycled polyester met een gevoerd laptopvak” is bruikbaar. Verwijder interne inkoopnotities, afkortingen voor leveranciers en velden die klanten niet mogen zien.

Heeft je feed varianten, bepaal dan of elke variant een apart record nodig heeft. Records op variantniveau helpen wanneer maat, kleur, prijs, voorraad of compatibiliteit het antwoord wezenlijk verandert. Verschillen varianten alleen in een intern nummer, dan is een bovenliggend productrecord vaak duidelijker.

Voeg de bron toe en valideer

Voeg in de Fynd-kennisinterface een productfeedbron toe en selecteer XML of CSV. Geef de feedlocatie op, upload het bestand waar dat van toepassing is en voltooi de veldkoppeling. Kies een beschrijvende bronnaam zoals PIM-productexport – EU. De naam moet bij meerdere catalogi zowel de eigenaar als de markt herkenbaar maken.

Start de eerste sync en controleer het resultaat voordat je erop vertrouwt. Bekijk verwerkte records, geaccepteerde records, overgeslagen entries en fouten. Open een kleine steekproef met goedkope producten, duurdere producten, uitverkochte artikelen en producten met varianten. Vergelijk de geïmporteerde waarden met de live webshop en de oorspronkelijke feed.

De sync UI is een operationele controle, niet alleen een succesmelding. Een feed kan zonder technische fout afronden en toch zwakke titels, ontbrekende prijzen, dubbele identifiers of verouderde URL’s bevatten. Los dat bij voorkeur op in het exportsysteem; handmatig de feeduitvoer wijzigen maakt een correctie die de volgende export kan overschrijven.

Houd de feed actueel

Synchroniseer na wijzigingen die klantantwoorden beïnvloeden: nieuwe producten, voorraadwijzigingen, prijsupdates, uitfaseringen, hernoemde producten en aangepaste beschrijvingen. Stem de syncfrequentie af op de bedrijfsbehoefte. Een catalogus die ieder uur wijzigt vraagt om vaker bijwerken dan een seizoensassortiment.

Publiceer volledige feedbestanden waar mogelijk atomair. Wanneer een importer een bestand leest terwijl het opnieuw wordt aangemaakt, kan hij een gedeeltelijke catalogus aantreffen. Een bruikbaar patroon is een nieuw bestand genereren en de publieke feed-URL pas daarna omzetten.

Houd de feed-URL stabiel. Wijzigt een leverancier die URL, werk Fynd dan direct bij en voer een controlesync uit. Vermijd ondertekende URL’s die verlopen voordat toekomstige synchronisaties de feed kunnen ophalen.

Veelvoorkomende problemen oplossen

Producten ontbreken

Zoek in de oorspronkelijke XML of CSV naar de productidentifier. Ontbreekt die daar, herstel dan het exportfilter of de publicatiestatus van het product. Is het record aanwezig, controleer dan of verplichte gekoppelde velden leeg of onjuist geformatteerd zijn.

Producten staan dubbel

Zoek naar dubbele ID’s, zowel hoofdproduct- als variantregels, of meerdere regionale exports die als aparte bronnen zijn gekoppeld. Kies één duidelijke identifierstrategie en voorkom dat dezelfde catalogus tweemaal wordt toegevoegd.

Tekst ziet er beschadigd uit

Controleer bij CSV de codering, het scheidingsteken, de aanhalingsregels en HTML-escaping. Valideer bij XML afsluitende tags en entity-codering. Gebruik consequent UTF-8.

Prijs of voorraad is verouderd

Controleer wanneer het bronsysteem de feed voor het laatst heeft gegenereerd en vergelijk dat met de laatste Fynd-sync. Herstel de export of de synchronisatieplanning; ga er niet vanuit dat de feed zichzelf bijwerkt omdat de URL gelijk is gebleven.

Aanbevolen beheer

Leg de bron-URL, eigenaar van de feed, identifier-veld, veldkoppelingen en verwachte updatefrequentie vast. Controleer enkele producten na grote cataloguswijzigingen. Houd een sitemap-crawl aan voor publieke artikelen als je ook redactionele vragen wilt beantwoorden, en beperk de productfeed tot gestructureerde catalogusfeiten.

Samenvatting

XML- en CSV-feeds geven Fynd een gecontroleerde route naar productkennis. Gebruik stabiele identifiers, heldere titels en beschrijvingen, geldige URL’s en een voorspelbare export. Valideer elke nieuwe bron met representatieve producten en synchroniseer wanneer klantgerichte catalogusinformatie verandert.