Commission rates

The commission rate lookup endpoint can be used to retrieve the current commission rate for up to 50 products in a single request, identified by EAN and storefront. It is intended for use when selling costs need to be estimated before pricing decisions are made, or when internal tooling around Kaufland commission data is being built.

The returned rate is referred to as an estimate because it reflects the rate configured at the time of the request. The commission actually charged is determined at invoice time and may differ.

Endpoint

HTTP method: POST
URL: https://sellerapi.kaufland.com/v2/info/commission-rates/lookup
Query parameter: storefront — the storefront to look up rates for (e.g. de)

Sample request

{
    "eans": [
        "4006381333931",
        "3607345809915",
        "0000000000000"
    ]
}

Sample response

{
    "data": [
        {
            "ean": "4006381333931",
            "status": "OK",
            "commission_rate_estimate": {
                "variable_fee": 7.0,
                "fixed_fee": 0
            }
        },
        {
            "ean": "3607345809915",
            "status": "NO_COMMISSION_RATE"
        },
        {
            "ean": "0000000000000",
            "status": "NOT_FOUND"
        }
    ]
}

The complete request and response schema, including all field types and validation rules, is available in the endpoint specification.

Status values

Each result entry indicates the outcome of the lookup via a status field:

Error responses

In addition to the standard 401 Unauthorized and 500 Internal Server Error responses, the following error may be returned:

• 400 Bad Request — the request body is invalid or the eans array contains more than 50 entries.