Handleiding productfeeds bol.com

Vertrouwelijke informatie

Versie 3.0 | Juli 2014 Pagina 1 / 38

Handleiding productfeeds bol.com

Alle informatie in dit document is vertrouwelijk en mag niet worden verspreid of

aangeboden aan derden zonder expliciete toestemming van bol.com BV.



Wat is een productfeed?

Een productfeed is een tekstbestand (.txt) met informatie over de beschikbare producten

van bol.com. Deze informatie kunnen Partners gebruiken bij de promotie van bol.com

producten op hun eigen website. Door gebruik te maken van een feed kunnen Partners

gemakkelijk en snel veel gegevens verwerken en deze up-to-date houden. De partner

moet zelf de tracking toevoegen aan de informatie uit de productfeed.

De productfeeds van bol.com bevatten de naam, categorie, subcategorie, prijs, levertijd,

specificaties, afbeelding en URL van de beschikbare producten. Informatie kan door de

geaccepteerde Partners geraadpleegd worden. Deze Partners staan op een whitelist.

Het bestand van de productfeed bestaat uit regels met informatie. Iedere regel

vertegenwoordigd een ander product. De producten binnen een bepaalde categorie hebben

dezelfde opmaak en specificaties.

De feeds worden iedere 2 uur ge-update. Sommige feeds worden minder frequent ge-

update, zoals de boeken feed, muziek feed en de DVD feed. Deze drie feeds worden iedere

dag bijgewerkt.

Wat zijn de voordelen van een productfeed?

De beschikbare informatie is up-to-date.

Niet leverbare producten worden verwijderd uit de feeds.

Veel informatie kan gemakkelijk verwerkt worden door de Partners.

Hoe gebruik ik een productfeed?

Om gebruik te kunnen maken van een productfeed moet deze worden ingeladen in de

website. Dit kan, afhankelijk van het eigen kennisniveau, op verschillende manieren:

Doormiddel van een import in eigen database. Scripting kennis is hiervoor vereist.

Doormiddel van plugins en standaard-scripts voor CMS pakketten, zoals Wordpress.

Doormiddel van tools voor het ophalen van productfeeds.

Inloggegevens

Om de informatie te raadplegen moet er worden ingelogd op de FTP-server van bol.com.

Voor het ophalen van de productfeeds kun je ook gebruik maken van programma’s zoals

Filezilla of WSFTP.

Voorbeeld van een productregel in de bestbuy productfeed

"Business_unit"|"Category_1"|"Category_2"|"Category_3"|"Typ_code"|"Title"|"Su

btitle"|"Stock_NL"|"Dummy_1"|"Brand"|"Price_NL"|"Shipping"|"Delivery_time_NL"

|"Deliverable"|"MPN"|"EAN"|"Global_ID"|"Image_regular"|"ID"|"Seller_ID"|"Sell

er"|"Dummy_2"|"Typ_category_3"|"Delivery_time_BE"|"Stock_BE"|"List_price_NL"|

"List_price_BE"|"Price_BE"|"Delivery_BE"|"Release_date"|"Family_ID"|"Family_n

ame"|"GpcBrick_ID"|"Party_ID"

"baby"|"Onderweg"|"Buik- & Rugdragers"|""|"BABY"|"Manduca NewStyle - Draagzak

- Marineblauw"|""|"1"|""|"Manduca"|"119.00"|"0.00"|"Op werkdagen voor 16:00

uur besteld, morgen in

huis"|"1"|""|"4250371700535"|"9200000022381705"|"http://s.s-

http://www.woorden.org/woord/updaten&from=ge%C3%BCpdatet&from2=ge%C3%BCpdate





bol.com/imgbase0/imagebase/regular/FC/5/0/7/1/9200000022381705.jpg"|"http://w

ww.bol.com/nl/p/manduca-newstyle-draagzak-

marineblauw/9200000022381705/"|"880869"|"P"|""|"Buik- & Rugdragers"|"2

werkdagen"|"1"|""|""|"122.00"|"Y"|""|"9200000022381704"|"Manduca NewStyle -

Draagzak - Marineblauw"|"10000502"|"10564363"

"baby"|"Onderweg"|"Buik- & Rugdragers"|""|"BABY"|"Manduca NewStyle - Draagzak

