В документе приводятся технические сведения о программном интерфейсе приложений (API), предоставляющем возможность сторонним (клиентским) веб-приложениям выполнять регистрацию контрольно-кассовой техники (KKT) с помощью асинхронных HTTP-запросов к ИС «OFD.RU».
Обмен данными происходит по протоколу HTTP с использованием зашифрованного канала (HTTPS). Данные запросов и ответов передаются в виде структуры JSON. Вне зависимости от наличия ошибок в данных, обязательным условием успешного выполнения запроса является ответ с кодом 200 согласно протоколу HTTP.
Для получения токена авторизации, который будет использоваться для выполнения запросов, пользователю необходимо обратиться в раздел «Настройки» в Личном кабинете партнера.
Далее пользователь переходит на вкладку «API для партнеров» и попадает в блок генерации ключей доступа к использованию API 2.0.
Сгенерированный ключ появляется на вкладке «API для партнеров» в блоке «Ваши ключи доступа».
Созданный ключ доступа будет иметь указания данных о датах создания и последней активности, статусе ключа и типе доступа, которое будет использоваться в запросах API 2.0.
Используемое обозначение параметра ключа доступа в запросах — AuthToken={Code}
Для получения списка кодов активации используется метод «GET». В ответ на запрос возвращается список с кодами активации (в соответствии с переданным токеном).
Запрос на получение списка кодов имеет вид:
GET https://ofd.ru/api/integration/v2/kkt/code/list?AuthToken={authToken}
Заменяемые параметр {AuthToken} — токен, возвращенный в результате авторизации (см. пп. 1 «Авторизация»).
Пример успешного ответа на запрос имеет следующий вид (приведены примеры значений):
{
"Data": [
{
"Id": guid,
"Code": string,
"Service": string,
"Tariff": string,
"TariffCount": number,
"Status": string,
"ExpiredDateUtc": datetime,
}
],
"Success": true
}
Таблица 1 Поля структуры ответа на запрос списка кодов активации
| Параметр | Формат значения | Описание | |
|---|---|---|---|
| Success | Boolean | Статус ответа | |
| Data | Структура | Информация о ККТ партнера | |
| Id | guid | ID кода | |
| Code | String | Код активации | |
| Service | String | Для сервиса Ferma — значение «Ferma». Для сервиса ОФД — значение «Ofd» |
|
| Tariff | String | Тариф клиента | |
| TariffCount | Number | Остаток тарифа | |
| Status | String | Статус кода активации. По умолчанию статус «Active» | |
| ExpiredDateUtc | Datetime | Срок действия кода активации | |
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 2. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 500 | InternalError | Не удалось получить список Кодов активации |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Метод работает для ККТ сервиса ОФД и Ferma.
Чтобы забронировать ККТ отправьте код активации в методе POST.
Запрос имеет следующий вид:
POST https://ofd.ru/api/integration/v2/kkt/book?AuthToken={authToken}
Заменяемые параметр {AuthToken} — токен, возвращенный в результате авторизации (см. пп. 1 Авторизация).
Параметры запроса располагаются в теле запроса и имеют вид следующей структуры (приведены примеры значений):
{
"KktSerialNumber": string,
"FnSerialNumber": string,
"ActivationCode": string,
}
Параметры запроса брони ККТ:
В ответ на запрос сервер возвращает структуру данных (приведены примеры значений):
{
"Data": {
"Status": string
},
"Success": true
}
Параметры ответа на запрос брони ККТ:
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 3. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | ActivationCodeNotFound | Код не найден |
| 400 | ActivationCodeExpired | Истёк срок действия Кода |
| 400 | ActivationCodeUsed | Код уже использован |
| 400 | ActivationCodeBlocked | Код активации заблокирован |
| Код недоступен для применения Партнёром |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Метод используется партнерами для автоматизации оплаты касс клиентов кодами активации (далее КА) на услуги ОФД. Метод имеет следующий вид:
POST https://ofd.ru/api/integration/partner/v2/kkt/pay?AuthToken={Code}
Чтобы применить КА, необходимо передавать в метод обязательные параметры, со значениями данных своих клиентов в API-запрос.
После прохождении проверок выполняются следующие действия:
Параметры запроса располагаются в теле запроса и имеют вид следующей структуры (приведены примеры значений):
{
"Inn": string,
"Kpp": string,
"Rnm": string,
"ActivationCode": string,
"Email": string
}
В таблице 4 представлены параметры необходимые для выполнения запроса.
Таблица 4. Параметры запроса для применения КА
| Параметры | Формат значения | Описание | Признак обязательности в запросе1) |
|---|---|---|---|
| Inn | String | ИНН идентификационный налоговый регистрационный номер (Клиента) | Да |
| Kpp | String | КПП идентификационный признак юридического лица (Клиента) | Нет2) |
| String | Email клиента (Необходим для создания ЛКК в OFD.ru. Логин для входа в ЛКК) | Да | |
| ActivationCode | String | Код активации для применения на кассах клиента | Да |
| Rnm | String | РНМ регистрационный номер кассы клиента | Да |
В ответ на запрос возможны следующие вариант.
Ответ со значением «ККТ оплачена»:
{
"IsCompleted": true,
"IsWaiting": false
}
Ответ со значением «ККТ ожидает первый ФД»:
{
"IsCompleted": false,
"IsWaiting": true
}
Параметры ответа:
Возможные ошибки при обработке запроса на применение КА:
После применения КА на ИНН, если нет созданного ЛКК, но есть ККТ, создается ЛКК и отправляется на email письмо параметрами (логин и пароль) входа в ЛКК. После прохождения всех проверок, КА успешно применяется и активирует услуги ОФД.
Если ККТ не была настроена на передачу фискальных данных (далее ФД) в OFD.ru, КА для кассы действует в течении 3-х суток.
Особенности и ограничения:
Для получения списка статусов оплат используется метод «GET».
Запрос на получение списка статусов имеет вид:
GET https://ofd.ru/api/integration/partner/v2/kkt/paystatus?AuthToken={Code}&DateFromUtc={dateFrom}&DateToUtc={dateTo}
Заменяемые параметры:
Пример успешного ответа на запрос имеет следующий вид (приведены примеры значений):
{
"Data": [
{
"DateUtc": datetime,
"Inn": string,
"Rnm": string,
"ActivationCode": string,
"Status": string,
"ActivationDateUtc": datetime
}
],
"Success": true
}
Описание параметров ответа на запрос представлено в таблице 5.
Таблица 5. Поля структуры ответа на запрос статусов оплат
| Параметр | Вложенный параметр | Формат значения | Описание |
|---|---|---|---|
| Data | Array | Массив данных со списком касс с примененным КА | |
| Object | Структура данных по кассе с примененным КА | ||
| DateUtc | String | Дата и время отправки запроса | |
| Inn | String | ИНН клиента | |
| Rnm | String | Регистрационный номер кассы (РНМ) клиента | |
| ActivationCode | String | Код активации услуг ОФД | |
| Status | String | Статус КА. В параметре могут быть следующие значения: Undefined - Не определено; WaitingActivation - Ожидание активации ККТ; Payed - ККТ оплачена; Cancelled - Отмена |
|
| ActivationDateUtc | String | Дата и время применения кода | |
| Success | Boolean | Статус выполнения запроса | |
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Метод возвращает только общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Метод получения списка касс клиентов имеет следующий вид:
GET https://ofd.ru/api/integration/partner/v2/inn/{inn}/kkts?AuthToken={Code}
Пример успешного ответа на запрос:
{
"Data": [
{
"Id": "60854103-3e26-49d5-942b-07c34f7b9446",
"KktRegId": "0005792715046206",
"SerialNumber": "00105703738735",
"FnNumber": "9960440301038465",
"CreateDate": "2021-09-01T15:43:28",
"LastDocOnKktDateTime": "2021-12-13T16:34:00",
"LastDocOnOfdDateTimeUtc": "2021-12-13T13:37:03",
"FiscalAddress": "Москва, Ленинская Слобода, 19",
"FiscalPlace": "ofd.ru",
"KktModel": "АТОЛ 25Ф",
"FnEndDate": "2022-11-25T15:43:57",
"ContractStartDateUtc": "2021-09-01T00:00:00"
}
],
"Success": true
}
Описание параметров ответа представлено в таблице 6.
Таблица 6. Описание параметров ответа на запрос
| Параметр | Вложенный параметр | Формат значения | Описание |
|---|---|---|---|
| Data | Array | Массив данных со списком касс клиентов партнера | |
| Object | Структура данных по кассе | ||
| Id | String | Идентификатор кассы | |
| KktRegId | String | РНМ — регистрационный номер кассы | |
| SerialNumber | String | Заводской номер кассы | |
| FnNumber | String | Заводской номер фискального накопителя | |
| CreateDate | String | Дата регистрации кассы в личном кабинете клиента | |
| LastDocOnKktDateTime | String | Дата и время3) последнего документа, сгенерированного кассой | |
| LastDocOnOfdDateTimeUtc | String | Дата и время4) получения последнего документа кассы в ОФД | |
| FiscalAddress | String | Адрес установки кассы | |
| FiscalPlace | String | Место расчетов | |
| KktModel | String | Модель кассы (ККТ) | |
| FnEndDate | String | Дата и время5) окончания работы фискального накопителя | |
| Tariff | String | Тарифный план: | |
| «Red» | |||
| «Yellow» | |||
| «Green» | |||
| «Blue» | |||
| «Orange» | |||
| LastBuyDateUtc | String | Оплата услуги ОФД | |
| ContractStartDateUtc | String | Дата и время6) начало предоставления услуги ОФД | |
| ContractEndDateUtc | String | Дата и время7) окончания предоставления услуги ОФД | |
| Success | Boolean | Статус выполнения запроса | |
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Метод возвращает только общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Для того, чтобы перейти к удаленной оплате услуг и регистрации кассы, партнеру необходимо выполнить запрос на создание личного кабинета клиента с одним пользователем. После создания ЛКК клиенту на E-mail приходит письмо, в котором содержится ссылка для перехода и создания логина и пароля личного кабинета.
POST https://ofd.ru/api/integration/partner/v2/PartnerCreateClientCabinet?AuthToken={Code}
Code — значение действующего кода авторизации, полученного в ЛКП;
Пример запроса:
{
"Inn": "String",
"Kpp": "String",
"CompanyName": "String",
"Email": "String",
"Name": "String",
"Phone": "String",
}
Описание параметров запроса для создания ЛКК представлено в таблице 7.
Таблица 7. Параметры запроса на создание ЛКК
| Параметр | Формат | Описание |
|---|---|---|
| Inn | String | ИНН клиента. Длина 10-12 цифр |
| Kpp | String | КПП клиента |
| CompanyName | String | Наименование организации |
| String | Адрес электронной почты клиента | |
| Name | String | Имя пользователя с логином из поля Email. Параметр необязательный |
| Phone | String | Контактный телефон. Параметр необязательный |
Пример успешного ответа на запрос:
{
"OfdAgreementId": "String"
}
Описание параметра ответа:
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 8. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | ValidationError | ИНН компании (Inn) не определён |
| Название компании (CompanyName) не определено | ||
| Адрес электронной почты (Email) не определён | ||
| Длина имени (Name) не должна превышать 256 символов | ||
| Недостаточно прав | ||
| Партнёр не существует | ||
| Компания уже существует | ||
| Пользователь уже существует | ||
| Некорректный ИНН (ЛКК для такого ИНН/КПП уже существует) | ||
| 500 | InternalError | Неизвестная ошибка (например, пользователь или ЛКК с таким Email уже существует) |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Для создания заказа партнер указывает требуемое количество касс, тип тарифа и тип фискального накопителя (общие для всех касс в одном заказе).
Эти данные содержатся в одном заказе и привязываются к идентификатору заказа OrderID.
POST https://ofd.ru/api/integration/partner/v2/PartnerBookingKkt?AuthToken={Code}
Пример запроса
{
"OfdAgreementId": "String",
"quantity": "Integer",
"tariffType": "String",
"fnType": "String",
"PaymentType": "String"
}
Описание параметров запроса представлено в таблице 9.
Таблица 9. Параметры запроса на бронирование касс и передачу запроса на формирование ссылки на оплату нового клиента
| Параметр | Формат | Описание | |
|---|---|---|---|
| OfdAgreementId | String | Идентификатор юридического лица клиента, прикрепленного к ЛК OFD.ru | |
| quantity | Integer | Количество касс по выбранным tariffType и fnType | |
| tariffType | String | Тип тарифа на кассе. Возможные значения: | |
| Urgent1M | Количества месяцев | ||
| Urgent6M | |||
| Urgent12M | |||
| Urgent15M | |||
| Urgent18M | |||
| Receipt399 | Количества чеков | ||
| Receipt699 | |||
| Receipt999 | |||
| fnType | String | Тип фискального накопителя, установленного в кассу. Возможные значения: | |
| Fn15 | ФН15 | ||
| Fn36 | ФН36 | ||
| PaymentType | String | Значения способа оплаты заказа: Bill - выставление счета; CreditCard - оплата картой; SBP - оплата по СБП |
|
Пример ответа
{
"OrderID": "String"
"OrderReceiptUrl": "String",
}
Описание параметров ответа на запрос представлено в таблице 10.
Таблица 10. Параметры ответа на запрос
| Параметр | Формат | Описание |
|---|---|---|
| OrderID | String | Идентификатор заказа |
| OrderReceiptUrl | String | Возможные значения в зависимости от выбранного PaymentType в заказе: QR-код в формате Base64; Ссылка на оплату по карте; Ссылка на счет в формате PDF |
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 11. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | ValidationError | Идентификатор юридического лица клиента (OfdAgreementId) не определён |
| Тип тарифа (TariffType) не определён | ||
| Количество касс (Quantity) не определено | ||
| Способ оплаты (PaymentType) не определён | ||
| Неверный способ оплаты (PaymentType) | ||
| Недостаточно прав | ||
| Партнёр не существует | ||
| Тариф недоступен | ||
| 400 | OfdAgreementNotFound | Клиентский договор не найден |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Партнер может получить статус заказа посредством запроса статуса бронирования:
GET https://ofd.ru/api/integration/partner/v2/kkt/GetStatus?AuthToken={Code}&OrderID={orderid}
Параметры запроса:
Пример ответа на запрос
{
"Status": "Integer",
"DueDate": "String"
}
Описание параметров ответа на запрос представлено в таблице 12.
Таблица 12. Поля структуры ответа на запрос статуса заказа
| Параметр | Формат | Описание |
|---|---|---|
| Status | Integer | Статус заказа. Доступными результатами ответа в значении поля Status являются: 1 – Оплачен; 2 – Ожидает оплату; 3 – Просрочен |
| DueDate | String | Дата и время8), до которой на бронировании оплачен тариф, в формате UTC+0 «dd.mm.yyyy HH:MM:SS». Параметр отображается в ответе только в случае значения статуса 1 – Оплачен. |
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Метод возвращает только общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
При регистрации/перерегистрации ККТ на другие ОФД взимается плата с баланса ЛКП в размере 100 р.
Если на балансе недостаточно средств, система уведомит об этом, и регистрация или перерегистрация на другой ОФД осуществлена не будет.
Для работы API сервиса авторегистрации в ФНС в запросах и ответах используется кодировка UTF-8. Запросы выполняются методами POST, GET и PUT, параметры запроса располагаются в структуре данных формата JSON, передаваемой в блоке данных запроса (при использовании POST и PUT), также параметры могут передаваться в строке запроса (при использовании GET).
Ответы выдаются сервером в формате JSON и, в случае успешного ответа согласно его заголовку (код ответа по протоколу HTTP равен 200), данные имеют следующий обобщенный вид:
{
"Status": "Success",
"Data": {}
}
Получаем параметры ответа с кодом 200:
В случае ответа с ошибкой (код ответа по протоколу HTTP не равен 200) ответ имеет следующий вид:
{
"Status": "Failed",
"Error": {
Code: 0,
Message: "string"
}
}
В ответе с кодом не равным 200 возможны следующие параметры со значениями:
В разделе представлена общая JSON-схема заявки, описание параметров, а также описаны действия перед началом работы с API сервиса авторегистрации в ФНС.
Параметры заявок на регистрацию, перерегистрацию и снятие с учета передается в JSON структуре.
Вам представлена JSON-схема с параметрами для всех видов заявок.
Общая JSON-схема:
{
"Id": uuid,
"Purpose": string,
"Stage": string,
"Status": string,
"StatusReason": string,
"StatusChangeDateUtc": date,
"CompanyDetails": {
"CompanyType": string,
"Director": {
"FirstName": string,
"LastName": string,
"MiddleName": string
},
"FnsBranchCode": string,
"LegalAddress": {
"PostalCode": string,
"RegionCode": string,
"Region": string,
"Settlement": string,
"Street": string,
"HouseNumber": string,
"Building": string,
"Office": string,
"FiasCode": uiid,
"FullAddress": string
},
"Inn": string
"Ogrn": string,
"Kpp": string,
"CompanyName": string,
"Signatory": {
"Name": string,
"Position": string,
"Email": string,
"Phone": string,
"RepresentativeDetails": {
"Number": string,
"EvaluateDate": string,
"DocId": string,
}
}
},
"KktDetails": {
"SerialNumber": string,
"RegNumber": string,
"OfdInn": string,
"Ofdname": string,
"FnNumber": string,
"FnName": string,
"Model": string,
"InstallmentAddress": {
"PostalCode": string,
"RegionCode": string,
"Region": string,
"Settlement": string,
"Street": string,
"HouseNumber": string,
"FiasCode": uuid,
"FullAddress": string
},
"InstallmentPlace": string,
"ReregistrationReasons": {
"AutomatedDeviceChanged": bool,
"FnChanged": bool,
"InstallmentPlaceChanged": bool,
"OfdChaged": bool,
"Other": bool,
"SwitchedFromOfflineToOnlineMode": bool,
"SwitchedFromOnlineToOfflineMode": bool,
"UserChanged": bool
},
"UnregistrationReasons": {
"Lost": bool,
"Stolen": bool,
"Broken": bool
}
"UsageMode": {
"Gambling": bool,
"Lottery": bool,
"Agent": bool,
"AutomatedDevice": bool,
"Internet": bool,
"Mobile": bool,
"Banking": bool,
"ExcisableGoods": bool,
"FormsForReports": bool,
"Marking": bool
},
"FiscalDocumentData": {
"DateTime": date,
"DocumentNumber": string,
"Signature": string
},
"FnsBranchCode": string,
"ClosedFnDetails": {
"FdDateTime": date,
"FdNumber": string,
"FpValue": string
},
"InstalledFnDetails": {
"FdDateTime": date,
"FdNumber": string,
"FpValue": string
},
"IsPrinterInAutomat": bool,
"IsEncryption": bool,
"IsPaymentForService": bool,
"FormatVersion": int
},
"AutomaticDevices": [{
"InstallmentAddress": {
"PostalCode": string,
"RegionCode": string,
"Region": string,
"Settlement": string,
"Street": string,
"HouseNumber": string,
"FiasCode": uuid,
"FullAddress": string
},
"InstallmentPlace": string,
"DeviceNumber" string
}],
"FiscalDocuments": [{
"RawId": string,
"KktRegNumber": string,
"FnNumber": string,
"Tag": string,
"FdDateTime": string,
"FdNumber": string,
"FpValue": string,
"DownloadUri": string
}],
"Documents": [{
"Id": uuid,
"Kind": string,
"Content": string,
"Signature": string,
"Description": string,
"FileName": string
}],
"OfdAgreementId": uuid,
"CDateUtc": date,
"UDateUtc": date,
"UserAccountId": uuid,
"ResultDocs": [{
"KktId":
"ReportTypeId": string,
"DocType": string,
"ConversationUuid": uuid,
"ReportSizeInBytes": int,
"FileType": string,
"DownloadUri": string
}],
"DownloadUri": string,
"CanBeAutomaticDevice": bool
},
В таблице 13 представлено описание параметров.
Таблица 13. Описание параметров.
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| Id | Uuid | Уникальный идентификатор заявки |
| Purpose | String | Назначение заявки. Назначение заявки может принимать следующие значения: |
| - InitialRegistration - первичная регистрация; | ||
| - Reregistration - перерегистрация; | ||
| - Unregistration - снятие с учета. | ||
| Stage | String | Этап оформления заявки. Этап оформления заявки может принимать следующие значения: |
| - Initialization - начало оформления; | ||
| - Finalization - окончание оформления. | ||
| Status | String | Статус заявки. Статус заявки может принимать следующие значения: |
| - New - новая заявка на регистрацию/перерегистрацию; | ||
| - AwaitingDocuments - ожидание формирования документов для подписи; | ||
| - AwaitingSignature - документы сформированы, ожидают подписи; | ||
| - ProcessingSignedDocuments - проверка подписанных документов; | ||
| - ReadyToBeSentToFns - заявка готова к отправке в ФНС; | ||
| - SentToFns - заявка отправлена в ФНС; | ||
| - AwaitingAutoFinalization - ожидание завершения упрощенной перегистрации; | ||
| - Rejected - заявка отклонена; | ||
| - Approved - заявка одобрена; | ||
| - DownloadingDocuments - получения готовых документов; | ||
| - UnknownError - неизвестная ошибка. | ||
| StatusReason | String | В параметре присутствует описание причины отказа заявки на регистрацию/перерегистрацию ФНС |
| StatusChangeDateUtc | Date | Дата изменения состояния (UTC) |
| CompanyDetails | Object | Данные организации. Описание структуры параметра представлено в таблице 13.1. |
| KktDetails | Object | Сведения о кассе. Описание структуры параметра представлено в таблице 13.2. |
| AutomaticDevices | Array | Данные автоматического устройств. Описание структуры параметра представлено в таблице 13.3. |
| Object | ||
| FiscalDocuments | Array | Данные фисальных документов в заявке. Описание структуры параметра представлено в таблице 13.4. |
| Documents | Array | Исходящие документы от ФНС. Описание структуры параметра представлено в таблице 13.5. |
| Object | ||
| OfdAgreementId | Uuid | Идентификатор организации, привязанной к ЛКК OFD.ru |
| CDateUtc | Date | Дата создания заявки (UTC) |
| UDateUtc | Date | Дата изменения заявки (UTC) |
| UserAccountId | Uuid | Идентификатор ЛКК OFD.ru |
| ResultDocs | Array | Ответ ФНС на заявку о регистрации/перерегистрации. Описание структуры параметра представлено в таблице 13.6. |
| Object | ||
| DownloadUri | String | Ссылка для получения печатной формы заявления о регистрации/перерегистрации |
| CanBeAutomaticDevice | Boolean | Признак автоматического устройства |
Таблица 13.1. Описание параметров. Описание параметров структуры «CompanyDetails» (Данные об организации)
| Параметр | Вложенный параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|---|
| CompanyType | String | Тип организации имеет следующие значения: | ||
| - LegalEntity - Юридическое лицо; | ||||
| - PrivateEntrepreneur - Индивидуальный предприниматель. | ||||
| Director | Object | Руководитель организации | ||
| FirstName | String | Фамилия Руководителя организации | ||
| LastName | String | Имя Руководителя организации | ||
| MiddleName | String | Отчество Руководителя организации | ||
| FnsBranchCode | String | Код филиала ФНС | ||
| LegalAddress | Object | Адрес филиала ФНС | ||
| PostalCode | String | Почтовый индекс филиала ФНС | ||
| RegionCode | String | Код субъекта РФ | ||
| Region | String | Наименование субъекта РФ | ||
| Settlement | String | Населённый пункт | ||
| HouseNumber | String | Номер дома | ||
| Building | String | Строение | ||
| Office | String | Номер комнаты/офиса | ||
| FiasCode | Uuid | Код ФИАС | ||
| FullAddress | String | Полный адрес филиала ФНС | ||
| Inn | String | Идентификационный номер налогоплательщика | ||
| Ogrn | String | Основной государственный регистрационный номер юридического лица | ||
| Kpp | String | Код основания постановки на учет в ФНС | ||
| CompanyName | String | Наименование организации | ||
| TaxationType | Object | Тип налогообложения | ||
| Common | 0 | String | Общая | |
| SimpleIn | 1 | String | Упрощённая Доход (УСН(Д)) | |
| SimpleInOut | 2 | String | Упрощённая Доход минус Расход (УСН(Д-Р)) | |
| Unified | 3 | String | Единый налог на вмененный доход (ЕНВД) | |
| UnifiedAgricultural | 4 | String | Единый сельскохозяйственный налог (ЕСХН) | |
| Patent | 5 | String | Патентная система налогообложения (ПСН) | |
| Unknown | 6 | String | Не определено | |
| AutomatedSimpleIn | 7 | String | Автоматизированная упрощённая Доход (АУСН(Д)) | |
| AutomatedSimpleInOut | 8 | String | Автоматизированная упрощённая Доход минус Расход (АУСН(Д-Р)) | |
| Signatory | Object | Сведения о подписанте | ||
| Name | String | Имя подписанта | ||
| Position | String | Должность | ||
| String | Электронный адрес почты подписанта | |||
| Phone | String | Контактный телефон подписанта | ||
| RepresentativeDetails | Object | Структура данных машинно-читаемой доверенности (далее - МЧД) | ||
| Number | String | Номер МЧД | ||
| EvaluateDate | String | Дата МЧД | ||
| DocId | String | ID МЧД |
Таблица 13.2. Описание параметров. Описание параметров структуры «KktDetails» (Сведения о кассе)
| Параметр | Вложенный параметр | Формат значения | Описание параметра | |
|---|---|---|---|---|
| SerialNumber | String | Серийный номер кассы | ||
| RegNumber | String | Регистрационный номер касс | ||
| OfdInn | String | ИНН ОФД. Значение должно совпадать с данными из ФНС | ||
| OfdName | String | Название компании ОФД. Значение должно совпадать с данными из ФНС | ||
| FnNumber | String | Номер фискального накопителя | ||
| FnName | String | Название фискального накопителя | ||
| Model | String | Модель кассы | ||
| InstallmentAddress | Object | Адрес установки кассы | ||
| PostalCode | String | Почтовый индекс адреса установки кассы | ||
| RegionCode | String | Код субъекта РФ | ||
| Region | String | Наименование субъекта РФ | ||
| Settlement | String | Населённый пункт | ||
| HouseNumber | String | Номер дома | ||
| Building | String | Строение | ||
| Office | String | Номер комнаты/офиса | ||
| FiasCode | Uuid | Код ФИАС | ||
| FullAddress | String | Полный адрес установки кассы | ||
| InstallmentPlace | String | Адрес места расчета | ||
| ReregistrationReasons | Object | Причины перерегистрации кассы | ||
| AutomatedDeviceChanged | Boolean | Измение автоматического устройства | ||
| FnChanged | Bool | Замена фискального накопителя | ||
| InstallmentPlaceChanged | Bool | Изменение адреса и места установки | ||
| OfdChaged | Boolean | Смена оператора фискальных данных | ||
| Other | Boolean | Другие причины | ||
| SwitchedFromOfflineToOnlineMode | Boolean | Переключение в режим работы в сети интернет | ||
| SwitchedFromOnlineToOfflineMode | Boolean | Переключение в автономный режим работы | ||
| UserChanged | Boolean | Смена организации | ||
| UnregistrationReasons | Object | Причины снятия кассы с учета | ||
| Lost | Boolean | Утеряна | ||
| Stolen | Boolean | Украдена | ||
| Broken | Boolean | Сломана | ||
| AgentSettings | Object | Агентские признаки | ||
| None | Boolean | Без агентских признаков | ||
| Agent | Boolean | Агент | ||
| PayAgent | Boolean | Платежный агент | ||
| BankPayAgent | Boolean | Банковский платежный агент | ||
| PaySubAgent | Boolean | Платежный субагент | ||
| BankPaySubAgent | Boolean | Банковский платежный субагент | ||
| Commissioner | Boolean | Комиссионер | ||
| Represent | Boolean | Поверенный | ||
| UsageMode | Object | Признак расчетов по кассе | ||
| Offline | Boolean | Offline-режим работы ККТ | ||
| Gambling | Boolean | Азартные игры: прием ставок и выплата выигрыша | ||
| Lottery | Boolean | Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша | ||
| Agent | Boolean | Платежный агент (субагент) | ||
| AutomatedDevice | Boolean | Признак: установка принтера в автомате | ||
| Internet | Boolean | Расчеты в интернете | ||
| Mobile | Boolean | Развозная и (или) разносная торговля | ||
| Banking | Boolean | Банковский платежный агент (субагент) | ||
| ExcisableGoods | Boolean | Касса используется для реализации подакцизных товаров | ||
| FormsForReports | Boolean | Оказания услуг | ||
| Marking | Boolean | Касса используется для реализации товаров с обязательной маркировкой | ||
| PawnShop | Boolean | Ломбард | ||
| Insurance | Boolean | Использование ККТ для расчетов по выплате страховых премий и вознаграждений | ||
| FiscalDocumentData | Object | Данные фискального документа | ||
| DateTime | Date | Время и дата пробития (UTC) | ||
| DocumentNumber | String | Номер фискального документа (UTC) | ||
| Signature | String | ЭЦП документа в формате base64 | ||
| FnsBranchCode | String | Код филиала ФНС | ||
| ClosedFnDetails | Object | Отчет о закрытии фискального накопителя | ||
| FdDateTime | Date | Время и дата пробития (UTC) | ||
| FdNumber | String | Номер фискального документа | ||
| FpValue | String | Фискальный признак | ||
| InstalledFnDetails | Object | Отчет об установки фискального накопителя | ||
| FdDateTime | Date | Время и дата пробития (UTC) | ||
| FdNumber | String | Номер фискального документа | ||
| FpValue | String | Фискальный признак | ||
| IsPrinterInAutomat | Boolean | Признак принтера в автоматическом режиме | ||
| IsEncryption | Boolean | Признак шифрования | ||
| IsPaymentForService | Boolean | Признак оплаты сервиса | ||
| FnType | Integer | Тип фискального накопителя. Возможные значения: | ||
| - 0 - UnKnown - Не определено; | ||||
| - 1 - FN15 - ФН 15 мес; | ||||
| - 2 - FN36 - ФН 36 мес. | ||||
| FormatVersion | Integer | Версия фискального документа. Версия фискального документа может принимать следующие значения: |
||
| - 1 - ФФД версии 1.0; | ||||
| - 2 - ФФД версии 1.05; | ||||
| - 3 - ФФД версии 1.1; | ||||
| - 4 - ФФД версии 1.2. | ||||
Таблица 13.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| InstallmentAddress | Object | Адрес установки кассы | |
| PostalCode | String | Почтовый индекс установки автоматического устройства | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Субъект РФ | |
| Street | String | Улица | |
| Locality | String | Населённый пункт | |
| City | String | Город | |
| District | String | Район | |
| HouseNumber | String | Номер дома | |
| Block | String | Номер строения/корпуса | |
| Flat | String | Номер квартиры/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки автоматического устройства | |
| InstallmentPlace | String | Место расчетов автоматического устройства | |
| DeviceNumber | String | Номер автоматического устройства |
Таблица 13.4. Описание параметров. Описание параметров структуры «FiscalDocuments» (Данные фисальных документов в заявке)
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| RawId | String | Уникальный номер фискального документа |
| KktRegNumber | String | Регистрационный номер ККТ |
| FnNumber | String | Номер фискального накопителя |
| Tag | String | Численный признак вида документа |
| FdDateTime | String | Время и дата пробития |
| FdNumber | String | Номер фискального документа |
| FpValue | String | Фискальный признак |
| DownloadUri | String | Ссылка для получения печатной формы заявления о регистрации/перерегистрации |
Таблица 13.5. Описание параметров. Описание параметров структуры «Documents» (Исходящие документы от ФНС)
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| Id | Uuid | Идентификатор исходящего документа |
| Kind | String | Вид исходящего документа |
| Content | String | Содержание исходящего документа |
| Signature | String | ЭЦП документа в формате base64 |
| Description | String | Описание |
| FileName | String | Название файла |
Таблица 13.6. Описание параметров. Описание параметров структуры «ResultDocs» (Ответ ФНС на заявку)
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| KktId | String | Идентификатор кассы |
| ReportTypeId | String | Идентификатор ответа ФНС на заявку о регистрации/перерегистрации |
| DocType | String | Ответ ФНС на заявку о регистрации/перерегистрации может принимать значения: |
| - RnmReport - отчёт о присвоении РНМ; | ||
| - RegReport - карточка регистрации ККТ; | ||
| - ReRegReport - карточка перерегистрации ККТ; | ||
| - RnmRejection - отказ на получение РНМ в рамках регистрации ККТ; | ||
| - RegRejection - отказ регистрации ККТ; | ||
| - ReRegRejection - отказ перерегистрации ККТ; | ||
| - UnReg - Снятие с учета; | ||
| - UnRegRejection - Отказ снятия с учета; | ||
| - UnKnown - не определён. | ||
| ConversationUuid | Uuid | Идентификатор сообщения ФНС |
| ReportSizeInBytes | Integer | Размер файла с ответом от ФНС |
| FileType | String | Расширение файла с ответом от ФНС |
| DownloadUri | String | Ссылка для получения печатной формы заявления о регистрации/перерегистрации |
В таблице 14 представлено описание прохождения этапов заявки.
Таблица 14. Описание этапов заявки
| Этап | Параметр | Значение | Описание | Тип заявки |
|---|---|---|---|---|
| Создание | Stage | Initialization | Создание заявки | Регистрация Перерегистрация Снятие с учета |
| Finalization | Создание заявки об отчете о регистрации | Регистрация | ||
| Status | New | Новая | Регистрация Перерегистрация Снятие с учета |
|
| Подготовка к подписи | Stage | Initialization | Создание заявки | Регистрация Перерегистрация Снятие с учета |
| Finalization | Создание заявки об отчете о регистрации | Регистрация | ||
| Status | AwaitingSignature, возможное промежуточное состояние AwaitingDocuments | Ожидание подписи, Ожидание подписанных документов для отправки | Регистрация Перерегистрация Снятие с учета |
|
| Подписание и отправка в ФНС | Stage | Initialization | Создание заявки | Регистрация Перерегистрация Снятие с учета |
| Finalization | Создание заявки об отчете о регистрации | Регистрация | ||
| Status | SentToFns Возможные промежуточные состояния: - ProcessingSignedDocuments; - ReadyToBeSentToFns. | Документы отправлены. Описание промежуточных состояний: - Документы в процессе отправки; - Документы готовы к отправке. | Регистрация Перерегистрация Снятие с учета |
|
| Проверка статуса | Stage | Finalization | Заявка создана | Регистрация Перерегистрация Снятие с учета Отчет о регистрации |
| Status | New | Для завершения регистрации кассы в фнс необходимо отправить отчете о регистрации | Регистрация | |
| Approved | касса успешно зарегистрирована, перерегистрирована или снята с учёта | Регистрация Перерегистрация Снятие с учета |
||
| Rejected | заявка отклонена, описание отказа описано в параметре StatusReason | Регистрация Перерегистрация Снятие с учета |
В разделе описаны выполнения запросов, методы вызова, параметры и их значения для осуществления всех этапов прохождения заявки.
Запрос выполняется для заявок на:
Начальный этап для всех видов заявок.
Рассмотрим работу запроса на примере создания заявки регистрации кассы в ФНС.
В запросе вы указываете основные данные для оформления заявки на регистрацию кассы в ФНС. Данные для регистрации кассы передаются в JSON-структуре.
Запрос на создание заявки выполняется методом POST
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration?AuthToken={Code}
В запросе участвует необходимый параметр AuthToken. Значение параметра AuthToken принимает действующий код авторизации. Значение кода авторизации получаем в ответе на запрос AuthToken, описанный в разделе Авторизация
Таблица 15. Описание параметров запроса на создание заявки на регистрацию кассы
| Параметр | Вложенный параметр | Вложенный параметр | Формат значения | Описание |
|---|---|---|---|---|
| Purpose | String | Назначение заявки. Назначение заявки может принимать одно из значений: |
||
| - InitialRegistration - первичная регистрация; | ||||
| - Reregistration - перерегистрация; | ||||
| - Unregistration - снятие с учета. | ||||
| CompanyDetails | Object | Данные организации | ||
| Inn | String | Идентификационный номер налогоплательщика | ||
| Kpp | String | Код основания постановки на учет в ФНС | ||
| RepresentativeDetails | Object | Структура данных МЧД | ||
| Number | String | Номер МЧД | ||
| EvaluateDate | String | Дата МЧД | ||
| DocId | String | ID МЧД | ||
| KktDetails | Object | Сведения о кассе | ||
| SerialNumber | String | Серийный номер кассы | ||
| OfdInn | String | ИНН ОФД. Значение должно совпадать с данными из ФНС | ||
| OfdName | String | Название компании ОФД. Значение должно совпадать с данными из ФНС | ||
| FnNumber | String | Номер фискального накопителя | ||
| FnName | String | Название фискального накопителя | ||
| Model | String | Модель кассы | ||
| InstallmentAddress | Object | Адрес установки кассы | ||
| PostalCode | String | Почтовый индекс адреса установки кассы | ||
| RegionCode | String | Код субъекта РФ | ||
| Region | String | Наименование субъекта РФ | ||
| Settlement | String | Населённый пункт | ||
| HouseNumber | String | Номер дома | ||
| Building | String | Строение | ||
| Office | String | Номер комнаты/офиса | ||
| FiasCode | Uuid | Код ФИАС | ||
| FullAddress | String | Полный адрес установки кассы | ||
| InstallmentPlace | String | Адрес места расчета | ||
| UsageMode | Object | Признак расчетов по кассе | ||
| Gambling | Boolean | Азартные игры: прием ставок и выплата выигрыша | ||
| Lottery | Boolean | Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша | ||
| Agent | Boolean | Платежный агент (субагент) | ||
| AutomatedDevice | Boolean | Признак: установка принтера в автомате | ||
| Internet | Boolean | Расчеты в интернете | ||
| Mobile | Boolean | Развозная и (или) разносная торговля | ||
| Banking | Boolean | Банковский платежный агент (субагент) | ||
| ExcisableGoods | Boolean | Касса используется для реализации подакцизных товаров | ||
| FormsForReports | Boolean | Оказания услуг | ||
| Marking | Boolean | Касса используется для реализации товаров с обязательной маркировкой | ||
| FormatVersion | Integer | Версия фискального документа. Версия фискального документа может принимать следующие значения: |
||
| - 2 - ФФД версии 1.05; | ||||
| - 3 - ФФД версии 1.1; | ||||
| - 4 - ФФД версии 1.2. | ||||
Пример запроса на создание заявки на регистрацию кассы в ФНС:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration?AuthToken=fefdbc999e2747b9999e04cb2efabf2c
Content-Type: application/json
{
"Purpose": "InitialRegistration",
"CompanyDetails":
{
"Inn":"7799999605",
"Kpp":"779999901"
},
"KktDetails":
{
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"SerialNumber": "1099995991",
"FnNumber": "9287440300999999",
"Model": "АТОЛ 42ФС",
"InstallmentAddress":
{
"FullAddress": "Москва, Ленинская Слобода, 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode":
{
"Internet": true,
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false
},
"FormatVersion": 3
}
}
Пример ответа на запрос создания заявки на регистрацию кассы:
{
"Data": {
"Id": "dce99999-ee9b-4378-990c-99999ef3815c",
"CompanyDetails": {
"Director": {},
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"FullAddress": ""
},
"Inn": "7799999905",
"Kpp": "779999991",
"Signatory": {
"Email": "test@ofd.ru",
"Phone": "9165999997",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287499999993573",
"InstallmentAddress": {
"FullAddress": "Москва, Ленинская Слобода, 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "АТОЛ 42ФС",
"SerialNumber": "1099999781",
"FiscalDocumentData": {},
"ClosedFnDetails": {},
"InstalledFnDetails": {}
},
"AutomaticDevices": [],
"Status": "New",
"Stage": "Initialization",
"CanDelete": true,
"Documents": [],
"Purpose": "InitialRegistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "999ae9fc-edaa-43fd-ba93-f999e3ed841f",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "NotStarted",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "999ae9fc-edaa-43fd-ba93-f599e3ed999f",
"CreatedDate": "2021-07-30T11:23:53",
"UpdatedDate": "2021-08-04T12:15:38",
"Number": "1129999811",
"LegalAddress": {
"PostalCode": "109004",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Земляной Вал",
"HouseNumber": "д 73",
"FullAddress": "г Москва, ул Земляной Вал, д 73"
},
"PostalAddress": {
"FullAddress": ""
},
"Inn": "7709125605",
"Ogrn": "1027700200494",
"Kpp": "770901001",
"CompanyName": "ФГБОУ ВО \"МГУТУ ИМ. К.Г. РАЗУМОВСКОГО (ПКУ)\"",
"Signatory": {
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"StatusChangeDateUtc": "2021-11-29T14:25:45",
"CDateUtc": "2021-11-29T14:25:45",
"UDateUtc": "2021-11-29T14:25:45",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=dce50538-ee9b-4378-990c-66824ef3815c&format=pdf",
"CanBeAutomaticDevice": false
},
"Success": true
}
Описание параметров ответа на запрос представлено в таблице 16.
Таблица 16. Описание параметров ответа на запрос.
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| Id | Uuid | Уникальный идентификатор заявки |
| CompanyDetails | Object | Данные организации. Описание структуры параметра представлено в таблице 16.1. |
| KktDetails | Object | Сведения о кассе. Описание структуры параметра представлено в таблице 16.2. |
| AutomaticDevices | Array | Данные автоматического устройств. Описание структуры параметра представлено в таблице 16.3. |
| Object | ||
| Stage | String | Этап оформления заявки. Этап оформления заявки может принимать следующие значения: |
| - Initialization - начало оформления; | ||
| - Finalization - окончание оформления. | ||
| Status | String | Статус заявки. Статус заявки может принимать следующие значения: |
| - New - новая заявка на регистрацию/перерегистрацию; | ||
| - AwaitingDocuments - ожидание формирования документов для подписи; | ||
| - AwaitingSignature - документы сформированы, ожидают подписи; | ||
| - ProcessingSignedDocuments - проверка подписанных документов; | ||
| - ReadyToBeSentToFns - заявка готова к отправке в ФНС; | ||
| - SentToFns - заявка отправлена в ФНС; | ||
| - AwaitingAutoFinalization - ожидание завершения упрощенной перегистрации; | ||
| - Rejected - заявка отклонена; | ||
| - Approved - заявка одобрена; | ||
| - DownloadingDocuments - получения готовых документов; | ||
| - UnknownError - неизвестная ошибка. | ||
| CanDelete | Boolean | Признак разрешения удалить заявку |
| Documents | Array | Документы, сгенерированные в процессе регистрации |
| Purpose | String | Назначение заявки. Назначение заявки может принимать следующие значения: |
| - InitialRegistration - первичная регистрация; | ||
| - Reregistration - перерегистрация; | ||
| - Unregistration - снятие с учета. | ||
| OfdAgreementId | String | Идентификатор юридического лица, прикрепленного к ЛК OFD.ru |
| OfdAgreement | Object | Описания и условия предоставления услуг OFD.ru. Описание структуры параметра представлено в таблице 16.3. |
| StatusChangeDateUtc | Date | Дата и время смены статуса заявки |
| CDateUtc | Date | Дата и время создания заявки |
| UDateUtc | Date | Дата и время последнего изменения шаблона заявки |
| UserAccountId | String | Идентификатор ЛКК |
| DownloadUri | String | Ссылка для получения печатной формы в формате *.pdf |
| CanBeAutomaticDevice | Boolean | Признак автоматического устройства |
Таблица 16.1. Описание параметров ответа на запрос. Описание параметров структуры «CompanyDetails» (Данные организации)
| Параметр | Вложенный параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|---|
| CompanyType | String | Тип организации имеет следующие значения: | ||
| - LegalEntity - Юридическое лицо; | ||||
| - PrivateEntrepreneur - Индивидуальный предприниматель. | ||||
| Director | Object | Руководитель организации | ||
| FirstName | String | Фамилия Руководителя организации | ||
| LastName | String | Имя Руководителя организации | ||
| MiddleName | String | Отчество Руководителя организации | ||
| FnsBranchCode | String | Код филиала ФНС | ||
| LegalAddress | Object | Адрес филиала ФНС | ||
| PostalCode | String | Почтовый индекс филиала ФНС | ||
| RegionCode | String | Код субъекта РФ | ||
| Region | String | Наименование субъекта РФ | ||
| Settlement | String | Населённый пункт | ||
| HouseNumber | String | Номер дома | ||
| Building | String | Строение | ||
| Office | String | Номер комнаты/офиса | ||
| FiasCode | Uuid | Код ФИАС | ||
| FullAddress | String | Полный адрес филиала ФНС | ||
| Inn | String | Идентификационный номер налогоплательщика | ||
| Ogrn | String | Основной государственный регистрационный номер юридического лица | ||
| Kpp | String | Код основания постановки на учет в ФНС | ||
| CompanyName | String | Наименование организации | ||
| TaxationType | Object | Тип налогообложения | ||
| Common | 0 | String | Общая | |
| SimpleIn | 1 | String | Упрощённая Доход (УСН(Д)) | |
| SimpleInOut | 2 | String | Упрощённая Доход минус Расход (УСН(Д-Р)) | |
| Unified | 3 | String | Единый налог на вмененный доход (ЕНВД) | |
| UnifiedAgricultural | 4 | String | Единый сельскохозяйственный налог (ЕСХН) | |
| Patent | 5 | String | Патентная система налогообложения (ПСН) | |
| Unknown | 6 | String | Не определено | |
| AutomatedSimpleIn | 7 | String | Автоматизированная упрощённая Доход (АУСН(Д)) | |
| AutomatedSimpleInOut | 8 | String | Автоматизированная упрощённая Доход минус Расход (АУСН(Д-Р)) | |
| Signatory | Object | Сведения о подписанте | ||
| Name | String | Имя подписанта | ||
| Position | String | Должность | ||
| String | Электронный адрес почты подписанта | |||
| Phone | String | Контактный телефон подписанта | ||
| RepresentativeDetails | Object | Структура данных машинно-читаемой доверенности (далее - МЧД) | ||
| Number | String | Номер МЧД | ||
| EvaluateDate | String | Дата МЧД | ||
| DocId | String | ID МЧД |
Таблица 16.2. Описание параметров ответа на запрос. Описание параметров структуры «KktDetails» (Сведения о кассе)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| FnNumber | String | Номер фискального накопителя | |
| FnName | String | Название фискального накопителя | |
| OfdInn | String | ИНН ОФД. Значение должно совпадать с данными из ФНС | |
| OfdName | String | Название компании ОФД. Значение должно совпадать с данными из ФНС | |
| InstallmentAddress | Object | Адрес установки кассы | |
| FullAddress | String | Полный адрес установки кассы | |
| InstallmentPlace | String | Адрес места расчета | |
| UsageMode | Object | Признак расчетов по кассе | |
| Gambling | Boolean | Азартные игры: прием ставок и выплата выигрыша | |
| Lottery | Boolean | Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша | |
| Agent | Boolean | Платежный агент (субагент) | |
| AutomatedDevice | Boolean | Признак: установка принтера в автомате | |
| Internet | Boolean | Расчеты в интернете | |
| Mobile | Boolean | Развозная и (или) разносная торговля | |
| Banking | Boolean | Банковский платежный агент (субагент) | |
| ExcisableGoods | Boolean | Касса используется для реализации подакцизных товаров | |
| FormsForReports | Boolean | Оказания услуг | |
| Marking | Boolean | Касса используется для реализации товаров с обязательной маркировкой | |
| Model | String | Модель кассы | |
| SerialNumber | String | Серийный номер кассы | |
| FiscalDocumentData | Object | Данные фискального документа | |
| ClosedFnDetails | Object | Отчет о закрытии фискального накопителя | |
| InstalledFnDetails | Object | Отчет об установки фискального накопителя |
Таблица 16.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| InstallmentAddress | Object | Адрес установки кассы | |
| PostalCode | String | Почтовый индекс установки автоматического устройства | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Субъект РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Номер строения | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки автоматического устройства | |
| InstallmentPlace | String | Место расчетов автоматического устройства | |
| DeviceNumber | String | Номер автоматического устройства |
Таблица 16.4. Описание параметров. Описание параметров структуры «OfdAgreement» (Описания и условия предоставления услуг OFD.ru)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| PayPeriods | Object | Период оплаты услуг OFD.ru | |
| 1 | String | Каждый месяц | |
| 3 | String | Каждый квартал | |
| 12 | String | Каждый год | |
| State | String | Регион нахождения клиента | |
| HasUnifiedOrPatentTaxation | Boolean | Признак СНО «УСН» или «Патент» | |
| IncorrectNdsCalculationKktExist | Boolean | Признак плательщика НДС | |
| Id | String | Идентификатор юридического лица, прикрепленного к ЛК OFD.ru | |
| CreatedDate | Date | Дата создания ЛКК | |
| UpdatedDate | Date | Дата обновления данных | |
| Number | String | Номер | |
| LegalAddress | Object | Фактический адрес организации | |
| PostalCode | String | Почтовый индекс адреса установки кассы | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Наименование субъекта РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Строение | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки кассы | |
| PostalAddress | Object | Адрес для корреспонденции | |
| FullAddress | String | Полный адрес для корреспонденции | |
| Inn | String | Идентификационный номер налогоплательщика | |
| Ogrn | String | Основной государственный регистрационный номер юридического лица | |
| Kpp | String | Код основания постановки на учет в ФНС | |
| CompanyName | String | Наименование организации | |
| Signatory | Object | Сведения о руководителе организации | |
| IsNdsPayer | Boolean | Организация работает с НДС | |
| ElectronicInvoicingType | String | Тип электронного документооборота | |
| PaymentType | String | Тип осуществления расчетов | |
| ProxyTestDiveAvailable | Boolean | Служебная строка, используется в отладочных целях | |
| IsReceiptSendingEnable | Boolean | Статус услуги ОФД | |
| IsPaymentAgent | Boolean | Признак платежного агента | |
| ShowEReceiptMainBanner | Boolean | Признак показа рекламного баннера в чеке при отправке по email | |
| LockCreatingCompanyWithOtherKpp | Boolean | Блокировать создания компании с другим КПП |
Если вы подписываете заявку на регистрацию/перерегистрацию, снятие с учета ККТ не от руководителя организации, то в заявке необходимо указать данные машинопечатной доверенности (далее - МЧД).
Заявка на регистрацию/перерегистрацию, снятие с учета с использованием МЧД выполняется методом описанным в разделе 7.1.
Пример заявки на регистрацию кассы с использованием МЧД:
{
"Purpose": "InitialRegistration",
"CompanyDetails":
{
"Inn":"5259999920",
"Kpp":"525999901",
"Signatory": {
"RepresentativeDetails": {
"Number":"- номер МЧД",
"EvaluateDate":"- дата МЧД",
"DocId": "- ID МЧД"
}
}
},
"KktDetails":
{
"SerialNumber": "1201999972",
"OfdInn": "7841465999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"FnNumber": "9251440300206308",
"Model": "САЛЮТ-12Ф",
"InstallmentAddress":
{
"FullAddress": "Москва, Ленинская Слобода, 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode":
{
"Internet": true,
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false
},
"FormatVersion": 3
}
}
Описание параметров запроса и параметров ответа представлено в таблице 16 раздела 7.1.
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 17. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | ValidationError | Не задан ИНН |
| Не заданы данные кассы | ||
| Не определена модель ФН | ||
| Не задана причина перерегистрации ККТ | ||
| Не заданы данные отчёта о закрытии ФН | ||
| Не заданы данные отчёта о перерегистрации | ||
| Пользователь не найден | ||
| Договор не найден |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Запрос выполняется для упрощенного процесса:
В запросе вы указываете основные данные для оформления заявки в ФНС.
Запрос выполняется методом POST с передачей параметров в JSON-структуре.
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/simplified?AuthToken={code}
Code — значение действующего кода авторизации, полученного в ЛКП;
Есть 2 способа обращения к методу:
● Без создания заявки на регистрацию/перерегистрацию/снятие с учета ККТ в ФНС:
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/simplified?AuthToken=d000000efd1c4b0ba70ef05b95a9a000
Content-Type: application/json
{
"RegNumber": "0000002950038403",
"FnNumber": "9287440300784224",
"DocumentNumber": "1",
"Inn": "5252012620",
"Purpose": "InitialRegistration"
}
Таблица 18. Описание параметров запроса без создания заявки.
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| RegNumber | string | РНМ ККТ |
| FnNumber | string | номер фискального накопителя |
| DocumentNumber | string | номер фискального документа |
| Inn | string | ИНН клиента |
| Purpose | string | Назначение заявки. Назначение заявки может принимать следующие значения: - InitialRegistration - первичная регистрация; - Reregistration - перерегистрация |
● С созданием заявки на регистрацию/перерегистрацию/снятие с учета ККТ в ФНС:
Передайте в теле запроса «ApplicationId: Id», полученный в ответе на запрос на создание заявки.
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/simplified?AuthToken=d191800efd1c4b0ba70ef05b95a9a582
Content-Type: application/json
{
"ApplicationId": "dce99999-ee9b-4378-990c-99999ef3815c",
}
Пример ответа на запрос:
{
"Data": {
"Id": "000bab1a-c00f-0000-be3a-bed5a000fd6e",
"CompanyDetails": {
"Director": {},
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"FullAddress": ""
},
"Inn": "3814000000",
"Signatory": {
"Email": "test@test.ru",
"Phone": "89999999999",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.2 исполнение Ин15-4»",
"FnNumber": "7380440802000000",
"InstallmentAddress": {
"FullAddress": ""
},
"AgentSettings": {
"None": false,
"Agent": false,
"PayAgent": false,
"BankPayAgent": false,
"PaySubAgent": false,
"BankPaySubAgent": false,
"Commissioner": false,
"Represent": false
},
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false,
"PawnShop": false,
"Insurance": false
},
"FiscalDocumentData": {
"DocumentNumber": "1"
},
"ClosedFnDetails": {},
"InstalledFnDetails": {}
},
"AutomaticDevices": [],
"Status": "New",
"Stage": "Initialization",
"CanSign": true,
"CanDelete": true,
"Documents": [],
"Purpose": "InitialRegistration",
"Gateway": "EKkt",
"OfdAgreementId": "c34f4ca9-74a4-4f06-ab84-00000000e3cb",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "NotStarted",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"ResponsibleManagerId": "2da000f7-0000-0d00-8eb4-000fe974e29e",
"Id": "c34f4ca9-74a4-4f06-ab84-88633180e3cb",
"CreatedDate": "2019-11-05T03:27:06",
"UpdatedDate": "2024-12-23T10:02:24",
"Number": "0000000604",
"LegalAddress": {
"City": "город Саянск",
"PostalCode": "666302",
"Region": "Иркутская",
"Settlement": "Центральный",
"Street": " ",
"HouseNumber": "15В",
"FullAddress": "666302, ИРКУТСКАЯ ОБЛАСТЬ, Г.О. ГОРОД САЯНСК, Г САЯНСК, МКР. ЦЕНТРАЛЬНЫЙ, СТР. 15В"
},
"PostalAddress": {
"City": "г Зима",
"PostalCode": "665388",
"RegionCode": "38",
"Region": "Иркутская область",
"Street": "ул Березовского",
"HouseNumber": "66",
"FullAddress": "665388, ул Березовского, 66"
},
"Inn": "3814000000",
"Ogrn": "1193850000000",
"Kpp": "381400000",
"CompanyName": "ООО \"ФАРТ\"",
"Signatory": {
"Name": "Скляренко Тарас Владимирович",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "PostPayment",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"StatusChangeDateUtc": "2025-05-21T16:49:22",
"CDateUtc": "2025-05-21T16:49:22",
"UDateUtc": "2025-05-21T16:49:22",
"UserAccountId": "0000000f-e23c-4355-9ce8-0000002b1f63",
"DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=000bab1a-c00f-0000-be3a-bed5a000fd6e&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа на запрос представлено в таблице 16 пункта 7.1
В случае неверных данных, в запросе вернется ошибка.
Пример ошибки:
{
"Data": null,
"Success": false,
"Errors": [
{
"Code": "InternalError",
"Message": "Не удалось оплатить услугу"
}
]
}
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 19. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | ValidationError | Регистрационный номер ККТ не заполнен (RegNumber) |
| Серийный номер ФН не заполнен (FnNumber) | ||
| Номер документа не заполнен (DocumentNumber) | ||
| ИНН не заполнен (Inn) | ||
| Не указано назначение (Purpose) | ||
| Некорректный статус заявки | ||
| 400 | DataNotFound | Заявка не найдена |
| 500 | InternalError | Не удалось запустить упрощённый процесс регистрации |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Чтобы узнать статус заявки, используйте метод:
GET https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:guid}/simplified/status
В запросе присутствует заменяемый параметр id:uuid - идентификатор заявки. Значение идентификатора заявки - это значение параметра ID из ответа на запрос описанный в разделе "7.1. Описание запроса на создание заявки";
Пример ответа на запрос. Возможные статусы представлены в таблице 16.
{
"Data": {
"Status": "SUCCESS",
"DownloadUrl": "https://ofd.ru/api/integration/v2/b2b/kkt/registration/3d79999e-f999-4ea4-8adc-ff299999db40/simplified/download?AuthToken=4E7E8D09D99999984640B8249999994"
},
"Success": true
}
Таблица 20. Описание возможных статусов по заявке
| Параметр | Значение | Описание |
|---|---|---|
| Status | ||
| PROCESSING | Документ находится в обработке ФНС | |
| REJECTED | Карточка ККТ сформированная в результате упрощенной регистрации/перерегистрации не найдена | |
| SUCCESS | Успешно найдена карточка ККТ сформированная в результате упрощенной регистрации/перерегистрации | |
| ERROR | Остальные ошибки |
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 21. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | DataNotFound | Заявка не найдена (ApplicationNotFound) |
| 500 | InternalError | Не удалось проверить статус заявки |
| Не удалось получить статус |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Запрос выполняется для:
Следующий этап, подготовка заявления для подписи. Рассмотрим работу запроса на примере заявки на регистрацию кассы в ФНС.
Запрос подготовки заявления выполняется методом POST с передачей параметров в JSON структуре.
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:uuid}/prepareDocuments?AuthToken={authToken}
В запросе обязательно присутствуют заменяемые параметры:
В теле запроса передаются следующие параметры:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/4121f0e0-f468-48fc-9387-b6a2d5646bc5/prepareDocuments?AuthToken=8dd69254b0444a1cbd103f80012cf1bb6
Content-Type: application/json
{
"GivenName": "Алла Романовна",
"LastName": "Романова",
"Position": "ТестДолжность"
}
Пример успешного ответа на запрос:
{
"Data": {
"Id": "4d5d5574-433d-4c3f-afd7-3b3c39595d33",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Юлия",
"LastName": "Ященко",
"MiddleName": "Владимирович"
},
"FnsBranchCode": "0278",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "394030",
"RegionCode": "36",
"Region": "Воронежская обл",
"Settlement": "г Уфа",
"Street": "ул Бакунина",
"HouseNumber": "1",
"Building": "к 1",
"Office": "пом 16И",
"FiasCode": "8a9c23a2-75a1-46e2-9151-e77233c37d5d",
"FullAddress": "394030, г Уфа, ул Бакунина, 1, корп/стр: к 1, офис/кв: пом 16И"
},
"Inn": "0278199519",
"Ogrn": "1053600591197",
"Kpp": "366401001",
"CompanyName": "ООО \"ПРИМЕР\"",
"Signatory": {
"Name": "Ященко Юлия Владимирович",
"Position": "Управляющий - индивидуальный предприниматель",
"Email": "yascher@ofd.ru",
"Phone": "1112223457",
"IsRepresent": false
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300783573",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "АТОЛ 42ФС",
"SerialNumber": "1077095781",
"FiscalDocumentData": {},
"FnsBranchCode": "7725",
"ClosedFnDetails": {},
"InstalledFnDetails": {}
},
"AutomaticDevices": [],
"Status": "AwaitingSignature",
"Stage": "Initialization",
"CanDelete": false,
"Documents": [
{
"Id": "c536906e-535f-454a-a732-d5519d01fdd1",
"Kind": "1110061",
"Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIgICAgICAgPC/R4uXkwOTwzNPx8j4KICAgI
CAgICAgICAgPC/R4uXk0OXjysrSPgogICAgICAgIDwvx+D/4t.................",
"Signature": "Unsigned",
"Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
"FileName": "KO_ZVLREGKKT_7725_0278_0278199519366401001_20211129_275bc3f7ca5c40a783424ee129a8c420"
}
],
"Purpose": "InitialRegistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "NotStarted",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
"CreatedDate": "2017-03-23T10:42:50",
"UpdatedDate": "2021-10-15T10:07:58",
"Number": "0708200414",
"LegalAddress": {
"City": "г Воронеж",
"PostalCode": "394030",
"RegionCode": "36",
"Region": "Воронежская обл",
"Street": "ул Бакунина",
"HouseNumber": "1",
"FullAddress": "394030, ул Бакунина, 1"
},
"PostalAddress": {
"City": "г Воронеж",
"PostalCode": "394030",
"RegionCode": "36",
"Region": "Воронежская обл",
"Street": "ул Бакунина",
"HouseNumber": "1",
"FullAddress": "394030, ул Бакунина, 1"
},
"Inn": "0278199519",
"Ogrn": "1053600591197",
"Kpp": "366401001",
"CompanyName": "ООО \"ПРИМЕР\"",
"Signatory": {
"Name": "Ященко Юлия",
"Position": "",
"Email": "salikhov@ofd.ru",
"IsRepresent": false
},
"IsNdsPayer": false,
"ElectronicInvoicingType": "Other",
"PaymentType": "BalancePrePayment",
"PartnerCode": "MPIHEJL1",
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": true,
"LockCreatingCompanyWithOtherKpp": true
},
"StatusChangeDateUtc": "2021-11-29T16:12:49",
"CDateUtc": "2021-11-29T16:11:43",
"UDateUtc": "2021-11-29T16:12:49",
"UserAccountId": "56805d98-6a0a-4148-8a1a-f0072cf7d32f",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=4d5d5574-433d-4c3f-afd7-3b3c39595d33&format=pdf",
"CanBeAutomaticDevice": false
},
"Success": true
}
Таблица 22. Описание параметров ответа на запрос.
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| Id | Uuid | Уникальный идентификатор заявки |
| CompanyDetails | Object | Данные организации. Описание структуры параметра представлено в таблице 22.1. |
| KktDetails | Object | Сведения о кассе. Описание структуры параметра представлено в таблице 22.2. |
| AutomaticDevices | Array | Данные автоматического устройств. Описание структуры параметра представлено в таблице 22.3. |
| Object | ||
| Stage | String | Этап оформления заявки. Этап оформления заявки может принимать следующие значения: |
| - Initialization - начало оформления; | ||
| - Finalization - окончание оформления. | ||
| Status | String | Статус заявки. Статус заявки может принимать следующие значения: |
| - New - новая заявка на регистрацию/перерегистрацию; | ||
| - AwaitingDocuments - ожидание формирования документов для подписи; | ||
| - AwaitingSignature - документы сформированы, ожидают подписи; | ||
| - ProcessingSignedDocuments - проверка подписанных документов; | ||
| - ReadyToBeSentToFns - заявка готова к отправке в ФНС; | ||
| - SentToFns - заявка отправлена в ФНС; | ||
| - AwaitingAutoFinalization - ожидание завершения упрощенной перегистрации; | ||
| - Rejected - заявка отклонена; | ||
| - Approved - заявка одобрена; | ||
| - DownloadingDocuments - получения готовых документов; | ||
| - UnknownError - неизвестная ошибка. | ||
| CanDelete | Boolean | Признак разрешения удалить заявку |
| Documents | Array | Документы, сгенерированные для передачи в ФНС. Описание структуры параметра представлено в таблице 22.4. |
| Object | ||
| Purpose | String | Назначение заявки. Назначение заявки может принимать следующие значения: |
| - InitialRegistration - первичная регистрация; | ||
| - Reregistration - перерегистрация; | ||
| - Unregistration - снятие с учета. | ||
| OfdAgreementId | String | Идентификатор юридического лица, прикрепленного к ЛК OFD.ru |
| OfdAgreement | Object | Описания и условия предоставления услуг OFD.ru. Описание структуры параметра представлено в таблице 22.5. |
| StatusChangeDateUtc | Date | Дата и время смены статуса заявки |
| CDateUtc | Date | Дата и время создания заявки |
| UDateUtc | Date | Дата и время последнего изменения шаблона заявки |
| UserAccountId | String | Идентификатор ЛКК |
| DownloadUri | String | Ссылка для получения печатной формы в формате *.pdf |
| CanBeAutomaticDevice | Boolean | Признак автоматического устройства |
Таблица 22.1. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «CompanyDetails» (Данные организации)
| Параметр | Вложенный параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|---|
| Director | Object | Руководитель организации | ||
| FirstName | String | Фамилия Руководителя организации | ||
| LastName | String | Имя Руководителя организации | ||
| MiddleName | String | Отчество Руководителя организации | ||
| FnsBranchCode | String | Код филиала ФНС | ||
| CreatedDate | Date | Дата и время регистрации компании | ||
| UpdatedDate | Date | Дата и время актуализации регистрации компании | ||
| LegalAddress | Object | Адрес филиала ФНС | ||
| PostalCode | String | Почтовый индекс филиала ФНС | ||
| RegionCode | String | Код субъекта РФ | ||
| Region | String | Наименование субъекта РФ | ||
| Settlement | String | Населённый пункт | ||
| HouseNumber | String | Номер дома | ||
| Building | String | Строение | ||
| Office | String | Номер комнаты/офиса | ||
| FiasCode | Uuid | Идентификатор ФИАС | ||
| FullAddress | String | Полный адрес филиала ФНС | ||
| Inn | String | Идентификационный номер налогоплательщика | ||
| Ogrn | String | Основной государственный регистрационный номер юридического лица | ||
| Kpp | String | Код основания постановки на учет в ФНС | ||
| CompanyName | String | Наименование организации | ||
| Signatory | Object | Сведения о руководителе организации | ||
| Name | String | Имя руководителя организации | ||
| Position | String | Должность | ||
| String | Электронный адрес почты руководителя организации | |||
| Phone | String | Контактный телефон руководителя организации | ||
| IsRepresent | Boolean | Признак подписанта. | ||
| RepresentativeDetails | Object | Структура данных МЧД | ||
| Number | String | Номер МЧД | ||
| EvaluateDate | String | Дата МЧД | ||
| DocId | String | ID МЧД | ||
| IsReceiptSendingEnable | Boolean | Статус услуги ОФД | ||
| IsPaymentAgent | Boolean | Признак платежного агента | ||
| ShowEReceiptMainBanner | Boolean | Признак показа рекламного баннера в чеке при отправке по email | ||
| LockCreatingCompanyWithOtherKpp | Boolean | Блокировать создания компании с другим КПП |
Таблица 22.2. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «KktDetails» (Сведения о кассе)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| FnNumber | String | Номер фискального накопителя | |
| FnName | String | Название фискального накопителя | |
| OfdInn | String | ИНН ОФД | |
| OfdName | String | Название ОФД | |
| InstallmentAddress | Object | Адрес установки кассы | |
| PostalCode | String | Почтовый индекс адреса установки кассы | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Наименование субъекта РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Строение | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки кассы | |
| InstallmentPlace | String | Адрес места расчета | |
| UsageMode | Object | Признак расчетов по кассе | |
| Gambling | Boolean | Азартные игры: прием ставок и выплата выигрыша | |
| Lottery | Boolean | Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша | |
| Agent | Boolean | Платежный агент (субагент) | |
| AutomatedDevice | Boolean | Признак: установка принтера в автомате | |
| Internet | Boolean | Расчеты в интернете | |
| Mobile | Boolean | Развозная и (или) разносная торговля | |
| Banking | Boolean | Банковский платежный агент (субагент) | |
| ExcisableGoods | Boolean | Касса используется для реализации подакцизных товаров | |
| FormsForReports | Boolean | Оказания услуг | |
| Marking | Boolean | Касса используется для реализации товаров с обязательной маркировкой | |
| Model | String | Модель кассы | |
| SerialNumber | String | Серийный номер кассы | |
| FiscalDocumentData | Object | Данные фискального документа | |
| FnsBranchCode | String | Код филиала ФНС | |
| ClosedFnDetails | Object | Отчет о закрытии фискального накопителя | |
| InstalledFnDetails | Object | Отчет об установки фискального накопителя |
Таблица 22.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| InstallmentAddress | Object | Адрес установки кассы | |
| PostalCode | String | Почтовый индекс установки автоматического устройства | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Субъект РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Номер строения | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки автоматического устройства | |
| InstallmentPlace | String | Место расчетов автоматического устройства | |
| DeviceNumber | String | Номер автоматического устройства |
Таблица 22.4. Описание параметров. Описание параметров структуры «Documents» (Документы, сгенерированные для передачи в ФНС )
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| Id | String | Идентификатор исходящего документа |
| Kind | String | Вид исходящего документа |
| Content | String | Содержание исходящего документа формате base64 |
| Signature | String | ЭЦП документа в формате base64 |
| Description | String | Описание документа |
| FileName | String | Имя файла |
Таблица 22.5. Описание параметров. Описание параметров структуры «OfdAgreement» (Описания и условия предоставления услуг OFD.ru)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| PayPeriods | Object | Период оплаты услуг OFD.ru | |
| 1 | String | Каждый месяц | |
| 3 | String | Каждый квартал | |
| 12 | String | Каждый год | |
| State | String | Регион нахождения клиента | |
| HasUnifiedOrPatentTaxation | Boolean | Признак СНО «УСН» или «Патент» | |
| IncorrectNdsCalculationKktExist | Boolean | Признак плательщика НДС | |
| Id | String | Идентификатор юридического лица, прикрепленного к ЛК OFD.ru | |
| CreatedDate | Date | Дата создания ЛКК | |
| UpdatedDate | Date | Дата обновления данных | |
| Number | String | Номер | |
| LegalAddress | Object | Фактический адрес организации | |
| PostalCode | String | Почтовый индекс адреса установки кассы | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Наименование субъекта РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Строение | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки кассы | |
| PostalAddress | Object | Адрес для корреспонденции | |
| FullAddress | String | Полный адрес для корреспонденции | |
| Inn | String | Идентификационный номер налогоплательщика | |
| Ogrn | String | Основной государственный регистрационный номер юридического лица | |
| Kpp | String | Код основания постановки на учет в ФНС | |
| CompanyName | String | Наименование организации | |
| Signatory | Object | Сведения о руководителе организации | |
| IsNdsPayer | Boolean | Организация работает с НДС | |
| ElectronicInvoicingType | String | Тип электронного документооборота | |
| PaymentType | String | Тип осуществления расчетов | |
| ProxyTestDiveAvailable | Boolean | Служебная строка, используется в отладочных целях | |
| IsReceiptSendingEnable | Boolean | Статус услуги ОФД | |
| IsPaymentAgent | Boolean | Признак платежного агента | |
| ShowEReceiptMainBanner | Boolean | Признак показа рекламного баннера в чеке при отправке по email | |
| LockCreatingCompanyWithOtherKpp | Boolean | Блокировать создания компании с другим КПП |
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 23. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | ValidationError | Не удалось определить модель ККТ |
| Не удалось определить ЗН ККТ | ||
| Касса не зарегистрирована в ФНС |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Запрос выполняется для:
Следующий этап, передача подписанного заявления в ФНС.
Запрос выполняется методом POST с передачей параметров в JSON-структуре.
Внимание! Повторная отправка запроса не допустима.
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:uuid}/sign?AuthToken={authToken}
Заменяемые параметры:
В теле запроса передаются следующие параметры:
Рассмотрим работу запроса на примере заявки на регистрацию кассы.
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/1b21cac3-2b85-404a-b147-7f3bbd6827a5/sign?AuthToken=d191800efd1c4b0ba70ef05b95a9a582
Content-Type: application/json
{
"DocumentId": "aaf0ba41-be2f-41f8-9267-f827194d8786",
"Signature": "MIIQbQYJKoZIhvcNAQcCoIIQXjCCEFoCAQExDjAMBggqhQMHAQECAgUAMIIJWwYJKoZIhvcNAQcB oIIJTASCCUhQRDk0Yld3Z2RtVnljMmx2YmowaU1TNHdJaUJsYm1OdlpHbHVa3........"
}
Пример ответа на запрос:
{
"Data": {
"Id": "1b21cac3-2b85-404a-b147-7f3bbd6827a5",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Юлия",
"LastName": "Ященко",
"MiddleName": "Владимирович"
},
"FnsBranchCode": "0278",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "394030",
"RegionCode": "36",
"Region": "Воронежская обл",
"Settlement": "г Уфа",
"Street": "ул Бакунина",
"HouseNumber": "1",
"Building": "к 1",
"Office": "пом 16И",
"FiasCode": "8a9c23a2-75a1-46e2-9151-e77233c37d5d",
"FullAddress": "394030, г Уфа, ул Бакунина, 1, корп/стр: к 1, офис/кв: пом 16И"
},
"Inn": "0278199519",
"Ogrn": "1053600591197",
"Kpp": "366401001",
"CompanyName": "ООО \"ПРИМЕР\"",
"Signatory": {
"Name": "Ященко Юлия Владимирович",
"Position": "Управляющий - индивидуальный предприниматель",
"Email": "motorkina@ofd.ru",
"Phone": "9111111111",
"IsRepresent": false
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300787427",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867279",
"FiscalDocumentData": {},
"FnsBranchCode": "7725",
"ClosedFnDetails": {},
"InstalledFnDetails": {}
},
"AutomaticDevices": [],
"Status": "ProcessingSignedDocuments",
"Stage": "Initialization",
"CanDelete": false,
"Documents": [
{
"Id": "aaf0ba41-be2f-41f8-9267-f827194d8786",
"Kind": "1110061",
"Signature": "Signed",
"Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
"FileName": "KO_ZVLREGKKT_7725_0278_0278199519366401001_20211203_1bfc0e7c1c4f4195898b5e452ff3492e"
}
],
"Purpose": "InitialRegistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "NotStarted",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
"CreatedDate": "2017-03-23T10:42:50",
"UpdatedDate": "2021-10-15T10:07:58",
"Number": "0708200414",
"LegalAddress": {
"City": "г Воронеж",
"PostalCode": "394030",
"RegionCode": "36",
"Region": "Воронежская обл",
"Street": "ул Бакунина",
"HouseNumber": "1",
"FullAddress": "394030, ул Бакунина, 1"
},
"PostalAddress": {
"City": "г Воронеж",
"PostalCode": "394030",
"RegionCode": "36",
"Region": "Воронежская обл",
"Street": "ул Бакунина",
"HouseNumber": "1",
"FullAddress": "394030, ул Бакунина, 1"
},
"Inn": "0278199519",
"Ogrn": "1053600591197",
"Kpp": "366401001",
"CompanyName": "ООО \"ПРИМЕР\"",
"Signatory": {
"Name": "Ященко Юлия",
"Position": "",
"Email": "salikhov@ofd.ru",
"IsRepresent": false
},
"IsNdsPayer": false,
"ElectronicInvoicingType": "Other",
"PaymentType": "BalancePrePayment",
"PartnerCode": "MPIHEJL1",
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": true,
"LockCreatingCompanyWithOtherKpp": true
},
"StatusChangeDateUtc": "2021-12-03T10:02:58",
"CDateUtc": "2021-12-03T09:59:03",
"UDateUtc": "2021-12-03T10:02:58",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=1b21cac3-2b85-404a-b147-7f3bbd6827a5&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Таблица 24. Описание параметров ответа на запрос.
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| Id | Uuid | Уникальный идентификатор заявки |
| CompanyDetails | Object | Данные организации. Описание структуры параметра представлено в таблице 24.1. |
| KktDetails | Object | Сведения о кассе. Описание структуры параметра представлено в таблице 24.2. |
| AutomaticDevices | Array | Данные автоматического устройств. Описание структуры параметра представлено в таблице 24.3. |
| Object | ||
| Stage | String | Этап оформления заявки. Этап оформления заявки может принимать следующие значения: |
| - Initialization - начало оформления; | ||
| - Finalization - окончание оформления. | ||
| Status | String | Статус заявки. Статус заявки может принимать следующие значения: |
| - New - новая заявка на регистрацию/перерегистрацию; | ||
| - AwaitingDocuments - ожидание формирования документов для подписи; | ||
| - AwaitingSignature - документы сформированы, ожидают подписи; | ||
| - ProcessingSignedDocuments - проверка подписанных документов; | ||
| - ReadyToBeSentToFns - заявка готова к отправке в ФНС; | ||
| - SentToFns - заявка отправлена в ФНС; | ||
| - AwaitingAutoFinalization - ожидание завершения упрощенной перегистрации; | ||
| - Rejected - заявка отклонена; | ||
| - Approved - заявка одобрена; | ||
| - DownloadingDocuments - получения готовых документов; | ||
| - UnknownError - неизвестная ошибка. | ||
| CanDelete | Boolean | Признак разрешения удалить заявку |
| Documents | Array | Документы, сгенерированные для передачи в ФНС. Описание структуры параметра представлено в таблице 24.4. |
| Object | ||
| Purpose | String | Назначение заявки. Назначение заявки может принимать следующие значения: |
| - InitialRegistration - первичная регистрация; | ||
| - Reregistration - перерегистрация; | ||
| - Unregistration - снятие с учета. | ||
| OfdAgreementId | String | Идентификатор юридического лица, прикрепленного к ЛК OFD.ru |
| OfdAgreement | Object | Описания и условия предоставления услуг OFD.ru. Описание структуры параметра представлено в таблице 24.5. |
| StatusChangeDateUtc | Date | Дата и время смены статуса заявки |
| CDateUtc | Date | Дата и время создания заявки |
| UDateUtc | Date | Дата и время последнего изменения шаблона заявки |
| UserAccountId | String | Идентификатор ЛКК |
| DownloadUri | String | Ссылка для получения печатной формы в формате *.pdf |
| CanBeAutomaticDevice | Boolean | Признак автоматического устройства |
Таблица 24.1. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «CompanyDetails» (Данные организации)
| Параметр | Вложенный параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|---|
| CompanyType | String | Тип организации имеет следующие значения: | ||
| - LegalEntity - Юридическое лицо; | ||||
| - PrivateEntrepreneur - Индивидуальный предприниматель. | ||||
| Director | Object | Руководитель организации | ||
| FirstName | String | Фамилия Руководителя организации | ||
| LastName | String | Имя Руководителя организации | ||
| MiddleName | String | Отчество Руководителя организации | ||
| FnsBranchCode | String | Код филиала ФНС | ||
| LegalAddress | Object | Адрес филиала ФНС | ||
| PostalCode | String | Почтовый индекс филиала ФНС | ||
| RegionCode | String | Код субъекта РФ | ||
| Region | String | Наименование субъекта РФ | ||
| Settlement | String | Населённый пункт | ||
| HouseNumber | String | Номер дома | ||
| Building | String | Строение | ||
| Office | String | Номер комнаты/офиса | ||
| FiasCode | Uuid | Код ФИАС | ||
| FullAddress | String | Полный адрес филиала ФНС | ||
| Inn | String | Идентификационный номер налогоплательщика | ||
| Ogrn | String | Основной государственный регистрационный номер юридического лица | ||
| Kpp | String | Код основания постановки на учет в ФНС | ||
| CompanyName | String | Наименование организации | ||
| TaxationType | Object | Тип налогообложения | ||
| Common | 0 | String | Общая | |
| SimpleIn | 1 | String | Упрощённая Доход (УСН(Д)) | |
| SimpleInOut | 2 | String | Упрощённая Доход минус Расход (УСН(Д-Р)) | |
| Unified | 3 | String | Единый налог на вмененный доход (ЕНВД) | |
| UnifiedAgricultural | 4 | String | Единый сельскохозяйственный налог (ЕСХН) | |
| Patent | 5 | String | Патентная система налогообложения (ПСН) | |
| Unknown | 6 | String | Не определено | |
| AutomatedSimpleIn | 7 | String | Автоматизированная упрощённая Доход (АУСН(Д)) | |
| AutomatedSimpleInOut | 8 | String | Автоматизированная упрощённая Доход минус Расход (АУСН(Д-Р)) | |
| Signatory | Object | Сведения о подписанте | ||
| Name | String | Имя подписанта | ||
| Position | String | Должность | ||
| String | Электронный адрес почты подписанта | |||
| Phone | String | Контактный телефон подписанта | ||
| RepresentativeDetails | Object | Структура данных машинно-читаемой доверенности (далее - МЧД) | ||
| Number | String | Номер МЧД | ||
| EvaluateDate | String | Дата МЧД | ||
| DocId | String | ID МЧД |
Таблица 24.2. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «KktDetails» (Сведения о кассе)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| FnNumber | String | Номер фискального накопителя | |
| FnName | String | Название фискального накопителя | |
| OfdInn | String | ИНН ОФД | |
| OfdName | String | Название ОФД | |
| InstallmentAddress | Object | Адрес установки кассы | |
| PostalCode | String | Почтовый индекс адреса установки кассы | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Наименование субъекта РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Строение | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки кассы | |
| InstallmentPlace | String | Адрес места расчета | |
| UsageMode | Object | Признак расчетов по кассе | |
| Gambling | Boolean | Азартные игры: прием ставок и выплата выигрыша | |
| Lottery | Boolean | Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша | |
| Agent | Boolean | Платежный агент (субагент) | |
| AutomatedDevice | Boolean | Признак: установка принтера в автомате | |
| Internet | Boolean | Расчеты в интернете | |
| Mobile | Boolean | Развозная и (или) разносная торговля | |
| Banking | Boolean | Банковский платежный агент (субагент) | |
| ExcisableGoods | Boolean | Касса используется для реализации подакцизных товаров | |
| FormsForReports | Boolean | Оказания услуг | |
| Marking | Boolean | Касса используется для реализации товаров с обязательной маркировкой | |
| Model | String | Модель кассы | |
| SerialNumber | String | Серийный номер кассы | |
| FiscalDocumentData | Object | Данные фискального документа | |
| FnsBranchCode | String | Код филиала ФНС | |
| ClosedFnDetails | Object | Отчет о закрытии фискального накопителя | |
| InstalledFnDetails | Object | Отчет об установки фискального накопителя |
Таблица 24.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| InstallmentAddress | Object | Адрес установки кассы | |
| PostalCode | String | Почтовый индекс установки автоматического устройства | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Субъект РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Номер строения | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки автоматического устройства | |
| InstallmentPlace | String | Место расчетов автоматического устройства | |
| DeviceNumber | String | Номер автоматического устройства |
Таблица 24.4. Описание параметров. Описание параметров структуры «Documents» (Документы, сгенерированные для передачи в ФНС )
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| Id | String | Идентификатор исходящего документа |
| Kind | String | Вид исходящего документа |
| Content | String | Содержание исходящего документа формате base64 |
| Signature | String | ЭЦП документа в формате base64 |
| Description | String | Описание документа |
| FileName | String | Имя файла |
Таблица 24.5. Описание параметров. Описание параметров структуры «OfdAgreement» (Описания и условия предоставления услуг OFD.ru)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| PayPeriods | Object | Период оплаты услуг OFD.ru | |
| 1 | String | Каждый месяц | |
| 3 | String | Каждый квартал | |
| 12 | String | Каждый год | |
| State | String | Регион нахождения клиента | |
| HasUnifiedOrPatentTaxation | Boolean | Признак СНО «УСН» или «Патент» | |
| IncorrectNdsCalculationKktExist | Boolean | Признак плательщика НДС | |
| Id | String | Идентификатор юридического лица, прикрепленного к ЛК OFD.ru | |
| CreatedDate | Date | Дата создания ЛКК | |
| UpdatedDate | Date | Дата обновления данных | |
| Number | String | Номер | |
| LegalAddress | Object | Фактический адрес организации | |
| PostalCode | String | Почтовый индекс адреса установки кассы | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Наименование субъекта РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Строение | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки кассы | |
| PostalAddress | Object | Адрес для корреспонденции | |
| FullAddress | String | Полный адрес для корреспонденции | |
| Inn | String | Идентификационный номер налогоплательщика | |
| Ogrn | String | Основной государственный регистрационный номер юридического лица | |
| Kpp | String | Код основания постановки на учет в ФНС | |
| CompanyName | String | Наименование организации | |
| Signatory | Object | Сведения о руководителе организации | |
| IsNdsPayer | Boolean | Организация работает с НДС | |
| ElectronicInvoicingType | String | Тип электронного документооборота | |
| PaymentType | String | Тип осуществления расчетов | |
| ProxyTestDiveAvailable | Boolean | Служебная строка, используется в отладочных целях | |
| IsReceiptSendingEnable | Boolean | Статус услуги ОФД | |
| IsPaymentAgent | Boolean | Признак платежного агента | |
| ShowEReceiptMainBanner | Boolean | Признак показа рекламного баннера в чеке при отправке по email | |
| LockCreatingCompanyWithOtherKpp | Boolean | Блокировать создания компании с другим КПП |
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 25. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | ValidationError | Заявка не найдена |
| Файл не найден | ||
| Не удалось проверить КЭП | ||
| Некорректный статус заявки | ||
| 500 | InternalError | Ошибка на сервере |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Запрос выполняется для получения статус и ответа от ФНС для:
После выполнения запроса передачи в ФНС подписанного заявления, необходимо получить ответ от ФНС.
В зависимости от заявки, карточка с ответом от ФНС может иметь следующие ответы:
Запрос проверки статуса заявки позволяет получить ссылку на сформированный и подписанный документ с ответом от ФНС.
Запрос выполняется методом GET.
GET https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:uuid}?AuthToken={authToken:string}
Заменяемые параметры:
Рассмотрим работу запрос на примере заявления на регистрацию кассы.
Пример запроса:
GET https://ofd.ru/api/integration/v2/b2b/kkt/registration/1b21cac3-2b85-404a-b147-7f3bbd6827a5?AuthToken=d191800efd1c4b0ba70ef05b95a9a582
Пример ответа на запрос статуса заявки, со описанием отказа ФНС принять заявку на регистрацию кассы:
{
"Data": {
"Id": "1b21cac3-2b85-404a-b147-7f3bbd6827a5",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Юлия",
"LastName": "Ященко",
"MiddleName": "Владимирович"
},
"FnsBranchCode": "0278",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "394030",
"RegionCode": "36",
"Region": "Воронежская обл",
"Settlement": "г Уфа",
"Street": "ул Бакунина",
"HouseNumber": "1",
"Building": "к 1",
"Office": "пом 16И",
"FiasCode": "8a9c23a2-75a1-46e2-9151-e77233c37d5d",
"FullAddress": "394030, г Уфа, ул Бакунина, 1, корп/стр: к 1, офис/кв: пом 16И"
},
"Inn": "0278199519",
"Ogrn": "1053600591197",
"Kpp": "366401001",
"CompanyName": "ООО \"ПРИМЕР\"",
"Signatory": {
"Name": "Ященко Юлия Владимирович",
"Position": "Управляющий - индивидуальный предприниматель",
"Email": "motorkina@ofd.ru",
"Phone": "9111111111",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300787427",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867279",
"FiscalDocumentData": {},
"FnsBranchCode": "7725",
"ClosedFnDetails": {},
"InstalledFnDetails": {}
},
"AutomaticDevices": [],
"Status": "Rejected",
"Stage": "Initialization",
"CanDelete": false,
"Documents": [],
"Purpose": "InitialRegistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "NotStarted",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
"CreatedDate": "2017-03-23T10:42:50",
"UpdatedDate": "2021-10-15T10:07:58",
"Number": "0708200414",
"LegalAddress": {
"City": "г Воронеж",
"PostalCode": "394030",
"RegionCode": "36",
"Region": "Воронежская обл",
"Street": "ул Бакунина",
"HouseNumber": "1",
"FullAddress": "394030, ул Бакунина, 1"
},
"PostalAddress": {
"City": "г Воронеж",
"PostalCode": "394030",
"RegionCode": "36",
"Region": "Воронежская обл",
"Street": "ул Бакунина",
"HouseNumber": "1",
"FullAddress": "394030, ул Бакунина, 1"
},
"Inn": "0278199519",
"Ogrn": "1053600591197",
"Kpp": "366401001",
"CompanyName": "ООО \"ПРИМЕР\"",
"Signatory": {
"Name": "Ященко Юлия",
"Position": "",
"Email": "salikhov@ofd.ru",
"IsRepresent": false
},
"IsNdsPayer": false,
"ElectronicInvoicingType": "Other",
"PaymentType": "BalancePrePayment",
"PartnerCode": "MPIHEJL1",
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": true,
"LockCreatingCompanyWithOtherKpp": true
},
"StatusReason": "Ошибка проверки ЮЛ/ИП с данными {inn=0278199519, ogrn=1053600591197}: Заявитель не идентифицирован. Просьба обратиться в Службу Технической Поддержки ФНС России или ближайший ТНО.",
"StatusChangeDateUtc": "2021-12-03T10:05:02",
"CDateUtc": "2021-12-03T09:59:03",
"UDateUtc": "2021-12-03T10:05:02",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"ResultDocs": [],
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=1b21cac3-2b85-404a-b147-7f3bbd6827a5&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Пример ответа на запрос статуса заявки, со ссылкой на документ с ответом от ФНС о присвоении РНМ:
{
"Data": {
"Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300784224"
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867358",
"FiscalDocumentData": {},
"RegNumber": "0000002950038403",
"FnsBranchCode": "7725",
"ClosedFnDetails": {},
"InstalledFnDetails": {},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "New",
"Stage": "Finalization",
"CanDelete": false,
"Documents": [
{
"Id": "5de805db-d44b-4f7b-af93-1ff4028125d4",
"Kind": "1110061",
"Signature": "Signed",
"Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
"FileName": "KO_ZVLREGKKT_7725_5252_5252012620525201001_20211216_35fd55f7006140bfba42c1139372ce5f"
}
],
"Purpose": "InitialRegistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-16T09:20:14",
"CDateUtc": "2021-12-16T09:02:14",
"UDateUtc": "2021-12-16T09:20:14",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"ResultDocs": [
{
"KktId": 16840,
"ReportTypeId": 50,
"DocType": "RnmReport",
"ConversationUuid": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
"ReportSizeInBytes": 114984,
"FileType": "application/pdf",
"DownloadUri": "https://dev.ofd.ru/api/kkt/application/doc/81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c/16840/50"
}
],
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Таблица 26. Описание параметров ответа на запрос.
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| Id | Uuid | Уникальный идентификатор заявки |
| CompanyDetails | Object | Данные организации. Описание структуры параметра представлено в таблице 26.1. |
| KktDetails | Object | Сведения о кассе. Описание структуры параметра представлено в таблице 26.2. |
| AutomaticDevices | Array (Структура) | Данные автоматического устройств. Описание структуры параметра представлено в таблице 26.3. |
| Stage | String | Этап оформления заявки. Этап оформления заявки может принимать следующие значения: |
| - Initialization - начало оформления; | ||
| - Finalization - окончание оформления. | ||
| Status | String | Статус заявки. Статус заявки может принимать следующие значения: |
| - New - новая заявка на регистрацию/перерегистрацию; | ||
| - AwaitingDocuments - ожидание формирования документов для подписи; | ||
| - AwaitingSignature - документы сформированы, ожидают подписи; | ||
| - ProcessingSignedDocuments - проверка подписанных документов; | ||
| - ReadyToBeSentToFns - заявка готова к отправке в ФНС; | ||
| - SentToFns - заявка отправлена в ФНС; | ||
| - AwaitingAutoFinalization - ожидание завершения упрощенной перегистрации; | ||
| - Rejected - заявка отклонена; | ||
| - Approved - заявка одобрена; | ||
| - DownloadingDocuments - получения готовых документов; | ||
| - UnknownError - неизвестная ошибка. | ||
| CanDelete | Boolean | Признак разрешения удалить заявку |
| Documents | Array | Документы, сгенерированные для передачи в ФНС. Описание структуры параметра представлено в таблице 26.4. \\ |
| Object | ||
| Purpose | String | Назначение заявки. Назначение заявки может принимать следующие значения: |
| - InitialRegistration - первичная регистрация; | ||
| - Reregistration - перерегистрация; | ||
| - Unregistration - снятие с учета. | ||
| OfdAgreementId | String | Идентификатор юридического лица, прикрепленного к ЛК OFD.ru |
| OfdAgreement | Object | Описания и условия предоставления услуг OFD.ru. Описание структуры параметра представлено в таблице 26.5. |
| StatusReason | String | Описание причины отказа ФНС в заявки |
| KktAgreementId | String | Присвоенный РНМ |
| StatusChangeDateUtc | Date | Дата и время смены статуса заявки |
| CDateUtc | Date | Дата и время создания заявки |
| UDateUtc | Date | Дата и время последнего изменения шаблона заявки |
| UserAccountId | String | Идентификатор ЛКК |
| ResultDocs | Array | Ответ от ФНС результатом о присвоении РНМ |
| Object | ||
| DownloadUri | String | Ссылка для получения печатной формы в формате *.pdf |
| CanBeAutomaticDevice | Boolean | Признак автоматического устройства |
Таблица 26.1. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «CompanyDetails» (Данные организации)
| Параметр | Вложенный параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|---|
| CompanyType | String | Тип организации имеет следующие значения: | ||
| - LegalEntity - Юридическое лицо; | ||||
| - PrivateEntrepreneur - Индивидуальный предприниматель. | ||||
| Director | Object | Руководитель организации | ||
| FirstName | String | Фамилия Руководителя организации | ||
| LastName | String | Имя Руководителя организации | ||
| MiddleName | String | Отчество Руководителя организации | ||
| FnsBranchCode | String | Код филиала ФНС | ||
| LegalAddress | Object | Адрес филиала ФНС | ||
| PostalCode | String | Почтовый индекс филиала ФНС | ||
| RegionCode | String | Код субъекта РФ | ||
| Region | String | Наименование субъекта РФ | ||
| Settlement | String | Населённый пункт | ||
| HouseNumber | String | Номер дома | ||
| Building | String | Строение | ||
| Office | String | Номер комнаты/офиса | ||
| FiasCode | Uuid | Код ФИАС | ||
| FullAddress | String | Полный адрес филиала ФНС | ||
| Inn | String | Идентификационный номер налогоплательщика | ||
| Ogrn | String | Основной государственный регистрационный номер юридического лица | ||
| Kpp | String | Код основания постановки на учет в ФНС | ||
| CompanyName | String | Наименование организации | ||
| TaxationType | Object | Тип налогообложения | ||
| Common | 0 | String | Общая | |
| SimpleIn | 1 | String | Упрощённая Доход (УСН(Д)) | |
| SimpleInOut | 2 | String | Упрощённая Доход минус Расход (УСН(Д-Р)) | |
| Unified | 3 | String | Единый налог на вмененный доход (ЕНВД) | |
| UnifiedAgricultural | 4 | String | Единый сельскохозяйственный налог (ЕСХН) | |
| Patent | 5 | String | Патентная система налогообложения (ПСН) | |
| Unknown | 6 | String | Не определено | |
| AutomatedSimpleIn | 7 | String | Автоматизированная упрощённая Доход (АУСН(Д)) | |
| AutomatedSimpleInOut | 8 | String | Автоматизированная упрощённая Доход минус Расход (АУСН(Д-Р)) | |
| Signatory | Object | Сведения о подписанте | ||
| Name | String | Имя подписанта | ||
| Position | String | Должность | ||
| String | Электронный адрес почты подписанта | |||
| Phone | String | Контактный телефон подписанта | ||
| RepresentativeDetails | Object | Структура данных машинно-читаемой доверенности (далее - МЧД) | ||
| Number | String | Номер МЧД | ||
| EvaluateDate | String | Дата МЧД | ||
| DocId | String | ID МЧД |
Таблица 26.2. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «KktDetails» (Сведения о кассе)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| FnNumber | String | Номер фискального накопителя | |
| FnName | String | Название фискального накопителя | |
| OfdInn | String | ИНН ОФД | |
| OfdName | String | Название ОФД | |
| InstallmentAddress | Object | Адрес установки кассы | |
| PostalCode | String | Почтовый индекс адреса установки кассы | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Наименование субъекта РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Строение | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки кассы | |
| InstallmentPlace | String | Адрес места расчета | |
| UsageMode | Object | Признак расчетов по кассе | |
| Gambling | Boolean | Азартные игры: прием ставок и выплата выигрыша | |
| Lottery | Boolean | Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша | |
| Agent | Boolean | Платежный агент (субагент) | |
| AutomatedDevice | Boolean | Признак: установка принтера в автомате | |
| Internet | Boolean | Расчеты в интернете | |
| Mobile | Boolean | Развозная и (или) разносная торговля | |
| Banking | Boolean | Банковский платежный агент (субагент) | |
| ExcisableGoods | Boolean | Касса используется для реализации подакцизных товаров | |
| FormsForReports | Boolean | Оказания услуг | |
| Marking | Boolean | Касса используется для реализации товаров с обязательной маркировкой | |
| Model | String | Модель кассы | |
| SerialNumber | String | Серийный номер кассы | |
| FiscalDocumentData | Object | Данные фискального документа | |
| FnsBranchCode | String | Код филиала ФНС | |
| ClosedFnDetails | Object | Отчет о закрытии фискального накопителя | |
| InstalledFnDetails | Object | Отчет об установки фискального накопителя |
Таблица 26.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)
| Параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|
| InstallmentAddress | Object | Адрес установки кассы | |
| PostalCode | String | Почтовый индекс установки автоматического устройства | |
| RegionCode | String | Код субъекта РФ | |
| Region | String | Субъект РФ | |
| Settlement | String | Населённый пункт | |
| HouseNumber | String | Номер дома | |
| Building | String | Номер строения | |
| Office | String | Номер комнаты/офиса | |
| FiasCode | Uuid | Код ФИАС | |
| FullAddress | String | Полный адрес установки автоматического устройства | |
| InstallmentPlace | String | Место расчетов автоматического устройства | |
| DeviceNumber | String | Номер автоматического устройства |
Таблица 26.4. Описание параметров. Описание параметров структуры «Documents» (Документы, сгенерированные для передачи в ФНС )
| Параметр | Формат значения | Описание параметра |
|---|---|---|
| Id | String | Идентификатор исходящего документа |
| Kind | String | Вид исходящего документа |
| Content | String | Содержание исходящего документа формате base64 |
| Signature | String | ЭЦП документа в формате base64 |
| Description | String | Описание документа |
| FileName | String | Имя файла |
Таблица 26.5. Описание параметров. Описание параметров структуры «OfdAgreement» (Описания и условия предоставления услуг OFD.ru)
| Параметр | Вложенный параметр | Вложенный параметр | Формат значения | Описание параметра |
|---|---|---|---|---|
| PayPeriods | Object | Период оплаты услуг OFD.ru | ||
| 1 | String | Каждый месяц | ||
| 3 | String | Каждый квартал | ||
| 12 | String | Каждый год | ||
| State | String | Регион нахождения клиента | ||
| HasUnifiedOrPatentTaxation | Boolean | Признак СНО «УСН» или «Патент» | ||
| IncorrectNdsCalculationKktExist | Boolean | Признак плательщика НДС | ||
| Id | String | Идентификатор юридического лица, прикрепленного к ЛК OFD.ru | ||
| CreatedDate | Date | Дата создания ЛКК | ||
| UpdatedDate | Date | Дата обновления данных | ||
| Number | String | |||
| LegalAddress | Object | Фактический адрес организации | ||
| PostalCode | String | Почтовый индекс адреса установки кассы | ||
| RegionCode | String | Код субъекта РФ | ||
| Region | String | Наименование субъекта РФ | ||
| Settlement | String | Населённый пункт | ||
| HouseNumber | String | Номер дома | ||
| Building | String | Строение | ||
| Office | String | Номер комнаты/офиса | ||
| FiasCode | Uuid | Код ФИАС | ||
| FullAddress | String | Полный адрес установки кассы | ||
| PostalAddress | Object | Адрес для корреспонденции | ||
| FullAddress | String | Полный адрес для корреспонденции | ||
| Inn | String | Идентификационный номер налогоплательщика | ||
| Ogrn | String | Основной государственный регистрационный номер юридического лица | ||
| Kpp | String | Код основания постановки на учет в ФНС | ||
| CompanyName | String | Наименование организации | ||
| Signatory | Object | Сведения о руководителе организации | ||
| Name | String | Имя руководителя организации | ||
| Position | String | Должность | ||
| String | Электронный адрес почты руководителя организации | |||
| Phone | String | Контактный телефон руководителя организации | ||
| IsRepresent | Boolean | Признак подписанта. | ||
| RepresentativeDetails | Object | Структура данных МЧД | ||
| Number | String | Номер МЧД | ||
| EvaluateDate | String | Дата МЧД | ||
| DocId | String | ID МЧД | ||
| IsNdsPayer | Boolean | Организация работает с НДС | ||
| ElectronicInvoicingType | String | Тип электронного документооборота | ||
| PaymentType | String | Тип осуществления расчетов | ||
| ProxyTestDiveAvailable | Boolean | Служебная строка, используется в отладочных целях | ||
| IsReceiptSendingEnable | Boolean | Статус услуги ОФД | ||
| IsPaymentAgent | Boolean | Признак платежного агента | ||
| ShowEReceiptMainBanner | Boolean | Признак показа рекламного баннера в чеке при отправке по email | ||
| LockCreatingCompanyWithOtherKpp | Boolean | Блокировать создания компании с другим КПП |
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Метод возвращает только общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
После получения ответа от ФНС о присвоении РНМ, для завершения регистрации кассы требуется выполнить следующие действия:
Чтобы внести в заявку данные из отчета о регистрации необходимо воспользоваться запросом передача данных отчета о регистрации методом PUT.
Данные отчета передаются в формате JSON.
PUT https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:uuid}?AuthToken={authToken}
Заменяемые параметры:
Параметры запроса для передачи отчета о регистрации.
В параметре FiscalDocumentData передается структура со следующими параметрами:
Пример запроса:
PUT https://ofd.ru/api/integration/v2/b2b/kkt/registration/4121f0e0-f468-48fc-9387-b6a2d5646bc5?AuthToken=8dd69254b0444a1cbd103f80012cf1bb6
Content-Type: application/json
{
"KktDetails":
{
"FiscalDocumentData": {
"DateTime": "2021-12-09T00:00:00",
"DocumentNumber": "1",
"Signature": "12345"
}
}
}
Пример ответа на запрос:
{
"Data": {
"Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300784224",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867358",
"FiscalDocumentData": {
"DateTime": "2021-12-16T00:00:00",
"DocumentNumber": "1",
"Signature": "12345"
},
"RegNumber": "0000002950038403",
"FnsBranchCode": "7725",
"ClosedFnDetails": {},
"InstalledFnDetails": {},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "New",
"Stage": "Finalization",
"CanDelete": false,
"Documents": [],
"Purpose": "InitialRegistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-16T09:20:14",
"CDateUtc": "2021-12-16T09:02:14",
"UDateUtc": "2021-12-16T09:27:37",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа на запрос представлен в таблице 15 в разделе "7.1. Описание запроса на создание заявки"
Подготовка отчета для подписи выполняется запросом описанным в разделе "7.3. Описание запроса на подготовку заявки для подписи".
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/4121f0e0-f468-48fc-9387-b6a2d5646bc5/prepareDocuments?AuthToken=8dd69254b0444a1cbd103f80012cf1bb6
Content-Type: application/json
{
"GivenName": "Алла Романовна",
"LastName": "Романова",
"Position": "ТестДолжность"
}
Пример ответа на запрос:
{
"Data": {
"Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300784224",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867358",
"FiscalDocumentData": {
"DateTime": "2021-12-16T00:00:00",
"DocumentNumber": "1",
"Signature": "12345"
},
"RegNumber": "0000002950038403",
"FnsBranchCode": "7725",
"ClosedFnDetails": {},
"InstalledFnDetails": {},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "AwaitingSignature",
"Stage": "Finalization",
"CanDelete": false,
"Documents": [
{
"Id": "0cf2502a-a03b-4431-a73b-eec10c15bda1",
"Kind": "1110061",
"Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIiBzdGFuZGFsb25lPSJ5ZXMiPz4KPNTg6esgyOTU4OnrPSJLT19PVENIUkVHS0t........",
"Signature": "Unsigned",
"Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
"FileName": "KO_OTCHREGKKT_7725_5252_5252012620525201001_20211216_5636afc3345847b68cd5bde3f3408af8"
}
],
"Purpose": "InitialRegistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-16T09:27:52",
"CDateUtc": "2021-12-16T09:02:14",
"UDateUtc": "2021-12-16T09:27:52",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа приведены в таблице 22 в разделе "7.3. Описание запроса на подготовку заявки для подписи".
Чтобы подписать и отправить в ФНС данные из отчета о регистрации, необходимо воспользоваться запросом описанным в разделе 5.4. Описание выполнения запроса на передачу в ФНС подписанной заявки.
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/1b21cac3-2b85-404a-b147-7f3bbd6827a5/sign?AuthToken=d191800efd1c4b0ba70ef05b95a9a582
Content-Type: application/json
{
"DocumentId": "0cf2502a-a03b-4431-a73b-eec10c15bda1",
"Signature": "MIAGCSqGSIb3DQEHAqCAMIACAQExDjAMBggqhQMHAQECAwUAMIAGCSqGSIb3DQEHAQAAoIIJOTCCCTUwggjioAMCAQICEQPjTaYArK2tpkENF6N6aVknMAoGC........"
}
Пример ответа:
{
"Data": {
"Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300784224",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867358",
"FiscalDocumentData": {
"DateTime": "2021-12-16T00:00:00",
"DocumentNumber": "1",
"Signature": "12345"
},
"RegNumber": "0000002950038403",
"FnsBranchCode": "7725",
"ClosedFnDetails": {},
"InstalledFnDetails": {},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "ProcessingSignedDocuments",
"Stage": "Finalization",
"CanDelete": false,
"Documents": [
{
"Id": "0cf2502a-a03b-4431-a73b-eec10c15bda1",
"Kind": "1110061",
"Signature": "Signed",
"Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
"FileName": "KO_OTCHREGKKT_7725_5252_5252012620525201001_20211216_5636afc3345847b68cd5bde3f3408af8"
}
],
"Purpose": "InitialRegistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-16T09:39:45",
"CDateUtc": "2021-12-16T09:02:14",
"UDateUtc": "2021-12-16T09:39:45",
"UserAccountId": "2ec4e129-965c-40bf-a499-9081513205a6",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа представлено в таблице 24 в разделе 7.4. Описание выполнения запроса на передачу в ФНС подписанной заявки.
Чтобы получить ответ от ФНС о статусе заявки вам нужно воспользоваться запросом описанным в разделе "7.5. Описание запроса проверки статуса заявки"
Пример запроса:
GET https://ofd.ru/api/integration/v2/b2b/kkt/registration/81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c?AuthToken=d191800efd1c4b0ba70ef05b95a9a582
Пример ответа:
{
"Data": {
"Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300784224",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867358",
"FiscalDocumentData": {
"DateTime": "2021-12-16T00:00:00",
"DocumentNumber": "1",
"Signature": "12345"
},
"RegNumber": "0000002950038403",
"FnsBranchCode": "7725",
"ClosedFnDetails": {},
"InstalledFnDetails": {},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "SentToFns",
"Stage": "Finalization",
"CanDelete": false,
"Documents": [],
"Purpose": "InitialRegistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-16T09:40:19",
"CDateUtc": "2021-12-16T09:02:14",
"UDateUtc": "2021-12-16T09:40:19",
"UserAccountId": "2ec4e129-965c-40bf-a499-9081513205a6",
"ResultDocs": [
{
"KktId": 16840,
"ReportTypeId": 100,
"DocType": "RegReport",
"ConversationUuid": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
"ReportSizeInBytes": 125002,
"FileType": "application/pdf",
"DownloadUri": "https://dev.ofd.ru/api/kkt/application/doc/81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c/16840/100"
},
{
"KktId": 16840,
"ReportTypeId": 50,
"DocType": "RnmReport",
"ConversationUuid": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
"ReportSizeInBytes": 114984,
"FileType": "application/pdf",
"DownloadUri": "https://dev.ofd.ru/api/kkt/application/doc/81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c/16840/50"
}
],
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа представлено в таблице 26 в разделе 5.5. Описание запроса проверки статуса заявки
В разделе описан процесс последовательности действий для заявки на перерегистрацию кассы в ФНС.
Заявку на перерегистрацию создают в следующих случаях:
Последовательность выполнения запросов на перерегистрацию кассы:
Создание заявки на перерегистрацию кассы выполняется запросом описанным в разделе 7.1. Описание запроса на создание заявки.
Пример запроса создания заявки на перерегистрации кассы по причине замены ФН:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration?AuthToken=ecca6a6949e848089bbecc8a97951734
Content-Type: application/json
{
"Purpose": "Reregistration",
"CompanyDetails":
{
"Inn":"5252012620",
"Kpp":"525201001"
},
"KktDetails":
{
"SerialNumber": "00307404867291",
"RegNumber": "0000002928049035",
"FnNumber": "9287440300787014",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"Model": "ЭВОТОР СТ2Ф",
"InstallmentAddress":
{
"FullAddress": "Москва, Ленинская Слобода, 19"
},
"InstallmentPlace": "Магазин №1",
"FormatVersion": 3,
"ReregistrationReasons": {
"FnChanged": true
},
"ClosedFnDetails": {
"FdDateTime": "2021-12-16T13:55:55",
"FdNumber": "12345",
"FpValue": "12345"
},
"InstalledFnDetails": {
"FdDateTime": "2021-12-16T17:14:00",
"FdNumber": "1",
"FpValue": "12345"
},
"UsageMode":
{
"Internet": false,
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false
}
}
}
Пример ответа
{
"Data": {
"Id": "c76b003e-36de-4db6-af87-ad91e67ba042",
"CompanyDetails": {
"Director": {},
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"FullAddress": ""
},
"Inn": "5252012620",
"Kpp": "525201001",
"Signatory": {
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300787014",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"FullAddress": "Москва, Ленинская Слобода, 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867291",
"FiscalDocumentData": {},
"RegNumber": "0000002928049035",
"ReregistrationReasons": {
"AutomatedDeviceChanged": false,
"FnChanged": true,
"InstallmentPlaceChanged": false,
"OfdChaged": false,
"Other": false,
"SwitchedFromOfflineToOnlineMode": false,
"SwitchedFromOnlineToOfflineMode": false,
"UserChanged": false
},
"ClosedFnDetails": {
"FdDateTime": "2021-12-16T13:55:55",
"FdNumber": "12345",
"FpValue": "12345"
},
"InstalledFnDetails": {
"FdDateTime": "2021-12-16T17:14:00",
"FdNumber": "1",
"FpValue": "12345"
},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "New",
"Stage": "Initialization",
"CanDelete": true,
"FiscalDocuments": [],
"Documents": [],
"Purpose": "Reregistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-22T12:16:01",
"CDateUtc": "2021-12-22T12:16:01",
"UDateUtc": "2021-12-22T12:16:03",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа представлено в таблице 15 в разделе 7.1. Описание запроса на создание заявки
Подготовка заявки на перерегистрацию кассы для подписи выполняется запросом описанным в разделе 7.3. Описание запроса на подготовку заявки для подписи.
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/c76b003e-36de-4db6-af87-ad91e67ba042/prepareDocuments?AuthToken=ecca6a6949e848089bbecc8a97951734
Content-Type: application/json
{
"GivenName": "Алла Романовна",
"LastName": "Романова",
"Position": "ТестДолжность"
}
Пример ответа:
{
"Data": {
"Id": "c76b003e-36de-4db6-af87-ad91e67ba042",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300787014",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867291",
"FiscalDocumentData": {},
"RegNumber": "0000002928049035",
"FnsBranchCode": "7725",
"ReregistrationReasons": {
"AutomatedDeviceChanged": false,
"FnChanged": true,
"InstallmentPlaceChanged": false,
"OfdChaged": false,
"Other": false,
"SwitchedFromOfflineToOnlineMode": false,
"SwitchedFromOnlineToOfflineMode": false,
"UserChanged": false
},
"ClosedFnDetails": {
"FdDateTime": "2021-12-16T13:55:55",
"FdNumber": "12345",
"FpValue": "12345"
},
"InstalledFnDetails": {
"FdDateTime": "2021-12-16T17:14:00",
"FdNumber": "1",
"FpValue": "12345"
},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "AwaitingSignature",
"Stage": "Initialization",
"CanDelete": false,
"Documents": [
{
"Id": "012fad42-0e31-4c10-8a9f-098709374c91",
"Kind": "1110061",
"Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0.......................",
"Signature": "Unsigned",
"Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
"FileName": "KO_ZVLREGKKT_7725_5252_5252012620525201001_20211222_d44dd8f5e75b44c286d4045361b0a741"
}
],
"Purpose": "Reregistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-22T12:18:10",
"CDateUtc": "2021-12-22T12:16:01",
"UDateUtc": "2021-12-22T12:18:10",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа приведены в таблице 22 в разделе "7.3. Описание запроса на подготовку заявки для подписи".
Чтобы подписать и отправить отчет заявки на перерегистрацию кассы в ФНС необходимо воспользоваться запросом описанным в разделе 7.4. Описание выполнения запроса на передачу в ФНС подписанной заявки.
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/c76b003e-36de-4db6-af87-ad91e67ba042/sign?AuthToken=ecca6a6949e848089bbecc8a97951734
Content-Type: application/json
{
"DocumentId": "012fad42-0e31-4c10-8a9f-098709374c91",
"Signature": "MIAGCSqGSIb3DQEHAqCAMIACAQExDjAMBggqhQMHAQECAwUAMIAGCSqGSIb3.............."
}
Пример ответа на запрос:
{
"Data": {
"Id": "c76b003e-36de-4db6-af87-ad91e67ba042",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300787014",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867291",
"FiscalDocumentData": {},
"RegNumber": "0000002928049035",
"FnsBranchCode": "7725",
"ReregistrationReasons": {
"AutomatedDeviceChanged": false,
"FnChanged": true,
"InstallmentPlaceChanged": false,
"OfdChaged": false,
"Other": false,
"SwitchedFromOfflineToOnlineMode": false,
"SwitchedFromOnlineToOfflineMode": false,
"UserChanged": false
},
"ClosedFnDetails": {
"FdDateTime": "2021-12-16T13:55:55",
"FdNumber": "12345",
"FpValue": "12345"
},
"InstalledFnDetails": {
"FdDateTime": "2021-12-16T17:14:00",
"FdNumber": "1",
"FpValue": "12345"
},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "ProcessingSignedDocuments",
"Stage": "Initialization",
"CanDelete": false,
"Documents": [
{
"Id": "012fad42-0e31-4c10-8a9f-098709374c91",
"Kind": "1110061",
"Signature": "Signed",
"Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
"FileName": "KO_ZVLREGKKT_7725_5252_5252012620525201001_20211222_d44dd8f5e75b44c286d4045361b0a741"
}
],
"Purpose": "Reregistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-22T12:28:01",
"CDateUtc": "2021-12-22T12:16:01",
"UDateUtc": "2021-12-22T12:28:01",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа представлено в таблице 24 в разделе 7.4. Описание выполнения запроса на передачу в ФНС подписанной заявки.
Чтобы получить ответ от ФНС о статусе заявки вам нужно воспользоваться запросом описанным в разделе 7.5. Описание запроса проверки статуса заявки
Пример запроса:
GET https://ofd.ru/api/integration/v2/b2b/kkt/registration/c76b003e-36de-4db6-af87-ad91e67ba042?AuthToken=ecca6a6949e848089bbecc8a97951734
Пример ответа:
{
"Data": {
"Id": "c76b003e-36de-4db6-af87-ad91e67ba042",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300787014",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867291",
"FiscalDocumentData": {},
"RegNumber": "0000002928049035",
"FnsBranchCode": "7725",
"ReregistrationReasons": {
"AutomatedDeviceChanged": false,
"FnChanged": true,
"InstallmentPlaceChanged": false,
"OfdChaged": false,
"Other": false,
"SwitchedFromOfflineToOnlineMode": false,
"SwitchedFromOnlineToOfflineMode": false,
"UserChanged": false
},
"ClosedFnDetails": {
"FdDateTime": "2021-12-16T13:55:55",
"FdNumber": "12345",
"FpValue": "12345"
},
"InstalledFnDetails": {
"FdDateTime": "2021-12-16T17:14:00",
"FdNumber": "1",
"FpValue": "12345"
},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "SentToFns",
"Stage": "Initialization",
"CanDelete": false,
"FiscalDocuments": [],
"Documents": [],
"Purpose": "Reregistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-22T12:30:18",
"CDateUtc": "2021-12-22T12:16:01",
"UDateUtc": "2021-12-22T12:30:19",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"ResultDocs": [
{
"KktId": 16880,
"ReportTypeId": 101,
"DocType": "ReRegReport",
"ConversationUuid": "c76b003e-36de-4db6-af87-ad91e67ba042",
"ReportSizeInBytes": 124914,
"FileType": "application/pdf",
"DownloadUri": "https://dev.ofd.ru/api/kkt/application/doc/c76b003e-36de-4db6-af87-ad91e67ba042/16880/101"
}
],
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа представлено в таблице 26 в разделе 7.5. Описание запроса проверки статуса заявки
В разделе описан процесс последовательности действий для заявки на снятие с учета кассы в ФНС.
Заявку на снятие с учета оформляют в связи:
Последовательность выполнения запросов заявки снятия с учета:
Создание заявки на снятие с учета кассы выполняется запросом описанным в разделе 7.1. Описание запроса на создание заявки.
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration?AuthToken=fefdbc065e2747b0922e04cb2efabf2c
Content-Type: application/json
{
"Purpose": "Unregistration",
"CompanyDetails":
{
"Inn":"5252012620",
"Kpp":"525201001"
},
"KktDetails":
{
"SerialNumber": "00307404867347",
"RegNumber": "0000002947022927",
"FnNumber": "9287440300784236",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"Model": "ЭВОТОР СТ2Ф",
"InstallmentAddress":
{
"FullAddress": "Москва, Ленинская Слобода, 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode":
{
"Internet": true,
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false
},
"FormatVersion": 3,
"UnregistrationReasons": {
"Lost": true
}
}
}
Пример ответа:
{
"Data": {
"Id": "3c8cdf17-5286-44df-bf9b-48b32cd10e5c",
"CompanyDetails": {
"Director": {},
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"FullAddress": ""
},
"Inn": "5252012620",
"Kpp": "525201001",
"Signatory": {
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "00307404867347",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"FullAddress": ""
},
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": false,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "9287440300784236",
"FiscalDocumentData": {},
"RegNumber": "0000002947022927",
"UnregistrationReasons": {
"Lost": true,
"Stolen": false,
"Broken": false
},
"ClosedFnDetails": {},
"InstalledFnDetails": {}
},
"AutomaticDevices": [],
"Status": "New",
"Stage": "Initialization",
"CanDelete": true,
"Documents": [],
"Purpose": "Unregistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-16T11:47:24",
"CDateUtc": "2021-12-16T11:47:24",
"UDateUtc": "2021-12-16T11:47:25",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=3c8cdf17-5286-44df-bf9b-48b32cd10e5c&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа представлено в таблице 15 в разделе 5.1. Описание запроса на создание заявки 7.1. Описание запроса на создание заявки.
Подготовка заявки на снятие с учета кассы для подписи выполняется запросом описанным в разделе 7.3. Описание запроса на подготовку заявки для подписи
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/b9e0ff67-eae4-4d7b-b637-68df3999e7fb/prepareDocuments?AuthToken=8dd69254b0444a1cbd103f80012cf1bb6
Content-Type: application/json
{
"GivenName": "Алла Романовна",
"LastName": "Романова",
"Position": "ТестДолжность"
}
Пример ответа:
{
"Data": {
"Id": "b9e0ff67-eae4-4d7b-b637-68df3999e7fb",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300784236",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода",
"HouseNumber": "д 19",
"FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867347",
"FiscalDocumentData": {},
"RegNumber": "0000002947022927",
"FnsBranchCode": "7725",
"UnregistrationReasons": {
"Lost": true,
"Stolen": false,
"Broken": false
},
"ClosedFnDetails": {},
"InstalledFnDetails": {},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "AwaitingSignature",
"Stage": "Initialization",
"CanDelete": false,
"Documents": [
{
"Id": "c98b46dd-2780-4006-bc71-c67e6483de46",
"Kind": "1110061",
"Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIiBzdGFuZGFsb25lP..................",
"Signature": "Unsigned",
"Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
"FileName": "KO_ZVLSNUCHKKT_7725_7725_5252012620525201001_20211216_39fd922ee8574678a7e750f463cc15db"
}
],
"Purpose": "Unregistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-16T12:32:33",
"CDateUtc": "2021-12-16T12:32:15",
"UDateUtc": "2021-12-16T12:32:33",
"UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа представлено в таблице 24 в разделе 7.4. Описание выполнения запроса на передачу подписанного заявления в ФНС.
Чтобы подписать и отправить заявку на снятие с учета кассы в ФНС, необходимо воспользоваться запросом описанным в разделе 7.4. Описание выполнения запроса на передачу в ФНС подписанной заявки.
Пример запроса:
POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/b9e0ff67-eae4-4d7b-b637-68df3999e7fb/sign?AuthToken=d191800efd1c4b0ba70ef05b95a9a582
Content-Type: application/json
{
"DocumentId": "c98b46dd-2780-4006-bc71-c67e6483de46",
"Signature": "MIAGCSqGSIb3DQEHAqCAMIACAQExDjAMBggqhQMHAQECAwUAMIAGCSqGSIb3DQEHAQAAoIIJOTCCCTUwggjioAMCAQICEQPjTaYArK2tpkEN.........."
}
Пример ответа:
{
"Data": {
"Id": "b9e0ff67-eae4-4d7b-b637-68df3999e7fb",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300784236",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "г Москва",
"Street": "ул Ленинская Слобода"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867347",
"FiscalDocumentData": {},
"RegNumber": "0000002947022927",
"FnsBranchCode": "7725",
"UnregistrationReasons": {
"Lost": true,
"Stolen": false,
"Broken": false
},
"ClosedFnDetails": {},
"InstalledFnDetails": {},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "ProcessingSignedDocuments",
"Stage": "Initialization",
"CanDelete": false,
"Documents": [
{
"Id": "c98b46dd-2780-4006-bc71-c67e6483de46",
"Kind": "1110061",
"Signature": "Signed",
"Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
"FileName": "KO_ZVLSNUCHKKT_7725_7725_5252012620525201001_20211216_39fd922ee8574678a7e750f463cc15db"
}
],
"Purpose": "Unregistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-16T12:37:04",
"CDateUtc": "2021-12-16T12:32:15",
"UDateUtc": "2021-12-16T12:37:04",
"UserAccountId": "56805d98-6a0a-4148-8a1a-f0072cf7d32f",
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа представлено в таблице 24 в разделе 7.4. Описание выполнения запроса на передачу в ФНС подписанной заявки.
Чтобы получить ответ от ФНС о статусе заявки вам нужно воспользоваться запросом описанным в разделе 7.5. Описание запроса проверки статуса заявки
Пример запроса:
GET https://ofd.ru/api/integration/v2/b2b/kkt/registration/b9e0ff67-eae4-4d7b-b637-68df3999e7fb?AuthToken=a70b4f0b575d4fe8a8931d929f601e37
Пример ответа на запрос
{
"Data": {
"Id": "b9e0ff67-eae4-4d7b-b637-68df3999e7fb",
"CompanyDetails": {
"CompanyType": "LegalEntity",
"Director": {
"FirstName": "Алла",
"LastName": "Романова",
"MiddleName": "Романовна"
},
"FnsBranchCode": "5252",
"CreatedDate": "0001-01-01T00:00:00",
"UpdatedDate": "0001-01-01T00:00:00",
"LegalAddress": {
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ТестДолжность",
"Email": "skripchuk@ofd.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false,
"RepresentativeDetails": {}
},
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": false
},
"KktDetails": {
"FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
"FnNumber": "9287440300784236",
"OfdInn": "7841499999",
"OfdName" : "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
"InstallmentAddress": {
"PostalCode": "115280",
"RegionCode": "77",
"Region": "Москва",
"FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
},
"InstallmentPlace": "Магазин №1",
"UsageMode": {
"Gambling": false,
"Lottery": false,
"Agent": false,
"AutomatedDevice": false,
"Internet": true,
"Mobile": false,
"Banking": false,
"ExcisableGoods": false,
"FormsForReports": false,
"Marking": false
},
"Model": "ЭВОТОР СТ2Ф",
"SerialNumber": "00307404867347",
"FiscalDocumentData": {},
"RegNumber": "0000002947022927",
"FnsBranchCode": "7725",
"UnregistrationReasons": {
"Lost": true,
"Stolen": false,
"Broken": false
},
"ClosedFnDetails": {},
"InstalledFnDetails": {},
"FormatVersion": 3
},
"AutomaticDevices": [],
"Status": "Approved",
"Stage": "Finalization",
"CanDelete": false,
"Documents": [],
"Purpose": "Unregistration",
"Gateway": "SuccessMock",
"OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
"OfdAgreement": {
"PayPeriods": {
"1": "EachMonth",
"3": "EachQuarter",
"12": "EachYear"
},
"State": "Liquidated",
"HasUnifiedOrPatentTaxation": false,
"IncorrectNdsCalculationKktExist": false,
"Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
"CreatedDate": "2020-09-09T09:18:54",
"UpdatedDate": "2021-12-06T10:41:05",
"Number": "1025375819",
"LegalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"PostalAddress": {
"District": "Беломорский р-н",
"City": "г Беломорск",
"PostalCode": "109341",
"RegionCode": "77",
"Region": "Москва",
"Settlement": "Москва",
"Street": "ул Пушкина-колотушкина",
"HouseNumber": "1",
"Building": "1",
"FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
},
"Inn": "5252012620",
"Ogrn": "1025202124716",
"Kpp": "525201001",
"CompanyName": "Юридическое лицо 9291",
"Signatory": {
"Name": "Романова Алла Романовна",
"Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
"Email": "ivanov_ivan_ivanich@ofd.ru.ru",
"Phone": "+7 (495) 123-45-67",
"IsRepresent": false
},
"IsNdsPayer": true,
"ElectronicInvoicingType": "None",
"PaymentType": "BalancePrePayment",
"PartnerCode": "335",
"ProxyTestDiveAvailable": true,
"IsReceiptSendingEnable": false,
"IsPaymentAgent": false,
"ShowEReceiptMainBanner": false,
"LockCreatingCompanyWithOtherKpp": true
},
"KktAgreementId": "00000000-0000-0000-0000-000000000000",
"StatusChangeDateUtc": "2021-12-16T13:40:28",
"CDateUtc": "2021-12-16T12:32:15",
"UDateUtc": "2021-12-16T13:40:28",
"UserAccountId": "56805d98-6a0a-4148-8a1a-f0072cf7d32f",
"ResultDocs": [],
"DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
"CanBeAutomaticDevice": true
},
"Success": true
}
Описание параметров ответа представлено в таблице 22 в разделе 7.5. Описание запроса проверки статуса заявки
Запрос на изменение заявки допустимо вызывать несколько раз, но только до выполнения вызова запроса «7.3. Описание запроса на подготовку заявки для подписи» и выполняется методом PUT с передачей параметров в JSON структуре.
PUT https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:guid}
В запросе обязательно присутствуют заменяемые параметры:
PUT https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:guid}
{
"CompanyDetails": {...},
"KktDetails": {...},
"AutomaticDevices": {...}
}
Описание параметров данных запроса приведено в пункте 6.2.1. Общая схема JSON-заявки. Ответ на данный запрос является полностью аналогичным ответу запроса на создание заявки.
Ошибки Формат ответа об ошибке описан в разделе 6.1.
Таблица 27. Возможные ошибки в ответе на запрос
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | ValidationError | Номер ФД не может превышать {MaximumLength} символов |
| Признак ФД не может превышать {MaximumLength} символов | ||
| Дата фискализации не может быть позже сегодняшней |
Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.
Признаком ошибки является HTTP-код, отличный от 200. В теле ответа Success = false (либо Status = Failed для методов раздела 7) и заполненный объект Error (Errors) с кодом и текстом ошибки. Структура ответа об ошибке описана в разделе 6.1.
Один код ошибки (поле Code) может сопровождаться разными сообщениями (поле message) в зависимости от причины.
Общие ошибки авторизации и доступа Перечисленные ниже ошибки могут быть возвращены любым методом API. В описании отдельных методов они не повторяются — там приведены только специфичные ошибки.
Таблица 28. Общие ошибки авторизации и доступа
| HTTP | Код ошибки | Сообщение (поле message) |
|---|---|---|
| 400 | AccessDenied | Нет доступа |
| Доступ запрещён | ||
| Не удалось определить токен | ||
| Не найдены авторизационные данные | ||
| 400 | ValidationError | Некорректный авторизационный токен |
| 400 | B2bAgreementNotFound | Кабинет партнёра не найден |
Версия 1.0
Выпущена 20 Февраля 2025 г.
Первая регистрируемая версия документа.
Версия 2.0
Выпущена 29 Апреля 2025 г.
Добавлены методы авторегистрации в фнс и упрощенная авторегистрация (Пункты 4 - 5.9).
Версия 2.1
Выпущена 28 Мая 2025 г.
Добавлены методы бронирование ККТ (Пункт 3) и получения списка кодов активации (Пункт 2).
Версия 2.2
Выпущена 22 Мая 2026 г.
Убран тариф «Urgent13M».
Версия 2.3
Выпущена 18 Июня 2026 г.
Добавлен раздел 8 «Обработка ошибок». Для методов добавлены таблицы возможных ошибок (разделы 2, 3, 5.1, 5.2, 7.1, 7.2, 7.2.1, 7.3, 7.4, 7.9) и отсылки к разделу 8 (разделы 4.2, 4.3, 5.3, 7.5).
Версия 2.31
Выпущена 23 Июня 2026 г.
Исправлена ошибка в разделе 8.