1. Overview

1.1. Version information

Version : version 1

1.2. URI scheme

BasePath : /api/1

1.3. Consumes

  • application/json

1.4. Produces

  • application/json

2. Paths

2.1. GET /status

2.1.1. Description

Состояние фискального накопителя

2.1.2. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

fiscal_drive_number
optional

Номер фискального накопителя.
Length : 1 - 16

string

state
optional

Фаза жизненного цикла фискального накопителя.

Значение Описание

0

Настройка

1

Готовность к фискализации

3

Фискальный режим

7

Постфискальный режим, идет передача ФД в ОФД

15

Чтение данных из архива ФН

integer

document_code
optional

Код текущего документа.

Значение Описание

0

Нет документа

1

Отчёт о регистрации ККТ

2

Отчёт об открытии смены

4

Кассовый чек

8

Отчёт о закрытии смены

16

Отчёт о закрытии фискального режима

17

Бланк строкой отчетности

18

Отчет об изменении параметров регистрации ККТ в связи с заменой ФН

19

Отчет об изменении параметров регистрации ККТ

20

Кассовый чек коррекции

21

БСО коррекции

23

Отчёт о текущем состоянии расчетов

integer

document_data_status
optional

Состояние данных документа.

Значение Описание

0

Нет данных документа

1

Получены данные документа

enum (0, 1)

shift_status
optional

Состояние смены.

Значение Описание

0

Смена закрыта

1

Смена открыта

enum (0, 1)

alert_flags
optional

Флаги предупреждения.

Бит Описание

0

Срочная замена КС (до окончания срока действия 3 дня)

1

Исчерпание ресурса КС (до окончания срока действия 30 дней)

2

Переполнение памяти ФН (Архив ФН заполнен на 90 %)

3

Превышено время ожидания ответа ОФД

7

Критическая ошибка ФН

integer

last_document_datetime
optional

Дата и время последнего документа.

string (date-time)

last_document_number
optional

Номер последнего фискального документа.

integer

2.2. POST /settings

2.2.1. Description

Настройки

2.2.2. Parameters

Type Name Schema

Body

data
required

data

Name Description Schema

dateTime
required

Текущие дата и время.

string (date-time)

ofdHost
required

Адрес сервера ОФД.
Minimum length : 1
Pattern : "^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?))|(?:([a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,6})$"

string

ofdPort
required

Порт сервера ОФД.
Minimum value : 1
Maximum value : 65535

integer

ofdReconnectionDelay
required

Задержка при переподключении к ОФД, в секундах.
Minimum value : 0
Maximum value : 3600

integer

2.2.3. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

2.3. POST /reset

2.3.1. Description

Сброс фискального накопителя (только в версии для разработчиков)

2.3.2. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

2.4.1. Description

Поиск фискального документа по номеру

2.4.2. Parameters

Type Name Schema

Path

document_number
required

string

2.4.3. Responses

HTTP Code Schema

200

404

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

code
optional

В случае неудачи, содержит код ошибки.
Minimum value : 1

integer

message
optional

В случае неудачи, содержит сообщение об ошибке.
Minimum length : 1

string

state
optional

В случае неудачи из-за неверной фазы жизненного цикла фискального накопителя, содержит фазу.

integer

document_number
optional

В случае успеха, содержит номер документа.
Minimum value : 1

integer

document_type
optional

В случае успеха, содержит тип документа.

integer

Response 404

Name Description Schema

ok
required

Статус операции.

boolean

document_number
required

Содержит запрошенный номер документа.

integer

code
required

Содержит код ошибки.

integer

not_found
required

Документ не найден. Всегда true.

boolean

2.5. POST /print/{document_number}/

2.5.1. Description

Печать фискального документа по номеру

2.5.2. Parameters

Type Name Schema

Path

document_number
required

string

2.5.3. Responses

HTTP Code Schema

200

404

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

code
optional

В случае неудачи, содержит код ошибки.
Minimum value : 1

integer

message
optional

В случае неудачи, содержит сообщение об ошибке.
Minimum length : 1

string

state
optional

В случае неудачи из-за неверной фазы жизненного цикла фискального накопителя, содержит фазу.

integer

Response 404

Name Description Schema

ok
required

Статус операции.

boolean

document_number
required

