Корпоративное API: Работа с доверенностями в Астрал.Доверенность | Помощь Астрал
Техподдержка:
8 (800) 551-80-36

Техподдержка
Отдел продаж
8 (800) 600-36-51

moscow@astral.ru
График работы

Астрал.Доверенность: Работа с доверенностями

Автор Чижова Юлия

Автор: Чижова Юлия

27.04.2024
1304
Из статьи вы узнаете:

Получение списка опубликованных доверенностей

GET/corporate-api/v1/poas/published

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

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

Status

string

Фильтр по статусу доверенности. Принимает значения:

  • WaitingForConfirmation
  • Rejected
  • Created
  • Active
  • Expired
  • Revoked
  1. WaitingForConfirmation - Ожидает подтверждения
  2. Rejected - Отказ в регистрации
  3. Created - Зарегистрирована
  4. Active - Действует
  5. Expired - Срок действия истек
  6. 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 - общее число найденных черновиков

400BadRequestНеверный запрос
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundНеверный URL
500InternalServerErrorAn 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

400BadRequestНеверный запрос
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundНеверный URL
500InternalServerErrorAn 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

400BadRequestНеверный запрос
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundНеверный URL
500InternalServerErrorAn 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"

Неверный запрос
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundНеверный URL
500InternalServerErrorAn 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"
}

Неверный запрос
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundНеверный URL
500InternalServerErrorAn 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"

Неверный запрос
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundНеверный URL
500InternalServerErrorAn 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"
}

Неверный запрос
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundНеверный URL
500InternalServerErrorAn 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


<Файл ВерсФорм="001">
  <Документ>
    <СвЗаяв НомДовер="ce99cd7b-184a-4ae8-91ab-42d695bac6e0" ПричОтз="тест" />
    <СвЗаявит>
      <СвДоверит>
        <РосОргДовер НаимОрг="ООО "Ромашка"" ОГРН="1184910001462" ИННЮЛ="4909128502" КПП="490901001" />
     
   
 

Возвращается XML файл

400

BadRequest

{
    "title": "Доверенность с таким номером не найдена в базе данных",
    "status": 400,
    "instance": "/corporate-api/v1/poas/create-cancellation",
    "errorCode": "POA-10003",
    "contextId": "fbb4dbfb-0cff-4574-b823-bc085dd2a683"
}

Неверный запрос
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundНеверный URL
500InternalServerErrorAn error has occured

Запрос:

{
  "poaNumber": "ce99cd7b-184a-4ae8-91ab-42d695bac6e0",
  "reason": "тест"
}

Ответ:

revoke_ce99cd7b-184a-4ae8-91ab-42d695bac6e0.xml

Отправка заявления на отзыв доверенности

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

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

  • XML файл заявления;
  • SIG файл открепленной подписи к файлу XML заявления.
Наименование параметраТип параметраЗначениеДополнительно

poaNumber 

string

Номер доверенности

Обязательный параметр

files

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

Success


400

BadRequest

{
    "title": "Доверенность уже была отозвана",
    "status": 400,
    "instance": "/corporate-api/v1/poas/b44081b6-e51d-4f82-a029-add2b05aecc3/send-cancellation",
    "errorCode": "POA-10018",
    "contextId": "f67d8249-a2d5-48f0-af10-39c6aeed5c25"
}

 
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundДанные не найдены
500InternalServerErrorAn 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
  • PDF

По умолчанию (без указания параметров) возвращает файл в формате XML.

Наименование параметраТип параметраЗначениеДополнительно

poaNumber 

string

Номер доверенности

Обязательный параметр

issuerInn 

string

ИНН доверителя

Обязательный параметр

format

string

Требуемый формат файла

Принимает значения:

XML, ZIP, HTML, PDF

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

Success

Файл

Возвращается файл

400

BadRequest

{
    "title": "Доверенность с таким номером не найдена в базе данных",
    "status": 400,
    "instance": "/corporate-api/v1/poas/ce99cd7b-184a-4ae8-91ab-42d695bac6e0%20%20/4909128502/file",
    "errorCode": "POA-10003",
    "contextId": "897d164f-c2af-475d-a95b-38d8302c9907"
}

 
401UnauthorizedApiKey отсутствует
403ForbiddenДоступ запрещен
404NotFoundДанные не найдены
500InternalServerErrorAn error has occured

Запрос:

corporate-api/v1/poas/ce99cd7b-184a-4ae8-91ab-42d695bac6e0/4909128502/file?format=Pdf

Ответ:

poa_ce99cd7b-184a-4ae8-91ab-42d695bac6e0_4909128502.pdf

Комментарии для сайта Cackle

Хотите разобраться
в сервисах Астрал?

Подробные инструкции,
решения проблем
и ответы на вопросы
в Базе знаний
autohello-finger