GetLastEvent

Предупреждение

После окончания переходного периода эта версия метода перестанет работать и будет возвращать ошибки. Используйте новую версию метода — GetLastEvent (V2).

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

GET /GetLastEvent

Query Parameters:

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

Request Headers:

Authorization – данные, необходимые для авторизации.

Status Codes:

200 OK – операция успешно завершена.
204 No Content – в ящике нет событий.
400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
402 Payment Required – у указанного ящика закончилась подписка на API.
403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.
404 Not Found – не найден ящик с указанным идентификатором.
405 Method Not Allowed – используется неподходящий HTTP-метод.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит последнее событие в ящике, представленное структурой 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; charset=utf-8

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

{
    "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 (V2) — возвращает событие по указанному идентификатору
GetEvent (V3) — возвращает событие по указанному идентификатору
GetLastEvent — возвращает последнее событие в ящике
GetLastEvent (V2) — возвращает последнее событие в ящике
GetNewEvents (V7) — возвращает ленту событий в ящике
GetNewEvents (V8) — возвращает ленту событий в ящике