Программный интерфейс приложений (API) обслуживания касс ИС «OFD.RU» для партнеров

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

Обмен данными происходит по протоколу HTTP с использованием зашифрованного канала (HTTPS). Данные запросов и ответов передаются в виде структуры JSON. Вне зависимости от наличия ошибок в данных, обязательным условием успешного выполнения запроса является ответ с кодом 200 согласно протоколу HTTP.

Для получения токена авторизации, который будет использоваться для выполнения запросов, пользователю необходимо обратиться в раздел «Настройки» в Личном кабинете партнера.

Далее пользователь переходит на вкладку «API для партнеров» и попадает в блок генерации ключей доступа к использованию API 2.0.

• Ключ доступа к API 2.0 (API KEY) предоставляется на личный кабинет организации (уникальную пару ИНН и КПП);
• Блокировка ключа доступа в интерфейсе личного кабинета партнера в случае компрометации;
• Срок действия ключа доступа — неограничен;
• Право на выделение ключа доступа есть у пользователей с полными правами администратора в ЛКП.

Сгенерированный ключ появляется на вкладке «API для партнеров» в блоке «Ваши ключи доступа».

Созданный ключ доступа будет иметь указания данных о датах создания и последней активности, статусе ключа и типе доступа, которое будет использоваться в запросах API 2.0.

Используемое обозначение параметра ключа доступа в запросах — AuthToken={Code}

Внимание! Так как параметр AuthToken передается в строке запроса (query string), он может попадать в access-логи серверов, историю браузера и системы аналитики. Рекомендуется ограничивать доступ к таким логам и избегать их передачи третьим лицам.

Для получения списка кодов активации используется метод «GET». В ответ на запрос возвращается список с кодами активации (в соответствии с переданным токеном).

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

GET https://ofd.ru/api/integration/v2/kkt/code/list?AuthToken={authToken}&FolderId={id}

Заменяемые параметры:

• AuthToken — токен, возвращенный в результате авторизации (см. пп. 1 «Авторизация»);
• FolderId — идентификатор папки, по которому выполняется фильтрация списка кодов активации. При указании параметра в ответе возвращаются только коды активации, непосредственно расположенные в указанной папке. Если параметр не указан, возвращаются коды активации из всех папок.

Параметры пагинации, ограничения количества записей и сортировки в методе не предусмотрены: все коды активации, соответствующие запросу, возвращаются одним массивом Data.

Пример успешного ответа на запрос имеет следующий вид (приведены примеры значений):

      
{
  "Data": [
    {
      "Id": guid,
      "Code": string,
      "Service": string,
      "Tariff": string,
      "TariffCount": number,
      "Status": string,
      "ExpiredDateUtc": datetime,
      "Path": "Все папки/Архив кодов"
    }
  ],
  "Success": true
}

Таблица 1 Поля структуры ответа на запрос списка кодов активации

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Таблица 2. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

В ответ на запрос возвращается список папок, включая стандартные и созданные пользователем. Удалённые папки в ответе не отображаются. Запрос на получение списка папок имеет вид:

GET https://ofd.ru/api/integration/v2/kkt/code/folders?AuthToken={authToken}

Заменяемый параметр AuthToken — токен, возвращённый в результате авторизации (см. пп. 1 «Авторизация»).

Пример успешного ответа на запрос имеет следующий вид (приведены примеры значений):

{
  "Data": [
    {
      "FolderID": guid,
      "Path": string,
      "Name": string,
      "Level": number,
      "Count": number
    }
  ],
  "Success": true
}

Таблица 3. Поля структуры ответа на запрос списка папок

Метод работает для ККТ сервиса ОФД и Ferma.

Чтобы забронировать ККТ отправьте код активации в методе POST.

Запрос имеет следующий вид:

POST https://ofd.ru/api/integration/v2/kkt/book?AuthToken={authToken}

