Functional documentation

Offer feature V2

How to manage your catalog

API product Feature

  • SUBMIT OFFERS with json (Not available for Cdiscount)
  • SUBMIT OFFERS with xml 
  • GET OFFERS

Endpoint

What is an offer ?

  1. The difference between product and offer
  2. How to create and update offers via API
  3. How to delete an offer (not with API)
  4. How to apply commercial operations (only Cdiscount)

Help center documentation

How to Get Offers information ?

There are currently two endpoints to get the offer information of your catalogue. 

  • POST Offer Search (will be deprecated)
  • GET Offers (new endpoint)

POST offer search 

This endpoint must not used anymore. We advise you to use the Get/offers.

GET Offers 

This is the new endpoint for all sales channels with a maximum of information on offers from our referentials and from the sales channel feedbacks.

! NEW – Released June 2025 !

salesChannelFeedback Information:

This new object available by using expand parameters on Cdiscount gives very usefull data like:

On line offers: get the real visibility status of offers. Indeed, the sales channel can decide to do not show offers on various criterias. Now, the get offers retrieves this status directly from the sales channel.

Best offer: Which offer has the best offer on the sales channel and with which price.

Offer Quality: also known as “Qualiscrore” on Cdiscount. This object gives you the score and the reason of score on offers.

Competing offers: If other offers are in competition with yours, you can get the data about the competitors in order to adjust your price strategy.

Seller and product information: get the seller and product ratings on offers.

Functional rules:

There are some differences in the attributes you can retrieve from Cdiscount (CDISFR) compared with other channels

  • Attributes only available on Cdiscount:
    • comments
    • offerCompetition
    • Best offer information into salesChannelFeedback.bestOfferDetails
    • expand parameter with salesChannelFeedback value
    • Qualiscore : more details on offerQuality.scoreReasons into the FAQ
  • Attributes only available on other sales channels:
    • salesChannelAcceptanceStatus
    • deliveryOffers.storageCountry
    • Best offer information into isBestOffer & BestOffer

New features:

  • Fields parameter : The fields parameter let you fetch only the data you need.The payload will always contain basis information as:
    • offerIdsellerExternalReferenceofferStatecreatedAtupdatedAt
    To retrieve only the useful information, specify the field (e.g., condition) or the node name (e.g., salesChannelFeedback) or the node name with the field name separated by a dot (e.g., facialPrice.price).
  • Expand parameter (Cdiscount Only):To include sales-channel feedback information, set the expand parameter to:
    • salesChannelFeedback
    This node contains information returned by the sales channels’ APIs.
    Because this data may take time to update, several updatedAt fields are provided.

Example of payload returned using expand paramteters:

{
  "items": [
    {
      "sellerId": 1234,
      "sellerExternalReference": "REF001",
      "condition": "New",
      "salesChannelId": "CDISFR",
      "offerId": "1234_TES3499550358636_6_CDISFR",
      "offerState": "Active",
      "createdAt": "2025-04-26T01:28:53.0000000+00:00",
      "updatedAt": "2025-05-31T02:37:26.0000000+00:00",
      "product": {
        "reference": "TES3499550358636",
        "gtin": "3499550358636"
      },
      "integrationPrice": {
        "price": 19.9,
        "currencyCode": "EUR",
        "originPrice": 29.9,
        "taxes": [
          {
            "value": 0,
            "code": "deaTax",
            "type": "Amount"
          },
          {
            "value": 0,
            "code": "ecoTax",
            "type": "Amount"
          },
          {
            "value": 0.2,
            "code": "vat",
            "type": "Rate"
          },
          {
            "value": 0,
            "code": "privateCopy",
            "type": "Amount"
          }
        ]
      },
      "facialPrice": {
        "price": 19.9,
        "currencyCode": "EUR",
        "originPrice": 29.9,
        "taxes": [
          {
            "value": 0,
            "code": "deaTax",
            "type": "Amount"
          },
          {
            "value": 0,
            "code": "ecoTax",
            "type": "Amount"
          },
          {
            "value": 0.2,
            "code": "vat",
            "type": "Rate"
          },
          {
            "value": 0,
            "code": "privateCopy",
            "type": "Amount"
          }
        ]
      },
      "deliveryOffers": [
        {
          "preparationTime": 2,
          "supplyMode": "Seller",
          "quantity": 10,
          "isBestDelivery": true,
          "deliveryModes": [
            {
              "code": "None",
              "legacyDeliveryModeId": "Tracked",
              "minDeliveryTime": 2,
              "maxDeliveryTime": 4,
              "cost": 0,
              "additionalCost": 0
            },
            {
              "code": "None",
              "legacyDeliveryModeId": "Registered",
              "minDeliveryTime": 2,
              "maxDeliveryTime": 4,
              "cost": 1,
              "additionalCost": 1
            }
          ]
        }
      ],
      "comments": "This is a comment on the offer.",
      "offerCompetition": {
        "isActivated": true,
        "minimumPrice": 10.56
      },
      "salesChannelFeedback": {
        "isOnline": true,
        "displayedOfferPrice": 19.9,
        "deliveryCost": 0,
        "updatedAt": "2025-03-07T16:11:30Z",
        "bestOfferDetails": {
          "isBestOffer": true,
          "isBestOfferUpdatedAt": "2025-03-07T16:11:30Z",
          "bestOffer": {
            "price": 19.9,
            "deliveryCost": null,
            "updatedAt": "2025-03-07T16:11:30Z"
          }
        },
        "productInformation": {
          "productPageUrl": "url",
          "productReviewsCount": 127,
          "productReviewsAverageRating": 4.3,
          "offersCount": 2,
          "updatedAt": "2025-03-07T16:11:30Z"
        },
        "offlineReason": {
          "reason": null,
          "updatedAt": "2025-03-07T16:11:30Z"
        },
        "sellerGrade": {
          "sellerRating": 2,
          "selerReviewsCount": 12,
          "updatedAt": "2025-03-07T16:11:30Z"
        },
        "offerQuality": {
          "offerScore": "E",
          "scoreReasons": [
            {
              "code": "longDeliverytime",
              "reason": "Délais de livraison longs"
            }
          ],
          "updatedAt": "2025-03-07T16:11:30Z"
        },
        "loyaltyInformation": {
          "isPartOfLoyaltyProgram": true,
          "loyaltyProgramNames": [
            "CDAV"
          ],
          "updatedAt": "2025-03-07T16:11:30Z"
        },
        "promotionInformation": {
          "isPromotion": true,
          "promotionLabels": [
            "BackToSchool"
          ],
          "updatedAt": "2025-03-07T16:11:30Z"
        },
        "competingOffers": [
          {
            "sellerName": "TestSellerName",
            "sellerRating": 4.5,
            "sellerReviewsCount": null,
            "salesChannelExternalReference": "xxx",
            "isOnline": true,
            "isBestOffer": false,
            "displayedOfferPrice": 33.99,
            "deliveryCost": 0,
            "updatedAt": "2025-03-07T16:11:30Z",
            "loyaltyInformation": {
              "isPartOfLoyaltyProgram": true,
              "loyaltyProgramNames": [
                "CDAV"
              ],
              "updatedAt": "2025-03-07T16:11:30Z"
            },
            "promotionInformation": {
              "isPromotion": true,
              "promotionLabels": [
                "BackToSchool"
              ],
              "updatedAt": "2025-03-07T16:11:30Z"
            }
          }
        ]
      }
    }
  ],
  "itemsPerPage": 1
}

Scroll to Top