Помогаем продавать
Войти в ЛК

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

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

Ведение

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

1. Общий вид запроса и ответа в процессе использования API

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

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

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

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


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

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

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

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

2. Общее описание и начало работы

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

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

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

Вид запроса:

POST 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 и содержать следующую структуру:

{
    "Status": "Success",
    "Data": {
        "AuthToken": "f3accdfda7574736ba94a78d00e974f4",
        "ExpirationDateUtc": "2017-01-24T14:44:21"
    }
}

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

  • «AuthToken» – код авторизации. 1);
  • «ExpirationDateUtc» – значение имеет формат строки символов, в значении представлено дата и время в формате UTC+3, МОСКОВСКОЕ ВРЕМЯ, действия кода авторизации. 2)
    Время задается в формате «ГГГГ-ММ-ДДTчч:мм:сс» 3):
    ГГГГ - год даты, 4 цифры,
    ММ - месяц даты, 2 цифры,
    ДД - день даты 2 цифры,
    T - заглавная латинская буква “T”, используется как разделитель даты и времени,
    чч - часы, 2 цифры,
    мм - минуты, 2 цифры,
    сс - секунды, 2 цифры ().

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

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


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

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

2.2. Общая JSON-схема заявки

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

Вам представлена JSON-схема с параметрами для всех видов заявок.

Общая JSON-схема:

{
	"Id": uuid,
	"Purpose": string,
	"Stage": string,
	"Status": string,
	"StatusReason": string,
	"StatusChangeDateUtc": date,
	"CompanyDetails": {
		"CompanyType": string,
		"Director": {
			"FirstName": string,
			"LastName": string,
			"MiddleName": string
		},
		"FnsBranchCode": string,
		"LegalAddress": {
			"PostalCode": string,
			"RegionCode": string,
			"Region": string,
			"Settlement": string,
			"Street": string,
			"HouseNumber": string,
			"Building": string,
			"Office": string,
			"FiasCode": uiid,
			"FullAddress": string
		},
		"Inn": string
		"Ogrn": string,
		"Kpp": string,
		"CompanyName": string,
		"Signatory": {
			"Name": string,
			"Position": string,
			"Email": string,
			"Phone": string
		}
	},
	"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
	}],
	"Documents": [{
		"Id": uuid,
		"Kind": string,
		"Content": string,
		"Signature": string,
		"Description": string,
		"FileName": string
	}],
	"OfdAgreementId": uuid,
	"CDateUtc": date,
	"UDateUtc": date,
	"UserAccountId": uuid,
	"ResultDocs": [{
		"KktId":
		"ReportTypeId":,
		"DocType": string,
		"ConversationUuid": uuid,
		"ReportSizeInBytes": int,
		"FileType": string,
		"DownloadUri": string

	}],
	"DownloadUri": string,
	"CanBeAutomaticDevice": bool
},

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

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