Заменяемые параметры {AuthToken} — токен, возвращенный в результате авторизации (см. пп. 1 Авторизация).

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

{
   "KktSerialNumber": string,
   "FnSerialNumber": string,
   "ActivationCode": string
}

Параметры запроса брони ККТ:

• KktSerialNumber — серийный номер ККТ;
• FnSerialNumber — серийный номер фискального накопителя;
• ActivationCode — код активации.

В ответ на запрос сервер возвращает структуру данных (приведены примеры значений):

{
  "Data": {
      "Status": string
    },
  "Success": true
}

Параметры ответа на запрос брони ККТ:

• Success — статус ответа;
• Status — статус брони ККТ.

Безопасность повторного запроса

Метод проверяет наличие действующей брони и использование кода активации, однако эти проверки не гарантируют безопасного автоматического повтора запроса, если ответ на первый запрос не был получен. Если бронирование по первому запросу прошло успешно, повторный запрос, как правило, вернёт ошибку ActivationCodeUsed. По этой ошибке нельзя однозначно определить результат первого запроса, поэтому состояние брони необходимо проверить отдельно.

Возможные ошибки:

Формат ответа об ошибке описан в разделе 6.1.

Таблица 4. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

Метод используется партнерами для автоматизации оплаты касс клиентов кодами активации (далее КА) на услуги ОФД. Метод имеет следующий вид:

POST https://ofd.ru/api/integration/partner/v2/kkt/pay?AuthToken={Code}

• Code — действующий код авторизации, полученный при авторизации.

Чтобы применить КА, необходимо передавать в метод обязательные параметры, со значениями данных своих клиентов в API-запрос.
После прохождения проверок выполняются следующие действия:

• создание личного кабинета клиента (если ЛКК по ИНН клиента отсутствует);
• применение кода активации на услугу ОФД.

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

{
 "Inn": string,
 "Kpp": string,
 "Rnm": string,
 "ActivationCode": string,
 "Email": string
}

В таблице 5 представлены параметры необходимые для выполнения запроса.

Таблица 5. Параметры запроса для применения КА

В ответ на запрос возможны следующие вариант.

Ответ со значением «ККТ оплачена»:

{
  "IsCompleted": true,  
  "IsWaiting": false
}

Ответ со значением «ККТ ожидает первый ФД»:

{
  "IsCompleted": false, 
  "IsWaiting": true
}

Параметры ответа:

• IsCompleted - КА применена на кассе ждет первого фискального документа (далее ФД).
• IsWaiting - значение получения первого ФД.

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Таблица 6. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

После ввода кода активации (КА) для кассы клиента система проверяет наличие личного кабинета (ЛКК). Если ЛКК еще не создан, но ККТ уже есть, система автоматически регистрирует ЛКК и отправляет логин и пароль на email клиента. После этого код активации успешно применяется и запускает услуги ОФД.

Бронирование ККТ (см. раздел 3. Бронирование ККТ) действует 60 дней. Если за этот срок ККТ не будет зарегистрирована в OFD.ru, КА высвобождается, а бронирование удаляется.

Особенности и ограничения:

• КА можно применить на кассу, на которой уже активна услуга ОФД. В этом случае КА встанет в очередь на кассу.
• КА для массового применения услуг ОФД закрепляется за одним партнером:
  • на ККТ присваивается код партнера в соответствии с КА.
  • КА чужого партнера применить на ККТ невозможно.

Безопасность повторного запроса

Гарантированной защиты от повторного применения при неполученном ответе сейчас нет: запрос не использует ключ идемпотентности, повтор может привести к повторной обработке. Если результат операции уже получен, перед повтором нужно сначала проверить статус по коду активации (см. 4.2. Получение списка статусов оплаты). Если ответ с результатом потерян, требуется сверка через поддержку.

Для получения списка статусов оплат используется метод «GET».

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

GET https://ofd.ru/api/integration/partner/v2/kkt/paystatus?AuthToken={Code}&DateFromUtc={dateFrom}&DateToUtc={dateTo}

