Qugo Integration API ## Sections • [Введение](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/introduction.md): Описание и возможности API: Документация упрощает API интеграции с платформой Qugo и автоматизацию бизнес-процессов компании. Методы API разделены на категории: Исполнители, Задания, Выплаты, Баланс и Документы, что облегчает навигацию и использование. Ключевые понятия и термины : Account (Заказчик) — пользователь платформы, который публикует задания и устанавливает вознаграждение за их выполнение. Workman (Исполнитель) — внештатный сотрудник, выполняющий задания и получающий за это оплату. Job (Задание ) — сущность, создаваемая заказчиком. Это работа, которую нужно выполнить за вознаграждение. Обладает параметрами: описание задания, срок выполнения и бюджет. JobOffer (Предложение по заданию\отлик) — предложение исполнителя с суммой, за которую он возьмётся за исполнение. JobInvite (Приглашение на задание) — Приглашение к исполнению задания, которое заказчик отправляет исполнителю. Приглашение приходит в виде ссылки в СМС-сообщении и в виде уведомлении на платформе. Исполнитель может принять или отклонить приглашение. Payroll Registry — Реестр выплат, через который в QUGO создаются задания с упрощенным жизненным циклом. Employee (Избранный исполнитель) — Исполнитель или будущий ещё не зарегистрированный исполнитель, который имел отношение к заказчику в рамках сервиса QUGO. Избранным он становится по следующему ряду причин: 1. Был приглашен в сервис через интерфейс или через методы API 2. Успешно выполнил задание, созданное заказчиком. 3. Зарегистрировался в сервисе по реферальной ссылке заказчика. Выплаты — транзакции за выполненные задания. Баланс — номинальный счет заказчика, используемый совершения выплат. Документы — документация, необходимая для отчетности и организации процесса выплат. Возможности API Приглашать исполнителей и запрашивать информацию о зарегистрированных исполнителях Запрашивать информацию о договорах, персональных документах исполнителей Создавать задания для исполнителей Формировать реестры на выплаты, оплачивать выполненные задания Создавать акты и запрашивать информацию о созданных на платформе актах Работать со номинальным счетом на платформе: запрашивать выписки, историю пополнений счета Ограничения и лимиты запросов : 1000 запросов в секунду Данные и методы : API поддерживает методы GET и POST . Все запросы и ответы передаются в формате JSON, что обеспечивает совместимость с большинством языков программирования. Структура ошибок : API возвращает стандартные коды ошибок HTTP: 4xx для клиентских ошибок, 5xx для серверных Title Description 🚀 Just getting started? Check out our Quickstart Guide. 🗓️ Need any assistance? Book a meeting • [Задания](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs.md): Сценарий работы через задания используется в случаях, когда вы работаете с самозанятыми исполнителями и хотите фиксировать завершение работ до проведения выплаты . В этом сценарии заказчик заранее создает задание, приглашает исполнителя к его выполнению, а выплата инициируется только после подтверждения результата. Задания можно создавать по одному или массово, загружая данные в формате JSON. Ниже приведены рекомендуемые сценарии работы с заданиями. Рекомендованные сценарии Одиночные задания Получить справочник услуг: GET /v1/common/services-groups Создать одиночное задание: POST /api/v1/jobs Пригласить исполнителя к заданию: по ИНН: POST /api/v1/jobs/{jobId}/invites/invite-by-inn , либо по телефону: POST /api/v1/jobs/{jobId}/invites/invite-by-phone . После выполнения работ: Заказчик подтверждает выполнение задания: POST /api/v1/job-offers/{offerId}/finish-execution Заказчик инициирует выплату по заданию POST /api/v1/job-offers/{offerId}/result-accept Если нужно изменить суммы выплаты Для завершения задания с изменения суммы выплаты по заданию заказчик запускает арбитраж POST /api/v1/job-offers/{offerId}/arbitration Получить информацию по статусу выплаты или получить акт и чек GET /api/v1/jobs/{jobId} Массовое создание заданий Получить справочник услуг: GET /v1/common/services-groups Загрузить реестр заданий в json POST /api/v1/job-registries/json метод возвращает id загруженного реестра. реестр не публикуется, исполнители не видят приглашений Опубликовать загруженный реестр POST /api/v1/job-registries/{id}/json метод возвращает информацию по общей сумме реестра и счетчики заданий Массовое принятие результата и инициация выплат по заданиям POST/api/v1/jobs/mass-result-accept (метод будет опубликован 20 марта 2026) При массовом принятии заданий их выполнение подтверждается автоматически. Если нужно изменить суммы выплаты Загрузка реестра изменения стоимости (арбитраж) POST /api/v1/job-mass-arbitrate/imports/json (метод в разработке) Публикация реестра изменения стоимости (арбитраж) POST /api/v1/job-mass-arbitrate/imports/{id}/json (метод в разработке) Допустимо использовать метод для одиночных заданий POST /api/v1/job-offers/{offerId}/arbitration Проверить статус реестра и по отдельным строкам можно через: Получение информации о реестре заданий 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 • [Получение списка заданий](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/poluchenie-spiska-vsekh-zadanii.md): Для поиска нужных заданий доступна фильтрация по статусам, дате и другим параметрам. Возвращает объект с метаданными и элементами заданий, включая заголовок, статус, бюджет и доступные действия. • [Получить справочник услуг](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/poluchit-spravochnik-uslug.md): Для заполнения параметра “тип услуг” при создании заданий понадобится точная формулировка из справочника. Метод отдает XSLX файл с наименованиями услуг и их id. Для создания задания необходимо указать id услуги из справочника. Точное указание id услуги критически важно при работе с модулем 1С от Qugo, так как при создании бухгалтерских документов система определяет номенклатуру на основе указанного типа услуги. • [Создание одиночного задания](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/sozdanie-odinochnogo-zadaniya.md): Создает одиночное задание с заданными параметрами. В теле запроса передаются: текст для чека; id услуги (из справочника GET /v1/common/services-groups ); бюджет; описание; дата начала и окончания теги задания файлы В ответе система возвращает: id задания; статус задания. После публикации задания в маркетплейсе любой исполнитель может откликнуться. • [Приглашение исполнителя к заданию по телефону](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/priglashenie-ispolnitelya-k-zadaniyu-po-telefonu.md): Метод позволяет заказчику пригласить избранного исполнителя к заданию, указав номер телефона и ID задания. При успешном приглашении возвращает объект с информацией о задании и исполнителе, включая детали задания, бюджет. • [Приглашение исполнителя к заданию по ИНН](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/priglashenie-ispolnitelya-k-zadaniyu-po-inn.md): Метод позволяет заказчику пригласить избранного исполнителя к конкретному заданию, используя ИНН и ID задания. При успешном приглашении возвращает объект с информацией о задании и исполнителе, включая детали задания, бюджет. • [Завершение задания](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/zavershenie-zadaniya.md): Метод переводит задание в статус “Выполнено”(completed). Только после этого можно принять результат и отправить выплату по заданию, используя POST /api/v1/job-offers/{offerId}/result-accept • [Принятие результата и отправка выплаты](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/prinyatie-rezultata-i-otpravka-vyplaty.md): Для отправки выплаты по одиночному заданию необходимо принять результат работы. После принятия исполнитель получает акт на подписание (если подключены), после подписания акта автоматически следует выплата. • [Завершение задания с изменением суммы выплаты](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/zavershenie-zadaniya-s-izmeneniem-stoimosti.md): Метод используется, если конечная сумма выплаты должна быть изменена в большую или меньшую сторону (в том числе до 0). Обязательно добавление комментария о причинах изменения стоимости. Задание отправляется в арбитраж. При увеличении суммы подтверждений от исполнителя не требуется. При уменьшении суммы выплаты требуется подтверждение от исполнителя. После подписание акта (если подключены) выплата по заданию уходит автоматически. • [Получение информации о задании](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/new-sectionpoluchenie-informacii-o-zadanii.md): Для получения документов (Чека, Договора, Акта) по заданию необходимо узнать ID задания (Job) и сделать запрос на получение документов. Закрывающие документы будут доступны после того, как статус задания изменится на PAID. В ответе выдает объект задания. Документы и ссылки находятся во вложеном jobOffer. Договор (Contract) - Ссылка в поле Origin. Приложение к договору (contract) - Ссылка в поле Origin. Акт (act) - Ссылка в поле Origin. Чек (receipt) - Ссылка в поле url. • [Загрузка реестра заданий](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/zagruzka-reestra-zadanii.md): Подходит, если нужно создать сразу множество заданий для разных исполнителей. В теле запроса передаётся массив заданий, для каждого указываются: тип услуги (по справочнику GET /v1/common/services-groups ); текст для чека; дата начала и окончания описание; сумма; ИНН (желательно) или телефон исполнителя; теги заданий В ответе система возвращает id реестра и его начальный статус. Настройка автопубликации реестра. Есть возможность исключить шаг подтверждения реестра. Если autoapply = true, то в течение 1 минуты реестр будет автоматически опубликован. Если autoapply = false. то реестр не будет опубликован без команды POST /api/v1/job-registries/{id}/json • [Публикация реестра заданий](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/publikaciya-reestra-zadanii.md): Используйте id реестра, полученного при загрузке реестра POST /api/v1/job-registries/json После публикации реестра исполнители получат приглашения к заданиям. • [Массовое принятие результата и отправка выплат](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/massovoe-prinyatie-rezultata-i-otpravka-vyplat.md): Метод будет опубликован 21 марта 2026 года. Принимает результат всех заданий в выбранном реесте и/или во всех выбранных заданиях. Выплаты по заданиям уходямт автоматически. Если подключены обязательные акты, то отправка выплаты происходит сразу после подписания. Метод работает только для заданий в статусе In progress (в работе). Не получится отправить выплату по зданиям, которые ранее были переведены в статус Completed (Выполнено) • [Получение информации о реестре заданий](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/poluchenie-informacii-o-reestre-zadanii.md): Метод позволяет получить основную информацию о загруженном ранее реестре заданий по его ID. В ответе возвращаются заголовок реестра, дата загрузки, общая сумма и счетчики по статусам обработки. Полезен для отслеживания статуса реестра и проверки, какие данные были загружены и обработаны. • [Получение элементов из реестра заданий](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/poluchenie-elementov-iz-reestra-zadanii.md): Метод позволяет получить список заданий, загруженных через конкретный реестр, с возможностью фильтрации и постраничного отображения. Поддерживает поиск по ФИО, ИНН, номеру телефона, а также фильтрацию по статусу чека. В ответе возвращается подробная информация по каждому элементу: название задания, исполнитель, статус, сумма, а также связанные документы (чек, акт, договор). • [Выгрузка файла с ошибочными записями реестра заданий](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/vygruzka-faila-s-oshibochnymi-zapisyami-reestra-zadanii.md): При загрузке реестры заданий проходят валидацию. В ходе проверки система отбраковывает строки с ошибками. Метод позволяет скачать Excel-файл с ошибками, обнаруженными при загрузке реестра заданий. В файле отображены строки с ошибками и расшифровка причин. • [Отмена задания](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/jobs/otmena-zadaniya.md): Для отмены задания нужно указать ID задания и добавить комментарий. Метод возвращает объект с данными задания. Применимо только для заданий, которые еще не взяты в работу . Для того, чтобы отказаться от выплаты по заданию, воспользуйтесь функционалом изменения стоимости (арбитраж) POST /api/v1/job-offers/{offerId}/arbitration • [Выплаты](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/payroll.md): Совершение выплат через реестр (payroll) - это упрощенный способ выплат физическим лицам, ИП, ООО. Не работает для выплат самозанятым. Подходит, если вы заранее знаете, кому и сколько нужно выплатить — например, за уже выполненную работу. Чтобы правильно указать код типа услуги, используйте справочник: GET /v1/common/services-groups Одиночная выплата без подтверждения Если хотите отправить только одну выплату, используйте метод: POST /api/v1/payroll-registries/direct Система сразу создаёт и оплачивает реестр. Подтверждения оплаты не требуется. Проверьте статус выплаты: GET /api/v1/payroll-registries/{id}/items Убедитесь, что статус выплаты — PAID Массовая отправка выплат Сформируйте реестр выплат в json POST/api/v1/payroll-registries/payrolls После загрузки реестр ожидает подтверждения Подтвердите оплату реестра POST /api/v1/payroll-registries/{registryId}/execute В ответ вы получите статус оплаты, ID реестра и итоговую сумму. Получите информацию по статусу выплат, ссылку на чек и/или акт GET /v1/payroll-registries/{registryId}/items Если возникли ошибки при загрузке реестра Если в загруженном реестре были ошибки (например, неверный ИНН или пустое поле), вы можете скачать Excel-файл с их расшифровкой: GET /v1/payroll-registries/{id}/errors Файл содержит список ошибочных строк и пояснения, что именно нужно исправить. Изменения можно вносить прямо в реестре ошибок. Удалите комментарии системы. Этот файл можно использовать как реестр выплат. • [Получение списка реестров выплат](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/payroll/poluchenie-spiska-reestrov-vyplat.md): Метод выдает список реестров выплат с возможностью постраничного отображения и фильтрации по строке поиска и заголовку. Каждый реестр содержит информацию о дате создания и статус: в ожидании выплаты, оплачено и т.д. • [Одиночная выплата](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/payroll/odinochnaya-vyplata.md): Формирование реестра выплат с одним элементом . Метод создаёт реестр выплат (payroll) с одним заданием и сразу же отправляет в оплату. Если подключены обязательные акты, то реестр уходит в оплату только после подписания акта. В ответ система отдает PayrollRegistry, который содержит ID созданного реестра. Не применимо для выплат самозанятым. Выдает ошибку, если исполнитель самозанятый. • [Загрузка реестра выплат](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/payroll/zagruzka-reestra-vyplat.md): На основе json запроса создается реестр выплат. В ответе система предоставляет информацию о сформированном реестре, включая статус, общую сумму и дату создания. Не применимо для выплат самозанятым. Выдает ошибку, если исполнитель самозанятый. • [Оплата реестра](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/payroll/oplata-reestra.md): Метод запускает оплату для указанного реестра выплат по его ID. После успешного выполнения система подтверждает завершение операции и предоставляет код ответа 204. • [Получение элементов реестра](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/payroll/poluchenie-elementov-reestra.md): Для проверки элементов реестра нужен ID реестра выплат, полученный на этапе формирования. Ответом будет массив элементов (Items), который содержит информацию по заданиям, созданным через Payroll Registry. paymentStatus будет содержать состояние задания в реестре: PENDING_VALIDATION - В ожидании валидации VALIDATION_FAILED - Ошибка валидации. Наиболее частые: исполнитель не является Самозанятым, исполнитель не зарегистрирован на платформе, у заказчика не подключен функционал Выплат. Информацию об ошибке есть в личном кабинете на странице qugo.ru/profile/payroll-registry /{ID} , где ID это ID реестра выплат. READY_TO_APPLY - Готов к применению APPLYING - В ожидании применения AWAITING_HOLD_BALANCE - Базовые сущности задачи созданы BALANCE_HOLD_FAILED - Недостаточно средств на балансе. Система сверяет баланс на счете Own . BALANCE_HOLD_COMPLETED - Средства зарезервированы ADDITIONAL_JOB_ENTITIES_CREATED - Дополнительные сущности задачи созданы PENDING_ACT_SIGNING - Ожидание подписания акта исполнителем. Статус возникает, если подключено условие об обязательном подписании акта со стороны исполнителя. Автоподписание акта происходит через 48 часов. PENDING_RECEIPT_GENERATION - Ожидание генерации чека PAYMENT_WAITING - В ожидании оплаты. На этом этапе чек уже сформирован. PAID - Оплачено. Финальный успешный статус. • [Выгрузка файла с ошибками](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/payroll/vygruzka-faila-s-oshibkami.md): Метод позволяет по id рееестра скачать Excel-файл с ошибками, обнаруженными при обработке загруженного реестра выплат. В файле указаны строки, в которых возникли ошибки, и комментарии с пояснением причины для каждой из них. • [Баланс](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/balance.md): В разделе собраны методы, связанные с запросом баланса и пополнения номинального счета заказчика. • [Запрос баланса счетов](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/balance/poluchenie-balansa-zakazchika.md): Метод возвращает текущую информацию о состоянии номинального счета заказчика и связанных с ним расчетных категорий. Ключевое значение — это own (собственные средства, доступные для выплат), но для полной картины отображаются и другие счета: обязательства, зарезервированные суммы, комиссии и расчетный остаток. Полезен для оценки доступного остатка, отслеживания зарезервированных средств и контроля расходов. Ответ содержит: own — доступные средства на номинальном счете; creditline — сумма текущих обязательств (принимает отрицательное значение); bank — прогнозируемый остаток после выполнения обязательств (own+creditline); hold — зарезервированные средства под задания и реестры; comissionhold — комиссия платформы по загруженным заданиям; reserved — сумма всех замороженных средств (hold + comissionhold). • [Документы](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/documents.md): В разделе собраны методы, связанные с получением закрывающих документов и договоров. • [Получение закрывающих документов](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/documents/poluchenie-zakryvayushikh-dokumentov.md) • [Получение списка договоров](https://app.theneo.io/9d13aa25-024b-4881-8720-6c20ddac5a92/qugo/qugo-integration-api/documents/poluchenie-spiska-dogovorov.md)