Bol.com Retailer icon

Bol.com Retailer

Interact with Bol.com Retailer API

Actions3

Overview

This node interacts with the Bol.com Retailer API to manage orders. Specifically, the "Get All Orders" operation retrieves a paginated list of orders filtered by fulfilment method and status. This is useful for retailers who want to programmatically access their order data from Bol.com, enabling automation of order processing, reporting, or integration with other systems.

Practical examples:

  • Fetching all open orders fulfilled by the retailer to prepare shipments.
  • Retrieving shipped or delivered orders for reconciliation or customer service follow-up.
  • Automating periodic downloads of order lists for inventory or accounting purposes.

Properties

Name Meaning
Page The page number of the orders list to retrieve (pagination). Defaults to 1.
Fulfilment Method Filter orders by fulfilment method. Options:
- FBR (Fulfilled by Retailer)
- FBB (Fulfilled by Bol)
Status Filter orders by status. Options:
- All (no filter)
- Open
- Shipped
- Delivered
- Cancelled

Output

The output is an array of JSON objects representing orders retrieved from the Bol.com Retailer API. Each item corresponds to one order's data as returned by the API.

  • The json field contains the full order details.
  • If multiple orders are returned, each is output as a separate item in the array.
  • No binary data is output by this operation.

Dependencies

  • Requires an API authentication token configured via OAuth2 credentials for the Bol.com Retailer API.
  • The node makes HTTP GET requests to the endpoint /retailer/orders on the base URL https://api.bol.com.
  • Query parameters include pagination (page), fulfilment method, and status filters.

Troubleshooting

  • Common issues:

    • Invalid or expired API authentication token will cause authentication errors.
    • Requesting a page number beyond available pages may return empty results.
    • Using unsupported status or fulfilment method values will result in API errors.

  • Error messages:

    • Authentication failures typically indicate problems with the OAuth2 credential setup; re-authenticate or update credentials.
    • API errors related to invalid query parameters suggest checking the property values for correctness.
    • Network or connectivity errors require verifying internet access and API availability.

Links and References

Discussion