Различия

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

--- external:procart:01_setup:03_procart_setting [2022/09/29 06:54] – [r_keeper_midserver] Александр Ильин
+++ external:procart:01_setup:03_procart_setting [2024/11/21 13:52] (текущий) – Евгений Горносталь
@@ Строка 33: / Строка 33: @@
   * **password** - пароль пользователя для доступа к xml-интерфейсу (цифры и латиница, регистр важен)
   * **use_saas** - Значение зависит от того, какая лицензия на XML будет использоваться для работы. Если SaaS (подписка), то **true**, если lifetime (XML WriteOrder) - **false** \\ Если "use_saas=true", то необходимо произвести дополнительные настройки, необходимые для работы с XML SaaS, запустив файл "saas_settings.bat".
+Если настройка saas-xml лицензии произведена успешно, в корневой папке с файлами ProCart появится файл с расширением .saasdata
+Его примерное содержание должно быть:
+<code>
+{
+  "seq_number": -1,
+  "produrct_guid": "655cee55-7bcd-4826-b6e0-a8ccf2017ef3",
+  "usr": "YWxrLW922HlhLnJ1OzQ0MWZmY2UzMjk0OWZkZTg2NGUxNDk0M2FkNWNmYzI1Ozc0NWZkYTk4MDA0ZjEzM2QyZWRlMjRkNTI4ODQ2N2Nl"
+}
+</code>
+Если файл не появился вообще или в нём нет параметров "produrct_guid", "usr" - настройка неудачна, см. лог.
+В случае появления в логе ошибки ErrorText="Инстанс лицензии не найден", следует запустить файл change_license_instance.bat.
+Подробная статья про лицензирования XML-Save Order: [[external:zz_дополнительные_материалы:xml_save_order|почитать]]
 ===== r_keeper_references =====
@@ Строка 41: / Строка 59: @@
   cash_station: 1
   # Код стола для создания закаов (int)
+r_keeper_references:
+  # Код кассовой станции (int)
+  cash_station: 1
+  # Код стола для создания заказов (int)
   table: 1
   # Код категории заказа Если не передан в запросе будет использоваться по стандарту который указан в файле конфигурации, используется для подсчёта стоимости блюд (int)
@@ Строка 46: / Строка 68: @@
   # Код классификации блюд для выгрузки меню (int)
   menu_classification: 1
-  # Код причины внесения/выдачи денег для принятия онлайн платежа как предоплаты (int)
+   # Код суммовой скидки Скидка 'на заказ' c изменяемым значением (int)
-  payment_reason: 1
-  # Код суммовой скидки Скидка 'на заказ' c изменяемым значением (int)
   sum_discount: 1
+  # Код суммовой наценки Наценка 'на заказ' c изменяемым значением (int)
+  sum_markup: 1
+  # Код интерфейса для применения карты (int)
+  interface: 1
+  # Закрывать сбалансированный заказ (bool)
+  close_paid_order: false
+  # Код кассира от которого будет происходить оплата заказа (int)
+  cashier_code: 1
+  # Код учётной записи менеджера для удаления заказ (int)
+  manager_code: 1
+  # Код причины удаления заказа (int)
+  delete_reason: 1
+  # Код свободного модификатора для добавления комментария к блюду (int)
+  open_modifier_code: 1
+  # GUID расширенного свойства в заказе для комментария Необязательный параметр. GUID указывать без фигурных скобок (str)
+  guid_commment: ''
 </code>
 **cash_station** - КОД кассовой станции от имени которой будут производиться все операции. Как правило, это код главной кассы на кассовом сервере.
-**table** - КОД стола, на котором по умолчанию будут создаваться заказы. В запросе **/postorder** внешняя система может передать код другого стола (существующего в справочниках), и тогда заказ будет создан на указанном столе. Если этот параметр не передается из внешней системы - заказ будет создан на столе "по умолчанию".
+**table** - КОД стола, на котором по умолчанию будут создаваться заказы. [[https://wiki.carbis.ru/external/procart/02_procart_api#работа_со_столами|Подробнее тут]].
 **order_category** - КОД категории заказа используемой по умолчанию. [[https://wiki.carbis.ru/external/procart/02_procart_api#категория_заказа|Подробнее тут]].
-**menu_classification** - КОД классификации по которой ведется выборка блюд из r_keeper/ [[https://wiki.carbis.ru/external/procart/02_procart_api#классификации_блюд|Подробнее тут]].
+**menu_classification** - КОД классификации по которой ведется выборка блюд из r_keeper. [[https://wiki.carbis.ru/external/procart/02_procart_api#классификации_блюд|Подробнее тут]].
 **payment_reason** - КОД причины внесения предоплаты. [[https://wiki.carbis.ru/external/procart/02_procart_api#заказы_с_оплатой|Подробнее тут]].
-**sum_discount** - КОД суммовой скидки. Используется для передачи в систему произвольной скидки, сумма которой рассчитывается на стороне внешней системы. [[https://wiki.carbis.ru/external/procart/02_procart_api#скидки_суммовая_и_словарная|Подробнее тут]].
+**sum_discount** - КОД суммовой скидки. Используется для передачи в систему произвольной скидки, сумма которой рассчитывается на стороне внешней системы.
+[[https://wiki.carbis.ru/external/procart/02_procart_api#скидки_суммовая_и_словарная|Подробнее тут]].
+**sum_maprkup** - КОД суммовой наценки. Используется для передачи в систему произвольной наценки, сумма которой рассчитывается на стороне внешней системы.
+[[https://wiki.carbis.ru/external/procart/02_procart_api#наценка_суммовая|Подробнее тут]].
+**open_modifier_code** - КОД свободного модификатора. Используется для добавления комментария к блюду [[https://wiki.carbis.ru/external/procart/02_procart_api#комментарии_к_блюду_в_заказе_открытый_модификатор|Подробнее тут]]
+**guid_commment** - GUID расширенного свойства, для комментария. Из поля comment текст будет попадать в указанное поле. [[https://docs.rkeeper.ru/rk7/latest/ru/spravochnik-rasshirennye-svojstva-4038453.html|Подробнее тут]]
 ===== local_server =====
 <code>
@@ Строка 84: / Строка 126: @@
   # Задержка опроса r_keeper на предмет изменений в заказах (секунд) (int)
   timeout_statepolling: 10
+  # Включить проверку кодов блюд при создании заказа По умолчанию True (включено). Если выключить, то модуль неизвестные коды блюд будет интерпретировать как обычное блюдо. (bool)
+  enable_items_verification: true
 </code>
   * **token_list** - Список разрешенных токенов для подключения. \\ По умолчанию первый токен генерируется автоматически (при первом запуске модуля). Если с модулем ProCart будет работать несколько разных внешних систем, то рекомендуется для подключения каждой из них использовать отдельный токен. Новые токены записываются в файл с новой строки, строка начинается с символа "-". Значение токена должно соответствовать формату GUID. Для генерации значений новых токенов можно воспользоваться [[http://foxtools.ru/Guid|внешним сервисом]].
   * **timeout_statepolling** - Периодичность опроса кассовой системы r_keeper на предмет изменений в заказах. Значение в секундах. Значение по умолчанию: 10. Рекомендуемые значения: 10-60
+  * **enable_items_verification** - Данное значение стоит менять, только при понимании для чего это делается. Флаг для включения или отключения проверки блюд самим модулем в заказе при его создании или валидации. Если отключить, то неизвестные софту блюда будут интерпретироваться как обычное блюдо. При этом сам r_keeper вернет ошибку, если такого блюда действительно не существует. Значение по умолчанию: true. Допустимые значения: **true**, **false**.