Заменяемые параметры:

• {Code} — токен, возвращенный в результате авторизации (см. пп. 1. Авторизация).
• {dateFrom} — начальная дата поиска.
• {dateTo} — конечная дата поиска.

Пример успешного ответа на запрос имеет следующий вид (приведены примеры значений):

{
  "Data": [
    {
      "DateUtc": datetime,
      "Inn": string,
      "Rnm": string,
      "ActivationCode": string,
      "Status": string,
      "ActivationDateUtc": datetime
    }
  ],
  "Success": true
}

Описание параметров ответа на запрос представлено в таблице 7.

Таблица 7. Поля структуры ответа на запрос статусов оплат

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Метод возвращает только общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

Метод получения списка касс клиентов имеет следующий вид:

GET https://ofd.ru/api/integration/partner/v2/inn/{inn}/kkts?AuthToken={Code}

• Code — значение действующего кода авторизации, полученного в ЛКП;
• inn — ИНН партнера.

Пример успешного ответа на запрос:

{
    "Data": [
        {
            "Id": "guid",
            "KktRegId": "String",
            "SerialNumber": "String",
            "FnNumber": "String",
            "CreateDate": "String",
            "LastDocOnKktDateTime": "String",
            "LastDocOnOfdDateTimeUtc": "String",
            "FiscalAddress": "String",
            "FiscalPlace": "String",
            "KktModel": "String",
            "FnEndDate": "String",
            "LastBuyDateUtc": "String",
            "ContractStartDateUtc": "String",
            "ContractEndDateUtc": "String",
            "ContractEndDatemin": "String",
            "ContractEndDatemax": "String",
            "OrgInn": "String",
            "OrgKpp": "String",
            "OrgName": "String",
            "FnsRegState": "String",
            "TaxSystem": "String",
            "Ffd": "String",
            "IsMarkUpManual": bool,
            "IsMarking": bool,
            "KktType": "String",
            "KktErrors": "String",
            "DaysWithoutReceipts": integer,
            "FnCapacity": float,
            "FnType": "String"
        }
    ],
    "Success": true
}

Описание параметров ответа представлено в таблице 8.

Таблица 8. Описание параметров ответа на запрос

Ошибки

Формат ответа об ошибке описан в разделе 6.1.

Метод возвращает только общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

Для того, чтобы перейти к удаленной оплате услуг и регистрации кассы, партнеру необходимо выполнить запрос на создание личного кабинета клиента с одним пользователем. После создания ЛКК клиенту на E-mail приходит письмо, в котором содержится ссылка для перехода и создания логина и пароля личного кабинета.

POST https://ofd.ru/api/integration/partner/v2/PartnerCreateClientCabinet?AuthToken={Code}

Code — значение действующего кода авторизации, полученного в ЛКП;

Пример запроса:

{
  "Inn": "String",
  "Kpp": "String",
  "Email": "String",
  "Name": "String",
  "Phone": "String"
}

Описание параметров запроса для создания ЛКК представлено в таблице 9.

Таблица 9. Параметры запроса на создание ЛКК

Пример успешного ответа на запрос:

{
    "Data": {
        "OfdAgreementId": "String"
    },
    "Success": true
}

Описание параметра ответа:

• OfdAgreementId — Идентификатор юридического лица клиента, прикрепленного к ЛК OFD.ru.

Возможные ошибки:

Формат ответа об ошибке описан в разделе 6.1.

Таблица 10. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

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

Эти данные содержатся в одном заказе и привязываются к идентификатору заказа OrderID.

POST https://ofd.ru/api/integration/partner/v2/PartnerBookingKkt?AuthToken={Code}

Пример запроса

{
  "OfdAgreementId": "String",
  "quantity": "Integer",
  "tariffType": "String",
  "fnType": "String",
  "PaymentType": "String"
}

Описание параметров запроса представлено в таблице 11.

