Корпоративное API: Добавление доверенности из реестра СФР [SFR] по номеру и сертификату доверителя или представителя в Астрал.Доверенность | Помощь Астрал
Техподдержка:
Отдел продаж
График работы

Астрал.Доверенность: Добавление доверенности из реестра СФР [SFR] по номеру и сертификату доверителя или представителя

Автор Прошин Алексей

Автор: Прошин Алексей

12.08.2025
35
Из статьи вы узнаете:

Описание

POST/corporate-api/v1/poas/pull-from-sfr

Данный метод позволяет добавить в список Опубликованные доверенность, созданную в другой системе, зная ее номер, а также имея электронную подпись (УКЭП) доверителя или представителя. При этом доверенность должна быть размещена в реестре. 

Доверенность есть в базе данных А.Доверенность

Если доверенность есть в базе данных, то полная информация по ней вернется синхронно.

Доверенности нет в базе данных А.Доверенность

 Если доверенности нет в базе данных, то вернется только внутренняя информация (номер). При этом доверенность будет поставлена в очередь на притягивание из реестра. Полная информация по доверенности будет получена в промежуток времени от 15 мин до суток, в случае длительного ожидания необходимо обратиться в техническую поддержку.

Входные параметры

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

poaNumber 

string

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

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

Request body

requestFile

  • файл сформировать и подписать согласно правилам документации сэдо https://lk.fss.ru/sedo.html
  • формат запроса https://lk.fss.ru/mchd.html (Документооборот 203)
  • правила подписания https://lk.fss.ru/sedo.html
  • подпись может быть: доверителя или представителя
  • пример подписанного файла:
     

Формирование requestFile

Пример 

  string

№ п/п

Атрибут

Код

Описание

Отметка об обязательности

Тип

Пример данных

1.       

Идентификатор МЧД

uuid

Идентификатор доверенности

UUID 4я версия (случайный). 36 символов, разделенных на 4 блока дефисом «-».

По маске [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}

Да

c:UuidV1Type

84cff9ea-de0f-4841-8645-58620adf49b2

2.       

Блок информации об электронной подписи

certificate

Электронная метка, содержащая информацию об электронной подписи, в том числе о дате и времени подписания Эл.Доверенности (base 64)

Да

xs:string

 

Блок информации об электронной подписи формируется по стандарту XMLDSig, в соответствии OASIS Web Service Security: SOAP Message Security 1.1.

Подробнее см. в приложении.

Ответ

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

Success

{
  "poaNumber": "string",
  "creationDate": "2025-04-11T12:20:46.738Z",
  "data": "string",
  "principalsShortInfo": [
    {
      "inn": "string",
      "displayName": "string",
      "snils": "string",
      "ogrn": "string",
      "kpp": "string"
    }
  ],
  "startDate": "2025-04-11T12:20:46.738Z",
  "endDate": "2025-04-11T12:20:46.738Z",
  "status": "WaitingForConfirmation",
  "currentStage": "ReceivedFromRegistry",
  "statusDate": "2025-04-11T12:20:46.738Z",
  "rejectionReason": "string",
  "cancellationReason": "string",
  "receivingFailReason": "string",
  "canBeCancelledNow": true,
  "canBeCopied": true,
  "cancellationCurrentStage": "QueuedToSendToRegistry",
  "cancellationRejectionReason": "string",
  "poaRegistryType": "FNS",
  "relationshipType": "B2B",
  "formatCoreVersion": "string",
  "fnsStatus": "Unknown",
  "fnsRejectionReason": "string",
  "fnsStatusDateTime": "2025-04-11T12:20:46.738Z"
}

Возвращаются данные доверенности, содержащие следующие значения:

  • poaNumber - номер доверенности
  • creationDate - дата создания
  • data - данные доверенности. В зависимости от формата доверенности data будет иметь разную модель данных
  • principalsShortInfo - краткая информация по доверителю
    • principalsShortInfo.inn - ИНН доверителя
    • principalsShortInfo.displayName - наименование доверителя
    • principalsShortInfo.snils - СНИЛС доверителя
    • principalsShortInfo.ogrn - ОГРН доверителя
    • principalsShortInfo.kpp - ОГРН доверителя
  • startDate - дата свершения
  • endDate - дата окончания
  • status - статус доверенности
  • currentStage - статус доверенности в системе Астрал.Доверенность
  • statusDate - дата перехода в статус
  • rejectionReason - причина отмены, если доверенность отменена
  • cancellationReason - причина отмены доверенности
  • receivingFailReason - причина отказа при добавлении доверенности
  • canBeCancelledNow - возможность отмены доверенности
  • canBeCopied - возможность копирования доверенности
  • cancellationCurrentStage - статус заявления на отмену доверенности, если оно есть, в системе Астрал.Доверенность
  • cancellationRejectionReason - причина отклонения заявления на отмену
  • poaRegistryType - тип реестра
  • relationshipType - формат доверенности. 
  • formatCoreVersion - версия модели данных формата доверенности.
  • fnsStatus - статус направления ФНС для доверенности формата Unified 

  • fnsRejectionReason - причина отказано при статусе Rejected для доверенности формата Unified 

  • fnsStatusDateTime - дата регистрации или отказа направления ФНС для доверенности формата Unified 


Пример запроса

/corporate-api/v1/poas/pull-from-sfr?poaNumber=fc6bb7a2-751c-4e5b-bdef-f79986cf2429

get.xml

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

{
  "poa": {
    "principalsShortInfo": [],
    "startDate": "0001-01-01T00:00:00+00:00",
    "currentStage": "RequestingFromRegistry",
    "canBeCancelledNow": false,
    "canBeCopied": false,
    "poaRegistryType": "SFR",
    "relationshipType": "SFR",
    "poaNumber": "fc6bb7a2-751c-4e5b-bdef-f79986cf2429",
    "creationDate": "0001-01-01T00:00:00+00:00"
  }
Комментарии для сайта Cackle
Получите электронную подпись для работы на госпорталах, для участия в торгах и ЭДО

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

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

autohello-finger