Общие настройки ProCart

• Адрес сервера - ip адрес компьютера на котором работает кассовый сервер
• Порт сервера - http data port из конфигурации r_keeper Где найти
• Логин пользователя - логин пользователя для доступа к xml-интерфейсу (цифры и латиница, регистр важен)
• Пароль пользователя - пароль пользователя для доступа к xml-интерфейсу (цифры и латиница, регистр важен)

Если для создания заказов используется лицензия на XML Save Order (LifeTime), то ее настройка производится в r_keeper и данный пункт настраивать не требуется.
Если же для работы используется «XML-интерфейс для приложения», то необходимо включить данный раздел и произвести его настройку.

В общем виде настройка будет иметь последовательность:
1. Изменить тип лицензии на «R-keeper модуль XML-интерфейс для приложения»
2. Указать логин и пароль от личного кабинета R-keeper
3. Выбрать период лицензии
4. Нажать «Сохранить параметры подключения»
5. Нажать «Перегенерировать instace»
* Окно информации о лицензии загорится зелёным цветом, если все настройки выполнены правильно. В самом окне появятся данные о лицензии. (Пример см. на картинке ниже).

• Список токенов подключения (каждый токен на отдельной строке) - Список разрешенных токенов для подключения.
  По умолчанию первый токен генерируется автоматически (при первом запуске модуля). Если с модулем ProCart будет работать несколько разных внешних систем, то рекомендуется для подключения каждой из них использовать отдельный токен. Новые токены записываются в файл с новой строки, строка начинается с символа «-». Значение токена должно соответствовать формату GUID. Для генерации значений новых токенов можно воспользоваться внешним сервисом.
• Задержка опроса r_keeper на предмет изменений в заказах (секунд) - Периодичность опроса кассовой системы r_keeper на предмет изменений в заказах. Значение в секундах. Значение по умолчанию: 10. Рекомендуемые значения: 10-60
• Включить проверку кодов блюд при создании заказа - Данное значение стоит менять, только при понимании для чего это делается. Флаг для включения или отключения проверки блюд самим модулем в заказе при его создании или валидации. Если отключить, то неизвестные софту блюда будут интерпретироваться как обычное блюдо. При этом сам r_keeper вернет ошибку, если такого блюда действительно не существует. Значение по умолчанию: активно.
• Заполнять теги для интернет платежей - Тег-признак расчета для интернет платежей.По умолчанию «неактивно», при «неактивном» положении игнорирует теги «def_site_url_1187», «def_contact_1008». При «активном» положении берёт данные из полей запроса «site_url_1187», «contact_1008», если значение в запросе не указано берёт из конфига.подробнее тут.
• Адрес сайта (место расчётов) - По умолчанию пустая поле. Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные сайта
• Контактные данные покупателя - По умолчанию пустая поле. Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные покупателя.

Код кассовой станции - КОД кассовой станции от имени которой будут производиться все операции. Как правило, это код главной кассы на кассовом сервере.
Код стола для создания заказа - КОД стола, на котором по умолчанию будут создаваться заказы. Подробнее тут.
Код категории заказа - КОД категории заказа используемой по умолчанию. Подробнее тут.
Код классификации блюд для выгрузки меню - КОД классификации по которой ведется выборка блюд из r_keeper. Подробнее тут.
Код суммовой скидки «Скидка на заказ» с изменяемыми значениями - КОД суммовой скидки. Используется для передачи в систему произвольной скидки, сумма которой рассчитывается на стороне внешней системы. Подробнее тут.
Код суммовой наценки«Скидка на заказ» с изменяемыми значениями - КОД суммовой наценки. Используется для передачи в систему произвольной наценки, сумма которой рассчитывается на стороне внешней системы. Подробнее тут.
Код интерфейса для применения карты- КОД предназначен для применения карт лояльности.
Закрывать сбалансированный заказ- Если селектор не активен заказы сохраняются в статусе черновика. При активном положении селектора заказы будут закрываться, как оплаченные.
Код учётной записи кассира от которого будет происходить оплата заказа- КОД учетной записи кассира, используется для закрытия заказа.
Код учётной записи менеджера для удаления заказа- КОД учетной записи менеджера от которой будет вестись удаления заказа.
Код причины для удаления заказа- КОД указываемой причины для удаления заказа.
Код свободного модификатора для для добавления комментария к блюду - КОД свободного модификатора. Используется для добавления комментария к блюду Подробнее тут
GUID расширенного свойства, для комментария - Из данного поля текст будет попадать в указанное свойство. Настройка расширенного свойства описана тут.
Использовать причину внесения предоплат - данное поле определяет будет ли использоваться параметр «Причина внесения предоплат»
Код причины внесения - КОД указываемой причины для внесения предоплат.

