---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
vcsPath: >-
  motorway/magacg/support/docs/src/ru-x-ai/catalog/executor/executor-poll-order-changes.md
updatedAt: '2026-11-12T12:16:53.000Z'
alternate:
  - href: >-
      https://yamagistrali.ru/docs/ru-x-ai/catalog/executor/executor-poll-order-changes.md
    type: text/markdown
    title: Markdown version
  - href: https://yamagistrali.ru/docs/ru-x-ai/llms.txt
    rel: describedby
---
<!-- Сгенерировано командой api-docs export-site. -->

# Получать изменения заказов исполнителя

Стенд по умолчанию — `test`. Только чтение. [Порядок работы для агента](https://yamagistrali.ru/docs/ru-x-ai/concepts/agent-workflow.md).

Используйте [общий порядок синхронизации](https://yamagistrali.ru/docs/ru-x-ai/concepts/order-sync.md) и методы для исполнителя. Нужен действующий токен с ролью исполнителя и правами в нужных организациях из карточек методов.

## Методы исполнителя

1. Если курсора нет, вызовите [`POST /api/orders/changesForExecutors/getLastLogId/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/orders.changes-for-executors.get-last-log-id.v0.md) и передайте границу синхронизации в `data.toTime`.
2. Читайте порцию через [`POST /api/orders/changesForExecutors/get/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/orders.changes-for-executors.get.v0.md). Передайте курсор в `data.lastId`, размер порции — в `data.limit`. Если синхронизируете одну организацию, передайте один и тот же `data.executorId` при получении начального курсора и чтении порций.
3. При `data.changes: []` или допустимом по карточке `data.changes: null` завершите обработку порции без запроса деталей. Если `data.changes` отсутствует или имеет другой тип, остановитесь и проверьте ответ. В этих случаях курсор не продвигайте.
4. При синхронизации одной организации сверьте `data.changes[].executorId` каждой записи с идентификатором выбранной организации. Если поле отсутствует или отличается, остановитесь до запроса деталей и оставьте курсор прежним.
5. Для получения актуальных карточек вызовите [`POST /api/orders/v0/transferOrder/getFlatForExecutor`](https://yamagistrali.ru/docs/ru-x-ai/methods/orders.transfer-order.get-flat-for-executor.v0.md), только если выбрали хотя бы один нужный непустой `orderId`. Передайте выбранные идентификаторы в `data.exactOrderIds`. Используйте только карточки с `data.orders[].id` из запроса. Область исторического события определяйте по `executorId` записи ленты. Карточка показывает текущего исполнителя.