Features V2

Offer feature V2

How to manage your catalog

Please notice : this API is for Octopia sales channel only. You can not use it to manage offers on Cdiscount.

API offer Feature

The offer allows you to manage your catalog. With the offer feature, you will be able to :

  • retrieve the offer information of your catalog. 

Endpoint

What is an offer ?

In order to understand what "offer" means for Octopia you can read the help center documentation. You will find :

  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

Some definition

Glossary :

Offer: The offer data concern:

  • Stock

  • Price

  • Taxes

  • Product condition

  • Delivery information (Mode ; Cost ; Time)

  • Status (Active ; Inactive)

An offer is active if and only if ALL the above information are submitted by the seller.

Sales channel : Octopia allows to sell and manage offers on several marketplaces.

Currently, on the offer feature, there are differences of working between Cdiscount and other marketplaces of octopia.

SalesChannelid : This id is used to identify the targeted sales channel. It allows the seller to publish offer information on a specific sales channel.

OfferPoolId : this is a legacy id for the sales channel. It will be deprecated with the SOAP API. Octopia advise to use the sales channel id.

Submit offers : The seller can publish and/or modify the offer information through API’s.

Get offers : The seller can retrieve all the offer information from its catalog

Get offers

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 

It is a POST endpoint for legacy technical reason but it should not be. 

GET Offers 

This is the new endpoint for Octopia and Cdiscount 

Here is an overview of the attributes available in the Get Offers : 

Endpoints

Search offers by criteria
GET /offers

Response attributes : offer id ; offer state ; seller product id ; product EAN ; price ; stock ; shipping information ...

Recommandations call frequency : Every time you need