Update special offer

POST/api/crm/v2/special_offers_list.updatev2

operationId: specialOffersList.update

Authorization

api-token + language + role

Query parameters

branch_idinteger

Branch where the request is executed. A partner with multiple branches must provide this parameter; otherwise, the request will fail. For a partner with a single branch, the server will assign it automatically.

Example: 8778

Request body `multipart/form-data`

object

Rules are hidden when operating_mode = informing

idnumberrequired

Example: 1

namestringrequired

Example: Free delivery

operating_modestring (TypeOperatingMode) required

Values:informingpromo_codeinforming_and_promo_codeautomatic_actioninforming_and_automatic_action

Example: informing

platformstring (Platform) required

Values:androidiosallmobile_appssitesocial_apps

Example: all

descriptionstring

Displayed and required when operating_mode is: informing, informing_and_promo_code, informing_and_automatic_action

Example: informing description

imageobject (ImageSource)

Displayed and required when operating_mode is informing, informing_and_promo_code, or informing_and_automatic_action

binarystring · binary

cropobject

Image crop coordinates

offsetsobject

xintegerrequired

Example: 100

yintegerrequired

Example: 50

sizesobject

widthintegerrequired

Example: 800

heightintegerrequired

Example: 600

push_titlestring

Displayed when operating_mode is: informing, informing_and_promo_code, informing_and_automatic_action

Example: the push title

push_messagestring

Displayed when operating_mode is: informing, informing_and_promo_code, informing_and_automatic_action

Example: the push message

date_availablestring (DataTimeFormat)

Example: 17:45 06/05/2024

date_expirationstring (DataTimeFormat)

Example: 17:45 06/05/2024

days_of_weekarray of integer (DaysWeek)

Days of the week

time_periodsarray of array of string (TimePeriods)

Time period

hide_for_districts_idsarray of integer

hide_for_pickups_idsarray of integer

typestring (TypeWorkOperatingMode)

Values:fixed_discount_on_all_orderpercent_discount_on_all_orderfixed_discount_on_items_from_categoriespercent_discount_on_items_from_categoriesfixed_discount_on_itemspercent_discount_on_itemsfree_item_to_choose_if_buy_itemsfree_item_to_choose_if_buy_items_from_categoriesfixed_discount_on_next_itempercent_discount_on_next_itemfixed_discount_on_next_item_from_categoriespercent_discount_on_next_item_from_categoriesfree_item_to_choosepercent_discount_on_item_with_minimum_cost_in_cartfixed_discount_on_item_with_minimum_cost_in_cartpercent_discount_on_item_with_minimum_cost_from_itemsfixed_discount_on_item_with_minimum_cost_from_itemspercent_discount_on_item_with_minimum_cost_from_categoriesfixed_discount_on_item_with_minimum_cost_from_categoriesbonusesfree_delivery

Example: free_delivery

subcategories_include_in_categories_enabledboolean

Displayed when type is: fixed_discount_on_items_from_categories, percent_discount_on_items_from_categories, free_item_to_choose_if_buy_items_from_categories, percent_discount_on_next_item_from_categories, fixed_discount_on_next_item_from_categories, percent_discount_on_item_with_minimum_cost_from_categories, fixed_discount_on_item_with_minimum_cost_from_categories

Example: true

authorized_users_enabledboolean

Displayed when type is: free_item_to_choose_if_buy_items, free_item_to_choose_if_buy_items_from_categories, free_item_to_choose, free_delivery, fixed_discount_on_all_order, percent_discount_on_all_order, fixed_discount_on_items, percent_discount_on_items, fixed_discount_on_items_from_categories, percent_discount_on_items_from_categories, fixed_discount_on_next_item, percent_discount_on_next_item, fixed_discount_on_next_item_from_categories, percent_discount_on_next_item_from_categories, percent_discount_on_item_with_minimum_cost_in_cart, fixed_discount_on_item_with_minimum_cost_in_cart, percent_discount_on_item_with_minimum_cost_from_items, fixed_discount_on_item_with_minimum_cost_from_items, percent_discount_on_item_with_minimum_cost_from_categories, fixed_discount_on_item_with_minimum_cost_from_categories

Example: true

work_with_pay_bonuses_enabledboolean

