Главная / Документация / APIAPI: бюджет, табели и ставкиМаршруты бюджета проекта, расчетов эффективности, табелей, согласования часов, ставок и бухгалтерских сводок volrix.pm с правами и примерами.Обновлено 27.09.2026Группа описывает деньги и время: статьи бюджета проекта с планом и фактом, запросы на изменение бюджета и сроков, расчеты эффективности (денежные потоки по периодам), табели сотрудников и их согласование, ставки по проектным ролям и сводки трудозатрат для бухгалтерии.**Что принимает API-ключ.** Бухгалтерские сводки (accounting:read, выгрузка - accounting:export), ставки (rate_cards:...) и пересчет бюджета команды (budget:manage_lines). Бюджет и расчеты конкретного проекта проверяют участие в нем, табель относится к самому пользователю - эти маршруты работают только в сессии.Базовый адрес, формат ответов и коды ошибок описаны в статье API: адрес, первый запрос и ответы, выпуск ключа и вход под пользователем - в статье API: вход, токен и API-ключи. В примерах ключ лежит в переменной окружения VOLRIX_API_KEY, токен пользователя - в VOLRIX_TOKEN.Типовой сценарий: выгрузка трудозатрат в учетную систему

Выберите период Сводки принимают date_from и date_to в формате ГГГГ-ММ-ДД. Параметры необязательны: без них сводка строится без ограничения по датам, поэтому передавайте границы явно.

Получите итоги GET /api/v1/accounting/labor-summary (accounting:read) - утвержденные часы по проектам и людям: всего, оплачиваемые, неоплачиваемые, ставка и фактическая стоимость.

Разложите по разрезам GET /api/v1/accounting/labor-breakdown с group_by: project (по умолчанию), person, role или center; GET .../labor-monthly - по месяцам.

Заберите файл GET /api/v1/accounting/labor-summary/export с тем же периодом (accounting:export) - та же сводка в CSV.

Табель заполняет сам сотрудник: PUT /me/timesheet/entry (одна ячейка, тело EntryUpsert: work_date и hours обязательны), затем POST /me/timesheet/periods/{period_id}/submit. Согласующий видит часы в GET /timesheet/approvals/pending и принимает или возвращает их по сегментам: POST .../{segment_id}/approve или .../reject.Примеры запросовСводка трудозатрат за сентябрь по ключу (скоуп accounting:read):curl --fail-with-body -sS \ -H "X-Api-Key: $VOLRIX_API_KEY" \ "https://ваш-адрес/api/v1/accounting/labor-summary?date_from=2026-09-01&date_to=2026-09-30"Бюджет проекта от имени участника (сессия):curl --fail-with-body -sS \ -H "Authorization: Bearer $VOLRIX_TOKEN" \ "https://ваш-адрес/api/v1/projects/{project_id}/budget"МаршрутыКак читать колонку «Доступ»: **скоуп вида users:read** - маршрут принимает API-ключ, если в ключе есть этот скоуп, а у сотрудника, выпустившего ключ, есть такое же право в роли (users.read). Если скоупов несколько через «+», нужны все. **Только сессия** - нужен заголовок Authorization: Bearer, API-ключ получит 403. **Без авторизации** - заголовки не нужны. Доступ к конкретному объекту (участие в проекте, права на папку Диска) сервер проверяет дополнительно. Пути в таблицах указаны полностью, от корня сервера.Бюджет проекта и запросы на изменение

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/projects/{project_id}/budget

project_id [path обяз.]: string (uuid)

Только сессия

200: object

GET /api/v1/projects/{project_id}/labor-actuals

project_id [path обяз.]: string (uuid)

Только сессия

200: object

GET /api/v1/projects/{project_id}/budget/export

project_id [path обяз.]: string (uuid)

Только сессия

200: object

POST /api/v1/projects/{project_id}/budget/lines

project_id [path обяз.]: string (uuid) | Тело: application/json: BudgetLineCreate

Только сессия

201: object

PUT /api/v1/projects/{project_id}/budget/lines/{line_id}

project_id [path обяз.]: string (uuid); line_id [path обяз.]: string (uuid) | Тело: application/json: BudgetLineUpdate

Только сессия

200: object

DELETE /api/v1/projects/{project_id}/budget/lines/{line_id}

project_id [path обяз.]: string (uuid); line_id [path обяз.]: string (uuid)

Только сессия

200: object

PATCH /api/v1/projects/{project_id}/budget/lines/{line_id}/actual