Содержит запрошенный номер документа.

integer

code
required

Содержит код ошибки.

integer

not_found
required

Документ не найден. Всегда true.

boolean

2.6. POST /printany

2.6.1. Description

Печать произвольных данных

2.6.2. Parameters

Type Name Schema

Body

data
required

< data > array

data

Name Description Schema

left
optional

Текст, выровненный по левому краю. Может быть указан совместно с right. Символы текста, которые не соответствуют печатным символам кодировки CP866, будут заменены на пробелы.
Minimum length : 1

string

right
optional

Текст, выровненный по правому краю. Может быть указан совместно с left. Символы текста, которые не соответствуют печатным символам кодировки CP866, будут заменены на пробелы.
Minimum length : 1

string

center
optional

Текст, выровненный по центру. В случае указания, left и right игнорируются. Символы текста, которые не соответствуют печатным символам кодировки CP866, будут заменены на пробелы.
Minimum length : 1

string

doubleWidth
optional

Использовать шрифт двойной ширины.
Default : false

boolean

doubleHeight
optional

Использовать шрифт двойной высоты.
Default : false

boolean

hr
optional

Горизонтальная линия. В случае указания, center, left, right игнорируются.
Default : false

boolean

feed
optional

Подача бумаги. В случае указания, center, left, right, hr игнорируются.

Значение Описание

default

Кол-во строк, заданное по-умолчанию и достаточное для отреза документа.

N lines

N строк (N - целое число от 1 до 16).

N dots

N точек (N - целое число от 1 до 255).

Minimum length : 1
Pattern : "^(default|([1-9]|1[0-6]) lines|([1-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-5]) dots)$"

string

2.6.3. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

2.7. POST /register

2.7.1. Description

Регистрация и изменение параметров регистрации

2.7.2. Parameters

Type Name Schema

Body

data
required

data

Name Description Schema

T1048
required

Наименование пользователя.
Length : 1 - 256

string

T1018
required

ИНН пользователя.
Length : 10 - 12
Pattern : "^\\d+$"

string

T1062
required

Системы налогообложения.
Содержит сведения о системах налогообложения, которые могут применяться пользователем при применении регистрируемого экземпляра ККТ.

Значение Тип системы налогообложения

1

Общая

2

Упрощенная доход

3

Упрощенная доход минус расход

4

Единый налог на вмененный доход

5

Единый сельскохозяйственный налог

6

Патентная система налогообложения

< enum (1, 2, 3, 4, 5, 6) > array

T1037
required

Регистрационный номер ККТ.
Length : 1 - 16

string

T1002
required

Признак автономного режима.

boolean

T1221
required

Признак установки принтера в автомате.

boolean

T1110
required

Признак АС БСО.

boolean

T1056
required

Признак шифрования.
Не может принимать значение true в случае, если T1002 (признак автономного режима) имеет значение true.

boolean

T1001
required

Признак автоматического режима.

boolean

T1108
required

Признак ККТ для расчетов только в Интернет.

boolean

T1036
optional

Номер автомата.
Обязателен в случае, если T1001 (признак автоматического режима) имеет значение true.
Length : 1 - 20

string

T1207
optional

Признак торговли подакцизными товарами.
Default : false

boolean

T1109
optional

Признак расчетов за услуги.
Default : false

boolean

T1193
optional

Признак проведения азартных игр.
Default : false

boolean

T1126
optional

Признак проведения лотереи.
Default : false

boolean

T1057
optional

Признак агента.
Включение значения в массив указывает, что пользователь может осуществлять расчеты, являясь соответствующим агентом.

Значение Описание

1

Оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным агентом банковским платежным агентом

2

Оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным агентом банковским платежным субагентом

3

Оказание услуг покупателю (клиенту) пользователем, являющимся платежным агентом

4

Оказание услуг покупателю (клиенту) пользователем, являющимся платежным субагентом

5

Осуществление расчета с покупателем (клиентом) пользователем, являющимся поверенным

6

Осуществление расчета с покупателем (клиентом) пользователем, являющимся комиссионером

7

Осуществление расчета с покупателем (клиентом) пользователем, являющимся агентом и не являющимся банковским платежным агентом (субагентом), платежным агентом (субагентом), поверенным, комиссионером

< enum (1, 2, 3, 4, 5, 6, 7) > array

T1021
optional

Кассир
Фамилия, имя, отчество (при наличии), должность лица, уполномоченного пользователем для формирования ФД.
Может не указываться в случае применения ККТ для расчетов, осуществляемых с использованием автоматических устройств для расчетов.
Length : 1 - 64

string

T1203
optional

ИНН кассира
ИНН (при наличии) лица, уполномоченного пользователем для формирования ФД.
Length : 12
Pattern : "^\\d+$"

string

T1009
required

Адрес расчетов.
Length : 1 - 256

string

T1187
required

Место расчетов.
Length : 1 - 256

string

T1117
optional

Адрес электронной почты отправителя чека.
Может не указываться в случае, если T1002 (признак автономного режима) имеет значение true.
Length : 1 - 64

string

T1017
optional

ИНН ОФД.
Обязателен в случае, если T1002 (признак автономного режима) имеет значение false.
Length : 10 - 12
Pattern : "^\\d+$"

string

T1046
optional

Наименование ОФД.
Обязательно в случае, если T1002 (признак автономного режима) имеет значение false.
Length : 1 - 256

string

T1190
optional

Версия ФФД ФН.
Default : "3"

enum (2, 3)

T1101
optional

Код причины перерегистрации.
Обязателен в случае перерегистрации.

Код Причина изменения параметров регистрации

1

Замена ФН

2

Замена ОФД

3

Изменение реквизитов

4

Изменение настроек ККТ

enum (1, 2, 3, 4)

2.7.3. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

code
optional

В случае неудачи, содержит код ошибки.
Minimum value : 1

integer

message
optional

В случае неудачи, содержит сообщение об ошибке.
Minimum length : 1

string

state
optional

В случае неудачи из-за неверной фазы жизненного цикла фискального накопителя, содержит фазу.

integer

document_number
optional

В случае успеха, содержит номер документа.
Minimum value : 1

integer

errors
optional

В случае неудачи из-за ошибок валидации, содержит детальную информацию об ошибочных полях.

< errors > array

errors

Name Description Schema

field
required

Наименование поля, которое вызвало ошибку.
Minimum length : 1

string

code
optional

Код ошибки.
Minimum value : 1

integer

message
optional

Сообщение об ошибке.
Minimum length : 1

string

2.8. POST /shift/open

2.8.1. Description

Открытие смены

2.8.2. Parameters

Type Name Schema

Body

data
required

data

Name Description Schema

T1021
optional

Кассир
Фамилия, имя, отчество (при наличии), должность лица, уполномоченного пользователем для формирования ФД.
Может не указываться в случае применения ККТ для расчетов, осуществляемых с использованием автоматических устройств для расчетов.
Length : 1 - 64

string

T1203
optional

ИНН кассира
ИНН (при наличии) лица, уполномоченного пользователем для формирования ФД.
Length : 12
Pattern : "^\\d+$"

string

2.8.3. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

code
optional

В случае неудачи, содержит код ошибки.
Minimum value : 1

integer

message
optional

В случае неудачи, содержит сообщение об ошибке.
Minimum length : 1

string

state
optional

В случае неудачи из-за неверной фазы жизненного цикла фискального накопителя, содержит фазу.

integer

document_number
optional

В случае успеха, содержит номер документа.
Minimum value : 1

integer

errors
optional

В случае неудачи из-за ошибок валидации, содержит детальную информацию об ошибочных полях.

< errors > array

errors

Name Description Schema

field
required

Наименование поля, которое вызвало ошибку.
Minimum length : 1

string

code
optional

Код ошибки.
Minimum value : 1

integer

message
optional

Сообщение об ошибке.
Minimum length : 1

string

2.9. POST /currentstate

2.9.1. Description

Текущее состояние расчетов

2.9.2. Parameters

Type Name Schema

Body

data
required

object

2.9.3. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

code
optional

В случае неудачи, содержит код ошибки.
Minimum value : 1

integer

message
optional

В случае неудачи, содержит сообщение об ошибке.
Minimum length : 1

string

state
optional

В случае неудачи из-за неверной фазы жизненного цикла фискального накопителя, содержит фазу.

integer

document_number
optional

В случае успеха, содержит номер документа.
Minimum value : 1

integer

errors
optional

