App2Shop Product Import XML voorbeeld User Guide V1.0

Transcriptie

1 Inleiding Om je zo goed mogelijk te helpen bij het importeren van je producten hebben wij een standaard import voor je ontwikkeld. Je kunt zowel werken met XML als met CSV, maar wij adviseren te werken met XML. In dit document spreken we daarom uitgebreider over de XML opbouw dan over de CSV opbouw. Met deze XML/CSV ben je in staat om alle functionaliteiten van App2Shop optimaal te benutten. In dit document lichten we de inhoud van deze XML/CSV opbouw toe. We gaan er vanuit in dit document dat je bekend bent met de basisfunctionaliteiten van de App2Shop product import module. Voor meer informatie, vragen of support kun je terecht op Gebruik van deze XML/CSV Om het zo gemakkelijk mogelijk te maken hebben wij reeds een profiel aangemaakt in de import module welke je kunt gebruiken. Je selecteert deze in de dropdown in de eerste stap van de product import en klik je op laden. XML opbouw Onderstaand een voorbeeld van alle mogelijke tages die je kunt gebruiken in deze XML import. Het is NIET noodzakelijk om alle tags te gebruiken, als ze maar dezelfde naam hebben. Alhoewel de meeste tags voor zich spreken lichten we ze verderop kort toe. <products> <product> <name></name> <price></price> <special_price></special_price> <start_datetime></start_datetime> <end_datetime></end_datetime> <model></model> <sku></sku> <ean></ean> <category></category> <description></description>

2 <image></image> <additional_images></additional_images> <quantity></quantity> <weight></weight> <length></length> <width></width> <height></height> <options></options> <sort_order></sort_order> <brand></brand> <subtract_stock></subtract_stock> <status></status> </product> </products> Met de tag <products> start je de XML. Ieder product individueel dien je tussen de tag <product> te zetten. Tags <name></name> De naam van het product. <price></price> De normale prijs van het product excl. BTW. <special_price></special_price> De aanbiedingsprijs van het product excl. BTW. <start_datetime></start_datetime> De startdatum en tijd van de aanbieding. Tot deze datum en tijd wordt de aanbieding niet zichtbaar in je apps. Het format voor de datum en tijd is als volgt: DD-MM-YYYY 00:00 (bijv :00). <end_datetime></end_datetime> De einddatum en tijd van de aanbieding. Na deze datum en tijd is de aanbieding niet langer zichtbaar in je apps. Het format voor de datum en tijd is als volgt: DD-MM-YYYY 00:00 (bijv :00). <model></model> Een uniek modelnummer voor je product. Let op, bij het verversen van je producten via de import module is het mogelijk om producten hiermee te herkennen. Zorg er dus voor dat dit nummer uniek is per product. <sku></sku> De SKU van het product. <ean></ean> De EAN code van het product. Kan ook gebruikt worden voor het herkennen van je producten een barcode scan mogelijkheid in de apps. <category></category> De categorie of categorieën waar het product onder valt. Er zijn wat verschillende manieren om met deze tag om te gaan, namelijk; Product koppelen aan 1 hoofdcategorie:

3 <category>categorienaam</category> Product koppelen aan meerdere hoofdcategorieën: <category>categorienaam 1</category> <category>categorienaam 2</category> Product koppelen aan subcategorie: <category>categorienaam > Subcategorienaam</category> Product koppelen aan meerdere subcategorieën: <category>categorienaam 1 > Subcategorienaam 1</category> <category>categorienaam 2 > Subcategorienaam 2 > Subcategorienaam 3</category> Een product wat je koppelt aan subcategorieen, wordt altijd toegevoegd aan de laatste subcategorie in je tag. Let erop dat je de juiste delimeter (scheidingsteken tussen categorieën) gebruikt:de >. Indien je deze niet gebruikt dan dien je in stap 2 aan te geven welke delimeter je wel hebt gebruikt. <description></description> De omschrijving van je product. Mocht je producten hebben met veel specificaties die je los van de omschrijving weergeeft op je website, zet deze dan ook tussen de description tag. <image></image> De link naar de afbeelding van je product. Let er op dit een link is met de volledige URL ervoor. De afbeelding wordt via deze link gedownload naar onze servers. <additional_images></additional_images> Eventuele extra afbeeldingen bij een product kun je tussen deze zetten. Hetzelfde geldt hier: let er op dat je de in de link de volledige URL gebruikt. Ook deze afbeeldingen worden via deze link gedownload naar onze servers. <quantity></quantity> Het aantal wat je van dit product op voorraad hebt. <weight></weight> Het gewicht van je product. Eventueel kun je dit gebruiken om transportkosten op te baseren.

