Метод позволяет получить список всех опубликованных доверенностей организации, при этом отфильтровать его по различным параметрам. Вернется массив доверенностей, по каждой доверенности будет указана краткая информация:

номер доверенности
формат доверенности
дата начала
дата окончания
данные о доверителе
- ИНН
- Наименование
- СНИЛС
- ОГРН
данные о представителях
- ИНН
- Наименование
- СНИЛС
- ОГРН
статус
признак возможности отмены доверенности
признак возможности скопировать доверенность
статус заявления на отмену, если такое есть
дата привязки доверенности к организации

Наименование параметра	Тип параметра	Значение	Дополнительно
Status	string	Фильтр по статусу доверенности. Принимает значения: WaitingForConfirmation Rejected Created Active Expired Revoked	WaitingForConfirmation - Ожидает подтверждения Rejected - Отказ в регистрации Created - Зарегистрирована Active - Действует Expired - Срок действия истек Revoked - Отменена
Type	string	Формат доверенности B2B - вернутся доверенности формата 1.01, 001, 002 B2G - вернутся доверенности формата 5.01 Unified - вернутся доверенности формата 003	Можно указать одновременно только один тип доверенности
SearchByPrincipal	string	Поиск по наименованию доверителя
SearchByRepresentative	string	Поиск по наименованию представителя
Search	string	Поиск по любому значению
Offset	integer($int32)	Отступ
Count	integer($int32)	Количество доверенностей

