Различия

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

--- external:procart:02_procart_api [2022/09/29 06:51] – [Скидки (суммовая и словарная)] Александр Ильин
+++ external:procart:02_procart_api [2025/09/04 10:25] (текущий) – Евгений Горносталь
@@ Строка 72: / Строка 72: @@
 ===== Комментарии к заказу =====
 В системе r_keeper у заказов есть свойство, которое можно использовать для хранения дополнительной текстовой информации (комментария к заказу), но к сожалению, длина этого поля крайне мала (30-100 символов) и зачастую вся необходимая доп. информация по заказу туда не помещается.
-В рамках ProCart эта проблема решена следующим образом: В запросе **/postorder** внешняя система может передать текстовый комментарий.
+В рамках ProCart проблема длинных комментариев решена следующим образом: В запросе **/postorder** внешняя система может передать текстовый комментарий (поле "comment").
 Он будет сохранен в локальной базе ProCart и связан с реальным заказом в системе r_keeper.
-В печатных формах системы r_keeper (сервис-чек, пречек, чек) можно добавить небольшой скрипт, который при помощи служебного метода **/print_info** будет получать комментарий по конкретному заказу из БД ProCart и выводить его на печать.
+В печатных формах системы r_keeper (сервис-чек, пречек, чек) можно добавить небольшой скрипт, который при помощи служебного метода **/internal/print_info** будет получать комментарий по конкретному заказу из БД ProCart и выводить его на печать.
+Так же в запросе **/postorder** есть поле "short_external_info", куда можно передать краткую информацию о заказе (идентификатор заказа во внешней системе, тел или ФИО гостя и т.п.)
+Этот комментарий (30 символов) будет виден персоналу на экране кассы r_keeper (в списке заказов) и может помочь быстрее сориентироваться и найти нужный заказ.
+===== Комментарии к блюду в заказе (открытый модификатор) =====
+**С версии 1.5.0.30**
+В рамках ProCart к блюду может быть прикреплен комментарий. Для этого в запросе **/postorder**, для элемента меню, можно передать комментарий в поле "item_comment". Данный комментарий будет виден персоналу на экране кассы, как модификатор для блюда.
+Данный комментарий, имеет ограничение на длину от 1 до 255 символов.
+**Важно!** [[https://wiki.carbis.ru/external/procart/01_setup/01_rkeeper_settings#настройка_общего_текстового_модификатора_для_комментариев_к_блюду_опционально|Требуется дополнительная настройка в r_keeper]]
 ===== Заказы с оплатой =====
 Через систему **ProCart** можно создать в **r_keeper** заказ в котором есть только блюда (нет оплат) и далее этот заказ будет рассчитан сотрудником на кассе как обычно.
@@ Строка 91: / Строка 99: @@
 Также поддержана работа с автоматическими скидками кассы r_keeper. Если в ресторане используются какие-то автоматические скидки по определенным правилам, и заказ сделанный внешней системой удовлетворяет этим условиям, то запросы **/validate** и **/postorder** вернут содержимое заказа с учетом автоматических скидок.
+===== Наценка суммовая =====
+Модуль **ProCart** поддерживает работу с наценками, от версии ProCart 1.9.1.64.
+Для суммовой наценки поддержана работа с произвольной (суммовыми) наценкой. В данном сценарии сумма наценки и правила ее применения находятся на стороне внешней системы, в запросах **/validate** и **/postorder** передается итоговая сумма наценки, рассчитанная внешней системой.
+Пример того, как в запросе в поле "discount" можно передать одновременно Скидку словарную (Ref), Скидку суммовую(Sum) и Наценку суммовую(MARKUPSUM):
+<code>
+"discounts": [
+     {
+        'type': 'REF',
+        'code': 10,
+        },
+    {
+          "type":"SUM",
+          "sum": 120,
+          "code": 1137
+      },
+    {
+          "type":"MARKUPSUM",
+          "sum": 40,
+          "code": 1143
+      }
+  ]
+</code>
 ===== Поддержка стоп-листов и ограниченных блюд =====
@@ Строка 102: / Строка 136: @@
 Когда заказ создан в кассовой системе, автоматически происходит сервис печать (по настройкам r_keeper). Этот механизм можно дополнительно задействовать для уведомления персонала, если в используемую схему печати добавить еще одно правило, согласно которому, все заказы полученные из внешней системы будут печататься по отдельному макету сервис-печати на выделенный принтер.
+===== Описание блюда =====
+Описание блюда передаётся при запросе меню. Логика этого поля имеет постоянное свойство и дополнительно не настраивается. В приоритете в ProCart поле "description"(описание блюда) заполняется значение из поля "Комментарий" из карточки блюда в r_keeper, если это поле пустое, то заполняется из поля "Рецепт". Если на стороне r_keeper оба поля не заполнены, то и в  ProCart в поле "description" будет пустым.
+<hidden>
+Пример поля на стороне Procart:
+{{ :external:procart:2025-03-28_12-33-07_2_.png |}}
+Пример передаваемых полей на стороне r_keeper (приоритет у поля "Комментарий")
+{{ :external:procart:2025-03-28_12-35-43_2_.png |}}
+</hidden>
+===== Работа с тегами интернет продаж =====
+В связи с изменением от 1 сентября 2025 года ФНС вводит обновленный формат фискальных данных (ФФД 1.2) — Приказ ФНС России от 26.03.2025 № ЕД-7-20/236@. [[https://www.nalog.gov.ru/rn77/about_fts/docs/16421640/|Подробнее об изменениях]] внесена доработка. От версии ProCart v1.9.4.64 в файл конфигурации добавлены новые параметры. (Данные параметры являются необязательными).
+Параметры:
+**use_internet_pay_tags** — новый реквизит — Признак расчета в «Интернет» (true — если покупатель оплатил заказ через интернет).
+**def_site_url_1187** — адрес сайта (в реквизите «Место расчетов»).
+**def_contact_1008** — контактные данные покупателя (телефон или email).
+При выполнении запроса **/postorder** если переданы  параметры **site_url_1187** и **contact_1008** (данные параметры являются необязательными), то они имеют преимущество над соответствующими полями заполненными в файле конфигурации.
+Формат полей в запросе:
+<code>
+"site_url_1187": "wiki.carbis.ru",
+"contact_1008": "mail@mail.ru",
+</code>