Астрал.Доверенность: Сценарии работы

Создание доверенности

1. По методу POST/corporate-api/v1/draft-poas/{relationshipType} создать черновик доверенности.
2. По методу PUT/corporate-api/v1/draft-poas/{poaNumber} наполнить созданный черновик данными.
3. По методу POST/corporate-api/v1/poas/{poaNumber}/form получить XML файл черновика доверенности.
4. С помощью СКЗИ создать:
   1. для relationshipType=Unified - файл открепленной подписи для файла XML черновика доверенности, файл должен иметь кодировку Base64
   2. для relationshipType=SFR - блок подписи внутри XML, электронно-цифровая подпись накладывается по стандарту XMLDSig, в соответствии OASIS Web Service Security: SOAP Message Security 1.1
5. Передать файлы на регистрацию в реестр:

   1. для relationshipType=Unified - POST/corporate-api/v1/poas/fns/{poaNumber}/send-poa

   2. для relationshipType=SFR - POST/corporate-api/v1/poas/sfr/{poaNumber}/send-poa 

6. По методу GET/corporate-api/v1/poas/{registryType}/{poaNumber} проверить параметр currentStage. Он может иметь варианты:
   1.  SentToRegistry  /// Доверенность отправлена в реестр - все прошло успешно 
   2. QueuedToSendToRegistry /// Доверенность поставлена в очередь на отправку в реестр  - реестр долго отвечает и нужно подождать
   3. RejectedByRegistry /// Доверенность отклонена реестром  - что-то пошло не так, возможно указаны неверные данные или реестр вернул ошибку при попытке регистрации.
      1. причину можно посмотреть в параметре rejectionReason

Отмена доверенности

1. Получить XML файл заявления на отмену доверенности:
   1. доверенность формата B2B, B2G, Unified - POST/corporate-api/v1/poas/create-fns-cancellation
   2. доверенность формата СФР - POST/corporate-api/v1/poas/create-sfr-cancellation
2. С помощью СКЗИ создать:
   1. доверенность формата B2B, B2G, Unified - файл открепленной подписи для файла XML заявления на отмену, файл должен иметь кодировку Base64
   2. доверенность формата СФР - блок подписи внутри XML, электронно-цифровая подпись накладывается по стандарту XMLDSig, в соответствии OASIS Web Service Security: SOAP Message Security 1.1
3. Передать заявление на регистрацию в реестр:
   1. доверенность формата B2B, B2G, Unified - POST/corporate-api/v1/poas/fns/{poaNumber}/send-cancellation
   2. доверенность формата СФР - POST/corporate-api/v1/poas/sfr/{poaNumber}/send-cancellation
4. По методу GET/corporate-api/v1/poas/{registryType}/{poaNumber} проверить параметр cancellationCurrentStage. Он может иметь варианты:
   1. SentToRegistry, /// Заявление принято реестром - все прошло успешно
   2. QueuedToSendToRegistry /// Заявление поставлено в очередь на отправку в рестр  - реестр долго отвечает и нужно подождать
   3. RejectedByRegistry /// Заявление отклонено реестром  - что-то пошло не так, возможно указаны неверные данные или реестр вернул ошибку при попытке регистрации заявления.
      
      1. причину можно посмотреть в параметре cancellationRejectionReason

Добавление доверенности, зарегистрированной ранее в ЦПРР ФНС (у вас есть реквизиты вашей доверенности, зарегистрированной в ЦПРР ФНС)

1. По методу GET/corporate-api/v1/poas/pull-from-fns передать номер доверенности, ИНН доверителя,  ИНН представителя
2. По методу GET/corporate-api/v1/poas/{registryType}/{poaNumber} проверить параметр currentStage. Он может иметь варианты:
   1.  ReceivedFromRegistry ///Доверенность загружена из реестра - все прошло успешно 
   2. RequestingFromRegistry  /// Доверенность запрашивается из реестра - реестр долго отвечает и нужно подождать
   3. FailedToReceiveFromRegistry  /// По указанному ИНН доверителя не удалось получить полные данные доверенности из реестра - что-то пошло не так, возможно указан неверный ИНН доверителя или реестр вернул ошибку при запросе доверенности.  
      
      1. причину можно посмотреть в параметре receivingFailReason

Добавление доверенности, зарегистрированной ранее в СФР (у вас есть номер вашей доверенности и сертификат доверителя или представителя)

1. По методу POST/corporate-api/v1/poas/form-poa-sfr-pulling передать номер доверенности
2. Ответ сохранить в файл
3. В полученный файл добавить блок подписи, электронно-цифровая подпись накладывается по стандарту XMLDSig, в соответствии OASIS Web Service Security: SOAP Message Security 1.1
4. По методу POST/corporate-api/v1/poas/pull-from-sfr передать полученный файл
5. По методу GET/corporate-api/v1/poas/{registryType}/{poaNumber} проверить параметр currentStage. Он может иметь варианты:
   1. ReceivedFromRegistry ///Доверенность загружена из реестра - все прошло успешно 
   2. RequestingFromRegistry  /// Доверенность запрашивается из реестра - реестр долго отвечает и нужно подождать
   3. FailedToReceiveFromRegistry  /// По указанному ИНН доверителя не удалось получить полные данные доверенности из реестра - что-то пошло не так, возможно указан неверный ИНН доверителя или реестр вернул ошибку при запросе доверенности.  
      
      1. причину можно посмотреть в параметре receivingFailReason

Подключение лицензии

1. По методу POST/corporate-api/v1/licenses/purchase создать заявку на подключение лицензии
2. Обратиться в свою обслуживающую организацию для оплаты и одобрения заявки
3. По методу GET/corporate-api/v1/licenses/get-last-purchase-request получить заявку и проверить ее статус. Если статус равен Accepted, то можно пользоваться сервисом

Продление лицензии

1. По методу GET/corporate-api/v1/licenses запросить данные о действующей лицензии
2. Проверить наличие объекта upcoming, если его нет, то ранее продления не было
3. Проверить параметр license/validUntil, если до указанной даты осталось 30 и менее дней, то можно отправить заявку на новую лицензию. 

   
   

4. По методу POST/corporate-api/v1/licenses/purchase создать заявку на подключение лицензии
5. Обратиться в свою обслуживающую организацию для оплаты и одобрения заявки
6. По методу GET/corporate-api/v1/licenses/get-last-purchase-request получить заявку и проверить ее статус. Если статус равен Accepted, то можно пользоваться сервисом

Пополнение баланса доверенностей

1. По методу POST/corporate-api/v1/licenses/replenish-balance создать заявку на пополнение
2. Обратиться в свою обслуживающую организацию для оплаты и одобрения заявки
   1. при одобрении заявки количество доверенностей можно скорректировать
3. По методу GET/corporate-api/v1/licenses/get-last-replenish-balance-request  получить заявку и проверить ее статус. Если статус равен Accepted, то баланс доверенностей пополнен.