REST API DropCat: отправка документа на подписание в «Госключ»
POST /signDocumentWithGoskey
Метод используется чтобы направить документ на подписание в Госключ. Черновик документа должен быть создан до запуска метода.
Метод позволяет направить на подписание титулы ЭТрН 5.01, уведомления о переадресовке, титулы ЭПЛ (за исключением титулов медицинских осмотров Т2, Т6), титулы ЭЗЗ.
Для успешного направления на подписание, документ должен находиться в статусе, допускающем его подписание.
Формат запроса
Запрос статуса следует отправлять с помощью метода POST.
/signDocumentWithGoskey
? [id_type= <gln>]
& [org_id= <идентификатор>]
& [doc_id= <идентификатор>]
Параметры запроса
| Параметр | Пример значения | Описание | Тип параметра | Тип данных |
|---|---|---|---|---|
| id_type* | gln | Тип идентификатора организации. Принимает значения: gln или fns | query | string |
| org_id* | 2000000009994 | Идентификатор организации-инициатора запроса | query | string |
| doc_id* |
51442005 |
Идентификатор документа в системе | query | long |
* Обязательный параметр.
body – должно содержать кодированный в base64 файл signer.json
В файле signer.json в формате JSON должны быть представлены данные о подписанте, на подпись которому направляется файл.
Ключи файла signer.json
| Параметр | Пример значения | Описание |
|---|---|---|
| snils* | 111-111-111 11 | СНИЛС лица, кому документ направляется на подписание |
| surname* | Иванов | Фамилия подписанта |
| name* | Иван | Имя подписанта |
| patronymic | Иванович | Отчество подписанта (при наличие) |
| poanumber | cccdedd0-270a-4e8f-bf32-9c6cdb07e9c | Номер машиночитаемой доверенности (МЧД), подтверждающей полномочия подписанта |
* Обязательный параметр.
Примечание: использование МЧД для подписания является обязательным. Приоритетным являются данные файла signer.json. Если они не заполнены, проверяется наличие сведений об МЧД в контенте документа (Блоки <СвДоверЭл> - для ЭПЛ, <СвДовер> - для ЭТрН). Если сведения об МЧД отсутствуют - метод вернет сообщение об ошибке.
Примечание: используемая МЧД должна быть предварительно зарегистрирована на платформе Dropcat.
Формат ответа
Если запрос был обработан без ошибок, API отвечает кодом 200. Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.
Curl
curl -X POST --header "Content-Type: application/json" --header "Accept: application/json" -d "IHsgDQoic25cG9....NkYjA3ZTljIiB9" "dapi-preprod.ediweb.ru/edi/api/v1.1/signDocumentWithGoskey?id_type=gln&org_id=1053675800999&doc_id=359063032"
URL запроса
https://dapi-preprod.ediweb.ru/edi/api/v1.1/signDocumentWithGoskey?id_type=gln&org_id=1053675800999&doc_id=359063032
Тело ответа
В теле ответа возвращается информация о направлении документа в «Госключ».
Document 359063032 has been sent to signing in GOSKEY
HTTP код ответа
200
Заголовки ответа
{
"connection": "keep-alive",
"content-encoding": "gzip",
"content-length": "238",
"content-type": "text/plain; charset=UTF-8",
"date": "Sun, 08 Dec 2024 12:46:21 GMT",
"request_uuid": "1ccc210f-01f4-4a2d-a4e1-32ff053419c3",
"server": "nginx"
}