Параметр Вложенный параметр Вложенный параметр Формат значения Описание параметра
Id Uuid Уникальный идентификатор заявки
Purpose String Назначение заявки.
Назначение заявки может принимать следующие значения:
- InitialRegistration - первичная регистрация;
- Reregistration - перерегистрация;
- Unregistration - снятие с учета.
Stage String Этап оформления заявки.
Этап оформления заявки может принимать следующие значения:
- Initialization - начало оформления;
- Finalization - окончание оформления.
Status String Статус заявки.
Статус заявки может принимать следующие значения:
- New - новая заявка на регистрацию/перерегистрацию;
- AwaitingDocuments - ожидание формирования документов для подписи;
- AwaitingSignature - документы сформированы, ожидают подписи;
- ProcessingSignedDocuments - проверка подписанных документов;
- ReadyToBeSentToFns - заявка готова к отправке в ФНС;
- SentToFns - заявка отправлена в ФНС;
- Rejected - заявка отклонена;
- Approved - заявка одобрена;
- DownloadingDocuments - получения готовых документов;
- UnknownError - неизвестная ошибка.
StatusReason String В параметре присутствует описание причины отказа заявки на регистрацию/перерегистрацию ФНС
StatusChangeDateUtc Date Дата изменения состояния (UTC)
CompanyDetails Структура Данные организации
CompanyType String Тип организации имеет следующие значения:
- LegalEntity - Юридическое лицо;
- PrivateEntrepreneur - Индивидуальный предприниматель.
Director Структура Руководитель организации
FirstName String Фамилия Руководителя организации
LastName String Имя Руководителя организации
MiddleName String Отчество Руководителя организации
FnsBranchCode String Код филиала ФНС
LegalAddress Структура Адрес филиала ФНС
PostalCode String Почтовый индекс филиала ФНС
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес филиала ФНС
Inn String Индификационный номер налогоплательщика
Ogrn String Основной государственный регистрационный номер юридического лица
Kpp String Код основания постановки на учет в ФНС
CompanyName String Название организации
Signatory Структура Сведения о руководителе организации
Name String Имя руководителя организации
Position String Должность
Email String Электронный адрес почты руководителя организации
Phone String Контактный телефон руководителя организации
KktDetails Структура Сведения о кассе
SerialNumber String Серийный номер кассы
RegNumber String Регистрационный номер касс
FnNumber String Номер фискального накопителя
FnName String Название фискального накопителя
Model String Модель кассы
InstallmentAddress Структура Адрес установки кассы
PostalCode String Почтовый индекс адреса установки кассы
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес установки кассы
InstallmentPlace String Адрес места расчета
ReregistrationReasons Структура Причины перерегистрации кассы
AutomatedDeviceChanged Boolean
FnChanged Bool Замена фискального накопителя
InstallmentPlaceChanged Bool Изменение адреса и места установки
OfdChaged Boolean Смена оператора фискальных данных
Other Boolean Другие причины
SwitchedFromOfflineToOnlineMode Boolean Переключение в режим работы в сети интернет
SwitchedFromOnlineToOfflineMode Boolean Переключение в автономный режим работы
UserChanged Boolean Смена организации
UnregistrationReasons Структура Причины снятия кассы с учета
Lost Boolean Утеряна
Stolen Boolean Украдена
Broken Boolean Сломана
UsageMode Структура Признак расчетов по кассе
Gambling Boolean Азартные игры: прием ставок и выплата выигрыша
Lottery Boolean Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша
Agent Boolean Платежный агент (субагент)
AutomatedDevice Boolean Признак: установка принтера в автомате
Internet Boolean Расчеты в интернете
Mobile Boolean Развозная и (или) разносная торговля
Banking Boolean Банковский платежный агент (субагент)
ExcisableGoods Boolean Касса используется для реализации подакцизных товаров
FormsForReports Boolean Оказания услуг
Marking Boolean Касса используется для реализации товаров с обязательной маркировкой
FiscalDocumentData Структура Данные фискального документа
DateTime Date Время и дата пробития (UTC)
DocumentNumber String Номер фискального документа (UTC)
Signature String ЭЦП документа в формате base64
FnsBranchCode String Код филиала ФНС
ClosedFnDetails Структура Отчет о закрытии фискального накопителя
FdDateTime Date Время и дата пробития (UTC)
FdNumber String Номер фискального документа
FpValue String Фискальный признак
InstalledFnDetails Структура Отчет об установки фискального накопителя
FdDateTime Date Время и дата пробития (UTC)
FdNumber String Номер фискального документа
FpValue String Фискальный признак
IsPrinterInAutomat Boolean Признак принтера в автоматическом режиме
IsEncryption Boolean Признак шифрования
IsPaymentForService Boolean Признак оплаты сервиса
FormatVersion Integer Версия фискального документа.
Версия фискального документа может принимать следующие значения:
- 1 - ФФД версии 1.0
- 2 - ФФД версии 1.05
- 3 - ФФД версии 1.1
- 4 - ФФД версии 1.2
AutomaticDevices Array (Структура) Данные автоматического устройств
InstallmentAddress Структура
PostalCode String Почтовый индекс установки автоматического устройства
RegionCode String Код субъекта РФ
Region String Субъект РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Номер строения
Office String Номер комнаты/офиса
FiasCode Uuid Код ФИАС
FullAddress String Полный адрес установки автоматического устройства
InstallmentPlace String Место расчетов автоматического устройства
DeviceNumber String Номер автоматического устройства
Documents Array (Структура) Исходящие документы от ФНС
Id Uuid Идентификатор исходящего документа
Kind String Вид исходящего документа
Content String Содержание исходящего документа
Signature String ЭЦП документа в формате base64
Description String Описание
FileName String Название файла
OfdAgreementId Uuid Идентификатор организации привязанной к ЛКК OFD.ru
CDateUtc Date Дата создания заявки (UTC)
UDateUtc Date Дата изменения заявки (UTC)
UserAccountId Uuid Идентификатор ЛКК OFD.ru
ResultDocs Array (Структура) Ответ ФНС на заявку о регистрации/перерегистрации
KktId String Идентификатор кассы
ReportTypeId String Идентификатор ответа ФНС на заявку о регистрации/перерегистрации
DocType String Ответ ФНС на заявку о регистрации/перерегистрации может принимать значения:
- RnmReport - отчёт о присвоении РНМ;
- RegReport - карточка регистрации ККТ;
- ReRegReport - карточка перерегистрации ККТ;
- RnmRejection - отказ на получение РНМ в рамках регистрации ККТ;
- RegRejection - отказ регистрации ККТ;
- ReRegRejection - отказ перерегистрации ККТ;
- UnKnwon - не определён.
ConversationUuid Uuid
ReportSizeInBytes Integer Размер файла с ответом от ФНС
FileType String Расширение файла с ответом от ФНС
DownloadUri String Ссылка для получения печатной формы заявления о регистрации/перерегистрации
DownloadUri String Ссылка для получения печатной формы заявления о регистрации/перерегистрации
CanBeAutomaticDevice Boolean Признак автоматического устройства

2.3. Описание этапов прохождения заявки

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

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

Этап Параметр Значение Описание Тип заявки
Создание Stage Initialization Создание заявки Регистрация
Перерегистрация
Снятие с учета
Finalization Создание заявки об отчете о регистрации Регистрация
Status New Новая Регистрация
Перерегистрация
Снятие с учета
Подготовка к подписи Stage Initialization Создание заявки Регистрация
Перерегистрация
Снятие с учета
Finalization Создание заявки об отчете о регистрации Регистрация
Status AwaitingSignature, возможное промежуточное состояние AwaitingDocuments Ожидание подписи, Ожидание подписанных документов для отправки Регистрация
Перерегистрация
Снятие с учета
Подписание и отправка в ФНС Stage Initialization Создание заявки Регистрация
Перерегистрация
Снятие с учета
Finalization Создание заявки об отчете о регистрации Регистрация
Status SentToFns
Возможные промежуточные состояния:
- ProcessingSignedDocuments;
- ReadyToBeSentToFns.
Документы отправлены.
Описание промежуточных состояний:
- Документы в процессе отправки;
- Документы готовы к отправке.
Регистрация
Перерегистрация
Снятие с учета
Проверка статуса Stage Finalization Заявка создана Регистрация
Перерегистрация
Снятие с учета
Отчет о регистрации
Status New Для завершения регистрации кассы в фнс необходимо отправить отчете о регистрации Регистрация
Approved касса успешно зарегистрирована, перерегистрирована или снята с учёта Регистрация
Перерегистрация
Снятие с учета
Rejected заявка отклонена, описание отказа описано в параметре StatusReason Регистрация
Перерегистрация
Снятие с учета

3. Последовательность выполнения запросов

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

3.1. Описание запроса на создание заявки

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

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

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

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


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

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

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

