1. Inleiding Dit document heeft als doel de nodige informatie te verschaffen aan de IT staff van een wineshop om hen toe te laten een data feed op te zetten tussen 90pluswines.com en de handelaar zijn database. Dit teneinde 90plus toe te laten periodiek de wijn lijst te downloaden en de prijs database gesynchroniseerd te houden met die van de handelaar. 2. Definitie van een “conforme data feed” De simpelste definitie van een “data feed” is een gestructureerde lijst die ter beschikking gesteld is van 90pluswines, in de vorm van een bestand of script gehost op de handelaar zijn website.
“Conform” betekend dat de data feed voldoet aan de volgende voorwaarden: -
De feed bevat één enkele gestructureerde lijst, in een van de ondersteunde formaten opgelijst in paragraaf 3. De feed bevat alle verplichte velden zoals omschreven in paragraaf 4.1. Het ter beschikking stellen van extra informatie (paragraaf 4.2) buiten deze velden is aangemoedigd maar niet verplicht.
3. Ondersteunde feed formaten Heden ondersteunt ons import systeem de volgende formaten: -
XML Excel 97-2003 .XLS Excel 2007 en nieuwer.XLSX CSV bestanden (Comma Separated Files) Tab delimited tekst bestanden.
Onze voorkeur gaat uit naar XML feeds, dus als de feed in kwestie nog dient gecreëerd te worden, zou dit zowel voor u als voor 90pluswines het handigste formaat moeten zijn. Een opmerking hierbij, een veel voorkomende manier om een downloadbare Excel file aan te bieden op een website is een HTML pagina met tabellen in generen met een script, en dan dit als .XLS file aan de bezoeker aanleveren. Heden ondersteunen wij dit soort lijsten niet.
4. Feed inhoud 4.1 Verplichte velden De feed moet een gestructureerde lijst zijn met minstens de onderstaande velden. Field Wine Name
Vintage
Volume
Sales Price
Description Omschrijving van de wijn, met alle nodige informatie om de wijn uniek te omschrijven. Bijvoorbeeld: "Meursault 1er Cru" of "Veuve Cliquot" zijn niet specifiek genoeg omschreven omdat de producent en de cuvee er niet bij staan. De jaargang in 4 cijfer formaat. Gebruik NV voor non-vintage wijnen. Indien er meer dan een vintage van een bepaalde wijn aangeboden wordt, dient u deze als aparte wijnen in uw feed te definiëren. Het volume van de wijnfles, bij voorkeur uitgedrukt in centiliters. Bijvb: “37,5”, “75”, “150”. We kunnen echter ook overweg met bijvb. “37,5 CL” of “0.375”. Prijs per fles, zonder BTW, verkoopsbelasting en vervoerskosten. Uitgedrukt in EUR. Andere wisselkoersen zijn ook ondersteund, maar dan dient u ons dit te laten weten zodat we uw feed correct kunnen configureren.
Het is niet noodzakelijk dat deze velden/kolommen exact de naam zoals hierboven omschreven hebben. Ze dienen aanwezig te zijn onder één welbepaalde naam.
4.2 Optionele velden Onderstaande velden zijn optioneel. De extra informatie die ze verschaffen helpt ons om gemakkelijker de wijnen die bedoelt worden te herkennen en te mappen in ons systeem.
Field Quantity
Product_url Image_url Remark Winery Color Country Region Subregion Varietal
Appelation
Description Aantal flessen op stock. Gelieve wijnen die u niet langer in stock heeft niet in de lijst weer te geven. URL van de pagina waar de wijn wordt omschreven op de merchant website. URL van de foto van de wijnfles. Extra informatie (OWC, vulniveau, label voorwaarden, ... ) Naam van de wijnproducent. Kleur van de wijn, mogelijkheden zijn: red,white,rose. Land van herkomst. Regio/provincie van herkomst. Subregio van herkomst. De samenstelling van de wijn, druivensoorten/het sepage. Bijvb: Cabernet Sauvignon (50%); Merlot (50%)) De Appellatie / DOC (=het meest specifieke niveau van herkomst.)
Het is niet noodzakelijk dat deze velden/kollommen exact de naam zoals hierboven omschreven hebben. Ze dienen aanwezig te zijn onder één welbepaalde naam.
5. Voorbeelden & richtlijnen 5.1 XML Feed <products>
- <winename>Petrus Pomerol 2005 37,5 <salesprice>999,9
- <winename>Moet & Chandon nv 75 <salesprice>50
De XML moet well formed zijn en in bovenstaande vorm. We kunnen geen node attributes verwerken, enkel de “inner text”. Met andere woorden, het volgende formaat is NIET ONDERSTEUND: <wine name=”Moet & Chandon” vintage =”2005”>
5.2 XLS/XLSX Feed
Op dit moment is het verplicht dat de eerste lijn van het excel werkblad de kolomnamen bevat. Hoe deze exact noemen is niet van belang, wij kunnen een mapping maken. We kunnen geen complexe XLS structuren verwerken. Bijvb: De wijnen staan gegroepeerd per naam, met dan per vintage een lijn met de prijs. Ook headers voor de XLS data begint en blanco lijnen/titels zijn niet toegelaten op dit moment.
5.3 CSV Feed / Delimited tekst bestanden “winename”;”vintage”;”volume”;”salesprices” “Petrus Pomerol”; ”2005”; ”37.5”; ”1000” ”Moet & Chandon”; ”nv”; ”75”; ”50” De indeling zonder aanhalingstekens is ook ondersteund, maar niet aangeraden. winename;vintage;volume;salesprices Petrus Pomerol;2005;37.5;1000 Moet & Chandon;nv;75;50 Het is hier eveneens zo dat de eerste lijn de kolomnamen dient te bevatten of we zijn niet in staat uw lijst te verwerken. We accepteren de volgende karakters als separators: -
“;” (puntkomma) “,” (komma) Tab
Zolang het separator karakter nooit in de velden zelf voorkomen, en er tegelijk van het formaat zonder aanhalingstekens gebruik gemaakt wordt, zouden we moeten in staat zijn uw lijst te verwerken.
6. Support contactgegevens
Mochten er zaken zijn in dit document die niet duidelijk zijn, of u bent niet in staat om een feed aan te leveren die met alle regels in dit document stroken, kunt u steeds de feed beheerder contacteren voor advies en eventuele oplossingen Pieter Vandenhende
[email protected] +32 9 243 97 25