В случае неудачи из-за ошибок валидации, содержит детальную информацию об ошибочных полях.

< errors > array

errors

Name Description Schema

field
required

Наименование поля, которое вызвало ошибку.
Minimum length : 1

string

code
optional

Код ошибки.
Minimum value : 1

integer

message
optional

Сообщение об ошибке.
Minimum length : 1

string

2.10. POST /receipt

2.10.1. Description

Кассовый чек (БСО)

2.10.2. Parameters

Type Name Schema

Body

data
required

data

Name Description Schema

T1054
required

Признак расчета.

Значение Описание

1

приход

2

возврат прихода

3

расход

4

возврат расхода

enum (1, 2, 3, 4)

T1055
required

Применяемая система налогообложения.

Значение Тип системы налогообложения

1

Общая

2

Упрощенная доход

3

Упрощенная доход минус расход

4

Единый налог на вмененный доход

5

Единый сельскохозяйственный налог

6

Патентная система налогообложения

enum (1, 2, 3, 4, 5, 6)

T1008
optional

Телефон или электронный адрес покупателя.
Length : 1 - 64

string

T1059
required

Предмет расчета.
Кассовый чек (БСО), формируемый ККТ в автономном режиме, может содержать не более 10 элементов T1059 (предмет расчета), содержащих в своем составе T1162 (код товарной номенклатуры) и (или) T1226 (ИНН поставщика).

< T1059 > array

T1031
optional

Сумма по чеку (БСО) наличными.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1081
optional

Сумма по чеку (БСО) электронными.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1215
optional

Сумма по чеку (БСО) предоплатой (зачетом аванса и (или) предыдущих платежей).
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1216
optional

Сумма по чеку (БСО) постоплатой (в кредит).
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1217
optional

Сумма по чеку (БСО) встречным предоставлением.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1192
optional

Дополнительный реквизит чека (БСО).
Указывается учетом особенностей сферы деятельности, в которой осуществляются расчеты.
Length : 1 - 16

string

T1084
optional

Дополнительный реквизит пользователя.
Указывается учетом особенностей сферы деятельности, в которой осуществляются расчеты.

T1021
optional

Кассир
Фамилия, имя, отчество (при наличии), должность лица, уполномоченного пользователем для формирования ФД.
Может не указываться в случае применения ККТ для расчетов, осуществляемых с использованием автоматических устройств для расчетов.
Length : 1 - 64

string

T1203
optional

ИНН кассира
ИНН (при наличии) лица, уполномоченного пользователем для формирования ФД.
Length : 12
Pattern : "^\\d+$"

string

T1059

Name Description Schema

T1214
required

Признак способа расчета.

Значение Основание для присвоения значения

1

Полная предварительная оплата до момента передачи предмета расчета

2

Частичная предварительная оплата до момента передачи предмета расчета

3

Аванс

4

Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета

5

Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит

6

Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит

7

Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита)

enum (1, 2, 3, 4, 5, 6, 7)

T1212
optional

Признак предмета расчета.

Значение T1030 (наименование предмета расчета) содержит сведения

1

о реализуемом товаре, за исключением подакцизного товара (наименование и иные сведения, описывающие товар)

2

о реализуемом подакцизном товаре (наименование и иные сведения, описывающие товар)

3

о выполняемой работе (наименование и иные сведения, описывающие работу)

4

об оказываемой услуге (наименование и иные сведения, описывающие услугу)

5

о приеме ставок при осуществлении деятельности по проведению азартных игр

6

о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр

7

о приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей

8

о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей

9

о предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации

10

об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета

11

о вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом

12

о предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение от 1 до 11

13

о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от 1 до 12

enum (1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13)

T1222
optional

Признак агента по предмету расчета.
Единственный элемент массива может принимать указанные ниже значения.

Значение Основание для присвоения значения

1

Оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным агентом банковским платежным агентом

2

Оказание услуг покупателю (клиенту) пользователем, являющимся банковским платежным агентом банковским платежным субагентом

3

Оказание услуг покупателю (клиенту) пользователем, являющимся платежным агентом

4

Оказание услуг покупателю (клиенту) пользователем, являющимся платежным субагентом

5

Осуществление расчета с покупателем (клиентом) пользователем, являющимся поверенным