Параметр Вложенный параметр Вложенный параметр Формат значения Описание
Purpose String Назначение заявки.
Назначение заявки может принимать одно из значений:
- InitialRegistration - первичная регистрация;
- Reregistration - перерегистрация;
- Unregistration - снятие с учета
CompanyDetails Структура Данные организации
Inn String Индификационный номер налогоплательщика
Kpp String Код основания постановки на учет в ФНС
KktDetails Структура Сведения о кассе
SerialNumber String Серийный номер кассы
FnNumber String Номер фискального накопителя
FnName String Название фискального накопителя
Model String Модель кассы
InstallmentAddress Структура Адрес установки кассы
PostalCode String Почтовый индекс адреса установки кассы
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес установки кассы
InstallmentPlace String Адрес места расчета
UsageMode Структура Признак расчетов по кассе
Gambling Boolean Азартные игры: прием ставок и выплата выигрыша
Lottery Boolean Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша
Agent Boolean Платежный агент (субагент)
AutomatedDevice Boolean Признак: установка принтера в автомате
Internet Boolean Расчеты в интернете
Mobile Boolean Развозная и (или) разносная торговля
Banking Boolean Банковский платежный агент (субагент)
ExcisableGoods Boolean Касса используется для реализации подакцизных товаров
FormsForReports Boolean Оказания услуг
Marking Boolean Касса используется для реализации товаров с обязательной маркировкой
FormatVersion Integer Версия фискального документа.\ Версия фискального документа может принимать следующие значения:
- 1 - ФФД версии 1.0
- 2 - ФФД версии 1.05
- 3 - ФФД версии 1.1
- 4 - ФФД версии 1.2

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


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://dev.ofd.ru/document/KktRegistrationApplication?Id=dce50538-ee9b-4378-990c-66824ef3815c&format=pdf",
        "CanBeAutomaticDevice": false
    },
    "Success": true
}

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

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

Параметр Вложенный параметр Вложенный параметр Формат значения Описание параметра
Id Uuid Уникальный идентификатор заявки
CompanyDetails Структура Данные организации
Director Структура Руководитель организации
FirstName String Фамилия Руководителя организации
LastName String Имя Руководителя организации
MiddleName String Отчество Руководителя организации
CreatedDate Date Дата и время регистрации компании
UpdatedDate Date Дата и время актуализации регистрации компании
LegalAddress Структура Фактический адрес организации
FullAddress String Полный адрес организации
Inn String Индификационный номер налогоплательщика
Kpp String Код основания постановки на учет в ФНС
Signatory Структура Сведения о руководителе организации
Email String Электронный адрес почты руководителя организации
Phone String Контактный телефон руководителя организации
IsRepresent Boolean Заместитель руководителя
RepresentativeDetails Структура Данные заместителя руководителя организации
IsReceiptSendingEnable Boolean Статус услуги ОФД
IsPaymentAgent Boolean Признак платежного агента
ShowEReceiptMainBanner Boolean
LockCreatingCompanyWithOtherKpp Boolean Блокировать создания компании с другим КПП
KktDetails Структура Сведения о кассе
FnNumber String Номер фискального накопителя
FnName String Название фискального накопителя
InstallmentAddress Структура Адрес установки кассы
FullAddress String Полный адрес установки кассы
InstallmentPlace String Адрес места расчета
UsageMode Структура Признак расчетов по кассе
Gambling Boolean Азартные игры: прием ставок и выплата выигрыша
Lottery Boolean Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша
Agent Boolean Платежный агент (субагент)
AutomatedDevice Boolean Признак: установка принтера в автомате
Internet Boolean Расчеты в интернете
Mobile Boolean Развозная и (или) разносная торговля
Banking Boolean Банковский платежный агент (субагент)
ExcisableGoods Boolean Касса используется для реализации подакцизных товаров
FormsForReports Boolean Оказания услуг
Marking Boolean Касса используется для реализации товаров с обязательной маркировкой
Model String Модель кассы
SerialNumber String Серийный номер кассы
FiscalDocumentData Структура Данные фискального документа
ClosedFnDetails Структура Отчет о закрытии фискального накопителя
InstalledFnDetails Структура Отчет об установки фискального накопителя
AutomaticDevices Array (Структура) Данные автоматического устройств
Stage String Этап оформления заявки.
Этап оформления заявки может принимать следующие значения:
- Initialization - начало оформления;
- Finalization - окончание оформления.
Status String Статус заявки.
Статус заявки может принимать следующие значения:
- New - новая заявка на регистрацию/перерегистрацию;
- AwaitingDocuments - ожидание формирования документов для подписи;
- AwaitingSignature - документы сформированы, ожидают подписи;
- ProcessingSignedDocuments - проверка подписанных документов;
- ReadyToBeSentToFns - заявка готова к отправке в ФНС;
- SentToFns - заявка отправлена в ФНС;
- Rejected - заявка отклонена;
- Approved - заявка одобрена;
- DownloadingDocuments - получения готовых документов;
- UnknownError - неизвестная ошибка.
CanDelete Boolean Признак разрешения удалить заявку
Documents Array Документы, сгенерированные в процессе регистрации
Purpose String Назначение заявки.
Назначение заявки может принимать следующие значения:
- InitialRegistration - первичная регистрация;
- Reregistration - перерегистрация;
- Unregistration - снятие с учета.
Gateway Служебная строка, используется в отладочных целях
OfdAgreementId String Идентификатор юридического лица прикрепленного к ЛК OFD.ru
OfdAgreement Структура Описания и условия предоставления услуг OFD.ru
PayPeriods Структура Период оплаты услуг OFD.ru
1 String Каждый месяц
3 String Каждый квартал
12 String Каждый год
State String Регион нахождения клиента
HasUnifiedOrPatentTaxation Boolean
IncorrectNdsCalculationKktExist Boolean
Id String Идентификатор юридического лица прикрепленного к ЛК OFD.ru
CreatedDate Date Дата создания ЛКК
UpdatedDate Date Дата обновления данных
Number String
LegalAddress Структура Фактический адрес организации
PostalCode String Почтовый индекс адреса установки кассы
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес установки кассы
PostalAddress Структура Адрес для корреспонденции
FullAddress String Полный адрес для корреспонденции
Inn String Индификационный номер налогоплательщика
Ogrn String Основной государственный регистрационный номер юридического лица
Kpp String Код основания постановки на учет в ФНС
CompanyName String Название организации
Signatory Структура Сведения о руководителе организации
IsNdsPayer Boolean Организация работает с НДС
ElectronicInvoicingType String Тип электронного документооборота
PaymentType String Тип осуществления расчетов
ProxyTestDiveAvailable Boolean Служебная строка, используется в отладочных целях
IsReceiptSendingEnable Boolean Статус услуги ОФД
IsPaymentAgent Boolean Признак платежного агента
ShowEReceiptMainBanner Boolean Признак показа рекламного баннера в чеке при отправке по email
LockCreatingCompanyWithOtherKpp Boolean Блокировать создания компании с другим КПП
StatusChangeDateUtc Date Дата и время смены статуса заявки
CDateUtc Date Дата и время создания заявки
UDateUtc Date Дата и время последнего изменения шаблона заявки
UserAccountId String Идентификатор ЛКК
DownloadUri String Ссылка для получения печатной формы в формате *.pdf
CanBeAutomaticDevice Boolean Признак автоматического устройства

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

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

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

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

