Различия

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

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

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

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

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

Различия

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