Код	Значение	Дополнительно
200	Success { "data": [ { "poaNumber": "string", "type": "B2B", "startDate": "2024-03-27T11:49:02.927Z", "endDate": "2024-03-27T11:49:02.927Z", "principals": [ { "inn": "string", "displayName": "string", "snils": "string", "ogrn": "string" } ], "representatives": [ { "inn": "string", "displayName": "string", "snils": "string", "ogrn": "string" } ], "status": "WaitingForConfirmation", "canBeCancelledNow": true, "canBeCopied": true, "cancellationTransactionStatus": "Pending", "linkedAt": "2024-03-27T11:49:02.927Z" } ], "meta": { "totalCount": 0 } }	Возвращается массив 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": "string", "creationDate": "2024-03-27T15:46:50.778Z", "data": "string", "principalsShortInfo": [ { "inn": "string", "displayName": "string", "snils": "string", "ogrn": "string" } ], "startDate": "2024-03-27T15:46:50.778Z", "endDate": "2024-03-27T15:46:50.778Z", "status": "WaitingForConfirmation", "currentStage": "ReceivedFromRegistry", "statusDate": "2024-03-27T15:46:50.778Z", "rejectionReason": "string", "canBeCancelledNow": true, "canBeCopied": true, "cancellationTransactionStatus": "Pending", "cancellationCurrentStage": "QueuedToSendToRegistry", "relationshipType": "B2B", "formatCoreVersion": "string" }	Возвращаются данные доверенности, содержащие следующие значения: poaNumber - номер доверенности creationDate - дата создания data - данные доверенности. В зависимости от формата доверенности data будет иметь разную модель данных principalsShortInfo - краткая информация по доверителю principalsShortInfo.inn - ИНН доверителя principalsShortInfo.displayName - наименование доверителя principalsShortInfo.snils - СНИЛС доверителя principalsShortInfo.ogrn - ОГРН доверителя startDate - дата свершения endDate - дата окончания status - статус доверенности currentStage - статус доверенности (черновика) в системе Астрал.Доверенность ReceivedFromRegistry /// Доверенность загружена из реестра Draft /// Черновик SentForSigning /// Доверенность отправлена на подписание SigningRejectedBySignatory /// Подписание доверенности отклонено доверителем SigningRejectedByRequester /// Запрос на подписание доверенности отменен SentToRegistry /// Доверенность подписана и отправлена в реестр RequestingFromRegistry /// Доверенность запрашивается из реестра FailedToReceiveFromRegistry /// По указанному ИНН доверителя не удалось получить полные данные доверенности из реестра QueuedToSendToRegistry /// Доверенность поставлена в очередь на отправку в реестр RejectedByRegistry /// Доверенность отклонена реестром statusDate - дата перехода в статус rejectionReason - причина отмены, если доверенность отменена canBeCancelledNow - возможность отмены доверенности canBeCopied - возможность копирования доверенности cancellationTransactionStatus - статус принятия заявления на отмену доверенности [Pending - в процессе, Success - Успешно, Failure - Отказ] cancellationCurrentStage - статус заявления на отмену доверенности, если оно есть, в системе Астрал.Доверенность QueuedToSendToRegistry - Заявление на отмену поставлено в очередь на отправку в реестр SentToRegistry - Заявление на отмену подписано и отправлено в реестр RejectedByRegistry - Заявление на отмену отклонено реестром relationshipType - формат доверенности. Принимает значения: B2B B2G Unified formatCoreVersion - версия модели данных формата доверенности. Принимает значения: B2B_coreV2 B2G_coreV1 Unified_coreV1 Соответствие 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": "string", "creationDate": "2024-03-29T08:06:44.820Z", "data": "string", "principalsShortInfo": [ { "inn": "string", "displayName": "string", "snils": "string", "ogrn": "string" } ], "startDate": "2024-03-29T08:06:44.820Z", "endDate": "2024-03-29T08:06:44.820Z", "status": "WaitingForConfirmation", "currentStage": "ReceivedFromRegistry", "statusDate": "2024-03-29T08:06:44.820Z", "rejectionReason": "string", "canBeCancelledNow": true, "canBeCopied": true, "cancellationTransactionStatus": "Pending", "cancellationCurrentStage": "QueuedToSendToRegistry", "relationshipType": "B2B", "formatCoreVersion": "string" }	Возвращаются данные доверенности, содержащие следующие значения: poaNumber - номер доверенности creationDate - дата создания data - данные доверенности. В зависимости от формата доверенности data будет иметь разную модель данных principalsShortInfo - краткая информация по доверителю principalsShortInfo.inn - ИНН доверителя principalsShortInfo.displayName - наименование доверителя principalsShortInfo.snils - СНИЛС доверителя principalsShortInfo.ogrn - ОГРН доверителя startDate - дата свершения endDate - дата окончания status - статус доверенности currentStage - статус доверенности (черновика) в системе Астрал.Доверенность ReceivedFromRegistry /// Доверенность загружена из реестра Draft /// Черновик SentForSigning /// Доверенность отправлена на подписание SigningRejectedBySignatory /// Подписание доверенности отклонено доверителем SigningRejectedByRequester /// Запрос на подписание доверенности отменен SentToRegistry /// Доверенность подписана и отправлена в реестр RequestingFromRegistry /// Доверенность запрашивается из реестра FailedToReceiveFromRegistry /// По указанному ИНН доверителя не удалось получить полные данные доверенности из реестра QueuedToSendToRegistry /// Доверенность поставлена в очередь на отправку в реестр RejectedByRegistry /// Доверенность отклонена реестром statusDate - дата перехода в статус rejectionReason - причина отмены, если доверенность отменена canBeCancelledNow - возможность отмены доверенности canBeCopied - возможность копирования доверенности cancellationTransactionStatus - статус принятия заявления на отмену доверенности [Pending - в процессе, Success - Успешно, Failure - Отказ] cancellationCurrentStage - статус заявления на отмену доверенности, если оно есть, в системе Астрал.Доверенность QueuedToSendToRegistry - Заявление на отмену поставлено в очередь на отправку в реестр SentToRegistry - Заявление на отмену подписано и отправлено в реестр RejectedByRegistry - Заявление на отмену отклонено реестром relationshipType - формат доверенности. Принимает значения: B2B B2G Unified formatCoreVersion - версия модели данных формата доверенности. Принимает значения: B2B_coreV2 B2G_coreV1 Unified_coreV1 Соответствие 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": "string", "startDate": "2024-03-27T16:27:48.047Z", "endDate": "2024-03-27T16:27:48.047Z", "poaStatus": "Created", "statusDate": "2024-03-27T16:27:48.047Z", "createdDate": "2024-03-27T16:27:48.047Z" }`	Возвращаются данные доверенности, содержащие следующие значения: poaNumber - номер доверенности creationDate - дата создания startDate - дата свершения endDate - дата окончания poaStatus - статус доверенности statusDate - дата перехода в текущий статус
400	BadRequest "title": "Доверенность не зарегистрирована в реестре", "status": 400, "detail": "Доверенность 7840885e-1881-4989-88c9-3571a173fbf4 не зарегистрирована в реестре ФНС", "instance": "/corporate-api/v1/poas/7840885e-1881-4989-88c9-3571a173fbf4%20%20/open-data", "errorCode": "POA-14002", "data": { "poaNumber": "7840885e-1881-4989-88c9-3571a173fbf4 " }, "contextId": "97c8fa44-9a7a-4b4e-8395-39cf4be342bb"	Неверный запрос
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": "Ошибка при взаимодействии с реестром. Повторите попытку позднее или свяжитесь с технической поддержкой", "status": 400, "detail": "Во время операции API ФНС вернуло ошибку: 'Не удалось получить данные доверенностей'. Повторите попытку позднее или свяжитесь с технической поддержкой", "instance": "/corporate-api/v1/poas/e830e679-47c8-421d-b63a-7ab31e41ef57/%7B4401165141/zip", "errorCode": "POA-14001", "data": { "description": "Не удалось получить данные доверенностей" }, "contextId": "b6574310-6b24-4273-a309-f0b5ccb46cae" }	Неверный запрос
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

