ТЕХНИЧЕСКАЯ ДОКУМЕНТАЦИЯ

Работа с картинками

> СерверККМ V4 > REST API > Работа с ККМ
Дата обновления: 7 августа 2026 г.

POST picture

Загрузка изображения в выбранную ККТ

URL: {{HTTPRoot}}/picture

Тело запроса

{
  "DeviceName": "Atol",
  "Base64": "iVBORw0KGgoAAAANSUhEUgA...",
  "PictureName": "name3212",
  "Alignment": 2
}

Тип: Picture

Имя поля Тип Обяз Назначение Пример
DeviceName string + Имя устройства “Atol”
Base64 string + Изображение закодированное в Base64 “iVBORw0KGgoAAAANSUhEUgA…”
PictureName string + Название изображения — используется как идентификатор при последующем получении или удалении. “logo”
Alignment int + Выравнивание изображения при печати:
1 — по левому краю;
2 — по центру;
3 — по правому краю. Если не указано — 2 (по центру).		 2

Тело ответа

200 OK

{
    "Result": {
        "PictureNumber": 17
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (Picture)

Имя поля Тип Обяз Назначение Пример
PictureNumber int - Номер изображения 18

Примеры ошибок

4 Не указано имя ККТ

{
    "Code": 4,
    "Description": "Не указано имя ККТ",
    "Success": false
}

72 Не найдено устройство

{
    "Code": 72,
    "Description": "Не удалось загрузить картинку: UploadPicture(): Не найдено устройство atol.",
    "Success": false
}

72 Не указан PictureName

{
    "Code": 72,
    "Description": "Не указан PictureName.",
    "Success": false
}

GET picture?device=Atol&id=name32

Получение изображения

URL: {{HTTPRoot}}/picture?device=Atol&id=name32

Параметры запроса

Имя параметра Тип Обяз Назначение Пример
id string + Имя изображение. name32
device string + Имя устройства. Atol

Тело ответа

200 OK

{
    "Result": "iVBORw0KGgoAAAANSUhEUg...",
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (Picture)

Имя поля Тип Обяз Назначение Пример
Picture string - Изображение в кодировке Base64 “iVBORw0KGgoAAAANSUhEUg…”

Примеры ошибок

72 Изображение не найдено

{
    "Code": 72,
    "Description": "Изображение не найдено: Bad Request.",
    "Success": false
}

72 Не указан PictureId

{
    "Code": 72,
    "Description": "Не указан PictureId.",
    "Success": false
}

GET picture/list?device=Atol

Получение списка изображений

URL: {{HTTPRoot}}/picture/list?device=Atol

Параметры запроса

Имя параметра Тип Обяз Назначение Пример
device string + Имя устройства. Atol

Тело ответа

200 OK

{
    "Result": [
        {
            "PictureBase64": "iVBORw0KGgoAAAANSU...",
            "PictureName": "name",
            "Width": 300,
            "Height": 329,
            "StartLineNumber": 0,
            "EndLineNumber": 0,
            "Alignment": 1,
            "IsUploaded": false,
            "Override": false
        }
    ],
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (массив Picture)

Имя поля Тип Обяз Назначение Пример
PictureBase64 string + Изображение в формате base64 “iVBORw0KGgoAAAANSU…”
PictureName string + Название изображения “name”
Width int - Ширина изображения при печати, в точках 200
Height int - Высота изображения при печати, в точках 80
StartLineNumber int - Номер первой строки печати изображения 0
EndLineNumber int - Номер последней строки печати изображения 0
Alignment int - Выравнивание:
1 - по левому краю;
2 - по центру;
3 - по правому краю.		 2
IsUploaded bool - Признак загрузки изображения в память ККТ false
Override bool П- ризнак перезаписи изображения в памяти ККТ false

Примеры ошибок

72 Не найдено устройство

{
    "Code": 72,
    "Description": "Изображение не найдено: GetListPicture(): Не найдено устройство atol..",
    "Success": false
}

72 Изображение не найдено

{
    "Code": 72,
    "Description": "Изображение не найдено: Bad Request.",
    "Success": false
}

DELETE picture?device=Atol&id=b0ce9370-4435-49f8-a5e8-9bc267a26f77

Удаление картинки с устройства

URL: {{HTTPRoot}}/picture?device=Atol&id=b0ce9370-4435-49f8-a5e8-9bc267a26f77

Параметры запроса

Имя параметра Тип Обяз Назначение Пример
device string + Имя устройства. Atol
id string + Имя изображение b0ce9370-4435-49f8-a5e8-9bc267a26f77

Примеры ошибок

ОК

{
    "Result": "Ok",
    "Code": 0,
    "Description": "OK",
    "Success": true
}

72 Не указано PictureName

{
    "Code": 72,
    "Description": "Не указано PictureName.",
    "Success": false
}

72 Изображение не найдено

{
    "Code": 72,
    "Description": "Изображение не найдено: Bad Request.",
    "Success": false
}