4 <length></length> De lengte van je product. <width></width> De breedte van je product. <height></height> De hoogte van je product. <options></options> Deze tag dient ter voorbeeld. Als je gebruik maakt van opties voor je producten dan gebruik je de naam van de optie als tag en NIET de tag zoals die hierboven staat. Hier kun je de opties van je product onderbrengen, zoals kleuren en maten. Opties dien je per stuk te definiëren en de waardes kun je scheiden met een pipe. Bijvoorbeeld: Blauw Rood Geel of S M L XL. Dus voor de optie kleur maar je een tag <kleur></kleur>. Tussen deze tag zet je de kleuren. Als volgt; <kleur> Blauw Rood Geel </kleur> Indien je per optie ook de voorraad van die optie wilt meegeven dan zet je dat achter een dubbele punt achter de optiewaarde. Bijvoorbeeld: Blauw:8 Rood:5 Geel:7. Belangrijk: je kunt ook aangeven of de voorraad moet worden bijgewerkt als er een product met deze optie wordt verkocht. Werk je de voorraad niet bij, dan zal die optie altijd beschikbaar zijn ook al is de voorraad 0. Doe je dat wel, dan zal de optie verdwijnen uit de apps zodra de voorraad 0 is. Default staat deze waarde ingesteld op Niet van voorraad. Om dit aan te geven gebruik je een 0 voor nee en een 1 voor ja. Deze waarde zet je achter het aantal. Bijvoorbeeld: Blauw:8:1 Rood:5:1 Geel:7:1 Het is tevens mogelijk een toeslag voor een optie mee te geven. Dit werkt op dezelfde manier als de voorraad, je zet er simpelweg achter na een dubbele punt. Bijvoorbeeld: Blauw:8:5 Rood:5:5 Geel:7:5. In dit voorbeeld is de toeslag dus 5 euro. Extra gewicht toevoegen gaat op dezelfde manier, alsmede een sortering volgorde. De meeste uitgebreide versie kan er dan zo uitzien: <kleur> Blauw:8:1:5:4:0 Rood:5:1:5:4:1 Geel:7:1:5:4:2 </kleur> Er zijn dus 8 stuks van blauw op voorraad, bij verkoop moet de voorraad worden bijgesloten, de toeslag is 5 euro, het extra gewicht is 4 kilogram en sortering volgorde is 0. <sort_order></sort_order> Hiermee geef de sorteringvolgorde aan van je product.

5 <brand></brand> Het merk of de fabrikant van het product. <subtract_stock></subtract_stock> Hiermee kun je aangeven of je wilt dat van dit product de voorraad wordt bijgewerkt zodra een product worden verkocht. Als je wilt zet je hier een 1 tussen, zo niet dan zet je er een 0 tussen. <status></status> Geef hier aan of het product actief of inactief is. Actief geef je aan met een 1, inactief met een 0. CSV i.p.v. XML Wil je toch liever gebruik maken van CSV dan XML? Dat kan ook. Je gebruikt precies dezelfde tags en vult hetzelfde in als hierboven omschreven maar het grote verschil is dat de waardes niet in tag staan maar achter elkaar in de kop van je CSV file. De waardes dien je te scheiden met ; (punt-komma). Alle overige waardes blijven ongewijzigd. Een voorbeeld van een kop van een CSV file kan er zo uitzien; name;price;special_price;start_datetime;end_datatime;model;sku;ean;category;description;image;addi tional_images;quantity;weight;length;widht;height;options;sort_order;brand;subtract_stock;status Invoeren van bestand Je kunt je XML bestand op 2 manieren inlezen. De eerste mogelijkheid is door een bestand te uploaden in de App2Shop import tool. Een tweede en onderhoudsvriendelijkere manier is door een URL op te geven waar wij jouw laatste data kunnen ophalen. We doen dit ongeveer ieder uur (afhankelijk van de load op dat moment kan dit iets afwijken). Dat betekent dus dat als jij ervoor zorgt dat op die locatie ieder uur de nieuwe data staat, jouw producten altijd up to date zijn. Je geeft je bestand of URL op in stap 1 van de import module.