Программный интерфейс приложений (API) для работы с ИС «Чеки и ККТ»

Версия 1.5 от 24.08.2018 Открыть pdf-файл

Введение

Описывается программный интерфейс приложений (API) предоставляющий возможность сторонним (клиентским) приложениям использовать данные фискальных документов из информационной системы (ИС) «Чеки и ККТ» для сверки. Взаимодействие клиентского приложения и API производится путем отправки приложением HTTP-запросов к серверу и получением ответов на них. Для отправки запросов и получения ответов используется протокол HTTPS.

1. Авторизация через AuthToken

Возможность множественных обращений к ИС «Чеки и ККТ» после одной авторизации без использования механизма Cookies реализуется с помощью механизма AuthToken: после авторизации с передачей имени и пароля система возвращает код авторизации – строку символов, которая используется, как параметр авторизации при обращении к соответствующему личному кабинету (ЛК). HTTP-запрос авторизации, передающий имя пользователя и пароль в формате JSON выглядит следующим образом:

--- BEGIN ---
POST https://ofd.ru/api/Authorization/CreateAuthToken HTTP/1.1
Content-Length: 38
Content-Type: application/json; charset=utf-8 {"Login": "12345", "Password": "56789"}
--- END ---

В данном запросе присутствуют примеры значений: передаваемое имя пользователя – "12345" и пароль – "56789"; они задаются как значения в JSON-структуре внутри запроса с ключами "Login" и "Password" соответственно. Другой формат запроса, обрабатываемый ИС «Чеки и ККТ»: HTTP-запрос авторизации в формате URLEncoded:

--- BEGIN ---
POST https://ofd.ru/api/Authorization/CreateAuthToken HTTP/1.1
Content-Length: 26
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Login=12345&Password=56789
--- END ---

В ответ на данный запрос будет получен ответ по протоколу HTTP, который в случае успешной авторизации будет иметь код равный 200 и содержать структуру, подобную следующей (с примерами значений):

{
"AuthToken": "f3accdfda7574736ba94a78d00e974f4",
"ExpirationDateUtc": "2017-01-24T14:13:24"
}

Здесь с ключом "AuthToken" – код авторизации: строка символов AuthToken, представляет собой 32-значную последовательность шестнадцатеричных цифр, используемую для повторной аутентификации, а ключ "ExpirationDateUtc" – строка, описывающая момент времени (дату и время в формате UTC), до которого будет действовать данный код авторизации.

Момент времени задается в формате "ГГГГ-ММ-ДДTчч:мм:сс"; здесь

ГГГГ год даты, 4 цифры,
ММ месяц даты, 2 цифры,
ДД день даты 2 цифры,
T заглавная латинская буква “T”, используется как разделитель даты и времени,
чч часы, 2 цифры,
мм минуты, 2 цифры,
сс секунды, 2 цифры.

В случае проблем с авторизацией (код ответа по протоколу HTTP будет равен 403) данные будут отсутствовать, JSON-структура будет пустой (будет иметь вид «{}»). Полученный код авторизации используется в виде дополнительного параметра в запросах документов для сверки, где необходима авторизация. Пример запроса с использованием кода авторизации:

GET api/integration/v1/inn/INN1/kkts?AuthToken=Code1

здесь INN1 – идентификационный номер налогоплательщика (ИНН) юридического лица о котором производится запрос; строка из 10 цифр от 0 до 9; Code1 – действующий код авторизации, полученный в результате запроса авторизации.

2. Виды запросов ИС «Чеки и ККТ»

Запросы (функции) программного интерфейса приложений ИС «Чеки и ККТ» реализуют функции, необходимые в процессе работы различных ИС, использующих кассы и работающих с кассовыми документами. Большинство запросов имеет схожий формат и особенности структуры входных и выходных данных, если входные и выходные данные будут отличаться, это будет описываться дополнительно. Обобщенно формат запроса и ответа описан ниже.

