Программный интерфейс приложений (API) сервиса авторегистрации в ФНС

В инструкции представлено описание программного интерфейса приложений (API) сервиса авторегистрации в ФНС. API сервис авторегистрации в ФНС осуществляет регистрацию, перерегистрацию, снятие с учета касс в ФНС.
В инструкции описаны API запросы и методы выполнения заявок регистрации, перерегистрации, снятия с учета касс, а также представлены описания основных параметров запросов и ответов.

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

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

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

• «Data» – данные ответа на запрос;
• «Success» – признак успешной обработки запроса, значение true.

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

{
    "Data": null,
    "Success": false,
    "Errors": [
        {
            "Code": "InternalError",
            "Message": "Заявка не найдена"
        }
    ]
}

Параметры ответа с ошибкой:

• «Data» – значение null;
• «Success» – значение false;
• «Errors» – массив ошибок, каждый элемент которого содержит:
  • «Code» – код ошибки в формате String;
  • «Message» – сообщение об ошибке в формате String.

Отдельные ответы имеют другой вид:

• успешный ответ на запрос получения AuthToken содержит параметры AuthToken и ExpirationDateUtc в корневом JSON-объекте, без обертки Data и без параметров Status и Success;
• ответ с сообщением Validation error и ответ с кодом 403 из таблицы 1 содержат параметр «Success» со значением false и параметр «Message» с сообщением, без массива «Errors»;
• ответы с ошибкой на запрос получения AuthToken описаны в разделе 2.1;
• ответ на запрос получения списка заявок (раздел 3.9) содержит параметры Status, Data и Elapsed, без параметра Success;
• если идентификатор заявки в адресе запроса не является UUID, сервер возвращает HTML-страницу ошибки вместо JSON.

Обработка ошибок

• Для разных причин ошибки может возвращаться один и тот же код InternalError. Чтобы определить причину, используйте HTTP-код ответа совместно с сообщением об ошибке.
• Текст отдельных сообщений может отличаться. При обработке ответа используйте HTTP-код, код ошибки и сообщение совместно.
• Не повторяйте изменяющий запрос автоматически после ошибки. Ошибка не гарантирует, что изменения не были сохранены: сначала получите состояние заявки запросом, описанным в разделе 3.4. Если результат создания заявки неизвестен, проверьте наличие заявки в ЛКК OFD.ru перед повторным запросом создания.
• При обращении в поддержку укажите метод, время запроса, идентификатор заявки и полученный ответ. Не передавайте AuthToken, пароль и лишние персональные данные.

В таблицах ошибок:

• «Не передается» – код или сообщение в ответе отсутствует;
• null – сообщение в ответе не задано; после сериализации параметр может отсутствовать;
• фигурные скобки обозначают переменную часть сообщения; текст в скобках не нужно передавать в запросе.

Столбец «Код ошибки» содержит значение параметра Errors[].Code. Значения в столбце «Сообщение об ошибке», похожие на код, остаются текстом сообщения и не являются отдельным публичным кодом ошибки.

Ошибки адреса запроса, неподдерживаемого HTTP-метода, заголовка Content-Type, разбора JSON и преобразования типов могут возникнуть до выполнения метода API. Их формат может отличаться от общего формата ответа с ошибкой. Проверьте адрес, метод, заголовок Content-Type: application/json, корректность JSON и типы передаваемых значений.

Ошибки из таблицы 1 возможны для запросов создания, изменения, подготовки для подписи, подписи и проверки статуса заявки. Ошибки каждого запроса описаны в соответствующих разделах.

Таблица 1. Общие ошибки запросов работы с заявкой

В разделе представлена общая JSON-схема заявки, описание параметров, а также описаны действия перед началом работы с API сервиса авторегистрации в ФНС.

Чтобы неоднократно обращаться к API сервису авторегистрации в ФНС без использования механизма Cookies, вам необходимо воспользоваться методом получения AuthToken. Метод AuthToken - это метод авторизации в OFD.ru с передачей имени и пароля, а также получения кода авторизации для использования в запросах API сервиса авторегистрации в ФНС . Успешным ответом является возвращение кода авторизации.
Код авторизации - это значение авторизации для обращения к личному кабинету (ЛК).

Вид запроса:

POST https://ofd.ru/api/Authorization/CreateAuthToken

Тело запроса представляет собой структуру JSON.

Структура запроса выглядит следующим образом:

POST https://ofd.ru/api/Authorization/CreateAuthToken
Content-Type: application/json

{
    "Login": "12345",
    "Password": "56789"
}

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

• Login;
• Password.

Значения параметров передаются в JSON-структуре внутри запроса.
Ваш логин и пароль от ЛКК OFD.ru являются значениями для запроса получения кода авторизации.

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

{
    "AuthToken": "0123456789abcdef0123456789abcdef",
    "ExpirationDateUtc": "2026-10-22T15:06:11"
}

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

• «AuthToken» – код авторизации. ¹⁾;
• «ExpirationDateUtc» – дата и время окончания действия кода авторизации в UTC (UTC+0). Значение передается строкой в формате «ГГГГ-ММ-ДДTчч:мм:сс» без указания смещения часового пояса. Интерпретируйте это значение как UTC. ^{2) 3)}:
  ГГГГ - год даты, 4 цифры,
  ММ - месяц даты, 2 цифры,
  ДД - день даты, 2 цифры,
  T - заглавная латинская буква “T”, используется как разделитель даты и времени,
  чч - часы, 2 цифры,
  мм - минуты, 2 цифры,
  сс - секунды, 2 цифры.

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

Используйте полученный код авторизации повторно до истечения срока его действия. Частота запросов на получение кода авторизации ограничена: при превышении ограничения возвращается ошибка с кодом 429.

Для метода получения AuthToken действуют ограничения: не более 3 запросов в минуту и не более 120 запросов в час с одного IP-адреса. Если несколько экземпляров интеграции используют один адрес для исходящих запросов, ограничение применяется к их общей частоте запросов.

Пример запроса с использованием кода авторизации:

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

Code – действующий код авторизации.

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

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

Таблица 2. Ошибки запроса получения AuthToken

В ответах с кодом 400 без сообщения и с кодом 403 параметры AuthToken и ExpirationDateUtc не заполнены, код и сообщение об ошибке не передаются. Ответ с сообщением Validation error содержит параметры «Success» и «Message». При ответе 429 сократите частоту запросов и повторите запрос позже. Если сервер передал заголовок Retry-After, используйте указанную в нём задержку.

Параметры заявок на регистрацию, перерегистрацию и снятие с учета передается в 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": uuid,
            "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,
        "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
},

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

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

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

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

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

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

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

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

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

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

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

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

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

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

POST api/integration/v1/kkt/registration?AuthToken={Code}

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

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

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

POST https://ofd.ru/api/integration/v1/kkt/registration?AuthToken=fefdbc065e2747b0922e04cb2efabf2c
Content-Type: application/json

