Ссылка для быстрого доступа к этой статье
Получение ссылки для загрузки PDF...
Ошибка при запросе PDF!
Перезагрузите страницу и попробуйте ещё раз
Работа с доверенностями
Получение списка опубликованных доверенностей
GET/corporate-api/v1/poas/published
Метод позволяет получить список всех опубликованных доверенностей организации, при этом отфильтровать его по различным параметрам. Вернется массив доверенностей, по каждой доверенности будет указана краткая информация:
- номер доверенности
- формат доверенности
- дата начала
- дата окончания
- данные о доверителе
- ИНН
- Наименование
- СНИЛС
- ОГРН
- данные о представителях
- ИНН
- Наименование
- СНИЛС
- ОГРН
- статус
- признак возможности отмены доверенности
- признак возможности скопировать доверенность
- статус заявления на отмену, если такое есть
- дата привязки доверенности к организации
Наименование параметра | Тип параметра | Значение | Дополнительно |
---|---|---|---|
Status | string | Фильтр по статусу доверенности. Принимает значения:
|
|
Type | string | Формат доверенности
| Можно указать одновременно только один тип доверенности |
SearchByPrincipal | string | Поиск по наименованию доверителя | |
SearchByRepresentative | string | Поиск по наименованию представителя | |
Search | string | Поиск по любому значению | |
Offset | integer($int32) | Отступ | |
Count | integer($int32) | Количество доверенностей |
Код | Значение | Дополнительно |
---|---|---|
200 | Success
| Возвращается массив data кратких данных по каждой доверенности, содержащий следующие значения: poaNumber - номер черновика доверенности type - формат доверенности [B2B, B2G, Unified] startDate - дата свершения endDate - дата окончания principals - сведения о доверителе principals.inn - ИНН доверителя principals.displayName - наименование доверителя principals.snils - СНИЛС доверителя principals.ogrn - ОГРН доверителя representatives - сведения о представителях representatives.inn - ИНН представителя representatives.displayName - наименование представителя representatives.snils - СНИЛС представителя representatives.ogrn - ОГРН представителя status- статус доверенности [WaitingForConfirmation, Rejected, Created, Active, Expired, Revoked] canBeCancelledNow - возможность отмены доверенности canBeCopied - возможность копирования доверенности cancellationTransactionStatus - статус заявления на отмену доверенности [Pending, Success, Failure] linkedAt - дата привязки доверенности к организации (добавление или создание) meta - служебная информация totalCount - общее число найденных черновиков |
400 | BadRequest | Неверный запрос |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Неверный URL |
500 | InternalServerError | An error has occured |
Запрос:
/corporate-api/v1/poas/published?Status=Active
Ответ:
{
"data": [
{
"status": "Created",
"canBeCancelledNow": true,
"canBeCopied": false,
"linkedAt": "2024-03-27T13:23:54.061102+00:00",
"poaNumber": "1662ba19-b06b-4e6b-9a81-bb128826fcec",
"type": "B2B",
"startDate": "2025-08-11T00:00:00+00:00",
"endDate": "2029-09-10T00:00:00+00:00",
"principals": [
{
"inn": "4909128502",
"displayName": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОМАШКА\"",
"ogrn": "1184910001462"
}
],
"representatives": [
{
"inn": "665901828890",
"displayName": "Соловьёв Петр Александрович",
"snils": "385-206-419 84"
}
]
}
],
"meta": {
"totalCount": 1
}
}
Получение полной информации по доверенности
GET/corporate-api/v1/poas/{poaNumber}
Метод позволяет получить полные данные конкретной доверенности.
Наименование параметра | Тип параметра | Значение | Дополнительно |
---|---|---|---|
poaNumber | string | Номер доверенности | Обязательный параметр |
Код | Значение | Дополнительно |
---|---|---|
200 | Success
| Возвращаются данные доверенности, содержащие следующие значения: poaNumber - номер доверенности creationDate - дата создания data - данные доверенности. В зависимости от формата доверенности data будет иметь разную модель данных principalsShortInfo - краткая информация по доверителю principalsShortInfo.inn - ИНН доверителя principalsShortInfo.displayName - наименование доверителя principalsShortInfo.snils - СНИЛС доверителя principalsShortInfo.ogrn - ОГРН доверителя startDate - дата свершения endDate - дата окончания status - статус доверенности currentStage - статус доверенности (черновика) в системе Астрал.Доверенность
statusDate - дата перехода в статус rejectionReason - причина отмены, если доверенность отменена canBeCancelledNow - возможность отмены доверенности canBeCopied - возможность копирования доверенности cancellationTransactionStatus - статус принятия заявления на отмену доверенности [Pending - в процессе, Success - Успешно, Failure - Отказ] cancellationCurrentStage - статус заявления на отмену доверенности, если оно есть, в системе Астрал.Доверенность
relationshipType - формат доверенности. Принимает значения:
formatCoreVersion - версия модели данных формата доверенности. Принимает значения:
Соответствие relationshipType и formatCoreVersion B2B - B2B_coreV2 B2G - B2G_coreV1 Unified - Unified_coreV1 |
400 | BadRequest | Неверный запрос |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Неверный URL |
500 | InternalServerError | An error has occured |
Запрос:
corporate-api/v1/poas/b1c2ebe1-9ed2-4462-a6e1-89051f6cd9fa
Ответ:
{
"principalsShortInfo": [
{
"inn": "9654045503",
"displayName": "_тест_АО \"Ко &Овчинников\"",
"ogrn": "1157451843560"
}
],
"startDate": "2024-02-06T00:00:00+00:00",
"endDate": "2024-02-14T00:00:00+00:00",
"status": "Rejected",
"currentStage": "RejectedByRegistry",
"statusDate": "2024-02-06T07:55:37.231636+00:00",
"rejectionReason": "Указанное в доверенности лицо, как действующее от имени организации без доверенности, в ЕГРЮЛ отсутствует у данной организации",
"canBeCancelledNow": false,
"canBeCopied": true,
"relationshipType": "B2G",
"formatCoreVersion": "coreV1",
"poaNumber": "b1c2ebe1-9ed2-4462-a6e1-89051f6cd9fa",
"creationDate": "2024-02-05T09:42:26.927668+00:00",
"data": {
"endDate": "2024-02-14T00:00:00+00:00",
"principal": {
"principalType": "RusOrganization",
"privatePerson": null,
"rusOrganization": {
"inn": "9654045503",
"kpp": "999999998",
"name": "_тест_АО \"Ко &Овчинников\"",
"ogrn": "1157451843560",
"address": "Удмуртская Респ, Игринский р-н, тер ППБ Комсомолец",
"individual": {
"inn": "961160209502",
"snils": "265-027-859 81",
"position": null,
"birthDate": null,
"nationality": null
},
"isPresentManagingOrg": false,
"managingOrganization": null
},
"foreignOrganization": null
},
"startDate": "2024-02-06T00:00:00+00:00",
"representative": {
"individual": {
"inn": "961465501822",
"snils": "593-241-708 01",
"ogrnip": null,
"birthDate": "2001-02-01T00:00:00+00:00",
"identityDocument": {
"issuerCode": null,
"issuerName": "УМВД",
"dateOfIssue": "2024-02-03T00:00:00+00:00",
"documentType": "19",
"numberSeries": "11 11 111111"
},
"nationalityCountryCode": null,
"representativeCredentials": {
"name": "Григорий",
"surname": "Мартынов",
"patronymic": null
}
},
"empowermentCodes": [
"08"
],
"representativeOrganization": {
"inn": "9611463520",
"kpp": "999901001",
"name": "АО \"Осень\"",
"ogrn": "1273775454545"
},
"representativeIsOrganization": true
},
"signatoryCredentials": {
"name": "Фёина",
"surname": "Нёумова",
"patronymic": "Яковлёвна"
},
"submitTaxAuthorityCode": "0001",
"targetTaxAuthorityCodes": [
"0001"
]
}
}
Добавление доверенности по номеру и ИНН доверителя
GET/corporate-api/v1/poas/{poaNumber}/{issuerInn}
Метод позволяет добавить в список "Опубликованные" доверенность, созданную в другой системе, зная ее номер и ИНН доверителя. При этом доверенность должна быть размещена в реестре.
Наименование параметра | Тип параметра | Значение | Дополнительно |
---|---|---|---|
poaNumber | string | Номер доверенности | Обязательный параметр |
issuerInn | string | ИНН доверителя | Обязательный параметр |
Код | Значение | Дополнительно |
---|---|---|
200 | Success
| Возвращаются данные доверенности, содержащие следующие значения: poaNumber - номер доверенности creationDate - дата создания data - данные доверенности. В зависимости от формата доверенности data будет иметь разную модель данных principalsShortInfo - краткая информация по доверителю principalsShortInfo.inn - ИНН доверителя principalsShortInfo.displayName - наименование доверителя principalsShortInfo.snils - СНИЛС доверителя principalsShortInfo.ogrn - ОГРН доверителя startDate - дата свершения endDate - дата окончания status - статус доверенности currentStage - статус доверенности (черновика) в системе Астрал.Доверенность
statusDate - дата перехода в статус rejectionReason - причина отмены, если доверенность отменена canBeCancelledNow - возможность отмены доверенности canBeCopied - возможность копирования доверенности cancellationTransactionStatus - статус принятия заявления на отмену доверенности [Pending - в процессе, Success - Успешно, Failure - Отказ] cancellationCurrentStage - статус заявления на отмену доверенности, если оно есть, в системе Астрал.Доверенность
relationshipType - формат доверенности. Принимает значения:
formatCoreVersion - версия модели данных формата доверенности. Принимает значения:
Соответствие relationshipType и formatCoreVersion B2B - B2B_coreV2 B2G - B2G_coreV1 Unified - Unified_coreV1 |
400 | BadRequest | Неверный запрос |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Неверный URL |
500 | InternalServerError | An error has occured |
Запрос:
corporate-api/v1/poas/ce99cd7b-184a-4ae8-91ab-42d695bac6e0/4909128502
Ответ:
{
"principalsShortInfo": [
{
"inn": "4909128502"
}
],
"startDate": "2024-04-01T00:00:00+00:00",
"endDate": "2024-12-31T00:00:00+00:00",
"status": "Active",
"currentStage": "RequestingFromRegistry",
"statusDate": "2024-04-01T00:00:00+00:00",
"canBeCancelledNow": false,
"canBeCopied": false,
"poaNumber": "536b3a91-a060-42d8-b78c-9b96b4d89a6d",
"creationDate": "2024-04-01T07:20:36.533698+00:00"
}
Получение открытых данных доверенности
GET/corporate-api/v1/poas/{poaNumber}/open-data
Метод позволяет проверить статус доверенности, зная ее номер, а также получить некоторые открытые данные. В список "Опубликованные" доверенность при запросе не добавляется.
Наименование параметра | Тип параметра | Значение | Дополнительно |
---|---|---|---|
poaNumber | string | Номер доверенности | Обязательный параметр |
Код | Значение | Дополнительно |
---|---|---|
200 | Success
| Возвращаются данные доверенности, содержащие следующие значения: poaNumber - номер доверенности creationDate - дата создания startDate - дата свершения endDate - дата окончания poaStatus - статус доверенности statusDate - дата перехода в текущий статус |
400 | BadRequest "title": "Доверенность не зарегистрирована в реестре", | Неверный запрос |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Неверный URL |
500 | InternalServerError | An error has occured |
Запрос:
/corporate-api/v1/poas/7840885e-1881-4989-88c9-3571a173fbf4/open-data
Ответ:
{
"poaNumber": "7840885e-1881-4989-88c9-3571a173fbf4",
"startDate": "2024-03-27T00:00:00+00:00",
"endDate": "2024-05-01T00:00:00+00:00",
"poaStatus": "Active",
"statusDate": "2024-03-27T00:00:00+00:00",
"createdDate": "2024-03-27T00:00:00+00:00"
}
Получение архива доверенности
GET/corporate-api/v1/poas/{poaNumber}/{issuerInn}/zip
Метод позволяет получить ZIP файл, содержащий все файлы по доверенности.
Наименование параметра | Тип параметра | Значение | Дополнительно |
---|---|---|---|
poaNumber | string | Номер доверенности | Обязательный параметр |
issuerInn | string | ИНН доверителя | Обязательный параметр |
Код | Значение | Дополнительно |
---|---|---|
200 | Success Файл в формате ZIP | Возвращается ZIP файл |
400 | BadRequest "title": "Ошибка при взаимодействии с реестром. Повторите попытку позднее или свяжитесь с технической поддержкой", | Неверный запрос |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Неверный URL |
500 | InternalServerError | An error has occured |
Запрос:
corporate-api/v1/poas/e830e679-47c8-421d-b63a-7ab31e41ef57/4401165141/zip
Ответ:
Формирование XML файла черновика доверенности
POST/corporate-api/v1/poas/{poaNumber}/form
Метод позволяет сформировать XML файл черновика доверенности для предпросмотра перед отправкой в реестр или для внесения изменений, а также для создания открепленной подписи в собственной ИС.
Наименование параметра | Тип параметра | Значение | Дополнительно |
---|---|---|---|
poaNumber | string | Номер доверенности | Обязательный параметр |
Код | Значение | Дополнительно |
---|---|---|
200 | Success Файл доверенности в формате XML
| Возвращается XML файл |
400 | BadRequest "title": "Черновик доверенности с таким номером не найден в базе данных", | Неверный запрос |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Неверный URL |
500 | InternalServerError | An error has occured |
Запрос:
/corporate-api/v1/poas/bee25c68-f06c-441a-b1b3-9f28cf449212/form
Ответ:
Отправка в реестр доверенности организации
POST/corporate-api/v1/poas/{poaNumber}/send
Метод позволяет передать файлы доверенности на отправку в реестр. Необходимы следующие файлы:
- XML файл доверенности;
- SIG файл открепленной подписи к файлу XML доверенности.
Наименование параметра | Тип параметра | Значение | Дополнительно |
---|---|---|---|
poaNumber | string | Номер доверенности | Обязательный параметр |
files
Код | Значение | Дополнительно |
---|---|---|
200 | Success | |
400 | BadRequest
| Неверный запрос |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Неверный URL |
500 | InternalServerError | An error has occured |
Запрос:
/corporate-api/v1/poas/b44081b6-e51d-4f82-a029-add2b05aecc3/send
form-data: files
poa_b44081b6-e51d-4f82-a029-add2b05aecc3.xml
poa_b44081b6-e51d-4f82-a029-add2b05aecc3.xml.sig
Ответ:
–
Создание xml-файла заявления на отмену доверенности
POST/corporate-api/v1/poas/create-cancellation
Метод позволяет сформировать XML файл заявления на отмену доверенности для предпросмотра перед отправкой в реестр или для внесения изменений, а также для создания открепленной подписи в собственной ИС.
{
"poaNumber": "string",
"reason": "string"
}
Код | Значение | Дополнительно |
---|---|---|
200 | Success Файл заявления в формате XML
| Возвращается XML файл |
400 | BadRequest { | Неверный запрос |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Неверный URL |
500 | InternalServerError | An error has occured |
Запрос:
{
"poaNumber": "ce99cd7b-184a-4ae8-91ab-42d695bac6e0",
"reason": "тест"
}
Ответ:
Отправка заявления на отзыв доверенности
POST/corporate-api/v1/poas/{poaNumber}/send-cancellation
Метод позволяет передать файлы заявления на отмену доверенности на отправку в реестр. Необходимы следующие файлы:
- XML файл заявления;
- SIG файл открепленной подписи к файлу XML заявления.
Наименование параметра | Тип параметра | Значение | Дополнительно |
---|---|---|---|
poaNumber | string | Номер доверенности | Обязательный параметр |
files
Код | Значение | Дополнительно |
---|---|---|
200 | Success | |
400 | BadRequest
| |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Данные не найдены |
500 | InternalServerError | An error has occured |
Запрос:
/corporate-api/v1/poas/b44081b6-e51d-4f82-a029-add2b05aecc3/send-cancellation
form-data:files
revoke_b1483d03-1230-466f-95c4-bb94e247f4a4.sig
revoke_b1483d03-1230-466f-95c4-bb94e247f4a4.xml
Ответ:
–
Скачивание файла доверенности в различных форматах
GET/corporate-api/v1/poas/{poaNumber}/{issuerInn}/file
Метод позволяет получить файл доверенности в одном из доступных форматов:
- XML
- ZIP
- HTML
По умолчанию (без указания параметров) возвращает файл в формате XML.
Наименование параметра | Тип параметра | Значение | Дополнительно |
---|---|---|---|
poaNumber | string | Номер доверенности | Обязательный параметр |
issuerInn | string | ИНН доверителя | Обязательный параметр |
format | string | Требуемый формат файла | Принимает значения: XML, ZIP, HTML, PDF |
Код | Значение | Дополнительно |
---|---|---|
200 | Success Файл | Возвращается файл |
400 | BadRequest
| |
401 | Unauthorized | ApiKey отсутствует |
403 | Forbidden | Доступ запрещен |
404 | NotFound | Данные не найдены |
500 | InternalServerError | An error has occured |
Запрос:
corporate-api/v1/poas/ce99cd7b-184a-4ae8-91ab-42d695bac6e0/4909128502/file?format=Pdf
Ответ:
Обновлено: 27.04.2024 11:42+0000