АТС: Аналитика

Для построения отчётов и анализа эффективности найма рекомендуется использовать следующую логику выгрузки данных.

1. Выгрузка вакансий

Получите список всех вакансий, созданных или обновлённых за интересующий период.

Метод: POST /api/v1/jobs/search
Фильтр: date_updated_from и date_updated_to

2. Выгрузка апликантов

Загрузите всех апликантов, добавленных в систему.

Метод: POST /api/v1/applicants/search
Фильтр: date_created_from и date_created_to
Примечание: это могут быть резюме, ещё не привязанные к вакансиям

3. Выгрузка кандидатов

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

Метод: POST /api/v1/candidates/search
Фильтр: date_updated_from и date_updated_to
Действие: сохраните список candidate.id для последующего получения действий

4. Выгрузка действий

Получите историю перемещений и событий по кандидатам.

Метод: POST /api/v1/actions/search
Параметры: передайте список candidates_ids, полученный на предыдущем шаге
Результат: вы увидите переходы по этапам, отказы с причинами и другие активности

5. Выгрузка фидбеков по интервью

Получите скоркарты, которые интервьюеры заполнили по кандидату. Оба метода работают по одному кандидату, поэтому вызывайте их для candidate.id, собранных на шаге 3.

Метод: GET /api/v1/candidates/{candidate_id}/feedbacks
Результат: все фидбеки кандидата со всеми вопросами и ответами на них
Требуется: feature ats_scorecards=true и доступ к кандидату

Каждый элемент answers описывает один вопрос и ответ на него:

question_title: формулировка вопроса из скоркарты
question_type: open_answer, scale, select, employee_nps, goals, write_to_field, file
answer_text: текст открытого ответа
comment: комментарий интервьюера, доступен для вопроса любого типа
answer_options: выбранные варианты шкалы или списка, текстом
answer_score: числовое значение выбранного варианта шкалы

Оформительские элементы формы (text) в ответы не попадают - отвечать на них нечем.

Фидбеки, которые ещё никто не заполнил, тоже возвращаются: поля ответов пустые, status отличается от completed.

6. Выгрузка только оценок

Если нужны оценки без текстов ответов, используйте сводный метод.

Метод: GET /api/v1/candidates/{candidate_id}/feedbacks/overview
Результат: requested_count, completed_count, avg_scale_score, max_scale_score, avg_score_mark, score_marks
Требуется: feature ats_scorecards=true и доступ к кандидату