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

Шаблоны чека

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

GET checkTemplate?id=piot_test_classic_5.04

Получение шаблона чека по имени

URL: {{HTTPRoot}}/checkTemplate?id=piot_test_classic_5.04

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

Имя поля Тип Обяз Назначение Пример
id string + Имя шаблона чека piot_test_classic_5.1

Тело ответа

200 OK

{
    "Result": {
        "Name": "piot_test_classic_5.1",
        "Document": {
            "TaskType": 1,
            "TaxType": 0,
            "TimeZone": 0,
            "OperationOnline": false,
            "IsReplaceTax": true,
            "TrustedInFn": false,
            "Change": 0,
            "Sum": 0,
            "Electronically": false,
            "IsFiscal": false,
            "MtNumber": 0,
            "PrintError": false,
            "CheckItems": [
                {
                    "Name": "Молоко Сценарий 1, 2, 5, 7, 14, Авария",
                    "Quantity": 1,
                    "Price": 101,
                    "Sum": 101,
                    "IsFiscal": true,
                    "MarkingCode": "0104670540176099215'W9Um\u001d93dGVz",
                    "ProductCode": "4670540176099"
                }
            ],
            "Payments": {
                "Cash": 101,
                "Electronic": 0,
                "PrePaid": 0,
                "Credit": 0,
                "Barter": 0
            }
        }
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (CheckTemplate)

Имя поля Тип Обяз Назначение Пример
Name string + Уникальное имя шаблона чека. “piot_test_classic_5.1”
Document CheckTemplateDocument - Сохранённые данные документа шаблона “Document”: {
“TaskType”: 1,
“TaxType”: 0,
“TimeZone”: 0,
“OperationOnline”: false,
“IsReplaceTax”: true,
“Sum”: 101,
“Electronically”: false,
“IsFiscal”: false,
“MtNumber”: 0,
“PrintError”: false,
“CheckItems”: [
{
“Name”: “Молоко Сценарий 1, 2, 5, 7, 14, Авария”,
“Quantity”: 1,
“Price”: 101,
“Sum”: 101,
“IsFiscal”: true,
“MarkingCode”: “0104670540176099215’W9Um93dGVz”,
“ProductCode”: “4670540176099”
}
],
“Payments”: {
“Cash”: 101,
“Electronic”: 0,
“PrePaid”: 0,
“Credit”: 0,
“Barter”: 0
}
}

CheckTemplateDocument

Имя поля Тип Обяз Назначение Пример
TaskType int - Тип чека.
0 — Текст;
1 — Продажа;
2 — Возврат;
3 — Покупка;
4 — ВозвратПокупки;
5 — ЧекКоррекцииПрихода;
6 — ЧекКоррекцииВозвратаПрихода;
7 — ЧекКоррекцииРасхода;
8 — ЧекКоррекцииВозвратаРасхода		 1
TaxType int - Система налогообложения:
0 — Общая (ОСН);
1 — Упрощенная Доход(УСН);
2 — Упрощенная Доход минус Расход(УСНД_Р);
3 — Единый налог на вмененный доход(ЕНВД);
4 — Единый сельскохозяйственный налог(ЕСН);
5 — Патентная система налогообложения(ПСН)		 0
TimeZone int - Номер часовой зоны места расчета:
0 — не выбрано;
1 — 1 часовая зона (МСК-1 / UTC+2);
2 — 2 часовая зона (МСК / UTC+3);
3 — 3 часовая зона (МСК+1 / UTC+4);
4 — 4 часовая зона (МСК+2 / UTC+5);
5 — 5 часовая зона (МСК+3 / UTC+6);
6 — 6 часовая зона (МСК+4 / UTC+7);
7 — 7 часовая зона (МСК+5 / UTC+8);
8 — 8 часовая зона (МСК+6 / UTC+9);
9 — 9 часовая зона (МСК+7 / UTC+10);
10 — 10 часовая зона (МСК+8 / UTC+11);
11 — 11 часовая зона (МСК+9 / UTC+12)		 9
OperationOnline bool - Признак применения ККТ при расчёте в безналичном порядке в сети «Интернет» false
IsReplaceTax bool - Признак замены системы налогообложения настройками ККТ true
TrustedInFn bool - Подтвержден в ФН false
Sum decimal - Сумма с учетом скидки 0.0
Change decimal - Сдача 0
Electronically bool - Регистрация чека без печати на ленте false
IsFiscal bool - Фискальный режим true
MtNumber int - Номер документа “Уведомление о реализации МТ” в который включается данные чека 0
PrintError bool - Ошибка при печати бумажной формы чека false
CheckItems Список CheckItem - Позиции шаблона []
Payments Payments - Способы оплаты “Payments”:

CheckItems

Имя поля Тип Обяз Назначение Пример
Name string - Название товара или услуги “Молоко Сценарий 1, 2, 5, 7, 14, Авария”
Quantity decimal - Количество товара 1.0
Price decimal - Цена позиции 101.0
Sum decimal - Сумма с учетом скидки 50.0
IsFiscal bool - Фискальный режим true
MarkingCode string - Код маркировки в кодировке Base64 “0104670540176099215’W9Um?93dGVz”
ProductCode string - Код товара “4670540176099”

Payments

Имя поля Тип Обяз Назначение Пример
Cash decimal - Сумма наличной оплаты 915.0
Electronic decimal - Сумма безналичными средствами 0.0
PrePaid decimal - Сумма предоплатой (зачетом аванса) 0.0
Credit decimal - Сумма постоплатой (в кредит) 0.0
Barter decimal - Сумма встречным предоставлением) 10.0

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

2 Недопустимое имя шаблона чека

{
    "Code": 2,
    "Description": "Не удалось получить шаблон чека: Недопустимое имя шаблона чека. Разрешенные символы: a-zA-Z0-9_-(). Пробелы запрещены.",
    "Success": false
}

2 Форма чека-шаблона не найдена

{
    "Code": 2,
    "Description": "Не удалось получить шаблон чека: Форма чека-шаблона 'piot_' не найдена.",
    "Success": false
}

GET checkTemplate/list

Получение списка шаблонов чека

URL: {{HTTPRoot}}/checkTemplate/list

Тело ответа

200 OK

{
    "Result": [
        {
            "Name": "piot_test_classic_5.1",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.10",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.11",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.12",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.13",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.14",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.15",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.16",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.17",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.18",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.19",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.2",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.20",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.21",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.22",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.23",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.24",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.25",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.26",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.3",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.4",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.5",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.6",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.7",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.8",
            "TaskType": 1
        },
        {
            "Name": "piot_test_classic_5.9",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.1",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.10",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.11",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.12",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.13",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.14",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.15",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.2",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.3",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.4",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.5",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.6",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.7",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.8",
            "TaskType": 1
        },
        {
            "Name": "piot_test_heal_5.9",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.1",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.10",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.11",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.12",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.13",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.14",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.2",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.3",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.4",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.5",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.6",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.7",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.8",
            "TaskType": 1
        },
        {
            "Name": "piot_test_LI_5.9",
            "TaskType": 1
        }
    ],
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (список CheckTemplate)

Имя поля Тип Обяз Назначение Пример
Name string + Уникальное имя шаблона чека. “piot_test_classic_5.1”
TaskType int + Тип чека.
0 — Текст;
1 — Продажа;
2 — Возврат;
3 — Покупка;
4 — ВозвратПокупки;
5 — ЧекКоррекцииПрихода;
6 — ЧекКоррекцииВозвратаПрихода;
7 — ЧекКоррекцииРасхода;
8 — ЧекКоррекцииВозвратаРасхода		 1

POST checkTemplate

Создание нового шаблона чека

URL: {{HTTPRoot}}/checkTemplate

Тело запроса

{
  "Name": "sale_template_01",
  "Document": {
    "PaymentType": 1,
    "TaxVariant": 0,
    "Payments": { "Cash": 101 },
    "Positions": [
      {
        "FiscalString": {
          "Name": "Товар",
          "Quantity": 1,
          "PriceWithDiscount": 101,
          "SumWithDiscount": 101,
          "Tax": "0",
          "SignMethodCalculation": 4,
          "SignCalculationObject": 33
        }
      }
    ]
  }
}

Тип: CheckTemplateParameters

Имя поля Тип Обяз Назначение Пример
Name string + Уникальное имя шаблона чека. Допустимы только символы “a-zA-Z0-9_-()”, пробелы запрещены. “sale_template_01”
Document CheckTemplateDocumentParameters + Данные документа шаблона. “Document”: {
“PaymentType”: 1,
“TaxVariant”: 0,
“Payments”: { “Cash”: 101 },
“Positions”: [
{
“FiscalString”: {
“Name”: “Товар”,
“Quantity”: 1,
“PriceWithDiscount”: 101,
“SumWithDiscount”: 101,
“Tax”: “0”,
“SignMethodCalculation”: 4,
“SignCalculationObject”: 33
}
}
]
}

CheckTemplateDocumentParameters

Смотрите документацию POST-запроса check

Тело ответа

200 OK

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

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

2 Имя шаблона чека не задано

{
    "Code": 2,
    "Description": "Не удалось создать шаблон чека: Имя шаблона чека не задано.",
    "Success": false
}

PUT checkTemplate

Редактирование шаблона чека

URL: {{HTTPRoot}}/checkTemplate

Тело запроса

{
  "Name": "sale_template_01",
  "Document": {
    "PaymentType": 1,
    "TaxVariant": 0,
    "Payments": { "Cash": 12 },
    "Positions": [
      {
        "FiscalString": {
          "Name": "Товар1",
          "Quantity": 1,
          "PriceWithDiscount": 12,
          "SumWithDiscount": 12,
          "Tax": "0",
          "SignMethodCalculation": 4,
          "SignCalculationObject": 33
        }
      }
    ]
  }
}

Смотрите документацию POST-запроса checkTemplate

Тело ответа

200 OK

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

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

2 Имя шаблона чека не задано

{
    "Code": 2,
    "Description": "Не удалось обновить шаблон чека: Имя шаблона не задано.",
    "Success": false
}

DELETE checkTemplate?id=piot_test_classic_5.1

Удаление шаблона чека по имени

URL: {{HTTPRoot}}/checkTemplate?id=piot_test_classic_5.1

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

Имя параметра Тип Обяз Назначение Пример
id string + Название шаблона чека piot_test_classic_5.1

Тело ответа

200 OK

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

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

2 Форма чека-шаблона не найдена

{
    "Code": 2,
    "Description": "Не удалось удалить шаблон чека: Форма чека-шаблона 'sale_templat' не найдена.",
    "Success": false
}

2 Недопустимое имя шаблона чека

{
    "Code": 2,
    "Description": "Не удалось удалить шаблон чека: Недопустимое имя шаблона чека. Разрешенные символы: a-zA-Z0-9_-(). Пробелы запрещены.",
    "Success": false
}