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

Нужны роль исполнителя (`exec`), доступ к заказу или рейсу и права на выбранное действие. Перед добавлением комментария на рабочем стенде получите подтверждение пользователя.

## Комментарии к заказу

1. Перед добавлением комментария проверьте, от какой организации он будет записан. В исполняемом заказе сверьте назначенного исполнителя. В заказе со статусом `onMatch` метод не принимает `orgId`: сервер сам выбирает профиль из организаций, которым доступна запись. Выбор профиля в клиенте этого не меняет. Если нельзя подтвердить, что выбранная организация — единственная подходящая для этого вызова, остановитесь и предложите пользователю добавить комментарий в интерфейсе сервиса.
2. Если организация определена однозначно, вызовите [`POST /api/orders/comments/create/by/executer/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-orders-comments-create-by-executer-v0.md). Передайте `data.orderId` и `data.content`. При необходимости сохраните `data.commentId`.
3. Чтобы получить список, вызовите [`POST /api/orders/comments/get/by/executer/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-orders-comments-get-by-executer-v0.md) с тем же `data.orderId`. Выберите нужный комментарий из `data.comments`.
4. Чтобы скачать вложение, вызовите [`POST /api/orders/comments/getFileByExecutor/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-orders-comments-getfilebyexecutor-v0.md). Передайте `data.orderId`, идентификатор комментария в `data.commentId` и идентификатор из `comments[].files[].id` в `data.commentFileId`. При `200 OK` сохраните тело ответа как файл.

## Комментарии к рейсу

1. Для добавления вызовите [`POST /api/comments/create/by/executer/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-comments-create-by-executer-v0.md) с `data.flightId` и `data.content`. В ответе приходит `data.commentId`.
2. Для чтения вызовите [`POST /api/comments/get/by/executer/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-comments-get-by-executer-v0.md) с тем же `data.flightId`. Выберите комментарий из `data.comments`.
3. Чтобы скачать вложение, вызовите [`POST /api/flights/comments/getFileByExecutor/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-flights-comments-getfilebyexecutor-v0.md). Передайте `data.flightId`, `data.commentId` и `data.commentFileId`. При `200 OK` сохраните тело ответа как файл.

## Файлы заказа

1. Вызовите [`POST /api/orders/file/listForExecutor/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-orders-file-listforexecutor-v0.md) с `data.orderId` и `data.orgId`. При необходимости исключите архив через `data.hideArchive: true`. Выберите готовый файл по имени. При нескольких совпадениях уточните выбор по паре из имени списка и `id`.
2. Вызовите [`GET /api/orders/file/forExecutor/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/get-api-orders-file-forexecutor-v0.md) с `id` выбранного файла и `orderId`. Для `orderRegularFiles` укажите `src=fs_order`. Для `conditionsTemplateRegularFiles` и `systemConditionsTemplateRegularFiles` укажите `src=fs_ct`. При `200 OK` сохраните байты ответа в локальном клиенте.

Если имя совпадает только с записью из списка печатных форм, уточните получение или формирование документа. Для скачивания нужен ID готового файла.

## Ошибки

- При `403 Forbidden` проверьте права на конкретный заказ, рейс или файл.
- При `404 Not Found` сверьте идентификаторы объекта и файла.
- Если комментарий не виден исполнителю, проверьте его получателей в `viewers`.