Ответ:

e830e679-47c8-421d-b63a-7ab31e41ef57_4401165141.zip

Формирование XML файла черновика доверенности

POST/corporate-api/v1/poas/{poaNumber}/form

Метод позволяет сформировать XML файл черновика доверенности для предпросмотра перед отправкой в реестр или для внесения изменений, а также для создания открепленной подписи в собственной ИС.

Наименование параметра	Тип параметра	Значение	Дополнительно
poaNumber	string	Номер доверенности	Обязательный параметр

Код	Значение	Дополнительно
200	Success Файл доверенности в формате XML `<Доверенность xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn://x-artefacts/EMCHD_1 ON_EMCHD_1_928_00_01_01_01.xsd" ВерсФорм="EMCHD_1" ПрЭлФорм="00000000" ИдФайл="ON_EMCHD_20240331_bee25c68-f06c-441a-b1b3-9f28cf449212" xmlns="urn://x-artefacts/EMCHD_1">` `<Документ>` `<Довер>` `<СвДов ВидДовер="1" ПрПередов="3" ВнНомДовер="123" НомДовер="bee25c68-f06c-441a-b1b3-9f28cf449212" ДатаВыдДовер="2024-03-27" СрокДейст="2024-03-31">` `<СведСист>https://m4d.nalog.gov.ru/EMCHD/check-status?guid=bee25c68-f06c-441a-b1b3-9f28cf449212>` `<СвДоверит ТипДоверит="1">` `<Доверит>` `<РосОргДовер ЕИОУК="0" ЕИОФЛ="1" ЕИОИП="0">` `<СвРосОрг НаимОрг="_тест_АО "Ко &Овчинников"" ИННЮЛ="9654045503" КПП="999999998" ОГРН="1157451843560">` `<АдрРег Регион="53">` `<АдрРФ>Удмуртская Респ, Игринский р-н, тер ППБ Комсомолец` `<ЛицоБезДов ПолнЮЛ="1">` `<СвФЛ ИННФЛ="961160209502" СНИЛС="265-027-859 81">` `<СведФЛ>` `<ФИО Фамилия="Нёумова" Имя="Фёина" Отчество="Яковлёвна" />` `<СвУпПред ТипПред="1">` `<Пред>` `<СведОрг НаимОрг="ООО "Тест"" ИННЮЛ="9600562311" КПП="999901001" ОГРН="1273775454545" />` `<СвПолн ТипПолн="0" ПрСовмПолн="1" ПрУтрПолн="1">` `<ТекстПолн>Какие то важные полномочия`	Возвращается XML файл
400	BadRequest "title": "Черновик доверенности с таким номером не найден в базе данных", "status": 400, "instance": "/corporate-api/v1/poas/bee25c68-f06c-441a-b1b3-9f28cf449212%20%20/form", "errorCode": "POA-10004", "contextId": "1f99dcea-9162-4961-97fa-36506a840562"	Неверный запрос
401	Unauthorized	ApiKey отсутствует
403	Forbidden	Доступ запрещен
404	NotFound	Неверный URL
500	InternalServerError	An error has occured

Запрос:

/corporate-api/v1/poas/bee25c68-f06c-441a-b1b3-9f28cf449212/form

Ответ:

Дов_ec6403a0-8250-4904-a47a-0d8c1affbc7e.xml

Отправка в реестр доверенности организации

POST/corporate-api/v1/poas/{poaNumber}/send

Метод позволяет передать файлы доверенности на отправку в реестр. Необходимы следующие файлы:

XML файл доверенности;
SIG файл открепленной подписи к файлу XML доверенности.

Наименование параметра	Тип параметра	Значение	Дополнительно
poaNumber	string	Номер доверенности	Обязательный параметр

files

Код	Значение	Дополнительно
200	Success
400	BadRequest `{` `"title": "Для отправки запроса в реестр необходимо наличие 2 файлов: файла доверенности [формат xml] и открепленной подписи [формат sig]",` `"status": 400,` `"instance": "/corporate-api/v1/poas/b44081b6-e51d-4f82-a029-add2b05aecc3/send",` `"errorCode": "POA-10006",` `"contextId": "e9220562-70de-46a0-ab15-cc1238971d3a"` `}`	Неверный запрос
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"
}

Код	Значение	Дополнительно