ExtendedSignerDetails (POST)
warning
Метод устарел и будет удален из API после 30 ноября 2026 года. Подробнее в истории изменений. Используйте актуальную версию метода — ExtendedSignerDetails (POST) (V2).
Заполняет дополнительные данные подписанта.
Дополнительные данные подписанта могут быть заполнены:
- Автоматически — для документов, перечисленных в поле
ExtendedDocumentTitleTypeструктуры SignerInfoV2, Диадок заполнит данные подписанта на основе информации из сертификата и реквизитов организации, если были указаныBoxIdиCertificate/CertificateThumbprint. Если в Диадоке нет дополнительных данных, необходимых для подписания, то возникнет ошибка. - Вручную — с помощью метода
ExtendedSignerDetails.
POST /ExtendedSignerDetails
Параметры запроса
boxId— идентификатор ящика организации, для которого нужно заполнить данные о подписанте, в формате GUID.thumbprint— отпечаток сертификата, для которого нужно заполнить дополнительные данные о подписанте.buyer— признак того, что указанные данные должны использоваться при формировании титула покупателя.correction— признак того, что указанные данные должны использоваться при формировании корректировки.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Тело запроса
Тело запроса должно содержать информацию для заполнения дополнительных данных подписанта, представленную структурой 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": "Должностные обязанности"
}
См. также
Инструкции: