---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
vcsPath: >-
  motorway/magacg/support/docs/src/ru-x-ai/catalog/executor/executor-create-manage-flight.md
updatedAt: '2026-11-12T12:16:53.000Z'
alternate:
  - href: >-
      https://yamagistrali.ru/docs/ru-x-ai/catalog/executor/executor-create-manage-flight.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).

Соберите задачи по заказам в один рейс. Выберите организацию с ролью исполнителя и заказы в статусе `onExecute`. Перед записью на рабочем стенде получите подтверждение пользователя.

## Найти задачи заказов

Вызовите [`POST /api/orders/v0/transferOrder/getFlatForExecutor`](https://yamagistrali.ru/docs/ru-x-ai/methods/orders.transfer-order.get-flat-for-executor.v0.md) с идентификаторами заказов в `data.exactOrderIds`. В `data.orders[].shipments` выберите нужные задачи. Используйте `transferOrderTaskID` как идентификатор задачи заказа. Если у задачи уже есть `flightTaskId`, проверьте её принадлежность рейсу перед добавлением.

## Создать пустой рейс

Вызовите [`POST /api/flights/create/v1`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-flights-create-v1.md). Передайте идентификатор организации в `data.executerId` и название в `data.flightName`. Сохраните `data.id` из ответа.

## Добавить задачи

Вызовите [`POST /api/flights/tasks/addBulk/v1`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-flights-tasks-addbulk-v1.md). Для каждой задачи передайте идентификатор рейса в `data.tasks[].flightId` и `transferOrderTaskID` из карточки заказа в `data.tasks[].taskId`. В `externalId` передайте строковый идентификатор задачи в вашей системе. Поле не даёт гарантии защиты от повторного добавления. Задайте позиции сразу в `loadingOrder` и `unloadingOrder`. Сохраните возвращённые `data.ids`. Для сопоставления с исходными задачами перечитайте рейс.

## Задать порядок

Если нужно изменить порядок, вызовите [`POST /api/flights/order/setBulk/v1`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-flights-order-setbulk-v1.md). Используйте идентификаторы задач рейса в `data.flightOrders[].flightTaskId`. Для каждой записи задайте `order` и вид операции в `orderType`. Для погрузки это `loadingOrder`, для выгрузки — `unloadingOrder`. Проверьте `data.success` в ответе.

## Проверить рейс

Вызовите [`POST /api/flights/v1/listForExecutor`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-flights-v1-listforexecutor.md) с идентификатором рейса в `data.ids`. Найдите нужный объект в `data.flights` и проверьте `executerId`.

| Что проверить | Поле внутри `data.flights[].tasks[]` |
| --- | --- |
| Какой задаче заказа соответствует запись | `transferOrderTaskID` |
| Какой ID передавать в метод порядка | `flightTaskId` |
| Какие позиции сохранены | `flightInfo.loadingOrder`, `flightInfo.unloadingOrder` |

## Если запись завершилась тайм-аутом

- Если неизвестен ID нового рейса, остановитесь и передайте пользователю сверку. Совпадения организации и названия недостаточно, чтобы однозначно связать рейс с вызовом создания.
- Если ID рейса известен, перечитайте его. Сопоставьте задачи по `transferOrderTaskID` и проверьте порядок. Если подтверждена только часть изменений, сообщите, какие задачи или позиции остались непроверенными. Сразу повторять запись нельзя.

При `403 Forbidden` проверьте, назначена ли ваша организация исполнителем заказов и доступен ли ей рейс.

Для назначения транспорта и водителя используйте [Назначить на рейс водителя, тягач и прицеп](https://yamagistrali.ru/docs/ru-x-ai/catalog/executor/executor-assign-vehicle-driver-trailer.md).