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

platform-flow-to-konsol-smz

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

Не все статусы встречаются у всех компаний: отметка о начале работы и отчёт исполнителя используются только если они включены в вашем сценарии. Если пункт не описан ниже, используйте его так же, как в текущей интеграции Platform Flow.

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

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

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

Исполнители: привлечение и работа

Раньше: Platform Flow	Теперь: Консоль.Самозанятые
Новый исполнитель создаётся отдельным приглашением, проходит оформление, затем его `contractor_id` используется при создании задания.	Отдельное приглашение для нового исполнителя не создаётся. Передайте его номер в `contractor.phone` при создании задания. После публикации платформа отправит человеку ссылку на задание; он зарегистрируется, пройдёт оформление и подпишет договор.
Можно вызвать API приглашений и затем работать со списком приглашений.	API приглашений для этого сценария не используется: новый исполнитель приходит через конкретное задание.
Задание можно адресовать оформленному исполнителю через `contractor_ids`.	Для уже оформленного исполнителя способ не меняется: передавайте `contractor_ids`.
Компания может получить отклики и принять выбранный отклик через `POST /workflow/tasks/{task_id}/responses/{response_id}/accept`.	Компания не принимает отклик вручную. Платформа сама выбирает и назначает подходящего исполнителя; вызов `responses/{response_id}/accept` не используйте.

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

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

Для нового исполнителя договор создаётся в процессе оформления после перехода по ссылке на задание. Не создавайте отдельный договор или приглашение в интеграции до создания задания.

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

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

Создание заданий

Раньше: Platform Flow	Теперь: Консоль.Самозанятые
`POST /workflow/platform/tasks` — создать одно задание. В теле передаются `title`, даты и время, адрес или удалённая работа, `contractor_ids`, услуги и другие поля.	Тот же endpoint. Для нового исполнителя вместо `contractor_ids` передайте `contractor.phone`. В ответе сохраняйте `task_id` и `task_url`.
Допустимы `payment_type: "prepay"` и `payment_type: "postpay"`.	Используйте только `payment_type: "postpay"` либо не передавайте поле: `postpay` применяется по умолчанию. `prepay` не поддерживается.
Исполнитель без договора может быть обработан по старому сценарию приглашения или отклика.	Задание с номером нового исполнителя создаётся без назначенного исполнителя. После публикации номер получает ссылку на публичную карточку задания.

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

{
  "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
}

При transit_to_submitted_after_creation: true задание публикуется сразу. Если создаёте черновик, публикуйте его обычным POST /workflow/tasks/submit с массивом ids. Ссылка исполнителю отправляется после фактической публикации, а не после сохранения черновика.

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

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

Раньше	Теперь
`POST /workflow/tasks/submit` с `ids` — опубликовать задания и перевести их в `submitted`.	Тот же endpoint. Для задания, созданного по телефону нового исполнителя, после публикации платформа отправляет ссылку на задание.

Назначение исполнителя

Раньше	Теперь
Для задания без исполнителя компания получает отклики, выбирает нужный и вызывает `POST /workflow/tasks/{task_id}/responses/{response_id}/accept`.	Не вызывайте этот endpoint. Платформа сама завершает назначение после оформления исполнителя. Актуальное состояние задания получайте через `GET /workflow/tasks/{id}`.

Перевод в работу и отчёт исполнителя

Набор статусов и переходов зависит от отметки о начале работы и отчёта исполнителя:

Без отметки: submitted → confirmed → accepted. После принятия задания исполнитель не вызывает check_in.
Только отметка о начале работы: после confirmed компания вызывает POST /workflow/tasks/check_in с ids; задание переходит в checked_in.
Только отчёт исполнителя: после confirmed исполнитель отправляет отчёт, задание переходит в completed; компания принимает результат после completed.
Обе отметки: компания вызывает check_in, затем исполнитель отправляет отчёт, после чего компания принимает результат.

Принятие результата и создание актов

Раньше	Теперь
`POST /workflow/tasks/accept` с `ids` — принять результат.	Тот же endpoint. Без отчёта исполнителя принимайте из `confirmed`; с отчётом — после `completed`.
`POST /workflow/tasks/finalize` с `ids` — создать акты по заданиям.	Тот же endpoint. Не объединяйте в одном запросе задания из разных сценариев.

После finalize работа с актами не меняется: используйте текущие методы получения, подписания и оплаты актов.

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

Раньше	Теперь
`POST /workflow/tasks_imports` — создать пачку заданий; после обработки получить `task_ids` и выполнить дальнейшие операции с заданиями.	Тот же метод. В строке реестра можно передать номер нового исполнителя; после публикации он получит ссылку на задание. Не заменяйте импорт массовой рассылкой приглашений.

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

Привлечение нового исполнителя: вместо приглашения передавайте contractor.phone в POST /workflow/platform/tasks.
Создание задания: endpoint остаётся POST /workflow/platform/tasks; для СМЗ используйте postpay.
Публикация: POST /workflow/tasks/submit не меняется; после публикации нового исполнителя уведомляет ссылка на задание.
Назначение: не вызывайте POST /workflow/tasks/{task_id}/responses/{response_id}/accept; платформа назначает исполнителя сама.
Статус задания: получайте карточку задания через GET /workflow/tasks/{id}; не меняйте состояние только по локальному предположению.
Принятие результата и акты: POST /workflow/tasks/accept и POST /workflow/tasks/finalize сохраняются; соблюдайте условия по confirmed и completed.
Пачки заданий: POST /workflow/tasks_imports сохраняется; для нового исполнителя передавайте телефон в строке реестра.