6

Осуществление расчета с покупателем (клиентом) пользователем, являющимся комиссионером

7

Осуществление расчета с покупателем (клиентом) пользователем, являющимся агентом и не являющимся банковским платежным агентом (субагентом), платежным агентом (субагентом), поверенным, комиссионером

< enum (1, 2, 3, 4, 5, 6, 7) > array

T1223A
optional

Данные агента.
Указываются в случае, если соответствующий предмет расчета содержит сведения об осуществлении расчетов пользователем в качестве платежного агента или платежного субагента.

T1223B
optional

Данные агента.
Указываются в случае, если соответствующий предмет расчета содержит сведения об осуществлении расчетов пользователем в качестве банковского платежного агента или банковского платежного субагента.

T1224
optional

Данные поставщика.
Указываются в случае, если соответствующий предмет расчета содержит сведения об осуществлении расчетов пользователем в качестве платежного агента (субагента), банковского платежного агента (субагента), комиссионера, поверенного или иного агента.
Если пользователь является платежным агентом (субагентом), то указываются данные лица, являющегося поставщиком платежного агента (субагента) в соответствии с Федеральным законом от 3 июня 2009 года N 103-ФЗ "О деятельности по приему платежей физических лиц, осуществляемой платежными агентами".
Если пользователь является банковским платежным агентом (субагентом), то указываются данные лица, являющегося получателем средств банковского платежного агента (субагента) в соответствии с Федеральным законом от 27 июня 2011 года N 161-ФЗ "О национальной платежной системе".
Если пользователь является комиссионером, то указываются данные лица, являющегося комитентом комиссионера в соответствии с пунктом 1 статьи 990 части второй Гражданского кодекса Российской Федерации (Собрание законодательства Российской Федерации, 1996, N 5, ст. 410, 2016, N 22, ст. 3094).
Если пользователь является поверенным, то указываются данные лица, являющегося доверителем поверенного в соответствии с пунктом 1 статьи 971 части второй Гражданского кодекса Российской Федерации.
Если расчет с покупателем (клиентом) осуществляется пользователем, являющимся агентом, не являющимся банковским платежным агентом (субагентом), платежным агентом (субагентом), поверенным или комиссионером, то указываются данные лица, являющегося принципалом агента в соответствии с пунктом 1 статьи 1005 части второй Гражданского кодекса Российской Федерации.

T1226
optional

ИНН поставщика.
Указывается в случае, если соответствующий предмет расчета содержит сведения об осуществлении расчетов пользователем в качестве платежного агента (субагента), банковского платежного агента (субагента), комиссионера, поверенного или иного агента.
Length : 10 - 12
Pattern : "^\\d+$"

string

T1030
required

Наименование предмета расчета.
Length : 1 - 128

string

T1197
optional

Единица измерения предмета расчета.
Length : 1 - 16

string

T1162
optional

Код товарной номенклатуры.
Формат данных определяется ФНС России.
Length : 1 - 44

string

T1079
required

Цена за единицу предмета расчета с учетом скидок и наценок.
Указывается в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1023
required

Количество предмета расчета.
Length : 1 - 21
Pattern : "^\\d+(\\.\\d{1,3})?$"

string

T1199
optional

Ставка НДС.

Значение Наименование ставки НДС

1

ставка НДС 18%

2

ставка НДС 10%

3

ставка НДС расч. 18/118

4

ставка НДС расч. 10/110

5

ставка НДС 0%

6

НДС не облагается

Default : "1"

enum (1, 2, 3, 4, 5, 6)

T1191
optional

Дополнительный реквизит предмета расчета.
Формат данных определяется ФНС России.
Length : 1 - 64

string

T1223A

Name Description Schema

T1073
required

Телефон платежного агента.

< string > array

T1074
required

Телефон оператора по приему платежей.

< string > array

T1223B

Name Description Schema

T1044
required

Операция платежного агента.
Length : 1 - 24

string

T1073
required

Телефон платежного агента.

< string > array

T1005
required

Адрес оператора перевода.
Length : 1 - 256

string

T1016
required

ИНН оператора перевода.
Length : 10 - 12
Pattern : "^\\d+$"

string

T1026
required

Наименование оператора перевода.
Length : 1 - 64

string

T1075
required

