General
At the start of the send products method the validator is called to validate the presense of the EAN, unitPrice, condition.name, condition.category fields as those are required to be able to process the product. If one of the required fields is not present in the data an exception is thrown with a message about which field is missing in the mapping.
If the validation has passed and after the file content retrieval process was completed the EAN or the reference of the product is looked up in the file content. When found the data will be prepared and a request to update an existing product is done else the data is further extended and checked and a request to create a new product is done. The response is handled by the Job processing and status updates process.
After a product was updated a new job will be dispatched to update the product price. In case the product is created the price is also allowed in the data.
Please note: IF the product has to be created the validator will be called again to validate if the EAN field is present as this is required when creating a product.
Please note: if a product with a variant is offered to the Bol.com application the variant data is copied to the product making the variant the main product before further processing the product.
Please be aware that due to the way BOL works only a very limited number of fields can be updated on a product. As this information is already present in the file content a check is done before doing an update request to see if any fields have actually changed and an update is desired. If no update is needed the customer will be informed through the activity logs. The fields that can be updated are:
Product types
Simple and configurable products are supported when this data is sent from the source application.
Attributes/Features
not supported
Categories
not supported
Images
not supported
Datamapper
Per default APIcenter supplies a mapping that makes sure you can send product data towards Bol.com. You can also make adjustments to this yourself.
Default fields that are mapped are for example:
- Name/Title
- SKU
- Long Description
- Short Description
- Price excl. tax or incl. tax
- Quantity
- EAN/GTIN
- Currency
More information about data mapping can be found here.