Customer Offer

Guidance

These steps allow you to synchronize the Customer offers created for a supplier organization to the supplier application.

Start by retrieving the maximum sequence number found in Customer Offers using the GetCustomerOffersMaxSequence endpoint.

Next, retrieve changed Customer Offers since last sequence number using the GetSupplyLinesBySequenceNumber endpoint. Repeat this step until all Customer Offers are synchronised.

Guidance

These steps allow you to add new Customer Offer Lines to an existing Customer Offer.

Customer Offer Lines can be added using the AddCustomerOfferLine endpoint and requires a customerOfferId. The endpoint contains the following properties. Properties that may require further explanation are listed below.

📘

Customer Offer Lines added to Customer Offers may have different Order and Delivery periods.

📘

For the mandatory properties, please consult the Model on the Swagger page.

{
  "customerOfferLineId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "tradeItemId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "despatchWarehouseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "numberOfPieces": 2147483647,
  "pricePerPiece": {
    "currency": "EUR",
    "value": 10000000000000000
  },
  "volumePrices": [
    {
      "unit": "LAYER",
      "pricePerPiece": 9999999
    }
  ],
  "salesUnit": "PACKAGE",
  "orderPeriod": {
    "startDateTime": "2025-06-25T07:04:10.655Z",
    "endDateTime": "2025-06-25T07:04:10.655Z"
  },
  "deliveryPeriod": {
    "startDateTime": "2025-06-25T07:04:10.655Z",
    "endDateTime": "2025-06-25T07:04:10.655Z"
  },
  "usesCatalogAvailability": true,
  "batchId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "packingConfiguration": {
    "piecesPerPackage": 9999,
    "vbnPackageCode": 999,
    "customPackageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "packagesPerLayer": 9999,
    "layersPerLoadCarrier": 9999,
    "loadCarrier": "NONE",
    "photoUrl": "string"
  },
  "includedServices": [
    "DELIVERY"
  ]
}

• volumePrices: This property may be used to set a quantity discount by adding a price per volume. By default, the price per piece must be filled. The property volumePrices is optional and allows supplier organizations to add a seperate price per Layer or per Load Carrier to their Customer Offer lines. Once a customer organization orders the amount required for a Layer/Load Carrier, the price per piece for the Customer Offer line changes accordingly.
  • Take note that a volumePrice only affects the corresponding Customer Offer line. For instance, a Customer Offer consists of two Customer Offer lines and both have a lower volumePrice when a layer is ordered. When a customer organization orders a layer of the first Customer Offer line, the price per piece of the second Customer Offer line is not adjusted. A layer of the second Customer Offer line must be ordered for the volumePrice of that line to take effect.
• salesUnit: This limits the customer organization to only being able to place order in set amounts defined by the salesUnit, such as by Layer, by Load carrier, by entire Supply line.
• usesCatalogAvailability: Sets the method of availability for the Customer offer.
  • true: The availability of Customer Offer lines is based on the availability of the trade items used in Catalog supply. This feature was created to allow supplier organizations to easily manage the availability of their Direct supply by only having to toggle the availability of their Catalog Supply lines.
  • false: The availability of Customer Offer lines in the Customer Offer is linked directly to the amount specified in the Customer Offer line. This amount counts down, meaning a Customer Offer line with 0 of a salesUnit is considered sold out.
• includedServices:
  • Set DELIVERY if Transport and Delivery costs should not be settled for sales orders placed on the Customer Offer.
  • Set STICKERING if sticker costs should not be settled for sales orders placed on the Customer Offer.

Guidance

These steps allow you to update the number of pieces of a Customer Offer Line.

The number of pieces of a Customer Offer Line can be updated using the SetNumberOfPiecesOfCustomerOfferLine endpoint and requires a customerOfferId and a customerOfferLineId. The updated number of pieces must be added to the body of the request.