С помощью запросов программного интерфейса приложений ИС «Чеки и ККТ» можно получать информацию о чеках и ККТ. Кодировка, в запросах и ответах – UTF-8. Ответы выдаются сервером в формате JSON, и, в случае успешности ответа, согласно его заголовку (код ответа по протоколу HTTP равен 200), данные имеют следующий обобщенный вид:

{
"Data": {
"Prop1": "Val1",
"Prop2": "Val2",
...
"PropN": "ValN"
},
"Status": "Success",
"Elapsed": "чч:мм:сс.ддддддд"
}

Здесь ключу "Data" соответствует структура, где "Prop1", "Prop2", ... "PropN" и "Val1", "Val2", ... "ValN" — ключи передаваемых параметров с их значениями (см. описания параметров ниже; значениями параметров могут являться массивы и структуры); параметр "Status" – состояние обработки запроса, в данном случае имеет значение "Success" (запрос обработан успешно). Параметр "Elapsed" — время, затраченное системой на обработку запроса: от получения запроса системой до выдачи ответа. Формат времени — строка вида "чч:мм:сс.ддддддд", в которой

чч часы,
мм минуты,
сс секунды,
ддддддд доли секунды.

В случае неуспешности ответа (код ответа по протоколу HTTP не равен 200) данные имеют следующий обобщенный вид:

{
"Errors": [
"Ошибка 1",
"Ошибка 2",
...
"Ошибка N"
],
"Status": "Failed",
"Elapsed": "чч:мм:сс.ддддддд"
}

Здесь ключу "Errors" соответствует одномерный массив, в котором присутствуют строки с сообщениями об ошибках, возникших при обработке данных. На месте строк "Ошибка 1", "Ошибка 2", ... "Ошибка N" перечислены сообщения об ошибках, возникших при обработке переданных данных. Параметр "Status" в данном случае имеет значение "Failed" (обработка запроса не удалась). Параметр "Elapsed" – так же, как и в случае успешного ответа, время, затраченное системой на обработку запроса; формат представления времени тот же.

2.1. Запрос списка зарегистрированной KKT

Запрос на получение списка зарегистрированной ККТ имеет вид:

GET api/integration/v1/inn/INN1/kkts

Здесь INN1 – идентификационный номер налогоплательщика (ИНН) юридического лица о котором производится запрос – строка из 10 цифр от 0 до 9. Успешным ответом на запрос возвращается структура данных JSON следующего примерного вида (вид значений показан на примерах, многоточие означает многократно повторяющуюся структуру такого же вида):

{
"Status": "Success",
"Data": [
{
"KktRegId": "9304171212297195",
"SerialNumber": "44444444444443421132",
"FnNumber": "0666666666666660",
"CreateDate": "2017-01-13T12:09:51",
"PaymentDate": "2017-01-13T12:15:43",
"SignDate": "2017-01-13T12:12:47",
"ActivationDate": "2017-01-13T12:15:48",
"ContractStartDate": "2017-01-13T12:12:47",
"ContractEndDate": "2018-02-12T12:12:47",
"LastDocOnKktDateTime": "2017-02-12T10:12:00",
"LastDocOnOfdDateTimeUtc": "2017-02-12T07:13:10"
},
...
]
}

Список полей этой структуры c их описаниями представлен в таблице 1.

Таблица 1. Поля данных записи с информацией о ККТ

Идентификатор Формат поля Назначение
KktRegId Строка Регистрационный номер ККТ (кассы)
SerialNumber Строка Заводской (серийный) номер ККТ (кассы)
FnNumber Строка Номер фискального накопителя
CreateDate Дата и время
в формате ISO
Дата регистрации кассы на сайте
PaymentDate Дата и время
в формате ISO
Дата оплаты услуг оператора “OFD.ru”
SignDate Дата и время
в формате ISO
Дата подписания КЭП (квалификационной электронной подписью)
ActivationDate Дата и время
в формате ISO
Дата успешной проверки регистрационного номера в ФНС
ContractStartDate Дата и время
в формате ISO
Дата начала действия контракта на получение услуг оператора “OFD.ru”
ContractEndDate Дата и время
в формате ISO
Дата окончания действия контракта на получение услуг оператора “OFD.ru”
LastDocOnKktDateTime Дата и время
в формате ISO
Дата и время последнего документа, сгенерированного кассой (по локальному времени кассы)
LastDocOnOfdDateTimeUtc Дата и время
в формате ISO
Дата и время получения последнего документа кассы в ОФД (по времени оператора “OFD.ru” в UTC)

