Переход с HRM на Консоль. Самозанятые

hrm-to-konsol-smz

В Консоль.HRM работа обычно начинается с приглашения исполнителя: компания приглашает человека, ждёт окончания оформления и подписания договора, затем создаёт ему задание или акт. В Консоль.Самозанятые основной объект интеграции — задание. Исполнитель приходит через опубликованное задание, а акт создаётся только по выполненному заданию.

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

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

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

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

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

Раньше: Консоль.HRMТеперь: Консоль.Самозанятые
Компания создаёт приглашение через API, исполнитель проходит онбординг, затем интеграция получает его contractor_id.API приглашений не используется. Новый исполнитель приходит через опубликованное задание. Для задания, адресованного конкретному новому человеку, передайте номер в contractor.phone при его создании.
Исполнителя можно приостановить или возобновить через API.Не используйте методы приостановки и возобновления исполнителя: в Консоль.Самозанятые они недоступны.
Компания сама выбирает отклик и может вызвать endpoint принятия отклика.Исполнителя назначает площадка. Не вызывайте POST /workflow/tasks/{task_id}/responses/{response_id}/accept.
Интеграция получает данные приглашения и управляет дальнейшим оформлением через API.Состояние задания и назначенного исполнителя получайте через GET /workflow/tasks/{id}. Данные отклика раскрываются после оформления договора.

Для исполнителя, с которым у компании уже есть договорные отношения, можно передать идентификатор в contractor_ids при создании задания.

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

Раньше: Консоль.HRMТеперь: Консоль.Самозанятые
Через API доступны операции с договорами и документами. Акт можно создать вручную или из задания — в зависимости от текущего сценария.Операции с договорами и документами не публикуются в API. Договор с назначенным исполнителем подписывается в кабинете компании.
Интеграция может создавать акт без задания.Акт создаётся только из задания через POST /workflow/tasks/finalize с массивом ids.
После создания акта используются методы его получения, подписания и оплаты.Этот порядок сохраняется. После finalize получите акт, подпишите его и оплатите доступными методами интеграции.

Не создавайте договор и акт вручную для нового исполнителя до создания задания.

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

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

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

Раньше: Консоль.HRMТеперь: Консоль.Самозанятые
POST /workflow/tasks — создать задание для исполнителя из пула компании.POST /workflow/platform/tasks — создать платформенное задание. Для нового исполнителя передайте contractor.phone; для исполнителя с действующим договором используйте contractor_ids.
Допустимы payment_type: "prepay" и payment_type: "postpay".Используйте только payment_type: "postpay" либо не передавайте поле: postpay применяется по умолчанию.
Условия задания можно менять после публикации по HRM-сценарию.После публикации условия задания не изменяются. Внесите необходимые изменения, пока задание находится в черновике.
Возможны разовые задания.Разовые задания не публикуются.

Задание для исполнителя с действующим договором

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

Задание для нового исполнителя

Передайте номер в международном формате +7….

{
  "title": "Выкладка товара",
  "since_date": "2026-10-01",
  "since_time": "09:00",
  "upto_time": "18:00",
  "address_id": 12345,
  "contractor": { "phone": "+79991234567" },
  "payment_type": "postpay",
  "duties": [
    { "title": "Выкладка товара", "price": 3500, "quantity": 1, "measure": "смена" }
  ],
  "transit_to_submitted_after_creation": true
}

Сохраните идентификатор задания и task_url из ответа. При transit_to_submitted_after_creation: true задание публикуется сразу. Если создаёте черновик, опубликуйте его отдельным методом.

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

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

РаньшеТеперь
Задание направляется исполнителю после того, как он приглашён и оформлен.Опубликуйте задание POST /workflow/tasks/submit с массивом ids. Новый исполнитель получает ссылку на задание и проходит оформление по этому сценарию.

Назначение исполнителя и договор

РаньшеТеперь
Компания выбирает исполнителя из своего пула или принимает нужный отклик.Исполнителя назначает площадка. Интеграция не принимает отклик вручную.
Договор можно вести через API до создания задания.После назначения договор подписывается в кабинете компании. Операции с договором через API не вызывайте.

Получайте текущее состояние задания через GET /workflow/tasks/{id}. Не рассчитывайте статус из последовательности отправленных запросов: назначение исполнителя и оформление выполняются вне вашей интеграции.

Принятие результата

Набор статусов зависит от того, используются ли отметка начала работы и отчёт исполнителя:

  • Без отчёта исполнителя: после оформления и подтверждения задания компания принимает результат через POST /workflow/tasks/accept с массивом ids.
  • С отметкой начала работы: компания вызывает POST /workflow/tasks/check_in с ids, когда наступает начало работы.
  • С отчётом исполнителя: исполнитель переводит задание в completed; после этого компания принимает результат через POST /workflow/tasks/accept.

Задание нельзя принять или завершить до окончания указанного в нём времени. Его также нельзя принять или завершить, пока не подписан договор с назначенным исполнителем.

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

Раньше: Консоль.HRMТеперь: Консоль.Самозанятые
Можно создать акт вручную либо завершить задание и сформировать акт по нему.Создавайте акт только через POST /workflow/tasks/finalize с массивом ids.
В одном сценарии могут обрабатываться задания и самостоятельные акты.В finalize передавайте только задания, готовые к завершению. Не заменяйте этот вызов ручным созданием акта.

После finalize получите созданный акт, подпишите его и оплатите доступными методами API.

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

Раньше: Консоль.HRMТеперь: Консоль.Самозанятые
Пачка заданий создаётся для исполнителей, которых компания уже пригласила или добавила в пул.Используйте POST /workflow/tasks_imports. В строке реестра можно передать номер нового исполнителя; после публикации он получит ссылку на задание.
После обработки пачки выполняются обычные операции с заданиями.Получите task_ids обработанной пачки и публикуйте, отслеживайте, принимайте и завершайте задания теми же методами, что и при поштучном создании.

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

  1. Привлечение исполнителя: вместо приглашения создавайте и публикуйте задание; для адресного задания новому человеку передавайте contractor.phone.
  2. Назначение: компания больше не выбирает и не принимает отклик вручную — исполнителя назначает площадка.
  3. Договор: не выполняйте операции с договором через API; договор с назначенным исполнителем подписывается в кабинете компании.
  4. Создание задания: вместо POST /workflow/tasks используйте POST /workflow/platform/tasks; применяйте только postpay.
  5. Правка задания: после публикации условия задания не изменяются.
  6. Акты: не создавайте акт вручную; формируйте его только POST /workflow/tasks/finalize.
  7. Пачки: POST /workflow/tasks_imports сохраняется; для нового исполнителя передавайте номер в строке реестра.