Displayed for type: free_item_to_choose_if_buy_items, free_item_to_choose_if_buy_items_from_categories, free_item_to_choose, free_delivery, fixed_discount_on_all_order, percent_discount_on_all_order, fixed_discount_on_items, percent_discount_on_items, fixed_discount_on_items_from_categories, percent_discount_on_items_from_categories, fixed_discount_on_next_item, percent_discount_on_next_item, fixed_discount_on_next_item_from_categories, percent_discount_on_next_item_from_categories, percent_discount_on_item_with_minimum_cost_in_cart, fixed_discount_on_item_with_minimum_cost_in_cart, percent_discount_on_item_with_minimum_cost_from_items, fixed_discount_on_item_with_minimum_cost_from_items, percent_discount_on_item_with_minimum_cost_from_categories, fixed_discount_on_item_with_minimum_cost_from_categories

Example: true

accrual_bonuses_enabledboolean

Example: true

first_purchase_enabledboolean

Displayed for all types

Example: true

first_purchase_platformstring (Platform)

Values:androidiosallmobile_appssitesocial_apps

Example: all

reuse_enabledboolean

Displayed for all types

Example: true

use_only_in_birthday_enabledboolean

Displayed for all types

Example: true

birthday_validity_beforeinteger

Displayed for all types when use_only_in_birthday_enabled is enabled

Example: 10

birthday_validity_afterinteger

Displayed for all types when use_only_in_birthday_enabled is enabled

Example: 10

ignore_in_minimum_sum_enabledboolean

Displayed when type is: fixed_discount_on_all_order, percent_discount_on_all_order, fixed_discount_on_items, percent_discount_on_items, fixed_discount_on_items_from_categories, percent_discount_on_items_from_categories, fixed_discount_on_next_item, percent_discount_on_next_item, fixed_discount_on_next_item_from_categories, percent_discount_on_next_item_from_categories, percent_discount_on_item_with_minimum_cost_in_cart, fixed_discount_on_item_with_minimum_cost_in_cart, percent_discount_on_item_with_minimum_cost_from_items, fixed_discount_on_item_with_minimum_cost_from_items, percent_discount_on_item_with_minimum_cost_from_categories, fixed_discount_on_item_with_minimum_cost_from_categories

Example: true

delivery_methodstring (DeliveryMethodUpdate)

Values:allcourierpickup

from_sumnumber

Example: 100

to_sumnumber

Example: 1000

multiple_sumnumber

Displayed when type: free_item_to_choose

Example: 100

from_to_sums_for_items_from_conditions_enabledboolean

Displayed when type is free_item_to_choose_if_buy_items or free_item_to_choose_if_buy_items_from_categories

Example: true

discountnumber

Example: 10

count_items_for_conditioninteger

Displayed when type: fixed_discount_on_items, percent_discount_on_items, free_item_to_choose_if_buy_items, free_item_to_choose_if_buy_items_from_categories, fixed_discount_on_items_from_categories, percent_discount_on_items_from_categories, fixed_discount_on_next_item, percent_discount_on_next_item, fixed_discount_on_next_item_from_categories, percent_discount_on_next_item_from_categories, percent_discount_on_item_with_minimum_cost_from_items, fixed_discount_on_item_with_minimum_cost_from_items, percent_discount_on_item_with_minimum_cost_from_categories, fixed_discount_on_item_with_minimum_cost_from_categories

Example: 10

count_items_for_actioninteger

Displayed when type is: free_item_to_choose, free_item_to_choose_if_buy_items, free_item_to_choose_if_buy_items_from_categories

Example: 10

one_item_from_conditions_enabledboolean

Displayed when type: fixed_discount_on_items, percent_discount_on_items, free_item_to_choose_if_buy_items, free_item_to_choose_if_buy_items_from_categories, fixed_discount_on_items_from_categories, percent_discount_on_items_from_categories, percent_discount_on_item_with_minimum_cost_from_items, fixed_discount_on_item_with_minimum_cost_from_items, percent_discount_on_item_with_minimum_cost_from_categories, fixed_discount_on_item_with_minimum_cost_from_categories

Example: true

use_only_one_time_in_cart_enabledboolean

Displayed when type is: fixed_discount_on_items_from_categories, percent_discount_on_items_from_categories, fixed_discount_on_items, percent_discount_on_items, free_item_to_choose_if_buy_items, free_item_to_choose_if_buy_items_from_categories, fixed_discount_on_next_item, percent_discount_on_next_item, fixed_discount_on_next_item_from_categories, percent_discount_on_next_item_from_categories, percent_discount_on_item_with_minimum_cost_from_items, fixed_discount_on_item_with_minimum_cost_from_items, percent_discount_on_item_with_minimum_cost_from_categories, fixed_discount_on_item_with_minimum_cost_from_categories

