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

Администрирование

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

GET kkt/list

Получение список зарегистрированных ККТ.

URL: {{HTTPRoot}}/kkt/list

Тело ответа

200 OK

{
    "Result": [
        {
            "DeviceName": "Atol",
            "Driver": 3,
            "DeviceStatusDescription": "НетСвязи(выкл)"
        },
        {
            "DeviceName": "Emu",
            "Driver": 100,
            "DeviceStatusDescription": "Ok"
        }
    ],
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (массив DeviceListResponse)

Имя параметра Тип Обяз Назначение Пример
DeviceName string - Имя устройства “Atol”
Driver int - Тип драйвера.
1 — Shtrih;
2 — 1C(4.7);
3 — Atol;
4 — RrElectro;
5 — 1C(5.0);
100 — Emulator;
3
DeviceStatusDescription string - Описание статуса устройства. “Ok”

GET kkt/list/byPool?pool=pool

Получить список устройств, входящих в указанный пул.

Пулом называется именованная группа устройств ККТ, объединённых для распределения заданий на печать между несколькими кассами.

URL: {{HTTPRoot}}/kkt/list/byPool?pool=pool

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

Имя параметра Тип Обяз Назначение Пример
pool string + Название пула. Если пул с указанным названием не найден или в него не включено ни одно устройство, сервер возвращает пустой массив pool

Тело ответа

200 OK

{
    "Result": [
        "Atol",
        "Emu",
        "Shtrih"
    ],
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (массив Devices)

Имя параметра Тип Обяз Назначение Пример
Result string - Название устройства “Atol”,
“Emu”,
“Shtrih”

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

72 Не указано имя пула

{
  "Code": 72,
  "Description": "Не указано имя пула",
  "Success": false
}

GET kkt?device=Atol

Получение подробной информации об устройстве ККТ.

URL: {{HTTPRoot}}/kkt?device=Atol

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

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

Тело ответа

200 OK

{
  "Result": {
    "ServerVersion": "4.0.70.0723",
    "Fn": {
      "Execution": "",
      "FnContainsKeysUpdaterServerUri": false,
      "FiscalizationsCount": 1,
      "FiscalizationsFree": 0,
      "FiscalizationDocumentNumber": "1",
      "FiscalizationDateTime": "2026-06-10T12:30:09",
      "ReasonCode": 3,
      "LivePhase": "fiscalMode",
      "Version": "1.0",
      "RnNumber": "00031415926",
      "FnsUrl": "nalog.ru",
      "SenderEmail": "serverkkm@mail.ru",
      "FfdVersion": "1.2",
      "SerialNumber": "0123123123123",
      "OrganizationName": "\"ООО `РБ-Софт`\"",
      "Vatin": "7722345670",
      "ValidityDate": "2027-07-27T09:47:05.0003584+08:00",
      "SaleAddress": "г.Улан-Удэ, ул.Балтахинова, д17Е, офис 215",
      "SaleLocation": "Офис",
      "TaxVariant": 63,
      "SignOfAgent": 127,
      "AutomaticNumber": "",
      "Ofd": {
        "Name": "Тестовый ОФД",
        "Vatin": "1234554321",
        "Host": "ofd.rbsoft.ru",
        "Port": 7777
      },
      "Warnings": {
        "CriticalError": false,
        "MemoryOverflow": false,
        "NeedReplacement": false,
        "OfdTimeout": false,
        "ResourceExhausted": false
      },
      "Modes": {
        "PrinterAutomatic": false,
        "OfflineMode": false,
        "ServiceSign": true,
        "BsoSign": false,
        "CalcOnlineSign": false,
        "DataEncryption": true,
        "SaleExcisableGoods": true,
        "SignOfGambling": true,
        "SignOfLottery": true,
        "Pawnshop": true,
        "Assurance": true,
        "Marking": true,
        "VendingMachine": true,
        "CateringServices": true,
        "WholesaleTrade": true,
        "AutomaticMode": false
      }
    },
    "Device": {
      "FfdVersion": "1.2",
      "FnFfdVersion": "1.2",
      "TimeZone": 7,
      "KktLicenses": [],
      "IsFiscal": true,
      "LineLength": 64,
      "LineLengthPixels": 0,
      "DeviceClass": 4,
      "Model": "РБ-Софт:Эмулятор ККМ",
      "SerialNumber": "0020260207",
      "FirmwareVersion": "2026",
      "ConfigurationVersion": "02.07"
    },
    "Driver": {
      "Type": "EmulatorFR",
      "Version": "26.01.27",
      "Vendor": "РБ-Софт"
    },
    "Status": {
      "IsFnPresent": true,
      "IsFnError": false,
      "IsIsmDisconnected": false,
      "IsOfdDisconnected": false,
      "Ism": {
        "Address": "ism.rbsoft.ru",
        "Port": 8888,
        "Errors": {
          "FnCommandCode": 0,
          "DocumentNumber": 0,
          "LastSuccessConnectionDateTime": "0001-01-01T00:00:00",
          "Fn": {
            "Code": 0
          },
          "Network": {
            "Code": 0
          },
          "Ism": {
            "Code": 0,
            "Description": ""
          }
        },
        "Backlog": {
          "DocumentsCounter": 0,
          "DocumentFirstNumber": 0,
          "DocumentFirstDateTime": "0001-01-01T00:00:00"
        }
      },
      "Warnings": {
        "CriticalError": false,
        "MemoryOverflow": false,
        "NeedReplacement": false,
        "OfdTimeout": false,
        "ResourceExhausted": false
      },
      "ShiftNumber": 50,
      "DocNumber": 445,
      "DocNumberInShift": 6,
      "CashSum": 2795.80,
      "TotalSum": 600.0,
      "IsFiscal": true,
      "OpenShiftTime": "2026-07-24T15:59:11",
      "IsShiftOpened": true,
      "IsShiftExpired": true,
      "ComputerTime": "2026-07-27T10:07:14.8375644+08:00",
      "DeviceTime": "2026-07-27T10:07:14.8375644+08:00",
      "IsDrawerOpened": false,
      "IsCheckPaperPresent": true,
      "IsControlPaperPresent": false,
      "IsWaitContinuePrint": false,
      "IsCoverOpened": false,
      "IsBatteryLow": false,
      "IsOpenDocument": false,
      "LineLength": 42,
      "LineLengthPixels": 512,
      "TaskId": "00000000-0000-0000-0000-000000000000",
      "Error": 0,
      "IsBusy": false,
      "ErrorCode": 0,
      "ErrorCodeDescription": "OK",
      "DriverMode": 0,
      "DriverModeDescription": "",
      "DriverAdvancedMode": 0,
      "DriverAdvancedModeDescription": "",
      "LicenseStatus": 0,
      "License": {
        "code": 0,
        "isEndUser": false,
        "isActivated": false,
        "isBlocked": false,
        "blockDate": "0001-01-01T00:00:00",
        "date": "0001-01-01T00:00:00",
        "expired": "0001-01-01T00:00:00",
        "updateExpired": "0001-01-01T00:00:00",
        "limitInstalls": 0,
        "needObjectActivation": false,
        "limitObjects": 0,
        "setupTokenIndex": 0,
        "licenseUpdated": "0001-01-01T00:00:00"
      },
      "LicenseUpdated": "0001-01-01T00:00:00"
    }
  },
  "Code": 0,
  "Description": "OK",
  "Success": true
}

Result (DataKkt)

Имя параметра Тип Обяз Назначение Пример
ServerVersion string - Версия сервера ККМ “4.0.70.0723”
Fn FnInfo - Описание фискального накопителя “Fn”: {
“Execution”: “”,
“FnContainsKeysUpdaterServerUri”: false,
“FiscalizationsCount”: 1,
“FiscalizationsFree”: 0,
“FiscalizationDocumentNumber”: “1”,
“FiscalizationDateTime”: “2025-03-16T00:00:00”,
“ReasonCode”: 0,
“LivePhase”: “fiscalMode”,
“Version”: “1.0”,
“RnNumber”: “00031415926”,
“FnsUrl”: “nalog.ru”,
“SenderEmail”: “kuznicov@mail.ru”,
“FfdVersion”: “1.2”,
“SerialNumber”: “0123123123123”,
“OrganizationName”: “ООО ‘Ромашка’“,
“Vatin”: “7722345678”,
“ValidityDate”: “2027-02-15T23:36:30.0725604+08:00”,
“SaleAddress”: “г.Улан-Удэ, ул.Виноградная, д11А, офис 25”,
“SaleLocation”: “Офис”,
“TaxVariant”: 63,
“SignOfAgent”: 127,
“AutomaticNumber”: “”,
“Ofd”: {
“Name”: “Тестовый ОФД”,
“Vatin”: “1234554321”,
“Host”: “ofd.example.ru”,
“Port”: 7777
},
“Warnings”: {
“CriticalError”: false,
“MemoryOverflow”: false,
“NeedReplacement”: false,
“OfdTimeout”: false,
“ResourceExhausted”: false
},
“Modes”: {
“PrinterAutomatic”: false,
“OfflineMode”: false,
“ServiceSign”: true,
“BsoSign”: false,
“CalcOnlineSign”: false,
“DataEncryption”: true,
“SaleExcisableGoods”: true,
“SignOfGambling”: true,
“SignOfLottery”: true,
“Pawnshop”: true,
“Assurance”: true,
“Marking”: true,
“VendingMachine”: true,
“CateringServices”: true,
“WholesaleTrade”: true,
“AutomaticMode”: false
}
}
Device KktInfo - Описание ККМ “Device”:
Driver DriverInfo - Описание драйвера ККМ “Driver”:
Status KktStatus - Состояние обмена с ОФД “Status”: {
“IsFnPresent”: true,
“IsFnError”: false,
“IsIsmDisconnected”: false,
“IsOfdDisconnected”: false,
“Backlog”: {
“DocumentsCounter”: 0,
“DocumentFirstNumber”: 0,
“DocumentFirstDateTime”: “0001-01-01T00:00:00”
},
“ExchangeStatusIsm”: {
“AddressIsm”: “testism.ru”,
“PortIsm”: 20,
“Errors”: {
“FnCommandCode”: 0,
“DocumentNumber”: 0,
“LastSuccessConnectionDateTime”: “0001-01-01T00:00:00”,
“Fn”: {
“Code”: 0
},
“Network”: {
“Code”: 0
},
“Ism”: {
“Code”: 0
}
},
“Status”: {
“DocumentsCounter”: 0,
“DocumentFirstNumber”: 0,
“DocumentFirstDateTime”: “0001-01-01T00:00:00”
},
“Warnings”: {
“DataForSendIsEmpty”: false
}
},
“Warnings”: {
“CriticalError”: false,
“MemoryOverflow”: false,
“NeedReplacement”: false,
“OfdTimeout”: false,
“ResourceExhausted”: false
},
“ShiftNumber”: 4,
“CheckNumber”: 22,
“CheckNumberByShift”: 13,
“CashSum”: 2624.89,
“Sum”: 10588.89,
“IsFiscal”: true,
“OpenShiftTime”: “2026-02-15T00:18:26”,
“IsShiftOpened”: true,
“IsShiftExpired”: false,
“ComputerTime”: “2026-02-15T23:37:05.0357118+08:00”,
“DeviceTime”: “2026-02-15T23:37:05.0357118+08:00”,
“IsDrawerOpened”: false,
“IsCheckPaperPresent”: true,
“IsControlPaperPresent”: false,
“IsWaitContinuePrint”: false,
“IsCoverOpened”: false,
“IsBatteryLow”: false,
“IsOpenDocument”: false,
“LineLength”: 42,
“TaskId”: “00000000-0000-0000-0000-000000000000”,
“Error”: 0,
“IsBusy”: false,
“ErrorCode”: 0,
“ErrorCodeDescription”: “OK”,
“DriverMode”: 0,
“DriverModeDescription”: “”,
“DriverAdvancedMode”: 0,
“DriverAdvancedModeDescription”: “”,
“LicenseStatus”: 0,
“License”: {
“code”: 0,
“isEndUser”: false,
“isActivated”: false,
“isBlocked”: false,
“blockDate”: “0001-01-01T00:00:00”,
“date”: “0001-01-01T00:00:00”,
“expired”: “0001-01-01T00:00:00”,
“updateExpired”: “0001-01-01T00:00:00”,
“limitInstalls”: 0,
“needObjectActivation”: false,
“limitObjects”: 0,
“setupTokenIndex”: 0,
“licenseUpdated”: “0001-01-01T00:00:00”
},
“LicenseUpdated”: “0001-01-01T00:00:00”
}

FnInfo

Имя параметра Тип Обяз Назначение Пример
Execution string - Исполнение ФН ”“
FnContainsKeysUpdaterServerUri bool - ФН содержит URI сервера ОКП false
FiscalizationsCount int - Количество проведенных регистраций 0
FiscalizationsFree int - Количество оставшихся регистраций 0
FiscalizationDocumentNumber string - Номер документа регистрация фискального накопителя “0”
FiscalizationDateTime datetime - Дата и время операции регистрации фискального накопителя “2026-02-15T00:00:00”
ReasonCode int - Код причины перерегистрации: 0 — Нет причины / первичная регистрация (не перерегистрация);
1 — Замена ФН;
2 — Замена ОФД;
3 — Изменение реквизитов;
4 — Изменение настроек ККТ
0
LivePhase string - Фаза жизни ФН:
init - настройка ФН;
configured - настроен, готов в активации;
fiscalMode - фискальный режим;
postFiscalMode - постфискальный режим;
accessArchive - доступ к архиву ФН;
unknown - неизвестная фаза жизни
“fiscalMode”
Version string - Версия ФН “1.0”
RnNumber string - Регистрационный номер ККТ “00031415926”
FnsUrl string - Адрес сайта уполномоченного органа(ФНС) в сети «Интернет» “nalog.ru”
SenderEmail string - Адрес электронной почты отправителя чека “ivanov@mail.ru”
FfdVersion string - Версия ФФД ФН “1.2”
SerialNumber string - Серийный номер ФН “0123123123123”
OrganizationName string - Название организации “ООО ‘Ромашка’“
Vatin string - ИНН организации “7722345678”
ValidityDate datetime - Срок действия ФН “2027-06-08T17:22:38.2396579+08:00”
SaleAddress string - Адрес установки ККТ для проведения расчетов “г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
SaleLocation string - Место проведения расчетов “Офис”
TaxVariant int - Коды систем налогообложения:
1 — Общая (ОСН);
2 — Упрощенная Доход(УСН);
3 — Упрощенная Доход минус Расход(УСНД_Р);
4 — Единый налог на вмененный доход(ЕНВД);
5 — Единый сельскохозяйственный налог(ЕСН);
6 — Патентная система налогообложения(ПСН)
63
SignOfAgent int - Коды признаков агента.
0 — Банковский платежный агент;
1 — Банковский платежный субагент;
2 — Платежный агент;
3 — Платежный субагент;
4— Поверенный;
5 — Комиссионер;
6 — Агент;
127
AutomaticNumber string - Номер автомата ”“
Ofd Ofd - ОФД “Ofd”: {
“Name”: “Тестовый ОФД”,
“Vatin”: “1234554321”,
“Host”: “ofd.example.ru”,
“Port”: 7777
},
Warnings Warnings - Предупреждения ФН “Warnings”:
Modes FnModes - Признаки ФН {…”Modes”: {
“PrinterAutomatic”: false,
“OfflineMode”: false,
“ServiceSign”: true,
“BsoSign”: false,
“CalcOnlineSign”: false,
“DataEncryption”: true,
“SaleExcisableGoods”: true,
“SignOfGambling”: true,
“SignOfLottery”: true,
“Pawnshop”: true,
“Assurance”: true,
“Marking”: true,
“VendingMachine”: true,
“CateringServices”: true,
“WholesaleTrade”: true,
“AutomaticMode”: false
}}

Ofd

Имя параметра Тип Обяз Назначение Пример
Name string - Имя ОФД “Тестовый ОФД”
Vatin string - ИНН ОФД “1234554321”
Host string - Адрес сервера ОФД “ofd.example.ru”
Port int - Порт сервера ОФД 7777

Warnings

Имя параметра Тип Обяз Назначение Пример
CriticalError bool - Критическая ошибка ФН false
MemoryOverflow bool - Память ФН переполнена false
NeedReplacement bool - Требуется срочная замена ФН false
OfdTimeout bool - Превышено время ожидания ответа от ОФД false
ResourceExhausted bool - Исчерпан ресурс ФН false

Тип: FnModes

Имя параметра Тип Обяз Назначение Пример
PrinterAutomatic bool - Признак установки принтера в автомате false
OfflineMode bool - Признак автономного режима false
ServiceSign bool - Признак расчетов за услуги false
BsoSign bool - Признак формирования только БСО false
CalcOnlineSign bool - Признак ККТ для расчетов только в Интернет false
DataEncryption bool - Признак шифрование данных false
SaleExcisableGoods bool - Продажа подакцизного товара false
SignOfGambling bool - Признак проведения азартных игр false
SignOfLottery bool - Признак проведения лотереи false
Pawnshop bool - Признак применения при осуществлении ломбардами кредитования граждан false
Assurance bool - Признак применения при осуществлении деятельности по страхованию false
Marking bool - Признак применения при осуществлении торговли товарами, подлежащими обязательной маркировке средствами идентификации false
VendingMachine bool - Признак применения в автоматическом торговом автомате false
CateringServices bool - Признак применения при оказании услуг общественного питания false
WholesaleTrade bool - Признак применения о оптовой торговле с организациями и ИП false
AutomaticMode bool - Признак автоматического режима false

KktInfo

Имя параметра Тип Обяз Назначение Пример
FfdVersion string - Версия ФФД “1.2
FnFfdVersion string - Версия ФФД ФН “1.2”
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)
7
KktLicenses Массив KktLicenseInfo - Массив лицензий ККТ []
IsFiscal bool - Фискальный режим true
LineLength int - Ширина чековой ленты 64
LineLengthPixels int - Ширина чековой ленты в пикселях 0
DeviceClass int - Тип устройства:
1 — Принтер;
2 — Чековый принтер;
3 — Фискальный регистратор (не онлайн-ккм)
4 — Онлайн-ккм, применяемая в РФ в соответствии с ФЗ-54.
5 — Эквайринговый терминал;
6 — Терминал сбора данных;
7 — Электронные весы;
8 — Электронные весы с печатью этикеток;
9 — Сканер штрихкодов
7
SerialNumber string - Заводской номер ККТ “0020260207”
FirmwareVersion string - Версия прошивки “2026”
ConfigurationVersion string - Версия конфигурации прошивки устройства “02.07”

DriverInfo

Имя параметра Тип Обяз Назначение Пример
Type string - Тип драйвера “Atol”
Version string - Версия драйвера “26.01.27”
Vendor string - Данные поставщика “Atol”

KktStatus

Имя параметра Тип Обяз Назначение Пример
IsFnPresent bool - Присутствует ли фискальный накопитель false
IsFnError bool - Находится ли фискальный накопитель в состоянии ошибки false
IsIsmDisconnected bool - Доступен ли информационной системы маркировки false
IsOfdDisconnected bool - Доступен ли оператор информационной системы маркировки false
Backlog Backlog - Данные о непереданных документах “Backlog”:
Ism ExchangeStatusIsm - Состояние обмена с ИСМ “ExchangeStatusIsm”: {
“AddressIsm”: “testism.ru”,
“PortIsm”: 20,
“Errors”: {
“FnCommandCode”: 0,
“DocumentNumber”: 0,
“LastSuccessConnectionDateTime”: “0001-01-01T00:00:00”,
“Fn”: {
“Code”: 0
},
“Network”: {
“Code”: 0
},
“Ism”: {
“Code”: 0
}
},
“Status”: {
“DocumentsCounter”: 0,
“DocumentFirstNumber”: 0,
“DocumentFirstDateTime”: “0001-01-01T00:00:00”
},
“Warnings”: {
“DataForSendIsEmpty”: false
}
}
Warnings Warnings - Предупреждения ФН “Warnings”:
ShiftNumber int - Номер смены 17
DocNumber int - Номер фискального документа 98
DocNumberInShift int - Номер фискального документа за смену 3
CashSum decimal - Сумма наличных в денежном ящике 2128.0
TotalSum decimal - Сумма выручки 0.0
IsFiscal bool - Фискальный true
OpenShiftTime DateTime - Время открытия кассовой смены “0001-01-01T00:00:00”
IsShiftOpened bool - Смена открыта false
IsShiftExpired bool - Смена истекла false
ComputerTime DateTime - Время получения данных “2026-05-23T19:50:04.7531056+08:00”
DeviceTime DateTime - Время в часах устройства “2026-05-23T19:50:04.7531056+08:00”
IsDrawerOpened bool - Открыт денежный ящик false
IsCheckPaperPresent bool - Наличие чековой ленты false
IsControlPaperPresent bool - Наличие контрольной ленты false
IsWaitContinuePrint bool - Ожидание продолжения печати false
IsCoverOpened bool - Открыта ли крышка false
IsBatteryLow bool - Аккумулятор разряжен false
IsOpenDocument bool - Открытый документ false
LineLength int - Ширина чековой ленты 42
LineLengthPixels int - Ширина чековой ленты в пикселях 512
TaskId string - Идентификатор текущей задачи “00000000-0000-0000-0000-000000000000”
Error int - Код ошибки 0
ErrorCodeDescription string - Описание ошибки устройства по данным драйвера “OK”
DriverMode int - Режим по данным драйвера 0
DriverModeDescription string - Описание режима Mode по данным драйвера ”“
DriverAdvancedMode int - Специальный режим по данным драйвера 0
DriverAdvancedModeDescription string - Описание режима AdvancedMode по данным драйвера 0
LicenseStatus int - Статус состояния лицензии 0
License License - Описание лицензии “License”:
LicenseUpdated DateTime - Время последней проверке лицензии “0001-01-01T00:00:00”

ExchangeStatusIsm

Имя параметра Тип Обяз Назначение Пример
Address string - Адрес сервера информационной системы маркировки “ism.example.ru”
Port int - Порт сервера информационной системы маркировки 8888
Errors ErrorsIsm - Сведения об ошибках обмена данными “Errors”: {
“FnCommandCode”: 0,
“DocumentNumber”: 0,
“LastSuccessConnectionDateTime”: “0001-01-01T00:00:00”,
“Fn”: {
“Code”: 0
},
“Network”: {
“Code”: 0
},
“Ism”: {
“Code”: 0,
“Description”: “”
}
}
Backlog Backlog - Сведения о непереданных документах “Backlog”:

ErrorsIsm

Имя параметра Тип Обяз Назначение Пример
FnCommandCode int - Код команды фискального накопителя 0
DocumentNumber int - Номер документа 0
LastSuccessConnectionDateTime DateTime - Время последнего успешного подключения “0001-01-01T00:00:00”
Fn FnErrors - Код ошибки фискального накопителя “Fn”: {
“Code”: 0
},
Network NetworkErrors - Код ошибки сети “Network”:
Ism IsmErrors - Код ошибки информационной системы маркировки “Ism”:

FnErrors

Имя параметра Тип Обяз Назначение Пример
Code int - Код ошибки ФН 0

NetworkErrors

Имя параметра Тип Обяз Назначение Пример
Code int - Код ошибки сети 0

IsmErrors

Имя параметра Тип Обяз Назначение Пример
Code int - Код ошибки ИСМ 0
Description string - Описание ошибки “Нет ошибок”

Backlog

Имя параметра Тип Обяз Назначение Пример
DocumentsCounter int - Количество непереданных документов 0
DocumentFirstNumber int - Номер первого непереданного документ 0
DocumentFirstDateTime DateTime - Дата и время первого из непереданных документов “0001-01-01T00:00:00”

Warnings

Имя параметра Тип Обяз Назначение Пример
CriticalError bool - Критическая ошибка ФН false
MemoryOverflow bool - Память ФН переполнена false
NeedReplacement bool - Требуется срочная замена ФН false
OfdTimeout bool - Превышено время ожидания ответа от ОФД false
ResourceExhausted bool - Исчерпан ресурс ФН false

License

Имя параметра Тип Обяз Назначение Пример
code int - Код ошибки 0
isEndUser bool - Признак лицензии на конечного пользователя.
true — лицензия выдана конечному пользователю.
false — лицензия выдана партнеру для перепродажи
false
isActivated bool - Признак активации false
isBlocked bool - Признак блокировки 0
blockDate DateTime - Дата блокировки “0001-01-01T00:00:00”
date DateTime - Дата продажи “0001-01-01T00:00:00”
expired DateTime - Дата истечения срока действия “0001-01-01T00:00:00”
updateExpired DateTime - Дата истечения доступа к обновлениям “0001-01-01T00:00:00”
limitInstalls int - Количество разрешенных привязок равно числу ККМ, которые можно привязать к одной лицензии 0
needObjectActivation bool - Признак необходимости привязки объектов лицензирования после привязки. 0
limitObjects int - Количество объектов привязки на каждую установку 0
setupTokenIndex int - Индекс установочного токена 0
LicenseUpdated DateTime - Время последней проверке лицензии “0001-01-01T00:00:00”

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

709 Устройство не найдено

{
    "Code": 709,
    "Description": "Устройство Atol не найдено",
    "Success": false
}

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

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

POST kkt

Добавление устройства ККТ.

URL: {{HTTPRoot}}/kkt

Тело запроса

{
  "DeviceName": "MyKkt054",
  "Settings": {
    "DeviceType": 1,
    "Available": true,
    "DeviceName": "MyKkt054",

    "MethodConnection": 0,
    "PortNumber": 1,
    "BaudRate": 9600,
    "IpAddress": "192.168.0.109",
    "TcpPort": 7778,

    "Password": "30",

    "SerialNumber": "0392790042005043",

    "SenderEmail": "noreply@example.com",
    "Cashier": "Иванов А.И.",
    "CashierVatin": "7722345678",

    "Vatin": "7700000000",
    "OrganizationName": "ООО Ромашка",
    "SaleAddress": "г. Москва, ул. Пример, д. 1",
    "ClientSaleLocation": "Торговый зал",

    "TimeoutConnection": 5000,
    "TimeoutWaitForPrinting": 60000,

    "OfdAddress": "ofd.example.ru",
    "OfdPort": 7777
  }
}
Имя поля Тип Обяз Назначение Пример
DeviceName string + Имя устройства “Atol”
Settings DeviceSettings + Настройки устройства. Обязателен к передаче, но отдельные поля внутри необязательны “Settings”: {
“DeviceType”: 1,
“Available”: true,
“DeviceName”: “MyKkt054”,
“MethodConnection”: 0,
“PortNumber”: 1,
“BaudRate”: 9600,
“IpAddress”: “192.168.0.109”,
“TcpPort”: 7778,
“Password”: “30”,
“SerialNumber”: “0392790042005043”,
“SenderEmail”: "noreply@example.com”,
“Cashier”: “Иванов А.И.”,
“CashierVatin”: “7722345678”,
“Vatin”: “7700000000”,
“OrganizationName”: “ООО Ромашка”,
“SaleAddress”: “г. Москва, ул. Пример, д. 1”,
“ClientSaleLocation”: “Торговый зал”,
“TimeoutConnection”: 5000,
“TimeoutWaitForPrinting”: 60000,
“OfdAddress”: “ofd.example.ru”,
“OfdPort”: 7777
}

Тип DeviceSettings

Имя поля Тип Обяз Назначение Пример
DeviceName string + Имя устройства. Должно совпадать со значением поля DeviceName, указанным непосредственно в теле запроса. “Atol”
DeviceType int + Тип драйвера:
1 — Shtrih;
2 — 1С(4.7);
3 — Atol;
4 — RrElectro;
5 — 1С(5.0);
100 — Эмулятор.
1
Available bool - Признак доступности устройства. Если указано значение true, сервер немедленно предпринимает попытку подключения к устройству. Если подключиться не удалось, значение автоматически сбрасывается в false, при этом запрос на добавление устройства всё равно завершается успешно. true
MethodConnection int + Метод подключения: 0 — COM;
1 — TCP/IP
0
PortNumber int - Номер COM-порта.
Обязателен при MethodConnection=0
1
BaudRate int - Скорость COM-порта.
Обязателен при MethodConnection=0
9600
IpAddress string - IP-адрес.
Обязателен при MethodConnection=1
“192.168.0.109”
TcpPort int - TCP-порт.
Обязателен при MethodConnection=1
7778
Password string + Пароль устройства (пароль доступа к драйверу ККТ) “30”
AccessPassword string - Пароль доступа к настройкам устройства (не путать с паролем устройства Password) “0000”
SerialNumber string - Серийный номер устройства “0392790042005043”
Vatin string - ИНН организации “7722345678”
OrganizationName string - Название организации “ООО Ромашка”
SaleAddress string - Адрес расчётов “г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
ClientSaleLocation string - Место расчётов “Офис”
Cashier string - ФИО кассира по умолчанию “Иванов А.И.”
CashierVatin string - ИНН кассира “7722345678”
SenderEmail string - Email отправителя чека “ivanov@mail.ru”
TimeoutConnection int - Таймаут подключения к устройству, в миллисекундах.

Если не указан или указано значение 0 — применяется значение по умолчанию, равное 5000 мс.
5000
TimeoutWaitForPrinting int - Таймаут ожидания завершения печати, в миллисекундах.

Если не указан или указано значение 0 — применяется значение по умолчанию, равное 5000 мс.
60000
OfdAddress string - Адрес ОФД “ofd.example.ru”
OfdPort int - Порт ОФД 7777
Pool string - Имя пула, в который включается устройство.

Если не указано — устройство не входит ни в один пул.
“pool”

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

OK

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

-1 Устройство с таким именем уже существует

{
    "Code": -1,
    "Description": "ошибка: Ошибка добавления устройства. Устройство с таким именем уже существует",
    "Success": false
}

DELETE kkt?device=Atol

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

URL: {{HTTPRoot}}/kkt?device=Atol

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

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

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

OK

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

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

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

PUT kkt

Редактирование параметров устройства ККТ.

URL: {{HTTPRoot}}/kkt

Тело запроса

{
  "DeviceName": "MyKkt045",
  "Settings": {
    "DeviceName": "MyKkt042",
    "DeviceType": 1,
    "MethodConnection": 0,
    "PortNumber": 1,
    "BaudRate": 9600,
    "IpAddress": "192.168.0.101",
    "TcpPort": 7778,
    "Password": "30",
    "AccessPassword": "0000",
    "UseAccessPassword": false,
    "TimeoutConnection": 5000,
    "TimeoutWaitForPrinting": 60000,
    "Available": true
  }
}

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

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

ОК

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

-1 Устройство не поддерживает метод UpdateKKM

{
    "Code": -1,
    "Description": "ошибка: Ошибка обновления устройства: Устройство не поддерживает метод UpdateKKM",
    "Success": false
}

GET kkt/lineLength?device=Atol

Получение максимальной ширины строки чека устройства.

URL: {{HTTPRoot}}/kkt/lineLength?device=Atol

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

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

Тело ответа

200 OK

{
    "Result": {
        "LineLength": 64,
        "LineLengthPixels": 512
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (LineLength)

Имя параметра Тип Обяз Назначение Пример
LineLength int - Ширина чековой ленты в символах 42
LineLengthPixels int - Ширина чековой ленты в пикселях 384

GET kkt/status?device=Atol

Получение расширенного статуса ККТ.

URL: {{HTTPRoot}}/kkt/status?device=Atol

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

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

Тело ответа

200 OK

{
    "Result": {
        "IsFnPresent": true,
        "IsFnError": false,
        "IsIsmDisconnected": false,
        "IsOfdDisconnected": false,
        "Ism": {
            "Address": "ism.example.ru",
            "Port": 8888,
            "Errors": {
                "FnCommandCode": 0,
                "DocumentNumber": 0,
                "LastSuccessConnectionDateTime": "0001-01-01T00:00:00",
                "Fn": {
                    "Code": 0
                },
                "Network": {
                    "Code": 0
                },
                "Ism": {
                    "Code": 0,
                    "Description": ""
                }
            },
            "Backlog": {
                "DocumentsCounter": 0,
                "DocumentFirstNumber": 0,
                "DocumentFirstDateTime": "0001-01-01T00:00:00"
            }
        },
        "Warnings": {
            "CriticalError": false,
            "MemoryOverflow": false,
            "NeedReplacement": false,
            "OfdTimeout": false,
            "ResourceExhausted": false
        },
        "ShiftNumber": 0,
        "DocNumber": 0,
        "DocNumberInShift": 0,
        "CashSum": 0,
        "TotalSum": 0,
        "IsFiscal": true,
        "OpenShiftTime": "0001-01-01T00:00:00",
        "IsShiftOpened": false,
        "IsShiftExpired": false,
        "ComputerTime": "2026-05-23T21:54:46.9737064+08:00",
        "DeviceTime": "2026-05-23T21:54:46.9737064+08:00",
        "IsDrawerOpened": false,
        "IsCheckPaperPresent": true,
        "IsControlPaperPresent": false,
        "IsWaitContinuePrint": false,
        "IsCoverOpened": false,
        "IsBatteryLow": false,
        "IsOpenDocument": false,
        "LineLength": 42,
        "LineLengthPixels": 512,
        "TaskId": "00000000-0000-0000-0000-000000000000",
        "Error": 0,
        "IsBusy": false,
        "ErrorCode": 0,
        "ErrorCodeDescription": "OK",
        "DriverMode": 0,
        "DriverModeDescription": "",
        "DriverAdvancedMode": 0,
        "DriverAdvancedModeDescription": "",
        "LicenseStatus": 0,
        "License": {
            "code": 0,
            "isEndUser": false,
            "isActivated": false,
            "isBlocked": false,
            "blockDate": "0001-01-01T00:00:00",
            "date": "0001-01-01T00:00:00",
            "expired": "0001-01-01T00:00:00",
            "updateExpired": "0001-01-01T00:00:00",
            "limitInstalls": 0,
            "needObjectActivation": false,
            "limitObjects": 0,
            "setupTokenIndex": 0,
            "licenseUpdated": "0001-01-01T00:00:00"
        },
        "LicenseUpdated": "0001-01-01T00:00:00"
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (KktStatus)

Имя параметра Тип Обяз Назначение Пример
IsFnPresent bool - Присутствует ли фискальный накопитель false
IsFnError bool - Находится ли фискальный накопитель в состоянии ошибки false
IsIsmDisconnected bool - Доступен ли информационной системы маркировки false
IsOfdDisconnected bool - Доступен ли оператор информационной системы маркировки false
Ism ExchangeStatusIsm - Состояние обмена с ИСМ “Ism”: {
“Address”: “ism.example.ru”,
“Port”: 8888,
“Errors”: {
“FnCommandCode”: 0,
“DocumentNumber”: 0,
“LastSuccessConnectionDateTime”: “0001-01-01T00:00:00”,
“Fn”: { “Code”: 0 },
“Network”: { “Code”: 0 },
“Ism”: { “Code”: 0, “Description”: “” }
},
“Backlog”: {
“DocumentsCounter”: 0,
“DocumentFirstNumber”: 0,
“DocumentFirstDateTime”: “0001-01-01T00:00:00”
}
}
ShiftNumber int + Смена 4
DocNumber int + Номер чека 22
CashSum decimal + Сумма наличных в денежном ящике 2624.89
TotalSum decimal - Сумма выручки 110.0
IsFiscal bool - Фискальный режим true
OpenShiftTime DateTime - Время открытия кассовой смены “2026-05-23T19:50:04.7531056+08:00”
IsShiftOpened bool - Смена открыта false
IsShiftExpired bool - Смена истекла false
ComputerTime DateTime - Время получения данных “2026-05-23T19:50:04.7531056+08:00”
DeviceTime DateTime - Время в часах устройства “2026-05-23T19:50:04.7531056+08:00”
IsDrawerOpened bool - Открыт денежный ящик false
IsCheckPaperPresent bool - Наличие чековой ленты false
IsControlPaperPresent bool - Наличие контрольной ленты false
IsWaitContinuePrint bool - Ожидание продолжения печати false
IsCoverOpened bool - Открыта ли крышка false
IsBatteryLow bool - Аккумулятор разряжен false
IsOpenDocument bool - - Открытый документ
LineLength int - Ширина чековой ленты 42
LineLengthPixels int - Ширина чековой ленты в пикселях 512
TaskId string - Идентификатор текущей задачи “24f4bffe-98ef-4627-846c-b1f74c5a495b”
Error int - Код ошибки 0
IsBusy bool - Признак занятости устройства false
ErrorCode int - Код ошибки 0
ErrorCodeDescription string - Описание ошибки устройства по данным драйвера “OK”
DriverMode int - Режим по данным драйвера 0
DriverModeDescription string - Описание режима Mode по данным драйвера ”“
DriverAdvancedMode int - Специальный режим по данным драйвера 0
DriverAdvancedModeDescription string - Описание режима AdvancedMode по данным драйвера 0
LicenseStatus int - Статус состояния лицензии 0
LicenseUpdated DateTime - Время последней проверке лицензии “0001-01-01T00:00:00”
Warnings Warnings - Предупреждения ФН “Warnings”:
License License - Описание лицензии “License”:

ExchangeStatusIsm

Имя параметра Тип Обяз Назначение Пример
Address string - Адрес сервера информационной системы маркировки “ism.example.ru”
Port int - Порт сервера информационной системы маркировки 8888
Errors ErrorsIsm - Сведения об ошибках обмена данными “Errors”: {
“FnCommandCode”: 0,
“DocumentNumber”: 0,
“LastSuccessConnectionDateTime”: “0001-01-01T00:00:00”,
“Fn”: { “Code”: 0 },
“Network”: { “Code”: 0 },
“Ism”: { “Code”: 0, “Description”: “” }
}
Backlog Backlog - Сведения о непереданных документах “Backlog”:

ErrorsIsm

Имя параметра Тип Обяз Назначение Пример
FnCommandCode int - Код команды фискального накопителя 0
DocumentNumber int - Номер документа 0
LastSuccessConnectionDateTime DateTime - Время последнего успешного подключения “0001-01-01T00:00:00”
Fn FnErrors - Код ошибки фискального накопителя “Fn”:
Network NetworkErrors - Код ошибки сети “Network”:
Ism IsmErrors Код ошибки информационной системы маркировки “Ism”:

FnErrors

Имя параметра Тип Обяз Назначение Пример
Code int - Код ошибки ФН 0

NetworkErrors

Имя параметра Тип Обяз Назначение Пример
Code int - Код ошибки сети 0

IsmErrors

Имя параметра Тип Обяз Назначение Пример
Code int - Код ошибки ИСМ 0
Description string - Описание ошибки “Нет ошибок”

Backlog

Имя параметра Тип Обяз Назначение Пример
DocumentsCounter int - Количество непереданных документов 0
DocumentFirstNumber int - Номер первого непереданного документ 0
DocumentFirstDateTime DateTime - Дата и время первого из непереданных документов “0001-01-01T00:00:00”

Warnings

Имя параметра Тип Обяз Назначение Пример
CriticalError bool - Критическая ошибка ФН false
MemoryOverflow bool - Память ФН переполнена false
NeedReplacement bool - Требуется срочная замена ФН false
OfdTimeout bool - Превышено время ожидания ответа от ОФД false
ResourceExhausted bool - Исчерпан ресурс ФН false

License

Имя параметра Тип Обяз Назначение Пример
code int - Код ошибки лицензирования 0
isEndUser bool - Признак лицензии, выданной конечному пользователю.
true — лицензия выдана конечному пользователю.
false — лицензия выдана партнёру для перепродажи
false
isActivated bool - Признак активации лицензии false
isBlocked bool - Признак блокировки лицензии false
blockDate DateTime - Дата блокировки “0001-01-01T00:00:00”
date DateTime - Дата продажи лицензии “0001-01-01T00:00:00”
expired DateTime - Дата истечения срока действия лицензии “0001-01-01T00:00:00”
updateExpired DateTime - Дата истечения доступа к обновлениям “0001-01-01T00:00:00”
limitInstalls int - Количество разрешённых привязок лицензии, равное числу ККТ, которые допускается привязать к одной лицензии 0
needObjectActivation bool - Признак необходимости привязки объектов лицензирования после привязки лицензии false
limitObjects int - Количество объектов привязки на каждую установку 0
setupTokenIndex int - Индекс установочного токена 0
licenseUpdated DateTime - Время последней проверки лицензии “0001-01-01T00:00:00”

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

-1 Не удалось найти устройство по deviceName

{
    "Result": {
        "IsFnPresent": false,
        "IsFnError": false,
        "IsIsmDisconnected": false,
        "IsOfdDisconnected": false,
        "Ism": {
            "Port": 0,
            "Errors": {
                "FnCommandCode": 0,
                "DocumentNumber": 0,
                "LastSuccessConnectionDateTime": "0001-01-01T00:00:00",
                "Fn": {
                    "Code": 0
                },
                "Network": {
                    "Code": 0
                },
                "Ism": {
                    "Code": 0
                }
            },
            "Backlog": {
                "DocumentsCounter": 0,
                "DocumentFirstNumber": 0,
                "DocumentFirstDateTime": "0001-01-01T00:00:00"
            }
        },
        "Warnings": {
            "CriticalError": false,
            "MemoryOverflow": false,
            "NeedReplacement": false,
            "OfdTimeout": false,
            "ResourceExhausted": false
        },
        "ShiftNumber": 0,
        "DocNumber": 0,
        "DocNumberInShift": 0,
        "CashSum": 0,
        "TotalSum": 0,
        "IsFiscal": false,
        "OpenShiftTime": "0001-01-01T00:00:00",
        "IsShiftOpened": false,
        "IsShiftExpired": false,
        "ComputerTime": "2026-06-08T09:49:48.6278913+08:00",
        "DeviceTime": "2026-06-08T09:49:48.6278913+08:00",
        "IsDrawerOpened": false,
        "IsCheckPaperPresent": false,
        "IsControlPaperPresent": false,
        "IsWaitContinuePrint": false,
        "IsCoverOpened": false,
        "IsBatteryLow": false,
        "IsOpenDocument": false,
        "LineLength": 0,
        "LineLengthPixels": 0,
        "TaskId": "00000000-0000-0000-0000-000000000000",
        "Error": 0,
        "IsBusy": false,
        "ErrorCode": -1,
        "ErrorCodeDescription": "GetDeviceStatus: Не удалось найти устройство по deviceName = Atol.",
        "DriverMode": 0,
        "DriverModeDescription": "",
        "DriverAdvancedMode": 0,
        "DriverAdvancedModeDescription": "",
        "LicenseStatus": 0,
        "LicenseUpdated": "0001-01-01T00:00:00"
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

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

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

GET kkt/shift/status?device=Atol

Получение краткого статуса смены и очереди ОФД.

URL: {{HTTPRoot}}/kkt/shift/status?device=Atol

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

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

Тело ответа

200 OK

{
    "Result": {
        "ShiftNumber": 0,
        "CheckNumber": 0,
        "ShiftState": 1,
        "Backlog": {
            "DocumentsCounter": 0,
            "DocumentFirstNumber": 0,
            "DocumentFirstDateTime": "0001-01-01T00:00:00"
        }
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (ResponseCurrentStatus)

Имя параметра Тип Обяз Назначение Пример
ShiftNumber int + Номер смены 4
CheckNumber int + Номер последнего фискального документа 22
ShiftState int - Состояние смены:
1 — закрыта,
2 — открыта,
3 — истекла
2
Backlog Backlog - Статус обмена данными с ОФД “Backlog”:

Backlog

Имя параметра Тип Обяз Назначение Пример
DocumentsCounter int - Количество непереданных документов 0
DocumentFirstNumber int - Номер первого непереданного документа 0
DocumentFirstDateTime datetime - Дата первого непереданного документа “0001-01-01T00:00:00”

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

-1 Не удалось найти устройство по deviceName

{
    "Code": -1,
    "Description": "GetDeviceStatus: Не удалось найти устройство по deviceName = Atol.",
    "Success": false
}

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

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

GET kkt/counters/shift?device=Atol

Получение счётчики за смену.

URL: {{HTTPRoot}}/kkt/counters/shift?device=Atol

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

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

Тело ответа

200 OK

{
    "Result": {
        "ShiftNumber": 40,
        "CashDrawer": {
            "Sum": 1365.68,
            "Count": 0
        },
        "ShiftIncome": {
            "Count": 0,
            "Sum": 0
        },
        "ShiftOutcome": {
            "Count": 0,
            "Sum": 0
        },
        "Counters": {
            "SumCorrection": 0,
            "NumberCorrections": 0,
            "Sales": {
                "Count": 1,
                "Sum": 50,
                "Payments": {
                    "Sum": 0,
                    "Cash": 50
                },
                "Discount": {
                    "Count": 0,
                    "Sum": 0
                },
                "Adding": {
                    "Count": 0,
                    "Sum": 0
                },
                "Tax": {
                    "TaxVat_5": 2.38
                }
            },
            "SalesReturn": {
                "Count": 0,
                "Sum": 0,
                "Payments": {
                    "Sum": 0
                },
                "Discount": {
                    "Count": 0,
                    "Sum": 0
                },
                "Adding": {
                    "Count": 0,
                    "Sum": 0
                },
                "Tax": {}
            },
            "SalesCorrection": {
                "Count": 0,
                "Sum": 0,
                "Payments": {
                    "Sum": 0
                },
                "Discount": {
                    "Count": 0,
                    "Sum": 0
                },
                "Adding": {
                    "Count": 0,
                    "Sum": 0
                },
                "Tax": {}
            },
            "SalesReturnCorrection": {
                "Count": 0,
                "Sum": 0,
                "Payments": {
                    "Sum": 0
                },
                "Discount": {
                    "Count": 0,
                    "Sum": 0
                },
                "Adding": {
                    "Count": 0,
                    "Sum": 0
                },
                "Tax": {}
            },
            "Purchases": {
                "Count": 0,
                "Sum": 0,
                "Payments": {
                    "Sum": 0
                },
                "Discount": {
                    "Count": 0,
                    "Sum": 0
                },
                "Adding": {
                    "Count": 0,
                    "Sum": 0
                },
                "Tax": {}
            },
            "PurchasesReturn": {
                "Count": 0,
                "Sum": 0,
                "Payments": {
                    "Sum": 0
                },
                "Discount": {
                    "Count": 0,
                    "Sum": 0
                },
                "Adding": {
                    "Count": 0,
                    "Sum": 0
                },
                "Tax": {}
            },
            "PurchasesCorrection": {
                "Count": 0,
                "Sum": 0,
                "Payments": {
                    "Sum": 0
                },
                "Discount": {
                    "Count": 0,
                    "Sum": 0
                },
                "Adding": {
                    "Count": 0,
                    "Sum": 0
                },
                "Tax": {}
            },
            "PurchasesReturnCorrection": {
                "Count": 0,
                "Sum": 0,
                "Payments": {
                    "Sum": 0
                },
                "Discount": {
                    "Count": 0,
                    "Sum": 0
                },
                "Adding": {
                    "Count": 0,
                    "Sum": 0
                },
                "Tax": {}
            }
        }
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (ResShiftTotal)

Имя параметра Тип Обяз Назначение Пример
ShiftNumber double - Номер смены 40.0
CashDrawer CashDrawer - Детали денежного ящиика “CashDrawer”:
ShiftIncome ShiftIncome - Внесение “ShiftIncome”:
ShiftOutcome ShiftIncome - Выемка “ShiftOutcome”:
Counters ShiftCounters - Счётчики за кассовую смену “Counters”: {
“SumCorrection”: 0,
“NumberCorrections”: 0,
“Sales”: {
“Count”: 1,
“Sum”: 50,
“Payments”: {
“Sum”: 0,
“Cash”: 50
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {
“TaxVat_5”: 2.38
}
},
“SalesReturn”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“SalesCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“SalesReturnCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“Purchases”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“PurchasesReturn”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“PurchasesCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“PurchasesReturnCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}
}

CashDrawer

Имя параметра Тип Обяз Назначение Пример
Sum decimal - Сумма 1365.68
Count int - Количество 7

ShiftIncome

Имя параметра Тип Обяз Назначение Пример
Count int - Количество 0
Sum decimal - Сумма 0.0

Тип: ShiftCounters

Имя параметра Тип Обяз Назначение Пример
SumCorrection decimal - Сумма коррекций 0.0
NumberCorrections int - Количество коррекций 0
Sales DocData - Чеки прихода “Sales”: {
“Count”: 0,
“Sum”: 50,
“Payments”: {
“Sum”: 24739.54,
“Cash”: 25163.08,
“Credit”: 9400.00,
“Electronically”: 4949.54,
“Barter”: 2350.00,
“Prepaid”: 4700.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_20”: 93.03,
“TaxVat_7”: 1536.90
}
}
SalesReturn DocData Чеки возврата прихода “SalesReturn”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
SalesCorrection DocData - Чеки прихода “SalesCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
SalesReturnCorrection DocData - Чеки возврата прихода “SalesReturnCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
Purchases DocData - Чеки расхода “Purchases”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
PurchasesReturn DocData - Чеки возврата расхода “PurchasesReturn”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
PurchasesCorrection DocData - Чеки расхода “PurchasesCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
PurchasesReturnCorrection DocData - Чеки возврата расхода “PurchasesReturnCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
}

DocData

Имя параметра Тип Обяз Назначение Пример
Count int - Количество 0
Sum decimal - Сумма 50.0
Payments DocDataPayments - Оплаты “Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
Discount RegData - Скидка Discount”:
Adding RegData - Надбавки “Adding”:
Tax Taxes - Налоги “Tax”:

DocDataPayments

Имя параметра Тип Обяз Назначение Пример
Sum decimal - Общая сумма чеков 50.0
Cash decimal - Сумма оплат наличными 50.0

RegData

Имя параметра Тип Обяз Назначение Пример
Count int - Количество 0
Sum decimal - Сумма 0.0

Taxes

Имя параметра Тип Обяз Назначение Пример
TaxVat_5 decimal - Ставка НДС 5% 0.0

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

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

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

POST kkt/reboot

Перезагрузка устройства.

URL: {{HTTPRoot}}/kkt/reboot

Тело запроса

{
    "DeviceName":"Atol"
}
Имя поля Тип Обяз Назначение Пример
DeviceName string + Имя устройства “Atol”

Тело ответа

200 OK

{
    "Code": 0,
    "Description": "ОК",
    "Success": false
}

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

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

{
    "Code": 2,
    "Description": "RebootDevice(): Не найдено устройство Atol.",
    "Success": false
}

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

{
    "Code": 2,
    "Description": "Bad Request",
    "Success": false
}

POST kkt/font/setting

Редактирование настроек шрифта шаблона для устройства.

URL: {{HTTPRoot}}/kkt/font/setting

Тело запроса

{
    "DeviceName": "Atol",
    "Settings": {
        "TemplateId": "lines2",
        "TemplateSettingH1": "1",
        "TemplateSettingH2": "1",
        "TemplateSettingH3": "2",
        "TemplateSettingH4": "2",
        "TemplateSettingH5": "2"
    }
}
Имя поля Тип Обяз Назначение Пример
DeviceName string + Имя устройства “Atol”
Settings DeviceSettings + Настройки шрифта шаблона. “Settings”:

Тип: DeviceSettings

Имя поля Тип Обяз Назначение Пример
Name string + Название шаблона “lines2”
TemplateSettingH1 string - Номер шрифта заголовка H1. Если не указано — ранее сохранённое значение стирается. “1”
TemplateSettingH2 string - Номер шрифта заголовка H2. Если не указано — ранее сохранённое значение стирается. “1”
TemplateSettingH3 string - Номер шрифта заголовка H3. Если не указано — ранее сохранённое значение стирается. “2”
TemplateSettingH4 string - Номер шрифта заголовка H4. Если не указано — ранее сохранённое значение стирается. “2”
TemplateSettingH5 string - Номер шрифта заголовка H5. Если не указано — ранее сохранённое значение стирается. “2”

Тело ответа

200 OK

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

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

709 Устройство не найдено

{
    "Code": 709,
    "Description": "Устройство  не найдено",
    "Success": false
}

GET pool/list

Получение списка всех пулов.

URL: {{HTTPRoot}}/pool/list

Тело ответа

200 OK

{
    "Result": [
        "asd"
    ],
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (массив пулов)

Имя поля Тип Обяз Назначение Пример
Result Массив string - Название пулов “asd”,
“dsa”

GET kkt/counters/overall?device=Atol

Получение необнуляемых (накопительных) счетчиков ККТ.

URL: {{HTTPRoot}}/kkt/counters/overall?device=Atol

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

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

Тело ответа

200 ОК

{
  "Result": {
    "DataLoaded": true,
    "Sum": 0.0,
    "Count": 0,
    "Counters": {
      "SumCorrection": 0.0,
      "NumberCorrections": 0,
      "Sales": {
        "Count": 266,
        "Sum": 24739.54,
        "Payments": {
          "Sum": 24739.54,
          "Cash": 25163.08,
          "Credit": 9400.00,
          "Electronically": 4949.54,
          "Barter": 2350.00,
          "Prepaid": 4700.00
        },
        "Discount": {
          "Count": 0,
          "Sum": 0.0
        },
        "Adding": {
          "Count": 0,
          "Sum": 0.0
        },
        "Tax": {
          "TaxVat_20": 93.03,
          "TaxVat_7": 1536.90
        }
      },
      "SalesReturn": {
        "Count": 45,
        "Sum": 4500.0,
        "Payments": {
          "Sum": 4500.0,
          "Cash": 4500.00,
          "Credit": 1800.00,
          "Electronically": 900.00,
          "Barter": 450.00,
          "Prepaid": 900.00
        },
        "Discount": {
          "Count": 0,
          "Sum": 0.0
        },
        "Adding": {
          "Count": 0,
          "Sum": 0.0
        },
        "Tax": {
          "TaxVat_7": 294.30
        }
      },
      "SalesCorrection": {
        "Count": 45,
        "Sum": 4500.0,
        "Payments": {
          "Sum": 4500.0,
          "Cash": 4500.00,
          "Credit": 1800.00,
          "Electronically": 900.00,
          "Barter": 450.00,
          "Prepaid": 900.00
        },
        "Discount": {
          "Count": 0,
          "Sum": 0.0
        },
        "Adding": {
          "Count": 0,
          "Sum": 0.0
        },
        "Tax": {
          "TaxVat_7": 294.30
        }
      },
      "SalesReturnCorrection": {
        "Count": 45,
        "Sum": 4500.0,
        "Payments": {
          "Sum": 4500.0,
          "Cash": 4500.00,
          "Credit": 1800.00,
          "Electronically": 900.00,
          "Barter": 450.00,
          "Prepaid": 900.00
        },
        "Discount": {
          "Count": 0,
          "Sum": 0.0
        },
        "Adding": {
          "Count": 0,
          "Sum": 0.0
        },
        "Tax": {
          "TaxVat_7": 294.30
        }
      },
      "Purchases": {
        "Count": 45,
        "Sum": 4500.0,
        "Payments": {
          "Sum": 4500.0,
          "Cash": 4500.00,
          "Credit": 1800.00,
          "Electronically": 900.00,
          "Barter": 450.00,
          "Prepaid": 900.00
        },
        "Discount": {
          "Count": 0,
          "Sum": 0.0
        },
        "Adding": {
          "Count": 0,
          "Sum": 0.0
        },
        "Tax": {
          "TaxVat_7": 294.30
        }
      },
      "PurchasesReturn": {
        "Count": 45,
        "Sum": 4500.0,
        "Payments": {
          "Sum": 4500.0,
          "Cash": 4500.00,
          "Credit": 1800.00,
          "Electronically": 900.00,
          "Barter": 450.00,
          "Prepaid": 900.00
        },
        "Discount": {
          "Count": 0,
          "Sum": 0.0
        },
        "Adding": {
          "Count": 0,
          "Sum": 0.0
        },
        "Tax": {
          "TaxVat_7": 294.30
        }
      },
      "PurchasesCorrection": {
        "Count": 45,
        "Sum": 4500.0,
        "Payments": {
          "Sum": 4500.0,
          "Cash": 4500.00,
          "Credit": 1800.00,
          "Electronically": 900.00,
          "Barter": 450.00,
          "Prepaid": 900.00
        },
        "Discount": {
          "Count": 0,
          "Sum": 0.0
        },
        "Adding": {
          "Count": 0,
          "Sum": 0.0
        },
        "Tax": {
          "TaxVat_7": 294.30
        }
      },
      "PurchasesReturnCorrection": {
        "Count": 45,
        "Sum": 4500.0,
        "Payments": {
          "Sum": 4500.0,
          "Cash": 4500.00,
          "Credit": 1800.00,
          "Electronically": 900.00,
          "Barter": 450.00,
          "Prepaid": 900.00
        },
        "Discount": {
          "Count": 0,
          "Sum": 0.0
        },
        "Adding": {
          "Count": 0,
          "Sum": 0.0
        },
        "Tax": {
          "TaxVat_7": 294.30
        }
      }
    },
    "CashDrawer": {
      "Sum": 345.00,
      "Count": 37
    }
  },
  "Code": 0,
  "Description": "OK",
  "Success": true
}

Result (OverallTotals)

Имя поля Тип Обяз Назначение Пример
DataLoaded bool - Все ли данные успешно прочитаны из устройства true
Sum decimal - Сумма 0.0
Count int - Количество 0
Counters ShiftCounters - Счётчики “Counters”: {
“SumCorrection”: 0.0,
“NumberCorrections”: 0,
“Sales”: {
“Count”: 266,
“Sum”: 24739.54,
“Payments”: {
“Sum”: 24739.54,
“Cash”: 25163.08,
“Credit”: 9400.00,
“Electronically”: 4949.54,
“Barter”: 2350.00,
“Prepaid”: 4700.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_20”: 93.03,
“TaxVat_7”: 1536.90
}
},
“SalesReturn”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
“SalesCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
“SalesReturnCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
“Purchases”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
“PurchasesReturn”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
“PurchasesCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
“PurchasesReturnCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
}
}
CashDrawer CashDrawer - Детали денежного ящиика “CashDrawer”:

ShiftCounters

Имя поля Тип Обяз Назначение Пример
SumCorrection decimal - Сумма коррекций 0.0
NumberCorrections int - Количество коррекций 0
Sales DocData - Чеки прихода “Sales”: {
“Count”: 266,
“Sum”: 24739.54,
“Payments”: {
“Sum”: 24739.54,
“Cash”: 25163.08,
“Credit”: 9400.00,
“Electronically”: 4949.54,
“Barter”: 2350.00,
“Prepaid”: 4700.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_20”: 93.03,
“TaxVat_7”: 1536.90
}
}
SalesReturn DocData - Чеки возврата прихода “SalesReturn”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
SalesCorrection DocData - Чеки прихода “SalesCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
SalesReturnCorrection DocData - Чеки возврата прихода “SalesReturnCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
Purchases DocData - Чеки расхода “Purchases”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
PurchasesReturn DocData - Чеки возврата расхода “PurchasesReturn”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
PurchasesCorrection DocData - Чеки расхода “PurchasesCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
PurchasesReturnCorrection DocData - Чеки возврата расхода “PurchasesReturnCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
}

DocData

Имя поля Тип Обяз Назначение Пример
Count int - Количество 210
Sum decimal - Сумма 10218.00
Payments DocDataPayments - Оплаты “Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
Discount RegData - Скидка Discount”:
Adding RegData - Надбавки “Adding”:
Tax Taxes - Налоги “Tax”:

DocDataPayments

Имя поля Тип Обяз Назначение Пример
Sum decimal - Общая сумма чеков 7753.00
Cash decimal - Сумма оплат наличными 10430.06
Credit decimal - Сумма кредитов 9400.00
Electronically decimal - Сумма оплат безналичными 405.00
Barter decimal - Сумма оплат встречным предоставлением 2350.00
Prepaid decimal - Сумма предоплатой (зачетом аванса) 30.0

RegData

Имя поля Тип Обяз Назначение Пример
Count int - Количество 0
Sum decimal - Сумма 0.0

Taxes

Имя поля Тип Обяз Назначение Пример
TaxVat_5 decimal - Ставка НДС 5% 2.38
TaxVat_20 decimal - Ставка НДС 20% 1659.94

CashDrawer

Имя поля Тип Обяз Назначение Пример
Sum decimal - Сумма 2128.80
Count int - Количество 7

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

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

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

GET service/settings

Получение настроек службы

URL: {{HTTPRoot}}/service/settings

Тело ответа

200 OK

{
    "Result": {
        "WcfServicePort": 4398,
        "WebServicePort": 8866,
        "ServiceTimeOut": "00:00:15",
        "ProxyServerSettings": {
            "IsUseProxy": false,
            "IpAddress": "",
            "Port": 0,
            "Name": "",
            "Password": ""
        },
        "MaxQueueSize": 100,
        "RepeatPrintingOnError": false
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Result (ServiceSettings)

Имя поля Тип Назначение Пример
WcfServicePort int Порт, на котором работает WCF-служба и принимает REST API запросы.

Если значение не удаётся прочитать из настроек сервера, возвращается значение по умолчанию — 4398.
4398
WebServicePort int Порт, на котором работает веб-страница администрирования сервера (добавление и настройка ККТ, редактирование рекламных шаблонов, просмотр очереди печати). Это тот адрес, который открывают в браузере.

Если значение не удаётся прочитать из настроек сервера, возвращается значение по умолчанию — 8866.
8866
ServiceTimeOut TimeSpan Таймаут обработки запросов.

Если значение не удаётся прочитать из настроек сервера, возвращается "00:00:00", без явной пометки ошибки.
“00:00:15”
MaxQueueSize int Максимальный размер очереди заданий.

Если значение не удаётся прочитать из настроек сервера, возвращается значение по умолчанию — 100.
100
RepeatPrintingOnError bool Повторять печать при ошибке/перезапуске.

Если значение не удаётся прочитать из настроек сервера, возвращается значение по умолчанию false.
false
ProxyServerSettings ProxyConfig Конфигурация прокси сервера “ProxyServerSettings”:

Тип: ProxyConfig

Имя поля Тип Назначение Пример
IsUseProxy bool Использовать прокси-сервер false
IsUseProxyService bool Использовать прокси-сервер для работы сервера ККМ false
IsUseProxyMarking bool Использовать прокси-сервер для работы с сервисами по проверки маркировки false
IpAddress string IP-адрес прокси “193.148.21.111”
Port int Порт прокси 67
Name string Логин к прокси-серверу “ProxyName”
Password string Пароль к прокси-серверу “ProxyPassword”

POST service/settings

Сохранение настроек служб

URL: {{HTTPRoot}}/service/settings

Тело запроса

{
    "ServiceSettings": {
        "WcfServicePort": 4398,
        "WebServicePort": 8888,
        "ServiceTimeOut": "00:00:15",
        "ProxyServerSettings": {
            "IsUseProxy": false,
            "IpAddress": "",
            "Port": 0,
            "Name": "",
            "Password": ""
        },
        "MaxQueueSize": 100,
        "RepeatPrintingOnError": false
    }
}
Имя поля Тип Обяз Назначение Пример
WcfServicePort int + Порт, на котором работает WCF-служба и принимает REST API запросы.

Если указано значение 0 или поле не указано, текущее значение порта в настройках сервера не изменяется.
4398
WebServicePort int + Порт, на котором работает веб-страница администрирования сервера (добавление и настройка ККТ, редактирование рекламных шаблонов, просмотр очереди печати). Это тот адрес, который открывают в браузере.

Если указано значение 0 или поле не указано, текущее значение порта в настройках сервера не изменяется.
8866
ServiceTimeOut string - Таймаут обработки запросов (hh:mm:ss).

Если поле не передано, будет сохранено значение "00:00:00"
“00:00:15”
ProxyServerSettings ProxyConfig - Конфигурация прокси сервера “ProxyServerSettings”:
MaxQueueSize int + Максимальный размер очереди заданий.

Значение сохраняется, если поле не передано в запросе — в таком случае будет сохранено значение 0.
100
RepeatPrintingOnError bool - Признак повторной печати задания при ошибке или перезапуске службы.

Значение сохраняется, если поле не передано в запросе — в этом случае будет сохранено значение false.
false

Тип: ProxyConfig

Имя поля Тип Обяз Назначение Пример
IsUseProxy bool - Признак использования прокси-сервера.

Если указано значение true, а поля IsUseProxyService и IsUseProxyMarking не переданы (или оба переданы как false), сервер принудительно устанавливает оба этих поля в true
false
IsUseProxyService bool - Признак использования прокси-сервера непосредственно для работы сервера ККМ false
IsUseProxyMarking bool - Признак использования прокси-сервера для обращения к сервисам проверки кодов маркировки false
IpAddress string - IP-адрес прокси-сервера “193.148.21.111”
Port int - Порт прокси-сервера 67
Name string - Логин доступа к прокси-серверу.

Если поле не передано, ранее сохранённый логин будет затёрт пустым значением.
“ProxyServer”
Password string - Пароль доступа к прокси-серверу.

Если поле не передано, ранее сохранённый пароль будет затёрт пустым значением.
“ProxyPassword”

Тело ответа

200 ОК

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