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

Астрал.Доверенность: Добавление доверенности из реестра ЦПРР [FNS] по номеру, ИНН доверителя, ИНН представителя

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

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

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

Описание

GET/corporate-api/v1/poas/pull-from-fns

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

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

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

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

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

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

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

poaNumber 

string

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

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

issuerInn 

string

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

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

representativeInn 

string

ИНН представителя

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

Ответ

КодЗначениеДополнительно
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-fns?poaNumber=c8db1fbc-872b-4ac5-bba9-3c5ccca634ea&issuerInn=9729053920&representativeInn=503610985968

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

{
  "poa": {
    "principalsShortInfo": [
      {
        "inn": "9729053920"
      }
    ],
    "startDate": "2025-04-14T00:00:00+03:00",
    "endDate": "2026-06-16T23:59:59.999+03:00",
    "status": "Active",
    "currentStage": "RequestingFromRegistry",
    "statusDate": "2025-04-14T00:00:00+03:00",
    "canBeCancelledNow": false,
    "canBeCopied": false,
    "poaRegistryType": "FNS",
    "poaNumber": "8b1c60d9-b2d0-41f9-a5c8-37dffecbe52a",
    "creationDate": "2025-04-14T19:03:36.048+03:00"
  }
}
Комментарии для сайта Cackle
Получите электронную подпись для работы на госпорталах, для участия в торгах и ЭДО

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

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

autohello-finger