Example: true

automatic_old_cost_for_items_enabledboolean

Displayed when type is: percent_discount_on_all_order, percent_discount_on_items_from_categories, percent_discount_on_items

Example: true

bonuses_sumnumber

Displayed and required when type is bonuses

Example: 100

bonuses_validitynumber

Displayed when type: bonuses

Example: 100

actions_itemsarray of integer

Displayed and required when type is: percent_discount_on_item_with_minimum_cost_from_items, fixed_discount_on_item_with_minimum_cost_from_items, percent_discount_on_next_item, fixed_discount_on_next_item, percent_discount_on_items, fixed_discount_on_items, free_item_to_choose, free_item_to_choose_if_buy_items, free_item_to_choose_if_buy_items_from_categories

conditions_itemsarray of integer

Displayed and required when type is free_item_to_choose_if_buy_items

actions_categoriesarray of integer

Displayed and required when type is: percent_discount_on_item_with_minimum_cost_from_categories, fixed_discount_on_item_with_minimum_cost_from_categories, percent_discount_on_items_from_categories, fixed_discount_on_items_from_categories, percent_discount_on_next_item_from_categories, fixed_discount_on_next_item_from_categories

conditions_categoriesarray of integer

Displayed and required when type is free_item_to_choose_if_buy_items_from_categories

Responses

object

statusstringrequired

Values:successerror

Example: success

dataobject

