Aktion erstellen

POST/api/crm/v2/special_offers_list.addv2

operationId: specialOffersList.add

Autorisierung

api-token + language + role

Abfrageparameter

branch_idinteger

Die Filiale, in der die Anfrage ausgeführt wird. Ein Partner mit mehreren Filialen muss diesen Parameter angeben, andernfalls wird die Anfrage mit einem Fehler abgelehnt. Bei einem Partner mit nur einer Filiale wird dieser Wert vom Server automatisch gesetzt.

Beispiel: 8778

Anfragetext `multipart/form-data`

object

Die Regeln werden ausgeblendet, wenn operating_mode = informing

namestringerforderlich

Beispiel: Free delivery

operating_modestring (TypeOperatingMode) erforderlich

Werte:informingpromo_codeinforming_and_promo_codeautomatic_actioninforming_and_automatic_action

Beispiel: informing

platformstring (Platform) erforderlich

Werte:androidiosallmobile_appssitesocial_apps

Beispiel: all

descriptionstring

Wird angezeigt und ist erforderlich bei operating_mode: informing, informing_and_promo_code, informing_and_automatic_action

Beispiel: informing description

imageobject (ImageSource)

Wird angezeigt und ist erforderlich bei operating_mode: informing, informing_and_promo_code, informing_and_automatic_action

binarystring · binary

cropobject

Koordinaten des Bildzuschnitts

offsetsobject

xintegererforderlich

Beispiel: 100

yintegererforderlich

Beispiel: 50

sizesobject

widthintegererforderlich

Beispiel: 800

heightintegererforderlich

Beispiel: 600

push_titlestring

Wird angezeigt bei operating_mode: informing, informing_and_promo_code, informing_and_automatic_action

Beispiel: the push title

push_messagestring

Wird angezeigt bei operating_mode: informing, informing_and_promo_code, informing_and_automatic_action

Beispiel: the push message

date_availablestring (DataTimeFormat)

Beispiel: 17:45 06/05/2024

date_expirationstring (DataTimeFormat)

Beispiel: 17:45 06/05/2024

days_of_weekarray of integer (DaysWeek)

Wochentage

time_periodsarray of array of string (TimePeriods)

Zeitraum

hide_for_districts_idsarray of integer

hide_for_pickups_idsarray of integer

typestring (TypeWorkOperatingMode)

Werte: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

Beispiel: free_delivery

subcategories_include_in_categories_enabledboolean

Wird angezeigt bei type: 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

Beispiel: true

authorized_users_enabledboolean

Wird angezeigt bei 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

Beispiel: true

work_with_pay_bonuses_enabledboolean

Beispiel: true

accrual_bonuses_enabledboolean

Beispiel: true

first_purchase_enabledboolean

Wird für alle Typen angezeigt

Beispiel: true

first_purchase_platformstring (Platform)

Werte:androidiosallmobile_appssitesocial_apps

Beispiel: all

reuse_enabledboolean

Wird für alle Typen angezeigt

Beispiel: true

use_only_in_birthday_enabledboolean

Wird für alle Typen angezeigt

Beispiel: true

birthday_validity_beforeinteger

Wird für alle Typen angezeigt, wenn use_only_in_birthday_enabled aktiviert ist

Beispiel: 10

birthday_validity_afterinteger

Wird für alle Typen angezeigt, wenn use_only_in_birthday_enabled aktiviert ist

Beispiel: 10

ignore_in_minimum_sum_enabledboolean

Wird angezeigt bei type: 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

Beispiel: true

delivery_methodstring (DeliveryMethodUpdate)

Werte:allcourierpickup

from_sumnumber

Beispiel: 100

to_sumnumber

Beispiel: 1000

multiple_sumnumber

Wird angezeigt bei type: free_item_to_choose

Beispiel: 100

from_to_sums_for_items_from_conditions_enabledboolean

Wird angezeigt bei type: free_item_to_choose_if_buy_items, free_item_to_choose_if_buy_items_from_categories

Beispiel: true

discountnumber

Beispiel: 10

count_items_for_conditioninteger

Wird angezeigt bei 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

Beispiel: 10

count_items_for_actioninteger

Wird angezeigt bei type: free_item_to_choose, free_item_to_choose_if_buy_items, free_item_to_choose_if_buy_items_from_categories

Beispiel: 10

one_item_from_conditions_enabledboolean

Wird angezeigt bei 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

Beispiel: true

use_only_one_time_in_cart_enabledboolean

Angezeigt bei type: 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

Beispiel: true

automatic_old_cost_for_items_enabledboolean

Wird angezeigt bei type: percent_discount_on_all_order, percent_discount_on_items_from_categories, percent_discount_on_items

Beispiel: true

bonuses_sumnumber

Wird angezeigt und ist erforderlich bei type: bonuses

Beispiel: 100

bonuses_validitynumber

Wird angezeigt, wenn type: bonuses

Beispiel: 100

actions_itemsarray of integer

Wird angezeigt und ist erforderlich bei type: 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

Wird angezeigt und ist erforderlich bei type: free_item_to_choose_if_buy_items

actions_categoriesarray of integer

Wird angezeigt und ist erforderlich bei type: 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

Wird angezeigt und ist erforderlich bei type: free_item_to_choose_if_buy_items_from_categories

Antworten

object

statusstringerforderlich

Werte:successerror

Beispiel: success

dataobject

curl -X POST 'https://foodsoul.pro/api/crm/v2/special_offers_list.add' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: de' \
  -H 'role: partner' \
  -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.add', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'de',
        'role' => 'partner',
    ],
    'multipart' => [
        [
            '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("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.add", {
    method: "POST",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "de",
        "role": "partner"
    },
    body,
})
const data = await response.json()

import requests

response = requests.request(
    "POST",
    "https://foodsoul.pro/api/crm/v2/special_offers_list.add",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "de",
        "role": "partner",
    },
    files={
        "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()

Antwort 200

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

Anfragen werden an foodsoul.pro gesendet – dies ist der Host dieses Portals, ein anderer kann nicht ausgewählt werden.

Aktion erstellen

Autorisierung

Abfrageparameter

Anfragetext multipart/form-data

Antworten

Anfragetext `multipart/form-data`