ExtendedSignerDetails¶
Предупреждение
Метод устарел. Для заполнения данных подписанта используйте метод ExtendedSignerDetails.
Набор необходимых полей для подписания счетов-фактур, актов и накладных был значительно меньше, чем для подписания УПД и УКД.
Все данные подписанта можно было достать из сертификата и данных его организации - автоматическое заполнение данных подписанта происходило при заполнении BoxId и Certificate/CertificateThumbprint.
Данная логика сохранилась и при подписании УПД и УКД. Автоматическое заполнение происходит, если в Диадоке есть дополнительные данные, необходимые для подписания. Если дополнительных данных, необходимых для подписания в Диадоке нет, то будет возникать ошибка.
Заполнение данных¶
Расширенные данные можно заполнить методом ExtendedSignerDetails.
- POST /ExtendedSignerDetails¶
- Query Parameters:
boxId – идентификатор ящика организации, для которого нужно заполнить данные о подписанте.
thumbprint – отпечаток сертификата, для которого нужно заполнить дополнительные данные о подписанте.
buyer – флаг, указывающий, что указанные данные должны использоваться при формировании титула покупателя.
correction – флаг, указывающий, что указанные данные должны использоваться при формировании корректировки.
- Request Headers:
Authorization – данные, необходимые для авторизации.
- Request Body:
Тело запроса должно содержать отправляемое сообщение, сериализованное в протобуфер ExtendedSignerDetailsToPost.
- Status Codes:
200 OK – операция успешно завершена.
400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
401 Unauthorized – в запросе отсутствует HTTP-заголовок
Authorization
или в этом заголовке содержатся некорректные авторизационные данные.402 Payment Required – у организации с указанным идентификатором
boxId
закончилась подписка на API.403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.
405 Method Not Allowed – используется неподходящий HTTP-метод.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.
- Response Body:
Тело ответа содержит отправленное сообщение, сериализованное в протобуфер ExtendedSigner.
Проверка данных¶
Проверить, какие дополнительные данные указаны для конкретного подписанта можно этим же методом.
- GET /ExtendedSignerDetails¶
- Query Parameters:
boxId – идентификатор ящика организации, для которого нужно заполнить данные о подписанте.
thumbprint – отпечаток сертификата, для которого нужно заполнить дополнтиельные данные о подписанте.
buyer – флаг, указывающий, что указанные данные должны использоваться при формировании титула покупателя.
correction – флаг, указывающий, что указанные данные должны использоваться при формировании корректировки.
- Request Headers:
Authorization – данные, необходимые для авторизации.
- Status Codes:
200 OK – операция успешно завершена.
400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
401 Unauthorized – в запросе отсутствует HTTP-заголовок
Authorization
или в этом заголовке содержатся некорректные авторизационные данные.403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.
405 Method Not Allowed – используется неподходящий HTTP-метод.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.
- Response Body:
Тело ответа содержит отправленное сообщение, сериализованное в протобуфер ExtendedSigner.
Примеры¶
Пример POST запроса:
POST /ExtendedSignerDetails?boxId=48ad04b4-af63-4a72-901c-f19b698c31cc&thumbprint=B8C080A89A5F643A&buyer=true HTTP/1.1 Host: diadoc-api.kontur.ru Authorization: DiadocAuth ddauth_api_client_id=key, ddauth_token=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": "Должностные обязанности" }