Задания

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

Задания можно создавать по одному или массово, загружая данные в формате JSON. Ниже приведены рекомендуемые сценарии работы с заданиями.

Рекомендованные сценарии

Одиночные задания

1. Получить справочник услуг: GET /v1/common/services-groups
2. Создать одиночное задание: POST /api/v1/jobs
3. Пригласить исполнителя к заданию:
   • по ИНН: POST /api/v1/jobs/{jobId}/invites/invite-by-inn,
   • либо по телефону: POST /api/v1/jobs/{jobId}/invites/invite-by-phone.
4. После выполнения работ:
   • Заказчик подтверждает выполнение задания: POST /api/v1/job-offers/{offerId}/finish-execution
   • Заказчик инициирует выплату по заданию POST /api/v1/job-offers/{offerId}/result-accept
5. Если нужно изменить суммы выплаты
   • Для завершения задания с изменения суммы выплаты по заданию заказчик запускает арбитраж POST /api/v1/job-offers/{offerId}/arbitration
6. Получить информацию по статусу выплаты или получить акт и чекGET /api/v1/jobs/{jobId}

Массовое создание заданий

1. Получить справочник услуг: GET /v1/common/services-groups
2. Загрузить реестр заданий в json POST /api/v1/job-registries/json
   • метод возвращает id загруженного реестра.
   • реестр не публикуется, исполнители не видят приглашений
3. Опубликовать загруженный реестр POST /api/v1/job-registries/{id}/json
   • метод возвращает информацию по общей сумме реестра и счетчики заданий
4. Массовое принятие результата и инициация выплат по заданиям POST/api/v1/jobs/mass-result-accept (метод будет опубликован 20 марта 2026)
   • При массовом принятии заданий их выполнение подтверждается автоматически.
5. Если нужно изменить суммы выплаты
   • Загрузка реестра изменения стоимости (арбитраж) POST /api/v1/job-mass-arbitrate/imports/json (метод в разработке)
   • Публикация реестра изменения стоимости (арбитраж) POST /api/v1/job-mass-arbitrate/imports/{id}/json (метод в разработке)
   • Допустимо использовать метод для одиночных заданий POST /api/v1/job-offers/{offerId}/arbitration
6. Проверить статус реестра и по отдельным строкам можно через:
   • Получение информации о реестре заданий GET api/v1/job-registries/{id}
   • Получение элементов из реестра заданий GET /api/v1/job-registries/{id}/items

Негативные сценарии:

Исполнитель отказался от выполнения на этапе приглашения к заданию. В этом случае далее допустимы следующие действия:

• Отмена задания заказчиком: POST /api/v1/jobs/{id}/cancel
• Повторное приглашение того же или иного исполнителя к заданию POST /api/v1/jobs/{jobId}/invites/invite-by-inn

Исполнитель не принял арбитраж POST /api/v1/job-offers/{offerId}/arbitration, далее допустимо

• отправить арбитраж повторно

Ошибка при валидации реестра заданий (до его публикации) Для получения файла с ошибками по строкам загружаемого реестра используется метод

• GET /api/v1/job-registries/{registryId}/failed Возвращает файл с ошибками по строкам загружаемого реестра.
• в проработке находится метод получения реестра ошибок в json