Таблица 11. Параметры запроса на бронирование касс и передачу запроса на формирование ссылки на оплату нового клиента

Пример ответа

{
  "OrderID": "String"
  "OrderReceiptUrl": "String",
}

Описание параметров ответа на запрос представлено в таблице 12.

Таблица 12. Параметры ответа на запрос

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Таблица 13. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

Партнер может получить статус заказа посредством запроса статуса бронирования:

GET https://ofd.ru/api/integration/partner/v2/kkt/GetStatus?AuthToken={Code}&OrderID={orderid}

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

• Code — код полученный во время авторизации;
• orderid — идентификатор заказа

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

{
  "Status": "Integer",
  "DueDate": "String"
}

Описание параметров ответа на запрос представлено в таблице 14.

Таблица 14. Поля структуры ответа на запрос статуса заказа

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Метод возвращает только общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

При регистрации/перерегистрации ККТ на другие ОФД взимается плата с баланса ЛКП в размере 100 р.

Если на балансе недостаточно средств, система уведомит об этом, и регистрация или перерегистрация на другой ОФД осуществлена не будет.

Для работы API сервиса авторегистрации в ФНС в запросах и ответах используется кодировка UTF-8. Запросы выполняются методами POST, GET и PUT, параметры запроса располагаются в структуре данных формата JSON, передаваемой в блоке данных запроса (при использовании POST и PUT), также параметры могут передаваться в строке запроса (при использовании GET).
Ответы выдаются сервером в формате JSON и, в случае успешного ответа согласно его заголовку (код ответа по протоколу HTTP равен 200), данные имеют следующий обобщенный вид:

{
    "Status": "Success",
    "Data": {}
}

Получаем параметры ответа с кодом 200:

• параметр «Status» – состояние обработки запроса;
• параметр «Data» - данные ответа на запрос.

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

{
    "Status": "Failed",
    "Error": {
        Code: 0,
        Message: "string"
    }
}

В ответе с кодом не равным 200 возможны следующие параметры со значениями:

• «Status» - «Failed» (обработка запроса не удалась);
• «Error» - код ошибки и сообщение об ошибке;
  • «Code» - значение не равно 0;
  • «Message» - значение выводится в формате String. В значении выводится сообщение с описанием ошибки.

В разделе представлена общая 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
},

В таблице 15 представлено описание параметров.

Таблица 15. Описание параметров.

Таблица 15.1. Описание параметров. Описание параметров структуры «CompanyDetails» (Данные об организации)

Таблица 15.2. Описание параметров. Описание параметров структуры «KktDetails» (Сведения о кассе)

Таблица 15.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)

Таблица 15.4. Описание параметров. Описание параметров структуры «FiscalDocuments» (Данные фискальных документов в заявке)

Таблица 15.5. Описание параметров. Описание параметров структуры «Documents» (Исходящие документы от ФНС)

Таблица 15.6. Описание параметров. Описание параметров структуры «ResultDocs» (Ответ ФНС на заявку)

В таблице 16 представлено описание прохождения этапов заявки.

Таблица 16. Описание этапов заявки

В разделе описаны выполнения запросов, методы вызова, параметры и их значения для осуществления всех этапов прохождения заявки.

Запрос выполняется для заявок на:

• регистрацию кассы в ФНС;
• перерегистрацию кассы в ФНС;
• снятие с учета в ФНС.

Начальный этап для всех видов заявок.

Рассмотрим работу запроса на примере создания заявки регистрации кассы в ФНС.
В запросе вы указываете основные данные для оформления заявки на регистрацию кассы в ФНС. Данные для регистрации кассы передаются в JSON-структуре.
Запрос на создание заявки выполняется методом POST

POST https://ofd.ru/api/integration/v2/b2b/kkt/registration?AuthToken={Code}

