Specificaties productfeed

Voorwaarden Pricewatch productfeed

Om uw database te kunnen koppelen aan de Pricewatch database moet de database aan een aantal technische voorwaarden voldoen.

Online beschikbaar
De database met prijsdata moet als een CSV of XML file online op de site staan: onze server kan uw database dan zelfstandig downloaden en updates kunnen automatisch vanuit die database uitgevoerd worden.

Noodzakelijke kolommen
De product feed dient minimaal de kolommen te bevatten voor “EAN-code” of “SKUcode”, “Prijs”, “Levertijd”, “Leverkosten” (indien verschillend per product), “Deeplink” en “Productnaam”. De volgorde en de benamingen van deze kolommen maakt niet uit, dit is instelbaar in de Pricewatch Manager.

Hoe worden producten gekoppeld aan de Pricewatch?

De producten worden gekoppeld aan de hand van het unieke artikel nummer: de EAN productcode, SKU code of Tweakers ID. Hierdoor is bekend dat een bepaald product uit uw database hetzelfde product is als een product in onze Pricewatch Database.

Barcode (EAN)
Naast de code die de fabrikanten aan hun product meegeven (SKU), krijgen alle producten ook een barcode (EAN) mee. Doormiddel van deze unieke barcode kunt u uw prijzen koppelen aan de productvermeldingen in de Tweakers Pricewatch. Dit is de meest gebruikte manier voor het koppelen van producten, doordat een EAN een uniek nummer is.

Artikelnummer van de fabrikant (SKU)
Producten krijgen van de fabrikant vaak (naast de productnaam) een eigen productnummer, productcode, vendorcode of -id mee. Deze productnummers staan voor een groot aantal producten al in onze database onder de noemer SKU.

Tweakers ID
Het kan voorkomen dat een Pricewatch product (nog) niet beschikt over een SKU of EAN. In deze gevallen is het mogelijk een koppeling tot stand te brengen door middel van het Tweakers ID.

De productcodes die bij ons bekend zijn, zijn onderaan de specificatiepagina van het desbetreffende product terug te vinden:

Levertijden
Het is van belang dat zowel de prijzen als de levertijden juist worden vermeld in de Pricewatch. Mochten deze namelijk niet overeenkomen met de vermeldingen op de website van de shop zullen wij deze prijzen helaas moeten blokkeren.

De Tweakers Pricewatch kent de volgende levertijdindicaties:

De Pricewatch stelt de juiste indicatie in aan de hand van de volgende regels:

  • Als het veld puur alleen een getal is, dan gaan we er van uit dat dat het aantal dagen is.
  • Als het veld de tekst "morgen in huis", "morgen geleverd" of "24h" bevat (dus er mag van alles voor of na staan), dan beschouwen we dat als 24ulevering.
  • Als de tekst "direct leverbaar", "24 uur", "24u" bevat, dan beschouwen we het als 1 dag.

Alle levertijdindicaties worden geïmporteerd vanuit de feed, hierbij zijn echter 2 uitzonderingen:

  • Digitale download – deze wordt niet uit de feed gehaald, maar door Tweakers ingesteld als levertijd voor alle producten van het shopaccount. Mocht u zowel fysieke als digitale downloads aanbieden dan dienen hier 2 aparte feeds voor aangeleverd te worden.
  • Vandaag besteld, mogen in huis. Verstuurt ook in het weekend – Voor deze levertijdindicatie dient u de levertijd voor 24/5 mee te nemen in de feed. Zodra er hierbij ook op zondag bezorgd wordt kan dit aan Tweakers doorgeven worden, waarbij de 24/5 icoontjes veranderen naar 24/7.

Hierbij enkele voorbeelden hoe de Pricewatch de levertijden vertaald:

1 = Levering verwacht binnen 3 dagen
3 dagen = Levering verwacht binnen 3 dagen
24 uur = Levering verwacht binnen 3 dagen
1 tot 3 dagen = Levering verwacht binnen 3 dagen
3 - 5 dagen = Levering verwacht binnen 5 dagen
Morgen geleverd = Op een werkdag besteld, morgen in huis
24h = Op een werkdag besteld, morgen in huis
Vandaag voor 20:00 uur besteld, morgen in huis = Op een werkdag voor 20:00u besteld, morgen in huis
download = Download
Pre-order Alvast te reserveren

Mocht je er niet helemaal zeker van zijn hoe de levertijden door Tweakers geclassificeerd worden, dan kan je dit controleren in de Pricewatch Manager onder “Importeren” ⇨ “Levertijden”. Hier kan je de waarde invoeren en bekijken hoe de Pricewatch deze classificeert.

Voorbeeld van een productfeed
De Pricewatch Manager ondersteunt tekst databases die voldoen aan de internationale CSV-standaard, aan de Extensible Markup Language (XML) standaard of aan JavaScript Object Notation (JSON).