Ошибка в ответе на запрос, обрабатываемая ИС: InnNotFound – для текущей учетной записи не найдено юридическое лицо по заданному ИНН.

2.2. Запрос списка отчетов по смене для заданной кассы за заданный период

Запрос на получение списка отчетов по смене (z-отчетов) по заданной кассе за заданный период имеет вид:

GET api/integration/v1/inn/INN/kkt/KKT/zreports?dateFrom=Date1&dateTo=Date2

Здесь INN – ИНН юридического лица, на которого зарегистрирована касса, по данным которой генерируется отчет – строка из 10 цифр от 0 до 9; KKT – регистрационный номер кассы – строка символов; Date1 и Date2 – начальная и конечная даты периода, для которого требуется сгенерировать отчет по открытым и закрытым сменам для заданной кассы – строка символов, содержащая дату и время в формате ISO. Разность Date2 и Date1 не должна превышать 30 дней. Успешным ответом на запрос (с кодом HTTP равным 200) является структура данных JSON следующего вида (вид значений показан на примерах, многоточие означает многократно повторяющуюся структуру такого же вида):

{
"Status": "Success",
"Data": [
{
"Id": "fc6562fc-e8b9-4ce2-a7c1-461a02171a98",
"Open_DocRawId": "7e66f625-2cf6-428f-bf98-be37077daf55",
"Close_DocRawId": "cc3110c0-f1ca-49d1-9d3c-1f880e28957f",
"Open_CDateUtc": "2016-07-26T09:28:54",
"Close_CDateUtc": "2016-07-27T15:47:36",
"UserInn": "7802870820",
"KktRegNumber": "111222333",
"FnNumber": "99990789388 ",
"ShiftNumber": 1,
"Operator": "Администратор",
"Open_DocNumber": 2,
"Open_DocDateTime": "2016-07-26T12:28:00",
"Close_DocNumber": 9,
"Close_DocDateTime": "2016-07-27T18:47:00",
"IncomeSumm": 375420,
"IncomeCount": 5,
"RefundIncomeSumm": 6360,
"RefundIncomeCount": 1,
"ExpenseSumm": 0,
"ExpenseCount": 0,
"RefundExpenseSumm": 0,
"RefundExpenseCount": 0,
"TaxTotalSumm": 0,
"Tax10Summ": 0,
"Tax18Summ": 0,
"Tax110Summ": 0,
"Tax118Summ": 0,
"TaxNaSumm": 0,
"Tax0Summ": 0
},
...
]
}

Список полей этой структуры c их описаниями представлен в таблице 2.

Таблица 2. Поля данных записи с информацией о ККТ

