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.

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.