Docflow flow

Написать комментарий к документу

Changed on

Пишет комментарий в обсуждение карточки документооборота или заявки на оплату. Комментарий не меняет редакцию документа и не сбрасывает визы согласования. Писать вправе всякий, кто предмет видит (иначе 404). @упоминание: mentioned_user_ids — сотрудники кабинета, чьё «@Имя» (имя как в ответе mention-candidates) стоит в тексте; номер без имени в тексте, себя и не сотрудника кабинета не засчитывают. Упомянутому, который документ видит, уходит уведомление docflow_comment_mention со ссылкой на документ; кто не видит — записан с sees_document=false и уведомления не получает (доступ этим вызовом не выдаётся). Автору документа и участникам текущего прохода согласования — уведомление docflow_comment, не чаще одного на документ за 10 минут на человека. Пустой текст, текст длиннее 4000 знаков или больше 20 упоминаний — 422 docflow.comment.field с полем.

post/api/v1/docflow/comments

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/docflow/comments
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Request body

subject_kind'flow_document' | 'payment_request' required

Вид предмета: flow_document — карточка документооборота, payment_request — заявка на оплату

subject_idstring uuid required
bodystring required

Текст комментария; упоминание — «@Имя» в тексте

mentioned_user_idsinteger[]

Упомянутые сотрудники; засчитываются те, чьё «@Имя» стоит в тексте

Response

Комментарий

idstring uuid required
subject_kind'flow_document' | 'payment_request' required

Вид предмета

subject_idstring uuid required
author_idinteger required

Автор комментария

author_namestring required

Имя автора

bodystring required

Текст; пусто у удалённого

created_atstring date-time required
edited_atstring date-time

Когда текст исправили

deleted_atstring date-time

Когда комментарий удалили

deletedboolean required

Комментарий удалён — остался след

can_editboolean required

Смотрящий вправе исправить: свой и не прошло 15 минут

editable_untilstring date-time

До какого времени свой комментарий можно исправить

can_deleteboolean required

Смотрящий вправе удалить — свой комментарий

Changes