Запрос подготовки заявления выполняется методом 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://dev.ofd.ru/document/KktRegistrationApplication?Id=4d5d5574-433d-4c3f-afd7-3b3c39595d33&format=pdf",
        "CanBeAutomaticDevice": false
    },
    "Success": true
}

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

Параметр Вложенный параметр Вложенный параметр Формат значения Описание параметра
Id Uuid Уникальный идентификатор заявки
CompanyDetails Структура Данные организации
Director Структура Руководитель организации
FirstName String Фамилия Руководителя организации
LastName String Имя Руководителя организации
MiddleName String Отчество Руководителя организации
FnsBranchCode String Код филиала ФНС
CreatedDate Date Дата и время регистрации компании
UpdatedDate Date Дата и время актуализации регистрации компании
LegalAddress Структура Адрес филиала ФНС
PostalCode String Почтовый индекс филиала ФНС
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid Идентификатор ФИАС
FullAddress String Полный адрес филиала ФНС
Inn String Индификационный номер налогоплательщика
Ogrn String Основной государственный регистрационный номер юридического лица
Kpp String Код основания постановки на учет в ФНС
CompanyName String Название организации
Signatory Структура Сведения о руководителе организации
Name String Имя руководителя организации
Position String Должность
Email String Электронный адрес почты руководителя организации
Phone String Контактный телефон руководителя организации
IsRepresent Boolean Заместитель руководителя
IsReceiptSendingEnable Boolean Статус услуги ОФД
IsPaymentAgent Boolean Признак платежного агента
ShowEReceiptMainBanner Boolean
LockCreatingCompanyWithOtherKpp Boolean Блокировать создания компании с другим КПП
KktDetails Структура Сведения о кассе
FnNumber String Номер фискального накопителя
FnName String Название фискального накопителя
InstallmentAddress Структура Адрес установки кассы
PostalCode String Почтовый индекс адреса установки кассы
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес установки кассы
InstallmentPlace String Адрес места расчета
UsageMode Структура Признак расчетов по кассе
Gambling Boolean Азартные игры: прием ставок и выплата выигрыша
Lottery Boolean Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша
Agent Boolean Платежный агент (субагент)
AutomatedDevice Boolean Признак: установка принтера в автомате
Internet Boolean Расчеты в интернете
Mobile Boolean Развозная и (или) разносная торговля
Banking Boolean Банковский платежный агент (субагент)
ExcisableGoods Boolean Касса используется для реализации подакцизных товаров
FormsForReports Boolean Оказания услуг
Marking Boolean Касса используется для реализации товаров с обязательной маркировкой
Model String Модель кассы
SerialNumber String Серийный номер кассы
FiscalDocumentData Структура Данные фискального документа
FnsBranchCode String Код филиала ФНС
ClosedFnDetails Структура Отчет о закрытии фискального накопителя
InstalledFnDetails Структура Отчет об установки фискального накопителя
AutomaticDevices Array (Структура) Данные автоматического устройств
Stage String Этап оформления заявки.
Этап оформления заявки может принимать следующие значения:
- Initialization - начало оформления;
- Finalization - окончание оформления.
Status String Статус заявки.
Статус заявки может принимать следующие значения:
- New - новая заявка на регистрацию/перерегистрацию;
- AwaitingDocuments - ожидание формирования документов для подписи;
- AwaitingSignature - документы сформированы, ожидают подписи;
- ProcessingSignedDocuments - проверка подписанных документов;
- ReadyToBeSentToFns - заявка готова к отправке в ФНС;
- SentToFns - заявка отправлена в ФНС;
- Rejected - заявка отклонена;
- Approved - заявка одобрена;
- DownloadingDocuments - получения готовых документов;
- UnknownError - неизвестная ошибка.
CanDelete Boolean Признак разрешения удалить заявку
Documents Array (Структура) Документы, сгенерированные в для передачи в ФНС
Id String Идентификатор исходящего документа
Kind String Вид исходящего документа
Content String Содержание исходящего документа формате base64
Signature String ЭЦП документа в формате base64
Description String Описание документа
FileName String Имя файла
Purpose String Назначение заявки.
Назначение заявки может принимать следующие значения:
- InitialRegistration - первичная регистрация;
- Reregistration - перерегистрация;
- Unregistration - снятие с учета.
Gateway Служебная строка, используется в отладочных целях
OfdAgreementId String Идентификатор юридического лица прикрепленного к ЛК OFD.ru
OfdAgreement Структура Описания и условия предоставления услуг OFD.ru
PayPeriods Структура Период оплаты услуг OFD.ru
1 String Каждый месяц
3 String Каждый квартал
12 String Каждый год
State String Регион нахождения клиента
HasUnifiedOrPatentTaxation Boolean
IncorrectNdsCalculationKktExist Boolean
Id String Идентификатор юридического лица прикрепленного к ЛК OFD.ru
CreatedDate Date Дата создания ЛКК
UpdatedDate Date Дата обновления данных
Number String
LegalAddress Структура Фактический адрес организации
PostalCode String Почтовый индекс адреса установки кассы
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес установки кассы
PostalAddress Структура Адрес для корреспонденции
FullAddress String Полный адрес для корреспонденции
Inn String Индификационный номер налогоплательщика
Ogrn String Основной государственный регистрационный номер юридического лица
Kpp String Код основания постановки на учет в ФНС
CompanyName String Название организации
Signatory Структура Сведения о руководителе организации
IsNdsPayer Boolean Организация работает с НДС
ElectronicInvoicingType String Тип электронного документооборота
PaymentType String Тип осуществления расчетов
ProxyTestDiveAvailable Boolean Служебная строка, используется в отладочных целях
IsReceiptSendingEnable Boolean Статус услуги ОФД
IsPaymentAgent Boolean Признак платежного агента
ShowEReceiptMainBanner Boolean Признак показа рекламного баннера в чеке при отправке по email
LockCreatingCompanyWithOtherKpp Boolean Блокировать создания компании с другим КПП
StatusChangeDateUtc Date Дата и время смены статуса заявки
CDateUtc Date Дата и время создания заявки
UDateUtc Date Дата и время последнего изменения шаблона заявки
UserAccountId String Идентификатор ЛКК
DownloadUri String Ссылка для получения печатной формы в формате *.pdf
CanBeAutomaticDevice Boolean Признак автоматического устройства

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметр Вложенный параметр Вложенный параметр Формат значения Описание параметра
Id Uuid Уникальный идентификатор заявки
CompanyDetails Структура Данные организации
Director Структура Руководитель организации
FirstName String Фамилия Руководителя организации
LastName String Имя Руководителя организации
MiddleName String Отчество Руководителя организации
FnsBranchCode String Код филиала ФНС
CreatedDate Date Дата и время регистрации компании
UpdatedDate Date Дата и время актуализации регистрации компании
LegalAddress Структура Адрес филиала ФНС
PostalCode String Почтовый индекс филиала ФНС
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid Идентификатор ФИАС
FullAddress String Полный адрес филиала ФНС
Inn String Индификационный номер налогоплательщика
Ogrn String Основной государственный регистрационный номер юридического лица
Kpp String Код основания постановки на учет в ФНС
CompanyName String Название организации
Signatory Структура Сведения о руководителе организации
Name String Имя руководителя организации
Position String Должность
Email String Электронный адрес почты руководителя организации
Phone String Контактный телефон руководителя организации
IsRepresent Boolean Заместитель руководителя
IsReceiptSendingEnable Boolean Статус услуги ОФД
IsPaymentAgent Boolean Признак платежного агента
ShowEReceiptMainBanner Boolean
LockCreatingCompanyWithOtherKpp Boolean Блокировать создания компании с другим КПП
KktDetails Структура Сведения о кассе
FnNumber String Номер фискального накопителя
FnName String Название фискального накопителя
InstallmentAddress Структура Адрес установки кассы
PostalCode String Почтовый индекс адреса установки кассы
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес установки кассы
InstallmentPlace String Адрес места расчета
UsageMode Структура Признак расчетов по кассе
Gambling Boolean Азартные игры: прием ставок и выплата выигрыша
Lottery Boolean Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша
Agent Boolean Платежный агент (субагент)
AutomatedDevice Boolean Признак: установка принтера в автомате
Internet Boolean Расчеты в интернете
Mobile Boolean Развозная и (или) разносная торговля
Banking Boolean Банковский платежный агент (субагент)
ExcisableGoods Boolean Касса используется для реализации подакцизных товаров
FormsForReports Boolean Оказания услуг
Marking Boolean Касса используется для реализации товаров с обязательной маркировкой
Model String Модель кассы
SerialNumber String Серийный номер кассы
FiscalDocumentData Структура Данные фискального документа
FnsBranchCode String Код филиала ФНС
ClosedFnDetails Структура Отчет о закрытии фискального накопителя
InstalledFnDetails Структура Отчет об установки фискального накопителя
AutomaticDevices Array (Структура) Данные автоматического устройств
Stage String Этап оформления заявки.
Этап оформления заявки может принимать следующие значения:
- Initialization - начало оформления;
- Finalization - окончание оформления.
Status String Статус заявки.
Статус заявки может принимать следующие значения:
- New - новая заявка на регистрацию/перерегистрацию;
- AwaitingDocuments - ожидание формирования документов для подписи;
- AwaitingSignature - документы сформированы, ожидают подписи;
- ProcessingSignedDocuments - проверка подписанных документов;
- ReadyToBeSentToFns - заявка готова к отправке в ФНС;
- SentToFns - заявка отправлена в ФНС;
- Rejected - заявка отклонена;
- Approved - заявка одобрена;
- DownloadingDocuments - получения готовых документов;
- UnknownError - неизвестная ошибка.
CanDelete Boolean Признак разрешения удалить заявку
Documents Array (Структура) Документы, сгенерированные в для передачи в ФНС
Id String Идентификатор исходящего документа
Kind String Вид исходящего документа
Content String Содержание исходящего документа формате base64
Signature String ЭЦП документа в формате base64
Description String Описание документа
FileName String Имя файла
Purpose String Назначение заявки.
Назначение заявки может принимать следующие значения:
- InitialRegistration - первичная регистрация;
- Reregistration - перерегистрация;
- Unregistration - снятие с учета.
Gateway Служебная строка, используется в отладочных целях
OfdAgreementId String Идентификатор юридического лица прикрепленного к ЛК OFD.ru
OfdAgreement Структура Описания и условия предоставления услуг OFD.ru
PayPeriods Структура Период оплаты услуг OFD.ru
1 String Каждый месяц
3 String Каждый квартал
12 String Каждый год
State String Регион нахождения клиента
HasUnifiedOrPatentTaxation Boolean
IncorrectNdsCalculationKktExist Boolean
Id String Идентификатор юридического лица прикрепленного к ЛК OFD.ru
CreatedDate Date Дата создания ЛКК
UpdatedDate Date Дата обновления данных
Number String
LegalAddress Структура Фактический адрес организации
PostalCode String Почтовый индекс адреса установки кассы
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес установки кассы
PostalAddress Структура Адрес для корреспонденции
FullAddress String Полный адрес для корреспонденции
Inn String Индификационный номер налогоплательщика
Ogrn String Основной государственный регистрационный номер юридического лица
Kpp String Код основания постановки на учет в ФНС
CompanyName String Название организации
Signatory Структура Сведения о руководителе организации
IsNdsPayer Boolean Организация работает с НДС
ElectronicInvoicingType String Тип электронного документооборота
PaymentType String Тип осуществления расчетов
ProxyTestDiveAvailable Boolean Служебная строка, используется в отладочных целях
IsReceiptSendingEnable Boolean Статус услуги ОФД
IsPaymentAgent Boolean Признак платежного агента
ShowEReceiptMainBanner Boolean Признак показа рекламного баннера в чеке при отправке по email
LockCreatingCompanyWithOtherKpp Boolean Блокировать создания компании с другим КПП
StatusChangeDateUtc Date Дата и время смены статуса заявки
CDateUtc Date Дата и время создания заявки
UDateUtc Date Дата и время последнего изменения шаблона заявки
UserAccountId String Идентификатор ЛКК
DownloadUri String Ссылка для получения печатной формы в формате *.pdf
CanBeAutomaticDevice Boolean Признак автоматического устройства

