---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
vcsPath: >-
  motorway/magacg/support/docs/src/ru-x-ai/catalog/customer/customer-poll-order-changes.md
updatedAt: '2026-11-12T12:16:53.000Z'
alternate:
  - href: >-
      https://yamagistrali.ru/docs/ru-x-ai/catalog/customer/customer-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/changesForForwarders/getLastLogId/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/orders.changes-for-forwarders.get-last-log-id.v0.md) и передайте границу синхронизации в `data.toTime`.
2. Читайте порцию через [`POST /api/orders/changesForForwarders/get/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/orders.changes-for-forwarders.get.v0.md). Передайте курсор в `data.lastId`, размер порции — в `data.limit`. Если синхронизируете одну организацию, передайте один и тот же `data.forwarderId` при получении начального курсора и чтении порций.
3. При `data.changes: []` завершите обработку порции без запроса деталей. При отсутствии `data.changes` или значении другого типа остановитесь и проверьте ответ. Курсор в обоих случаях не продвигайте.
4. Для получения актуальных карточек вызовите [`POST /api/orders/v0/transferOrder/getFlatForCustomer`](https://yamagistrali.ru/docs/ru-x-ai/methods/orders.transfer-order.get-flat-for-customer.v0.md), только если выбрали хотя бы один нужный непустой `orderId`. Передайте выбранные идентификаторы в `data.exactOrderIds`. Для одной организации укажите также `data.forwarderIDs` и сверьте `data.orders[].forwarder.forwarderId` каждой карточки. Если идентификатор организации отсутствует или отличается от выбранного, остановитесь и оставьте курсор прежним.