В инструкции представлено описание программного интерфейса приложений (API) сервиса авторегистрации в ФНС. API сервис авторегистрации в ФНС осуществляет регистрацию, перерегистрацию, снятие с учета касс в ФНС.
В инструкции описаны API запросы и методы выполнения заявок регистрации, перерегистрации, снятия с учета касс, а также представлены описания основных параметров запросов и ответов.
Для работы API сервиса авторегистрации в ФНС в запросах и ответах используется кодировка UTF-8. Запросы выполняются методами POST, GET и PUT, параметры запроса располагаются в структуре данных формата JSON, передаваемой в блоке данных запроса (при использовании POST и PUT), также параметры могут передаваться в строке запроса (при использовании GET).
Ответы выдаются сервером в формате JSON и, в случае успешного ответа согласно его заголовку (код ответа по протоколу HTTP равен 200), данные имеют следующий обобщенный вид:
{
"Status": "Success",
"Data": {}
}
Получаем параметры ответа с кодом 200:
В случае ответа с ошибкой (код ответа по протоколу HTTP не равен 200) ответ имеет следующий вид:
{
"Status": "Failed",
"Error": {
Code: 0,
Message: "string"
}
}
В ответе с кодом не равным 200 возможны следующие параметры со значениями:
В разделе представлена общая JSON-схема заявки, описание параметров, а также описаны действия перед началом работы с API сервиса авторегистрации в ФНС.
Чтобы неоднократно обращаться к 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"
}
В данном запросе присутствуют примеры значений следующих параметров:
Значения параметров передаются в JSON-структуре внутри запроса.
Ваш логин и пароль от ЛКК OFD.ru являются значениями для запроса получения кода авторизации.
В ответ на данный запрос будет получен ответ по протоколу HTTP. Успешный ответ на запрос авторизации будет иметь код равный 200 и содержать следующую структуру:
{
"Status": "Success",
"Data": {
"AuthToken": "f3accdfda7574736ba94a78d00e974f4",
"ExpirationDateUtc": "2017-01-24T14:44:21"
}
}
Описание параметров ответа на запрос:
Полученный код авторизации необходим в запросах в виде дополнительного параметра. Код авторизации необходим в запросах для обращения к ЛКК.
Пример запроса с использованием кода авторизации:
POST https://ofd.ru/api/integration/v1/kkt/registration?AuthToken={Code}
Code – действующий код авторизации.
Параметры заявок на регистрацию, перерегистрацию и снятие с учета передается в 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 | Должность | ||
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 представлено описание прохождения этапов заявки.
Таблица 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 | Регистрация Перерегистрация Снятие с учета |
В разделе описаны выполнения запросов, методы вызова, параметры и их значения для осуществления всех этапов прохождения заявки.
Запрос выполняется для заявок на:
Начальный этап для всех видов заявок.
Рассмотрим работу запроса на примере создания заявки регистрации кассы в ФНС.
В запросе вы указываете основные данные для оформления заявки на регистрацию кассы в ФНС. Данные для регистрации кассы передаются в 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 | Структура | Сведения о руководителе организации | ||
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 | Признак автоматического устройства |
Запрос выполняется для:
Следующий этап, подготовка заявления для подписи. Рассмотрим работу запроса на примере завки на регистрацию кассы в ФНС.
Запрос подготовки заявления выполняется методом POST с передачей параметров в JSON структуре.
POST api/integration/v1/kkt/registration/{id:uuid}/prepareDocuments?AuthToken={authToken}
В запросе обязательно присутствую заменяемые параметры:
В теле запроса передаются следующие параметры:
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 | Должность | ||
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 | Признак автоматического устройства |
Запрос выполняется для:
Следующий этап, передача подписанного заявления в ФНС.
Запрос выполняется методом POST с передачей параметров в JSON-структуре.
Внимание! Повторная отправка запроса не допустима.
POST api/integration/v1/kkt/registration/{id:uuid}/sign?AuthToken={authToken}
Заменяемые параметры:
В теле запроса передаются следующие параметры:
Рассмотрим работу запроса на примере заявки на регистрацию кассы.
Пример запроса:
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 | Должность | ||
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 | Признак автоматического устройства |
Запрос выполняется для получения статус и ответа от ФНС для:
После выполнения запроса передачи в ФНС подписанного заявления, необходимо получить ответ от ФНС.
В зависимости от заявки, карточка с ответом от ФНС может иметь следующие ответы:
Запрос проверки статуса заявки позволяет получить ссылку на сформированный и подписанный документ с ответом от ФНС.
Запрос выполняется методом GET.
GET api/integration/v1/kkt/registration/{id:uuid}?AuthToken={authToken:string}
Заменяемые параметры:
Рассмотрим работу запрос на примере заявления на регистрацию кассы.
Пример запроса:
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 | Должность | ||
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 | Должность | ||
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 | Признак автоматического устройства |
После получения ответа от ФНС о присвоении РНМ, для завершения регистрации кассы требуется выполнить следующие действия:
Чтобы внести в заявку данные из отчета о регистрации необходимо воспользоваться запросом передача данных отчета о регистрации методом PUT.
Данные отчета передаются в формате JSON.
PUT /api/integration/v1/kkt/registration/{id:uuid}?AuthToken={authToken}
Заменяемые параметры:
Параметры запроса для передачи отчета о регистрации.
В параметре FiscalDocumentData передается структура со следующими параметрами:
Пример запроса:
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.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.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.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.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.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.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.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.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.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.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.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 г.
Первая отслеживаемая версия документа.