- Rood"|""|"2"|""|"Manduca"|"119.00"|"0.00"|"Op werkdagen voor 16:00 uur

besteld, morgen in

huis"|"1"|""|"4250371700474"|"9200000022381703"|"http://s.s-


ww.bol.com/nl/p/manduca-newstyle-draagzak-

rood/9200000022381703/"|"880869"|"P"|""|"Buik- & Rugdragers"|"2

werkdagen"|"1"|""|""|"122.00"|"Y"|""|"9200000022381702"|"Manduca NewStyle -

Draagzak - Rood"|"10000502"|"10564363"

"baby"|"Onderweg"|"Buik- & Rugdragers"|""|"BABY"|"Manduca BlackLine -

Draagzak - ScreaminGreen"|""|"1"|""|"Manduca"|"129.00"|"0.00"|"Op werkdagen

voor 16:00 uur besteld, morgen in

huis"|"1"|""|"4250371700665"|"9200000022381707"|"http://s.s-


ww.bol.com/nl/p/manduca-blackline-draagzak-

screamingreen/9200000022381707/"|"880869"|"P"|""|"Buik- & Rugdragers"|"2

werkdagen"|"1"|""|""|"132.00"|"Y"|""|"9200000022381706"|"Manduca BlackLine -

Draagzak - ScreaminGreen"|"10000502"|"10564363"

*Het bovenstaande voorbeeld is afkomstig van de bolcom_bestbuy_baby.TXT feed.

Soorten en bestandsnamen productfeeds

Wij bieden zowel een 'Best Buy' als bol.com-only feed aan. De Best Buy feed bevat voor ieder

product het beste aanbod op het moment dat de feed wordt samengesteld. Dat kan het aanbod

van bol.com of een zakelijk verkoper (bol.com Plaza) zijn.

In de laatste kolom van iedere productregel zie je aan de hand van een B (bol.com) of P (Plaza)

wie het product aanbiedt. De bol.com-only feed bevat alleen het aanbod van bol.com. In deze

feeds wordt het aanbod van externe verkopers niet meegenomen. Naast de feeds per

productgroep is er een aparte feed met tweedehands boeken.

Bol.com

bolcom_baby.TXT

bolcom_boeken-engels.TXT

bolcom_boeken.TXT

bolcom_dier-tuin-klussen.TXT

bolcom_dvd.TXT

bolcom_elektronica.TXT

bolcom_games.TXT

bolcom_koken-tafelen.TXT

bolcom_mobiele-telefonie.TXT

bolcom_mooi-gezond.TXT

bolcom_muziek.TXT

bolcom_notebooks-pc-accessoires.TXT

bolcom_sieraden-horloges-accessoires.TXT

bolcom_speelgoed.TXT

bolcom_vrije-tijd.TXT

bolcom_wonen.TXT

ftp://ftp.bolcom.nl/bolcom_boeken.TXT

ftp://ftp.bolcom.nl/bolcom_baby.TXT

ftp://ftp.bolcom.nl/bolcom_boeken-engels.TXT

ftp://ftp.bolcom.nl/bolcom_boeken.TXT

ftp://ftp.bolcom.nl/bolcom_dier-tuin-klussen.TXT

ftp://ftp.bolcom.nl/bolcom_dvd.TXT

ftp://ftp.bolcom.nl/bolcom_elektronica.TXT

ftp://ftp.bolcom.nl/bolcom_games.TXT

ftp://ftp.bolcom.nl/bolcom_koken-tafelen.TXT

ftp://ftp.bolcom.nl/bolcom_mobiele-telefonie.TXT

ftp://ftp.bolcom.nl/bolcom_mooi-gezond.TXT

ftp://ftp.bolcom.nl/bolcom_muziek.TXT

ftp://ftp.bolcom.nl/bolcom_notebooks-pc-accessoires.TXT

ftp://ftp.bolcom.nl/bolcom_sieraden-horloges-accessoires.TXT

ftp://ftp.bolcom.nl/bolcom_speelgoed.TXT

ftp://ftp.bolcom.nl/bolcom_vrije-tijd.TXT

ftp://ftp.bolcom.nl/bolcom_wonen.TXT



Bol.com 2ehands

bolcom_2ehands-boeken.TXT

Bol.com + externe verkopers (Plaza)

bolcom_bestbuy_baby.TXT

