Functional documentation
Offer feature V2
How to manage your catalog
API product Feature
The offer feature allows you to manage your catalog. You will be able to :
- SUBMIT OFFERS with json (Not available for Cdiscount)
- SUBMIT OFFERS with xml
- GET OFFERS
What is an offer ?
In order to understand what “offer” means for Octopia you can read the help center documentation. You will find :
- The difference between product and offer
- How to create and update offers via API
- How to delete an offer (not with API)
- How to apply commercial operations (only Cdiscount)
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
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
Because this data may take time to update, severalupdatedAt
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
}