Идентификатор Формат поля Назначение
Id Строка в формате UUID Идентификатор смены
Open_DocRawId Строка в формате UUID Идентификатор документа отчета об открытии смены, полученного от кассы
Close_DocRawId Строка в формате UUID Идентификатор документа отчета об закрытии смены, полученного от кассы
Open_CDateUtc Дата и время
в формате ISO
Дата и время первого принятия в ИС от кассы документа отчета об открытии смены
Close_CDateUtc Дата и время
в формате ISO
Дата и время первого принятия в ИС от кассы документа отчета о закрытии смены
UserInn Строка, 10 или 12 цифр ИНН владельца кассы
KktRegNumber Строка Регистрационный номер кассы
FnNumber Строка Номер фискального накопителя, установленного в кассу
ShiftNumber Целое число Номер смены по данным кассы
Operator Строка Фамилия, имя, отчество оператора
Open_DocNumber Целое число Фискальный номер документа отчета об открытии смены, присвоенный кассой (уникальный в рамках текущего фискального режима)
Open_DocDateTime Дата и время
в формате ISO
Дата и время формирования отчета об открытии смены по данным кассы
Close_DocNumber Целое число Номер документа отчета о закрытии смены, присвоенный кассой (уникальный в рамках текущего фискального режима)
Close_DocDateTime Дата и время
в формате ISO
Дата и время формирования отчета о закрытии смены по данным кассы
IncomeSumm Целое число Сумма полученных денежных средств за смену в копейках
IncomeCount Целое число Количество чеков, выданных за смену, соответствующих получению суммы IncomeSumm
RefundIncomeSumm Целое число Сумма выданных (возвращённых) денежных средств за смену в копейках
RefundIncomeCount Целое число Количество чеков, выданных за смену, соответствующих возврату суммы RefundIncomeSumm
TaxTotalSumm Целое число Общая сумма удерживаемых налогов, начисленная за смену в копейках
Tax10Summ Целое число Сумма удерживаемого налога на добавленную стоимость (НДС) по ставке 10 %, начисленная за смену в копейках
Tax18Summ Целое число Сумма удерживаемого налога на добавленную стоимость (НДС) по ставке в 18 %, начисленная за смену в копейках
Tax110Summ Целое число Сумма удерживаемого налога на добавленную стоимость (НДС) по ставке 10/110, начисленная за смену, в копейках
Tax118Summ Целое число Сумма удерживаемого налога на добавленную стоимость (НДС) по ставке в 18/118, начисленная за смену, в копейках
TaxNaSumm Целое число Сумма по операциям, не облагаемая НДС, накопленная за смену, в копейках
Tax0Summ Целое число Сумма по операциям, облагаемая НДС по ставке 0%, накопленная за смену, в копейках

Ошибки в ответе на запрос, обрабатываемые ИС:

  • InnNotFound – для текущей учетной записи не найдена организация;
  • KktNotFound – для текущей учетной записи не найдена касса с заданным номером;
  • InvalidTimeInterval – неверно указан временной интервал;
  • TimeIntervalMustNotExceed30Days – временной интервал более 30 дней.

2.3. Запрос списка отчетов по смене для всей ККТ за заданный период

Запрос на получение списка отчетов по смене (z-отчетов) для всей ККТ, зарегистрированной на определенного владельца, за заданный период имеет вид:

GET api/integration/v1/inn/INN/zreports?dateFrom=Date1&dateTo=Date2

Здесь INN – ИНН юридического лица, на которого зарегистрирована касса, по данным которой генерируется отчет – строка из 10 или 12 цифр от 0 до 9; Date1 и Date2 – начальная и конечная даты периода, для которого требуется сгенерировать отчет по открытым и закрытым сменам для заданной кассы – строка символов, содержащая дату и время в формате ISO. Разность Date2 и Date1 не должна превышать 30 дней. Успешным ответом на запрос (с кодом HTTP равным 200) является структура данных вида, аналогичного структуре, выдаваемой ИС по запросу списка отчетов по смене для заданной кассы за заданный период.

Ошибки в ответе на запрос, обрабатываемые ИС:

  • InnNotFound – для текущей учетной записи не найдена организация;
  • InvalidTimeInterval – неверно указан временной интервал;
  • TimeIntervalMustNotExceed30Days – временной интервал более 30 дней.

2.4. Список чеков за период по заданной кассе

Запрос на получение списка за период по заданной кассе имеет вид:

GET api/integration/v1/inn/INN/kkt/KKT/receipts?dateFrom=Date1&dateTo=Date2