Логин - Логин пользователя.По умолчанию - admin.
Пароль - Пароль пользователя.По умолчанию - admin.
Важно! При удалении данных пользователя из файла конфига, дальнейшая настройка будет возможна, только в файле конфига. И доступ в веб версию панели администратора будет недоступен.

Уровень логирования 1-10 - Уровень логирования. Чем выше - тем подробнее. По умолчанию - 3. Возможные значения 1-10.
Срок хранения *.log файлов (дней) - Срок хранения файлов логирования. Значение означает количество дней хранения. По умолчанию - 7. Возможные значения 1-30.

ProCart.yaml - файл конфигурации модуля, он содержит все необходимые настройки для работы модуля.
Данный файл создается автоматически при первом запуске модуля.
После изменения параметров в данном файле, для вступлениях их в силу необходимо перезапустить модуль ProCart.

Настройки разбиты на 5 групп:

• r_keeper_midserver - параметры подключения к кассовому серверу
• r_keeper_references - данные справочников r_keeper
• local_server - параметры локального сервера модуля
• pro_cart_setting - параметры работы шлюза доставки
• log - параметры логирования

r_keeper_midserver

# Параметры подключения к кассовому серверу r_keeper 
r_keeper_midserver:
  # Адрес кассового сервера (str)
  host: 127.0.0.1
  # Порт для подключения к xml-интерфейсу кассового сервера (int)
  port: 3357
  # Логин пользователя (str)
  user: http
  # Пароль пользователя (str)
  password: http
  # Использовать SaaS XML для подключения к rk7 (bool)
  use_saas: false

• host - ip адрес компьютера на котором работает кассовый сервер
• port - http data port из конфигурации r_keeper Где найти
• user - логин пользователя для доступа к xml-интерфейсу (цифры и латиница, регистр важен)
• password - пароль пользователя для доступа к xml-интерфейсу (цифры и латиница, регистр важен)
• use_saas - Значение зависит от того, какая лицензия на XML будет использоваться для работы. Если SaaS (подписка), то true, если lifetime (XML WriteOrder) - false
  Если «use_saas=true», то необходимо произвести дополнительные настройки, необходимые для работы с XML SaaS, запустив файл «saas_settings.bat».

Если настройка saas-xml лицензии произведена успешно, в корневой папке с файлами ProCart появится файл с расширением .saasdata

Его примерное содержание должно быть:

{
  "seq_number": -1,
  "produrct_guid": "655cee55-7bcd-4826-b6e0-a8ccf2017ef3",
  "usr": "YWxrLW922HlhLnJ1OzQ0MWZmY2UzMjk0OWZkZTg2NGUxNDk0M2FkNWNmYzI1Ozc0NWZkYTk4MDA0ZjEzM2QyZWRlMjRkNTI4ODQ2N2Nl"
}

Если файл не появился вообще или в нём нет параметров «produrct_guid», «usr» - настройка неудачна, см. лог.

В случае появления в логе ошибки ErrorText=«Инстанс лицензии не найден», следует запустить файл change_license_instance.bat.

Подробная статья про лицензирования XML-Save Order: почитать

r_keeper_references =====
# Данные справочников r_keeper
r_keeper_references:

# Код кассовой станции (int)
cash_station: 1
# Код стола для создания закаов (int)

r_keeper_references:

# Код кассовой станции (int)
cash_station: 1
# Код стола для создания заказов (int)
table: 1
# Код категории заказа Если не передан в запросе будет использоваться по стандарту который указан в файле конфигурации, используется для подсчёта стоимости блюд (int)
order_category: 1
# Код классификации блюд для выгрузки меню (int)
menu_classification: 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: ''
# Использование причины внесения предоплат (int)
payment_reason_option: 0
# Код причины внесения предоплат (int)
payment_reason_code: 2

</code>