curl -X POST 'https://foodsoul.pro/api/crm/v2/special_offers_list.update' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: en' \
  -H 'role: partner' \
  -F 'id=1' \
  -F 'name=Free delivery' \
  -F 'operating_mode=informing' \
  -F 'platform=all' \
  -F 'description=informing description' \
  -F 'image={"binary":"<file>","crop":{"offsets":{"x":100,"y":50},"sizes":{"width":800,"height":600}}}' \
  -F 'push_title=the push title' \
  -F 'push_message=the push message' \
  -F 'date_available=17:45 06/05/2024' \
  -F 'date_expiration=17:45 06/05/2024' \
  -F 'days_of_week=[2,3]' \
  -F 'time_periods=[["13:12 - 13:15"]]' \
  -F 'hide_for_districts_ids=[55311]' \
  -F 'hide_for_pickups_ids=[4925]' \
  -F 'type=free_delivery' \
  -F 'subcategories_include_in_categories_enabled=true' \
  -F 'authorized_users_enabled=true' \
  -F 'work_with_pay_bonuses_enabled=true' \
  -F 'accrual_bonuses_enabled=true' \
  -F 'first_purchase_enabled=true' \
  -F 'first_purchase_platform=all' \
  -F 'reuse_enabled=true' \
  -F 'use_only_in_birthday_enabled=true' \
  -F 'birthday_validity_before=10' \
  -F 'birthday_validity_after=10' \
  -F 'ignore_in_minimum_sum_enabled=true' \
  -F 'delivery_method=all' \
  -F 'from_sum=100' \
  -F 'to_sum=1000' \
  -F 'multiple_sum=100' \
  -F 'from_to_sums_for_items_from_conditions_enabled=true' \
  -F 'discount=10' \
  -F 'count_items_for_condition=10' \
  -F 'count_items_for_action=10' \
  -F 'one_item_from_conditions_enabled=true' \
  -F 'use_only_one_time_in_cart_enabled=true' \
  -F 'automatic_old_cost_for_items_enabled=true' \
  -F 'bonuses_sum=100' \
  -F 'bonuses_validity=100' \
  -F 'actions_items=[94061047]' \
  -F 'conditions_items=[94061047]' \
  -F 'actions_categories=[3387030]' \
  -F 'conditions_categories=[3387030]'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://foodsoul.pro/api/crm/v2/special_offers_list.update', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'en',
        'role' => 'partner',
    ],
    'multipart' => [
        [
            'name' => 'id',
            'contents' => '1',
        ],
        [
            'name' => 'name',
            'contents' => 'Free delivery',
        ],
        [
            'name' => 'operating_mode',
            'contents' => 'informing',
        ],
        [
            'name' => 'platform',
            'contents' => 'all',
        ],
        [
            'name' => 'description',
            'contents' => 'informing description',
        ],
        [
            'name' => 'image',
            'contents' => '{"binary":"<file>","crop":{"offsets":{"x":100,"y":50},"sizes":{"width":800,"height":600}}}',
        ],
        [
            'name' => 'push_title',
            'contents' => 'the push title',
        ],
        [
            'name' => 'push_message',
            'contents' => 'the push message',
        ],
        [
            'name' => 'date_available',
            'contents' => '17:45 06/05/2024',
        ],
        [
            'name' => 'date_expiration',
            'contents' => '17:45 06/05/2024',
        ],
        [
            'name' => 'days_of_week',
            'contents' => '[2,3]',
        ],
        [
            'name' => 'time_periods',
            'contents' => '[["13:12 - 13:15"]]',
        ],
        [
            'name' => 'hide_for_districts_ids',
            'contents' => '[55311]',
        ],
        [
            'name' => 'hide_for_pickups_ids',
            'contents' => '[4925]',
        ],
        [
            'name' => 'type',
            'contents' => 'free_delivery',
        ],
        [
            'name' => 'subcategories_include_in_categories_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'authorized_users_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'work_with_pay_bonuses_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'accrual_bonuses_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'first_purchase_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'first_purchase_platform',
            'contents' => 'all',
        ],
        [
            'name' => 'reuse_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'use_only_in_birthday_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'birthday_validity_before',
            'contents' => '10',
        ],
        [
            'name' => 'birthday_validity_after',
            'contents' => '10',
        ],
        [
            'name' => 'ignore_in_minimum_sum_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'delivery_method',
            'contents' => 'all',
        ],
        [
            'name' => 'from_sum',
            'contents' => '100',
        ],
        [
            'name' => 'to_sum',
            'contents' => '1000',
        ],
        [
            'name' => 'multiple_sum',
            'contents' => '100',
        ],
        [
            'name' => 'from_to_sums_for_items_from_conditions_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'discount',
            'contents' => '10',
        ],
        [
            'name' => 'count_items_for_condition',
            'contents' => '10',
        ],
        [
            'name' => 'count_items_for_action',
            'contents' => '10',
        ],
        [
            'name' => 'one_item_from_conditions_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'use_only_one_time_in_cart_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'automatic_old_cost_for_items_enabled',
            'contents' => 'true',
        ],
        [
            'name' => 'bonuses_sum',
            'contents' => '100',
        ],
        [
            'name' => 'bonuses_validity',
            'contents' => '100',
        ],
        [
            'name' => 'actions_items',
            'contents' => '[94061047]',
        ],
        [
            'name' => 'conditions_items',
            'contents' => '[94061047]',
        ],
        [
            'name' => 'actions_categories',
            'contents' => '[3387030]',
        ],
        [
            'name' => 'conditions_categories',
            'contents' => '[3387030]',
        ],
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const body = new FormData()
body.append("id", "1")
body.append("name", "Free delivery")
body.append("operating_mode", "informing")
body.append("platform", "all")
body.append("description", "informing description")
body.append("image", "{\"binary\":\"<file>\",\"crop\":{\"offsets\":{\"x\":100,\"y\":50},\"sizes\":{\"width\":800,\"height\":600}}}")
body.append("push_title", "the push title")
body.append("push_message", "the push message")
body.append("date_available", "17:45 06/05/2024")
body.append("date_expiration", "17:45 06/05/2024")
body.append("days_of_week", "[2,3]")
body.append("time_periods", "[[\"13:12 - 13:15\"]]")
body.append("hide_for_districts_ids", "[55311]")
body.append("hide_for_pickups_ids", "[4925]")
body.append("type", "free_delivery")
body.append("subcategories_include_in_categories_enabled", "true")
body.append("authorized_users_enabled", "true")
body.append("work_with_pay_bonuses_enabled", "true")
body.append("accrual_bonuses_enabled", "true")
body.append("first_purchase_enabled", "true")
body.append("first_purchase_platform", "all")
body.append("reuse_enabled", "true")
body.append("use_only_in_birthday_enabled", "true")
body.append("birthday_validity_before", "10")
body.append("birthday_validity_after", "10")
body.append("ignore_in_minimum_sum_enabled", "true")
body.append("delivery_method", "all")
body.append("from_sum", "100")
body.append("to_sum", "1000")
body.append("multiple_sum", "100")
body.append("from_to_sums_for_items_from_conditions_enabled", "true")
body.append("discount", "10")
body.append("count_items_for_condition", "10")
body.append("count_items_for_action", "10")
body.append("one_item_from_conditions_enabled", "true")
body.append("use_only_one_time_in_cart_enabled", "true")
body.append("automatic_old_cost_for_items_enabled", "true")
body.append("bonuses_sum", "100")
body.append("bonuses_validity", "100")
body.append("actions_items", "[94061047]")
body.append("conditions_items", "[94061047]")
body.append("actions_categories", "[3387030]")
body.append("conditions_categories", "[3387030]")

const response = await fetch("https://foodsoul.pro/api/crm/v2/special_offers_list.update", {
    method: "POST",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "en",
        "role": "partner"
    },
    body,
})
const data = await response.json()