Здесь INN – ИНН юридического лица, на которого зарегистрирована касса, по данным которой генерируется отчет – строка из 10 цифр от 0 до 9; KKT – регистрационный номер кассы – строка символов; Date1 и Date2 – начальная и конечная даты периода, для которого требуется сгенерировать отчет по открытым и закрытым сменам для заданной кассы – строка символов, содержащая дату и время в формате ISO. Разность Date2 и Date1 не должна превышать 7 дней. Успешным ответом на запрос (с кодом HTTP равным 200) является структура данных JSON следующего вида (вид значений показан на примерах, многоточие означает многократно повторяющуюся структуру такого же вида):

{
"Status": "Success",
"Data": [
{
"Id": "3a6e3b83-a0b0-4587-bfb3-1b7539b05cf3",
"IsCorrection": false,
"CDateUtc": "2016-07-26T09:32:41",
"Tag": 0,
"IsBso": false,
"OperationType": "Income",
"UserInn": "7802870820",
"KktRegNumber": "111222333",
"FnNumber": "99990789388",
"DocNumber": 3,
"DocDateTime": "2016-07-26T12:32:00"
"DocRawId": "3a6e3b83-a0b0-4587-bfb3-1b7539b05cf3"
"DocShiftNumber": 1,
"ReceiptNumber": 1,
"TotalSumm": 0,
"CashSumm": 0,
"ECashSumm": 0,
"CreditSumm": 0,
"PrepaidSumm": 0,
"ProvisionSumm": 0,
"TaxTotalSumm": 0,
"Tax10Summ": 0,
"Tax18Summ": 0,
"Tax110Summ": 0,
"Tax118Summ": 0,
"Tax0Summ": 0,
"TaxNaSumm": 0,
"Depth": 3
}
]
}

Список полей этой структуры c их описаниями представлен в таблице 3. Ошибки в ответе на запрос, обрабатываемые ИС:

  • InnNotFound – для текущей учетной записи не найдена организация;
  • KktNotFound – для текущей учетной записи не найдена касса с заданным номером;
  • InvalidTimeInterval – неверно указан временной интервал;
  • TimeIntervalMustNotExceed7Days – временной интервал более 7 дней.

Таблица 3. Поля данных записи со списком документов (чеков)

Идентификатор Формат поля Назначение
Id Строка в формате UUID уникальный номер фискального документа в ИС, используется в запросе подробной информации по чеку, как RawId
IsCorrection Логическая переменная Имеет значение true, если чек или бланк строгой отчетности (БСО) является документом коррекции, иначе – false
CDateUtc Дата и время
в формате ISO
Дата и время приема документа в ИС
Tag Целое число Численный признак вида документа:
IsBso Логическая переменная Имеет значение true, если документ является БСО, иначе (если документ является чеком) – false
OperationType Строка Тип операции:
KktRegNumber Строка Регистрационный номер кассы
FnNumber Строка Номер фискального накопителя, установленного в кассу
DocNumber Целое число Фискальный номер документа
DocDateTime Дата и время
в формате ISO
Дата и время формирования документа по данным кассы
DocRawId Строка в формате UUID уникальный номер фискального документа в ИС, (используется в запросе подробной информации по чеку, как RawId, дублирует поле Id)
DocShiftNumber Целое число Номер смены (по данным кассы), в которую был сформирован документ
ReceiptNumber Целое число Номер документа в смене (по данным кассы)
TotalSumm Целое число Общая сумма по чеку в копейках
CashSumm Целое число Сумма по чеку (БСО) наличными в копейках
ECashSumm Целое число Сумма по чеку (БСО) электронными в копейках
CreditSumm Целое число Сумма по чеку (БСО) постоплатами (кредитами)
PrepaidSumm Целое число Сумма по чеку (БСО) предоплатами (авансами)
ProvisionSumm Целое число Сумма по чеку (БСО) встречными предоставлениями
TaxTotalSumm Целое число Общая сумма удерживаемых налогов, начисленная за смену в копейках
Tax10Summ Целое число Сумма удерживаемого налога на добавленную стоимость (НДС) по ставке 10 %, начисленная за смену, в копейках
Tax18Summ Целое число Сумма удерживаемого налога на добавленную стоимость (НДС) по ставке в 18 %, начисленная за смену, в копейках
Tax110Summ Целое число Сумма удерживаемого налога на добавленную стоимость (НДС) по ставке 10/110, начисленная за смену, в копейках
Tax118Summ Целое число Сумма удерживаемого налога на добавленную стоимость (НДС) по ставке в 18/118, начисленная за смену, в копейках
TaxNaSumm Целое число Сумма по операциям, не облагаемая НДС, накопленная за смену, в копейках
Tax0Summ Целое число Сумма по операциям, облагаемая НДС по ставке 0%, накопленная за смену, в копейках
Depth Целое число Количество товарных позиций в чеке

