The following applies only to JSON properties of offers in offer requests uploads in an offer requests package through the Offer Managament JSON API endpoint.
Fields descriptions
SellerExternalReference
|
FIELD DESCRIPTION |
This reference is the identifier that you give to your offers. |
|
EXPECTED FORMAT |
Alphanumeric |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
Between 1 and 50 characters |
|
CHARACTER |
Mandatory |
|
Business rules |
This field cannot be empty.Several offers on the same sales channel cannot have the same reference.Allowed special characters: “{ }”, “@”, “%”, “;”, “$”, “=”, “[]”, “/”, “,”, “-“, “()” , ” ‘ “, “\”, ” ” “, “&”, “!”, “#”, “^”, “#”, “?”, “_” , “+” , “:” , ” .” |
Product GTIN or EAN
product.gtin
|
FIELD DESCRIPTION |
Unique identification of the product in GTIN or EAN format. |
|
EXPECTED FORMAT |
Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
Between 8 and 14 characters on Octopia |
|
CHARACTER |
Mandatory for creation if the seller does not use the product reference used when creating the productOptional for creation if the seller uses the product reference used when creating the productOptional for modifying the offer |
|
Business rules |
Check the formatting of the 0s at the start of the cell, so that they appear correctly.The EAN must correspond to an existing product at Cdiscount or Octopia .( Octopia ) The product must be sellable |
Condition
|
FIELD DESCRIPTION |
The product condition allows to qualify the state of the product. To be chosen from the values in the limited list, depending on the condition of the product. |
|
|
EXPECTED FORMAT |
Bounded list |
|
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
|
|
|
CHARACTER |
Mandatory (not case sensitive) |
|
|
Business rules |
Please note, in the case of submission by excel matrix, the expected value of the list depends on the language in which the matrix was generated (Example: If generated in English, the value Neuf – Neuf will become New – New) |
|
|
Enum (productCondition) |
Wording |
|
|
|
Used – Like new |
|
|
|
Used – Very good state |
|
|
|
Used – Average state |
|
|
|
New – New |
|
|
|
Refurbished – Like new |
|
|
|
Refurbished – Very good state |
|
|
|
Refurbished – Good state |
|
Price
price.price
|
FIELD DESCRIPTION |
Price to be informed including tax, excluding shipping costs, including Eco share and DEA if applicable, expressed in €. |
|
EXPECTED FORMAT |
Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
10 characters before the decimal point, |
|
CHARACTER |
Mandatory |
|
Business rules |
The price must be greater than 0.00 (Currency).The price must be greater than the sum of the EcoTax and DeaTax fields.The price must be higher than the floor price.The price must be lower than the Origin (or Striked) price. |
OriginPrice
price.originPrice
|
FIELD DESCRIPTION |
Market price observed for the product. Also called Striked Price |
|
EXPECTED FORMAT |
Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
10 characters before the decimal point, |
|
CHARACTER |
Optional |
|
Business rules |
This price must be strictly greater than the Price field. |
Taxes
price.taxes
|
FIELD DESCRIPTION |
The list of the taxes applied on offers. For Update packages, the complete list of taxes must be expressed |
|
EXPECTED FORMAT |
Object |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
Array of taxes List of available taxes :
|
|
CHARACTER |
Mandatory |
|
Business rules |
The taxes object is mandatory Each objects in the array must have variables “code” and “value” and the associated values The Array can be empty if there is no taxes to apply on this sales channel |
Vat
price.taxes
|
FIELD DESCRIPTION |
VAT rate applicable to the product, expressed in % |
|
EXPECTED FORMAT |
code : String value : Digital (ex : 0.2 for 20% of VAT) |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
For the value :4 characters before comma, |
|
CHARACTER |
Mandatory |
|
Business rules |
The VAT field cannot be strictly greater than 100%.The sum of taxes must be strictly lower than the price and floor price |
EcoTax
price.taxes
|
FIELD DESCRIPTION |
Eco-participation applicable to new products. Even if the tax is not applicable to this product, you must fill the field with the value zero. |
|
EXPECTED FORMAT |
code : String value : Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
3 characters before comma, |
|
CHARACTER |
Mandatory |
|
Business rules |
The EcoTax field must be strictly less than 1000.The sum of taxes must be strictly lower than the price and floor price |
DeaTax
price.taxes
|
FIELD DESCRIPTION |
Eco-furnishing applicable to furnishing goods Even if the tax is not applicable to this product, you must fill in the field with the value zero. |
|
EXPECTED FORMAT |
code : Stringvalue : Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
4 characters before comma, |
|
CHARACTER |
Mandatory |
|
Business rules |
The DEA field must be strictly less than 1000.The sum of taxes must be strictly lower than the price and floor price |
Private Copy
price.taxes
|
FIELD DESCRIPTION |
French tax on information storage and the right to private copying |
|
EXPECTED FORMAT |
code : String value : Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
4 characters before comma, |
|
CHARACTER |
Optional |
|
Business rules |
The Private Copy field must be strictly lower than the price including tax.The sum of taxes must be strictly lower than the price and floor price |
Chemical Tax
price.taxes.code
|
FIELD DESCRIPTION |
Swedish chemical tax |
|
EXPECTED FORMAT |
code : String value : Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
4 characters before comma, |
|
CHARACTER |
Optional |
|
Business rules |
Tax field must be strictly lower than the tax-inclusive price.The sum of taxes must be strictly lower than the price and floor price |
Delivery Modes
deliveryModes
|
FIELD DESCRIPTION |
The list of delivery modes to be applied on offers. For Update packages, the complete list of delivery modes must be expressed |
|
EXPECTED FORMAT |
Object |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
Array of delivery modes code: String cost: Digital additionalCost: DigitalCombined with the preparationTime fieldExample:”deliveryModes”: [ |
|
CHARACTER |
Mandatory |
|
Business rules |
The Delivery Modes object is mandatory Each objects in the array must have variables “code” “cost” and “additionalCost” (optional) and the associated values |
Delivery modes code
deliveryModes.code
|
FIELD DESCRIPTION |
The delivery mode code is a list of available delivery modes that can be set for each offer. |
|
EXPECTED FORMAT |
string |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
|
|
CHARACTER |
MandatoryList of available delivery modes for Octopia sales channels |
|
Business rules |
The delivery mode availability depends on the configuration of the sales channels.If the delivery mode is not configured on the sales channel, an error will be thrown. The offer must have at least one configured delivery mode to be published |
See also : Octopia Delivery Modes
Delivery modes cost
deliveryModes.cost
|
FIELD DESCRIPTION |
Amount of delivery costs |
|
EXPECTED FORMAT |
Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
10 characters before the decimal point, |
|
CHARACTER |
Mandatory |
|
Business rules |
The delivery mode cost must be associated to a delivery mode code |
Delivery modes additional cost
deliveryModes.additionalCost
|
FIELD DESCRIPTION |
Amount of additional delivery costs paid for the 2nd item for customers. |
|
EXPECTED FORMAT |
Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
10 characters before the decimal point, |
|
CHARACTER |
Optional |
|
Business rules |
Additional costs cannot be strictly greater than 30 euros.If the field is not filled by the seller, 0 is automatically filled in it. |
Preparation Time
preparationTime
|
FIELD DESCRIPTION |
Maximum number of working days between your validation of the order and delivery of the package to the carrier. This delay therefore excludes the delay from the carrier to the end customer. |
|
EXPECTED FORMAT |
Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
10 characters before the decimal point, |
|
CHARACTER |
Mandatory on creation |
|
Business rules |
If a decimal place is indicated in this field, it is rounded to the wholeThe preparation Time is mandatory with the delivey modes for the update packages. |
Quantity (Stock)
quantity
|
FIELD DESCRIPTION |
Number of units that you put up for sale on the offer on a sales channel A zero stock does not allow the offer to be published on Cdiscount or Octopia . If you subscribe to Fulfillment On Demand , this field allows you to declare the stock you are hosting. |
|
EXPECTED FORMAT |
Digital |
|
FIELD SIZE & MAXIMUM EXPECTED VALUE |
Between 1 and 10 characters |
|
CHARACTER |
Mandatory on creation |
|
Business rules |
The field value must be less than 10,000,000,000.For the same seller, on the same product and the same condition, quantity is shared across all sales channels (Cdiscount and Octopia )If a decimal place is indicated in this field, it is rounded to the whole |