CSV-database
CSV staat voor "Comma-Seprated Value". Hiervan zijn drie varianten:

  • Tabgescheiden
  • Kommagescheiden
  • Puntkommagescheiden

In uw tekstbestand mogen de kolommen dus gescheiden worden door tabs, komma's of puntkomma's. De volgorde van uw kolommen maakt niet uit, maar let er wel op dat wanneer u een kommagescheiden bestand gebruikt, dat u bij de prijzen niet ook komma's gebruikt worden om euro's en centen te scheiden.

Voorbeeld van een puntkommagescheiden CSV-document:

EAN code;SKU Code;Naam;Deeplink;Prijs;Levertijd;Verzendkosten;Promotiezin 8806071470511;GT-I9001HKDXEN;Samsung Galaxy S Plus i9001 Zwart;http://www.uwwinkel.nl/product/galaxy-s-plus-zwart.html;256,00;op werkdagen voor 17:00 uur besteld, morgen in huis;4,95;Gratis verzending boven de € 50,- 8806071501413;GT-I9001RWDXEN;Samsung Galaxy S Plus i9001 Zilver;http://www.uwwinkel.nl/product/galaxy-s-plus-zilver.html;273,00;op werkdagen voor 17:00 uur besteld, morgen in huis;4,95; Nu met gratis dongel

XML-database
XML staat voor Extensible Markup Language en is een standaard van het World Wide Web Consortium voor de syntaxis van formele opmaaktalen waarmee men gestructureerde gegevens kan weergeven in de vorm van platte tekst. Een XML-document is tekst waaraan tags zijn toegevoegd.

Voorbeeld van een XML-document:

<Products>
<Product>
<Product_in_stock>50</Product_in_stock>
<Product_Brand>CASE LOGIC</Product_Brand>
<SKU_Code>VNCI118</SKU_Code>
<Product_Name>Case Logic 17/18" notebooktas VNCI118</Product_Name>
<Product_Price>19,99</Product_Price>
<Delivery_Period>3 dagen</Delivery_Period>
<Product_Ean>0085854199667</Product_Ean>
<Deeplink>http://www.uwwinkel.nl/VNCI118/default.aspx?channel=40</Deeplink>
<Delivery_Costs>4,95</Delivery_Costs>
<Promotiezin> Gratis verzending boven de € 50,-</Promotiezin>
</Product>
<Product>
<Product_in_stock>50</Product_in_stock>
<Product_Brand>CASE LOGIC</Product_Brand>
<Vendor_Code>VNCI118</Vendor_Code>
<Product_Name>Case Logic 17/18" notebooktas VNCI118</Product_Name>
<Product_Price>19,99</Product_Price>
<Delivery_Period>3 dagen</Delivery_Period>
<Product_Ean>0085854199667</Product_Ean>
<Deeplink>http://www.uwwinkel.nl/VNCI118/product_code=14327908</Deeplink>
<Delivery_Costs>4,95</Delivery_Costs>
<Promotiezin>Nu met gratis dongel </Promotiezin>
</Product>
</Products>

JSON-database
JSON staat voor JavaScript Object Notation en is een op JavaScript gebaseerde manier om gegevens te weergeven en op te slaan. Met JSON zijn gegevens op een georganiseerde en gemakkelijk toegankelijke manier weergeven, waardoor deze eenvoudig zijn af te lezen.

Voorbeeld van een JSON-document:

[

{

"deep_link": "https://www.example.com/product/123",

"price": "49,50",

"product_name": "Acme anvil",

"tweakers_id": null,

"ean1": "1234567890",

"ean2": "9847239429",

"ean3": null,

"sku1": "ACME ANVIL 1979 RB1a",

"sku2": null,

"sku3": null,

"delivery_time_NL": "24h",

"delivery_time_BE": "3 dagen",

"delivery_cost_NL": "2,95",

"delivery_cost_BE": "4,95",

"promo_NL": "Al meer dan 20 jaar betrouwbaar",

"promo_BE": null,

// These fields are only required for the refurbished (tweede kans) feeds

"condition": "refurbished",

"condition_description": "Nieuw scherm en batterij",

"warranty_period": null

},

{

// etc..

}

]


Nintendo Switch (OLED model) Apple iPhone SE (2022) LG G1 Google Pixel 6 Call of Duty: Vanguard Samsung Galaxy S22 Garmin fēnix 7 Nintendo Switch Lite

Tweakers vormt samen met Hardware Info, AutoTrack, Gaspedaal.nl, Nationale Vacaturebank, Intermediair en Independer DPG Online Services B.V.
Alle rechten voorbehouden © 1998 - 2022 Hosting door True