bolcom_bestbuy_boeken-engels.TXT

bolcom_bestbuy_boeken.TXT

bolcom_bestbuy_dier-tuin-klussen.TXT

bolcom_bestbuy_dvd.TXT

bolcom_bestbuy_elektronica.TXT

bolcom_bestbuy_games.TXT

bolcom_bestbuy_koken-tafelen.TXT

bolcom_bestbuy_mobiele-telefonie.TXT

bolcom_bestbuy_mooi-gezond.TXT

bolcom_bestbuy_muziek.TXT

bolcom_bestbuy_notebooks-pc-

accessoires.TXT

bolcom_bestbuy_sieraden-horloges.TXT

bolcom_bestbuy_speelgoed.TXT

bolcom_bestbuy_vrije-tijd.TXT

bolcom_bestbuy_wonen.TXT

Tracking URL

De URL’s in de productfeeds zijn reguliere productlinks naar de website van bol.com. Deze

kunnen worden omgezet naar een tracking URL. Een tracking URL is nodig om te registreren

van wie de verkoop afkomstig is. Zonder tracking URL wordt een verkoop niet correct

toegewezen aan de verantwoordelijke Partner. De registratie wordt gedaan doormiddel van

een cookie. Hieronder een voorbeeld van het samenstellen van een dergelijke link:

Product:

The Common Linnets Cd

Gegevens voorbeeld Partner:

SiteId is “144”

Subid is “123”

Naam is “linnets”

Productlink:

http://www.bol.com/nl/p/the-common-linnets/9200000026169207

Opbouw tracking URL:

http://partnerprogramma.bol.com/click/click?p=1&t=url&s=SiteId&url=Productli

nk&f=TXL&subid=SubID&name=Naam

Voorbeeld eindresultaat:

ftp://ftp.bolcom.nl/bolcom_2ehands-boeken.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_baby.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_boeken-engels.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_boeken.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_dier-tuin-klussen.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_dvd.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_elektronica.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_games.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_koken-tafelen.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_mobiele-telefonie.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_mooi-gezond.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_muziek.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_notebooks-pc-accessoires.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_notebooks-pc-accessoires.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_sieraden-horloges.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_speelgoed.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_vrije-tijd.TXT

ftp://ftp.bolcom.nl/bolcom_bestbuy_wonen.TXT



http://partnerprogramma.bol.com/click/click?p=1&t=url&s=144&url=http://ww

w.bol.com/nl/p/the-common-

linnets/9200000026169207&f=TXL&subid=123&name=linnets

Let op: de correcte wijze van invoer is verantwoordelijkheid van de partner. Denk ook aan

het encoderen van de productlink. Controleer dus altijd of je links werken in je rapportages

voordat je deze definitief plaatst in je website.

Productfeed specificaties per categorie

Feed Baby File Bolcom_google_baby.txt Delimeter: |

Text enclosure: "

Order Header

Bron systeem Data kolom

Constante waarde Vertaling

1 Business_unit baby

2 Category_1"|"Category_2"|"Category_3 PCS

TYP_CODE,GPC_BRICK_ID

Best buy Categorie GPC vertaling

3 Typ_code PCS TYP_CODE

4 Title PCS TITLE

5 Subtitle PCS SUBTITLE

6 Stock_NL POS CORRECTED_STOCK_NL Voorraad vertaling

7 Dummy_1 <leeg>

8 Brand PCS BRANDS

9 Price_NL POS GROSS_SELLING_PRICE_NL

10 Shipping POS SHIPPING



11 Delivery_time_NL POS

DELIVERABLE_NL, MAXIMAL_DELIVERY_TIME_NL, ULTIMATE_ORDER_TIME_NL

Beschikbaarheid vertaling

12 Deliverable POS

DELIVERABLE, MAXIMAL_DELIVERY_TIME

Voorraad 2 vertaling

13 MPN PCS MPN

14 EAN PCS EAN_CODE

15 Global_ID PCS / POS GLOBAL_ID

16 Image_regular PCS COVER_IMAGE Image URL vertaling

17 ID PCS TITLE,GLOBAL_ID Link vertaling

18 Seller_ID POS SLR_ID

19 Seller POS SLR_ID Seller vertaling

20 Dummy_2 <leeg>

21 Typ_category_3 PCS TYP_CODE,GPC_BRICK_ID

