Добавить ссылку на команды RK7 XML API

1 ОписаниеLink to 1 Описание

НазначениеВыполнение произвольной команды RK7 XML Interface. Подробнее запросы к Rk7 описаны в документации по RK7
Тип запросаАсинхронный

2 Формат запросовLink to 2 Формат запросов

2.1 Формат запросаLink to 2.1 Формат запроса

<?xml version="1.0" encoding="utf-8"?>
<RQ cmd="exec_rk7call" tasktype="any_call" callback="http://yoursite.ru/">
  <PARAM name="object_id" val="199990053"/>
 <RK7Query>
    Произвольный запрос к RK7
 </RK7Query>
</RQ>

Описание параметров


Параметр
Тип
Обязательный
Описание
Значение по умолчанию
object_idint+Код ресторана в системе лицензирования
callbackstring+HTTP адрес, по которому WhiteServer отправит запрос после выполнения команды


2.2 Формат ответаLink to 2.2 Формат ответа

<?xml version="1.0" encoding="utf-8"?>
<RP taskguid="6774b0bc-dd5e-4eca-a1f9-d982607feb2e" code="0" version="1.5.0.7155" />

Описание параметров

Параметр
Тип
Описание
taskguidguidУникальный код этой задачи. При отправке callback будет использован этот код, чтобы вызывающий сервис мог сопоставить запрос и ответ


2.3 Формат callback (асинхронного ответа)Link to 2.3 Формат callback (асинхронного ответа)

<RP cmdguid="d87eb27c-6220-4ff4-9d1b-0951b50447a7" posid="4D7B18F2-58CE-4F0F-A2B6-2D90A6BFCF67">
результат выполнения команды
</RP>

Описание параметров

Параметр
Тип
Описание
cmdguidguidСовпадает с taskguid в ответе
posidguidPOS id кассового сервера (можно игнорировать)

3 Примеры вызововLink to 3 Примеры вызовов

3.1 Пример GetSystemInfoLink to 3.1 Пример GetSystemInfo

3.1.1 ЗапросLink to 3.1.1 Запрос

<?xml version="1.0" encoding="utf-8"?>
<RQ cmd="exec_rk7call" tasktype="any_call" groupguid="0259572a-0020-48ac-8427-ddd31cb379c6" callback="http://mysite.ru/WSCallback/">
  <PARAM name="object_id" val="199990105"/>
 <RK7Query>
    <RK7CMD CMD="GetSystemInfo"/>
 </RK7Query>
</RQ>

3.1.2 ОтветLink to 3.1.2 Ответ

<?xml version="1.0" encoding="utf-8"?>
<RP taskguid="0a85447e-f4da-4424-8c36-d20c63fe6b89" code="0" version="1.7.0.8215" />

3.1.3 Callback (асинхронный ответ)Link to 3.1.3 Callback (асинхронный ответ)

<RP cmdguid="0a85447e-f4da-4424-8c36-d20c63fe6b89" posid="797C3E3B-3C33-4D97-87F8-25578FE48BE6">
  <RK7QueryResult ServerVersion="7.5.8.17" XmlVersion="232" NetName="MIDSERVER_050810" Status="Ok" CMD="GetSystemInfo" ErrorText="" DateTime="2017-11-20T19:43:48" WorkTime="0" Processed="1">
    <SystemInfo SystemTime="3720368628234" ReqSysVer="2" NetName="MIDSERVER_050810" ProcessID="192" CashServerVersion="7.5.8.17" ShiftDate="20171120" RestCode="199990105">
      <BusinessPeriod id="1013522" code="2" name="День" />
      <CashGroup id="20409" name="MIDSERVER_050810" />
      <Restaurant id="1057767" code="105" name="Test1" />
    </SystemInfo>
  </RK7QueryResult>
</RP>

Обратите внимание, что в 4.1.2 taskguid и 4.1.3 cmdguid совпадают.