Переход с Platform Flow на Консоль.HRM

platform-flow-to-hrm

Компания работала с заданиями Platform Flow: создавала и публиковала задания, а площадка обрабатывала отклики и назначала исполнителя. После перехода на Консоль.HRM работа начинается с приглашения исполнителя. Сначала исполнитель проходит оформление и подключается к компании, затем ему создаётся задание. Компания самостоятельно управляет заданиями, договорами, документами и актами.

Полное описание методов Консоль.HRM приведено в документации API. Ниже описаны только изменения относительно текущего сценария Platform Flow.

Проверка доступности API (по необходимости)

Ничего не меняется. Используйте тот же метод:

GET /health — убедиться, что сервис отвечает.

Исполнители: приглашение и работа

Раньше: Platform Flow	Теперь: Консоль.HRM
Для нового исполнителя создаётся платформенное задание; номер передаётся в `contractor.phone`, после публикации человек получает ссылку на задание.	Сначала создайте приглашение исполнителя через API. Исполнитель проходит онбординг и становится исполнителем компании. Только после этого используйте его идентификатор в заданиях.
Исполнителя может назначить площадка после обработки отклика.	Компания сама формирует пул исполнителей и назначает их на задания.
Для исполнителя без договора задание может быть опубликовано, а договор оформляется в процессе работы с заданием.	Перед созданием задания дождитесь, когда исполнитель завершит требуемое оформление и будет доступен в списке исполнителей компании.
Платформенный `contractor_id` можно получить из задания или отклика.	Получите актуальный идентификатор через список исполнителей HRM. Не переносите идентификатор исполнителя из Platform Flow как готовый HRM-идентификатор.

Для приглашения используйте методы раздела contractor_invites: получите доступные сценарии онбординга, создайте приглашение, затем отслеживайте его статус. После завершения оформления получите исполнителя через GET /contractors и сохраните его HRM-идентификатор.

Документы, договоры и акты

Раньше: Platform Flow	Теперь: Консоль.HRM
Договор создаётся и подписывается в сценарии платформенного задания; отдельные операции с договором через API ограничены.	В API доступны операции с договорами и персональными документами исполнителя. Используйте их в текущем HRM-сценарии после оформления исполнителя.
Акт создаётся из задания через `POST /workflow/tasks/finalize`.	Этот способ сохраняется. Кроме того, HRM поддерживает создание актов без задания — используйте его, если в интеграции есть самостоятельный актовый сценарий.
Исполнитель и задание связаны в рамках площадки.	Компания ведёт исполнителя в собственном пуле; договоры и документы относятся к этому исполнителю и компании.

Справочники и структура заданий

Ничего не меняется. Используйте проекты, адреса, локации, шаблоны услуг, услуги и пользовательские поля.

Для услуг с категорией запрашивайте и передавайте категорию, доступную текущей HRM-компании. Не переиспользуйте идентификатор категории из другой компании или из Platform Flow без проверки.

Создание и правка заданий

Раньше: Platform Flow	Теперь: Консоль.HRM
`POST /workflow/platform/tasks` — создать платформенное задание. Нового исполнителя можно передать по номеру в `contractor.phone`.	`POST /workflow/tasks` — создать задание для исполнителя из пула компании. Передавайте `contractor_ids`, полученные после HRM-онбординга.
Публикация может быть выполнена одновременно с созданием через `transit_to_submitted_after_creation`.	Создайте задание, затем опубликуйте его отдельным `POST /workflow/tasks/submit` с массивом `ids`.
После публикации условия задания ограничены правилами площадки.	В HRM задание можно изменить методом `PATCH /workflow/tasks/{id}` в пределах доступных переходов и прав.
Для платформенного задания применяется сценарий оплаты площадки.	Не переносите ограничение Platform Flow на способ оплаты автоматически: параметры оплаты определяются настройками HRM-компании и её договором с исполнителем.

Задание для оформленного исполнителя