Categorie GPC boom

22 Delivery_time_BE POS

DELIVERABLE_BE, MAXIMAL_DELIVERY_TIME_BE, ULTIMATE_ORDER_TIME_BE


23 Stock_BE POS CORRECTED_STOCK_BE

Voorraad vertaling

24 List_price_NL POS LIST_PRICE_NL

25 List_price_BE POS LIST_PRICE_BE

26 Price_BE POS GROSS_SELLING_PRICE_BE

27 Delivery_BE POS DELIVERABLE_BE

28 Release_date POS RELEASE_DATE

29 Family_ID PCS FAMILY_ID

30 Family_name PCS FAMILY_NAME

31 GpcBrick_ID PCS GPC_BRICK_ID

32 Party_ID PCS BRAND_ID



Feed Boeken Engels File bolcom_bestbuy_boeken-engels.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit boeken-engels

2 Category_1"|"Category_2"|"Category_3 PCS PCY_CODES

Best buy Categorie omschrijving vertaling


4 Binding_code PCS UUB_BINDINGCODE Binding vertaling

5 Title PCS TITLE


7 Free_gift PCS FREE_GIFT

8 Author PCS AUTHORS Party name vertaling








12 Deliverable POS




14 EAN PCS EAN_CODE




18 Language PCS LANGUAGE



21 Dummy_1 <leeg>





Voorraad vertaling









32 Party_ID PCS AUTHOR_IDS Party ID vertaling



Feed Boeken NL File bolcom_bestbuy_boeken.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit boeken




4 Binding_code PCS BINDINGCODE Binding vertaling

5 Title PCS TITLE



8 Author PCS AUTHORS Party name vertaling








12 Deliverable POS




14 EAN PCS EAN_CODE


16 Image_regular PCS THUMB_COVER_IMAGE Image URL vertaling




20 Dummy_1 <leeg>





Voorraad vertaling








31 Party_ID PCS AUTHOR_IDS Party ID vertaling




Feed Dieren, tuin & klussen File bolcom_bestbuy_dier-tuin-klussen.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit dier-tuin-klussen





4 Title PCS TITLE

5 sub_title PCS SUBTITLE

6 Stock_NL POS CORRECTED_STOCK_NL

Voorraad vertaling

7 Publishers <leeg>

8 Brand PCS BRANDS








12 Deliverable POS



13 MPN PCS MPN

14 EAN PCS EAN_CODE



17 Titel PCS TITLE,GLOBAL_ID Link vertaling



20 Dummy_1 <leeg>


Categorie GPC boom





Voorraad vertaling












Feed DVD File bolcom_bestbuy_dvd.<> Delimeter: |

Text enclosure: "

Order Header



1 Business_unit dvd




4 Title PCS TITLE



7 Format PCS DVD_FORMAT

8 Actor PCS ACTORS Party name vertaling








12 Deliverable POS



13 EAN PCS EAN_CODE






19 Dummy_1 <leeg>






Voorraad vertaling









31 Party_ID PCS ACTOR_IDS Party ID vertaling



Feed Elektronica File bolcom_bestbuy_elektronica.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit elektronica




4 Title PCS TITLE



7 Brand PCS PUBLISHERS

8 Colour PCS COLOUR








12 Deliverable POS




Voorraad vertaling

14 MPN PCS MPN

15 EAN PCS EAN_CODE






21 Dummy_1 <leeg>





Voorraad vertaling









32 Party_ID PCS PUBLISHER_ID



Feed Games File bolcom_bestbuy_games.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit games




4 Title PCS TITLE



7 Publisher PCS PUBLISHERS








11 Deliverable POS




13 MPN PCS MPN

14 EAN PCS EAN_CODE






20 Dummy_1 <leeg>





Voorraad vertaling












Feed Kleding File bolcom_bestbuy_kleding.<> Delimeter: |

Text enclosure: "

Order Header



1 Business_unit kinderkleding


TYP_CODE,GPC_CHUNK_ID



4 Title PCS TITLE



Voorraad vertaling

7 Dummy_1 <leeg>

8 Brand PCS BRANDS








12 Deliverable POS



13 MPN PCS MPN

14 EAN PCS EAN_CODE






20 Dummy_2 <leeg>

21 Typ_category_3 PCS TYP_CODE,GPC_CHUNK_ID

