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

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

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

POST picture

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

URL: {{HTTPRoot}}/picture

Тело запроса

{
    "DeviceName": "{device}",
    "Base64": "iVBORw0KGgoAAAANSUhEUgAAASwAAAFJCAYAAAAhRBCcAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQU...",
    "PictureName": "name3212",
    "Alignment": 2
}

Тип: Picture

Picture

Имя поля Тип Назначение Пример
DeviceName string Имя устройства для печати “Emu”
Base64 string Изображение закодированное в Base64 “iVBORw0KGgoAAAANSUhEUgA…”
PictureName string Название изображения “logo”
Alignment int 1 left - по левому краю;
2 center - по центру(по умолчанию);
3 right - по правому краю		 2

Тело ответа

Успешный ответ (200 OK)

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

Поле Result

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

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

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

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

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

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

72 — Не указан PictureName

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

GET picture?device={device}&id={id}

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

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

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

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

Тело ответа

Успешный ответ (200 OK)

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

Поле Result

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

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

72 — Не указан PictureId

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

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

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

GET picture/list?device={device}

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

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

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

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

Тело ответа

Успешный ответ (200 OK)

{
    "Result": [
        {
            "PictureBase64": "/9j/4AAQSkZJRgABAQEASABIAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZWiAH4AABAAEAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlkZXNjAAAA8AAAACRyWFlaAAABFAAAABRnWFlaAAABKAAAABRiWFlaAAABPAAAABR3dHB0AAABUAAAABRyVFJDAAABZAAAAChnVFJDAAABZAAAAChiVFJDAAABZAAA7...",
            "Width": 720,
            "Height": 451,
            "StartLineNumber": 0,
            "EndLineNumber": 0,
            "Alignment": 0,
            "IsUploaded": false,
            "Override": false
        },
        {
            "PictureBase64": "iVBORw0KGgoAAAANSUhEUgAAASwAAAFJCAYAAAAhRBCcAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAAZdEVYdFNvZnR3YXJlAFBhaW50Lk5FVCA1LjEuMTGKCBbOAAAAuGVYSWZJSSoACAAAAAUAGgEFAAEAAABKAAAAGwEFAAEAAABSAAAAKAEDAAEAAAACAAAAMQECABEAAABaAAAAaYcEAAEAAABsAAAAAAAAAGAAAAABAAAAYAAAAAEAAABQYWludC5ORVQgNS4xLjExAAADAACQBwAEAAAAMDIzMAGgAwABAAAAAQAAAAW...",
            "PictureName": "Picture",
            "Width": 300,
            "Height": 329,
            "StartLineNumber": 0,
            "EndLineNumber": 0,
            "Alignment": 0,
            "IsUploaded": false,
            "Override": false
        },
        {
            "PictureBase64": "iVBORw0KGgoAAAANSUhEUgAAASwAAAFJCAYAAAAhRBCcAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAAZdEVYdFNvZnR3YXJlAFBhaW50Lk5FVCA1LjEuMTGKCBbOAAAAuGVYSWZJSSoACAAAAAUAGgEFAAEAAABKAAAAGwEFAAEAAABSAAAAKAEDAAEAAAACAAAAMQECABEAAABaAAAAaYcEAAEAAABsAAAAAAAAAGAAAAABAAAAYAAAAAEAAABQYWludC5ORVQgNS4xLjExAAADAACQBwAEAAAAMDIzMAGgAwABAAA...",
            "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": "Изображение не найдено: Bad Request.",
    "Success": false
}

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

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

DELETE picture?device={device}&id={id}

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

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

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

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

Тело ответа

Успешный ответ (200 OK)

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

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

72 — Не указан PictureName

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

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

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