{
  "title": "Выкладка товара",
  "since_date": "2026-10-01",
  "since_time": "09:00",
  "upto_date": "2026-10-01",
  "upto_time": "18:00",
  "address_id": 12345,
  "contractor_ids": [67890],
  "duties": [
    { "title": "Выкладка товара", "price": 3500, "quantity": 1, "measure": "смена" }
  ]
}

Не передавайте в запросе поля, которые использовались только для привлечения исполнителя через задание: contractor.phone, task_url и transit_to_submitted_after_creation.

Отправка заданий исполнителям и управление статусами

Публикация заданий

Раньше	Теперь
После публикации площадка обрабатывает отклики и назначает исполнителя.	Опубликуйте задания через `POST /workflow/tasks/submit`. В запросе передайте `ids` заданий, уже связанных с исполнителями компании.

В одном пакетном запросе передавайте не более 10 000 идентификаторов. Это ограничение действует для HRM при групповых операциях с заданиями.

Назначение и подтверждение задания

Раньше	Теперь
Исполнителя выбирает и назначает площадка; вызов ручного принятия отклика не нужен.	Компания управляет назначением. Для подтверждения задания используйте `POST /workflow/tasks/{id}/confirm_by_company`; для отказа — `POST /workflow/tasks/{id}/decline_by_company`.
Интеграция получает актуальные данные из карточки платформенного задания.	Получайте карточку через `GET /workflow/tasks/{id}` и используйте её состояние как источник истины для последующих действий.

Выполнение, принятие и отзыв

Операция	Консоль.HRM
Изменить задание	`PATCH /workflow/tasks/{id}`
Опубликовать задания	`POST /workflow/tasks/submit`
Отозвать задания	`POST /workflow/tasks/revoke`
Отклонить результат	`POST /workflow/tasks/reject`
Принять результат одного задания	`POST /workflow/tasks/{id}/accept`
Создать акты по заданиям	`POST /workflow/tasks/finalize`

Не используйте workflow.accept_task_response как основание для смены состояния: этот сценарий относится к Platform Flow. В HRM изменения состояния выполняются методами заданий и подтверждаются ответом API.

Создание актов

Раньше: Platform Flow	Теперь: Консоль.HRM
Акт формируется из принятого задания.	Этот сценарий сохраняется: вызовите `POST /workflow/tasks/finalize` с массивом `ids`.
Самостоятельный акт вне задания не используется в платформенном сценарии.	При необходимости используйте отдельные методы HRM для создания и обработки актов без задания.

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

Пачки заданий

Раньше: Platform Flow	Теперь: Консоль.HRM
Пачка может содержать задания с номером нового исполнителя; после публикации платформа начинает его оформление.	Перед импортом пачки сначала пригласите исполнителей и получите их HRM-идентификаторы. В реестре указывайте этих исполнителей, а не номер телефона как способ приглашения.
После обработки пачки задания публикуются и площадка назначает исполнителя.	После обработки получите `task_ids`, опубликуйте задания и управляйте их статусами методами HRM.

В HRM реестр также может использоваться для допустимого изменения статуса существующего задания. Для этого передавайте идентификатор задания и целевой статус; не используйте изменение статуса как замену созданию или правке задания.

Краткая сводка: что поменялось

Привлечение исполнителя: вместо задания с номером телефона создавайте приглашение, дождитесь HRM-онбординга и получите contractor_id из списка исполнителей.
Создание задания: вместо POST /workflow/platform/tasks используйте POST /workflow/tasks и передавайте contractor_ids.
Публикация: выполняйте отдельный POST /workflow/tasks/submit; не передавайте transit_to_submitted_after_creation.
Назначение: компания подтверждает или отклоняет задание методами confirm_by_company и decline_by_company; площадка не назначает исполнителя автоматически.
Правка: используйте PATCH /workflow/tasks/{id} для доступных изменений задания.
Акты: сохраняется POST /workflow/tasks/finalize; в HRM также доступен отдельный сценарий акта без задания.
Пачки и реестры: используйте HRM-исполнителей; в пакетной операции передавайте не более 10 000 идентификаторов, а изменение статуса через реестр доступно для существующих заданий.