ExecuteRk7Query

Назначение	Выполнить произвольный XML запрос на кассе
Поддерживаемая версия агента	v1, v2
PluggetSystemType	RKMid

ФОРМАТ ЗАПРОСА

Формат запроса

Запрос

{
  "taskType": "ExecuteRk7Query",
  "params": {
    "sync": {
      "objectId": number,
       "timeout": number
    },
    "base64": "string",
   }
}

CODE

Параметр Тип Обязательный Описание Значение по умолчанию

taskType string + Тип задачи, для данного метода значение "ExecuteRk7Query"

sync Синхронный вызов метода (либо синхронный, либо асинхронный. Для этого изменить на "async")

timeout int - Время ожидания ответа от агента в секундах 120 секунд

objectId int + Код ресторана в системе лицензирования

base64

string

+

Текст запроса в xml (это вся нода RK7Query) необходимо перевести в кодировку base64 (для тестов это можно сделать любым онлайн сервисом).

В админке White Server текст запроса будет отображаться в обоих вариантах (оригинал и закодированный в base64).

Xml запросы и схемы для них можно посмотреть и скачать в статье.

Пример запроса:

Xml оригинал текст:

<?xml version="1.0" encoding="UTF-8"?>
<RK7Query>
<RK7CMD CMD="GetSystemInfo"/>
</RK7Query>

Xml в кодировке base64:

PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxSSzdRdWVyeT4NCiAgCQk8Uks3Q01EIENNRD0iR2V0U3lzdGVtSW5mbyIvPg0KPC9SSzdRdWVyeT4NCg==

ФОРМАТ ОТВЕТА

Формат ответа

Успешный ответ

{
  "taskResponse": {
     "base64": "string"
  },
  "responseCommon": {
    "taskGuid": "string",
    "taskType": "ExecuteRk7Query",
    "objectId": 199990246,
    "agentGuid": "d564619a-50c3-3d87-0816-de67ed9c8e18"
  }
}

CODE

Ответ с ошибкой. Ошибка агента или сервера

{
  "responseCommon": {
    "taskGuid": "string",
    "taskType": "ExecuteRk7Query",
    "objectId": 199990530,
    "agentGuid": "24c31062-c8dc-4da4-9e03-3e50e9444c55"
  },
  "error": {
    "wsError": {
      "code": "string",
      "desc": "string"
    },
    "agentError": {
      "code": "string",
      "desc": "string"
    }
  }
}

CODE

Параметр Тип Описание

base64

string

Текст запроса в xml (это вся нода RK7Query) необходимо перевести в кодировку base64 (для тестов это можно сделать любым онлайн сервисом).

В админке White Server текст запроса будет отображаться в обоих вариантах (оригинал и закодированный в base64).

Xml запросы и схемы для них можно посмотреть и скачать в статье

Пример ответа:

Xml оригинал текст:

<?xml version="1.0" encoding="UTF-8"?>
  <RK7QueryResult ServerVersion="7.6.2.203" XmlVersion="244" NetName="5826_MIDSERV" Status="Ok" CMD="GetSystemInfo" ErrorText="" DateTime="2019-10-01T15:14:28" WorkTime="0" Processed="1">
  <SystemInfo SystemTime="3779104468231" ReqSysVer="2" NetName="5826_MIDSERV" ProcessID="3052" CashServerVersion="7.6.2.203" ShiftDate="20190930" RestCode="199995826">
    <BusinessPeriod id="0" code="0" />
    <CashGroup id="15007" code="15007" name="5826_MIDSERV" />
    <Restaurant id="1" code="5826" name="Ресторан "Стенд"" />
  </SystemInfo>
</RK7QueryResult>

Xml в кодировке base64:

PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxSSzdRdWVyeVJlc3VsdCBTZXJ2ZXJWZXJzaW9uPSI3LjYuMi4yMDMiIFhtbFZlcnNpb249IjI0NCIgTmV0TmFtZT0iNTgyNl9NSURTRVJWIiBTdGF0dXM9Ik9rIiBDTUQ9IkdldFN5c3RlbUluZm8iIEVycm9yVGV4dD0iIiBEYXRlVGltZT0iMjAxOS0xMC0wMVQxNToxNDoyOCIgV29ya1RpbWU9IjAiIFByb2Nlc3NlZD0iMSI+DQogICAgPFN5c3RlbUluZm8gU3lzdGVtVGltZT0iMzc3OTEwNDQ2ODIzMSIgUmVxU3lzVmVyPSIyIiBOZXROYW1lPSI1ODI2X01JRFNFUlYiIFByb2Nlc3NJRD0iMzA1MiIgQ2FzaFNlcnZlclZlcnNpb249IjcuNi4yLjIwMyIgU2hpZnREYXRlPSIyMDE5MDkzMCIgUmVzdENvZGU9IjE5OTk5NTgyNiI+DQogICAgICA8QnVzaW5lc3NQZXJpb2QgaWQ9IjAiIGNvZGU9IjAiIC8+DQogICAgICA8Q2FzaEdyb3VwIGlkPSIxNTAwNyIgY29kZT0iMTUwMDciIG5hbWU9IjU4MjZfTUlEU0VSViIgLz4NCiAgICAgIDxSZXN0YXVyYW50IGlkPSIxIiBjb2RlPSI1ODI2IiBuYW1lPSLvv73vv73vv73vv73vv73vv73vv73vv70gJnF1b3Q777+977+977+977+977+9JnF1b3Q7IiAvPg0KICAgIDwvU3lzdGVtSW5mbz4NCjwvUks3UXVlcnlSZXN1bHQ+

