Различия

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

--- external:procart:01_setup:03_procart_setting [2026/02/03 11:20] – [Параметры настройки шлюза доставки] Роман Назаров
+++ external:procart:01_setup:03_procart_setting [2026/09/29 07:41] (текущий) – Евгений Горносталь
@@ Строка 6: / Строка 6: @@
 {{ :external:procart:01_setup:2026-02-02_18-01-20.png |}}
+<hidden>
   * **Адрес сервера** - ip адрес компьютера на котором работает кассовый сервер
   * **Порт сервера** - http data port из конфигурации r_keeper [[https://wiki.carbis.ru/external/zz_дополнительные_материалы/02_xml_interfaсe_rkeeper#настройка_http_xml_интерфейса_кассового_сервера_или_кассы|Где найти]]
   * **Логин пользователя** - логин пользователя для доступа к xml-интерфейсу (цифры и латиница, регистр важен)
   * **Пароль пользователя** - пароль пользователя для доступа к xml-интерфейсу (цифры и латиница, регистр важен)
-  * **Использовать SaaS XML для подключения к rk7** - Положение тригера зависит от того, какая лицензия на XML будет использоваться для работы. Если SaaS (подписка), то **активен**, если lifetime (XML WriteOrder) - **неактивен**. \\ Если "Использовать SaaS XML для подключения к rk7" активна, то необходимо произвести дополнительные настройки, необходимые для работы с XML SaaS, запустив файл "saas_settings.bat".
+</hidden>
+===== Настройка типа лицензии XML-создания заказа =====
+От версии ProCart v1.9.30.100 настройка применения XML-создания заказа доступна в админке.
  Подробная статья про лицензирования XML-Save Order: [[external:zz_дополнительные_материалы:xml_save_order|почитать]].
+<hidden>
+Если для создания заказов используется лицензия на XML Save Order (LifeTime), то ее настройка производится в r_keeper и данный пункт настраивать не требуется.
+Если же для работы используется «XML-интерфейс для приложения», то необходимо включить данный раздел и произвести его настройку.
+В общем виде настройка будет иметь последовательность:
+. Изменить тип лицензии на "R-keeper модуль XML-интерфейс для приложения"
+. Указать логин и пароль от личного кабинета R-keeper
+. Выбрать период лицензии
+. Нажать "Сохранить параметры подключения"
+. Нажать "Перегенерировать instace"
+* Окно информации о лицензии загорится зелёным цветом, если все настройки выполнены правильно. В самом окне появятся данные о лицензии. (Пример см. на картинке ниже).
+{{ :external:procart:01_setup:2026-09-29_07-01-43.png |}}
+</hidden>
 ===== Параметры настройки шлюза доставки =====
 {{ :external:procart:01_setup:2026-02-03_14-05-24.png |}}
+<hidden>
   * **Список токенов подключения (каждый токен на отдельной строке)** - Список разрешенных токенов для подключения. \\ По умолчанию первый токен генерируется автоматически (при первом запуске модуля). Если с модулем ProCart будет работать несколько разных внешних систем, то рекомендуется для подключения каждой из них использовать отдельный токен. Новые токены записываются в файл с новой строки, строка начинается с символа "-". Значение токена должно соответствовать формату GUID. Для генерации значений новых токенов можно воспользоваться [[http://foxtools.ru/Guid|внешним сервисом]].
   * **Задержка опроса r_keeper на предмет изменений в заказах (секунд)** - Периодичность опроса кассовой системы r_keeper на предмет изменений в заказах. Значение в секундах. Значение по умолчанию: 10. Рекомендуемые значения: 10-60
@@ Строка 24: / Строка 42: @@
   * **Адрес сайта (место расчётов)** - По умолчанию пустая поле. Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные  сайта
   * **Контактные данные покупателя**  - По умолчанию пустая поле. Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные покупателя.
+</hidden>
 ===== Данные справочников r_keeper =====
-{{ :external:procart:01_setup:2026-02-03_14-08-53.png |}}
+{{:external:procart:01_setup:2026-07-14_11-51-04.png}}
+<hidden>
 **Код кассовой станции** - КОД кассовой станции от имени которой будут производиться все операции. Как правило, это код главной кассы на кассовом сервере.
 **Код стола для создания заказа** - КОД стола, на котором по умолчанию будут создаваться заказы. [[https://wiki.carbis.ru/external/procart/02_procart_api#работа_со_столами|Подробнее тут]].
 **Код категории заказа** - КОД категории заказа используемой по умолчанию. [[https://wiki.carbis.ru/external/procart/02_procart_api#категория_заказа|Подробнее тут]].
 **Код классификации блюд для выгрузки меню** - КОД классификации по которой ведется выборка блюд из r_keeper. [[https://wiki.carbis.ru/external/procart/02_procart_api#классификации_блюд|Подробнее тут]].
-**Код суммовой скидки "Скидка на заказ" с изменяемыми значениями** - КОД суммовой скидки. Используется для передачи в систему произвольной скидки, сумма которой рассчитывается на стороне внешней системы.
+**Код суммовой скидки "Скидка на заказ" с изменяемыми значениями** - КОД суммовой скидки. Используется для передачи в систему произвольной скидки, сумма которой рассчитывается на стороне внешней системы. [[https://wiki.carbis.ru/external/procart/02_procart_api#скидки_суммовая_и_словарная|Подробнее тут]].
-[[https://wiki.carbis.ru/external/procart/02_procart_api#скидки_суммовая_и_словарная|Подробнее тут]].
+**Код суммовой наценки"Скидка на заказ" с изменяемыми значениями** - КОД суммовой наценки. Используется для передачи в систему произвольной наценки, сумма которой рассчитывается на стороне внешней системы. [[https://wiki.carbis.ru/external/procart/02_procart_api#наценка_суммовая|Подробнее тут]].
-**Код суммовой наценки"Скидка на заказ" с изменяемыми значениями** - КОД суммовой наценки. Используется для передачи в систему произвольной наценки, сумма которой рассчитывается на стороне внешней системы.
-[[https://wiki.carbis.ru/external/procart/02_procart_api#наценка_суммовая|Подробнее тут]].
 **Код интерфейса для применения карты**- КОД предназначен для применения карт лояльности.
 **Закрывать сбалансированный заказ**- Если селектор не активен заказы сохраняются в статусе черновика. При активном положении селектора заказы будут закрываться, как оплаченные.
@@ Строка 44: / Строка 60: @@
 **Код свободного модификатора для для добавления комментария к блюду** - КОД свободного модификатора. Используется для добавления комментария к блюду [[https://wiki.carbis.ru/external/procart/02_procart_api#комментарии_к_блюду_в_заказе_открытый_модификатор|Подробнее тут]]
 **GUID расширенного свойства, для комментария** - Из данного поля текст будет попадать в указанное свойство. Настройка расширенного свойства описана [[external:procart:01_setup:01_rkeeper_settings#настройка_длинного_комментария|тут]].
+**Использовать причину внесения предоплат** - данное поле определяет будет ли использоваться параметр "Причина внесения предоплат"
+**Код причины внесения** - КОД указываемой причины для внесения предоплат.
+</hidden>
 ===== Настройки пользователя по умолчанию =====
 {{ :external:procart:01_setup:2026-02-03_14-14-50.png |}}
+<hidden>
-**Логин**- Логин пользователя.По умолчанию - admin.
+**Логин** - Логин пользователя.По умолчанию - admin.
-**Пароль**- Пароль пользователя.По умолчанию - admin.
+**Пароль** - Пароль пользователя.По умолчанию - admin.
 **Важно! При удалении данных пользователя из файла конфига, дальнейшая настройка будет возможна, только в файле конфига. И доступ в веб версию панели администратора будет недоступен.**
+</hidden>
 ===== Логирование =====
 {{ :external:procart:01_setup:2026-02-03_14-14-50.png |}}
+<hidden>
 **Уровень логирования 1-10** - Уровень логирования. Чем выше - тем подробнее. По умолчанию - 3. Возможные значения 1-10.
 **Срок хранения *.log файлов (дней)** - Срок хранения файлов логирования. Значение означает количество дней хранения. По умолчанию - 7. Возможные значения 1-30.
+</hidden>
 ==== Настройки в конфигурационном файле ====
@@ Строка 148: / Строка 167: @@
   # GUID расширенного свойства в заказе для комментария Необязательный параметр. GUID указывать без фигурных скобок (str)
   guid_commment: ''
+  # Использование причины внесения предоплат (int)
+  payment_reason_option: 0
+  # Код причины внесения предоплат (int)
+  payment_reason_code: 2
 </code>
@@ Строка 154: / Строка 177: @@
 **order_category** - КОД категории заказа используемой по умолчанию. [[https://wiki.carbis.ru/external/procart/02_procart_api#категория_заказа|Подробнее тут]].
 **menu_classification** - КОД классификации по которой ведется выборка блюд из r_keeper. [[https://wiki.carbis.ru/external/procart/02_procart_api#классификации_блюд|Подробнее тут]].
-**payment_reason** - Код причины внесения предоплаты.**Параметр убран из настроек от версии ProCart v1.5.7.38**.
 **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 текст будет попадать в указанное свойство. Настройка расширенного свойства описана [[external:procart:01_setup:01_rkeeper_settings#настройка_длинного_комментария|тут]].
+**  payment_reason_option** - КОД использования причины внесения предоплат. Имеет значения **0** и **1**, где **0** - это не использовать причину внесения предоплат, а **1**- использовать причину внесения, предоплат
+**payment_reason** - КОД причины внесения предоплаты.
 **local_server**
 <code>