Key Concepts
Within the API you may find some terms that you are not familiar with. Some of these terms are bol specific whilst others are general standards.
Bol Specific Terms
Bol specific terms are terms that we have defined internally.
Term |
Meaning |
bolProductId |
The unique bol product ID |
specification |
A general term used to refer to specifications of a product such as height, width, warranty period and much more |
specificationGroups |
At bol we group together specifications to make them understandable, i.e. Dimensions, Support, Allergy Information |
condition |
As bol facilitates selling second hand items we also provide condition to let user’s know what condition a product is in |
minDeliveryDate |
The minimal/the soonest expected delivery date |
maxDeliveryDate |
The maximum/the latest expected delivery date |
ultimateOrderTime |
The latest time of day at which the product can be ordered to ensure it can be delivered before the maximum expected delivery time (maxDeliveryDate) |
deliveryDescription |
A description of the delivery proposition, e.g. "Op voorraad. Voor 23:59 besteld, morgen in huis" |
releaseDate |
The date on which the product will be released |
seller name |
The customer facing name of a bol seller |
renditions |
The different sizes of an image available |
imageRendition |
A specific sized image |
category |
The category assigned to a product on bol |
Externally Defined Terms
These are terms found in our API which originate from externally defined standards.
Term |
Meaning |
ean |
The European Article Number, a 13 digit unique number identifying the product |
mimeType |
The mime type of the image, for example "image/jpeg" |
gpc |
The Global Product Classification, a universal set of standards for everything from a car to a litre of milk, and for everything from camping equipment to footwear, home and appliances to toys |
A product’s GPC is set by GS1 and is used to calculate an affiliate’s commission on a product. This commission is calculated based on the GPC Chunk which is a more fine grained level added by bol beneath the GPC Brick level. For completeness, the GPC can be seen as a tree structure with 5 levels: Segment, Family, Class, Brick and (our) Chunk.
|
| Although the GPC can be regarded as way to classify/categorise products, it is a different concept than the bol Product Category (see bol specific terms). A product can belong to multiple (unrelated) categories; e.g. a walking shoe belongs to outdoor gear but also to fashion. |