List recent orders from bol.com. Returns orders with their items, shipping details, and status. Use the fulfilmentMethod filter to show only FBR (fulfilled by retailer), FBB (fulfilled by bol.com), or ALL orders. Use the status filter to show OPEN (awaiting shipment/cancellation), SHIPPED, or ALL orders.

Get detailed information about a specific order including order items, shipping details, billing details, and fulfilment status.

Cancel an order item by order item ID. Can be used to confirm a customer cancellation request or to cancel an item you cannot fulfil. Returns a process status — the cancellation is processed asynchronously. Always review the order with get_order before cancelling.

Get detailed information about a specific offer including EAN, pricing, stock, fulfilment method, and condition.

Create a new offer on bol.com. Requires EAN, condition, pricing (at least one bundle price with quantity 1), stock, and fulfilment method. Returns a process status — the offer is created asynchronously. Use get_process_status to check completion.

Update an existing offer's reference, on-hold status, product title, or fulfilment settings. To update pricing or stock, use update_offer_price or update_offer_stock instead. Returns a process status — changes are applied asynchronously.

Delete an offer from bol.com. This permanently removes the offer — it cannot be undone. Always confirm with the user before calling this tool.

Update the pricing for an existing offer. Provide bundle prices with at least one entry for quantity 1. Returns a process status — changes are applied asynchronously.

Update the stock level for an existing offer. Returns a process status — changes are applied asynchronously.

Request an offer export file containing all offers. Returns a process status — use get_process_status to get the report ID, then retrieve with get_offer_export.

Retrieve an offer export file by report ID. The report ID is obtained from the process status after requesting an export.

Request a report of all unpublished offers and reasons. Returns a process status — use get_process_status to get the report ID, then retrieve with get_unpublished_offer_report.

Retrieve an unpublished offer report by report ID. Contains all unpublished offers and reasons.

List shipments from bol.com. Optionally filter by order ID to see shipments for a specific order.

Get detailed information about a specific shipment including items, transport/tracking info, and shipping details.

Create a shipment for one or more order items. You must provide the order item IDs and optionally transport details (transporter code and track & trace). Returns a process status — the shipment is created asynchronously. Use get_process_status to check completion. Always verify the order item IDs with get_order before creating a shipment.

Get a list of invoice requests initiated by customers for shipments. Filter by shipment ID or state (OPEN, UPLOAD_ERROR, ALL).

Upload an invoice for a specific shipment. Provide the shipment ID and the invoice content. Returns a process status — the upload is processed asynchronously.

List returns from bol.com. Filter by handled status and fulfilment method. Unhandled returns require action — use handle_return to process them.

Get detailed information about a specific return including return items, reasons, tracking, and processing results.

Handle/process a return item by its RMA ID. The RMA ID can be found in the return items from get_return. Set the handling result and quantity returned. Valid handling results: RETURN_RECEIVED, EXCHANGE_PRODUCT, RETURN_DOES_NOT_MEET_CONDITIONS, REPAIR_PRODUCT, CUSTOMER_KEEPS_PRODUCT_PAID, STILL_APPROVED. Returns a process status — the return is handled asynchronously. Always review the return details with get_return before handling.

Create a return and automatically handle it with the provided handling result. When successfully created, the resulting return ID is provided in the process status. Returns a process status — the return is created asynchronously.

List invoices from bol.com. Optionally filter by date range using period start and end dates (format: YYYY-MM-DD). The date range must not exceed 31 days.

Get detailed information about a specific invoice.

Get an invoice specification with a paginated list of its transactions. The specification contains detailed line items for the invoice.

Get the commission for a product based on EAN, condition, and unit price. Returns the fixed amount, percentage, total cost, and any active reductions.

Get commissions and possible reductions for multiple products in bulk. Provide EAN, unit price, and optionally condition for each product.

Get a list of all commission rates by EAN. Returns commission rate tables with price ranges and conditions. This is a BETA endpoint.

Get the status of an asynchronous process by its process status ID. All PUT/POST/DELETE requests return a process status ID that can be used here to check completion.

Get the status of asynchronous processes by entity ID and event type. The entity ID can be an order item ID, transport ID, return number, replenishment ID, etc. Results are returned in descending order.

Get the status of multiple asynchronous processes by their process status IDs. Up to 1000 IDs can be queried in a single request.

Get the list of product categories available on bol.com. Returns categories with their IDs and names.

Search or browse products on bol.com by category or search term. Returns a list of products with EAN and title.