3.4. Описание запроса проверки статуса заявки

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

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

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

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

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

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

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

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

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

  • id:uuid - идентификатор заявки.
  • 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://dev.ofd.ru/document/KktRegistrationApplication?Id=1b21cac3-2b85-404a-b147-7f3bbd6827a5&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}



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

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

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

Параметр Вложенный параметр Вложенный параметр Формат значения Описание параметра
Id Uuid Уникальный идентификатор заявки
CompanyDetails Структура Данные организации
Director Структура Руководитель организации
FirstName String Фамилия Руководителя организации
LastName String Имя Руководителя организации
MiddleName String Отчество Руководителя организации
FnsBranchCode String Код филиала ФНС
CreatedDate Date Дата и время регистрации компании
UpdatedDate Date Дата и время актуализации регистрации компании
LegalAddress Структура Адрес филиала ФНС
PostalCode String Почтовый индекс филиала ФНС
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid Идентификатор ФИАС
FullAddress String Полный адрес филиала ФНС
Inn String Индификационный номер налогоплательщика
Ogrn String Основной государственный регистрационный номер юридического лица
Kpp String Код основания постановки на учет в ФНС
CompanyName String Название организации
Signatory Структура Сведения о руководителе организации
Name String Имя руководителя организации
Position String Должность
Email String Электронный адрес почты руководителя организации
Phone String Контактный телефон руководителя организации
IsRepresent Boolean Признак заместителя руководителя
RepresentativeDetails Boolean Данные заместителя руководителя
IsReceiptSendingEnable Boolean Статус услуги ОФД
IsPaymentAgent Boolean Признак платежного агента
ShowEReceiptMainBanner Boolean
LockCreatingCompanyWithOtherKpp Boolean Блокировать создания компании с другим КПП
KktDetails Структура Сведения о кассе
FnNumber String Номер фискального накопителя
FnName String Название фискального накопителя
InstallmentAddress Структура Адрес установки кассы
PostalCode String Почтовый индекс адреса установки кассы
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес установки кассы
InstallmentPlace String Адрес места расчета
UsageMode Структура Признак расчетов по кассе
Gambling Boolean Азартные игры: прием ставок и выплата выигрыша
Lottery Boolean Лотереи: реализация лотерейных билетов, прием лотерейных ставок и выплата выигрыша
Agent Boolean Платежный агент (субагент)
AutomatedDevice Boolean Признак: установка принтера в автомате
Internet Boolean Расчеты в интернете
Mobile Boolean Развозная и (или) разносная торговля
Banking Boolean Банковский платежный агент (субагент)
ExcisableGoods Boolean Касса используется для реализации подакцизных товаров
FormsForReports Boolean Оказания услуг
Marking Boolean Касса используется для реализации товаров с обязательной маркировкой
Model String Модель кассы
SerialNumber String Серийный номер кассы
FiscalDocumentData Структура Данные фискального документа
FnsBranchCode String Код филиала ФНС
ClosedFnDetails Структура Отчет о закрытии фискального накопителя
InstalledFnDetails Структура Отчет об установки фискального накопителя
AutomaticDevices Array (Структура) Данные автоматического устройств
Stage String Этап оформления заявки.
Этап оформления заявки может принимать следующие значения:
- Initialization - начало оформления;
- Finalization - окончание оформления.
Status String Статус заявки.
Статус заявки может принимать следующие значения:
- New - новая заявка на регистрацию/перерегистрацию;
- AwaitingDocuments - ожидание формирования документов для подписи;
- AwaitingSignature - документы сформированы, ожидают подписи;
- ProcessingSignedDocuments - проверка подписанных документов;
- ReadyToBeSentToFns - заявка готова к отправке в ФНС;
- SentToFns - заявка отправлена в ФНС;
- Rejected - заявка отклонена;
- Approved - заявка одобрена;
- DownloadingDocuments - получения готовых документов;
- UnknownError - неизвестная ошибка.
CanDelete Boolean Признак разрешения удалить заявку
Documents Array (Структура) Документы, сгенерированные в для передачи в ФНС
Id String Идентификатор исходящего документа
Kind String Вид исходящего документа
Content String Содержание исходящего документа формате base64
Signature String ЭЦП документа в формате base64
Description String Описание документа
FileName String Имя файла
Purpose String Назначение заявки.
Назначение заявки может принимать следующие значения:
- InitialRegistration - первичная регистрация;
- Reregistration - перерегистрация;
- Unregistration - снятие с учета.
Gateway String Служебная строка, используется в отладочных целях
OfdAgreementId String Идентификатор юридического лица прикрепленного к ЛК OFD.ru
OfdAgreement Структура Описания и условия предоставления услуг OFD.ru
PayPeriods Структура Период оплаты услуг OFD.ru
1 String Каждый месяц
3 String Каждый квартал
12 String Каждый год
State String Регион нахождения клиента
HasUnifiedOrPatentTaxation Boolean
IncorrectNdsCalculationKktExist Boolean
Id String Идентификатор юридического лица прикрепленного к ЛК OFD.ru
CreatedDate Date Дата создания ЛКК
UpdatedDate Date Дата обновления данных
Number String
LegalAddress Структура Фактический адрес организации
PostalCode String Почтовый индекс адреса установки кассы
RegionCode String Код субъекта РФ
Region String Название субъекта РФ
Settlement String Населённый пункт
HouseNumber String Номер дома
Building String Строение
Office String Номер комнаты/офиса
FiasCode Uuid код ФИАС
FullAddress String Полный адрес установки кассы
PostalAddress Структура Адрес для корреспонденции
FullAddress String Полный адрес для корреспонденции
Inn String Индификационный номер налогоплательщика
Ogrn String Основной государственный регистрационный номер юридического лица
Kpp String Код основания постановки на учет в ФНС
CompanyName String Название организации
Signatory Структура Сведения о руководителе организации
Name String Имя руководителя организации
Position String Должность
Email String Электронный адрес почты руководителя организации
Phone String Контактный телефон руководителя организации
IsRepresent Boolean Признак заместителя руководителя
IsNdsPayer Boolean Организация работает с НДС
ElectronicInvoicingType String Тип электронного документооборота
PaymentType String Тип осуществления расчетов
ProxyTestDiveAvailable Boolean Служебная строка, используется в отладочных целях
IsReceiptSendingEnable Boolean Статус услуги ОФД
IsPaymentAgent Boolean Признак платежного агента
ShowEReceiptMainBanner Boolean Признак показа рекламного баннера в чеке при отправке по email
LockCreatingCompanyWithOtherKpp Boolean Блокировать создания компании с другим КПП
StatusReason String Описание причины отказа ФНС в заявки
KktAgreementId String Присвоенный РНМ
StatusChangeDateUtc Date Дата и время смены статуса заявки
CDateUtc Date Дата и время создания заявки
UDateUtc Date Дата и время последнего изменения шаблона заявки
UserAccountId String Идентификатор ЛКК
ResultDocs Array (Структура) Ответ от ФНС результатом о присвоении РНМ
KktId String Идентификатор кассы
ReportTypeId String Идентификатор ответа ФНС на заявку о регистрации/перерегистрации
DocType String Ответ ФНС на заявку о регистрации/перерегистрации может принимать значения:
- RnmReport - отчёт о присвоении РНМ;
- RegReport - карточка регистрации ККТ;
- ReRegReport - карточка перерегистрации ККТ;
- RnmRejection - отказ на получение РНМ в рамках регистрации ККТ;
- RegRejection - отказ регистрации ККТ;
- ReRegRejection - отказ перерегистрации ККТ;
- UnKnwon - не определён.
ConversationUuid Uuid
ReportSizeInBytes Integer Размер файла с ответом от ФНС
FileType String Расширение файла с ответом от ФНС
DownloadUri String Ссылка для получения печатной формы заявления о регистрации, перерегистрации, снятия с учета
DownloadUri String Ссылка для получения печатной формы в формате *.pdf
CanBeAutomaticDevice Boolean Признак автоматического устройства

