Productenfeedspecificatie voor leveranciers, easygiven

Transcriptie

1 Productenfeedspecificatie voor leveranciers, easygiven Dit document bevat een voorstel voor een specificatie voor de XML Feeds waarmee aangesloten (web)winkels hun informatie en artikelen kunnen aanleveren. Deze specificatie is samengesteld op basis van de volgende functionele eisen: 1.Bruikbaar in een internationale context; de Engelse taal. 2.Naar eigen inzicht uit te breiden, zonder dat er compatibiliteitsproblemen optreden. 3.Herkenbaar, in het bestand moeten zowel easygiven als de leverancier herkenbaar zijn. <?xml version= 1.0 encoding= UTF-8?> <easygiven> <vendor> <name>naam van de Leverancier</name> <id>easygiven-id van de leverancier</id> <date>datum en tijd waarop deze feed samengesteld is</date> <terms>absolute URL van algemene voorwaarden</terms> <deliveryterms>absolute URL van leveringsvoorwaarden</deliveryterms> </vendor> <product> <id>id van het product, zoals bekend bij de leverancier</id> <title>titel van het product</title> <brand>merk van het product</brand> <model>model of type van het product</model> <description>omschrijving van het product, met basis HTML </description> <tags>komma, gescheiden, lijst, van, sleutelwoorden</tags> <picture>absolute URL naar een groot plaatje voor dit product</picture> <link>link naar een overzichtspagina voor het artikel bij de leverancier</link> <price>de prijs in de gekozen munteenheid, inclusief BTW</price> <deliverytime>levertijd van het product, in dagen</deliverytime> <deliveryprice>kosten voor het versturen van het product, in Euro</deliveryPrice> <stock>aantal producten dat direct verstuurd kan worden</stock> <size>37</size> <size>38</size> <color>grey</color> </product> </easygiven> (er zijn diversen mogelijkheden voor kleuren en maten. Zie laatste pagina)

2 <easygiven> Rootelement Het <easygiven> element is het root-element welke alle informatie in de huidige feed zal bevatten. <vendor> Direct onder het <easygiven> element. Dit element bevat informatie over de leverancier die deze feed samenstelt. Het <vendor> element mag slechts één keer in de feed voorkomen. <name> Direct onder het <vendor> element. Code d Azur Volledige naam van de leverancier zoals deze zichtbaar is bij producten op de easygiven website. <id> Direct onder het <vendor> element. Een volledig, positief getal Het ID van deze leverancier, zoals deze toegekend zal worden door easygiven. <date> Direct onder het <vendor> element. Een datum opgebouwd volgens ISO T15:00:00Z De datum waarop de producten in deze feed zijn samengesteld, om te verifiëren dat er met het laatste bestand wordt gewerkt. <product> Direct onder het <easygiven> element. Ieder product wordt omschreven als een <product> element. Er is geen maximale aantal <product> elementen dat mag voorkomen. <id> Een volledig, positief getal ID van het product zoals deze bekend is bij de leverancier. Bij een bestelling zal deze opgegeven worden. <title> Apple ipod (32GB, rood) Titel van het product zoals deze weergegeven moet worden op easygiven. Eventuele bijzonderheden kunnen hier benoemd worden. <brand> Apple Merknaam van het product. <model> ipod Model en/of uitvoering van het product bij het merk.

3 <description> Tekstueel, basis HTML. Een <b>prachtige</b> muziekspeler. Beschrijving van het product. In dit veld mag een kleine subset aan HTML worden gebruikt, namelijk de volgende tags: <b> Maak (een deel van) de tekst dikgedrukt. <i> Maak (een deel van) de tekst cursief. <u> Maak (een deel van) de tekst onderstreept. <ol> Een genummerde lijst. <ul> Een ongenummerde (bullet-)lijst. <li> Item binnen een lijst. <p> Paragraaf. <br> Nieuwe regel buiten een paragraaf. <tags> apple, ipad, muziek, speler, mp3 Eén of meerdere woorden welke een relatie hebben tot dit artikel. Meerdere woorden moeten worden gescheiden door een komma, direct gevolgt door een spatie (, ). <picture> Tekstueel (URL). Een absolute URL naar een afbeelding bij dit product, in een zo hoog mogelijke resolutie. <link> Tekstueel (URL). Een absolute URL naar de productinformatiepagina op de website van de leverancier. <price> Een positief getal, in Euro, met twee cijfers achter de punt. 39,95 De prijs van dit product, exclusief verzendskosten, inclusief BTW en eventuele afhandelingskosten. <deliverytime> Eén of twee volledig, positieve getallen. 1-5 De levertijd van dit product in dagen. 0 in geval het product nog dezelfde dag verzonden zou kunnen worden, 30 in geval van onbekend. Een span aan dagen kan aangegeven worden door twee getallen op te geven, gescheiden door spaties en een streepje ( - ). <deliveryprice> Een positief getal, in Euro, met twee cijfers achter de punt. 4,95 Totale kosten welke in rekening worden gebracht voor het versturen van dit product. <stock> Eén of twee volledig, positieve getallen De actuele voorraad voor dit product. 0 in geval het product niet in voorraad is, 1000 in het geval er geen precieze waarde bekend is, maar wel voldoende. Een span aan dagen kan aangegeven worden door twee getallen op te geven, gescheiden door spaties en een streepje ( - ).

4 Voorbeelden: <option> Direct onder het <stock> element. Indien het product meerdere varianten heeft kunnen deze hieronder worden weergegeven. Indien er geen andere varianten zijn, kunnen deze node leeg gelaten worden. Hier binnen vallen de items, het is hierin mogelijk om per product een nieuwe item te beginnen Binnen deze node vallen de kleuren en maten per item <color> Zwart De kleur van het product <size> Direct onder het <color> element. 38, Medium, 64Gb Voor iedere maat moet een nieuwe node worden aangemaakt zie pag.1 van dit document als voorbeeld Zie voorbeelden van verschillende opties op de volgende pagina.

5 Voorbeelden: 1 product in 2 kleuren met verschillende maten per kleur (bijv. schoenen): <size>37</size> <size>38</size> <color>grey</color> 1 product in meerdere kleuren (bijv. een klok): <color>white</color> <color>red</color> <color>orange</color> 1 product in meerdere maten (bijv. een tafel): <size>100x180</size> <size>100x200</size> <size>100x220</size>