v10 - Commissions - Demo Endpoints

Get a list of commissions for EAN 8712626055150

POST /retailer-demo/commissions

Request
Response

Accept: application/vnd.retailer.v10+json
Content-Type: application/vnd.retailer.v10+json
Authorization: Bearer token (omitted)

{
  "products" : [ {
    "ean" : "8712626055150"
  }, {
    "ean" : "4549526287360"
  }, {
    "ean" : "871262605514-"
  } ]
}

Content-Type: application/vnd.retailer.v10+json

Status: 207 MULTI_STATUS

{
  "successfulQueries" : [ {
    "index" : 0,
    "status" : 200,
    "commissionRates" : [ {
      "ean" : "8712626055150",
      "dateRanges" : [ {
        "startDate" : "2023-11-28",
        "endDate" : "2023-11-29",
        "rates" : [ {
          "condition" : "NEW",
          "priceRanges" : [ {
            "range" : {
              "lower" : 0.0,
              "upper" : 10.0
            },
            "fixedAmount" : 0.2,
            "percentage" : 12.396694,
            "reductionApplied" : false
          }, {
            "range" : {
              "lower" : 10.0,
              "upper" : 20.0
            },
            "fixedAmount" : 0.4,
            "percentage" : 12.396694,
            "reductionApplied" : false
          }, {
            "range" : {
              "lower" : 20.0,
              "upper" : 20.0
            },
            "fixedAmount" : 0.85,
            "percentage" : 12.396694,
            "reductionApplied" : false
          } ]
        }, {
          "condition" : "SECONDHAND",
          "priceRanges" : [ {
            "range" : {
              "lower" : 0.0,
              "upper" : 10.0
            },
            "fixedAmount" : 0.2,
            "percentage" : 12.396694,
            "reductionApplied" : false
          }, {
            "range" : {
              "lower" : 10.0,
              "upper" : 20.0
            },
            "fixedAmount" : 0.4,
            "percentage" : 12.396694,
            "reductionApplied" : false
          }, {
            "range" : {
              "lower" : 20.0,
              "upper" : 20.0
            },
            "fixedAmount" : 0.85,
            "percentage" : 12.396694,
            "reductionApplied" : false
          } ]
        } ]
      } ]
    } ]
  } ],
  "failedQueries" : [ {
    "index" : 1,
    "status" : 404,
    "violations" : [ {
      "name" : "ean",
      "reason" : "Product related to the ean 4549526287360 could not be found."
    } ]
  }, {
    "index" : 2,
    "status" : 400,
    "violations" : [ {
      "name" : "ean",
      "reason" : "Invalid EAN: 871262605514-. Must be a 13-digit number"
    } ]
  } ]
}

Retrieve commission information for a single EAN 8712626055143

Retrieves commission information on a specific EAN, in this case 8712626055143.

GET /retailer-demo/commission/8712626055143?condition=GOOD&unit-price=24.50

Request
Response

Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "ean" : "8712626055143",
  "condition" : "GOOD",
  "unitPrice" : 24.5,
  "fixedAmount" : 0.99,
  "percentage" : 15,
  "totalCost" : 4.67
}

Retrieve commission information for a single EAN 0604020064587

Retrieves commission information on a specific EAN, in this case 0604020064587.

GET /retailer-demo/commission/0604020064587?condition=NEW&unit-price=24.95

Request
Response

Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "ean" : "0604020064587",
  "condition" : "NEW",
  "unitPrice" : 24.95,
  "fixedAmount" : 0.99,
  "percentage" : 15,
  "totalCost" : 4.73
}

Retrieve commission information for a single EAN 8718526069334 with reductions

Retrieves commission information on a specific EAN, in this case 8718526069334. This article is also viable for a reduction in commission if a certain pricepoint is met.

GET /retailer-demo/commission/8718526069334?condition=NEW&unit-price=25.00

Request
Response

Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "ean" : "8718526069334",
  "condition" : "NEW",
  "unitPrice" : 25.0,
  "fixedAmount" : 0.99,
  "percentage" : 15,
  "totalCost" : 3.82,
  "totalCostWithoutReduction" : 4.74,
  "reductions" : [ {
    "maximumPrice" : 25.99,
    "costReduction" : 0.92,
    "startDate" : "2018-04-25",
    "endDate" : "2018-05-15"
  } ]
}

Retrieve commission information for a single EAN 8804269223123

Retrieves commission information on a specific EAN, in this case 8804269223123.

GET /retailer-demo/commission/8804269223123?condition=NEW&unit-price=699.95

Request
Response

Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)

This endpoint has no request body.

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "ean" : "8804269223123",
  "condition" : "NEW",
  "unitPrice" : 699.95,
  "fixedAmount" : 0.99,
  "percentage" : 16,
  "totalCost" : 112.99
}

Retrieve commission information on multiple EAN’s

In addition to the GET Commission request which returns commission information for a single EAN, it is also possibly to send us a query with multiple EANs with a maximum of 100 EANs. The demo environment contains commission information for the following EAN’s: 8712626055150, 8804269223123, 8712626055143, 8718526069334, 0604020064587.

POST /retailer-demo/commission

Request
Response

Accept: application/vnd.retailer.v10+json
Content-Type: application/vnd.retailer.v10+json
Authorization: Bearer token (omitted)

{
  "commissionQueries" : [ {
    "ean" : "8712626055150",
    "condition" : "NEW",
    "unitPrice" : "34.99"
  }, {
    "ean" : "8804269223123",
    "condition" : "NEW",
    "unitPrice" : "699.95"
  }, {
    "ean" : "8712626055143",
    "condition" : "GOOD",
    "unitPrice" : "24.50"
  }, {
    "ean" : "0604020064587",
    "condition" : "NEW",
    "unitPrice" : "24.95"
  }, {
    "ean" : "8718526069334",
    "condition" : "NEW",
    "unitPrice" : "25.00"
  } ]
}

Content-Type: application/vnd.retailer.v10+json

Status: 200 OK

{
  "commissions" : [ {
    "ean" : "8712626055150",
    "condition" : "NEW",
    "unitPrice" : 34.99,
    "fixedAmount" : 0.99,
    "percentage" : 15,
    "totalCost" : 6.24
  }, {
    "ean" : "8804269223123",
    "condition" : "NEW",
    "unitPrice" : 699.95,
    "fixedAmount" : 0.99,
    "percentage" : 16,
    "totalCost" : 112.99
  }, {
    "ean" : "8712626055143",
    "condition" : "GOOD",
    "unitPrice" : 24.5,
    "fixedAmount" : 0.99,
    "percentage" : 15,
    "totalCost" : 4.67
  }, {
    "ean" : "0604020064587",
    "condition" : "NEW",
    "unitPrice" : 24.95,
    "fixedAmount" : 0.99,
    "percentage" : 15,
    "totalCost" : 4.73
  }, {
    "ean" : "8718526069334",
    "condition" : "NEW",
    "unitPrice" : 25.0,
    "fixedAmount" : 0.99,
    "percentage" : 15,
    "totalCost" : 3.82,
    "totalCostWithoutReduction" : 4.74,
    "reductions" : [ {
      "maximumPrice" : 25.99,
      "costReduction" : 0.92,
      "startDate" : "2018-04-25",
      "endDate" : "2018-05-15"
    } ]
  } ]
}