project_id [path обяз.]: string (uuid); line_id [path обяз.]: string (uuid) | Тело: application/json: object

Только сессия

200: object

GET /api/v1/projects/{project_id}/change-requests

project_id [path обяз.]: string (uuid)

Только сессия

200: object

POST /api/v1/projects/{project_id}/change-requests

project_id [path обяз.]: string (uuid) | Тело: application/json: ChangeRequestCreate

Только сессия

201: object

Расчеты эффективности

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/projects/{project_id}/calculations

project_id [path обяз.]: string (uuid)

Только сессия

200: array[CalculationListItem]

POST /api/v1/projects/{project_id}/calculations

project_id [path обяз.]: string (uuid) | Тело: application/json: CalculationCreate

Только сессия

201: CalculationDetail

GET /api/v1/projects/{project_id}/calculations/{calc_id}

project_id [path обяз.]: string (uuid); calc_id [path обяз.]: string (uuid)

Только сессия

200: CalculationDetail

PUT /api/v1/projects/{project_id}/calculations/{calc_id}

project_id [path обяз.]: string (uuid); calc_id [path обяз.]: string (uuid) | Тело: application/json: CalculationUpdate

Только сессия

200: CalculationDetail

DELETE /api/v1/projects/{project_id}/calculations/{calc_id}

project_id [path обяз.]: string (uuid); calc_id [path обяз.]: string (uuid)

Только сессия

204

POST /api/v1/projects/{project_id}/calculations/{calc_id}/drivers

project_id [path обяз.]: string (uuid); calc_id [path обяз.]: string (uuid) | Тело: application/json: DriverCreate

Только сессия

201: CalculationDetail

PUT /api/v1/projects/{project_id}/calculations/{calc_id}/drivers/{driver_id}

project_id [path обяз.]: string (uuid); calc_id [path обяз.]: string (uuid); driver_id [path обяз.]: string (uuid) | Тело: application/json: DriverUpdate

Только сессия

200: CalculationDetail

DELETE /api/v1/projects/{project_id}/calculations/{calc_id}/drivers/{driver_id}

project_id [path обяз.]: string (uuid); calc_id [path обяз.]: string (uuid); driver_id [path обяз.]: string (uuid)

Только сессия

200: CalculationDetail

Бюджет команды

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

POST /api/v1/projects/{project_id}/team-budget/recalculate

project_id [path обяз.]: string (uuid)

budget:manage_lines

200: object

Бухгалтерия: трудозатраты

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/accounting/labor-summary

date_from [query]: string (date) / null; date_to [query]: string (date) / null

accounting:read

200: object

GET /api/v1/accounting/labor-breakdown

group_by [query]: string (default=project); date_from [query]: string (date) / null; date_to [query]: string (date) / null

accounting:read

200: object

GET /api/v1/accounting/labor-monthly

date_from [query]: string (date) / null; date_to [query]: string (date) / null

accounting:read

200: object

GET /api/v1/accounting/labor-summary/export

date_from [query]: string (date) / null; date_to [query]: string (date) / null

accounting:export

200: object

Мой табель

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/me/timesheet

ref_date [query]: string (date) / null; kind [query]: string / null; period_start [query]: string (date) / null; period_end [query]: string (date) / null

Только сессия

200: GridResponse

PUT /api/v1/me/timesheet/entry

Нет | Тело: application/json: EntryUpsert

Только сессия

200: EntryRead

PUT /api/v1/me/timesheet/entries

Нет | Тело: application/json: BulkEntries

Только сессия

200: array[EntryRead]

POST /api/v1/me/timesheet/distribute

Нет | Тело: application/json: DistributeIn

Только сессия

200: array[EntryRead]

DELETE /api/v1/me/timesheet/entry/{entry_id}

entry_id [path обяз.]: string (uuid)

Только сессия

204

GET /api/v1/me/timesheet/periods

Нет

Только сессия

200: array[PeriodRead]

POST /api/v1/me/timesheet/periods/{period_id}/submit

period_id [path обяз.]: string (uuid)

Только сессия

200: PeriodRead

POST /api/v1/me/timesheet/periods/{period_id}/recall

period_id [path обяз.]: string (uuid)

Только сессия

200: PeriodRead

GET /api/v1/me/timesheet/periods/{period_id}/segments

period_id [path обяз.]: string (uuid)

Только сессия

200: array[PeriodSegmentRead]

Согласование табелей

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/timesheet/approvals/pending

Нет

Только сессия

200: array[PendingSegment]

POST /api/v1/timesheet/approvals/{segment_id}/approve