2.5. Список чеков за смену по заданной кассе

Запрос на получение списка за смену по заданной кассе имеет вид:

GET api/integration/v1/inn/INN/kkt/KKT/receipts?ShiftNumber=Shift1&FnNumber=Fn1

Здесь INN – ИНН юридического лица, на которого зарегистрирована касса, по данным которой генерируется отчет – строка из 10 цифр от 0 до 9; KKT – заводской (серийный) номер кассы – строка символов; Shift1 – номер смены, по которой требуется сгенерировать отчет и Fn1 – номер фискального накопителя, установленного в кассу. Успешным ответом на запрос (с кодом HTTP равным 200) является структура данных JSON, аналогичная структуре, приведенной в п. 2.1.4. Описание полей структуры см. в Таблице 3, описание ошибок, см. в п. 2.1.4.

2.6. Подробная информация по чеку

Запрос на получение подробной информации по конкретному чеку может быть получен двумя способами: по уникальному номеру фискального документа, либо по порядковому номеру смены и номеру документа в смене.

GET api/integration/v1/inn/INN/kkt/KKT/receipt/RawId

или

GET api/integration/v1/inn/INN/kkt/KKT/zreport/ShiftNumber/
receipt/DocShiftNumber

здесь INN – ИНН юридического лица, на которого зарегистрирована касса, по данным которой генерируется отчет – строка из 10 цифр от 0 до 9; KKT – заводской (серийный) номер кассы – строка символов; RawId – уникальный номер фискального документа в ИС «Чеки и ККТ» (строка в формате UUID); ShiftNumber – номер смены, в течение которой был сгенерирован документ, DocShiftNumber – номер документа внутри смены.

Успешным ответом на запрос (с кодом HTTP равным 200) является структура данных JSON следующего вида (приведены примеры значений):

{
"Status": "Success",
"Data": {
"Tag": 3,
"User": "ООО МКАС СПб",
"UserInn": "7802870820 ",
"Number": 1,
"DateTime": "2016-07-26T12:32:00",
"ShiftNumber": 1,
"OperationType": 1,
"TaxationType": 1,
"Operator": "Администратор",
"KKT_RegNumber": "111222333",
"FN_FactoryNumber": "99990789388 ",
"Items": [
{
"Name": "Редис",
"Price": 1190,
"Quantity": 12,
"Nds00_TotalSumm": 0,
"Total": 14280
},
{
"Name": "Колбаса Докторская 500 г",
"Price": 23880,
"Quantity": 1,
"Nds00_TotalSumm": 0,
"Total": 23880
}
],
"Buyer_Address": "",
"Nds00_TotalSumm": 0,
"Amount_Total": 51360,
"Amount_Cash": 51360,
"Amount_ECash": 0,
"Document_Number": 3,
"FiscalSign": "MQTLUGn8",
"ExtraProperty": [
{
"ExtraProperty_Name": "Name",
"ExtraProperty_Value": "Value"
},
{
"ExtraProperty_Name": "Name",
"ExtraProperty_Value": "Value"
}
]
}
}

Список полей этой структуры c их описаниями представлен в таблице 4.

Таблица 4. Поля данных записи с подробной информацией о чеке