{
    "Purpose": "InitialRegistration",
    "CompanyDetails":
    {
        "Inn":"7709125605",
        "Kpp":"770901001"
    },
    "KktDetails":
    {
        "SerialNumber": "1077095781",
        "FnNumber": "9287440300783573",
        "Model": "АТОЛ 42ФС",
        "InstallmentAddress":
        {
            "FullAddress": "Москва, Ленинская Слобода, 19"
        },
        "InstallmentPlace": "Магазин №1",
        "UsageMode":
        {
            "Internet": true,
            "Gambling": false,
            "Lottery": false,
            "Agent": false,
            "AutomatedDevice": false,
            "Mobile": false,
            "Banking": false,
            "ExcisableGoods": false,
            "FormsForReports": false
        },
        "FormatVersion": 3
    }
}

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

{
    "Data": {
        "Id": "dce50538-ee9b-4378-990c-66824ef3815c",
        "CompanyDetails": {
            "Director": {},
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "FullAddress": ""
            },
            "Inn": "7709125605",
            "Kpp": "770901001",
            "Signatory": {
                "Email": "skripchuk@ofd.ru",
                "Phone": "9165497297",
                "IsRepresent": false,
                "RepresentativeDetails": {}
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300783573",
            "InstallmentAddress": {
                "FullAddress": "Москва, Ленинская Слобода, 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "АТОЛ 42ФС",
            "SerialNumber": "1077095781",
            "FiscalDocumentData": {},
            "ClosedFnDetails": {},
            "InstalledFnDetails": {}
        },
        "AutomaticDevices": [],
        "Status": "New",
        "Stage": "Initialization",
        "CanDelete": true,
        "Documents": [],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "628ae9fc-edaa-43fd-ba93-f556e3ed841f",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "NotStarted",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "628ae9fc-edaa-43fd-ba93-f556e3ed841f",
            "CreatedDate": "2021-07-30T11:23:53",
            "UpdatedDate": "2021-08-04T12:15:38",
            "Number": "1121126811",
            "LegalAddress": {
                "PostalCode": "109004",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Земляной Вал",
                "HouseNumber": "д 73",
                "FullAddress": "г Москва, ул Земляной Вал, д 73"
            },
            "PostalAddress": {
                "FullAddress": ""
            },
            "Inn": "7709125605",
            "Ogrn": "1027700200494",
            "Kpp": "770901001",
            "CompanyName": "ФГБОУ ВО \"МГУТУ ИМ. К.Г. РАЗУМОВСКОГО (ПКУ)\"",
            "Signatory": {
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "StatusChangeDateUtc": "2021-11-29T14:25:45",
        "CDateUtc": "2021-11-29T14:25:45",
        "UDateUtc": "2021-11-29T14:25:45",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=dce50538-ee9b-4378-990c-66824ef3815c&format=pdf",
        "CanBeAutomaticDevice": false
    },
    "Success": true
}

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

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

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

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

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

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

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

Ошибки запроса на создание заявки, в том числе заявки с МЧД, приведены в таблице 16. Также возможны общие ошибки из таблицы 1 раздела 1.

Таблица 16. Ошибки запроса на создание заявки

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

Заявка на регистрацию/перерегистрацию, снятие с учета с использованием МЧД выполняется методом описанным в разделе 3.1.

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

{
    "Purpose": "InitialRegistration",
    "CompanyDetails":
    {
        "Inn":"5252012620",
        "Kpp":"525201001",
        "Signatory": {
          "RepresentativeDetails": {
                "Number":"- номер МЧД",
                "EvaluateDate":"- дата МЧД",
                "DocId": "- ID МЧД"
            }
        }
    },
    "KktDetails":
    {
        "SerialNumber": "1201014072",
        "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
    }
}

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

Возможные ошибки приведены в таблице 16 раздела 3.1.

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

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

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

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

POST api/integration/v1/kkt/registration/{id:uuid}/prepareDocuments?AuthToken={authToken}

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

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

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

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

POST https://ofd.ru/api/integration/v1/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",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "АТОЛ 42ФС",
            "SerialNumber": "1077095781",
            "FiscalDocumentData": {},
            "FnsBranchCode": "7725",
            "ClosedFnDetails": {},
            "InstalledFnDetails": {}
        },
        "AutomaticDevices": [],
        "Status": "AwaitingSignature",
        "Stage": "Initialization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "c536906e-535f-454a-a732-d5519d01fdd1",
                "Kind": "1110061",
                "Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIgICAgICAgPC/R4uXkwOTwzNPx8j4KICAgI
                CAgICAgICAgPC/R4uXk0OXjysrSPgogICAgICAgIDwvx+D/4t.................",
                "Signature": "Unsigned",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_ZVLREGKKT_7725_0278_0278199519366401001_20211129_275bc3f7ca5c40a783424ee129a8c420"
            }
        ],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "NotStarted",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
            "CreatedDate": "2017-03-23T10:42:50",
            "UpdatedDate": "2021-10-15T10:07:58",
            "Number": "0708200414",
            "LegalAddress": {
                "City": "г Воронеж",
                "PostalCode": "394030",
                "RegionCode": "36",
                "Region": "Воронежская обл",
                "Street": "ул Бакунина",
                "HouseNumber": "1",
                "FullAddress": "394030, ул Бакунина, 1"
            },
            "PostalAddress": {
                "City": "г Воронеж",
                "PostalCode": "394030",
                "RegionCode": "36",
                "Region": "Воронежская обл",
                "Street": "ул Бакунина",
                "HouseNumber": "1",
                "FullAddress": "394030, ул Бакунина, 1"
            },
            "Inn": "0278199519",
            "Ogrn": "1053600591197",
            "Kpp": "366401001",
            "CompanyName": "ООО \"ПРИМЕР\"",
            "Signatory": {
                "Name": "Ященко Юлия",
                "Position": "",
                "Email": "salikhov@ofd.ru",
                "IsRepresent": false
            },
            "IsNdsPayer": false,
            "ElectronicInvoicingType": "Other",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "MPIHEJL1",
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": true,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "StatusChangeDateUtc": "2021-11-29T16:12:49",
        "CDateUtc": "2021-11-29T16:11:43",
        "UDateUtc": "2021-11-29T16:12:49",
        "UserAccountId": "56805d98-6a0a-4148-8a1a-f0072cf7d32f",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=4d5d5574-433d-4c3f-afd7-3b3c39595d33&format=pdf",
        "CanBeAutomaticDevice": false
    },
    "Success": true
}

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

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

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

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

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

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

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

Ошибки запроса на подготовку заявки для подписи приведены в таблице 23. Также возможны общие ошибки из таблицы 1 раздела 1.

Таблица 23. Ошибки запроса на подготовку заявки для подписи

Успешный ответ на запрос подготовки не означает, что документы уже готовы к подписи. Перед запросом подписи убедитесь, что заявка имеет статус AwaitingSignature, а в параметре Documents есть документ для подписи.

В сообщении Missing_{путь к параметру} указан путь к первому обнаруженному незаполненному параметру заявки. Все сообщения из таблицы 24 возвращаются с кодом ответа 400 и кодом ошибки InternalError.

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