segment_id [path обяз.]: string (uuid)

Только сессия

200: SegmentResult

POST /api/v1/timesheet/approvals/{segment_id}/reject

segment_id [path обяз.]: string (uuid) | Тело: application/json: RejectBody

Только сессия

200: SegmentResult

Ставки

Метод и путь

Параметры и тело

Доступ (скоуп ключа)

Успешный ответ

GET /api/v1/rate-cards

project_role [query]: string / null; is_active [query]: boolean / null

rate_cards:read

200: object

POST /api/v1/rate-cards

Нет | Тело: application/json: RateCardCreate

rate_cards:create

201: object

GET /api/v1/rate-cards/known-roles

Нет

rate_cards:read

200: object

GET /api/v1/rate-cards/next-working-day

after [query обяз.]: string (date)

rate_cards:read

200: object

GET /api/v1/rate-cards/schedule/{project_role}

project_role [path обяз.]: string; project_id [query]: string (uuid) / null

rate_cards:read

200: object

POST /api/v1/rate-cards/schedule

Нет | Тело: application/json: RateScheduleSave

rate_cards:create

200: object

GET /api/v1/rate-cards/{card_id}

card_id [path обяз.]: string (uuid)

rate_cards:read

200: object

PUT /api/v1/rate-cards/{card_id}

card_id [path обяз.]: string (uuid) | Тело: application/json: RateCardUpdate

rate_cards:update

200: object

DELETE /api/v1/rate-cards/{card_id}

card_id [path обяз.]: string (uuid)

rate_cards:delete

204

Тела запросовПоля JSON и форм multipart из схемы сервера. «Да» - поле обязательно. Ссылка на другую схему (например, array[QCApproverInput]) означает вложенный объект с теми же полями.BudgetLineCreate: POST /projects/{project_id}/budget/lines

Поле

Обязательно

Тип / значения

Ограничения

expense_type

Нет

string

default="capex"

category

Да

string

period

Нет

string

default="month"

planned_amount

Да

number / string

actual_amount

Нет

number / string / null

note

Нет

string / null

BudgetLineUpdate: PUT /projects/{project_id}/budget/lines/{line_id}

Поле

Обязательно

Тип / значения

Ограничения

expense_type

Нет

string / null

category

Нет

string / null

planned_amount

Нет

number / string / null

actual_amount

Нет

number / string / null

note

Нет

string / null

ChangeRequestCreate: POST /projects/{project_id}/change-requests

Поле

Обязательно

Тип / значения

Ограничения

justification

Да

string

new_budget

Нет

number / string / null

new_end_date

Нет

string (date) / null

new_stage_id

Нет

string (uuid) / null

CalculationCreate: POST /projects/{project_id}/calculations

Поле

Обязательно

Тип / значения

Ограничения

name

Да

string

description

Нет

string / null

period_kind

Нет

PeriodKind

default="year"

periods_count

Нет

integer

default=5; minimum=1.0; maximum=600.0

start_date

Нет

string (date) / null

discount_rate_annual

Нет

number / string

default="0"

rate_basis

Нет

RateBasis

default="effective"

currency

Нет

string

default="RUB"

drivers

Нет

array[DriverCreate]

CalculationUpdate: PUT /projects/{project_id}/calculations/{calc_id}

Поле

Обязательно

Тип / значения

Ограничения

name

Нет

string / null

description

Нет

string / null

period_kind

Нет

PeriodKind / null

periods_count

Нет

integer / null

start_date

Нет

string (date) / null

discount_rate_annual

Нет

number / string / null

rate_basis

Нет

RateBasis / null

currency

Нет

string / null

DriverCreate: POST /projects/{project_id}/calculations/{calc_id}/drivers

Поле

Обязательно

Тип / значения

Ограничения

name

Да

string

direction

Да

DriverDirection

category

Нет

string / null

input_mode

Нет

DriverInputMode

default="manual"

values

Нет

array[number / string] / null

base_amount

Нет

number / string / null

growth_rate

Нет

number / string / null

start_period

Нет

integer / null

end_period

Нет

integer / null

sort_order

Нет

integer

default=0

DriverUpdate: PUT /projects/{project_id}/calculations/{calc_id}/drivers/{driver_id}

Поле

Обязательно

Тип / значения

Ограничения

name

Нет

string / null

direction

Нет

DriverDirection / null

category

Нет

string / null

input_mode

Нет

DriverInputMode / null

values

Нет

array[number / string] / null

base_amount

Нет