Идентификатор Формат поля Назначение
Tag Целое число Численный признак вида документа:
User Строка Полное имя или название владельца кассы
UserInn Строка, 10 или 12 цифр ИНН владельца кассы
Number Целое число Номер документа внутри смены
DateTime Дата и время
в формате ISO
Дата и время формирования документа (чека)
ShiftNumber Целое число Номер смены (по данным кассы), в которую был сформирован документ
OperationType Строка Тип операции:
TaxationType Целое число Тип налогообложения
Operator Строка Фамилия, имя, отчество оператора
KKT_RegNumber Строка Регистрационный номера кассы
FN_FactoryNumber Строка Номер фискального накопителя, установленного в кассу
Items Массив структур Список товарных позиций в чеке
Name Строка Название товарной позиции в чеке
Price Целое число Цена в копейках за единицу измерения товарной позиции
Quantity Целое число Количество единиц товарной позиции
Nds00_TotalSumm Целое число Общая сумма НДС в копейках
Total Целое число Стоимость товарной позиции в копейках
Buyer_Address Строка Адрес покупателя (используется службами доставки)
Nds00_TotalSumm Целое число Общая сумма НДС по чеку в копейках
Amount_Total Целое число Общая сумма по чеку в копейках
Amount_Cash Целое число Сумма наличными по чеку в копейках
Amount_ECash Целое число Сумма, оплаченная картой, в копейках
Document_Number Целое число Фискальный номер документа
FiscalSign Строка Фискальный признак документа
ExtraProperty Массив структур Список дополнительных свойств чека
ExtraProperty_Name Строка Название (идентификатор) свойства
ExtraProperty_Value Строка Значение свойства

Ошибки в ответе на запрос, обрабатываемые ИС:

  • InnNotFound – для текущей учетной записи не найдена организация;
  • KktNotFound – для текущей учетной записи не найдена касса с заданным номером;
  • DocumentNotFound – документ (чек) не найден.

2.7. Прямая ссылка на электронный чек

Прямая ссылка на электронный чек имеет следующий вид:

{Домен}/rec/{inn}/{kktregnumber}/{fnnumber}/{docnumber}/{decsign}

Ниже, в таблице 5 приведен список параметров.

Таблица 5. Параметры ссылки на электронный чек

Параметр Тэг из
документа «Приложении 2
к приказу ФНС России от 21 марта 2017 г.
Описание
inn 1018 ИНН владельца кассы, на которого она зарегистрирована
kktregnumber 1037 Регистрационный номер ККТ
fnnumber 1041 Номер фискального накопителя
docnumber 1040 Номер фискального документа
decsign 1077 Фискальный признак документа

3. История изменений

Версия 1.3

Выпущена 11 октября 2017 г.

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

 

Версия 1.31

Выпущена 26 января 2018 г.

  1. Добавлены дополнительные поля в структуры данных смены и чека.
  2. Устранены мелкие недочеты по всему объему документа.

 

Версия 1.32

Выпущена 7 февраля 2018 г.

  1. Добавлена дополнительная форма запроса подробной информации
    по чеку.
  2. Устранены мелкие недочеты по всему объему документа.

 

Версия 1.33

Выпущена 15 марта 2018 г.

Добавлена дополнительная форма запроса данных смены и чека.

 

Версия 1.34

Выпущена 24 мая 2018 г.

Добавлены дополнительные поля в запросе данных чека.

Версия 1.4

Выпущена 16 июля 2018 г.

  1. Изменено название документа на «Программный интерфейс приложений (API) интеграции ИС пользователей с АИС “OFD.ru”»
  2. Изменен стиль оформления документа, обновлен логотип кампании.
  3. Добавлены функции работы с пользовательскими отчетами.
  4. Введена новая структура разделов, функции поделены на группы.
  5. Устранены фактические ошибки в существующих описаниях вызовов API.

Версия 1.5

Выпущена 24.08.2018

  1. Изменено название документа на «Программный интерфейс приложений (API) для работы с ИС «Чеки и ККТ»
  2. Подраздел «Работа с пользовательскими отчетами» выделен в документ «Программный интерфейс приложений (API) для работы с ИС «Отчеты»