Categorie GPC boom





Voorraad vertaling










33 Material PCS MATERIAL

34 Gender PCS GENDER



Feed Koken & tafelen File bolcom_bestbuy_koken-tafelen.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit koken-tafelen





4 Title PCS TITLE



7 Dummy_1 <leeg>

8 Brand PCS BRANDS








12 Deliverable POS



13 MPN PCS MPN

14 EAN PCS EAN_CODE






20 Dummy_2 <leeg>


Categorie GPC boom





Voorraad vertaling












Feed Mooi & gezond File bolcom_bestbuy_mooi-gezond.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit mooi-gezond





4 Title PCS TITLE



7 Dummy_1 <leeg>

8 Brand PCS BRANDS








12 Deliverable POS



13 MPN PCS MPN

14 EAN PCS EAN_CODE






20 Dummy_2 <leeg>


Categorie GPC boom





Voorraad vertaling












Feed Mobiele telefonie File bolcom_bestbuy_mobiele-telefonie.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit telefonie




4 Title PCS TITLE



7 Brand PCS PUBLISHERS

8 Colour PCS COLOUR









13 Deliverable POS




15 MPN PCS MPN

16 EAN PCS EAN_CODE






22 Dummy_1 <leeg>





Voorraad vertaling











Feed Muziek File bolcom_bestbuy_muziek.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit muziek




4 Title PCS TITLE



7 Author PCS PERFORS Party name vertaling








11 Deliverable POS



12 EAN PCS EAN_CODE






18 Dummy_1 <leeg>






Voorraad vertaling







30 Party_ID PCS PERFOR_IDS Party ID vertaling





Feed Notebooks, pc & accessoires File

bolcom_bestbuy_notebooks-pc-accessoires.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit

notebooks-pc-accessoires


TYP_CODE,GPC_CHUNK_ID,PCY_CODES

Best buy Electronica vertaling


4 Title PCS TITLE



7 Publisher PCS PUBLISHERS

8 Colour PCS COLOUR








12 Deliverable POS DELIVERABLE, MAXIMAL_DELIVERY_TIME



14 MPN PCS MPN

15 EAN PCS EAN_CODE


17 Image_regular PCS COVER_IMAGE

Image URL vertaling




21 Dummy_1 <leeg>




23 Stock_BE POS CORRECTED_STOCK_BE Voorraad vertaling












Feed Sieraden & horloges File bolcom_bestbuy_sieraden-horloges.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit sieraden-horloges


TYP_CODE,GPC_CHUNK_ID



4 Title PCS TITLE



7 Dummy_1 <leeg>

8 Brand PCS BRANDS








12 Deliverable POS



13 MPN PCS MPN

14 EAN PCS EAN_CODE






20 Dummy_2 <leeg>

21 Typ_category_3 PCS TYP_CODE,GPC_CHUNK_ID

Categorie GPC boom





Voorraad vertaling










33 Material PCS MATERIAL

34 Gender PCS GENDER



Feed Speelgoed File bolcom_bestbuy_speelgoed.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit speelgoed




4 Title PCS TITLE



Voorraad vertaling

7 Dummy_1 <leeg>

8 Brand PCS BRANDS








12 Deliverable POS



13 MPN PCS MPN

14 EAN PCS EAN_CODE






20 Dummy_2 <leeg>





Voorraad vertaling












Feed Vrije tijd File bolcom_bestbuy_vrije-tijd.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit vrije-tijd





4 Title PCS TITLE



7 Dummy_1 <leeg>

8 Brand PCS BRANDS








12 Deliverable POS



13 MPN PCS MPN

14 EAN PCS EAN_CODE






20 Dummy_2 <leeg>


Categorie GPC boom





Voorraad vertaling












Feed Wonen File bolcom_bestbuy_wonen.<>

Delimeter: |

Text enclosure: "

Order Header



1 Business_unit wonen





4 Title PCS TITLE

5 sub_title PCS SUBTITLE


7 Dummy_1 <leeg>

8 Brand PCS BRANDS








12 Deliverable POS



13 MPN PCS MPN

14 EAN PCS EAN_CODE






20 Dummy_2 <leeg>


Categorie GPC boom





Voorraad vertaling










Handleiding productfeeds bol.com

Documents

Transcript of Handleiding productfeeds bol.com