Content feed documentatie

Lees in dit artikel alles over de documentatie van de content feed.

Content feed

Middels een content feed kunnen gebruikers de productgroep, vertalingen en attributen van producten automatisch laten importen in Vendiro.

De producten groepen worden alleen bijgewerkt indien deze aanwezig zijn in de content feed.
Bij het ontbreken van de <group> node, zal de productgroep niet verwijderd worden.
De vertalingen worden automatisch geïmporteerd voor de geactiveerde talen.

Standaard dienen attributen vooraf in de Vendiro interface ingesteld te worden.
De keys die in de interface gedefinieerd worden, worden vervolgens bij de import geïmporteerd.
Attribuut keys die niet bekend zijn op het moment van importeren worden genegeerd.
Het is ook mogelijk om de Vendiro interface tijdens de import de attributen automatisch aan te laten maken.

De content feed dient de encodering UTF-8 te gebruiken.
Velden dienen beschermd te zijn door CDATA tags, indien ze speciale karakters bevatten die de XML ongeldig zouden kunnen maken.

Let op: Als je in een content feed informatie weghaalt, wordt de data bij het product niet verwijderd. Je kan de data dus enkel overschrijven. Als je verkeerde data hebt ingeschoten, moet het desbetreffende veld leeg worden ingeschoten. Het attribuut blijft bestaan, maar het veld is dan leeg.

Voorbeeld:

Klant heeft attribuut 'Gender' met de waarde 'Jongens' voor een frituurpan ingeschoten, dit wil de klant weg hebben. De klant moet dan het attribuut 'Gender' met een lege waarde insturen om 'Jongens' te laten verdwijnen. Het gehele attribuut uit de feed verwijderen helpt niet.

Taalcodes

Momenteel ondersteunt Vendiro de volgende talen:

Taalcode Taal
nl Nederlands
de Duits
fr Frans
gb Engels
it Italiaans
es Spaans
pt Portugees
da Deens
se Zweeds
pl Pools

 

 

 

 

 

 

 

 

 

Bestandstructuur

XML structuur

Node Verplicht Type Omschrijving
<?xml version="1.0" encoding="UTF-8"?> Ja XML Codering van het bestand
Alleen UTF-8 is toegestaan
products Ja XML Root node
product Ja XML Product data

 

XML / product

Node Verplicht Type Omschrijving
sku Ja Char (100) Product SKU
group Nee Char (255) Product groep
translations Nee XML Vertaal data
attributes Nee XML Attribuut data

 

XML / product / translations

De translation nodes en subnodes bevatten de vertalingen per product.
De taal wordt meegeven in het language attribuut, zie het hoofdstuk Taalcodes voor de beschikbare waarden.

Node Verplicht Type Omschrijving
translation Ja XML Vertaal data
translation[language] Ja Char (2) Taal code

 

XML / product / translations / translation

De translation node van bevat de vertalingen in de aangegeven taal.
De name is verplicht voor een product, de verschillende descriptions en de bullets zijn optioneel.
De verschillende translations kunnen gebruikt worden om bij specifieke marketplaces een ander soort omschrijving te gebruiken. 

Node Verplicht Type Omschrijving
name Ja Char (255) Product naam
description Nee Text Product omschrijving
description_long Nee Text Product omschrijving
description_html Nee Text Product omschrijving
bullets Nee XML Bullets data

 

XML / product / translations / translation / bullets

Node Verplicht Type Omschrijving
Bullet Ja Char (255) Product bullet

 

XML / product / attributes

De attributes node bevat de attribuut informatie van het product.

Node Verplicht Type Omschrijving
attribute Ja XML Attribuut data

 

XML / product / attributes / attribute

De attribuut nodes bevatten de daadwerkelijke waarden van het attribuut.
Middels het key attribuut wordt de key van het attribuut aangegeven.
Per product mag een key slechts één keer voorkomen.

Node Verplicht Type Omschrijving
attribute Ja Char (255) Attribuut waarde
attribute[key] Ja Char (100) Attribuut key

 

Voorbeeldbestand