Откройте раздел Интеграции - Автоматизация
Из выпадающего списка Выберите Режим → Ваш Сайт
Укажите в настройках ссылки на Ваш сайт по которым будет происходить обмен запросами:
Включите опцию Callback API
Иконка в виде глаза справа сверху позволяет включить или выключить интеграцию, переключите её на зелёную.
В Callback API используется подпись запросов для проверки валидности отправителя.
Генерируется она таким образом:
md5(id.date.Token)
Токен апи можно скопировать в личном кабинете в разделе Настройки → Филиалы в таблице рядом с названием города.
Для того, чтобы начать валидировать заказы в Вашей системе, необходимо написать код, аналогичный данному примеру написанному на языке PHP:
$r = &$_REQUEST;
$token = 'Токен Api';
if (empty($r['body']['order_number'])) {
exit('Not exists order number');
}
if (empty($r['body']['date'])) {
exit('Not date');
}
if (empty($r['signature'])) {
exit('Not exists signture');
}
$signature = md5($r['body']['order_number'].$r['body']['date'].$token);
if ($signature != $r['signature']) {
exit('error_signature');
}
//Проверка прошла успешно, можно обрабатывать Массив
На URL Api отправляется запрос order_status
{
"body": {
"order_id": "123456" // номер заказа в Вашей системе
},
"action": "order_status",
"signature": "dd4c5af279d02fd7095acec203726b96"
}
в ответ вы должны вернуть актуальный статус заказа из списка:
| Не обработан | not_processed |
| В пути | in_transit |
| Комплектовка заказа | assembly |
| На кухне | in_kitchen |
| Ожидает отправки | ready_to_transit |
| Ожидает отправки на кухню | wait_to_kitchen |
| Ожидает переделки | wait_remade |
| Отменен | canceled |
| Подтвержден | confirmed |
| Приготовлен | cooked |
| Выполнен | done |
в формате json
{ "status" : "assembly" }
в этом запросе вместо date используется date("Y-m-d H"), вместо id → order_id из запроса
$signature = md5($r['body']['order_id'].date("Y-m-d H").$token);
на URL Api отправляется запрос client_info
{
"body": {
"phone": "89333333333" // номер телефона клиента
},
"action": "client_info",
"signature": "dd4c5af279d02fd7095acec203726b96"
}
в ответ вы должны вернуть актуальный баланс в формате json
{
"balance" : 1234,
"qr_code" : "1293719824671892",
"bar_code" : "1293719824671892"
}
в этом запросе вместо date используется date("Y-m-d H"), вместо id → phone из запроса
$signature = md5($r['body']['phone'].date("Y-m-d H").$token);
на URL API отправляется событие client_authorization
{
"body": {
"name": "Александр", // имя клиента
"phone": "79000000000", // номер телефона клиента
"date_of_birth": "01.01.1900", // дата рождения
"gender": "man" // Пол клиента (man,woman)
},
"action": "client_authorization",
"signature": "dd4c5af279d02fd7095acec203726b96" // вычисляетя по полю phone
}
Для получения номенклатуры используется xml файл. Ваш файл может быть представлен в YML формате ( Yandex Market ) или в одном из расширенных форматов ( пример и описание ниже ).
Значение атрибута id для категорий(category), товаров(offer), групп модификаторов(modifiersGroup) и модификаторов(modifier) должны соответствовать значениям в Вашей базе данных.
У тега fs_catalog должен присутствовать атрибут date - это дата последнего изменения меню в формате YYYY-MM-DD HH:MM
Если за 4 часа меню будет обновлено более 6 раз, то API будет автоматически отключено и его необходимо будет снова активировать в личном кабинете вручную, поэтому, чтобы Ваше меню всегда было актуальным в режиме реального времени, настраивайте алгоритм выдачи date правильно.
Мы рекомендуем указывать ссылку на картинку(picture) в оптимальном разрешении, чтобы одна из сторон была не менее 800px
Суммарный лимит всех данных(параметры товаров + товары + категории + модификаторы + группы модификаторов) - 3000 наименований, если наименований больше меню не будет интегрировано
Так же если Ваш сервер/сайт имеет время ответа более 20 секунд, меню интегрировано не будет
| Индекс (descriptionIndex) | Описание |
|---|---|
| 0 | ед. |
| 1 | гр. |
| 2 | кг. |
| 3 | мл. |
| 4 | л. |
| 5 | см. |
| 6 | м. |
| 7 | мин. |
| 8 | ч. |
| 9 | шт. |
| 10 | порц. |
| Тип | Описание |
|---|---|
| all_unlimited | Сколько угодно модификаторов в любом количестве |
| all_one | Сколько угодно модификаторов в одном количестве |
| one_unlimited | Только один модификатор в любом количестве |
| one_one | Только один модификатор в одном количестве |
<?xml version="1.0" encoding="utf-8"?>
<!--
date: дата последнего изменения информации в файле
importNotPublished: выгружать непубличную номенклатуру, по умолчанию false
-->
<fs_catalog date="2016-12-20 19:43" importNotPublished="true">
<shop>
<!-- описание групп модификаторов -->
<modifiersGroups>
<!--
id: идентификатор позиции, должен быть уникальным
published: указатель публикации на сайте/ в приложении
-->
<modifiersGroup id="1" required="true" published="false">
<!-- название -->
<name>Соусы</name>
<!-- тип -->
<type>one_one</type>
<!-- минимальное количество ингредиентов -->
<minimum>0</minimum>
<!-- максимальное количество ингредиентов -->
<maximum>0</maximum>
<!-- порядковый номер отображения (необязательный) -->
<sort>1</sort>
</modifiersGroup>
<modifiersGroup id="2" required="false" published="true">
<name>Тесто</name>
<type>one_one</type>
<minimum>0</minimum>
<maximum>0</maximum>
<sort>2</sort>
</modifiersGroup>
</modifiersGroups>
<!-- описание модификаторов -->
<modifiers>
<!--
id: идентификатор позиции, должен быть уникальным
published: указатель публикации на сайте/ в приложении
-->
<modifier id="1" published="true">
<!-- название -->
<name>Белый</name>
<!-- стоимость -->
<price>0</price>
<!-- белки -->
<proteins>123</proteins>
<!-- жиры -->
<fats>123</fats>
<!-- углеводы -->
<carbohydrates>123</carbohydrates>
<!-- количество калорий -->
<calories>123</calories>
<!-- идентификатор группы модификаторов -->
<modifiersGroupId>1</modifiersGroupId>
<!-- уникальный идентификатор позиции, используется для связи с внешним сайтом, если не указан vendor_code используется id -->
<vendor_code>1234</vendor_code>
<!-- порядковый номер отображения (необязательный) -->
<sort>1</sort>
</modifier>
<modifier id="2" published="false">
<vendor_code>123</vendor_code>
<name>Красный</name>
<price>0</price>
<modifiersGroupId>1</modifiersGroupId>
<sort>2</sort>
</modifier>
<modifier id="3">
<vendor_code>456</vendor_code>
<name>Пышное</name>
<price>50</price>
<modifiersGroupId>2</modifiersGroupId>
<sort>3</sort>
</modifier>
<modifier id="4">
<vendor_code>678</vendor_code>
<name>Тонкое</name>
<price>0</price>
<modifiersGroupId>2</modifiersGroupId>
</modifier>
</modifiers>
<!-- список категорий -->
<categories>
<!--
id: идентификатор позиции, должен быть уникальным
published: указатель публикации на сайте/ в приложении
parentId: id родительской категории
discount: true/false; true - на товары из категории действуют скидки
minimal_sum: true/false; true - товары из категории принимают участие в минимальной сумме заказа,
sort: порядковый номер отображения (необязательный)
-->
<category id="59" published="true" discount="true" minimal_sum="true" sort='1'>Пицца</category>
<category id="60" published="false" discount="true" minimal_sum="false" sort='2'>Бургеры</category>
<category id="61" published="true" discount="false" minimal_sum="false" parentId="59" sort="3">Пицулечки</category>
</categories>
<!-- описание меню -->
<offers>
<!-- описание товара -->
<!--
id: идентификатор позиции, должен быть уникальным
published: указатель публикации на сайте/ в приложении
-->
<offer id="50" published="true">
<!-- название -->
<name>Маргарита</name>
<!-- описание -->
<description>
Пицца соус, томаты, маслины, оливки, моцарелла.
</description>
<!-- ссылка на изображение -->
<picture>
http://example.ru/image/cache/catalog/noviepruduk/margarita-50-800x800.jpg
</picture>
<!-- идентификатор категории -->
<categoryId>59</categoryId>
<!-- Дни недели отображения. Если все дни недели, данный тег можно опустить -->
<days_of_week>["1", "2", "3", "4", "5"]</days_of_week>
<!-- Временной период отображения. Если товар доступен круглосуточно, данный тег можно опустить -->
<time_periods>["10:00 - 16:00", "18:00 - 23:59"]</time_periods>
<!-- выбор вариантов размера -->
<parameters>
<parameter id="1">
<!-- уникальный идентификатор позиции, используется для связи с внешним сайтом, если не указан vendor_code используется id -->
<vendor_code>123</vendor_code>
<!-- стоимость -->
<price>299</price>
<!-- описание параметра -->
<description>30</description>
<!-- описание единицы измерения -->
<descriptionIndex>5</descriptionIndex>
<!-- белки -->
<proteins>123</proteins>
<!-- жиры -->
<fats>123</fats>
<!-- углеводы -->
<carbohydrates>123</carbohydrates>
<!-- количество калорий -->
<calories>123</calories>
<!-- список групп модификаторов по id, опционально для каждого варианта -->
<modifiers_groups_ids>
<modifiers_group_id>1</modifiers_group_id>
<modifiers_group_id>2</modifiers_group_id>
</modifiers_groups_ids>
<!-- sort: порядковый номер отображения (необязательный) -->
<sort>123</sort>
</parameter>
<parameter id="2">
<vendor_code>456</vendor_code>
<price>399</price>
<description>40</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
<parameter id="3">
<vendor_code>789</vendor_code>
<price>399</price>
<description>50</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
</parameters>
<!-- список групп модификаторов по id -->
<modifiersGroupsIds>
<modifiersGroupId>1</modifiersGroupId>
<modifiersGroupId>2</modifiersGroupId>
</modifiersGroupsIds>
<!-- список меток товара по id; добавляются в личном кабинете -->
<labelsIds>
<labelId>1</labelId>
<labelId>2</labelId>
</labels>
<!-- порядковый номер отображения (необязательный) -->
<sort>50</sort>
</offer>
<offer id="51" published="false">
<name>Кальцоне</name>
<description>
Пицца соус, корнишоны, колбаса, лук репчатый, маслины, оливки, моцарелла.
</description>
<picture>
http://example.ru/image/cache/catalog/noviepruduk/rucckaya-51-800x800.jpg
</picture>
<categoryId>59</categoryId>
<parameters>
<parameter id="4" published="true">
<price>399</price>
<description>25</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
</parameters>
<modifiersGroupsIds>
<modifiersGroupId>2</modifiersGroupId>
</modifiersGroupsIds>
<sort>51</sort>
</offer>
<offer id="52">
<name>С перцем пепперони</name>
<description>
Пицца соус, перец пепперони, огурцы, колбаски копченые, маслины, оливки, бекон, моцарелла.
</description>
<picture>
http://example.ru/image/cache/catalog/noviepruduk/c-percem-pepperoni-52-800x800.jpg
</picture>
<categoryId>59</categoryId>
<url>http://example.ru/picca/c-percem-pepperoni.html</url>
<parameters>
<parameter id="4">
<price>210</price>
<description>size 3</description>
<descriptionIndex>3</descriptionIndex>
</parameter>
</parameters>
<modifiersGroupsIds>
<modifiersGroupId>3</modifiersGroupId>
</modifiersGroupsIds>
<sort>52</sort>
</offer>
<offer id="53" recommend="true">
<name>Славянская</name>
<description>
Пицца соус, томаты, фарш говяжий, бекон, лук репчатый, маслины, оливки, моцарелла.
</description>
<picture>
http://example.ru/image/cache/catalog/noviepruduk/clavyanckaya-53-800x800.jpg
</picture>
<categoryId>59</categoryId>
<parameters>
<parameter id="4">
<price>299</price>
<description>30</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
<parameter id="5">
<price>399</price>
<description>40</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
<parameter id="6">
<price>499</price>
<description>50</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
</parameters>
<modifiersGroupsIds>
<modifiersGroupId>1</modifiersGroupId>
<modifiersGroupId>2</modifiersGroupId>
</modifiersGroupsIds>
<sort>53</sort>
</offer>
<offer id="54" recommend="true">
<name>Славянская</name>
<description>
Пицца соус, томаты, фарш говяжий, бекон, лук репчатый, маслины, оливки, моцарелла.
</description>
<picture>
http://example.ru/image/cache/catalog/noviepruduk/clavyanckaya-53-800x800.jpg
</picture>
<categoryId>61</categoryId>
<parameters>
<parameter id="4">
<price>299</price>
<description>30</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
<parameter id="5">
<price>399</price>
<description>40</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
<parameter id="6">
<price>499</price>
<description>50</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
</parameters>
<modifiersGroupsIds>
<modifiersGroupId>1</modifiersGroupId>
<modifiersGroupId>2</modifiersGroupId>
</modifiersGroupsIds>
</offer>
<offer id="55" recommend="false">
<name>Блэк бургер</name>
<description>
БУЛКА! БУЛКА ЭТО ХАРД КОР!
</description>
<picture>
http://example.ru/image/cache/catalog/noviepruduk/clavyanckaya-53-800x800.jpg
</picture>
<categoryId>60</categoryId>
<parameters>
<parameter id="7">
<price>299</price>
<description>30</description>
<descriptionIndex>5</descriptionIndex>
</parameter>
</parameters>
</offer>
</offers>
</shop>
</fs_catalog>
Находится в разделе Интеграции → Автоматизация → Ссылка на выгрузку товаров
На момент запроса всегда выдаются актуальные данные, при изменении каталога товаров выгрузка автоматически изменяется.
Доступны следующие форматы:
Файл в данном формате доступен в личном кабинете по ссылке в разделе Интеграции → Автоматизация → Ссылка на выгрузку товаров → FS. Выгрузка аналогична старому расширенному формату и также подходит для импорта меню.
<?xml version="1.0" encoding="UTF-8"?>
<fs_catalog date="2021-01-20 14:00">
<shop>
<!-- описание групп модификаторов -->
<modifiers_groups>
<!-- группа модификаторов -->
<!-- required:true - обязательный выбор ингредиентов -->
<modifiers_group id="1" required="true">
<!-- Название -->
<name>Тесто</name>
<!-- Тип -->
<type>one_one</type>
<!-- Минимальное количество -->
<minimum>1</minimum>
<!-- Максимальное количество -->
<maximum>1</maximum>
<!-- Порядковый номер отображения (необязательный) -->
<sort>1</sort>
</modifiers_group>
<modifiers_group id="2" required="true">
<name>Соус</name>
<type>one_one</type>
<minimum>1</minimum>
<maximum>1</maximum>
<sort>2</sort>
</modifiers_group>
<modifiers_group id="3">
<name>Дополнительно</name>
<type>all_unlimited</type>
<minimum>0</minimum>
<maximum>10</maximum>
</modifiers_group>
</modifiers_groups>
<!-- описание модификаторов -->
<modifiers>
<modifier id="1">
<!-- название -->
<name>Традиционное тесто</name>
<!-- стоимость -->
<price>0.00</price>
<!-- артикул для связи с внешним сайтом, если поле отсутствует будет использоваться атрибут id -->
<vendor_code>1</vendor_code>
<!-- белки -->
<proteins>123</proteins>
<!-- жиры -->
<fats>123</fats>
<!-- углеводы -->
<carbohydrates>123</carbohydrates>
<!-- количество калорий -->
<calories>123</calories>
<!-- идентификатор группы модификаторов -->
<modifiers_group_id>1</modifiers_group_id>
<!-- порядковый номер отображения в группе модификаторов (необязательный) -->
<sort>1</sort>
</modifier>
<modifier id="2">
<name>Тонкое тесто</name>
<price>0.00</price>
<modifiers_group_id>1</modifiers_group_id>
<vendor_code>2</vendor_code>
<sort>2</sort>
</modifier>
<modifier id="3">
<name>Острый</name>
<price>0.00</price>
<modifiers_group_id>2</modifiers_group_id>
</modifier>
<modifier id="4">
<name>Томатный</name>
<price>0.00</price>
<modifiers_group_id>2</modifiers_group_id>
</modifier>
<modifier id="5">
<name>Сливочный</name>
<price>0.00</price>
<modifiers_group_id>2</modifiers_group_id>
</modifier>
<modifier id="6">
<name>Джем брусничный</name>
<price>0.00</price>
<modifiers_group_id>3</modifiers_group_id>
</modifier>
<modifier id="7">
<name>Сметана</name>
<price>0.00</price>
<modifiers_group_id>3</modifiers_group_id>
</modifier>
</modifiers>
<!-- список категорий -->
<categories>
<!--
parent_id: id родительской категории
discount: true/false; true - на товары из категории действуют скидки
minimal_sum: true/false; true - товары из категории принимают участие в минимальной сумме заказа
sort: int - порядковый номер отображения (необязательный) -->
<category id="1" sort="1">Пицца</category>
<category id="2">Завтраки</category>
<category id="3" parent_id="2">Десерты</category>
<category id="4" discount="true" minimal_sum="false" sort="2">Напитки</category>
</categories>
<!-- описание меню -->
<items>
<!-- описание товара -->
<!-- id: идентификатор позиции, должен быть уникальным -->
<item id="1000">
<!-- название -->
<name>Пицца «Итальянская»</name>
<!-- идентификатор категории -->
<category_id>1</category_id>
<!-- описание -->
<description>Пепперони, салями, орегано, шампиньоны, маслины, моцарелла.</description>
<!-- список групп модификаторов по id -->
<modifiers_groups_ids>
<modifiers_group_id>1</modifiers_group_id>
<modifiers_group_id>2</modifiers_group_id>
</modifiers_groups_ids>
<!-- ссылка на изображение -->
<images>
<large>https://ru.foodsoul.pro/uploads/branches/5389/images/items/large/9302ef6317e3d18e10cf1ea0ee4a4dd5.jpg</large>
</images>
<!-- выбор вариантов размера -->
<parameters>
<parameter id="1">
<!-- цена -->
<price>375.00</price>
<!-- описание параметра -->
<description>23 см.</description>
<vendor_code>1010</vendor_code>
<!-- белки -->
<proteins>123</proteins>
<!-- жиры -->
<fats>123</fats>
<!-- углеводы -->
<carbohydrates>123</carbohydrates>
<!-- количество калорий -->
<calories>123</calories>
<!-- список групп модификаторов по id, опционально для каждого варианта -->
<modifiers_groups_ids>
<modifiers_group_id>1</modifiers_group_id>
<modifiers_group_id>2</modifiers_group_id>
</modifiers_groups_ids>
<!-- порядковый номер отображения (необязательный) -->
<sort>1</sort>
</parameter>
<parameter id="2">
<price>565.00</price>
<description>30 см.</description>
<vendor_code>2020</vendor_code>
<sort>2</sort>
</parameter>
<parameter id="3">
<price>675.00</price>
<description>35 см.</description>
</parameter>
</parameters>
<!-- список меток товара по id; добавляются в личном кабинете -->
<labels_ids>
<label_id>4713</label_id>
<label_id>4714</label_id>
</labels_ids>
<!-- порядковый номер отображения (необязательный) -->
<sort>1</sort>
</item>
<item id="10001">
<name>Блинчики с творогом и изюмом</name>
<category_id>3</category_id>
<description>Блинчики с начинкой из творога и изюма. Вес: 200 г.</description>
<modifiers_groups_ids>
<modifiers_group_id>3</modifiers_group_id>
</modifiers_groups_ids>
<labels_ids>
<label_id>4713</label_id>
<label_id>4714</label_id>
</labels_ids>
<images>
<large>https://ru.foodsoul.pro/uploads/branches/5389/images/items/large/bcfb1c6374013216af109a092ef2ad29.jpg</large>
</images>
<parameters>
<parameter id="6337974">
<price>150.00</price>
<description>2 шт.</description>
</parameter>
</parameters>
</item>
</items>
</shop>
</fs_catalog>
Для того, чтобы начать принимать заказы в свою CRM систему необходимо в личном кабинете в поле "Ссылка на API" указать адрес входной точки куда отправить заказ, после этого нажать на глазик находящийся справа от этого поля. После этих манипуляций все заказы будут дублироваться на этот адрес.
Так же перед тем как начать принимать заказы, Вам необходимо заполнить артикулы всех товаров и модификаторов. Артикул(Наша система) = ID/Артикул товара(Ваша система).
Пример входящих данных:
array(
'signature' => 'f5b47045b8886866725417165dd57795', // Сгенерированная подпись для проверки заказа
'body' => // Тело заказа
array(
'id' => 1, // Номер заказа в нашей системе
'order_number' => 2, // Номер заказа для вашего филиала
'date' => 'YYYY-MM-DD H:I:S', // Дата создания заказа
'date_preorder' => 'YYYY-MM-DD H:I:S', //Время предзаказа
'date_finish_order' => 'YYYY-MM-DD H:I:S', // Время осуществления заказа по вашему часовому поясу
'cart' => // Массив корзины
array(
'items' => // Товары
array(
0 =>
array( // Объект товара
'vendor_code' => 'myaso-002', // Артикул по которому Вы сможете проидентифицировать товар в своей системе
'name' => 'Мясное изобилие - 33 см.', // Текстовое название товара с описанием
'description' => '1 порц.', // Описание товара
'count' => '1', // Количество товара
'cost' => '555.00', // Стоимость
'settings' =>
array( // Настройки товара
'separate_export' => false, // Отдельный экспорт
'discount' => true, // Участвует в скидке
'free_delivery' => true, // Участвует в бесплатной доставке
'minimum_sum' => true, // Участвует в минимальной сумме
'modifiers_multiplier' => true, // Множитель модификаторов
'stock_balance' => false, // Учёт остатков
),
'offers' =>
array( // Акции/промокоды применённые к товару
0 => array( // Объект акции
'id' => '292084', // ID акции
'name' => 'Скидка -15% за самовывоз. Промокод: САМ15', // Название акции
'type' => 'percent_discount_on_all_order', // Тип акции
'promo' => array( // Промокод
'id' => '120651', // ID промокода
'code' => 'САМ15', // Код промокода
),
'discount' => array( // Скидка по акции
'amount' => '15.00', // Размер скидки
'type' => 'percent', // Тип скидки (percent/fixed)
'count' => 1, // Количество применений
'use_in_old_cost' => false, // Использовать в старой цене
'use_in_minimum_sum' => true, // Учитывать в минимальной сумме
),
'record_id' => 5626949, // ID записи
),
),
),
1 =>
array( // Объект товара
'vendor_code' => 'myaso-001', // Артикул по которому Вы сможете проидентифицировать товар в своей системе
'modifiers' =>
array( // Массив вложенных модификаторов к этому товару
0 =>
array( // Объект модификатора
'count' => '1', // Количество
'name' => 'Васаби', // Наименование модификатора
'vendor_code' => 'modifier-001', // Артикул по которому Вы сможете проидентифицировать товар в своей системе
'cost' => '30', // Стоимость
),
1 =>
array( // Объект модификатора
'count' => '1', // Количество
'name' => 'Помидоры', // Наименование модификатора
'vendor_code' => 'modifier-002', // Артикул модификатора
'cost' => '50', // Стоимость
),
2 =>
array( // Объект модификатора
'count' => '1', // Количество
'name' => 'Перец болгарский', // Наименование модификатора
'vendor_code' => 'modifier-003', // Артикул модификатора
'cost' => '50', // Стоимость
),
),
'name' => 'Мясное изобилие - 45 см.', // Текстовое название товара
'count' => '3', // Количество товара
'cost' => '778.00', // Стоимость
),
2 =>
array( // Объект товара
'vendor_code' => 'myaso-001', // Артикул товара
'name' => 'Мясное изобилие - 45 см.', // Текстовое название товара
'count' => '1', // Количество товара
'cost' => '778.00', // Стоимость
),
),
'bonuses' => array( // Бонусы
'accrual' => array(
'sum' => 103, // Сумма начисления
),
),
'discount' => array( // Скидка
'total' => 275, // Общая сумма скидки
'cash' => 275, // Скидка деньгами
'bonuses' => 0, // Скидка бонусами
),
'delivery_fee' => '100.00' // стоимость доставки из настроек района,
'courier_fee' => '100.00' // стоимость доставки через автотизацию курьерской службы,
'service_fee' => '100.00' // сервисный сбор,
'promo_code' => 'Promo' // наименование промокода, примененного к корзине
),
'total' => '3855.00', // Общий итог
'sender_name' => 'John Doe', // Имя
'sender_phone' => '+1(123)456-67-89', // Телефон отправителя
'sender_email' => 'test@test.com', // Email
'authorization_phone' => '+1(123)456-67-89', // Телефон авторизации
'recipient_name' => 'John Doe', // Имя получателя
'recipient_phone' => '+1(123)456-67-89', // Телефон получателя
'operator_email' => 'test@yandex.ru', // Email оператора
'operator_phone' => '+1(123)456-67-89', // Телефон оператора
'pickup_address' => [ // Точка самовывоза при типе доставки - самовывоз
'id' => '7548', // Номер точки нас в системе
'name' => 'Наименование', // Наименование точки самовывоза
'address' => 'г. Севастополь, проспект Героев Сталинграда, 28а', // Адрес точки самовывоза
'latitude' => '44.5841845', // Широта
'longitude' => '33.4388047' // Долгота
],
'zone' => 'ru', // Код региона
'zip_code' => 123, // Код города
'city_name' => 'Киров', // Название города
'district_id' => '1234', // Код района
'district_name' => 'Ленинский', // Название района
'street' => 'Петрова', // Улица
'house' => '', // Номер дома
'building' => '', // Корпус
'entrance' => '', // Подъезд
'entrance_code' => '', // Код
'floor' => '', // Этаж
'apartment' => '3', // Квартира
'change' => '900', // Сдача со скольки
'persons' => '42', // Количество персон
'discount' => '', // Дисконтная карта
'comment' => 'Тест отмена', // Комментарий
'platform' => 'android', // Платформа поступления заказа android, ios, site, vk
'prepayment' => true, //Был ли заказ оплачен через приложение/сайт.
'payment_method' => 'online', //cash(Наличные), card_upon_receipt(Картой курьеру), online(Онлайн через приложение или сайт)
'payment_name' => 'Яндекс.Касса', //Через какую системы была произведена оплата
'delivery_method' => 'courier', //courier(Доставка курьером)/pickup(Самовывоз)
'greeting_card' => 'Text', // Текст на открытке,
'contactless_service' => true, // Бесконтактная доставка
'not_call_back' => true, // Не перезванивать,
'cutlery' => '2', // Количество столовых приборов
'expedited_delivery' => false // Ускоренная доставка
)
);
отдельные поля могут не приходить в запрос если они не были заполнены гостем при оформлении заказа.
Система будет ожидать номер заказа в ответе с Вашего сайта, если он не будет получен то запрос на создание заказа будет отправлен повторно, максимум 4 попытки. Следует быть к этому готовым.
В ответ необходимо вернуть актуальный номер заказа который был создан на Вашем сайте в формате json:
{ "order_id": "123456" }