Различия

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

--- кассир5:способыобменаданными [2022/11/01 12:59]
dzayonchkovskiy
+++ кассир5:способыобменаданными [2024/03/07 16:47] (текущий)
dzayonchkovskiy
@@ Строка 36: / Строка 36: @@
 ====ReceiveData====
 GET запрос.\\
-Получение данных из бэк-офиса.\\
+Получение данных из бэк-офиса, с возможностью получения данных (файла).\\
 Функция должна иметь следующий веб-адрес:\\
 <code>
-http://{host}/hs/KKMTransfer/{НомерПОС}/{НомерПакета}
+http://{host}/hs/KKMTransfer/{НомерПОС}/{НомерПакета}/?text=1
-</code>
-\\
-**host** - веб-адрес сервиса\\
-**НомерПОС** - число, уникальный номер рабочего места (задаётся в настройках стартера Кассира)\\
-**НомерПакета** - число, номер пакета для загрузки, после успешной загрузки Кассир увеличивает номер пакета на 1.\\
-Функция может вызываться несколько раз с одним номером пакета, поэтому сразу после выполнения нельзя удалять пакет с указанным номером.\\
-В ответе нужно указать заголовок: "Content-type:application/json;  charset=utf-8".
-===Возвращаемое значение===
-строка JSON с атрибутами:\\
-**data** - пустая строка или zip-архив с файлом в виде строки в формате base64\\
-**errcode** - код ошибки, 0 - ошибок нет\\
-**errmessage** - пустая строка или текст ошибки\\
-**packagetype** - расширение файла (spr или flr или dcm)\\
-**UID** - уникальный идентификатор, может указываться если packagetype = "flr" ([[кассир5:форматобменаданными:запространзакций|файл запроса транзакций]]). По заданным параметрам в файле flr, касса сформирует файл с транзакциями и выполнит ф-ю SendData с указанием данного UID.\\
-Пример успешного получения пакета с файлом:\\
-<code>
-{
-"data": "UEsDBBQAAAgIABuVPVAHI4ouFgAAABQAAAAOAAAAdjhfOTk2OV8xNS50eHR7v3u/\r\nsrKDg5qaiopKUIAPL5cyLxcAUEsBAi4DFAAACAgAG5U9UAcjii4WAAAAFAAAAA4A\r\nJAAAAAAAAAAAALSBAAAAAHY4Xzk5NjlfMTUudHh0CgAgAAAAAAABABgAgF1jfrrW\r\n1QGAXWN+utbVAYBdY3661tUBUEsFBgAAAAABAAEAYAAAAEIAAAAAAA==",
-"errcode": "0",
-"errmessage": "",
-"packagetype": "spr"
-}
-</code>
-Пример ответа, когда данные для отправки на кассу отсутствуют:\\
-<code>
-{
-"data": "",
-"errcode": "3",
-"errmessage": "Не найдены данные для отправки"
-}
-</code>
-====ReceiveDataText====
-GET запрос.\\
-Получение данных из бэк-офиса, с возможностью получения данных как текст файла, так и в base64 от zip архива файла.\\
-Функция должна иметь следующий веб-адрес:\\
-<code>
-http://{host}/hs/KKMTransfer/ReceiveDataText/{НомерПОС}/{НомерПакета}
 </code>
 \\
@@ Строка 85: / Строка 45: @@
 **НомерПОС** - число, уникальный номер рабочего места (задаётся в настройках стартера Кассира)\\
 **НомерПакета** - число, номер пакета для загрузки, после успешной загрузки Кассир увеличивает номер пакета на 1.\\
+**text** - необязательный параметр запроса.\\
 Функция может вызываться несколько раз с одним номером пакета, поэтому сразу после выполнения нельзя удалять пакет с указанным номером.\\
 В ответе нужно указать заголовок: "Content-type:application/json;  charset=utf-8".
@@ Строка 97: / Строка 58: @@
 **UID** - уникальный идентификатор, может указываться если packagetype = "flr" ([[кассир5:форматобменаданными:запространзакций|файл запроса транзакций]]). По заданным параметрам в файле flr, касса сформирует файл с транзакциями и выполнит ф-ю SendData с указанием данного UID.\\
 \\
-Если заполнен атрибут data, тогда атрибут dataText не заполняется.\\
+Если передан необязательный параметр запроса **text** и его значение равно "1", тогда сервис может вернуть текст файла в атрибуте **dataText** или вернуть base64 от zip архива файла в атрибуте **data**.\\
-Если заполнен атрибут dataText, тогда атрибут data не заполняется.\\
+Если не передан необязательный параметр запроса **text** или его значение не равно "1", тогда сервис возвращает данные в base64 от zip архива файла в атрибуте **data**, атрибут **dataText** не заполняется.\\
 Пример успешного получения пакета с zip архивом в формате base64:\\
@@ Строка 110: / Строка 71: @@
 }
 </code>
-Пример успешного получения пакета с текстом файла:\\
+Пример успешного получения пакета с текстом файла (если был передан параметр ?text=1):\\
 <code>
 {
@@ Строка 135: / Строка 96: @@
 Функция должна иметь следующий веб-адрес:\\
 <code>
-http://{host}/hs/KKMTransfer/SendData/{НомерПОС}/{НомерПакета}/{UID}
+http://{host}/hs/KKMTransfer/SendData/{НомерПОС}/{НомерПакета}/?UID=uuid
 </code>
 \\

Штрих-М: Документация

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы