Настройка XML интерфейса [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Настройка XML интерфейса ======
XML-интерфейс предоставляет наиболее удобный способ получения информации о системе r_keeper и сохранения данных в базах данных r_keeper 7, а также выполнения различных операций. 

Существует 3 вида интерфейсов в r_keeper 7:
  * Для кассовых серверов
  * Для кассовых станций
  * Для серверов справочников (отчетов)

Какой именно вид интерфейса нужно настроить - зависит от требований ПО для которого он будет использоваться. Чаще всего используется XML кассового сервера. Реже XML кассовой станции. XML сервера справочников используется крайне редко.

Для работы на чтение - лицензировать XML интерфейс не нужно. 
Если логика ПО требует создание заказа и/или их оплату через XML (в этом случае об этом будет сказано в описании модуля), то необходима лицензия на модуль "XML WriteOrder" или "XML SaaS"

Больше информации [[https://docs.rkeeper.ru/rk7/latest/ru/xml-interfejs-r_keeper-7-19605640.html|доступно тут]].


===== Настройка HTTP XML интерфейса кассового сервера (или кассы) =====
  - Перейдите в справочник "Сервис -> Станции и устройства".
  - Из дерева слева выберите кассовый сервер, с которым будет работать программа (или конкретную кассу).
  - Перейдите во вкладку "Свойства" выбранного кассового сервера (выбранной кассы).
  - В группе свойств HTTP ограничения для всех пунктов проставьте значение. Можно использовать стандартную привилегию (например, "HTTP Access"), а можно завести дополнительное значение и использовать его.
  - В группе свойств HTTP Server параметр "HTTP Data Port" установите в соответствии с любым свободным портом на компьютере, где работает выбранный кассовый сервер (или касса). Этот порт будет использоваться при настройке ПО. Параметр "Use Free Listen Port" рекомендуется отключить.
  - Сохраните изменения и перезапустите кассовый сервер (или кассу) для того, чтобы выполненные настройки вступили в силу.

{{:external:zz_дополнительные_материалы:pasted:20231026-123010.png}}

===== Настройка пользователя для HTTP XML интерфейса =====

  - Перейдите в справочник "Персонал -> Работники".
  - Выберите существующую роль XML-Editing (именно её), дайте ей привилегию на объект "HTTP Access" (или ту привилегию что вы завели в прошлом разделе) в группе параметров "Менеджерские ограничения".
  - Для выбранной роли создайте пользователя с названием строго из **ЛАТИНСКИХ ** букв (регистр вАжЕн), задайте пользователю пароль (цифры и латинские буквы).
  - Выдайте этой роли полные кассовые права.
  - Учетные данные заведенного пользователя (Название и пароль) потребуются для дальнейшей настройки ПО.

{{:external:zz_дополнительные_материалы:pasted:20220830-140809.png}}
{{:external:zz_дополнительные_материалы:pasted:20220830-140939.png}}

===== Как проверить? =====

В браузере перейти по ссылке: https://127.0.0.1:8026/webgui/iservxmltest.htm 

В данном примере:
127.0.0.1 - адрес кассового сервера;
8026 - порт, на котором поднят интерфейс.

{{:external:zz_дополнительные_материалы:pasted:20231026-122754.png}}

Если настроено корректно - браузер начнет ругаться на сертификат и если проигнорировать - спросит логин/пароль от интерфейса и пустит на страницу проверки.
Подходящий универсальный XML-запрос для проверки уже будет на этой странице.