Добавить комментарий и получить файлы заказа со стороны исполнителя

Стенд по умолчанию — test. Сценарий изменяет данные. Порядок работы для агента.

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

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

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

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

1. Для добавления вызовите POST /api/comments/create/by/executer/v0 с data.flightId и data.content. В ответе приходит data.commentId.
2. Для чтения вызовите POST /api/comments/get/by/executer/v0 с тем же data.flightId. Выберите комментарий из data.comments.
3. Чтобы скачать вложение, вызовите POST /api/flights/comments/getFileByExecutor/v0. Передайте data.flightId, data.commentId и data.commentFileId. При 200 OK сохраните тело ответа как файл.

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

1. Вызовите POST /api/orders/file/listForExecutor/v0 с data.orderId и data.orgId. При необходимости исключите архив через data.hideArchive: true. Выберите готовый файл по имени. При нескольких совпадениях уточните выбор по паре из имени списка и id.
2. Вызовите GET /api/orders/file/forExecutor/v0 с id выбранного файла и orderId. Для orderRegularFiles укажите src=fs_order. Для conditionsTemplateRegularFiles и systemConditionsTemplateRegularFiles укажите src=fs_ct. При 200 OK сохраните байты ответа в локальном клиенте.

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

ОшибкиОшибки

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