Перейти к основному содержимому

ExtendedSignerDetails (POST)

warning

Метод устарел и будет удален из API после 30 ноября 2026 года. Подробнее в истории изменений. Используйте актуальную версию метода — ExtendedSignerDetails (POST) (V2).

Заполняет дополнительные данные подписанта.

Дополнительные данные подписанта могут быть заполнены:

  • Автоматически — для документов, перечисленных в поле ExtendedDocumentTitleType структуры SignerInfoV2, Диадок заполнит данные подписанта на основе информации из сертификата и реквизитов организации, если были указаны BoxId и Certificate/CertificateThumbprint. Если в Диадоке нет дополнительных данных, необходимых для подписания, то возникнет ошибка.
  • Вручную — с помощью метода ExtendedSignerDetails.

POST /ExtendedSignerDetails

Параметры запроса

  • boxId — идентификатор ящика организации, для которого нужно заполнить данные о подписанте, в формате GUID.
  • thumbprint — отпечаток сертификата, для которого нужно заполнить дополнительные данные о подписанте.
  • buyer — признак того, что указанные данные должны использоваться при формировании титула покупателя.
  • correction — признак того, что указанные данные должны использоваться при формировании корректировки.

Заголовки запроса

Тело запроса

Тело запроса должно содержать информацию для заполнения дополнительных данных подписанта, представленную структурой ExtendedSignerDetailsToPost.

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 402 — у организации с указанным идентификатором boxId закончилась подписка на API.
  • 403 — доступ к ящику с предоставленным авторизационным токеном запрещен.
  • 405 — используется неподходящий HTTP-метод.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Тело ответа

Тело ответа содержит данные подписанта в расширенном формате, представленные структурой ExtendedSigner.

Примеры использования

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

POST /ExtendedSignerDetails?boxId=48ad04b4-af63-4a72-901c-f19b698c31cc&thumbprint=B8C080A89A5F643A&buyer=true HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8

{
"JobTitle": "сотрудник",
"SignerType": "LegalEntity",
"SignerInfo": "additional",
"SignerPowers": "PersonMadeOperation",
"SignerStatus": "SellerEmployee",
"SignerPowersBase": "Должностные обязанности"
}

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

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
"Surname": "Иванов",
"FirstName": "Иван",
"Patronymic": "Иванович",
"JobTitle": "сотрудник",
"Inn": "101010101010",
"SignerType": "IndividualEntity",
"SignerOrganizationName": "ЗАО \"ПФ \"СКБ Контур\"",
"SignerInfo": "additional",
"SignerPowers": "PersonMadeOperation",
"SignerStatus": "SellerEmployee",
"SignerPowersBase": "Должностные обязанности"
}

См. также

Инструкции:

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года