POST /certificate-forms/{formId}/release

Метод позволяет инициализировать процесс выпуска сертификата на данные формы. Инициализировать выпуск сертификата можно только для форм, которые находятся в статусе created.

Перед выпуском необходимо убедиться, что в форме есть все обязательные документы:

  • документ удостоверяющий личность
  • выписка из ЕГРЮЛ (для юридических лиц)

СНИЛС и ИНН можно не прикладывать. Если они не будут приложены, то после выпуска данные формы будут проверяться в базах государственных органов через СМЭВ. Если проверка пройдет успешно, то документы не понадобятся. Если проверка для какого-то реквизита завершится ошибкой, то форма перейдет в состояние validationError и для продолжения выпуска формы будет необходимо приложить документы.

Переменная

Название Тип Формат Описание
formId string Guid Идентификатор формы

Заголовки

Название Описание
Authorization Заголовок авторизации
Content-Type Тип контента

Content-Type

Допустимые значения Content-Type:

  • application/json;

Тело запроса

В теле запроса содержится описание скана "Заявления на выпуск сертификата" ContentInfo.

Заявление нужно:

  1. Сгенерировать на основании данных формы с помощью метода GET /certificate-forms/{formId}/render.
  2. Подписать владельцем сертификата на бумаге.
  3. Подписанный скан заявления загрузить в Реестро методом POST /contents.

Допустимые форматы заявления:

  • pdf;
  • png;
  • jpg;
  • jpeg;
  • tiff.

Пример

POST /realty/crypto/v2/certificate-forms/70f78249-dc69-450f-ab38-19974a310020/release
Content-Type: Аpplication/json
Authorization: ReestroAuth auth.sid=717726209B543848879C33F2BDDAB9F8561EFAC465A5DC439193062C700FAFDA&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c
{
    "contentId": "3a8cf2b8-ee9e-47ca-9ff9-75efced2d52e",
    "contentType":"pdf",
    "contentName": "Договор купли-продажи",
    "md5":"7E0D44C48AF788657EA6F5C4C87589E8"
}

Ответы

200

Форма отправлена на проверку в удостоверяющий центр.

  • Если проверка будет пройдена успешно, то по форме автоматически начнет выпускаться сертификат.

  • Если проверка не будет пройдена, то в описании формы будет содержаться описание ошибок валидации данных. Их нужно исправить и отправить форму на выпуск повторно.

    В ответе содержится описание формы CertificateForm.

Заголовки ответа

Название Описание
ETag Метка последнего изменения формы
Content-Type Тип содержимого

Пример ответа

  HTTP 200
  ETag: 686897696a7c876b7e
  Content-Type: Application/json
  {
    "formId": "c8fbe843-3ae2-4266-8fb7-7bf24bfd0704",
    "person":
    {
      "subject" :
      {
        "subjectId": "70f78249-dc69-450f-ab38-19974a310020",
        "person": {
          "name": "Анастасия",
          "surname": "Тарасова",
          "patronymic": "Константиновна",
          "dateBirth": "2018-01-01",
          "birthPlace": "Где то",
          "snils": "000-000-000 55",
          "inn": "121212121212",
          "email": "imya@yandex.ru",
          "phone": "79699999999",
          "gender": "Female",
          "identityDocument":
          {
            "documentType": "008001001000",
            "number": "123456",
            "series": "1111",
            "issueDate": "2018-12-12",
            "issuer":
            {
              "issuerCode": "123-123",
              "issuerName": "кем-то"
            }
          },
          "citizenship": "848000000643",
          "address":
          {
            "structuralAddress":
            {
              "region": "54",
              "city":
              {
                "name": "Новосибирск",
                "abbreviation": "г"
              },
              "street":
              {
                "name": "Челюскинцев",
                "abbreviation": "ул"
              },
              "house":
              {
                "name": "14",
                "abbreviation": "д"
              }
            }
          }
        }
      }
    },
    "documents:":
    [
      {
        "documentId": "3e605336-a34d-4f34-93dc-b5fd78c21d6a",
        "documentInfo":
        {
          "documentType": "100"
        },
        "content":
        {
          "contentInfo":
          {
            "contentId": "3a8cf2b8-ee9e-47ca-9ff9-75efced2d52e",
            "contentType":"pdf",
            "md5":"7E0D44C48AF788657EA6F5C4C87589E8"
          }
        }
      },
      {
        "documentId": "f0478c91-a93e-45cc-81f6-482a4e0d3443",
        "documentInfo":
        {
          "documentType": "200"
        },
        "content":
        {
          "contentInfo":
          {
            "contentId": "cb351abb-36fb-43be-9194-639be38b5617",
            "contentType":"pdf",
            "md5":"F7415E33F972C03ABD4F3FED36748F7A"
          }
        }
      }
    ],
    "state": "validating"
  }

400

Ошибки валидации запроса. В теле ответа содержится описание ошибки Error. Для данного метода возможны следующие ошибки:

Код ошибки Описание Содержимое контекста
NotAllowedFormState Статус формы не позволяет выпустить сертификат
BigContentSize Размер контента превышает 10 мб Описание неправильного контента ContetnIfo
UnsupportedContentType Указан контент, формат которого не поддерживается методом Описание неправильного контента ContetnIfo
UnexistentContent Не удалось найти указанный контент Описание ненайденного контента ContetnIfo
IncompleteDocumentList В форме указан неполный комплект документов Массив кодов документов, которых не хватает на форме для продолжения выпуска
WrongFieldValue Значение поля не соответствует требуемому формату. Поле, формат которого не соответствует, указано в описании ошибки в message
AbsenceOfRequiredField Не указано одно из обязательных полей

Пример ответа

  HTTP 400
  Content-Type Application/json
    {
        "code": "validation",
        "message": "Failed to validate request",
        "target": "api"
        "errors":
        [
          {
            "code": "NotAllowedFormState",
            "message": "Operation is not supported for  form 978a9fda-e2e8-415d-bf25-31487ffb8bf1 in state Validating",
            "target": "CryptoApi"
          }
        ]
    }

401

Ошибка авторизации: пользователь не авторизован

403

Ошибка аутентификации: пользователь не имеет доступа к ресурсам организации, которая указана в заголовке авторизации

404

Форма с указанным идентификатором не найдена

415

В заголовке Content-Type указан тип контента, который не поддерживается для данного метода