error object Контейнер ошибок, см Описание ошибок

wsError		Ошибка от сервера
agentError		Ошибка от агента

ПРИМЕРЫ СТРУКТУРЫ ЗАПРОСОВ

Примеры структуры запросов

{
  "taskType": "ExecuteRk7Query",
  "params": {
    "sync": {
      "objectId": "199996011",
      "timeout": 120
    },
    "base64": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxSSzdRdWVyeT4NCiAgCQk8Uks3Q01EIENNRD0iR2V0U3lzdGVtSW5mbyIvPg0KPC9SSzdRdWVyeT4NCg=="
  }
}

{
  "taskType": "ExecuteRk7Query",
  "params": {
    "sync": {
      "objectId": "199996011",
      "timeout": 120
    },
    "base64": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxSSzdRdWVyeT4NCiAgCQk8Uks3Q01EIENNRD0iR2V0U3lzdGVtSW5mbyIvPg0KPC9SSzdRdWVyeT4NCg=="
  }
}
 
RequestFromAggregatorV2 Base64 decoded:
<?xml version="1.0" encoding="UTF-8"?>
<RK7Query>
        <RK7CMD CMD="GetSystemInfo"/>
</RK7Query>

{
  "taskResponse": {
    "base64": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxSSzdRdWVyeVJlc3VsdCBTZXJ2ZXJWZXJzaW9uPSI3LjI2LjEuMjAwMSIgWG1sVmVyc2lvbj0iMjQ4IiBOZXROYW1lPSJURVNUMjJfTUlEU0VSVkVSIiBTdGF0dXM9Ik9rIiBDb25uZWN0SWQ9IjEyNy4wLjAuMXwiIENNRD0iR2V0U3lzdGVtSW5mbyIgRXJyb3JUZXh0PSIiIERhdGVUaW1lPSIyMDI2LTA1LTA1VDE3OjM3OjIzIiBXb3JrVGltZT0iMCIgUHJvY2Vzc2VkPSIxIiBBcnJpdmFsRGF0ZVRpbWU9IjIwMjYtMDUtMDVUMTc6Mzc6MjMiPg0KICA8U3lzdGVtSW5mbyBTeXN0ZW1UaW1lPSIzOTg3MTY0MjQzOTc4IiBSZXFTeXNWZXI9IjIiIE5ldE5hbWU9IlRFU1QyMl9NSURTRVJWRVIiIFByb2Nlc3NJRD0iMTA4NDgiIENhc2hTZXJ2ZXJWZXJzaW9uPSI3LjI2LjEuMjAwMSIgU2hpZnREYXRlPSIyMDI2MDMwNSIgUmVzdENvZGU9IjE5OTk5NjAxMSI+DQogICAgPEJ1c2luZXNzUGVyaW9kIGlkPSIwIiBjb2RlPSIwIiAvPg0KICAgIDxDYXNoR3JvdXAgaWQ9IjE1MDA1IiBjb2RlPSIxNTAwNSIgbmFtZT0iVEVTVDIyX01JRFNFUlZFUiIgZ3VpZD0ie0E1MkZGN0ZELUZENEEtNEMyNS05NUE0LTZENjJBNjY1MUNCQX0iIC8+DQogICAgPFJlc3RhdXJhbnQgaWQ9IjEiIGNvZGU9IjYwMTEiIG5hbWU9ItCd0LDQuNC80LXQvdC+0LLQsNC90LjQtSDQoNC10YHRgtC+0YDQsNC90LAiIGd1aWQ9IntGQzFCQkIzNi00RDdGLTRFRjktODBDMi0zM0I3OEFEQkRCNkF9IiAvPg0KICA8L1N5c3RlbUluZm8+DQo8L1JLN1F1ZXJ5UmVzdWx0Pg=="
  },
  "responseCommon": {
    "taskGuid": "1f1860e4-339e-4ded-b995-3b172f18fedf",
    "taskType": "ExecuteRk7Query",
    "objectId": 199996011,
    "agentGuid": "c415aa96-8952-4689-8fcb-c6c969e25aad"
  }
}