3.5. Последовательность выполнения действий для передачи данных из отчета о регистрации

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

3.5.1. Описание запроса на передачи данных из отчета о регистрации

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

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

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

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

Параметры запроса для передачи отчета о регистрации.
В параметре 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://dev.ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

3.5.2. Описание подготовки отчета для подписи

Подготовка отчета для подписи выполняется запросом описанным в разделе "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": "ул Ленинская Слобода",
                "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": "AwaitingSignature",
        "Stage": "Finalization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "0cf2502a-a03b-4431-a73b-eec10c15bda1",
                "Kind": "1110061",
                "Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIiBzdGFuZGFsb25lPSJ5ZXMiPz4KPNTg6esgyOTU4OnrPSJLT19PVENIUkVHS0t........",
                "Signature": "Unsigned",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_OTCHREGKKT_7725_5252_5252012620525201001_20211216_5636afc3345847b68cd5bde3f3408af8"
            }
        ],
        "Purpose": "InitialRegistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T09:27:52",
        "CDateUtc": "2021-12-16T09:02:14",
        "UDateUtc": "2021-12-16T09:27:52",
        "UserAccountId": "4debcd06-cfff-46ea-a928-b81b05350db4",
        "DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

3.5.3. Описания подписи и отправка в ФНС данных из отчета о регистрации