cash_station - КОД кассовой станции от имени которой будут производиться все операции. Как правило, это код главной кассы на кассовом сервере.
table - КОД стола, на котором по умолчанию будут создаваться заказы. Подробнее тут.
order_category - КОД категории заказа используемой по умолчанию. Подробнее тут.
menu_classification - КОД классификации по которой ведется выборка блюд из r_keeper. Подробнее тут.
sum_discount - КОД суммовой скидки. Используется для передачи в систему произвольной скидки, сумма которой рассчитывается на стороне внешней системы.
Подробнее тут.
sum_maprkup - КОД суммовой наценки. Используется для передачи в систему произвольной наценки, сумма которой рассчитывается на стороне внешней системы.
Подробнее тут.
open_modifier_code - КОД свободного модификатора. Используется для добавления комментария к блюду Подробнее тут
guid_commment - GUID расширенного свойства, для комментария. Из поля comment текст будет попадать в указанное свойство. Настройка расширенного свойства описана тут.
payment_reason_option - КОД использования причины внесения предоплат. Имеет значения 0 и 1, где 0 - это не использовать причину внесения предоплат, а 1- использовать причину внесения, предоплат
payment_reason - КОД причины внесения предоплаты.

local_server

# Параметры локального сервера 
local_server:
  # Адрес сервера (str)
  host: 0.0.0.0
  # Порт сервера (int)
  port: 11111
  # Количество потоков сервера (int)
  threads: 4

• host - Подсеть, в рамках которой сервер ProCart принимает и обрабатывает запросы. Значение по умолчанию «0.0.0.0» (обрабатывать запросы из любой подсети).
  Важно! Если вы не знаете зачем нужен этот параметр - не меняйте его значение.
  Важно! Не устанавливать «127.0.0.1».
• port - Порт на котором работает (принимает запросы) сервер ProCart. Значение по умолчанию - 11111
• threads - количество потоков обработки. Изменять не рекомендуется!

pro_cart_setting

# Параметры настройки шлюза доставки 
pro_cart_settings:
  # Список токенов подключения (str)
  token_list:
  - ccccbf02-776c-49a7-8d04-57ee6047e31f
  - bab937cc-2241-48da-910c-9856aff13e2e
  # Задержка опроса r_keeper на предмет изменений в заказах (секунд) (int)
  timeout_statepolling: 10
  # Включить проверку кодов блюд при создании заказа По умолчанию True (включено). Если выключить, то модуль неизвестные коды блюд будет интерпретировать как обычное блюдо. (bool)
  enable_items_verification: true
  # Заполнять теги для интернет платежей (bool)
  use_internet_pay_tags: true
  # Адрес сайта (Место расчетов) (str)
  def_site_url_1187: ''
  # Контактные данные покупателя (str)
  def_contact_1008: ''

• token_list - Список разрешенных токенов для подключения.
  По умолчанию первый токен генерируется автоматически (при первом запуске модуля). Если с модулем ProCart будет работать несколько разных внешних систем, то рекомендуется для подключения каждой из них использовать отдельный токен. Новые токены записываются в файл с новой строки, строка начинается с символа «-». Значение токена должно соответствовать формату GUID. Для генерации значений новых токенов можно воспользоваться внешним сервисом.
• 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», если значение в запросе не указано берёт из конфига.подробнее тут.
• def_site_url_1187 - Адрес сайта (место расчётов).
  По умолчанию пустая строка («»). Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные сайта
• def_contact_1008'' - Контактные данные покупателя,
  По умолчанию пустая строка («»). Задаёт дефолтное значение, если в запросе значение тега не передано, иначе берётся из запроса. Незаполненное поле требуется указать, если должен быть определенные данные покупателя

log

log:
  # Уровень логирования (int)
  level: 3
  # Срок хранения .log файлов (дней) (int)
  retention_days: 7

• level - Уровень логирования. Чем выше - тем подробнее. По умолчанию - 3. Возможные значения 1-10.
• retention_days - Срок хранения *.log файлов (дней). По умолчанию - 7. Возможные значения 1-30.

# Пользователь по умолчанию 
user:
  # Логин (str)
  login: admin
  # Пароль (str)
  password: admin

• login - Логин пользователя.По умолчанию - admin.
• password - Пароль пользователя.По умолчанию - admin.

Важно! При удалении данных пользователя из файла конфига, дальнейшая настройка будет возможна, только в файле конфига. И доступ в веб версию панели администратора будет недоступен.