В запросе участвует необходимый параметр AuthToken. Значение параметра AuthToken принимает действующий код авторизации. Значение кода авторизации получаем в ответе на запрос AuthToken, описанный в разделе Авторизация

Таблица 17. Описание параметров запроса на создание заявки на регистрацию кассы

Пример запроса на создание заявки на регистрацию кассы в ФНС:

POST https://ofd.ru/api/integration/v2/b2b/kkt/registration?AuthToken=fefdbc999e2747b9999e04cb2efabf2c
Content-Type: application/json

{
    "Purpose": "InitialRegistration",
    "CompanyDetails":
    {
        "Inn":"7841465198",
        "Kpp":"779999901"
    },
    "KktDetails":
    {
        "OfdInn": "7841465198",
        "OfdName" :  "Общество с ограниченной ответственностью «ПЕТЕР-СЕРВИС Спецтехнологии»",
        "SerialNumber": "1099995991",
        "FnNumber": "9287440300999999",
        "Model": "Эфир Pro ФС",
        "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": "7841465198",
            "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": "Эфир Pro ФС",
            "SerialNumber": "1099999781",
            "FiscalDocumentData": {},
            "ClosedFnDetails": {},
            "InstalledFnDetails": {}
        },
        "AutomaticDevices": [],
        "Status": "New",
        "Stage": "Initialization",
        "CanDelete": true,
        "Documents": [],
        "Purpose": "InitialRegistration",
        "Gateway": "EKkt",
        "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": "7777777777",
            "Ogrn": "1234567891234",
            "Kpp": "777777777",
            "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://ofd.ru/document/KktRegistrationApplication?Id=dce50538-ee9b-4378-990c-66824ef3815c&format=pdf",
        "CanBeAutomaticDevice": false
    },
    "Success": true
}

Описание параметров ответа на запрос представлено в таблице 18.

Таблица 18. Описание параметров ответа на запрос.

Таблица 18.1. Описание параметров ответа на запрос. Описание параметров структуры «CompanyDetails» (Данные организации)

Таблица 18.2. Описание параметров ответа на запрос. Описание параметров структуры «KktDetails» (Сведения о кассе)

Таблица 18.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)

Таблица 18.4. Описание параметров. Описание параметров структуры «OfdAgreement» (Описания и условия предоставления услуг OFD.ru)

Если вы подписываете заявку на регистрацию/перерегистрацию, снятие с учета ККТ не от руководителя организации, то в заявке необходимо указать данные машинопечатной доверенности (далее - МЧД).

Заявка на регистрацию/перерегистрацию, снятие с учета с использованием МЧД выполняется методом описанным в разделе 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
    }
}

Описание параметров запроса и параметров ответа представлено в таблице 18 раздела 7.1.

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Таблица 19. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 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"
}

Таблица 20. Описание параметров запроса без создания заявки.

● С созданием заявки на регистрацию/перерегистрацию/снятие с учета ККТ в ФНС:

Передайте в теле запроса «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
}

Описание параметров ответа на запрос представлено в таблице 18 пункта 7.1

В случае неверных данных, в запросе вернется ошибка.

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

{
  "Data": null,
  "Success": false,
  "Errors": [
    {
      "Code": "InternalError",
      "Message": "Не удалось оплатить услугу"
    }
  ]
}

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Таблица 21. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

Чтобы узнать статус заявки, используйте метод:

GET https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:guid}/simplified/status

В запросе присутствует заменяемый параметр id:uuid - идентификатор заявки. Значение идентификатора заявки - это значение параметра ID из ответа на запрос описанный в разделе "7.1. Описание запроса на создание заявки";

Пример ответа на запрос. Возможные статусы представлены в таблице 22.

{
    "Data": {
        "Status": "SUCCESS",
        "DownloadUrl": "https://ofd.ru/api/integration/v2/b2b/kkt/registration/3d79999e-f999-4ea4-8adc-ff299999db40/simplified/download?AuthToken=4E7E8D09D99999984640B8249999994"
    },
    "Success": true
}