Чтобы подписать и отправить в ФНС данные из отчета о регистрации, необходимо воспользоваться запросом описанным в разделе 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://dev.ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

3.5.4. Проверка статуса заявки

Чтобы получить ответ от ФНС о статусе заявки вам нужно воспользоваться запросом описанным в разделе "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://dev.ofd.ru/api/kkt/application/doc/81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c/16840/100"
            },
            {
                "KktId": 16840,
                "ReportTypeId": 50,
                "DocType": "RnmReport",
                "ConversationUuid": "81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c",
                "ReportSizeInBytes": 114984,
                "FileType": "application/pdf",
                "DownloadUri": "https://dev.ofd.ru/api/kkt/application/doc/81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c/16840/50"
            }
        ],
        "DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=81c178ca-fdf0-46f1-a4e6-a6cf0d77d39c&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.6.4. Проверка статуса заявки на перерегистрацию кассы

Чтобы получить ответ от ФНС о статусе заявки вам нужно воспользоваться запросом описанным в разделе 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://dev.ofd.ru/api/kkt/application/doc/c76b003e-36de-4db6-af87-ad91e67ba042/16880/101"
            }
        ],
        "DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=c76b003e-36de-4db6-af87-ad91e67ba042&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

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

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

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

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

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

3.7.1. Создание заявки на снятие с учета

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

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

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