{
  "taskResponse": {
    "base64": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxSSzdRdWVyeVJlc3VsdCBTZXJ2ZXJWZXJzaW9uPSI3LjI2LjEuMjAwMSIgWG1sVmVyc2lvbj0iMjQ4IiBOZXROYW1lPSJURVNUMjJfTUlEU0VSVkVSIiBTdGF0dXM9Ik9rIiBDb25uZWN0SWQ9IjEyNy4wLjAuMXwiIENNRD0iR2V0U3lzdGVtSW5mbyIgRXJyb3JUZXh0PSIiIERhdGVUaW1lPSIyMDI2LTA1LTA1VDE3OjM3OjIzIiBXb3JrVGltZT0iMCIgUHJvY2Vzc2VkPSIxIiBBcnJpdmFsRGF0ZVRpbWU9IjIwMjYtMDUtMDVUMTc6Mzc6MjMiPg0KICA8U3lzdGVtSW5mbyBTeXN0ZW1UaW1lPSIzOTg3MTY0MjQzOTc4IiBSZXFTeXNWZXI9IjIiIE5ldE5hbWU9IlRFU1QyMl9NSURTRVJWRVIiIFByb2Nlc3NJRD0iMTA4NDgiIENhc2hTZXJ2ZXJWZXJzaW9uPSI3LjI2LjEuMjAwMSIgU2hpZnREYXRlPSIyMDI2MDMwNSIgUmVzdENvZGU9IjE5OTk5NjAxMSI+DQogICAgPEJ1c2luZXNzUGVyaW9kIGlkPSIwIiBjb2RlPSIwIiAvPg0KICAgIDxDYXNoR3JvdXAgaWQ9IjE1MDA1IiBjb2RlPSIxNTAwNSIgbmFtZT0iVEVTVDIyX01JRFNFUlZFUiIgZ3VpZD0ie0E1MkZGN0ZELUZENEEtNEMyNS05NUE0LTZENjJBNjY1MUNCQX0iIC8+DQogICAgPFJlc3RhdXJhbnQgaWQ9IjEiIGNvZGU9IjYwMTEiIG5hbWU9ItCd0LDQuNC80LXQvdC+0LLQsNC90LjQtSDQoNC10YHRgtC+0YDQsNC90LAiIGd1aWQ9IntGQzFCQkIzNi00RDdGLTRFRjktODBDMi0zM0I3OEFEQkRCNkF9IiAvPg0KICA8L1N5c3RlbUluZm8+DQo8L1JLN1F1ZXJ5UmVzdWx0Pg=="
  },
  "responseCommon": {
    "taskGuid": "1f1860e4-339e-4ded-b995-3b172f18fedf",
    "taskType": "ExecuteRk7Query",
    "objectId": 199996011,
    "agentGuid": "c415aa96-8952-4689-8fcb-c6c969e25aad"
  }
}
<?xml version="1.0" encoding="utf-8"?>
<RK7QueryResult ServerVersion="7.26.1.2001" XmlVersion="248" NetName="TEST22_MIDSERVER" Status="Ok" ConnectId="127.0.0.1|" CMD="GetSystemInfo" ErrorText="" DateTime="2026-05-05T17:37:23" WorkTime="0" Processed="1" ArrivalDateTime="2026-05-05T17:37:23">
  <SystemInfo SystemTime="3987164243978" ReqSysVer="2" NetName="TEST22_MIDSERVER" ProcessID="10848" CashServerVersion="7.26.1.2001" ShiftDate="20260305" RestCode="199996011">
    <BusinessPeriod id="0" code="0" />
    <CashGroup id="15005" code="15005" name="TEST22_MIDSERVER" guid="{A52FF7FD-FD4A-4C25-95A4-6D62A6651CBA}" />
    <Restaurant id="1" code="6011" name="Наименование Ресторана" guid="{FC1BBB36-4D7F-4EF9-80C2-33B78ADBDB6A}" />
  </SystemInfo>
</RK7QueryResult>

{
  "responseCommon": {
    "taskGuid": "16f6788d-a726-4061-a5d3-e391b0b3caa8",
    "taskType": "ExecuteRk7Query",
    "objectId": 199990530,
    "agentGuid": "24c31062-c8dc-4da4-9e03-3e50e9444c55"
  },
  "error": {
    "agentError": {
      "code": "WsaOrderError",
      "desc": "HttpRequestException: Подключение не установлено, т.к. конечный компьютер отверг запрос на подключение. (127.0.0.1:8086)\r\nSocketException: Подключение не установлено, т.к. конечный компьютер отверг запрос на подключение."
    }
  }
}

{
  "responseCommon": {
    "taskGuid": "48aca38f-b452-4f3b-bc2c-a8ed372c04fb",
    "taskType": "ExecuteRk7Query",
    "objectId": 199996011,
    "agentGuid": "c415aa96-8952-4689-8fcb-c6c969e25aad"
  },
  "error": {
    "agentError": {
      "code": "WsaRk7QueryParseError",
      "desc": "FormatException: The input is not a valid Base-64 string as it contains a non-base 64 character, more than two padding characters, or an illegal character among the padding characters."
    }
  }
}