Различия

Показаны различия между двумя версиями страницы.

--- external:procart:01_setup:01_rkeeper_settings [2023/01/23 11:17] – ↷ Имя страницы external:procart:01_setup:02_rkeeper_settings изменено на external:procart:01_setup:01_rkeeper_settings Алексей Коробов
+++ external:procart:01_setup:01_rkeeper_settings [2025/07/08 06:36] (текущий) – Евгений Горносталь
@@ Строка 24: / Строка 24: @@
+==== Валюта для оплаты бонусами ====
+Со стороны внешней системы может приходить оплата (предоплата) заказа, в том числе бонусами.
+В справочнике "валюты" нужно добавить нефискальную валюту для оплаты бонусами.
+Тип фискальности для этой валюты - "фискальная скидка".
+Галку "без сдачи" не ставим, иначе касса не даст внести предоплату этой валютой.
+{{:external:procart:01_setup:pasted:20230202-172557.png}}
@@ Строка 39: / Строка 47: @@
 Распределите блюда меню по категориям для созданной вами классификации.
 {{:external:procart:01_setup:pasted:20220922-064529.png}}
+**Важно!** Для всех блюд, на которые ссылаются комбо-компоненты, необходимо указать категорию, обеспечивающую доступность этого элемента. Т. е. любую категорию из классификации для ProCart.
 ----
 ==== Причина внесения ====
-Для настройки модуля нужен код причины внесения денег. Этот параметр отвечает за внесение оплат при создании заказа с оплатами.
+Начиная с версии 1.5.7.38 причина внесения денег более не используется.
+Предоплаты передаются без причины внесения, так работает при значении параметра "Учет предоплат" = "Не учитывать".
+Убедитесь, что для стола (столов), на которые создаются заказы, настроено исключение параметра  "Учет предоплат" = "Не учитывать".
-Перед созданием причины внесения денег нужно добавить:
-) Блюдо, на которое будет ссылаться наценка.
-) Нераспределяемую суммовую наценку для предоплаты.
-Перейдите в справочник "Деньги -> Причины внесения/выдачи денег", выберете нужную причину и в поле "Код" будет значение которое нужно будет указать в файле конфигурации модуля.
-{{:external:procart:01_setup:pasted:20220921-050836.png}}
-----
 ==== Суммовая скидка на заказ с изменяемым значением ====
 Для внесения суммовой скидки в заказ при работе модуля нужно создать суммовую скидку "на заказ". Перейдите в справочник "Деньги -> Скидки и наценки", создайте новую скидку, укажите для неё параметры указанные на скриншоте
 {{:external:procart:01_setup:pasted:20230117-090000.png}}
+  * Тип - сумма
+  * Изменяемое значение - ✔
+  * Название - можете использовать своё название
+  * Статус - Активный
+  * Не вручную  - ✔
+Значение из поля "Код" понадобится далее при настройке модуля.
+==== Суммовая наценка на заказ с изменяемым значением ====
+Для внесения суммовой наценки в заказ при работе модуля нужно создать суммовую наценку "на заказ". Необходимо перейти  в справочник "Деньги -> Скидки и наценки", создайте новую наценку, указать для неё параметры указанные на скриншоте
+{{:external:procart:01_setup:2024-11-21_17-56-56.png}}
   * Тип - сумма
   * Изменяемое значение - ✔
@@ Строка 64: / Строка 78: @@
 ProCart может передать уже оплаченный заказ.
 В этом случае для фиксации оплаты в r_keeper будет использоваться механизм предоплат.
-**Необходимо настроить прием нефискальных предоплат с помощью нефискальной валюты и причины внесения денег с нефискальным зачетом аванса.**
+API ProCart позволяет передавать в заказ предоплату любой валютой (в запросе передаётся код валюты).
 С целью минимизации рисков для ресторана в случае неправильной настройки предоплат необходимо доверить выполнение этого пункта квалифицированному специалисту по r_keeper.
-Статья, описывающую настройку предоплат для такого случая: [[external:zz_дополнительные_материалы:03_predoplaty|Настройка предоплат]]
+**Важно!** Значение параметра "учет предоплат" обязательно должно быть = "Не учитывать" для всех столов, на которые передаются оплаты из ProCart.
 **Может потребоваться дилерская учетная запись для настройки фискальности валют.**
@@ Строка 137: / Строка 152: @@
 Также опционально можно использовать макет "Кнопки с заказами (обычные)": https://disk.yandex.ru/d/TiW-MxSifCEosA
 По умолчанию, если не исправлять -  на этой кнопке будет только номер заказа.
+===== Настройка общего (текстового) модификатора для комментариев к блюду (опционально) =====
+**С версии 1.5.0.30**
+Чтобы через API можно было оставлять текстовые комментарии к блюдам, необходимо создать общий модификатор.
+Меню - Модификаторы
+  - Создать группу модификаторов
+  - В свойствах группы, в блоке "Основное" проставить галочку "Общий модификатор"
+  - В группе создать модификатор
+  - В свойствах модификатора:
+      - В блоке "Интерфейс" проставить галочку "Ввод имени"
+      - В блоке "Цены" ввести 0 в поле "Основная"
+{{:external:procart:01_setup:pasted:20230518-084024.png}}
+{{:external:procart:01_setup:pasted:20230518-084354.png}}
+**Код данного модификатора понадобится при настройке ProCart.**
+===== Настройка длинного комментария =====
+Для передачи длинного текстового комментария из внешней системы требуется дополнительно создать и настроить расширенное свойство.
+Для создания свойства нужно:
+  * перейти в Настройки → Настройка → Расширенные свойства
+  * В разделе свойства для заказов создать новое свойство с подходящим названием, а так же задать системное имя
+  * Установить активный статус
+{{:external:procart:01_setup:2025-07-08_10-26-12.png}}
+**GUID расширенного свойства понадобится при настройке ProCart.**