Таблица 22. Описание возможных статусов по заявке

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Таблица 23. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

Запрос выполняется для:

• заявки на регистрацию кассы в ФНС;
• отправки отчета «О регистрации кассы» в ФНС;
• заявки на перерегистрацию кассы в ФНС;
• заявки снятия с учёта кассы в ФНС.

Следующий этап, подготовка заявления для подписи. Рассмотрим работу запроса на примере заявки на регистрацию кассы в ФНС.

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

POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:uuid}/prepareDocuments?AuthToken={authToken}

В запросе обязательно присутствуют заменяемые параметры:

• id:uuid - идентификатор заявки, значение идентификатора заявки - это значение параметра ID из ответа на запрос описанный в разделе "5.1. Описание запроса на создание заявки";
• Code – действующий код авторизации.

В теле запроса передаются следующие параметры:

• LastName - фамилия владельца электронной подписи (из КЭП);
• GivenName - имя владельца электронной подписи (из КЭП), может включать также и отчество;
• Position - должность владельца электронной подписи (из КЭП).

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": "7841465198",
            "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": "Эфир Pro ФС",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=4d5d5574-433d-4c3f-afd7-3b3c39595d33&format=pdf",
        "CanBeAutomaticDevice": false
    },
    "Success": true
}

Таблица 24. Описание параметров ответа на запрос.

Таблица 24.1. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «CompanyDetails» (Данные организации)

Таблица 24.2. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «KktDetails» (Сведения о кассе)

Таблица 24.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)

Таблица 24.4. Описание параметров. Описание параметров структуры «Documents» (Документы, сгенерированные для передачи в ФНС )

Таблица 24.5. Описание параметров. Описание параметров структуры «OfdAgreement» (Описания и условия предоставления услуг OFD.ru)

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Таблица 25. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

Запрос выполняется для:

• заявки на регистрацию кассы в ФНС;
• отправки отчета «О регистрации кассы» в ФНС;
• заявки на перерегистрацию кассы в ФНС;
• заявки снятия с учёта кассы в ФНС.

Следующий этап, передача подписанного заявления в ФНС.

Запрос выполняется методом POST с передачей параметров в JSON-структуре.

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

POST https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:uuid}/sign?AuthToken={authToken}

Заменяемые параметры:

• id:uuid - идентификатор заявки.
• Code – действующий код авторизации.

В теле запроса передаются следующие параметры:

• DocumentId - идентификатор исходящего документа, идентификатор берется из ответа на запрос подготовки заявления
• Signature - подписанный документ в формате base64, требуется подписать КЭПом строковые данные параметра Content полученные в ответе на запрос подготовки заявления. Данные передаются в формате base64.

Рассмотрим работу запроса на примере заявки на регистрацию кассы.

Пример запроса:

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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=1b21cac3-2b85-404a-b147-7f3bbd6827a5&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Таблица 26. Описание параметров ответа на запрос.

Таблица 26.1. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «CompanyDetails» (Данные организации)

Таблица 26.2. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «KktDetails» (Сведения о кассе)

Таблица 26.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)

Таблица 26.4. Описание параметров. Описание параметров структуры «Documents» (Документы, сгенерированные для передачи в ФНС )

Таблица 26.5. Описание параметров. Описание параметров структуры «OfdAgreement» (Описания и условия предоставления услуг OFD.ru)

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Таблица 27. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

Запрос выполняется для получения статус и ответа от ФНС для:

• заявки на регистрацию кассы в ФНС;
• отправки отчета «О регистрации кассы» в ФНС;
• заявки на перерегистрацию кассы в ФНС;
• заявки снятия с учёта кассы в ФНС.

После выполнения запроса передачи в ФНС подписанного заявления, необходимо получить ответ от ФНС.

В зависимости от заявки, карточка с ответом от ФНС может иметь следующие ответы:

