Различия

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

--- external:procart:01_setup:03_procart_setting [2025/09/04 06:27] – [pro_cart_setting] Роман Назаров
+++ external:procart:01_setup:03_procart_setting [2026/02/03 11:22] (текущий) – [Настройки пользователя по умолчанию] Роман Назаров
@@ Строка 1: / Строка 1: @@
 ====== Общие настройки ProCart ======
+Админка доступна от версии ProCart 1.9.21.89. Все изменения вступят в силу только после сохранения настроек и перезапуска ProCart.
+===== Параметры локального сервера и подключения к r_keeper =====
+{{ :external:procart:01_setup:2026-02-02_18-01-20.png |}}
+  * **Адрес сервера** - 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".
+ Подробная статья про лицензирования XML-Save Order: [[external:zz_дополнительные_материалы:xml_save_order|почитать]].
+===== Параметры настройки шлюза доставки =====
+{{ :external:procart:01_setup:2026-02-03_14-05-24.png |}}
+  * **Список токенов подключения (каждый токен на отдельной строке)** - Список разрешенных токенов для подключения. \\ По умолчанию первый токен генерируется автоматически (при первом запуске модуля). Если с модулем ProCart будет работать несколько разных внешних систем, то рекомендуется для подключения каждой из них использовать отдельный токен. Новые токены записываются в файл с новой строки, строка начинается с символа "-". Значение токена должно соответствовать формату GUID. Для генерации значений новых токенов можно воспользоваться [[http://foxtools.ru/Guid|внешним сервисом]].
+  * **Задержка опроса r_keeper на предмет изменений в заказах (секунд)** - Периодичность опроса кассовой системы r_keeper на предмет изменений в заказах. Значение в секундах. Значение по умолчанию: 10. Рекомендуемые значения: 10-60
+  * **Включить проверку кодов блюд при создании заказа** - Данное значение стоит менять, только при понимании для чего это делается. Флаг для включения или отключения проверки блюд самим модулем в заказе при его создании или валидации. Если отключить, то неизвестные софту блюда будут интерпретироваться как обычное блюдо. При этом сам r_keeper вернет ошибку, если такого блюда действительно не существует. Значение по умолчанию: активно.
+  * **Заполнять теги для интернет платежей** - Тег-признак расчета для интернет платежей.По умолчанию "неактивно", при "неактивном" положении игнорирует теги "def_site_url_1187", "def_contact_1008". При "активном" положении берёт данные из полей запроса "site_url_1187", "contact_1008", если значение в запросе не указано берёт из конфига.[[https://wiki.carbis.ru/external/procart/02_procart_api#работа_с_тегами_интернет_продаж|подробнее тут]].
+  * **Адрес сайта (место расчётов)** - По умолчанию пустая поле. Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные  сайта
+  * **Контактные данные покупателя**  - По умолчанию пустая поле. Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные покупателя.
+===== Данные справочников r_keeper =====
+{{ :external:procart:01_setup:2026-02-03_14-08-53.png |}}
+**Код кассовой станции** - КОД кассовой станции от имени которой будут производиться все операции. Как правило, это код главной кассы на кассовом сервере.
+**Код стола для создания заказа** - КОД стола, на котором по умолчанию будут создаваться заказы. [[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#комментарии_к_блюду_в_заказе_открытый_модификатор|Подробнее тут]]
+**GUID расширенного свойства, для комментария** - Из данного поля текст будет попадать в указанное свойство. Настройка расширенного свойства описана [[external:procart:01_setup:01_rkeeper_settings#настройка_длинного_комментария|тут]].
+===== Настройки пользователя по умолчанию =====
+{{ :external:procart:01_setup:2026-02-03_14-14-50.png |}}
+**Логин** - Логин пользователя.По умолчанию - admin.
+**Пароль** - Пароль пользователя.По умолчанию - admin.
+**Важно! При удалении данных пользователя из файла конфига, дальнейшая настройка будет возможна, только в файле конфига. И доступ в веб версию панели администратора будет недоступен.**
+===== Логирование =====
+{{ :external:procart:01_setup:2026-02-03_14-14-50.png |}}
+**Уровень логирования 1-10** - Уровень логирования. Чем выше - тем подробнее. По умолчанию - 3. Возможные значения 1-10.
+**Срок хранения *.log файлов (дней)** - Срок хранения файлов логирования. Значение означает количество дней хранения. По умолчанию - 7. Возможные значения 1-30.
+==== Настройки в конфигурационном файле ====
+Второстепенный метод настройки, которым можно воспользоваться, если нет возможности воспользоваться админкой.
+<hidden>
 ProCart.yaml - файл конфигурации модуля, он содержит все необходимые настройки для работы модуля.
@@ Строка 12: / Строка 73: @@
   * log - параметры логирования
-===== r_keeper_midserver =====
+ **r_keeper_midserver**
 <code>
 # Параметры подключения к кассовому серверу r_keeper
@@ Строка 52: / Строка 113: @@
 Подробная статья про лицензирования XML-Save Order: [[external:zz_дополнительные_материалы:xml_save_order|почитать]]
-===== r_keeper_references =====
+ **r_keeper_references =====**
-<code>
 # Данные справочников r_keeper
 r_keeper_references:
@@ Строка 92: / Строка 152: @@
 **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** - КОД причины внесения предоплаты. [[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#скидки_суммовая_и_словарная|Подробнее тут]].
@@ Строка 100: / Строка 160: @@
 **open_modifier_code** - КОД свободного модификатора. Используется для добавления комментария к блюду [[https://wiki.carbis.ru/external/procart/02_procart_api#комментарии_к_блюду_в_заказе_открытый_модификатор|Подробнее тут]]
 **guid_commment** - GUID расширенного свойства, для комментария. Из поля comment текст будет попадать в указанное свойство. Настройка расширенного свойства описана [[external:procart:01_setup:01_rkeeper_settings#настройка_длинного_комментария|тут]].
-===== local_server =====
+**local_server**
 <code>
 # Параметры локального сервера
@@ Строка 116: / Строка 176: @@
   * **threads** - количество потоков обработки. Изменять не рекомендуется!
-===== pro_cart_setting =====
+**pro_cart_setting **
 <code>
 # Параметры настройки шлюза доставки
@@ Строка 139: / Строка 199: @@
   * **timeout_statepolling** - Периодичность опроса кассовой системы r_keeper на предмет изменений в заказах. Значение в секундах. Значение по умолчанию: 10. Рекомендуемые значения: 10-60
   * **enable_items_verification** - Данное значение стоит менять, только при понимании для чего это делается. Флаг для включения или отключения проверки блюд самим модулем в заказе при его создании или валидации. Если отключить, то неизвестные софту блюда будут интерпретироваться как обычное блюдо. При этом сам r_keeper вернет ошибку, если такого блюда действительно не существует. Значение по умолчанию: true. Допустимые значения: **true**, **false**.
-  * **use_internet_pay_tags** - Тег-признак расчета для интернет платежей.\\ По умолчанию "false", при указании "flase" игнорирует теги "def_site_url_1187", "def_contact_1008". При указании значения "true" берёт данные из полей запроса "site_url_1187", "contact_1008", если значение в запросе не указано берёт из конфига.[[https://wiki.carbis.ru/external/procart/02_procart_api#Работа с тегами интернет продаж|Подробнее тут]].
+  * **use_internet_pay_tags** - Тег-признак расчета для интернет платежей.\\ По умолчанию "false", при указании "flase" игнорирует теги "def_site_url_1187", "def_contact_1008". При указании значения "true" берёт данные из полей запроса "site_url_1187", "contact_1008", если значение в запросе не указано берёт из конфига.[[https://wiki.carbis.ru/external/procart/02_procart_api#работа_с_тегами_интернет_продаж|подробнее тут]].
   * **def_site_url_1187** - Адрес сайта (место расчётов). \\ По умолчанию пустая строка (""). Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные  сайта
   * **def_contact_1008''**  - Контактные данные покупателя, \\ По умолчанию пустая строка (""). Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные покупателя
-===== log =====
+** log **
 <code>
 log:
@@ Строка 155: / Строка 215: @@
   * **retention_days** - Срок хранения *.log файлов (дней). По умолчанию - 7.  Возможные значения 1-30.
+<code>
+# Пользователь по умолчанию
+user:
+  # Логин (str)
+  login: admin
+  # Пароль (str)
+  password: admin
+</code>
+  * **login** - Логин пользователя.По умолчанию - admin.
+  * **password** - Пароль пользователя.По умолчанию - admin.
+ **Важно! При удалении данных пользователя из файла конфига, дальнейшая настройка будет возможна, только в файле конфига. И доступ в веб версию панели администратора будет недоступен.**
+</hidden>