Шаг 6. Подписание заявки на стороне внешней системы

При получении события о смене статуса заявки, если в данном сообщении так же присутствует UserAction с типом CLIENT_INTERNAL_SIGN, система-отправитель должна выполнить действие подписания заявки. Процесс подписания заявки организован через подписание ее документов, куда входят как документы, которые были ранее присланы при подаче заявки, так и сгенерированные на стороне банка документы (например, анкета клиента).

Получить список документов, требуемых на подпись можно вызвав URL, указанный в атрибуте userActions[].documentsToSignUrl. В результате данного вызова будет получен список документов, с их хешами разных алгоритмов, для возможности подписания, и URL для скачивания (если пользователю или системе отправителю, потребуется содержимое документов).

Так же в теле ответа приходит URL, на который необходимо отправлять результаты подписи. Данный URL определен в атрибуте result.signUrl.

Имя поля	Кратность	Тип	Описание
result.signUrl	1	URL	URL, по которому необходимо отправлять результат подписания.
documents[].id	1	String	Внутренний идентификатор в системе банка. Не участвует в последующей интеграции.
documents[].dealApplicationId	1	String	Идентификатор заявки. toProducts[].applicationId из POST /api/v1/deal/send_applications(Шаг 4. Отправка заявки в сервисы с указанием продуктов)
documents[].documentTypeName	1	String	Имя документа для отображению пользователю.
documents[].description	0-1	String	Описание документа
documents[].files[].id	1	String	Идентификатор файла в системе банка
documents[].files[].filename	1	String	Имя файла в файловой системе
documents[].files[].url	1	URL	URL получения содержимого файла
documents[].files[].comment	0-1	String	Комментарий к документу в системе банка.
documents[].files[].hashes[].algorithm	1	String	Алгоритм хеша по содержимому файла Список возможных алгоритмов GOST-3411, GOST-3411-2012-512, GOST-3411-2012-256, SHA-256.
documents[].files[].hashes[].hash	1	String(HEX)	Хеш по содержимому файла

Нажмите, чтобы посмотреть/скрыть пример списка документов на подписание

{
    "result": {
        "signUrl": "/deal/servicedocument/quick/sign",
        "documents": [
            {
                "id": "684369",
                "dealApplicationId": "333a7c64-973d-40ce-8fb5-18f228d89b8f",
                "documentTypeName": "Копии паспортов Бенефициарных владельцев",
                "description": null,
                "files": [
                    {
                        "id": "NzY5Mjk1OkF0dGFjaG1lbnRz",
                        "filename": "mtsbank_logored_ru_rgb.jpg",
                        "url": "http://192.168.1.138:8080/bidders/dg/remote_download/Attachments/769295/7b2def6f-ecb9-49ad-a32a-e5327e889f6d/",
                        "comment": null,
                        "hashes": [
                            {
                                "algorithm": "GOST-3411-2012-512",
                                "hash": "<OMMITED>"
                            },
                            {
                                "algorithm": "GOST-3411-2012-256",
                                "hash": "<OMMITED>"
                            }
                        ]
                    },
                    {
                        "id": "NzY5Mjk2OkF0dGFjaG1lbnRz",
                        "filename": "test.docx",
                        "url": "http://192.168.1.138:8080/bidders/dg/remote_download/Attachments/769296/7b2def6f-ecb9-49ad-a32a-e5327e889f6d/",
                        "comment": null,
                        "hashes": [
                            {
                                "algorithm": "GOST-3411-2012-512",
                                "hash": "<OMMITED>"
                            },
                            {
                                "algorithm": "GOST-3411-2012-256",
                                "hash": "<OMMITED>"
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "fetchFields": {}
}

Имя поля	Кратность	Тип	Описание
signatures[].dealApplicationId	1	String	Идентификатор заявки. toProducts[].applicationId из POST /api/v1/deal/send_applications(Шаг 4. Отправка заявки в сервисы с указанием продуктов)
signatures[].documentSignatures[].serviceDocumentFileId	1	String	Идентификатор файла. documents[].files[].id из списка документов на подписание.
signatures[].documentSignatures[].signature	1	String(BASE64)	Подпись в формате CMS.

Нажмите, чтобы посмотреть/скрыть пример сообщения с результатом подписания

{
  "signatures": [
    {
      "dealApplicationId": "333a7c64-973d-40ce-8fb5-18f228d89b8f",
      "documentSignatures": [
        {
          "serviceDocumentFileId": "Mjk4NjgxOkdlbmVyYXRlZERvY3VtZW50cw",
          "signature": "<OMMITED>"
        },
        {
          "serviceDocumentFileId": "Mjk4NjgyOkdlbmVyYXRlZERvY3VtZW50cw",
          "signature": "<OMMITED>"
        },
        {
          "serviceDocumentFileId": "MTEzMDc0MTpBdHRhY2htZW50cw",
          "signature": "<OMMITED>"
        }
      ]
    }
  ]
}

Create Branch

Дерево страниц