Vereisten voor import bestanden

Als je jouw productinformatie in Channable wilt importeren, kun je een importbestand/datafeed gebruiken zoals een XML, CSV, TXT, Google Spreadsheet of JSON. We hebben een aantal tips en vereisten voor het gebruik van een importbestand, welke in dit artikel zijn beschreven.

Algemene vereisten

• De datafeed moet op een online locatie beschikbaar zijn. Dit betekent dat je een URL nodig hebt van waaruit we op elk moment van de dag de datafeed kunnen downloaden.
• De datafeed moet op dezelfde URL (bij voorkeur minimaal één keer per dag) worden bijgewerkt met de laatste productinformatie (zoals voorraad en prijzen).
• De datafeed moet in XML-, CSV-, TXT-, Google Spreadsheet- of JSON-format zijn.

Limieten

• Het aantal imports per project is standaard beperkt tot 50.
• Elk geïmporteerd bestand mag maximaal 10 miljoen items bevatten.
• Elk geïmporteerd bestand mag niet groter zijn dan 5 GB

Neem contact op met onze support afdeling als je tegen deze limieten aanloopt, zodat we je kunnen helpen bij het bedenken van een oplossing.

Velden

Wanneer je een eigen bestand (XML, CSV of TXT) aan het maken bent waarmee je de productinformatie in Channable wilt importeren, kan het lastig zijn om te bedenken welke velden handig zijn om te gebruiken. Daarom hebben we een tabel gemaakt met daarin de basis voor een importbestand. De tabel staat hieronder weergegeven. In de tabel wordt per veld aangegeven of dit belangrijk, aanbevolen of optioneel is. Ook staat er per veld aangegeven welke waardes er in het veld kunnen staan. Onder de tabel staat een voorbeeld van de xml-code van één product om een beeld te geven van hoe productinformatie is opgebouwd in een xml-bestand. 

Voorbeeld XML code

<?xml version='1.0' encoding='utf-8'?>

<items>

<item>

<additional_image_link>http://www.webshop.com/product1b.jpg, http://www.webshop.com/product1c.jpg</additional_image_link>

<description>Description of the item here</description>

<brand>Retour Jeans</brand>

<ean>8719547238072</ean>

<unique_id>008305-01-122</unique_id>

<size>122</size>

<color>black</color>

<image_link>http://www.webshop.com/product1.jpg</image_link>

<price>54.95</price>

<shipping_country>NL</shipping_country>

<shipping_price>3.95 EUR</shipping_price>

<link>http://example.channable.com/product1</link>

<product_type>girls/trousers</product_type>

<stock>16</stock>

<title>Retour Jeans girls trousers Angelina</title>

</item>

<item>

…

</item>

</items>

Nesting

Momenteel kan Channable niet werken met geneste velden. Nesting houdt in dat informatie in jouw XML-import is gestructureerd in lagen. De beste oplossing is om helemaal geen geneste velden in jouw importbestand te gebruiken om fouten te voorkomen. Maar als je een paar geneste velden in je importbestand gebruikt, raden we aan om alle velden met een ''.''' in de mapping te vervangen door een ''_''. In onderstaande afbeelding zie je een voorbeeld van hoe een genest veld geïmporteerd wordt en hoe je dit moet aanpassen. Meer informatie over het aanpassen van de mapping vindt je in dit artikel.

Voorbeeld CSV-bestand