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

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

## Комментарии

1. Чтобы добавить комментарий, вызовите [`POST /api/orders/comments/create/by/forwarder/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-orders-comments-create-by-forwarder-v0.md). Передайте идентификатор заказа в `data.orderId`, а текст в `data.content`. Согласуйте получателей перед заполнением `data.viewers`. Если комментарий предназначен только для своей стороны, передайте `["forwarder"]`. Сохраните `data.commentId`.
2. Чтобы прочитать доступные комментарии, вызовите [`POST /api/orders/comments/get/by/forwarder/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-orders-comments-get-by-forwarder-v0.md) с тем же `data.orderId`. Для проверки записи найдите в `data.comments` элемент, у которого `id` равен сохранённому `commentId`.
3. Если запись завершилась тайм-аутом и ID неизвестен, передайте сверку пользователю. Одинаковый текст в списке не подтверждает, что его добавил этот запрос. Повторять создание автоматически нельзя.

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

1. Вызовите [`POST /api/orders/file/listForForwarder/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-orders-file-listforforwarder-v0.md) с идентификатором заказа в `data.orderId`. Для поиска только среди файлов вне архива укажите `data.hideArchive: true`.
2. Сопоставьте имя с полем `name` в списках ниже. Для выбора сохраните пару из имени списка и `id`. Если найдено несколько файлов с одинаковым именем, уточните выбор. Перед скачиванием проверьте, что выбранная пара есть в списке текущего заказа.
3. Вызовите [`GET /api/orders/file/forForwarder/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/get-api-orders-file-forforwarder-v0.md) с параметрами `id`, `orderId` и `src`. При `200 OK` сохраните байты ответа в локальном клиенте.

| Список готовых файлов в `data` | Значение `src` |
| --- | --- |
| `orderRegularFiles` | `fs_order` |
| `conditionsTemplateRegularFiles` | `fs_ct` |
| `systemConditionsTemplateRegularFiles` | `fs_ct` |

Записи из `orderPrintForms`, `conditionsTemplatePrintForms` и `systemConditionsTemplatePrintForms` описывают печатные формы. Их `id` сам по себе не подтверждает наличие готового файла. Если имя найдено только среди печатных форм, сообщите, что требуется отдельное получение или формирование документа. Для уже сформированного файла используйте его запись из списка готовых файлов.

## Ошибки

Если заказ или вложение не найдено, сверяйте идентификаторы и доступ заказчика к заказу. После ошибки прав не меняйте организацию без проверки доступа.