number / string / null

growth_rate

Нет

number / string / null

start_period

Нет

integer / null

end_period

Нет

integer / null

sort_order

Нет

integer / null

EntryUpsert: PUT /me/timesheet/entry

Поле

Обязательно

Тип / значения

Ограничения

work_date

Да

string (date)

hours

Да

number / string

task_id

Нет

string (uuid) / null

activity_type

Нет

string

default="project"

comment

Нет

string / null

is_billable

Нет

boolean

default=true

BulkEntries: PUT /me/timesheet/entries

Поле

Обязательно

Тип / значения

Ограничения

cells

Да

array[BulkCell]

maxItems=1000

DistributeIn: POST /me/timesheet/distribute

Поле

Обязательно

Тип / значения

Ограничения

days

Да

array[string (date)]

minItems=1; maxItems=400

hours

Да

number / string

task_id

Нет

string (uuid) / null

activity_type

Нет

string

default="project"

RejectBody: POST /timesheet/approvals/{segment_id}/reject

Поле

Обязательно

Тип / значения

Ограничения

reason

Нет

string / null

RateCardCreate: POST /rate-cards

Поле

Обязательно

Тип / значения

Ограничения

project_role

Да

string

minLength=1; maxLength=255

hourly_rate

Да

number / string

expense_type

Нет

string

default="opex"

valid_from

Да

string (date)

valid_to

Нет

string (date) / null

currency

Нет

string

default="RUB"; minLength=3; maxLength=3

is_active

Нет

boolean

default=true

RateScheduleSave: POST /rate-cards/schedule

Поле

Обязательно

Тип / значения

Ограничения

project_role

Да

string

minLength=1; maxLength=255

stages

Да

array[RateScheduleStageIn]

project_id

Нет

string (uuid) / null

RateCardUpdate: PUT /rate-cards/{card_id}

Поле

Обязательно

Тип / значения

Ограничения

project_role

Нет

string / null

hourly_rate

Нет

number / string / null

expense_type

Нет

string / null

valid_from

Нет

string (date) / null

valid_to

Нет

string (date) / null

currency

Нет

string / null

is_active

Нет

boolean / null

Вложенный объект BulkCell

Поле

Обязательно

Тип / значения

Ограничения

work_date

Да

string (date)

hours

Да

number / string

task_id

Нет

string (uuid) / null

activity_type

Нет

string

default="project"

Вложенный объект RateScheduleStageIn

Поле

Обязательно

Тип / значения

Ограничения

valid_from

Нет

string (date) / null

valid_to

Нет

string (date) / null

hourly_rate

Да

number / string

expense_type

Нет

string

default="opex"

currency

Нет

string

default="RUB"

Значения перечислений

Тип

Допустимые значения

DriverDirection

inflow, outflow

DriverInputMode

manual, parametric

PeriodKind

year, quarter, month

RateBasis

effective, simple

Если не получается

Что видно

Причина и что сделать

403 «API-ключи не поддерживаются на этом эндпоинте»

У маршрута в таблице указано «Только сессия». Выполните его с заголовком Authorization: Bearer от имени сотрудника, см. вход под пользователем.

Сводка пустая или меньше ожидаемого

В сводку входят только утвержденные часы. Проверьте, что табели за период согласованы (GET /timesheet/approvals/pending), и формат date_from и date_to (ГГГГ-ММ-ДД).

403 на пересчете бюджета команды

POST /projects/{project_id}/team-budget/recalculate требует скоуп budget:manage_lines и такое же право у владельца ключа.

403 «API-ключ не имеет права (...)»

В ключе нет скоупа из колонки «Доступ». Скоупы после создания не меняются: выпустите новый ключ с нужным скоупом в «Администрирование» → «Настройки продукта» → «Интеграции» и отзовите старый.

403 «Недостаточно прав (...)»

У пользователя или у сотрудника, выпустившего ключ, нет названного права в роли (с 0.110.6 для ключа проверяются и скоуп, и право владельца). Добавьте право в роль: «Администрирование» → «Доступ» → «Роли и права».

423 на POST, PUT, PATCH или DELETE, чтение работает

Нет действующей лицензии (в ответе license_status: expired, invalid, missing или mismatch). Изменения заблокированы до загрузки файла лицензии, см. Лицензия.

Финансы проекта

Мои трудозатраты

Бухгалтерия и финансы

Бюджет, факт и расчетыЗаполнить и отправить табельПроверить трудозатраты и себестоимость

Интеграции и REST API

Функциональная карта