Registration API
Группа методов для работы с сервисами регистрации абонентов.
Описание методов
Данный блок содержит подробное описание по каждому методу API.
[POST]/api/v2/registration
Регистрация организации по сертификату.
Основной сценарий Зарегистрировать организацию по сертификату.
Тело запроса
Тип запроса: multipart/form-data
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| certificateBody | Да | string(binary) | Открытая часть сертификата организации в формате Base64. |
| Да | string | Почта, с которой зарегистрирован аккаунт пользователя. | |
| tariffId | Нет | string | Идентификатор тарифа. |
| partnerCode | Нет | string | Код обслуживающей организации. |
| warrantNumber | Нет | string | Номер МЧД. |
| issuerInn | Нет | string | ИНН доверителя. |
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | RegistrationRequest | Информация по заявке на регистрацию |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 500 | Без данных | Внутренняя ошибка сервера. |
Пример успешного ответа
{
"id": "6a65415a-1a41-416c-ae18-cbdbb2175b87",
"abonentId": "8e26fb42-b2f1-45ed-b2ce-ab4c9308cbc5",
"creatorUserId": "07d3ba7c-d0aa-4cdc-bec4-236d2e180003",
"taxAuthority": {
"id": "7157f9f8-fd9d-425f-939e-bd06fd6e90af",
"code": "9999",
"name": "Межрайонная инспекция ФНС России № 2 по Республике Тестостан"
},
"status": "AwaitingPayment",
"partnerInfo": {
"code": 1,
"name": "АО \\\"Тестовый оператор\\\" ОПС ЭДО",
"phone": "8 (000) 000 00 00",
"email": "test@test.ru"
},
"inn": "9649563683",
"kpp": "000000000",
"ogrn": "0000000000000",
"organizationShortName": "Тестовое наименование организации",
"ipRegistrationCertificateNumber": "00 000000000",
"ipRegistrationDate": "2015-01-02",
"legalAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовый населённый пункт",
"street": "Тестовая улица",
"house": "404",
"housing": "А",
"apartment": "10"
},
"actualAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовый населённый пункт",
"street": "Тестовая улица",
"house": "404",
"housing": "А",
"apartment": "10"
},
"name": "Константин",
"surname": "Константинопольский",
"patronymic": "Константинович",
"snils": "138-050-393 43",
"position": "Директор",
"phone": "+70000000000",
"email": "test@test.ru",
"tariffs": [
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"extensions": [
"42F774E0-2325-45FA-A94D-F10A578A1EA0"
]
}
]
}
[GET]/api/v1/registration/requests
Получение списка заявок на подключение новых абонентов.
Основной сценарий Запросить заявки на подключение новых абонентов в систему ЭДО.
Параметры в строке запроса
| Название | Обязат. | Место | Тип | Описание |
|---|---|---|---|---|
| offset | Нет | Query | integer(int32) | Начальное значение списка. |
| count | Нет | Query | integer(int32) | Количество выводимых значений (По умолчанию: 15). |
| Inn | Нет | Query | string | ИНН организации. |
| Kpp | Нет | Query | string | КПП организации. |
| Status | Нет | Query | string | Статус заявки. |
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | RegistrationRequestShortResultList | Список заявок на регистрацию |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 500 | Без данных | Внутренняя ошибка сервера. |
Пример успешного ответа
{
"count": 1,
"data": [
{
"id": "a6a4bcd3-78c1-4504-a0c4-9cf18c5bb043",
"abonentId": "71067ff8-fc03-4309-abee-8cefb13103dd",
"inn": "9649563683",
"kpp": "000000000",
"organizationShortName": "Тестовое наименование организации",
"organizationFullName": "ООО \\\"Тестовое наименование организации\\\"",
"creationDate": "2022-02-11T13:03:05.670Z",
"status": "AwaitingPayment"
}
]
}
[GET]/api/v1/registration/requests/{registrationRequestId}
Получение информации по заявке на подключение нового абонента.
Основной сценарий Запросить информацию по заявке на подключение новых абонентов.
Параметры в строке запроса
| Название | Обязат. | Место | Тип | Описание |
|---|---|---|---|---|
| registrationRequestId | Да | Path | string(uuid) |
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | RegistrationRequest | Информация по заявке на подключение |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 404 | Без данных | Ресурс не найден. |
| 500 | Без данных | Внутренняя ошибка сервера. |
Пример успешного ответа
{
"id": "6a65415a-1a41-416c-ae18-cbdbb2175b87",
"abonentId": "8e26fb42-b2f1-45ed-b2ce-ab4c9308cbc5",
"creatorUserId": "07d3ba7c-d0aa-4cdc-bec4-236d2e180003",
"taxAuthority": {
"id": "7157f9f8-fd9d-425f-939e-bd06fd6e90af",
"code": "9999",
"name": "Межрайонная инспекция ФНС России № 2 по Республике Тестостан"
},
"status": "AwaitingPayment",
"partnerInfo": {
"code": 1,
"name": "АО \\\"Тестовый оператор\\\" ОПС ЭДО",
"phone": "8 (000) 000 00 00",
"email": "test@test.ru"
},
"inn": "9649563683",
"kpp": "000000000",
"ogrn": "0000000000000",
"organizationShortName": "Тестовое наименование организации",
"ipRegistrationCertificateNumber": "00 000000000",
"ipRegistrationDate": "2015-01-02",
"legalAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовый населённый пункт",
"street": "Тестовая улица",
"house": "404",
"housing": "А",
"apartment": "10"
},
"actualAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовый населённый пункт",
"street": "Тестовая улица",
"house": "404",
"housing": "А",
"apartment": "10"
},
"name": "Константин",
"surname": "Константинопольский",
"patronymic": "Константинович",
"snils": "138-050-393 43",
"position": "Директор",
"phone": "+70000000000",
"email": "test@test.ru",
"tariffs": [
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"extensions": [
"42F774E0-2325-45FA-A94D-F10A578A1EA0"
]
}
]
}
[PUT]/api/v1/registration/requests/{registrationRequestId}
Обновление выбранных реквизитов регистрационной заявки абонента с очисткой незаполненных реквизитов.
Основной сценарий Обновить заполненные реквизиты регистрационной заявки. Дополнительный сценарий Заполнить пустые реквизиты регистрационной заявки.
Параметры в строке запроса
| Название | Обязат. | Место | Тип | Описание |
|---|---|---|---|---|
| registrationRequestId | Да | Path | string(uuid) | Идентификатор заявки на регистрацию. |
Тело запроса
Тип запроса: application/json
Обновляемые параметры заявки на регистрацию.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| partnerCode | Нет | string | Код партнера. |
| kpp | Нет | string | КПП. Обязателен для ЮЛ. |
| taxAuthorityId | Нет | string | Идентификатор ИФНС. Обязателен для ЮЛ или ИП, имеющих ОГРН. |
| legalAddress | Нет | Одна из: AddressRequestArgs | Юридический адрес организации.Заполнять в формате “КЛАДР” |
| actualAddress | Нет | Одна из: AddressRequestArgs | Физический адрес организации.Обязателен для ЮЛ или ИП, имеющих ОГРН.Заполнять в формате “КЛАДР”. |
| Нет | string | Электронная почта организации. | |
| phone | Нет | string | Номер телефона организации. |
| ipRegistrationCertificateNumber | Нет | string | Номер свидельства о регистрации ИП.Обязателен для ИП, чей сертификат выдан до 2017 года. |
| ipRegistrationDate | Нет | date-time | Дата регистрации ИП.Обязателен для ИП, имеющих ОГРН. |
Пример модели
{
"partnerCode": "0000",
"kpp": "999901001",
"taxAuthorityId": "Строка",
"legalAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовое поселение",
"street": "Тестовая улица",
"house": "404",
"housing": "2",
"apartment": "1"
},
"actualAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовое поселение",
"street": "Тестовая улица",
"house": "404",
"housing": "2",
"apartment": "1"
},
"email": "test@test.ru",
"phone": "+70000000000",
"ipRegistrationCertificateNumber": "00 000000000",
"ipRegistrationDate": "2022-02-11T13:03:05.670Z"
}
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | Без данных | Заявка на регистрацию успешно обновлена. |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 404 | Без данных | Ресурс не найден. |
| 500 | Без данных | Внутренняя ошибка сервера. |
[PATCH]/api/v1/registration/requests/{registrationRequestId}
Обновление выбранных реквизитов регистрационной заявки абонента с игнорированием незаполненных реквизитов.
Основной сценарий Обновить заполненные реквизиты регистрационной заявки. Дополнительный сценарий Заполнить пустые реквизиты регистрационной заявки.
Параметры в строке запроса
| Название | Обязат. | Место | Тип | Описание |
|---|---|---|---|---|
| registrationRequestId | Да | Path | string(uuid) | Идентификатор заявки на регистрацию. |
Тело запроса
Тип запроса: application/json
Обновляемые параметры заявки на регистрацию.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| partnerCode | Нет | string | Код партнера. |
| kpp | Нет | string | КПП. Обязателен для ЮЛ. |
| taxAuthorityId | Нет | string | Идентификатор ИФНС. Обязателен для ЮЛ или ИП, имеющих ОГРН. |
| legalAddress | Нет | Одна из: AddressRequestArgs | Юридический адрес организации.Заполнять в формате “КЛАДР” |
| actualAddress | Нет | Одна из: AddressRequestArgs | Физический адрес организации.Обязателен для ЮЛ или ИП, имеющих ОГРН.Заполнять в формате “КЛАДР”. |
| Нет | string | Электронная почта организации. | |
| phone | Нет | string | Номер телефона организации. |
| ipRegistrationCertificateNumber | Нет | string | Номер свидельства о регистрации ИП.Обязателен для ИП, чей сертификат выдан до 2017 года. |
| ipRegistrationDate | Нет | date-time | Дата регистрации ИП.Обязателен для ИП, имеющих ОГРН. |
Пример модели
{
"partnerCode": "0000",
"kpp": "999901001",
"taxAuthorityId": "Строка",
"legalAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовое поселение",
"street": "Тестовая улица",
"house": "404",
"housing": "2",
"apartment": "1"
},
"actualAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовое поселение",
"street": "Тестовая улица",
"house": "404",
"housing": "2",
"apartment": "1"
},
"email": "test@test.ru",
"phone": "+70000000000",
"ipRegistrationCertificateNumber": "00 000000000",
"ipRegistrationDate": "2022-02-11T13:03:05.670Z"
}
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | Без данных | Заявка на регистрацию успешно обновлена. |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 404 | Без данных | Ресурс не найден. |
| 500 | Без данных | Внутренняя ошибка сервера. |
[DELETE]/api/v1/registration/requests/{registrationRequestId}
Удаление созданной заявки на регистрацию нового абонента.
Примечание — удалить заявку возможно только в статусе New или Rejected.
В случае попытки удаления заявки в любом другом статусе, система вернет сообщение об ошибке: “Невозможно удалить отправленную или принятую заявку на регистрацию”.
Основной сценарий Удалить созданную заявку на регистрацию.
Параметры в строке запроса
| Название | Обязат. | Место | Тип | Описание |
|---|---|---|---|---|
| registrationRequestId | Да | Path | string(uuid) | Идентификатор заявки на регистрацию. |
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | Без данных | Заявка на регистрацию успешно удалена. |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 404 | Без данных | Ресурс не найден. |
| 500 | Без данных | Внутренняя ошибка сервера. |
[POST]/api/v1/registration
Создание заявки на подключение абонента при помощи открытого ключа сертификата в формате Base64.
Основной сценарий Создать заявку на подключение нового абонента в системе ЭДО.
Тело запроса
Тип запроса: multipart/form-data
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| certificateBody | Да | string(binary) | Сертификат (в кодировке Base-64). |
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | RegistrationRequest | Информация по заявке на регистрацию |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 500 | Без данных | Внутренняя ошибка сервера. |
Пример успешного ответа
{
"id": "6a65415a-1a41-416c-ae18-cbdbb2175b87",
"abonentId": "8e26fb42-b2f1-45ed-b2ce-ab4c9308cbc5",
"creatorUserId": "07d3ba7c-d0aa-4cdc-bec4-236d2e180003",
"taxAuthority": {
"id": "7157f9f8-fd9d-425f-939e-bd06fd6e90af",
"code": "9999",
"name": "Межрайонная инспекция ФНС России № 2 по Республике Тестостан"
},
"status": "AwaitingPayment",
"partnerInfo": {
"code": 1,
"name": "АО \\\"Тестовый оператор\\\" ОПС ЭДО",
"phone": "8 (000) 000 00 00",
"email": "test@test.ru"
},
"inn": "9649563683",
"kpp": "000000000",
"ogrn": "0000000000000",
"organizationShortName": "Тестовое наименование организации",
"ipRegistrationCertificateNumber": "00 000000000",
"ipRegistrationDate": "2015-01-02",
"legalAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовый населённый пункт",
"street": "Тестовая улица",
"house": "404",
"housing": "А",
"apartment": "10"
},
"actualAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовый населённый пункт",
"street": "Тестовая улица",
"house": "404",
"housing": "А",
"apartment": "10"
},
"name": "Константин",
"surname": "Константинопольский",
"patronymic": "Константинович",
"snils": "138-050-393 43",
"position": "Директор",
"phone": "+70000000000",
"email": "test@test.ru",
"tariffs": [
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"extensions": [
"42F774E0-2325-45FA-A94D-F10A578A1EA0"
]
}
]
}
[PUT]/api/v1/registration/requests/{registrationRequestId}/tariff
Обновляет тариф у заявки на регистрацию нового абонента.
Основной сценарий Обновить тариф у регистрируемого абонента.
Параметры в строке запроса
| Название | Обязат. | Место | Тип | Описание |
|---|---|---|---|---|
| registrationRequestId | Да | Path | string(uuid) | Идентификатор заявки на регистрацию. |
Тело запроса
Тип запроса: application/json
Список тарифов. Тип контента: ChangeTariffsRequestArgs[array]
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | Без данных | Тариф в заявке на регистрацию успешно обновлен. |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 404 | Без данных | Ресурс не найден. |
| 500 | Без данных | Внутренняя ошибка сервера. |
[PUT]/api/v1/registration/requests/{registrationRequestId}/dispatch
Отправка регистрационной заявки на подключение в сервис Астрал.ЭДО.
Основной сценарий Отправить готовую заявку с выбранным тарифом на обработку.
Параметры в строке запроса
| Название | Обязат. | Место | Тип | Описание |
|---|---|---|---|---|
| registrationRequestId | Да | Path | string(uuid) | Идентификатор заявки на регистрацию. |
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | Без данных | Заявка на регистрацию успешно отправлена. |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 404 | Без данных | Ресурс не найден. |
| 500 | Без данных | Внутренняя ошибка сервера. |
[GET]/api/v1/registration/tariffs
Получение списка тарифов.
Основной сценарий Получить список действующих тарифов для работы в системе.
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | TariffInfoResultList | Список тарифов в системе. |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 500 | Без данных | Внутренняя ошибка сервера. |
Пример успешного ответа
{
"count": 1,
"data": [
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"name": "Промо",
"duration": 30,
"limit": 100
}
]
}
[GET]/api/v1/registration/tariffs/extensions
Получение списка расширений для тарифов.
Основной сценарий Получить список действующих расширений для тарифов для работы в системе.
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | TariffExtensionResultList | Список расширений для тарифов в системе. |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 500 | Без данных | Внутренняя ошибка сервера. |
Пример успешного ответа
{
"count": 1,
"data": [
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"name": "100",
"duration": 360,
"limit": 100
}
]
}
[GET]/api/v1/registration/tax-authority
Получение информации по списку ИФНС, зарегистрированных в системе.
Основной сценарий Получить список ИФНС с указанным идентификатором, кодом и наименованием конкретного налогового органа.
Параметры в строке запроса
| Название | Обязат. | Место | Тип | Описание |
|---|---|---|---|---|
| offset | Нет | Query | integer(int32) | Начальное значение списка. |
| count | Нет | Query | integer(int32) | Количество выводимых значений (По умолчанию: 15). |
| search | Нет | Query | string | Поисковая строка по наименованию/коду ИФНС. |
Возможные ответы метода
| Код | Тип | Описание |
|---|---|---|
| 200 | TaxAuthorityResultList | Список ИФНС. |
| 400 | Без данных | Переданы некорректные параметры запроса. |
| 401 | Без данных | Пользователь не авторизован. |
| 403 | Без данных | Отказано в доступе. |
| 500 | Без данных | Внутренняя ошибка сервера. |
Пример успешного ответа
{
"count": 1,
"data": [
{
"id": "7157f9f8-fd9d-425f-939e-bd06fd6e90af",
"code": "9999",
"name": "Межрайонная инспекция ФНС России № 2 по Республике Тестостан"
}
]
}
Описание дополнительных моделей
Данный блок содержит описание дополнительных моделей.
Address
Информация об адресе.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| postalIndex | Нет | string | Почтовый индекс. |
| regionCode | Да | string | Код региона. |
| regionName | Нет | string | Название региона. |
| area | Нет | string | Район. |
| city | Нет | string | Город.Это поле обязательно, если поле Settlement пустое. |
| settlement | Нет | string | Населенный пункт.Это поле обязательно, если поле City пустое. |
| street | Нет | string | Улица. |
| house | Нет | string | Дом. |
| housing | Нет | string | Корпус. |
| apartment | Нет | string | Квартира. |
Пример модели
{
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовый населённый пункт",
"street": "Тестовая улица",
"house": "404",
"housing": "А",
"apartment": "10"
}
AddressRequestArgs
Параметры запроса на изменение адреса.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| postalIndex | Нет | string | Почтовый индекс. |
| regionCode | Да | string | Код региона. |
| regionName | Нет | string | Название региона. |
| area | Нет | string | Район. |
| city | Нет | string | Город.Обязательное заполнение если не заполняется населенный пункт.Уловно обязательное значение. |
| settlement | Нет | string | Населенный пункт.Обязательное заполнение если не заполняется город.Уловно обязательное значение. |
| street | Нет | string | Улица. |
| house | Нет | string | Дом. |
| housing | Нет | string | Корпус. |
| apartment | Нет | string | Квартира. |
Пример модели
{
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовое поселение",
"street": "Тестовая улица",
"house": "404",
"housing": "2",
"apartment": "1"
}
ChangeTariffsRequestArgs
Параметры запроса на изменение тарифа.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| id | Да | string(uuid) | Идентификатор тарифа. |
| extensions | Нет | string(uuid)[array] | Список расширений. |
Пример модели
{
"id": "04843C66-B294-439B-A832-B1DDD9A23120",
"extensions": [
"42F774E0-2325-45FA-A94D-F10A578A1EA0"
]
}
PartnerInfo
Информация по партнеру.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| code | Да | integer(int32) | Код партнера. |
| name | Да | string | Наименование партнера. |
| phone | Нет | string | Номер телефона. |
| Нет | string | Электронная почта. |
Пример модели
{
"code": 1,
"name": "АО \\\"Тестовый оператор\\\" ОПС ЭДО",
"phone": "8 (000) 000 00 00",
"email": "test@test.ru"
}
RegistrationRequest
Информация о заявке на регистрацию абонента.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| id | Да | string(uuid) | Идентификатор заявки. |
| abonentId | Да | string(uuid) | Внутренний идентификатор абонента. |
| creatorUserId | Да | string(uuid) | Идентификатор пользователя, создавшего заявку. |
| taxAuthority | Нет | Одна из: TaxAuthority | Информация об ИФНС абонента. |
| status | Да | Одна из: RequestStatus | Статус заявки. |
| partnerInfo | Нет | Одна из: PartnerInfo | Информация о партнёре. |
| inn | Да | string | ИНН организации. |
| kpp | Нет | string | КПП организации. |
| ogrn | Нет | string | ОГРН организации. |
| organizationShortName | Да | string | Наименование организации. |
| ipRegistrationCertificateNumber | Нет | string | Номер свидетельства регистрации ИП. |
| ipRegistrationDate | Нет | string | Дата свидетельства регистрации ИП. |
| legalAddress | Да | Одна из: Address | Юридический адрес организации. |
| actualAddress | Да | Одна из: Address | Физический адрес организации. |
| name | Да | string | Имя владельца сертификата. |
| surname | Да | string | Фамилия владельца сертификата. |
| patronymic | Нет | string | Отчество владельца сертификата. |
| snils | Нет | string | СНИЛС владельца сертификата. |
| position | Нет | string | Должность владельца сертификата. |
| phone | Нет | string | Номер телефона организации. |
| Да | string | Электронный адрес организации. | |
| tariffs | Нет | Tariff[array] | Список тарифов. |
Пример модели
{
"id": "6a65415a-1a41-416c-ae18-cbdbb2175b87",
"abonentId": "8e26fb42-b2f1-45ed-b2ce-ab4c9308cbc5",
"creatorUserId": "07d3ba7c-d0aa-4cdc-bec4-236d2e180003",
"taxAuthority": {
"id": "7157f9f8-fd9d-425f-939e-bd06fd6e90af",
"code": "9999",
"name": "Межрайонная инспекция ФНС России № 2 по Республике Тестостан"
},
"status": "AwaitingPayment",
"partnerInfo": {
"code": 1,
"name": "АО \\\"Тестовый оператор\\\" ОПС ЭДО",
"phone": "8 (000) 000 00 00",
"email": "test@test.ru"
},
"inn": "9649563683",
"kpp": "000000000",
"ogrn": "0000000000000",
"organizationShortName": "Тестовое наименование организации",
"ipRegistrationCertificateNumber": "00 000000000",
"ipRegistrationDate": "2015-01-02",
"legalAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовый населённый пункт",
"street": "Тестовая улица",
"house": "404",
"housing": "А",
"apartment": "10"
},
"actualAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовый населённый пункт",
"street": "Тестовая улица",
"house": "404",
"housing": "А",
"apartment": "10"
},
"name": "Константин",
"surname": "Константинопольский",
"patronymic": "Константинович",
"snils": "138-050-393 43",
"position": "Директор",
"phone": "+70000000000",
"email": "test@test.ru",
"tariffs": [
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"extensions": [
"42F774E0-2325-45FA-A94D-F10A578A1EA0"
]
}
]
}
RegistrationRequestShort
Информация о заявке на регистрацию абонента.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| id | Нет | string(uuid) | Идентификатор заявки на регистрацию. |
| abonentId | Нет | string(uuid) | Внутренний идентификатор регистрируемого абонента. |
| inn | Нет | string | ИНН организации. |
| kpp | Нет | string | КПП организации. |
| organizationShortName | Нет | string | Краткое наименование регистрируемой организации. |
| organizationFullName | Нет | string | Наименование регистрируемой организации. |
| creationDate | Нет | date-time-offset | Дата создания заявки. |
| status | Нет | Одна из: RequestStatus | Статус заявки. |
Пример модели
{
"id": "a6a4bcd3-78c1-4504-a0c4-9cf18c5bb043",
"abonentId": "71067ff8-fc03-4309-abee-8cefb13103dd",
"inn": "9649563683",
"kpp": "000000000",
"organizationShortName": "Тестовое наименование организации",
"organizationFullName": "ООО \\\"Тестовое наименование организации\\\"",
"creationDate": "2022-02-11T13:03:05.670Z",
"status": "AwaitingPayment"
}
RegistrationRequestShortResultList
Список с результатом поиска.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| count | Да | integer(int32) | Количество элементов в результате. |
| data | Да | RegistrationRequestShort[array] | Список элементов в результате. |
Пример модели
{
"count": 1,
"data": [
{
"id": "a6a4bcd3-78c1-4504-a0c4-9cf18c5bb043",
"abonentId": "71067ff8-fc03-4309-abee-8cefb13103dd",
"inn": "9649563683",
"kpp": "000000000",
"organizationShortName": "Тестовое наименование организации",
"organizationFullName": "ООО \\\"Тестовое наименование организации\\\"",
"creationDate": "2022-02-11T13:03:05.670Z",
"status": "AwaitingPayment"
}
]
}
RequestStatus
Статус заявки на подключение нового абонента.
| Значение | Описание |
|---|---|
| Accepted | Принята. |
| AwaitingPayment | Ожидает оплаты. |
| New | Новая. |
| Rejected | Отменена. |
| Removed | Удалена. |
| Sent | Отправлена. |
Tariff
Информация о тарифе.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| id | Да | string(uuid) | Идентификатор тарифа. |
| extensions | Нет | string(uuid)[array] | Список идентификаторов расширений. |
Пример модели
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"extensions": [
"42F774E0-2325-45FA-A94D-F10A578A1EA0"
]
}
TariffExtension
Детальная информация о расширении для тарифа.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| id | Да | string(uuid) | Идентификатор расширения для тарифа. |
| name | Да | string | Наименование расширения для тарифа. |
| duration | Да | integer(int32) | Срок действия расширения для тарифа в днях. |
| limit | Да | integer(int32) | Лимит документов в расширении для тарифа. |
Пример модели
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"name": "100",
"duration": 360,
"limit": 100
}
TariffExtensionResultList
Список с результатом поиска.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| count | Да | integer(int32) | Количество элементов в результате. |
| data | Да | TariffExtension[array] | Список элементов в результате. |
Пример модели
{
"count": 1,
"data": [
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"name": "100",
"duration": 360,
"limit": 100
}
]
}
TariffInfo
Детальная информация о тарифе.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| id | Да | string(uuid) | Идентификатор тарифа. |
| name | Да | string | Наименование тарифа. |
| duration | Да | integer(int32) | Срок действия тарифа в днях. |
| limit | Да | integer(int32) | Лимит документов в тарифе. |
Пример модели
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"name": "Промо",
"duration": 30,
"limit": 100
}
TariffInfoResultList
Список с результатом поиска.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| count | Да | integer(int32) | Количество элементов в результате. |
| data | Да | TariffInfo[array] | Список элементов в результате. |
Пример модели
{
"count": 1,
"data": [
{
"id": "68b09b27-5701-47ed-8468-98886351473b",
"name": "Промо",
"duration": 30,
"limit": 100
}
]
}
TaxAuthority
Информация об ИФНС.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| id | Да | string(uuid) | Идентификатор налогового органа. |
| code | Да | string | Код налогового органа. |
| name | Да | string | Наименование налогового органа. |
Пример модели
{
"id": "7157f9f8-fd9d-425f-939e-bd06fd6e90af",
"code": "9999",
"name": "Межрайонная инспекция ФНС России № 2 по Республике Тестостан"
}
TaxAuthorityResultList
Список с результатом поиска.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| count | Да | integer(int32) | Количество элементов в результате. |
| data | Да | TaxAuthority[array] | Список элементов в результате. |
Пример модели
{
"count": 1,
"data": [
{
"id": "7157f9f8-fd9d-425f-939e-bd06fd6e90af",
"code": "9999",
"name": "Межрайонная инспекция ФНС России № 2 по Республике Тестостан"
}
]
}
UpdateRegistrationRequestArgs
Параметры запроса на изменение заявки на регистрацию.
| Название | Обязат. | Тип | Описание |
|---|---|---|---|
| partnerCode | Нет | string | Код партнера. |
| kpp | Нет | string | КПП. Обязателен для ЮЛ. |
| taxAuthorityId | Нет | string | Идентификатор ИФНС. Обязателен для ЮЛ или ИП, имеющих ОГРН. |
| legalAddress | Нет | Одна из: AddressRequestArgs | Юридический адрес организации.Заполнять в формате “КЛАДР” |
| actualAddress | Нет | Одна из: AddressRequestArgs | Физический адрес организации.Обязателен для ЮЛ или ИП, имеющих ОГРН.Заполнять в формате “КЛАДР”. |
| Нет | string | Электронная почта организации. | |
| phone | Нет | string | Номер телефона организации. |
| ipRegistrationCertificateNumber | Нет | string | Номер свидельства о регистрации ИП.Обязателен для ИП, чей сертификат выдан до 2017 года. |
| ipRegistrationDate | Нет | date-time | Дата регистрации ИП.Обязателен для ИП, имеющих ОГРН. |
Пример модели
{
"partnerCode": "0000",
"kpp": "999901001",
"taxAuthorityId": "Строка",
"legalAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовое поселение",
"street": "Тестовая улица",
"house": "404",
"housing": "2",
"apartment": "1"
},
"actualAddress": {
"postalIndex": "000000",
"regionCode": "000",
"regionName": "Тестовый регион",
"area": "Тестовый район",
"city": "Тестовый город",
"settlement": "Тестовое поселение",
"street": "Тестовая улица",
"house": "404",
"housing": "2",
"apartment": "1"
},
"email": "test@test.ru",
"phone": "+70000000000",
"ipRegistrationCertificateNumber": "00 000000000",
"ipRegistrationDate": "2022-02-11T13:03:05.670Z"
}