Подготовка заявки на снятие с учета кассы для подписи выполняется запросом описанным в разделе 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://dev.ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

3.7.3. Подпись и отправка в ФНС заявки на снятие с учета кассы

Чтобы подписать и отправить заявку на снятие с учета кассы в ФНС, необходимо воспользоваться запросом описанным в разделе 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": "ул Ленинская Слобода",
                "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": "ProcessingSignedDocuments",
        "Stage": "Initialization",
        "CanDelete": false,
        "Documents": [
            {
                "Id": "c98b46dd-2780-4006-bc71-c67e6483de46",
                "Kind": "1110061",
                "Signature": "Signed",
                "Description": "Заявление о регистрации (перерегистрации) контрольно-кассовой техники",
                "FileName": "KO_ZVLSNUCHKKT_7725_7725_5252012620525201001_20211216_39fd922ee8574678a7e750f463cc15db"
            }
        ],
        "Purpose": "Unregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T12:37:04",
        "CDateUtc": "2021-12-16T12:32:15",
        "UDateUtc": "2021-12-16T12:37:04",
        "UserAccountId": "56805d98-6a0a-4148-8a1a-f0072cf7d32f",
        "DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

3.7.4. Проверка статуса заявки на снятие с учета кассы

Чтобы получить ответ от ФНС о статусе заявки вам нужно воспользоваться запросом описанным в разделе 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": "Москва",
                "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": "Approved",
        "Stage": "Finalization",
        "CanDelete": false,
        "Documents": [],
        "Purpose": "Unregistration",
        "Gateway": "SuccessMock",
        "OfdAgreementId": "97b99150-c055-4f29-a02b-fbec947a11ea",
        "OfdAgreement": {
            "PayPeriods": {
                "1": "EachMonth",
                "3": "EachQuarter",
                "12": "EachYear"
            },
            "State": "Liquidated",
            "HasUnifiedOrPatentTaxation": false,
            "IncorrectNdsCalculationKktExist": false,
            "Id": "97b99150-c055-4f29-a02b-fbec947a11ea",
            "CreatedDate": "2020-09-09T09:18:54",
            "UpdatedDate": "2021-12-06T10:41:05",
            "Number": "1025375819",
            "LegalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "PostalAddress": {
                "District": "Беломорский р-н",
                "City": "г Беломорск",
                "PostalCode": "109341",
                "RegionCode": "77",
                "Region": "Москва",
                "Settlement": "Москва",
                "Street": "ул Пушкина-колотушкина",
                "HouseNumber": "1",
                "Building": "1",
                "FullAddress": "109341, г Москва, ул Пушкина-колотушкина, 1, корп/стр: 1"
            },
            "Inn": "5252012620",
            "Ogrn": "1025202124716",
            "Kpp": "525201001",
            "CompanyName": "Юридическое лицо 9291",
            "Signatory": {
                "Name": "Романова Алла Романовна",
                "Position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР",
                "Email": "ivanov_ivan_ivanich@ofd.ru.ru",
                "Phone": "+7 (495) 123-45-67",
                "IsRepresent": false
            },
            "IsNdsPayer": true,
            "ElectronicInvoicingType": "None",
            "PaymentType": "BalancePrePayment",
            "PartnerCode": "335",
            "ProxyTestDiveAvailable": true,
            "IsReceiptSendingEnable": false,
            "IsPaymentAgent": false,
            "ShowEReceiptMainBanner": false,
            "LockCreatingCompanyWithOtherKpp": true
        },
        "KktAgreementId": "00000000-0000-0000-0000-000000000000",
        "StatusChangeDateUtc": "2021-12-16T13:40:28",
        "CDateUtc": "2021-12-16T12:32:15",
        "UDateUtc": "2021-12-16T13:40:28",
        "UserAccountId": "56805d98-6a0a-4148-8a1a-f0072cf7d32f",
        "ResultDocs": [],
        "DownloadUri": "https://dev.ofd.ru/document/KktRegistrationApplication?Id=b9e0ff67-eae4-4d7b-b637-68df3999e7fb&format=pdf",
        "CanBeAutomaticDevice": true
    },
    "Success": true
}

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

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

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

1)
Значение параметра AuthToken имеет формат строки символов. Код авторизации представляет собой 32-значную последовательность шестнадцатеричных цифр, требуется для аутентификации ЛК OFD.ru
2)
Полученный код авторизации активен 24 часа.
3)
Формат времени описан в стандарте ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601). В ответе на запрос используется только формат представления времени без задания смещения часовых поясов (Time Zone Offset) и интервалов.