Телефон оператора перевода.

< string > array

T1224

Name Description Schema

T1171
required

Телефон поставщика.

< string > array

T1225
optional

Наименование поставщика.
Length : 1 - 256

string

T1084

Name Description Schema

T1085
required

Наименование дополнительного реквизита пользователя.
Length : 1 - 64

string

T1086
required

Значение дополнительного реквизита пользователя.
Length : 1 - 256

string

2.10.3. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

code
optional

В случае неудачи, содержит код ошибки.
Minimum value : 1

integer

message
optional

В случае неудачи, содержит сообщение об ошибке.
Minimum length : 1

string

state
optional

В случае неудачи из-за неверной фазы жизненного цикла фискального накопителя, содержит фазу.

integer

errors
optional

В случае неудачи из-за ошибок валидации, содержит детальную информацию об ошибочных полях.

< errors > array

errors

Name Description Schema

field
required

Наименование поля, которое вызвало ошибку.
Minimum length : 1

string

code
optional

Код ошибки.
Minimum value : 1

integer

message
optional

Сообщение об ошибке.
Minimum length : 1

string

index
optional

В случае, если ошибочное поле является массивом, содержит индекс ошибочного элемента в массиве.
Minimum value : 0

integer

errors
optional

В случае, если ошибочное поле является вложенным объектом, содержит детальную информацию об ошибочных полях вложенного объекта.

< errors > array

errors

Name Description Schema

field
required

Наименование поля, которое вызвало ошибку.
Minimum length : 1

string

code
optional

Код ошибки.
Minimum value : 1

integer

message
optional

Сообщение об ошибке.
Minimum length : 1

string

index
optional

В случае, если ошибочное поле является массивом, содержит индекс ошибочного элемента в массиве.
Minimum value : 0

integer

errors
optional

В случае, если ошибочное поле является вложенным объектом, содержит детальную информацию об ошибочных полях вложенного объекта.

< errors > array

errors

Name Description Schema

field
required

Наименование поля, которое вызвало ошибку.
Minimum length : 1

string

code
optional

Код ошибки.
Minimum value : 1

integer

message
optional

Сообщение об ошибке.
Minimum length : 1

string

index
optional

В случае, если ошибочное поле является массивом, содержит индекс ошибочного элемента в массиве.
Minimum value : 0

integer

2.11. POST /correctivereceipt

2.11.1. Description

Кассовый чек (БСО) коррекции

2.11.2. Parameters

Type Name Schema

Body

data
required

data

Name Description Schema

T1054
required

Признак расчета.

Значение Описание

1

коррекция прихода

3

коррекция расхода

enum (1, 3)

T1055
required

Применяемая система налогообложения.

Значение Тип системы налогообложения

1

Общая

2

Упрощенная доход

3

Упрощенная доход минус расход

4

Единый налог на вмененный доход

5

Единый сельскохозяйственный налог

6

Патентная система налогообложения

enum (1, 2, 3, 4, 5, 6)

T1173
required

Тип коррекции.

Значение Описание

0

самостоятельно

1

по предписанию

enum (0, 1)

T1177
required

Описание коррекции.
Length : 1 - 256

string

T1178
required

Дата документа основания для коррекции.

string (date)

T1179
required

Номер документа основания для коррекции.
Length : 1 - 32

string

T1020
required

Сумма расчета, указанного в чеке (БСО).
Сумма расчета должна быть равна сумме значений T1031, T1081, T1215, T1216, T1217.
Указывается в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1031
optional

Сумма по чеку (БСО) наличными.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1081
optional

Сумма по чеку (БСО) электронными.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1215
optional

Сумма по чеку (БСО) предоплатой (зачетом аванса и (или) предыдущих платежей).
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1216
optional

Сумма по чеку (БСО) постоплатой (в кредит).
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1217
optional

Сумма по чеку (БСО) встречным предоставлением.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1102
optional

Сумма НДС чека по ставке 18%.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1103
optional

Сумма НДС чека по ставке 10%.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1104
optional

Сумма расчета по чеку с НДС по ставке 0%.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1105
optional

Сумма расчета по чеку без НДС.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1106
optional

Сумма НДС чека по расч. ставке 18/118.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1107
optional

