Добавить комментарий и посмотреть файлы заказа со стороны заказчика
Стенд по умолчанию — test. Сценарий изменяет данные. Порядок работы для агента.
Нужны идентификатор заказа, доступ к нему и права на выбранное действие. Перед добавлением комментария на рабочем стенде получите подтверждение пользователя.
Комментарии
- Чтобы добавить комментарий, вызовите
POST /api/orders/comments/create/by/forwarder/v0. Передайте идентификатор заказа вdata.orderId, а текст вdata.content. Согласуйте получателей перед заполнениемdata.viewers. Если комментарий предназначен только для своей стороны, передайте["forwarder"]. Сохранитеdata.commentId. - Чтобы прочитать доступные комментарии, вызовите
POST /api/orders/comments/get/by/forwarder/v0с тем жеdata.orderId. Для проверки записи найдите вdata.commentsэлемент, у которогоidравен сохранённомуcommentId. - Если запись завершилась тайм-аутом и ID неизвестен, передайте сверку пользователю. Одинаковый текст в списке не подтверждает, что его добавил этот запрос. Повторять создание автоматически нельзя.
Файлы заказа
- Вызовите
POST /api/orders/file/listForForwarder/v0с идентификатором заказа вdata.orderId. Для поиска только среди файлов вне архива укажитеdata.hideArchive: true. - Сопоставьте имя с полем
nameв списках ниже. Для выбора сохраните пару из имени списка иid. Если найдено несколько файлов с одинаковым именем, уточните выбор. Перед скачиванием проверьте, что выбранная пара есть в списке текущего заказа. - Вызовите
GET /api/orders/file/forForwarder/v0с параметрамиid,orderIdиsrc. При200 OKсохраните байты ответа в локальном клиенте.
Список готовых файлов в data |
Значение src |
|---|---|
orderRegularFiles |
fs_order |
conditionsTemplateRegularFiles |
fs_ct |
systemConditionsTemplateRegularFiles |
fs_ct |
Записи из orderPrintForms, conditionsTemplatePrintForms и systemConditionsTemplatePrintForms описывают печатные формы. Их id сам по себе не подтверждает наличие готового файла. Если имя найдено только среди печатных форм, сообщите, что требуется отдельное получение или формирование документа. Для уже сформированного файла используйте его запись из списка готовых файлов.
Ошибки
Если заказ или вложение не найдено, сверяйте идентификаторы и доступ заказчика к заказу. После ошибки прав не меняйте организацию без проверки доступа.