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