Сумма НДС чека по расч. ставке 10/110.
Указывается в случае, если сумма отлична от нуля, в копейках.
Minimum value : 0
Maximum value : 281474976710655

integer

T1021
optional

Кассир
Фамилия, имя, отчество (при наличии), должность лица, уполномоченного пользователем для формирования ФД.
Может не указываться в случае применения ККТ для расчетов, осуществляемых с использованием автоматических устройств для расчетов.
Length : 1 - 64

string

T1203
optional

ИНН кассира
ИНН (при наличии) лица, уполномоченного пользователем для формирования ФД.
Length : 12

string

2.11.3. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

code
optional

В случае неудачи, содержит код ошибки.
Minimum value : 1

integer

message
optional

В случае неудачи, содержит сообщение об ошибке.
Minimum length : 1

string

state
optional

В случае неудачи из-за неверной фазы жизненного цикла фискального накопителя, содержит фазу.

integer

document_number
optional

В случае успеха, содержит номер документа.
Minimum value : 1

integer

errors
optional

В случае неудачи из-за ошибок валидации, содержит детальную информацию об ошибочных полях.

< errors > array

errors

Name Description Schema

field
required

Наименование поля, которое вызвало ошибку.
Minimum length : 1

string

code
optional

Код ошибки.
Minimum value : 1

integer

message
optional

Сообщение об ошибке.
Minimum length : 1

string

2.12. POST /shift/close

2.12.1. Description

Закрытие смены

2.12.2. Parameters

Type Name Schema

Body

data
required

data

Name Description Schema

T1021
optional

Кассир
Фамилия, имя, отчество (при наличии), должность лица, уполномоченного пользователем для формирования ФД.
Может не указываться в случае применения ККТ для расчетов, осуществляемых с использованием автоматических устройств для расчетов.
Length : 1 - 64

string

T1203
optional

ИНН кассира
Поле содержит ИНН (при наличии) лица, уполномоченного пользователем для формирования ФД.
Length : 12
Pattern : "^\\d+$"

string

2.12.3. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

code
optional

В случае неудачи, содержит код ошибки.
Minimum value : 1

integer

message
optional

В случае неудачи, содержит сообщение об ошибке.
Minimum length : 1

string

state
optional

В случае неудачи из-за неверной фазы жизненного цикла фискального накопителя, содержит фазу.

integer

document_number
optional

В случае успеха, содержит номер документа.
Minimum value : 1

integer

errors
optional

В случае неудачи из-за ошибок валидации, содержит детальную информацию об ошибочных полях.

< errors > array

errors

Name Description Schema

field
required

Наименование поля, которое вызвало ошибку.
Minimum length : 1

string

code
optional

Код ошибки.
Minimum value : 1

integer

message
optional

Сообщение об ошибке.
Minimum length : 1

string

2.13. POST /finalize

2.13.1. Description

Закрытие фискального накопителя

2.13.2. Parameters

Type Name Schema

Body

data
required

data

Name Description Schema

T1021
optional

Кассир
Фамилия, имя, отчество (при наличии), должность лица, уполномоченного пользователем для формирования ФД.
Может не указыватьсяо в случае применения ККТ для расчетов, осуществляемых с использованием автоматических устройств для расчетов.
Length : 1 - 64

string

T1203
optional

ИНН кассира
ИНН (при наличии) лица, уполномоченного пользователем для формирования ФД.
Length : 12
Pattern : "^\\d+$"

string

2.13.3. Responses

HTTP Code Schema

200

Response 200

Name Description Schema

ok
required

Статус операции.

boolean

code
optional

В случае неудачи, содержит код ошибки.
Minimum value : 1

integer

message
optional

В случае неудачи, содержит сообщение об ошибке.
Minimum length : 1

string

state
optional

В случае неудачи из-за неверной фазы жизненного цикла фискального накопителя, содержит фазу.

integer

document_number
optional

В случае успеха, содержит номер документа.
Minimum value : 1

integer

errors
optional

В случае неудачи из-за ошибок валидации, содержит детальную информацию об ошибочных полях.

< errors > array

errors

Name Description Schema

field
required

Наименование поля, которое вызвало ошибку.
Minimum length : 1

string

code
optional

Код ошибки.
Minimum value : 1

integer

message
optional

Сообщение об ошибке.
Minimum length : 1

string