General
You can determine what type of orders you want to retrieve, Fullfillment by Bol(FBB), Fullfillment by retailer(FBR) or both. You can also add different warehouses to these ordertypes. Retrieval of orders from Bol.com uses the generic method to retrieve orders based on the modify date. First APIcenter checks by ordernumber if the order already exists if it exists we skip the order. If it does not exists APIcenter checks if the customer exists by customer email address and depending on the outcome create or update the customer. APIcenter checks if all products exist by EAN and then the order is committed.
Ordertypes
We create per default a order. More information about different order types can be found here.
Important settings
- Amount to process
The amount of orders we try and sync at once. Always check if the target system can handle the amount of data.
- Specify the Date from which you want to retrieve Orders
Determines the date from which orders are retrieved based on the modify date.
- Fullfillment type settings
Bol.com knows 2 different fulfilment methods.
- Fulfilment By Reseller (FBR)
- Fulfilment By Bol (FBB)
For each method you can set the date, order status and warehouse code.
Datamapper
Per default APIcenter supplies a mapping that makes sure you can send orders towards the target application. You can also make adjustments to this yourself.
Default fields that are mapped are for example:
- Customer Name
- Billing address street
- Number
- Postalcode
- City
- Country
- Shipping address street
- Number
- Postalcode
- City
- Country
- SKU/EAN
- Quantity
- Price
More information about data mapping can be found here.
Settings used
Besides the settings used for most getflows the following setting are applicable for the getSalesOrder:
| Setting | Type | Function/Effect |
|---|---|---|
| use_default_warehouse_retailer | flow | Warehouse code to be used in case of FBR orders |
| use_default_warehouse_marketplace | flow | Warehouse code to be used in case of FBB orders |
| use_get_items_retailer_status | flow | for setting the order type to retrieve (ALL or OPEN) for FBR orders |
| use_get_items_marketplace_status | flow | for setting the order type to retrieve (ALL or OPEN) for FBB orders |
Endpoints used
The following endpoints are needed to complete the getSalesOrder flow:
| Endpoint | Method | Definition |
|---|---|---|
| getSalesOrders | GET | /orders?page={page}{filter} |
| getSalesOrder | GET | /orders/{orderId} |