Если вложенная структура (например, InstallmentAddress) не передана, вместо ошибки Missing_{путь к параметру} может вернуться другая ошибка. Передавайте необходимые структуры в запросе целиком.

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

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

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

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

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

POST api/integration/v1/kkt/registration/{id:uuid}/sign?AuthToken={authToken}

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

• id:uuid - идентификатор заявки. Обязательный параметр.
• Code – действующий код авторизации.

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

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

Параметр Signature в теле запроса содержит подпись в формате base64. Не путайте его с параметром Documents[].Signature в ответах API: в структуре Documents этот параметр содержит только статус подписи NotNeeded, Unsigned или Signed.

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

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

POST https://ofd.ru/api/integration/v1/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",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867279",
            "FiscalDocumentData": {},
            "FnsBranchCode": "7725",
            "ClosedFnDetails": {},
            "InstalledFnDetails": {}
        },
        "AutomaticDevices": [],
        "Status": "ProcessingSignedDocuments",
        "Stage": "Initialization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "aaf0ba41-be2f-41f8-9267-f827194d8786",
                "Kind": "1110061",
                "Signature": "Signed",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_ZVLREGKKT_7725_0278_0278199519366401001_20211203_1bfc0e7c1c4f4195898b5e452ff3492e"
            }
        ],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "NotStarted",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
            "CreatedDate": "2017-03-23T10:42:50",
            "UpdatedDate": "2021-10-15T10:07:58",
            "Number": "0708200414",
            "LegalAddress": {
                "City": "г Воронеж",
                "PostalCode": "394030",
                "RegionCode": "36",
                "Region": "Воронежская обл",
                "Street": "ул Бакунина",
                "HouseNumber": "1",
                "FullAddress": "394030, ул Бакунина, 1"
            },
            "PostalAddress": {
                "City": "г Воронеж",
                "PostalCode": "394030",
                "RegionCode": "36",
                "Region": "Воронежская обл",
                "Street": "ул Бакунина",
                "HouseNumber": "1",
                "FullAddress": "394030, ул Бакунина, 1"
            },
            "Inn": "0278199519",
            "Ogrn": "1053600591197",
            "Kpp": "366401001",
            "CompanyName": "ООО \"ПРИМЕР\"",
            "Signatory": {
                "Name": "Ященко Юлия",
                "Position": "",
                "Email": "salikhov@ofd.ru",
                "IsRepresent": false
            },
            "IsNdsPayer": false,
            "ElectronicInvoicingType": "Other",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "MPIHEJL1",
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": true,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "StatusChangeDateUtc": "2021-12-03T10:02:58",
        "CDateUtc": "2021-12-03T09:59:03",
        "UDateUtc": "2021-12-03T10:02:58",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=1b21cac3-2b85-404a-b147-7f3bbd6827a5&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

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

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

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

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

Ошибки запроса на передачу в ФНС подписанной заявки приведены в таблице 29. Также возможны общие ошибки из таблицы 1 раздела 1.

Таблица 29. Ошибки запроса на передачу в ФНС подписанной заявки

После ошибки отправки подписи всегда проверяйте состояние заявки. Не отправляйте подпись повторно автоматически. Успешный ответ на запрос подписи не означает, что касса зарегистрирована в ФНС: результат проверяйте запросом из раздела 3.4.

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

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

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

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

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

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

Известные сетевые тайм-ауты при взаимодействии с ФНС: подключение к ФНС — 5 секунд, ожидание ответа ФНС — 30 секунд. Повторяемыми считаются временная недоступность сервиса, внутренние ошибки ФНС, ошибки 5xx и некоторые ошибки авторизации сервиса.

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

GET api/integration/v1/kkt/registration/{id:uuid}?AuthToken={authToken:string}

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

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

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

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

GET https://ofd.ru/api/integration/v1/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",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867279",
            "FiscalDocumentData": {},
            "FnsBranchCode": "7725",
            "ClosedFnDetails": {},
            "InstalledFnDetails": {}
        },
        "AutomaticDevices": [],
        "Status": "Rejected",
        "Stage": "Initialization",
        "CanDelete": false,
        "Documents": [],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "NotStarted",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "ff2e85e6-9302-4188-91b6-55ecb4f91fbf",
            "CreatedDate": "2017-03-23T10:42:50",
            "UpdatedDate": "2021-10-15T10:07:58",
            "Number": "0708200414",
            "LegalAddress": {
                "City": "г Воронеж",
                "PostalCode": "394030",
                "RegionCode": "36",
                "Region": "Воронежская обл",
                "Street": "ул Бакунина",
                "HouseNumber": "1",
                "FullAddress": "394030, ул Бакунина, 1"
            },
            "PostalAddress": {
                "City": "г Воронеж",
                "PostalCode": "394030",
                "RegionCode": "36",
                "Region": "Воронежская обл",
                "Street": "ул Бакунина",
                "HouseNumber": "1",
                "FullAddress": "394030, ул Бакунина, 1"
            },
            "Inn": "0278199519",
            "Ogrn": "1053600591197",
            "Kpp": "366401001",
            "CompanyName": "ООО \"ПРИМЕР\"",
            "Signatory": {
                "Name": "Ященко Юлия",
                "Position": "",
                "Email": "salikhov@ofd.ru",
                "IsRepresent": false
            },
            "IsNdsPayer": false,
            "ElectronicInvoicingType": "Other",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "MPIHEJL1",
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": true,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "StatusReason": "Ошибка проверки ЮЛ/ИП с данными {inn=0278199519, ogrn=1053600591197}: Заявитель не идентифицирован. Просьба обратиться в Службу Технической Поддержки ФНС России или ближайший ТНО.",
        "StatusChangeDateUtc": "2021-12-03T10:05:02",
        "CDateUtc": "2021-12-03T09:59:03",
        "UDateUtc": "2021-12-03T10:05:02",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "ResultDocs": [],
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=1b21cac3-2b85-404a-b147-7f3bbd6827a5&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Пример ответа на запрос статуса заявки, со ссылкой на документ с ответом от ФНС о присвоении РНМ:

{
    "Data": {
        "Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false,
                "RepresentativeDetails": {}
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300784224",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867358",
            "FiscalDocumentData": {},
            "RegNumber": "0000002950038403",
            "FnsBranchCode": "7725",
            "ClosedFnDetails": {},
            "InstalledFnDetails": {},
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "New",
        "Stage": "Finalization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "5de805db-d44b-4f7b-af93-1ff4028125d4",
                "Kind": "1110061",
                "Signature": "Signed",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_ZVLREGKKT_7725_5252_5252012620525201001_20211216_35fd55f7006140bfba42c1139372ce5f"
            }
        ],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T09:20:14",
        "CDateUtc": "2021-12-16T09:02:14",
        "UDateUtc": "2021-12-16T09:20:14",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "ResultDocs": [
            {
                "KktId": 16840,
                "ReportTypeId": 50,
                "DocType": "RnmReport",
                "ConversationUuid": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
                "ReportSizeInBytes": 114984,
                "FileType": "application/pdf",
                "DownloadUri": "https://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
}

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

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

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

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

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

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

Ошибки запроса проверки статуса заявки приведены в таблице 35. Также возможны общие ошибки из таблицы 1 раздела 1.

Таблица 35. Ошибки запроса проверки статуса заявки

Ответ с кодом 200 и статусом заявки Rejected не является ошибкой запроса: это результат обработки заявки. Если описание причины отказа доступно, оно указано в параметре StatusReason; параметр может отсутствовать.

Отказ ФНС является результатом обработки заявки, а не ошибкой выполнения запроса API. Сервер возвращает код HTTP 200, значение Success = true и следующие параметры в структуре Data:

• Status со значением Rejected;
• StatusReason с текстовым описанием причины отказа, если оно доступно; параметр может отсутствовать.

Сокращенный пример ответа:

{
    "Data": {
        "Status": "Rejected",
        "StatusReason": "данная ККТ уже зарегистрирована в налоговых органах"
    },
    "Success": true
}

Если параметр StatusReason передан, он содержит готовую текстовую расшифровку ФНС. Обрабатывайте и сохраняйте значение целиком. Не извлекайте из текста числовой код и не сопоставляйте сообщение с локальным справочником: формулировка причины может измениться. Параметр StatusReason может отсутствовать.

При получении отказа:

• сохраните идентификатор заявки, значения Status и StatusChangeDateUtc, а также StatusReason и сведения о документах из ResultDocs, если они переданы;
• не повторяйте запрос подписи и не создавайте дубликат заявки автоматически;
• если StatusReason передан, покажите его пользователю или передайте в систему обработки заявок и устраните указанную причину отказа;
• если StatusReason отсутствует или его текст не позволяет определить дальнейшие действия, обратитесь в поддержку и передайте идентификатор заявки, время получения ответа и текст StatusReason, если он присутствует.

Если документы ответа ФНС доступны, они передаются в массиве ResultDocs как при успешной обработке заявки, так и при отказе. Массив может быть пустым.

Для скачивания файла используйте параметр ResultDocs[].DownloadUri. Тип документа указан в параметре ResultDocs[].DocType; отказу соответствуют значения RnmRejection, RegRejection, ReRegRejection или UnRegRejection.

Если ResultDocs пуст, ссылка на файл ответа в текущем ответе не передана. Не используйте другую ссылку как замену; при необходимости получить файл обратитесь в поддержку.

Параметр Data.DownloadUri содержит ссылку на печатную форму заявления и не является ссылкой на файл ответа ФНС.

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

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

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

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

PUT /api/integration/v1/kkt/registration/{id:uuid}?AuthToken={authToken}

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

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

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

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

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

PUT https://ofd.ru/api/integration/v1/kkt/registration/4121f0e0-f468-48fc-9387-b6a2d5646bc5?AuthToken=8dd69254b0444a1cbd103f80012cf1bb6
Content-Type: application/json

{
    "KktDetails":
    {
        "FiscalDocumentData": {
            "DateTime": "2021-12-09T00:00:00",
            "DocumentNumber": "1",
            "Signature": "12345"
        }
    }
}

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

{
    "Data": {
        "Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false,
                "RepresentativeDetails": {}
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300784224",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867358",
            "FiscalDocumentData": {
                "DateTime": "2021-12-16T00:00:00",
                "DocumentNumber": "1",
                "Signature": "12345"
            },
            "RegNumber": "0000002950038403",
            "FnsBranchCode": "7725",
            "ClosedFnDetails": {},
            "InstalledFnDetails": {},
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "New",
        "Stage": "Finalization",
        "CanDelete": false,
        "Documents": [],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T09:20:14",
        "CDateUtc": "2021-12-16T09:02:14",
        "UDateUtc": "2021-12-16T09:27:37",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

Возможные ошибки приведены в таблице 36 раздела 3.8.

Подготовка отчета для подписи выполняется запросом описанным в разделе "3.2. Описание запроса на подготовку заявки для подписи".

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

https://ofd.ru/api/integration/v1/kkt/registration/4121f0e0-f468-48fc-9387-b6a2d5646bc5/prepareDocuments?AuthToken=8dd69254b0444a1cbd103f80012cf1bb6
Content-Type: application/json
{
  "GivenName": "Алла Романовна",
  "LastName": "Романова",
  "Position": "ТестДолжность"
}

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

{
    "Data": {
        "Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300784224",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867358",
            "FiscalDocumentData": {
                "DateTime": "2021-12-16T00:00:00",
                "DocumentNumber": "1",
                "Signature": "12345"
            },
            "RegNumber": "0000002950038403",
            "FnsBranchCode": "7725",
            "ClosedFnDetails": {},
            "InstalledFnDetails": {},
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "AwaitingSignature",
        "Stage": "Finalization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "0cf2502a-a03b-4431-a73b-eec10c15bda1",
                "Kind": "1110061",
                "Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIiBzdGFuZGFsb25lPSJ5ZXMiPz4KPNTg6esgyOTU4OnrPSJLT19PVENIUkVHS0t........",
                "Signature": "Unsigned",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_OTCHREGKKT_7725_5252_5252012620525201001_20211216_5636afc3345847b68cd5bde3f3408af8"
            }
        ],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T09:27:52",
        "CDateUtc": "2021-12-16T09:02:14",
        "UDateUtc": "2021-12-16T09:27:52",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

Возможные ошибки приведены в таблицах 23 и 24 раздела 3.2.

Чтобы подписать и отправить в ФНС данные из отчета о регистрации, необходимо воспользоваться запросом описанным в разделе 3.3. Описание выполнения запроса на передачу в ФНС подписанной заявки.

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

POST https://ofd.ru/api/integration/v1/kkt/registration/1b21cac3-2b85-404a-b147-7f3bbd6827a5/sign?AuthToken=d191800efd1c4b0ba70ef05b95a9a582
Content-Type: application/json
{
    "DocumentId": "0cf2502a-a03b-4431-a73b-eec10c15bda1",
    "Signature": "MIAGCSqGSIb3DQEHAqCAMIACAQExDjAMBggqhQMHAQECAwUAMIAGCSqGSIb3DQEHAQAAoIIJOTCCCTUwggjioAMCAQICEQPjTaYArK2tpkENF6N6aVknMAoGC........"
}

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

{
    "Data": {
        "Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300784224",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867358",
            "FiscalDocumentData": {
                "DateTime": "2021-12-16T00:00:00",
                "DocumentNumber": "1",
                "Signature": "12345"
            },
            "RegNumber": "0000002950038403",
            "FnsBranchCode": "7725",
            "ClosedFnDetails": {},
            "InstalledFnDetails": {},
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "ProcessingSignedDocuments",
        "Stage": "Finalization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "0cf2502a-a03b-4431-a73b-eec10c15bda1",
                "Kind": "1110061",
                "Signature": "Signed",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_OTCHREGKKT_7725_5252_5252012620525201001_20211216_5636afc3345847b68cd5bde3f3408af8"
            }
        ],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T09:39:45",
        "CDateUtc": "2021-12-16T09:02:14",
        "UDateUtc": "2021-12-16T09:39:45",
        "UserAccountId": "2ec4e129-965c-40bf-a499-9081513205a6",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 25 в разделе 3.3. Описание выполнения запроса на передачу в ФНС подписанной заявки.

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

Чтобы получить ответ от ФНС о статусе заявки вам нужно воспользоваться запросом описанным в разделе "3.4. Описание запроса проверки статуса заявки"

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

GET https://ofd.ru/api/integration/v1/kkt/registration/81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c?AuthToken=d191800efd1c4b0ba70ef05b95a9a582

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

{
    "Data": {
        "Id": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false,
                "RepresentativeDetails": {}
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300784224",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867358",
            "FiscalDocumentData": {
                "DateTime": "2021-12-16T00:00:00",
                "DocumentNumber": "1",
                "Signature": "12345"
            },
            "RegNumber": "0000002950038403",
            "FnsBranchCode": "7725",
            "ClosedFnDetails": {},
            "InstalledFnDetails": {},
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "SentToFns",
        "Stage": "Finalization",
        "CanDelete": false,
        "Documents": [],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T09:40:19",
        "CDateUtc": "2021-12-16T09:02:14",
        "UDateUtc": "2021-12-16T09:40:19",
        "UserAccountId": "2ec4e129-965c-40bf-a499-9081513205a6",
        "ResultDocs": [
            {
                "KktId": 16840,
                "ReportTypeId": 100,
                "DocType": "RegReport",
                "ConversationUuid": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
                "ReportSizeInBytes": 125002,
                "FileType": "application/pdf",
                "DownloadUri": "https://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
}

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

Возможные ошибки приведены в таблице 35 раздела 3.4.

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

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

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

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

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

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

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

https://ofd.ru/api/integration/v1/kkt/registration?AuthToken=ecca6a6949e848089bbecc8a97951734
Content-Type: application/json
 {
    "Purpose": "Reregistration",
    "CompanyDetails":
    {
        "Inn":"5252012620",
        "Kpp":"525201001"
    },
    "KktDetails":
    {
        "SerialNumber": "00307404867291",
        "RegNumber": "0000002928049035",
        "FnNumber": "9287440300787014",
        "Model": "ЭВОТОР СТ2Ф",
                "InstallmentAddress":
        {
            "FullAddress": "Москва, Ленинская Слобода, 19"
        },
        "InstallmentPlace": "Магазин №1",
        "FormatVersion": 3,
        "ReregistrationReasons": {
            "FnChanged": true
        },
        "ClosedFnDetails": {
            "FdDateTime": "2021-12-16T13:55:55",
            "FdNumber": "12345",
            "FpValue": "12345"
        },
        "InstalledFnDetails": {
            "FdDateTime": "2021-12-16T17:14:00",
            "FdNumber": "1",
            "FpValue": "12345"
        },
        "UsageMode":
        {
            "Internet": false,
            "Gambling": false,
            "Lottery": false,
            "Agent": false,
            "AutomatedDevice": false,
            "Mobile": false,
            "Banking": false,
            "ExcisableGoods": false,
            "FormsForReports": false
        }
    }
}

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

{
    "Data": {
        "Id": "c76b003e-36de-4db6-af87-ad91e67ba042",
        "CompanyDetails": {
            "Director": {},
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "FullAddress": ""
            },
            "Inn": "5252012620",
            "Kpp": "525201001",
            "Signatory": {
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false,
                "RepresentativeDetails": {}
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300787014",
            "InstallmentAddress": {
                "FullAddress": "Москва, Ленинская Слобода, 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": false,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867291",
            "FiscalDocumentData": {},
            "RegNumber": "0000002928049035",
            "ReregistrationReasons": {
                "AutomatedDeviceChanged": false,
                "FnChanged": true,
                "InstallmentPlaceChanged": false,
                "OfdChaged": false,
                "Other": false,
                "SwitchedFromOfflineToOnlineMode": false,
                "SwitchedFromOnlineToOfflineMode": false,
                "UserChanged": false
            },
            "ClosedFnDetails": {
                "FdDateTime": "2021-12-16T13:55:55",
                "FdNumber": "12345",
                "FpValue": "12345"
            },
            "InstalledFnDetails": {
                "FdDateTime": "2021-12-16T17:14:00",
                "FdNumber": "1",
                "FpValue": "12345"
            },
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "New",
        "Stage": "Initialization",
        "CanDelete": true,
        "FiscalDocuments": [],
        "Documents": [],
        "Purpose": "Reregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-22T12:16:01",
        "CDateUtc": "2021-12-22T12:16:01",
        "UDateUtc": "2021-12-22T12:16:03",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

Возможные ошибки приведены в таблице 16 раздела 3.1.

Подготовка заявки на перерегистрацию кассы для подписи выполняется запросом описанным в разделе 3.2. Описание запроса на подготовку заявки для подписи.

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

https://ofd.ru/api/integration/v1/kkt/registration/c76b003e-36de-4db6-af87-ad91e67ba042/prepareDocuments?AuthToken=ecca6a6949e848089bbecc8a97951734
Content-Type: application/json

{
  "GivenName": "Алла Романовна",
  "LastName": "Романова",
  "Position": "ТестДолжность"
}

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

{
    "Data": {
        "Id": "c76b003e-36de-4db6-af87-ad91e67ba042",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300787014",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": false,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867291",
            "FiscalDocumentData": {},
            "RegNumber": "0000002928049035",
            "FnsBranchCode": "7725",
            "ReregistrationReasons": {
                "AutomatedDeviceChanged": false,
                "FnChanged": true,
                "InstallmentPlaceChanged": false,
                "OfdChaged": false,
                "Other": false,
                "SwitchedFromOfflineToOnlineMode": false,
                "SwitchedFromOnlineToOfflineMode": false,
                "UserChanged": false
            },
            "ClosedFnDetails": {
                "FdDateTime": "2021-12-16T13:55:55",
                "FdNumber": "12345",
                "FpValue": "12345"
            },
            "InstalledFnDetails": {
                "FdDateTime": "2021-12-16T17:14:00",
                "FdNumber": "1",
                "FpValue": "12345"
            },
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "AwaitingSignature",
        "Stage": "Initialization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "012fad42-0e31-4c10-8a9f-098709374c91",
                "Kind": "1110061",
                "Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0.......................",
                "Signature": "Unsigned",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_ZVLREGKKT_7725_5252_5252012620525201001_20211222_d44dd8f5e75b44c286d4045361b0a741"
            }
        ],
        "Purpose": "Reregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-22T12:18:10",
        "CDateUtc": "2021-12-22T12:16:01",
        "UDateUtc": "2021-12-22T12:18:10",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

Возможные ошибки приведены в таблицах 23 и 24 раздела 3.2.

Чтобы подписать и отправить отчет заявки на перерегистрацию кассы в ФНС необходимо воспользоваться запросом описанным в разделе 3.3. Описание выполнения запроса на передачу в ФНС подписанной заявки.

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

POST https://ofd.ru/api/integration/v1/kkt/registration/c76b003e-36de-4db6-af87-ad91e67ba042/sign?AuthToken=ecca6a6949e848089bbecc8a97951734
Content-Type: application/json

{
    "DocumentId": "012fad42-0e31-4c10-8a9f-098709374c91",
    "Signature": "MIAGCSqGSIb3DQEHAqCAMIACAQExDjAMBggqhQMHAQECAwUAMIAGCSqGSIb3.............."
}

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

{
    "Data": {
        "Id": "c76b003e-36de-4db6-af87-ad91e67ba042",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300787014",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": false,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867291",
            "FiscalDocumentData": {},
            "RegNumber": "0000002928049035",
            "FnsBranchCode": "7725",
            "ReregistrationReasons": {
                "AutomatedDeviceChanged": false,
                "FnChanged": true,
                "InstallmentPlaceChanged": false,
                "OfdChaged": false,
                "Other": false,
                "SwitchedFromOfflineToOnlineMode": false,
                "SwitchedFromOnlineToOfflineMode": false,
                "UserChanged": false
            },
            "ClosedFnDetails": {
                "FdDateTime": "2021-12-16T13:55:55",
                "FdNumber": "12345",
                "FpValue": "12345"
            },
            "InstalledFnDetails": {
                "FdDateTime": "2021-12-16T17:14:00",
                "FdNumber": "1",
                "FpValue": "12345"
            },
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "ProcessingSignedDocuments",
        "Stage": "Initialization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "012fad42-0e31-4c10-8a9f-098709374c91",
                "Kind": "1110061",
                "Signature": "Signed",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_ZVLREGKKT_7725_5252_5252012620525201001_20211222_d44dd8f5e75b44c286d4045361b0a741"
            }
        ],
        "Purpose": "Reregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-22T12:28:01",
        "CDateUtc": "2021-12-22T12:16:01",
        "UDateUtc": "2021-12-22T12:28:01",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 25 в разделе 3.3. Описание выполнения запроса на передачу в ФНС подписанной заявки.

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

Чтобы получить ответ от ФНС о статусе заявки вам нужно воспользоваться запросом описанным в разделе 3.4. Описание запроса проверки статуса заявки

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

GET https://ofd.ru/api/integration/v1/kkt/registration/c76b003e-36de-4db6-af87-ad91e67ba042?AuthToken=ecca6a6949e848089bbecc8a97951734

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

{
    "Data": {
        "Id": "c76b003e-36de-4db6-af87-ad91e67ba042",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false,
                "RepresentativeDetails": {}
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300787014",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": false,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867291",
            "FiscalDocumentData": {},
            "RegNumber": "0000002928049035",
            "FnsBranchCode": "7725",
            "ReregistrationReasons": {
                "AutomatedDeviceChanged": false,
                "FnChanged": true,
                "InstallmentPlaceChanged": false,
                "OfdChaged": false,
                "Other": false,
                "SwitchedFromOfflineToOnlineMode": false,
                "SwitchedFromOnlineToOfflineMode": false,
                "UserChanged": false
            },
            "ClosedFnDetails": {
                "FdDateTime": "2021-12-16T13:55:55",
                "FdNumber": "12345",
                "FpValue": "12345"
            },
            "InstalledFnDetails": {
                "FdDateTime": "2021-12-16T17:14:00",
                "FdNumber": "1",
                "FpValue": "12345"
            },
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "SentToFns",
        "Stage": "Initialization",
        "CanDelete": false,
        "FiscalDocuments": [],
        "Documents": [],
        "Purpose": "Reregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-22T12:30:18",
        "CDateUtc": "2021-12-22T12:16:01",
        "UDateUtc": "2021-12-22T12:30:19",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "ResultDocs": [
            {
                "KktId": 16880,
                "ReportTypeId": 101,
                "DocType": "ReRegReport",
                "ConversationUuid": "c76b003e-36de-4db6-af87-ad91e67ba042",
                "ReportSizeInBytes": 124914,
                "FileType": "application/pdf",
                "DownloadUri": "https://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
}

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

Возможные ошибки приведены в таблице 35 раздела 3.4.

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

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

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

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

1. Создание заявки. Раздел "3.7.1. Создание заявки на снятие с учета".
2. Подготовка к подписи. Раздел "3.7.2. Подготовка заявки на снятие с учета кассы для подписи".
3. Подписание и отправка в ФНС. Раздел"3.7.3. Подпись и отправка в ФНС заявки на снятие с учета кассы".
4. Получение ответа от ФНС. Раздел "3.7.4. Проверка статуса заявки на снятие с учета кассы".

Создание заявки на снятие с учета кассы выполняется запросом описанным в разделе 3.1. Описание запроса на создание заявки.

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

POST https://ofd.ru/api/integration/v1/kkt/registration?AuthToken=fefdbc065e2747b0922e04cb2efabf2c
Content-Type: application/json

{
    "Purpose": "Unregistration",
    "CompanyDetails":
    {
        "Inn":"5252012620",
        "Kpp":"525201001"
    },
    "KktDetails":
    {
        "SerialNumber": "00307404867347",
        "RegNumber": "0000002947022927",
        "FnNumber": "9287440300784236",
        "Model": "ЭВОТОР СТ2Ф",
                "InstallmentAddress":
        {
            "FullAddress": "Москва, Ленинская Слобода, 19"
        },
        "InstallmentPlace": "Магазин №1",
        "UsageMode":
        {
            "Internet": true,
            "Gambling": false,
            "Lottery": false,
            "Agent": false,
            "AutomatedDevice": false,
            "Mobile": false,
            "Banking": false,
            "ExcisableGoods": false,
            "FormsForReports": false
        },
        "FormatVersion": 3,
        "UnregistrationReasons": {
            "Lost": true
        }
    }
}

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

{
    "Data": {
        "Id": "3c8cdf17-5286-44df-bf9b-48b32cd10e5c",
        "CompanyDetails": {
            "Director": {},
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "FullAddress": ""
            },
            "Inn": "5252012620",
            "Kpp": "525201001",
            "Signatory": {
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false,
                "RepresentativeDetails": {}
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "00307404867347",
            "InstallmentAddress": {
                "FullAddress": ""
            },
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": false,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "9287440300784236",
            "FiscalDocumentData": {},
            "RegNumber": "0000002947022927",
            "UnregistrationReasons": {
                "Lost": true,
                "Stolen": false,
                "Broken": false
            },
            "ClosedFnDetails": {},
            "InstalledFnDetails": {}
        },
        "AutomaticDevices": [],
        "Status": "New",
        "Stage": "Initialization",
        "CanDelete": true,
        "Documents": [],
        "Purpose": "Unregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T11:47:24",
        "CDateUtc": "2021-12-16T11:47:24",
        "UDateUtc": "2021-12-16T11:47:25",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=3c8cdf17-5286-44df-bf9b-48b32cd10e5c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

Возможные ошибки приведены в таблице 16 раздела 3.1.

Подготовка заявки на снятие с учета кассы для подписи выполняется запросом описанным в разделе 3.2. Описание запроса на подготовку заявки для подписи

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

POST https://ofd.ru/api/integration/v1/kkt/registration/b9e0ff67-eae4-4d7b-b637-68df3999e7fb/prepareDocuments?AuthToken=8dd69254b0444a1cbd103f80012cf1bb6
Content-Type: application/json

{
  "GivenName": "Алла Романовна",
  "LastName": "Романова",
  "Position": "ТестДолжность"
}

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

{
    "Data": {
        "Id": "b9e0ff67-eae4-4d7b-b637-68df3999e7fb",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300784236",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода",
                "HouseNumber": "д 19",
                "FiasCode": "8ff65e61-b815-40e6-92cf-17a9678b3d0e",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867347",
            "FiscalDocumentData": {},
            "RegNumber": "0000002947022927",
            "FnsBranchCode": "7725",
            "UnregistrationReasons": {
                "Lost": true,
                "Stolen": false,
                "Broken": false
            },
            "ClosedFnDetails": {},
            "InstalledFnDetails": {},
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "AwaitingSignature",
        "Stage": "Initialization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "c98b46dd-2780-4006-bc71-c67e6483de46",
                "Kind": "1110061",
                "Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIiBzdGFuZGFsb25lP..................",
                "Signature": "Unsigned",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_ZVLSNUCHKKT_7725_7725_5252012620525201001_20211216_39fd922ee8574678a7e750f463cc15db"
            }
        ],
        "Purpose": "Unregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T12:32:33",
        "CDateUtc": "2021-12-16T12:32:15",
        "UDateUtc": "2021-12-16T12:32:33",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 25 в разделе 3.3. Описание выполнения запроса на передачу подписанного заявления в ФНС.

Возможные ошибки приведены в таблицах 23 и 24 раздела 3.2.

Чтобы подписать и отправить заявку на снятие с учета кассы в ФНС, необходимо воспользоваться запросом описанным в разделе 3.3. Описание выполнения запроса на передачу в ФНС подписанной заявки.

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

POST https://ofd.ru/api/integration/v1/kkt/registration/b9e0ff67-eae4-4d7b-b637-68df3999e7fb/sign?AuthToken=d191800efd1c4b0ba70ef05b95a9a582
Content-Type: application/json
{
    "DocumentId": "c98b46dd-2780-4006-bc71-c67e6483de46",
    "Signature": "MIAGCSqGSIb3DQEHAqCAMIACAQExDjAMBggqhQMHAQECAwUAMIAGCSqGSIb3DQEHAQAAoIIJOTCCCTUwggjioAMCAQICEQPjTaYArK2tpkEN.........."
}

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

{
    "Data": {
        "Id": "b9e0ff67-eae4-4d7b-b637-68df3999e7fb",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300784236",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "г Москва",
                "Street": "ул Ленинская Слобода"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867347",
            "FiscalDocumentData": {},
            "RegNumber": "0000002947022927",
            "FnsBranchCode": "7725",
            "UnregistrationReasons": {
                "Lost": true,
                "Stolen": false,
                "Broken": false
            },
            "ClosedFnDetails": {},
            "InstalledFnDetails": {},
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "ProcessingSignedDocuments",
        "Stage": "Initialization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "c98b46dd-2780-4006-bc71-c67e6483de46",
                "Kind": "1110061",
                "Signature": "Signed",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_ZVLSNUCHKKT_7725_7725_5252012620525201001_20211216_39fd922ee8574678a7e750f463cc15db"
            }
        ],
        "Purpose": "Unregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T12:37:04",
        "CDateUtc": "2021-12-16T12:32:15",
        "UDateUtc": "2021-12-16T12:37:04",
        "UserAccountId": "56805d98-6a0a-4148-8a1a-f0072cf7d32f",
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

Описание параметров ответа представлено в таблице 25 в разделе 3.3. Описание выполнения запроса на передачу в ФНС подписанной заявки.

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

Чтобы получить ответ от ФНС о статусе заявки вам нужно воспользоваться запросом описанным в разделе 3.4. Описание запроса проверки статуса заявки

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

GET https://ofd.ru/api/integration/v1/kkt/registration/b9e0ff67-eae4-4d7b-b637-68df3999e7fb?AuthToken=a70b4f0b575d4fe8a8931d929f601e37

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

{
    "Data": {
        "Id": "b9e0ff67-eae4-4d7b-b637-68df3999e7fb",
        "CompanyDetails": {
            "CompanyType": "LegalEntity",
            "Director": {
                "FirstName": "Алла",
                "LastName": "Романова",
                "MiddleName": "Романовна"
            },
            "FnsBranchCode": "5252",
            "CreatedDate": "0001-01-01T00:00:00",
            "UpdatedDate": "0001-01-01T00:00:00",
            "LegalAddress": {
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ТестДолжность",
                "Email": "skripchuk@ofd.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false,
                "RepresentativeDetails": {}
            },
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": false
        },
        "KktDetails": {
            "FnName": "Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2",
            "FnNumber": "9287440300784236",
            "InstallmentAddress": {
                "PostalCode": "115280",
                "RegionCode": "77",
                "Region": "Москва",
                "FullAddress": "115280, г Москва, ул Ленинская Слобода, д 19"
            },
            "InstallmentPlace": "Магазин №1",
            "UsageMode": {
                "Gambling": false,
                "Lottery": false,
                "Agent": false,
                "AutomatedDevice": false,
                "Internet": true,
                "Mobile": false,
                "Banking": false,
                "ExcisableGoods": false,
                "FormsForReports": false,
                "Marking": false
            },
            "Model": "ЭВОТОР СТ2Ф",
            "SerialNumber": "00307404867347",
            "FiscalDocumentData": {},
            "RegNumber": "0000002947022927",
            "FnsBranchCode": "7725",
            "UnregistrationReasons": {
                "Lost": true,
                "Stolen": false,
                "Broken": false
            },
            "ClosedFnDetails": {},
            "InstalledFnDetails": {},
            "FormatVersion": 3
        },
        "AutomaticDevices": [],
        "Status": "Approved",
        "Stage": "Finalization",
        "CanDelete": false,
        "Documents": [],
        "Purpose": "Unregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T13:40:28",
        "CDateUtc": "2021-12-16T12:32:15",
        "UDateUtc": "2021-12-16T13:40:28",
        "UserAccountId": "56805d98-6a0a-4148-8a1a-f0072cf7d32f",
        "ResultDocs": [],
        "DownloadUri": "https://ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

Возможные ошибки приведены в таблице 35 раздела 3.4.

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

PUT api/integration/v1/kkt/registration/{id:guid}

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

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

PUT api/integration/v1/kkt/registration/{id:guid}
{
    "CompanyDetails": {...},
    "KktDetails": {...},
    "AutomaticDevices": {...}
}

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

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

Ошибки запроса на изменение заявки, в том числе запроса на передачу данных из отчета о регистрации (раздел 3.5.1), приведены в таблице 36. Также возможны общие ошибки из таблицы 1 раздела 1.

Таблица 36. Ошибки запроса на изменение заявки

Несколько ошибок проверки структуры FiscalDocumentData могут быть возвращены в одном сообщении, разделенные переносом строки.

Внимание! При изменении структуры CompanyDetails передавайте актуальные значения всех реквизитов, в том числе КПП и должности подписанта: при передаче неполной структуры ранее заполненные параметры могут быть очищены. Передавайте корректный JSON с допустимыми значениями параметров и после изменения проверяйте сохраненные данные запросом проверки статуса заявки (раздел 3.4).

Запрос выполняется для получения списка заявок в ФНС с их текущими статусами. В ответ возвращаются заявки на:

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

Для получения подробной информации по заявке используйте ее идентификатор в запросе проверки статуса заявки (раздел 3.4).

Внимание! Для запроса используется AuthToken, полученный в соответствии с разделом 2.1. Авторизация через AuthToken. Ключ доступа к API для партнеров для этого запроса не подходит: в ответ возвращается ошибка NoAccess.

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

GET api/integration/v2/kkt/application?AuthToken={authToken:string}&ActionTypesFilter={type:string}

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

• AuthToken – действующий код авторизации. Обязательный параметр;
• ActionTypesFilter – фильтр по типу заявки. Может принимать следующие значения:
  • InitialRegistration – первичная регистрация;
  • Reregistration – перерегистрация;
  • Unregistration – снятие с учета.

Чтобы получить заявки нескольких типов, передайте параметр ActionTypesFilter несколько раз. Если параметр не передан, возвращаются заявки всех типов. Необязательный параметр.

Пример запроса на получение заявок всех типов:

GET https://ofd.ru/api/integration/v2/kkt/application?AuthToken=d191800efd1c4b0ba70ef05b95a9a582

Пример запроса на получение заявок на первичную регистрацию и перерегистрацию:

GET https://ofd.ru/api/integration/v2/kkt/application?AuthToken=d191800efd1c4b0ba70ef05b95a9a582&ActionTypesFilter=InitialRegistration&ActionTypesFilter=Reregistration

Ответ на запрос имеет вид, отличный от общего вида ответа (раздел 1): вместо параметра Success передаются параметры Status и Elapsed.

Пример ответа на запрос получения заявок всех типов:

{
    "Status": "Success",
    "Data": [
        {
            "Id": "3f2a6c1e-8b4d-4e7a-9c5f-1d2e3f4a5b6c",
            "Type": "Reregistration",
            "CDateUtc": "2026-10-07T12:19:20",
            "FnNumber": "9999078900001234",
            "SerialNumber": "0012345678901",
            "UserFullName": "Иванов Иван Иванович",
            "RegNumber": "0001234567890123",
            "Status": "Approved"
        },
        {
            "Id": "7b1e9d24-5c3a-4f86-a0d2-6e8f1b3c5a79",
            "Type": "InitialRegistration",
            "CDateUtc": "2026-10-06T10:15:02",
            "UserFullName": "Иванов Иван Иванович",
            "Status": "New"
        },
        {
            "Id": "c4d8e2f1-9a6b-4c3d-8e7f-2a1b5c6d7e80",
            "Type": "Unregistration",
            "CDateUtc": "2026-09-30T16:42:11",
            "FnNumber": "9999078900005678",
            "SerialNumber": "0012345678902",
            "UserFullName": "Петров Петр Петрович",
            "RegNumber": "0001234567890456",
            "Status": "Rejected"
        }
    ],
    "Elapsed": "00:00:00.4290583"
}

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

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

Параметры SerialNumber, FnNumber, UserFullName и RegNumber передаются в ответе, только если соответствующее значение заполнено в заявке.

Версия 1.0
Выпущена 22 декабря 2021 г.
Первая отслеживаемая версия документа.

Версия 1.1
Выпущена 09 июня 2023 г.

• Изменены таблицы 1, 4, 5, 6, 7
• Созданы новые таблицы:
  • 1.1, 1.2, 1.3, 1.4, 1.5;
  • 4.1, 4.2, 4.3, 4.4;
  • 5.1, 5.2, 5.3, 5.4, 5.5;
  • 6.1, 6.2, 6.3, 6.4, 6.5;
  • 7.1, 7.2, 7.3, 7.4, 7.5, 7.6,
• Добавлены новые параметры для запроса создания заявки
• Добавлен новый раздел 3.1.1.

Версия 1.2
Выпущена 09 апреля 2024 г.
Актуализированы значения параметров таблиц в пункте 2.2. Общая JSON-схема заявки и значения следующих объектов:

• CompanyDetails;
• KktDetails;
• AutomaticDevices;
• Documents;
• ResultDocs;
• OfdAgreement.

Версия 1.3
Выпущена 05 мая 2024 г.
Добавлено описание FiscalDocuments в пункте 2.2. Общая JSON-схема заявки.
Актуализировано описание пункта 3.5.1 Описание запроса на передачу данных из отчета о регистрации.
Добавлен пункт 3.8. Запрос на изменение заявки.

Версия 1.31
Выпущена 26 марта 2025 г.
Добавлен новый статус заявки - AwaitingAutoFinalization

Версия 1.32
Выпущена 26 августа 2025 г.
Исправлено название параметра KktDetails в документации.

Версия 1.33
Выпущена 6 мая 2026 г.
Добавлена обязательность параметрам запросов.

Версия 1.34
Выпущена 17 августа 2026 г.
Параметру Purpose измена обязательность с «Нет» на «Да». Следующим обязательным параметрам добавлены сноски: FnName, Model, InstallmentPlace, FnsBranchCode, PostalCode, RegionCode, Region, FullAddress, FullAddress, RegNumber, ReregistrationReasons + вложенные параметры, ClosedFnDetails, InstalledFnDetails + вложенные параметры.

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

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

Версия 1.37
Выпущена 09 октября 2026 г.
Добавлено описание возможных ошибок запросов API. Актуализирован общий вид ответа с ошибкой. Приведена к единому виду нумерация таблиц.

Версия 1.38
Выпущена 19 октября 2026 г.
Дополнены описания ошибок получения AuthToken, создания и изменения заявки, подготовки документов, подписания и проверки статуса заявки. Уточнены правила обработки ошибок и повторных запросов. Добавлены ограничения частоты запросов на получение AuthToken. Актуализированы структура успешного ответа получения AuthToken и описание времени ExpirationDateUtc. Уточнено, что параметр Documents[].Signature содержит статус подписи, а не ЭЦП. Добавлено описание обработки текстовых причин отказа ФНС и получения файлов ответа при успешном результате и отказе. Уточнено, что параметр StatusReason может отсутствовать.

Версия 1.39
Выпущена 26 октября 2026 г.
Добавлен раздел 3.9. «Запрос на получение списка заявок» с описанием метода получения списка заявок на регистрацию, перерегистрацию и снятие ККТ с учета.