• о присвоении РНМ;
• о завершении регистрации;
• о завершении перерегистрации;
• о снятия с учета.

Запрос проверки статуса заявки позволяет получить ссылку на сформированный и подписанный документ с ответом от ФНС.

Запрос выполняется методом GET.

GET https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:uuid}?AuthToken={authToken:string}

Заменяемые параметры:

• id:uuid - идентификатор заявки, значение идентификатора заявки - это значение параметра ID из ответа на запрос описанный в разделе "7.1. Описание запроса на создание заявки";
• Code – действующий код авторизации.

Рассмотрим работу запрос на примере заявления на регистрацию кассы.

Пример запроса:

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": "7841465198",
            "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": "EKkt",
        "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://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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/api/kkt/application/doc/81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c/16840/50"
            }
        ],
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Таблица 28. Описание параметров ответа на запрос.

Таблица 28.1. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «CompanyDetails» (Данные организации)

Таблица 28.2. Описание параметров ответа на запрос. Описание параметров. Описание параметров структуры «KktDetails» (Сведения о кассе)

Таблица 28.3. Описание параметров. Описание параметров структуры «AutomaticDevices» (Данные автоматического устройств)

Таблица 28.4. Описание параметров. Описание параметров структуры «Documents» (Документы, сгенерированные для передачи в ФНС )

Таблица 28.5. Описание параметров. Описание параметров структуры «OfdAgreement» (Описания и условия предоставления услуг OFD.ru)

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Метод возвращает только общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

После получения ответа от ФНС о присвоении РНМ, для завершения регистрации кассы требуется выполнить следующие действия:

• пробить отчет о регистрации на кассе;
• внести в заявку 7.6.1. Описание запроса на передачи данных из отчета о регистрации;
• подготовить заявку для подписи 7.6.2. Описание подготовки отчета для подписи;
• подписать и отправить в ФНС 7.6.3. Описания подписи и отправка в ФНС данных из отчета о регистрации;
• получить карточку о завершении регистрации кассы 7.6.4. Проверка статуса заявки.

Чтобы внести в заявку данные из отчета о регистрации необходимо воспользоваться запросом передача данных отчета о регистрации методом PUT.

Данные отчета передаются в формате JSON.

PUT https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:uuid}?AuthToken={authToken}

Заменяемые параметры:

• id:uuid - идентификатор заявки, значение идентификатора заявки - это значение параметра ID из ответа на запрос описанный в разделе "7.1. Описание запроса на создание заявки";
• Code – действующий код авторизации.

Параметры запроса для передачи отчета о регистрации.
В параметре FiscalDocumentData передается структура со следующими параметрами:

• DateTime - дата и время формирования отчета о регистрации;
• DocumentNumber - номер фискального документа;
• Signature - фискальный признак документа.

Пример запроса:

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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа на запрос представлен в таблице 18 в разделе "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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа приведены в таблице 24 в разделе "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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 26 в разделе 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": "test@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": "7841465198",
            "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": "EKkt",
        "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://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://ofd.ru/api/kkt/application/doc/81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c/16840/50"
            }
        ],
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 28 в разделе 5.5. Описание запроса проверки статуса заявки

В разделе описан процесс последовательности действий для заявки на перерегистрацию кассы в ФНС.

Заявку на перерегистрацию создают в следующих случаях:

• Замена фискального накопителя;
• Изменение адреса и места установки;
• Другое.

Последовательность выполнения запросов на перерегистрацию кассы:

1. Создание заявки. Раздел "7.7.1. Создание заявки на перерегистрацию кассы".
2. Подготовка к подписи. Раздел "7.7.2. Подготовка заявки на перерегистрацию кассы для подписи".
3. Подписание и отправка в ФНС. Раздел"7.7.3. Подпись и отправка заявки на перерегистрацию кассы в ФНС".
4. Получение ответа от ФНС. Раздел "7.7.4. Проверка статуса заявки на перерегистрацию кассы".

