# OF24 - Create, update, or delete offers

Returns the import identifier to track the status of the update.You must send all offer fields. Offer fields that are not sent are reset to their default value.Call FrequencyRecommended usage: Every 5 minutesMaximum usage: Once per minute

Endpoint: POST /api/offers

## Query parameters:

  - `shop_id` (integer)
    Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

## Request fields (application/json):

  - `offers` (array, required)
    Offers list

  - `offers.all_prices` (array)
    The volume and channel prices.

  - `offers.all_prices.channel_code` (string)
    The channel code the prices will be linked to. To set the default prices, set it to null.

  - `offers.all_prices.discount_end_date` (string)
    The end date of the discount. If no discount is desired, set it to null.

  - `offers.all_prices.discount_start_date` (string)
    The start date of the discount. If no discount is desired, set it to null.

  - `offers.all_prices.unit_discount_price` (number)
    The default unit discount price, i.e. the unit price when the discount applied.

  - `offers.all_prices.unit_origin_price` (number)
    The default unit original price, i.e. the unit price without taking discounts nor volume prices into account.

  - `offers.all_prices.volume_prices` (array)
    The volume prices applicable for the offer.

  - `offers.all_prices.volume_prices.quantity_threshold` (integer, required)
    The quantity threshold from which the volume price is applicable

  - `offers.all_prices.volume_prices.unit_discount_price` (number)
    The unit discount price, i.e. the unit price when the discount applies

  - `offers.all_prices.volume_prices.unit_origin_price` (number, required)
    The unit original price, i.e. the unit price excluding discounts

  - `offers.allow_quote_requests` (boolean)
    Whether the offer is eligible for quotation. Offer update: if not provided, will be set to false.

  - `offers.available_ended` (string)
    End date of the period of availability. Offer update: if not provided, existing data will be deleted.

  - `offers.available_started` (string)
    Started date of the period of availability. Offer update: if not provided, existing data will be deleted.

  - `offers.description` (string)
    Description of the offer. Offer update: if not provided, existing data will be deleted.

  - `offers.discount` (object)
    Discount of an offer. Offer update: if not provided, existing data will be deleted.

  - `offers.discount.end_date` (string)
    Discount end date. Offer update: if not provided, existing data will be deleted.

  - `offers.discount.price` (number)
    Discount price. Not to be used when ranges are specified. Offer update: if not provided, existing data will be deleted. For Dropship specifically: the discount purchasing price of the offer, also referred to as discount cost or discount wholesale price.

  - `offers.discount.ranges` (array)
    Discount ranges. Offer update: if not provided, existing data will be deleted.

  - `offers.discount.ranges.price` (number, required)
    Price of the offer if the quantity threshold is reached

  - `offers.discount.ranges.quantity_threshold` (integer, required)
    Minimum quantity to order for the given price to be applied

  - `offers.discount.start_date` (string)
    Discount start date. Offer update: if not provided, existing data will be deleted.

  - `offers.eco_contributions` (array)
    Eco-contributions of the offer - only available if the operator setting Activate data collection related to circular economy regulations has been enabled. Offer update: if not provided, existing data will be deleted.

  - `offers.eco_contributions.eco_contribution_amount` (number)
    Amount of the eco-contribution. Offer update: if not provided, existing data will be deleted.

  - `offers.eco_contributions.epr_category_code` (string, required)
    Extended Producer Responsibility (EPR) category code.
    Enum: "FR-AGROPACK", "FR-ASL", "FR-DASRIPAT", "FR-DBPS", "FR-DDS", "FR-DEA", "FR-DEEE", "FR-DISPMED", "FR-DIY", "FR-EMBM", "FR-GF", "FR-JOUETS", "FR-LUB", "FR-MH", "FR-MNU", "FR-PA", "FR-PAP", "FR-PCHIM", "FR-PMCB", "FR-PNEU", "FR-TABAC", "FR-TLC", "FR-VEHICULE", "FR-VHU", "DE-BATTG", "DE-PACK", "DE-WEEE", "ES-PACK", "ES-GPACK", "ES-WEEE"

  - `offers.eco_contributions.producer_id` (string)
    Producer identifier of the eco-contribution. Offer update: if not provided, existing data will be deleted.

  - `offers.internal_description` (string)
    Internal description of the offer. Offer update: if not provided, existing data will be deleted.

  - `offers.leadtime_to_ship` (integer)
    Leadtime to ship of the offer, in days. Offer update: if not provided, existing data will be deleted.

  - `offers.logistic_class` (string)
    Offer logistic class. Offer update: if not provided, existing data will be deleted.

  - `offers.max_order_quantity` (integer)
    The maximum quantity of product items per order. Offer update: if not provided, existing data will be deleted.

  - `offers.min_order_quantity` (integer)
    The minimum quantity of product items per order. Offer update: if not provided, existing data will be deleted.

  - `offers.min_quantity_alert` (integer)
    The minimum stock level that triggers an email alert. No alerts are sent if this field is not specified. Offer update: if not provided, existing data will be deleted.

  - `offers.msrp` (number)
    The retail price recommendation, also referred to as manufacturer's suggested retail price (MSRP) or recommended retail price (RRP). Only applicable for Dropship offers.

  - `offers.offer_additional_fields` (array)
    Custom fields of the offer

  - `offers.offer_additional_fields.code` (string, required)
    Custom field's code

  - `offers.offer_additional_fields.type` (string)
    Custom field's type
    Enum: "STRING", "DATE", "NUMERIC", "BOOLEAN", "LINK", "REGEX", "TEXTAREA", "LIST", "MULTIPLE_VALUES_LIST"

  - `offers.package_quantity` (integer)
    The indivisible selling quantity of the same product. Offer update: if not provided, existing data will be deleted.

  - `offers.price` (number, required)
    Price of the offer. For Dropship specifically: the purchasing price of the offer, also referred to as cost or wholesale price.

  - `offers.price_additional_info` (string)
    Price additional information of the offer. Offer update: if not provided, existing data will be deleted.

  - `offers.pricing_unit` (string)
    The unit corresponding to the submitted price when the price per measurement unit feature is used.

  - `offers.product_id` (string, required)
    Reference of the product associated with the offer. Required at offer creation. Optional at offer update.

  - `offers.product_id_type` (string, required)
    Reference type of the product associated with the offer. Required at offer creation. Optional at offer update.

  - `offers.product_tax_code` (string)
    Product tax code associated to the offer. When Operator mandatorily collects product tax codes on offers, required at offer creation and update. When Operator optionally collects product tax codes on offers, if no value is provided at offer update, existing data will be deleted.

  - `offers.quantity` (integer)
    Quantity available of the offer. Offer update: if not provided, will be set to 0.

  - `offers.retail_prices` (array)
    The retail prices of the offer, also referred to as selling prices. Applicable only for Dropship offers.

  - `offers.retail_prices.unit_discount_price` (number)
    The default unit discount retail price, i.e. the retail unit price when the discount applied.

  - `offers.retail_prices.unit_origin_price` (number)
    The default unit original retail price, i.e. the retail unit price without discount.

  - `offers.shop_sku` (string, required)
    Sku of the offer

  - `offers.state_code` (string, required)
    State of the offer

  - `offers.update_delete` (string, required)
    Update delete flag. Could be empty (means "update"), "update" or "delete".

## Response 201 fields (application/json):

  - `import_id` (integer, required)
    Offer import identifier