Get the available filters for browsing or searching products on bol.com.

Get product assets (images) for a product by EAN. Optionally filter by usage type.

Get competing offers for a product by EAN. Shows offer details including pricing, condition, and seller information.

Get product placement information for a product by EAN.

Get the price star boundaries for a product by EAN. Shows the price ranges that correspond to different star ratings.

Get the product identifiers for a product by EAN. Returns various IDs associated with the product.

Get ratings and reviews summary for a product by EAN. Shows the average rating and total number of reviews.

Get catalog product details by EAN, including product attributes, titles, and other catalog information.

Create or update product content for a given EAN. Provide product attributes such as title, description, brand, etc. Returns a process status — the content is created asynchronously. Use get_process_status to check completion.

Get a product content upload report by upload ID. Shows the status and any validation errors for a content upload.

Get product content recommendations (chunk recommendations) for a given EAN. Provides suggestions for improving product content.

Get offer visit and buy box insights for a specific offer. Returns data like product visits or buy box percentage over the specified time period.

Get retailer performance indicators for a specific week. Returns scores and details for metrics like cancellations, fulfilment, phone availability, etc.

Get product search and browse ranking data for a specific EAN on a given date. Shows how a product ranks in search results and category browsing.

Get sales forecast for a specific offer. Returns predicted sales volume for the specified number of weeks ahead (1-12).

Get search term volume data from bol.com. Returns how often a search term is used over the specified time period, optionally including related search terms.

Get LVB/FBB inventory list from bol.com. Returns inventory items with EAN, title, regular stock, and graded stock. Filter by quantity range, stock level, state, or search by EAN/product title.

List available promotions on bol.com. Filter by promotion type: AWARENESS (visibility promotions) or PRICE_OFF (discount promotions).

Get detailed information about a specific promotion including its type, dates, and conditions.

Get the list of products participating in a specific promotion.

List FBB (Fulfilled by bol.com) replenishments. Optionally filter by reference, EAN, date range, or state.

Get detailed information about a specific FBB replenishment including lines, state, delivery info, and load carriers.

Create a new FBB (Fulfilled by bol.com) replenishment. Provide a reference, delivery date, and lines with EAN and quantity. Returns a process status — the replenishment is created asynchronously. Use get_process_status to check completion.

Update a replenishment, for example to cancel it or update delivery info and load carriers. Returns a process status — changes are applied asynchronously.

Get available delivery dates for FBB (Fulfilled by bol.com) replenishments.

Get available pickup time slots for a given address and number of load carriers.

Request product warehouse destinations for the given EANs. Returns a process status — use the product destinations ID to retrieve results with get_product_destinations.

Get product warehouse destinations by product destinations ID. Use after requesting destinations with request_product_destinations.

Get load carrier labels for a replenishment. Returns label data (PDF).

Get the pick list for a replenishment. Returns pick list data (PDF).

Request product labels for FBB products. Returns label data (PDF). Specify the label format and products with EAN and quantity.

Get retailer information. Provide a retailer ID to look up a specific retailer, or omit it to get your own account information.

Get available delivery and shipping options for one or more order items. Shows available shipping methods with prices. Use the shippingLabelOfferId from the results when creating a shipping label.

Create a shipping label for one or more order items. Requires a shippingLabelOfferId from get_delivery_options. Returns a process status — the label is created asynchronously. Use get_process_status to check completion.

Download a shipping label by its ID. Returns the label data (PDF).

List all event subscriptions. Shows configured webhooks, GCP Pub/Sub, and AWS SQS subscriptions.

Get detailed information about a specific event subscription.

Create a new event subscription. Subscribe to events like PROCESS_STATUS, SHIPMENT, PRICE_STAR_BOUNDARY, COMPETING_OFFER, OFFER_FOR_SALE, OFFER_NOT_FOR_SALE. Supports WEBHOOK, GCP_PUBSUB, and AWS_SQS subscription types.

Update an existing event subscription. You can change the resources, URL, type, enabled status, and identity.

Delete an event subscription. This permanently removes the subscription — it cannot be undone. Always confirm with the user before calling this tool.

Send a test notification to a subscription endpoint. Use this to verify that your subscription is correctly configured.

Get the public keys used for webhook signature validation. Use these to verify that incoming webhook notifications are from bol.com.

Update transport/tracking information for a shipment. Provide a track and trace code and optionally a transporter code. Returns a process status — the update is applied asynchronously. Use get_process_status to check completion.