Создание заявки на перерегистрацию кассы выполняется запросом описанным в разделе 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": "7841465198",
        "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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 18 в разделе 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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа приведены в таблице 24 в разделе "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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 26 в разделе 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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/api/kkt/application/doc/c76b003e-36de-4db6-af87-ad91e67ba042/16880/101"
            }
        ],
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 28 в разделе 7.5. Описание запроса проверки статуса заявки

В разделе описан процесс последовательности действий для заявки на снятие с учета кассы в ФНС.

Заявку на снятие с учета оформляют в связи:

• с хищением кассы;
• с потерей кассы;
• с поломкой фискального накопителя.

Последовательность выполнения запросов заявки снятия с учета:

1. Создание заявки. Раздел "7.8.1. Создание заявки на снятие с учета".
2. Подготовка к подписи. Раздел "7.8.2. Подготовка заявки на снятие с учета кассы для подписи".
3. Подписание и отправка в ФНС. Раздел"7.8.3. Подпись и отправка в ФНС заявки на снятие с учета кассы".
4. Получение ответа от ФНС. Раздел "7.8.4. Проверка статуса заявки на снятие с учета кассы".

Создание заявки на снятие с учета кассы выполняется запросом описанным в разделе 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": "7841465198",
        "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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=3c8cdf17-5286-44df-bf9b-48b32cd10e5c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 18 в разделе 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": "test@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": "7841465198",
            "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": "EKkt",
        "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://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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 26 в разделе 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": "test@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": "7841465198",
            "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": "EKkt",
        "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://ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 28 в разделе 7.5. Описание запроса проверки статуса заявки

Запрос на изменение заявки допустимо вызывать несколько раз, но только до выполнения вызова запроса «7.3. Описание запроса на подготовку заявки для подписи» и выполняется методом PUT с передачей параметров в JSON структуре.

PUT https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:guid}

В запросе обязательно присутствуют заменяемые параметры:

• id:uuid - идентификатор заявки, значение идентификатора заявки - это значение параметра ID из ответа на запрос, описанный в разделе "7.1. Описание запроса на создание заявки";

PUT https://ofd.ru/api/integration/v2/b2b/kkt/registration/{id:guid}
{
    "CompanyDetails": {...},
    "KktDetails": {...},
    "AutomaticDevices": {...}
}

Описание параметров данных запроса приведено в пункте 6.2.1. Общая схема JSON-заявки. Ответ на данный запрос является полностью аналогичным ответу запроса на создание заявки.

Ошибки Формат ответа об ошибке описан в разделе 6.1.

Таблица 29. Возможные ошибки в ответе на запрос

Помимо перечисленных, метод возвращает общие ошибки авторизации и доступа — см. раздел 8. Обработка ошибок.

Признаком ошибки является HTTP-код, отличный от 200. В теле ответа Success = false (либо Status = Failed для методов раздела 7) и заполненный объект Error (Errors) с кодом и текстом ошибки. Структура ответа об ошибке описана в разделе 6.1.

Один код ошибки (поле Code) может сопровождаться разными сообщениями (поле message) в зависимости от причины.

Общие ошибки авторизации и доступа Перечисленные ниже ошибки могут быть возвращены любым методом API. В описании отдельных методов они не повторяются — там приведены только специфичные ошибки.

Таблица 30. Общие ошибки авторизации и доступа

Версия 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.

Версия 2.32
Выпущена 06 Июля 2026 г.
В разделе 3 и 5.1 добавлены новые коды ошибок.

Версия 2.33
Выпущена 15 Июля 2026 г.
Убраны тарифы «Urgent1M», «Urgent6M». В метод «2. Получение списка кодов активации» добавлен необязательный заменяемый параметр «FolderId». Добавлен новый метод «2.1. Получение списка папок с КА».

Версия 2.34
Выпущена 05 Октября 2026 г.
Устранены неточности и уточнены формулировки в описании методов и структур ответов API.