import requests

response = requests.request(
    "POST",
    "https://foodsoul.pro/api/crm/v2/special_offers_list.update",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "en",
        "role": "partner",
    },
    files={
        "id": [
            None,
            "1",
        ],
        "name": [
            None,
            "Free delivery",
        ],
        "operating_mode": [
            None,
            "informing",
        ],
        "platform": [
            None,
            "all",
        ],
        "description": [
            None,
            "informing description",
        ],
        "image": [
            None,
            "{\"binary\":\"<file>\",\"crop\":{\"offsets\":{\"x\":100,\"y\":50},\"sizes\":{\"width\":800,\"height\":600}}}",
        ],
        "push_title": [
            None,
            "the push title",
        ],
        "push_message": [
            None,
            "the push message",
        ],
        "date_available": [
            None,
            "17:45 06/05/2024",
        ],
        "date_expiration": [
            None,
            "17:45 06/05/2024",
        ],
        "days_of_week": [
            None,
            "[2,3]",
        ],
        "time_periods": [
            None,
            "[[\"13:12 - 13:15\"]]",
        ],
        "hide_for_districts_ids": [
            None,
            "[55311]",
        ],
        "hide_for_pickups_ids": [
            None,
            "[4925]",
        ],
        "type": [
            None,
            "free_delivery",
        ],
        "subcategories_include_in_categories_enabled": [
            None,
            "true",
        ],
        "authorized_users_enabled": [
            None,
            "true",
        ],
        "work_with_pay_bonuses_enabled": [
            None,
            "true",
        ],
        "accrual_bonuses_enabled": [
            None,
            "true",
        ],
        "first_purchase_enabled": [
            None,
            "true",
        ],
        "first_purchase_platform": [
            None,
            "all",
        ],
        "reuse_enabled": [
            None,
            "true",
        ],
        "use_only_in_birthday_enabled": [
            None,
            "true",
        ],
        "birthday_validity_before": [
            None,
            "10",
        ],
        "birthday_validity_after": [
            None,
            "10",
        ],
        "ignore_in_minimum_sum_enabled": [
            None,
            "true",
        ],
        "delivery_method": [
            None,
            "all",
        ],
        "from_sum": [
            None,
            "100",
        ],
        "to_sum": [
            None,
            "1000",
        ],
        "multiple_sum": [
            None,
            "100",
        ],
        "from_to_sums_for_items_from_conditions_enabled": [
            None,
            "true",
        ],
        "discount": [
            None,
            "10",
        ],
        "count_items_for_condition": [
            None,
            "10",
        ],
        "count_items_for_action": [
            None,
            "10",
        ],
        "one_item_from_conditions_enabled": [
            None,
            "true",
        ],
        "use_only_one_time_in_cart_enabled": [
            None,
            "true",
        ],
        "automatic_old_cost_for_items_enabled": [
            None,
            "true",
        ],
        "bonuses_sum": [
            None,
            "100",
        ],
        "bonuses_validity": [
            None,
            "100",
        ],
        "actions_items": [
            None,
            "[94061047]",
        ],
        "conditions_items": [
            None,
            "[94061047]",
        ],
        "actions_categories": [
            None,
            "[3387030]",
        ],
        "conditions_categories": [
            None,
            "[3387030]",
        ],
    },
)
data = response.json()

Response 200

{
  "status": "success",
  "data": {}
}

Requests are sent to foodsoul.pro — the host of this portal; you cannot choose another one.

Update special offer

Authorization

Query parameters

Request body multipart/form-data

Responses

Request body `multipart/form-data`