Comissions (Beta)

Post commissions by EAN in bulk: Analyzes a list of products by their EANs, returning commission rates for successfully identified products and reasons for failures in other cases.

This endpoint has been deprecated as of the 1st of March 2026. For more information, see our post on the bol Developers portal.

Detailed Functionality and Response Structure

  • Processing Product EANs: Upon receiving a request, the endpoint parses through an array of products, each tagged with an EAN. It then attempts to extract commission data corresponding to each EAN.

  • Handling Successful Queries: For EANs that are successfully processed, the endpoint returns a wealth of commission information. This includes:

  • Date Range: Identifying the period for which the commission rates are applicable.

  • Product Condition: Differentiating between new and second-hand items.

  • Commission Rates for Price Ranges: Providing a detailed breakdown of how commission varies across different selling prices.

  • Addressing Failed Queries: In instances where the endpoint is unable to process a query, it specifies the reason for failure. Common issues could include an invalid EAN format or the absence of a product corresponding to the given EAN in the database.

Please keep in mind that the array of objects (EAN) can only include up to 100 items at a time. This limit helps ensure that we don’t overload the service capacity.

Commission Rate Dimensions

  • Multi-Dimensional Rate Structure: The commission rates are meticulously categorized, encompassing:

  • Date Range: Extending from today (inclusive) to at least tomorrow (exclusive).

  • Product Category: Distinguishing between new and second-hand products.

  • Price Range: Covering various price brackets, with different commission rates applicable to each.

Commission Calculation Methodology and VAT Considerations

  • Commission Calculation Formula: The endpoint employs the formula CommissionExclusiveVAT = FixedFee + (UnitPriceInclusiveVAT * Percentage) to calculate commissions, taking into account both a fixed fee and a percentage of the unit price (inclusive of VAT).

  • Impact of Discounts on Commission: When discounts are applicable, the fixed fee might be rendered negative. Should this lead to a negative commission total, the amount is adjusted to zero.

  • Clarity on VAT Inclusion/Exclusion: All monetary fields in the response are marked to indicate whether VAT is included or excluded. Notably, the unit price includes VAT, differing from other monetary fields.

Operational Usage

  • Efficient Data Retrieval: The endpoint’s design allows retailers to gain all the necessary data for setting product prices with a single daily request per EAN, streamlining the pricing process.

  • Comprehensive Commission Insights: By offering a structured and detailed presentation of commission data, the endpoint provides a holistic view of potential earnings and costs.

  • Ease of Use and Practicality: Operating synchronously, the endpoint ensures immediate and clear responses for each query. A valid Partner account is the primary prerequisite for access, ensuring a secure and authorized use.