Бюджети та витрати – будуйте на Flowtly

Використовуйте цей добірний знімок OpenAPI-схеми Flowtly, щоб планувати інтеграції, автоматизувати процеси та синхронізувати дані, на які спираються ваші команди.

Статус документації

Остання синхронізація: 2025-12-11 09:43 (версія застосунку 2.0.0)

Публікується лише частина сутностей. Запускайте обидві команди синхронізації, щоб оновити цю документацію після виходу нових можливостей Flowtly.

Бюджети та витрати

Контролюйте фінансові плани, алокації та транзакції.

Огляд сутності

Бюджет

Публікуйте бюджети Flowtly у фінансові інструменти, щоб алокації, алерти та погодження залишалися синхронізованими.

Ендпоїнти

GET /api/budgets

Список бюджетів

Отримуйте бюджети з пагінацією та фільтрами за типом або валідністю.

POST /api/budgets

Створити бюджет

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

GET /api/budgets/{id}

Отримати бюджет за ID

Отримайте конкретний бюджет, щоб перевірити алокації та метадані.

PATCH /api/budgets/{id}

Оновити бюджет

Патчте дати бюджету, гранулярність або конфігураційні прапорці.

DELETE /api/budgets/{id}

Видалити бюджет

Видаліть бюджет, який більше не потрібно відстежувати.

GET /api/budget-contractors

List budget-contractors

Retrieve budget-contractor records.

POST /api/budget-contractors

Create budget-contractor

Create a new budget-contractor mapping.

GET /api/budget-contractors/{id}

Get budget-contractor

Fetch a budget-contractor by ID.

DELETE /api/budget-contractors/{id}

Delete budget-contractor

Remove a budget-contractor mapping.

GET /api/budget-employees

List budget-employees

Retrieve employee budget allocations.

POST /api/budget-employees

Create budget-employee

Create a new budget-employee allocation.

GET /api/budget-employees/{id}

Get budget-employee

Fetch a budget-employee allocation.

DELETE /api/budget-employees/{id}

Delete budget-employee

Remove a budget-employee allocation.

GET /api/budget-groups

List budget-groups

Retrieve budget groups.

POST /api/budget-groups

Create budget-group

Create a new budget group.

GET /api/budget-groups/{id}

Get budget-group

Fetch a budget group by ID.

PATCH /api/budget-groups/{id}

Update budget-group

Patch a budget group.

DELETE /api/budget-groups/{id}

Delete budget-group

Remove a budget group.

GET /api/budget-invoices

List budget-invoices

Retrieve budget-linked invoices.

POST /api/budget-invoices

Create budget-invoice

Create a budget invoice mapping.

GET /api/budget-invoices/{id}

Get budget-invoice

Fetch a budget invoice mapping.

DELETE /api/budget-invoices/{id}

Delete budget-invoice

Remove a budget invoice mapping.

GET /api/budget-projects

List budget-projects

Retrieve project allocations under budgets.

POST /api/budget-projects

Create budget-project

Create a budget-project allocation.

GET /api/budget-projects/{id}

Get budget-project

Fetch a budget-project allocation.

DELETE /api/budget-projects/{id}

Delete budget-project

Remove a budget-project allocation.

Сценарії використання

Створюйте річні cost centers з ERP і тримайте ліміти Flowtly актуальними.
Синхронізуйте бюджети маркетингових кампаній, щоб інструменти зупиняли витрати при перевищенні.

Поля схеми

Budget-budget.read_budget_employee.read
Поле Тип Опис
id string Унікальний ідентифікатор бюджету.
name string Зрозуміла назва бюджету.
type string Обсяг бюджету (глобальний або для співробітника).
granularity string Гранулярність звітності, наприклад місяць або квартал.
budgetGroup string | null IRI бюджетної групи, до якої належить цей бюджет.
dateFrom string | null Початок вікна дії бюджету.
dateTo string | null Кінець вікна дії бюджету.
config array Список увімкнених опцій, таких як алерти витрат.
budgetEmployees array Алокації співробітників у межах бюджету.

Приклади

POST /api/budgets

Створити глобальний маркетинговий бюджет

Налаштовує маркетинговий бюджет FY25, привʼязаний до наявної бюджетної групи з прапорцями автоматизації.

