Перейти к основному содержимому

GetLastEvent

warning

Метод устарел и будет удален из API после 03 апреля 2027 года. Подробнее в истории изменений. Используйте новую версию метода — GetLastEvent (V2).

Возвращает последнее событие в ящике.

GET /GetLastEvent

Параметры запроса

  • boxId — идентификатор ящика организации.

Заголовки запроса

Коды ответа

  • 200 — операция успешно завершена.
  • 204 — в ящике нет событий.
  • 400 — данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 402 — у указанного ящика закончилась подписка на API.
  • 403 — доступ к ящику с предоставленным авторизационным токеном запрещен.
  • 404 — не найден ящик с указанным идентификатором.
  • 405 — используется неподходящий HTTP-метод.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Тело ответа

Тело ответа содержит последнее событие в ящике, представленное структурой BoxEvent.

Метод вернет последнее событие из ленты событий. Лента формируется по подразделению организации, в котором состоит пользователь. Подразделение указано в поле UserDepartmentId структуры OrganizationUserPermissions.

к сведению

К подразделению организации привязываются все события, произошедшие с 15.03.2017. События, произошедшие до этой даты, может получить только пользователь, который имеет доступ ко всем документам организации.

Если у пользователя есть доступ ко всем документам организации, в ленту попадут события по всему ящику. Доступ пользователя указан в поле AllDocuments структуры DocumentAccessLevel.

События по черновикам доступны пользователям, у которых есть доступ ко всем документам организации, так как черновики не имеют привязки к подразделению.

Метод вернет всю информацию, которую возможно получить по указанному событию, в том числе содержимое документов и подписей. В некоторых случаях получить содержимое документов невозможно, подробнее об этом в описании структуры Content.

Примеры использования

Пример HTTP-запроса:

GET /GetLastEvent?boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json

Пример тела ответа:

{
"EventId": "f3b159fc-e128-4dec-b43e-5d9f1c5d75ae",
"Patch": {
"MessageId": "1dd76148-a336-4094-8a70-daa01a159427",
"TimestampTicks": 638932613723921153,
"Entities": [
{
"EntityType": "Attachment",
"EntityId": "b378a034-3966-4310-bc73-a3e7b42fc9d9",
"AuthorUserId": "",
"ParentEntityId": "bd84007b-c254-4a37-ac64-0b44598b9318",
"Content": {
"Size": 5683,
"Data": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIj8+DQo81O...k7+jx4O3yPg0KICA8L8Tu6vPs5e3yPg0KPC/U4OnrPg=="
},
"AttachmentType": "InvoiceCorrectionRequest",
"FileName": "DP_UVUTOCH_2BM-6125600340-732644841-202407101103418496883_2BM-9147414342-757645784-202407101104400484330_20250211_a8cd65c9-ee90-467b-bef0-c31a643c8384.xml",
"NeedRecipientSignature": false,
"RawCreationDate": 638932613721445085,
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "amendment_request_133_01_03"
},
{
"EntityType": "Signature",
"EntityId": "23eba3ac-fe1c-493f-b2f7-b182a9f4a76b",
"AuthorUserId": "",
"ParentEntityId": "b378a034-3966-4310-bc73-a3e7b42fc9d9",
"Content": {
"Size": -1,
"Data": "MIAGCSqGSIb3DQEHAqCAMIACAQExDDAKBggqhQMHAQECAjCABgkqhkiG9w0BBwEAAK...q5xaVinL8u7T1b6u1w9qPyVNWalLKnKzpjAAAAAAAAA=="
},
"AttachmentType": "Nonformalized",
"NeedRecipientSignature": false,
"SignerBoxId": "1f208d032a604f6491b1b7aad54cfaf3@diadoc.ru",
"RawCreationDate": 638932613723921153,
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "",
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyRequired",
"Comment": "Документ подписан сертификатом физ. лица без МЧД"
}
},
{
"EntityType": "Attachment",
"EntityId": "b2f88353-327b-40c4-9820-e4b633b6bbab",
"AuthorUserId": "",
"ParentEntityId": "b378a034-3966-4310-bc73-a3e7b42fc9d9",
"Content": {
"Size": 5319,
"Data": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2luZG93cy0xMjUxIj8+DQo81O...v0eLP7uvE7uo+DQogIDwvxO7q8+zl7fI+DQo8L9Tg6es+"
},
"AttachmentType": "InvoiceConfirmation",
"FileName": "DP_PDOTPR_2BM-6125600340-732644841-202407101103418496883_2BM_20250912_b2f88353-327b-40c4-9820-e4b633b6bbab.xml",
"NeedRecipientSignature": false,
"RawCreationDate": 638932613723921153,
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "delivery_confirmation_133_01_03"
},
{
"EntityType": "Signature",
"EntityId": "638013f5-9a07-41fa-bf97-004920d31506",
"AuthorUserId": "",
"ParentEntityId": "b2f88353-327b-40c4-9820-e4b633b6bbab",
"Content": {
"Size": -1,
"Data": "MIAGCSqGSIb3DQEHAqCAMIACAQExDDAKBggqhQMHAQECAjCABgkqhkiG9w0BBwEAAK...AlchVYv1plwsLQaaNx8d+gXYOylpYy2PNY17GAAAAAAAA"
},
"AttachmentType": "Nonformalized",
"NeedRecipientSignature": false,
"SignerBoxId": "00000000000000000000000000000000@diadoc.ru",
"RawCreationDate": 638932613723921153,
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "",
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyNotRequired"
}
}
],
"ForDraft": false,
"DraftIsRecycled": false,
"DraftIsTransformedToMessageIdList": [],
"DraftIsLocked": false,
"MessageIsDeleted": false,
"EntityPatches": [],
"MessageIsRestored": false,
"MessageIsDelivered": false,
"PatchId": "f3b159fc-e128-4dec-b43e-5d9f1c5d75ae",
"MessageType": "Letter"
},
"IndexKey": "CN3x07SB370"
}

См. также

Методы для работы с событиями по документам:

  • GetEvent (V3) — возвращает событие по указанному идентификатору
  • GetLastEvent (V2) — возвращает последнее событие в ящике
  • GetNewEvents (V8) — возвращает ленту событий в ящике

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года