Получение документов
Получить документ в ящике отправителя или в ящике получателя можно двумя способами:
через ленту событий: в этом случае вы можете получить документы, связанные с появлением нового события в ящике;
через поиск: в этом случае вы можете найти любые документы в своем ящике, указав параметры поиска.
Из полученного документа можно получить информацию о нем и его содержимое. Чтобы работать с данными содержимого формализованного документа, его можно распарсить: инструкция приведена на странице Парсинг формализованного документа.
Получение документов через ленту событий
При появлении нового документа в ящике отправителя или получателя формируются определенные события. Считывая ленту событий методами GetNewEvents (V7), GetNewEvents (V8), GetDocflowEvents (V3) и GetDocflowEvents (V4), можно получить эти документы.
Среди всех полученных документов можно найти документы определенного формата: сделать это можно по указанной версии в поле Version. Например, для документов формата приказа №970 версия будет начинаться с utd970: utd970_05_03_01.
Информация о возможных форматах и версиях документов приведена на странице Форматы документов.
Из ленты событий можно узнать идентификаторы документа MessageId и DocumentId и запросить дополнительную информацию по документу с помощью методов
Метод GetMessage не возвращает содержимое документа, а только информацию о нем. Чтобы получить содержимое, используйте метод GetEntityContent (V4).
Получение документов через поиск
Чтобы получить документы через поиск, нужно:
1. Поиск документов
Найти необходимые документы можно с помощью следующих методов:
GetDocuments (V3) — метод возвращает список документов, соответствующих заданным параметрам.
SearchDocflows (V4) — метод возвращает список документов, соответствующих строке запроса, с информацией о документообороте.
Ниже раскрываем подробности о каждом варианте поиска.
Поиск методом GetDocuments
Метод GetDocuments (V3) позволяет получить список документов, удовлетворяющих заданным фильтрам: типу, классу, статусу, контрагенту, подразделению, времени или дате отправки или получения. Например, с его помощью можно запросить список всех входящих счетов-фактур от указанного контрагента за определенный период. В запросе метода укажите параметры:
boxId— идентификатор ящика, в котором нужно найти входящие документы,
filterCategory— статус и тип документа.
HTTP-запрос на поиск входящих незавершенных счетов-фактур будет выглядеть следующим образом:
Пример HTTP-запроса метода GetDocuments:
GET /V3/GetDocuments?filterCategory=Invoice.InboundNotFinished&boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json
Content-Type: application/json charset=utf-8
В теле ответа вернется список документов в виде структуры DocumentList с вложенными элементами Document.
Пример тела ответа метода GetDocuments:
{
"TotalCount": 1,
"Documents": [
{
"IndexKey": "2B7732DB5692A849A133FDA593FDA38A9279A2CBA18EDF49B3D5CAE8D97C89B0ED4D67F0183510448F64919BE6B8F35B0000000000000000000000000000000000104608D2D2D8BA8731D80DDBCEBB34CE0D4EB3213F600C920935072CCF309772484DBC6FCA7A80E2CF95",
"MessageId": "bbcedb0d-ce34-4e0d-b321-3f600c920935",
"EntityId": "30cf2c07-7297-4d48-bc6f-ca7a80e2cf95",
"CreationTimestampTicks": 635802325536912186,
"CounteragentBoxId": "95f642cd1256426fb11c883c73d8440a@diadoc.ru",
"DocumentType": "Invoice",
"InitialDocumentIds": [],
"SubordinateDocumentIds": [],
"Content": "lores ipsum",
"FileName": "ON_SCHFDOPPR_2BM-7770357771-2012082810454029703720000000000_2BM-7750370234-4012052808304878702630000000000_20150826_d37c6a05-e85c-4469-8c68-2d0303f61c2a.xml",
"DocumentDate": "26.08.2015",
"DocumentNumber": "432634",
"InvoiceMetadata": {
"InvoiceStatus": "InboundNotFinished",
"Total": "17700.00",
"Vat": "2700.00",
"Currency": 643,
"ConfirmationDateTimeTicks": 635802433696852440,
"InvoiceAmendmentFlags": 0
},
"IsDeleted": false,
"DepartmentId": "00000000-0000-0000-0000-000000000000",
"IsTest": true,
"FromDepartmentId": "00000000-0000-0000-0000-000000000000",
"ToDepartmentId": "",
"CustomDocumentId": "",
"RevocationStatus": "RevocationStatusNone",
"SendTimestampTicks": 635802325536912186,
"DeliveryTimestampTicks": 635802325696852440,
"ForwardDocumentEvents": [],
"RoamingNotificationStatus": "RoamingNotificationStatusNone",
"HasCustomPrintForm": false,
"CustomData": [],
"DocumentDirection": "Inbound",
"LastModificationTimestampTicks": 635802325696852440,
"IsEncryptedContent": false,
"SenderSignatureStatus": "SenderSignatureCheckedAndValid"
}
]
}
После поиска необходимо получить информацию о каждом найденном документе.
Поиск методом SearchDocflows
Метод SearchDocflows (V4) выполняет поиск по строке запроса и возвращает найденные документы с информацией о документообороте.
Передайте в теле запроса структуру SearchDocflowsRequest, содержащую строку поиска в виде токенов или в формате YAML вида «ключ: значение». Область поиска можно ограничить, указав в параметре Scope одно из следующих значений:
SearchScopeAny— все документы в ящике.
SearchScopeInbound— входящие.
SearchScopeOutbound— исходящие.
SearchScopeDeleted— удаленные.
SearchScopeInternal— внутренние.
В строке поиска можно указать любые значения из цифр и букв, например: тип или наименование документа, ИНН или наимнование организации, дата отправки или получения, номер документа и пр. Для поиска по нескольким параметрам перечислите значения через пробел.
Пример HTTP-запроса метода SearchDocflows:
POST /V4/SearchDocflows?boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json; charset=utf-8
Тело запроса для поиска входящих договоров от 29.05.2025 будет выглядеть следующим образом:
Пример тела запроса метода SearchDocflows:
{
"QueryString": "Договор 29.05.2025",
"Scope": "SearchScopeInbound"
}
В теле ответа вернется список найденных документов с информацией о документообороте в виде структуры SearchDocflowsResponseV4.
Пример тела ответа метода SearchDocflows:
{
"Documents": [
{
"DocumentId": {
"MessageId": "a6865acc-050a-432f-9a77-548e32a3c7c8",
"EntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5"
},
"LastEvent": {
"EventId": "c453731a-3c84-11f0-8000-0000bd216658",
"Timestamp": {
"Ticks": 638841169375638298
}
},
"DocumentInfo": {
"FullVersion": {
"TypeNamedId": "Contract",
"Function": "default",
"Version": "v1"
},
"MessageType": "Letter",
"WorkflowId": 2,
"Participants": {
"Sender": {
"BoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"DepartmentId": "00000000-0000-0000-0000-000000000000"
},
"Recipient": {
"BoxId": "1f208d032a604f6491b1b7aad54cfaf3@diadoc.ru",
"DepartmentId": "00000000-0000-0000-0000-000000000000"
},
"IsInternal": false
},
"DocumentDirection": "Inbound",
"DepartmentId": "00000000-0000-0000-0000-000000000000",
"Metadata": [
{
"Key": "FileName",
"Value": "e6a02dc1-a673-41a2-b217-7bd1379130fc_пример (1).png"
},
{
"Key": "DocumentNumber",
"Value": "23"
},
{
"Key": "DocumentDate",
"Value": "2025-05-29T00:00:00.0000000Z"
},
{
"Key": "CurrencyCode",
"Value": "643"
},
{
"Key": "ContractPrice",
"Value": "23"
}
],
"CustomData": [],
"DocumentLinks": {
"InitialIds": [],
"SubordinateIds": []
},
"PacketInfo": {
"LockMode": "None"
},
"IsRead": true,
"IsDeleted": false,
"IsInvitation": false,
"LetterInfo": {
"IsEncrypted": false,
"ForwardDocumentEvents": [],
"IsTest": false
},
"EditingSettingId": ""
},
"Docflow": {
"SenderTitle": {
"IsFinished": true,
"Attachment": {
"Attachment": {
"Entity": {
"EntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"CreationTimestamp": {
"Ticks": 638841169138072584
},
"Content": {
"Size": 32837
}
},
"AttachmentFilename": "e6a02dc1-a673-41a2-b217-7bd1379130fc_пример (1).png",
"DisplayFilename": "Договор №23 от 29.05.25"
},
"Signature": {
"Cms": {
"EntityId": "1ebeb3bf-c200-420b-b4ca-e24af5434599",
"CreationTimestamp": {
"Ticks": 638841169138072584
},
"Content": {
"Size": 3213
}
},
"CadesT": {
"EntityId": "88c3511a-a6de-4d84-b01f-55dc3452d87d",
"CreationTimestamp": {
"Ticks": 638841169141027588
},
"Content": {
"Size": 6846
}
},
"SignerBoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"IsValid": true,
"DeliveredAt": {
"Ticks": 638841169141027588
},
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyRequired",
"Comment": "Документ подписан сертификатом физ. лица без МЧД"
}
},
"Comment": {
"EntityId": "adbdf5b1-93b1-4ba6-b72e-e6acbfe6960f",
"CreationTimestamp": {
"Ticks": 638841169138072584
},
"Content": {
"Size": 40
}
},
"ContentTypeId": "contract_01"
},
"SentAt": {
"Ticks": 638841169138072584
},
"DeliveredAt": {
"Ticks": 638841169141027588
},
"SenderSignatureStatus": "SenderSignatureCheckedAndValid"
},
"Confirmation": {
"IsFinished": true,
"ConfirmationAttachment": {
"Attachment": {
"Entity": {
"EntityId": "a9398d80-7924-4e66-b91a-4048ef2e15a8",
"CreationTimestamp": {
"Ticks": 638841169141027588
},
"Content": {
"Size": 5216
}
},
"AttachmentFilename": "DP_PDOTPR_2BM-6393630808-757645784-202407101104400484330_2BM_20250529_a9398d80-7924-4e66-b91a-4048ef2e15a8.xml",
"DisplayFilename": "Подтверждение даты отправки"
},
"Signature": {
"Cms": {
"EntityId": "fa1576ae-8035-47a0-a372-aad005d59b78",
"CreationTimestamp": {
"Ticks": 638841169141027588
},
"Content": {
"Size": 3532
}
},
"CadesT": {
"EntityId": "78a52a74-304c-49bf-b743-9069a291d3ad",
"CreationTimestamp": {
"Ticks": 638841169141027588
},
"Content": {
"Size": 7163
}
},
"SignerBoxId": "00000000000000000000000000000000@diadoc.ru",
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"IsValid": true,
"DeliveredAt": {
"Ticks": 638841169141027588
},
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyNotRequired"
}
},
"ContentTypeId": "delivery_confirmation_133_01_03"
},
"ConfirmedAt": {
"Ticks": 638841169141027588
}
},
"RecipientResponse": {
"IsFinished": false,
"ResponseStatus": "WaitingForRecipientSignature"
},
"Resolution": {
"IsFinished": true,
"ParentEntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"ResolutionStatus": "Approved",
"ResolutionEntityId": "4149b6ea-108e-4d00-aafa-106f0110599a"
},
"ResolutionEntities": {
"Requests": [],
"Resolutions": [
{
"Entity": {
"EntityId": "4149b6ea-108e-4d00-aafa-106f0110599a",
"CreationTimestamp": {
"Ticks": 638841169375346401
},
"Content": {
"Size": 48
}
},
"ResolutionRequestId": "",
"AuthorUserId": "9aa516d1-eec7-4e09-b11e-8772d081a4fa",
"ResolutionType": "Approve"
}
],
"ApprovementSignatures": [],
"SignatureDenials": []
},
"OuterDocflows": [],
"OuterDocflowEntities": [],
"DocflowStatus": {
"PrimaryStatus": {
"Severity": "Warning",
"StatusText": "Требуется подпись"
},
"SecondaryStatus": {
"Severity": "Success",
"StatusText": "Согласован"
},
"PowerOfAttorneyGeneralStatus": {
"Severity": "Warning",
"StatusNamedId": "IsNotAttached",
"StatusText": "Не приложена доверенность",
"Errors": []
}
}
}
}
],
"HaveMoreDocuments": false
}
2. Получение сведений о документах
Получение информации о найденных документах
Информацию о документе можно получить с помощью метода GetMessage (V6). В запросе передайте параметры найденного документа: boxId, messageId, entityId. Для получения информации о всех документах, находящихся в сообщении, укажите в запросе только boxId и messageId. HTTP-запрос на получение документа будет выглядеть следующим образом:
Пример HTTP-запроса метода GetMessage:
GET /V6/GetMessage?boxId={{boxId}}&messageId={{messageId}}&entityId={{entityId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8
В теле ответа метод вернет информацию о документе в сообщении в виде структуры Message. Ответ также будет содержать сущности всех дополнений сообщения.
Пример тела ответа метода GetMessage:
{
"MessageId": "a6865acc-050a-432f-9a77-548e32a3c7c8",
"TimestampTicks": 638841169138072584,
"LastPatchTimestampTicks": 638841169141027588,
"FromBoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"FromTitle": "Организация-отправитель",
"ToBoxId": "1f208d032a604f6491b1b7aad54cfaf3@diadoc.ru",
"ToTitle": "Организация-получатель",
"Entities": [
{
"EntityType": "Attachment",
"EntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"AuthorUserId": "",
"ParentEntityId": "",
"Content": {
"Size": 32837
},
"AttachmentType": "Contract",
"FileName": "FileName.png",
"NeedRecipientSignature": true,
"DocumentInfo": {
"MessageId": "a6865acc-050a-432f-9a77-548e32a3c7c8",
"EntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"CreationTimestampTicks": 638841169138072584,
"CounteragentBoxId": "1f208d032a604f6491b1b7aad54cfaf3@diadoc.ru",
"DocumentType": "Contract",
"InitialDocumentIds": [],
"SubordinateDocumentIds": [],
"Content": {
"Size": 32837
},
"FileName": "FileName.png",
"DocumentDate": "29.05.2025",
"DocumentNumber": "23",
"IsDeleted": false,
"DepartmentId": "00000000-0000-0000-0000-000000000000",
"IsTest": false,
"FromDepartmentId": "00000000-0000-0000-0000-000000000000",
"ToDepartmentId": "00000000-0000-0000-0000-000000000000",
"RevocationStatus": "RevocationStatusNone",
"SendTimestampTicks": 638841169138072584,
"DeliveryTimestampTicks": 638841169141027588,
"ForwardDocumentEvents": [],
"ContractMetadata": {
"DocumentStatus": "OutboundWaitingForRecipientSignature",
"ContractPrice": "23",
"ContractType": "",
"ReceiptStatus": "ReceiptStatusNone"
},
"RoamingNotificationStatus": "RoamingNotificationStatusNone",
"HasCustomPrintForm": false,
"CustomData": [],
"DocumentDirection": "Outbound",
"LastModificationTimestampTicks": 638841169141027588,
"IsEncryptedContent": false,
"SenderSignatureStatus": "SenderSignatureCheckedAndValid",
"IsRead": true,
"PacketIsLocked": false,
"ProxySignatureStatus": "ProxySignatureStatusNone",
"TypeNamedId": "Contract",
"Function": "default",
"WorkflowId": 2,
"Title": "Договор №23 от 29.05.25",
"Metadata": [
{
"Key": "FileName",
"Value": "FileName.png"
},
{
"Key": "DocumentNumber",
"Value": "23"
},
{
"Key": "DocumentDate",
"Value": "29.05.2025"
},
{
"Key": "CurrencyCode",
"Value": "643"
},
{
"Key": "ContractPrice",
"Value": "23"
}
],
"RecipientReceiptMetadata": {
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable",
"ConfirmationMetadata": {
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable",
"DateTimeTicks": 0
}
},
"ConfirmationMetadata": {
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable",
"DateTimeTicks": 638841169141027588
},
"RecipientResponseStatus": "WaitingForRecipientSignature",
"AmendmentRequestMetadata": {
"AmendmentFlags": 0,
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable"
},
"EditingSettingId": "",
"LockMode": "None",
"SenderReceiptMetadata": {
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable"
},
"Version": "v1",
"LastOuterDocflows": [],
"DocflowStatus": {
"PrimaryStatus": {
"Severity": "Warning",
"StatusText": "Ожидается подпись контрагента"
},
"PowerOfAttorneyGeneralStatus": {
"Severity": "Warning",
"StatusNamedId": "IsNotAttached",
"StatusText": "Не приложена доверенность",
"Errors": []
}
},
"TtGisFixationCancellationStatus": "TtGisFixationCancellationStatusNone",
"MessageIdGuid": "a6865acc-050a-432f-9a77-548e32a3c7c8",
"EntityIdGuid": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"CreationTimestamp": "2025-05-29T12:01:53.8072584Z"
},
"RawCreationDate": 638841169138072584,
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"Version": "v1",
"ContentTypeId": "contract_01"
},
{
"EntityType": "Attachment",
"EntityId": "adbdf5b1-93b1-4ba6-b72e-e6acbfe6960f",
"AuthorUserId": "",
"ParentEntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"Content": {
"Size": 40
},
"AttachmentType": "AttachmentComment",
"NeedRecipientSignature": false,
"RawCreationDate": 638841169138072584,
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": ""
},
{
"EntityType": "Signature",
"EntityId": "88c3511a-a6de-4d84-b01f-55dc3452d87d",
"AuthorUserId": "9aa516d1-eec7-4e09-b11e-8772d081a4fa",
"ParentEntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"Content": {
"Size": -1
},
"AttachmentType": "Nonformalized",
"NeedRecipientSignature": false,
"SignerBoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"RawCreationDate": 638841169141027588,
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "",
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyRequired",
"Comment": "Документ подписан сертификатом физ. лица без МЧД"
}
},
{
"EntityType": "Attachment",
"EntityId": "269f2463-484e-412d-b769-5e6c2b719162",
"AuthorUserId": "",
"ParentEntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"Content": {
"Size": 5208
},
"AttachmentType": "InvoiceConfirmation",
"FileName": "DP_PDPOL_2BM-6125600340-732644841-202407101103418496883_2BM_20250529_269f2463-484e-412d-b769-5e6c2b719162.xml",
"NeedRecipientSignature": false,
"RawCreationDate": 638841169141027588,
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "send_confirmation_133_01_03"
},
{
"EntityType": "Signature",
"EntityId": "8f77de9f-2ffb-491e-b9ba-4207e0e20ee0",
"AuthorUserId": "",
"ParentEntityId": "269f2463-484e-412d-b769-5e6c2b719162",
"Content": {
"Size": -1
},
"AttachmentType": "Nonformalized",
"NeedRecipientSignature": false,
"SignerBoxId": "00000000000000000000000000000000@diadoc.ru",
"RawCreationDate": 638841169141027588,
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "",
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyNotRequired"
}
}
],
"IsDraft": false,
"DraftIsLocked": false,
"DraftIsRecycled": false,
"CreatedFromDraftId": "",
"DraftIsTransformedToMessageIdList": [],
"IsDeleted": false,
"IsTest": false,
"IsInternal": false,
"IsProxified": false,
"ProxyBoxId": "",
"ProxyTitle": "",
"PacketIsLocked": false,
"LockMode": "None",
"MessageType": "Letter",
"IsReusable": false
}
Среди всех полученных документов можно найти документы определенного формата: сделать это можно по указанной версии в поле Version. Например, для документов формата приказа №970 версия будет начинаться с utd970: utd970_05_03_01.
Подробнее о возможных форматах и версиях документов — на странице Форматы документов.
Метод GetMessage возвращает только информацию о документе. Чтобы получить содержимое документа, используйте метод GetEntityContent (V4).
Получение содержимого документа
Содержимое документа можно получить с помощью метода GetEntityContent (V4). В запросе передайте параметры документа: boxId, messageId и entityId.
Пример HTTP-запроса метода GetEntityContent:
GET /V4/GetEntityContent?boxId={{boxId}}&messageId={{messageId}}&entityId={{entityId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json
В теле ответа метод вернет бинарное представление запрошенного документа.
Получение документооборота
Получить информацию о документообороте документа можно с помощью следующих методов:
SearchDocflows (V4) — метод возвращает список документов, соответствующих строке запроса, с информацией о документообороте. Инструкция по работе с методом описана в разделе Поиск методом SearchDocflows.
GetDocflows (V4) — метод возвращает список документов с информацией о документообороте по их идентификаторам. Подробнее об этом методе ниже.
С помощью метода GetDocflows (V4) можно получить информацию о документообороте и метаданные документов.
Передайте список запросов на получение документов с информацией о документообороте в виде структуры GetDocflowBatchRequest в теле запроса.
Пример HTTP-запроса метода GetDocflows:
POST /V4/GetDocflows?boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8
Content-Type: application/json
Пример тела запроса метода GetDocflows:
{
"Requests": [
{
"DocumentId": {
"MessageId": "b7a4809e-ff8f-4a6c-86ae-0f514c353afd",
"EntityId": "132c02e7-2d07-43f2-bf23-c9bc52f281e9"
}
}
]
}
В теле ответа вернется список документов с информацией о документообороте в виде структуры GetDocflowBatchResponseV4.
Пример тела ответа метода GetDocflows:
{
"Documents": [
{
"DocumentId": {
"MessageId": "b7a4809e-ff8f-4a6c-86ae-0f514c353afd",
"EntityId": "132c02e7-2d07-43f2-bf23-c9bc52f281e9"
},
"LastEvent": {
"EventId": "92d89e14-fdbb-11ef-8000-000189ea7b5d",
"Timestamp": {
"Ticks": 638772135536156180
}
},
"DocumentInfo": {
"FullVersion": {
"TypeNamedId": "Torg2",
"Function": "NoAdditionalInfo",
"Version": "torg2_05_01_01"
},
"MessageType": "Letter",
"WorkflowId": 1,
"Participants": {
"Sender": {
"BoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"DepartmentId": "00000000-0000-0000-0000-000000000000"
},
"Recipient": {
"BoxId": "1f208d032a604f6491b1b7aad54cfaf3@diadoc.ru",
"DepartmentId": "00000000-0000-0000-0000-000000000000"
},
"IsInternal": false
},
"DocumentDirection": "Inbound",
"DepartmentId": "00000000-0000-0000-0000-000000000000",
"Metadata": [
{
"Key": "FileName",
"Value": "DP_PRIRASXPRINMARK_2BM-0299242701-757645784-202407101104400484330_2BM-4934609619-732644841-202407101103418496883_20230116_17b84e47-f0c7-454e-a491-289dc2ace6c3.xml"
},
{
"Key": "DocumentNumber",
"Value": "1"
},
{
"Key": "DocumentDate",
"Value": "2023-01-16T00:00:00.0000000Z"
}
],
"CustomData": [],
"DocumentLinks": {
"InitialIds": [],
"SubordinateIds": []
},
"PacketInfo": {
"LockMode": "None"
},
"IsRead": true,
"IsDeleted": false,
"IsInvitation": false,
"LetterInfo": {
"IsEncrypted": false,
"ForwardDocumentEvents": [],
"IsTest": false
},
"EditingSettingId": ""
},
"Docflow": {
"SenderTitle": {
"IsFinished": true,
"Attachment": {
"Attachment": {
"Entity": {
"EntityId": "132c02e7-2d07-43f2-bf23-c9bc52f281e9",
"CreationTimestamp": {
"Ticks": 638772119340795259
},
"Content": {
"Size": 6658
}
},
"AttachmentFilename": "DP_PRIRASXPRINMARK_2BM-0299242701-757645784-202407101104400484330_2BM-4934609619-732644841-202407101103418496883_20230116_17b84e47-f0c7-454e-a491-289dc2ace6c3.xml",
"DisplayFilename": "Акт ТОРГ-2 №1 от 16.01.23"
},
"Signature": {
"Cms": {
"EntityId": "58c26ff0-683c-4031-b572-41abc009903b",
"CreationTimestamp": {
"Ticks": 638772119340795259
},
"Content": {
"Size": 3378
}
},
"CadesT": {
"EntityId": "66a045fc-521e-4d63-bae4-9c0e454aa35e",
"CreationTimestamp": {
"Ticks": 638772119344269072
},
"Content": {
"Size": 7010
}
},
"SignerBoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"IsValid": true,
"DeliveredAt": {
"Ticks": 638772119344269072
},
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyRequired",
"Comment": "Документ подписан сертификатом другого ЮЛ/ИП, возможно, требуется МЧД"
}
},
"ContentTypeId": "torg2_no_additional_info_05_01_01"
},
"SentAt": {
"Ticks": 638772119340795259
},
"DeliveredAt": {
"Ticks": 638772119344269072
},
"SenderSignatureStatus": "SenderSignatureCheckedAndValid"
},
"Confirmation": {
"IsFinished": true,
"ConfirmationAttachment": {
"Attachment": {
"Entity": {
"EntityId": "e13208c8-7962-4bbe-b9e1-7fdddff1254b",
"CreationTimestamp": {
"Ticks": 638772119344269072
},
"Content": {
"Size": 5547
}
},
"AttachmentFilename": "DP_PDOTPR_2BM-0299242701-757645784-202407101104400484330_2BM_20250310_e13208c8-7962-4bbe-b9e1-7fdddff1254b.xml",
"DisplayFilename": "Подтверждение даты отправки"
},
"Signature": {
"Cms": {
"EntityId": "6d9d47b2-890a-4e1b-ad17-f041af4ffdf9",
"CreationTimestamp": {
"Ticks": 638772119344269072
},
"Content": {
"Size": 3364
}
},
"CadesT": {
"EntityId": "ac1a3e4c-b2e4-43ec-87bb-d4267fc7d26a",
"CreationTimestamp": {
"Ticks": 638772119344269072
},
"Content": {
"Size": 6995
}
},
"SignerBoxId": "00000000000000000000000000000000@diadoc.ru",
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"IsValid": true,
"DeliveredAt": {
"Ticks": 638772119344269072
},
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyNotRequired"
}
},
"ContentTypeId": "delivery_confirmation_133_01_03"
},
"ConfirmedAt": {
"Ticks": 638772119344269072
}
},
"ResolutionEntities": {
"Requests": [],
"Resolutions": [],
"ApprovementSignatures": [],
"SignatureDenials": []
},
"OuterDocflows": [],
"OuterDocflowEntities": [],
"DocflowStatus": {
"PrimaryStatus": {
"Severity": "Info",
"StatusText": "Документооборот завершен"
},
"PowerOfAttorneyGeneralStatus": {
"Severity": "Warning",
"StatusNamedId": "IsNotAttached",
"StatusText": "Не приложена доверенность",
"Errors": []
}
}
}
}
]
}
Получение информации о подписи под документом
Информацию об электронной подписи и сертификате под указанным документом можно получить с помощью метода GetSignatureInfo. В запросе передайте параметры подписи, полученные методом GetMessage: boxId, messageId и entityId.
Пример HTTP-запроса метода GetSignatureInfo:
GET /GetSignatureInfo?boxId={{boxId}}&messageId={{messageId}}&entityId={{entityId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json
В теле ответа метод вернет информацию о подписи и сертификате в виде структуры SignatureInfo.
Пример тела ответа метода GetSignatureInfo:
{
"SigningTime": {
"Ticks": 638932562862009225
},
"SignatureVerificationTime": {
"Ticks": 638932562865236203
},
"SignatureVerificationResult": {
"IsValid": true,
"CertificateStatus": {
"VerificationTimeTicks": 638932562864552381,
"IsValid": true,
"CertificateChain": [
{
"CertificateChainStatusFlags": 0,
"DerCertificate": "MIIIyDCCCHWg...crXFWEer8="
},
{
"CertificateChainStatusFlags": 0,
"DerCertificate": "MIIFFjCCBMOg...39RHs92w=="
}
],
"VerificationTime": {
"Ticks": 638932562864552381
}
},
"SignatureTimestamp": {
"Ticks": 638932562860000000
}
},
"Thumbprint": "EE67A684C341A0B1F48C0135ECED866A67EFA1E1",
"SerialNumber": "012CBE7E007DB262844037E3A94CC30170",
"Issuer": "УЦ",
"StartDate": "07.02.25",
"EndDate": "07.05.26",
"OrgInn": "5320891637",
"JobTitle": "",
"FirstName": "Иван Иванович",
"Surname": "Иванов",
"Snils": "24572960090",
"Email": "email@example.com",
"CertificateSubjectType": "PhysicalPerson"
}