Пейлоад запиту 
{
    "name": "EMEA Marketing FY25",
    "type": "global",
    "granularity": "month",
    "dateFrom": "2024-01-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "budgetGroup": "/api/budget-groups/emarketing",
    "config": [
        "spend_alerts",
        "auto-freeze"
    ]
}
Пейлоад відповіді 
{
    "@id": "/api/budgets/bgt_fy25",
    "@type": "Budget",
    "id": "bgt_fy25",
    "name": "EMEA Marketing FY25",
    "type": "global",
    "granularity": "month",
    "dateFrom": "2024-01-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "budgetGroup": "/api/budget-groups/emarketing",
    "config": [
        "spend_alerts",
        "auto-freeze"
    ]
}

Огляд сутності

Бюджетна транзакція

Діліться даними про витрати в обидва боки, щоб і procurement-стек, і Flowtly узгоджували останні зафіксовані суми.

Ендпоїнти

GET /api/budget-transactions

Список бюджетних транзакцій

Отримайте журнал фінансових подій, що впливають на бюджет.

POST /api/budget-transactions

Створити бюджетну транзакцію

Привʼяжіть зовнішню транзакцію та, за потреби, співробітника до бюджету Flowtly.

GET /api/budget-transactions/{id}

Отримати бюджетну транзакцію

Перевірте транзакцію, привʼязану до бюджету, щоб оцінити вплив на витрати.

PATCH /api/budget-transactions/{id}

Оновити бюджетну транзакцію

Скоригуйте привʼязаний бюджет, співробітника або суму.

DELETE /api/budget-transactions/{id}

Видалити бюджетну транзакцію

Видаліть неправильний звʼязок бюджетної транзакції.

GET /api/income-transactions

List income-transactions

Retrieve income transactions.

POST /api/income-transactions

Create income-transaction

Create an income transaction entry.

GET /api/income-transactions/{id}

Get income-transaction

Fetch an income transaction by ID.

PATCH /api/income-transactions/{id}

Update income-transaction

Patch an income transaction entry.

DELETE /api/income-transactions/{id}

Delete income-transaction

Delete an income transaction entry.

GET /api/project-transactions

List project-transactions

Retrieve project transactions.

POST /api/project-transactions

Create project-transaction

Create a project transaction entry.

PATCH /api/project-transactions/{id}

Update project-transaction

Patch a project transaction entry.

DELETE /api/project-transactions/{id}

Delete project-transaction

Delete a project transaction entry.

GET /api/transactions

List transactions

Retrieve generic transactions.

POST /api/transactions

Create transaction

Create a generic transaction.

GET /api/transactions/{id}

Get transaction

Fetch a transaction by ID.

PATCH /api/transactions/{id}

Update transaction

Patch a transaction.

POST /api/transactions/import

Import transactions

Bulk import transactions.

GET /api/transactions/unassigned

List unassigned transactions

Retrieve transactions not yet linked to a budget.

GET /api/transaction-attachments

List transaction-attachments

Retrieve transaction attachments.

POST /api/transaction-attachments

Create transaction-attachment

Create a transaction attachment.

GET /api/transaction-attachments/{id}

Get transaction-attachment

Fetch a transaction attachment by ID.

PATCH /api/transaction-attachments/{id}

Update transaction-attachment

Patch a transaction attachment.

DELETE /api/transaction-attachments/{id}

Delete transaction-attachment

Delete a transaction attachment.

POST /api/transaction-attachments/create

Upload transaction-attachment

Upload a new transaction attachment.

GET /api/transaction-attachments/search

Search transaction-attachments

Search transaction attachments by query.

Сценарії використання

Надсилайте платежі інвойсів з вашої бухгалтерії, щоб Flowtly відображав фактичні витрати.
Привʼязуйте HR або вендорські витрати до бюджетів у момент їх затвердження.

Поля схеми

BudgetTransaction-budget_transaction.read_transaction.read
Поле Тип Опис
budget string IRI на бюджет, на який впливає транзакція.
transaction object IRI оригінальної ERP-транзакції.
employee string | null Співробітник, повʼязаний із витратами (може бути null).
amount integer | null Сума, списана з бюджету.

Приклади

POST /api/budget-transactions

Привʼязати ERP-транзакцію до бюджету

Повʼязує інвойс постачальника з маркетинговим бюджетом FY25 і фіксує власника.

Пейлоад запиту 
{
    "budget": "/api/budgets/bgt_fy25",
    "transaction": "/api/transactions/txn_904",
    "employee": "/api/employees/emp_777",
    "amount": 125000
}
Пейлоад відповіді 
{
    "@id": "/api/budget-transactions/btr_11",
    "@type": "BudgetTransaction",
    "id": "btr_11",
    "budget": "/api/budgets/bgt_fy25",
    "transaction": "/api/transactions/txn_904",
    "employee": "/api/employees/emp_777",
    "amount": 125000
}
Whatsapp