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

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

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

POST picture

Запрос: picture

URL: {{HTTPRoot}}/picture

Печать изображения

Тело запроса

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

Тип: объект Picture

Picture

Имя поля Тип Назначение Пример
DeviceName string Имя устройства для печати “atol”
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(): Не найдено устройство E..",
    "Success": false
}

72 — Не указан PictureName

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

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

Запрос: picture

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

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

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

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

Тело ответа

Успешный ответ (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}

Запрос: picture/list

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

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

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

Параметр Обяз Пример Описание
device + Emu —

Тело ответа

Успешный ответ (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

Picture

Имя поля Тип Назначение Пример
PictureBase64 string Изображение в формате base64 ”“
PictureName string Название изображения ”“
Width int Длина 0
Height int Ширина 0
StartLineNumber int Номер первой строки печати изображения 0
EndLineNumber int Номер последней строки печати изображения 0
Alignment int 1 - левый край; 2 - по центру(по умолчанию центер); 3 - правый край 0
Uploaded DateTime Дата загрузки в память ККТ ”“
IsUploaded bool Загружен в память ККТ false
Override bool Перезаписать false

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

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

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

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

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

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

Запрос: picture

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

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

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

Параметр Обяз Пример Описание
device + Shtrih Название устройства
id + logo название изображения

Тело ответа

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

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

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

72 — Не указан PictureName

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

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

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

Параметры

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