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