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

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

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

Остання синхронізація: 2026-02-23 12:40 (версія застосунку 2.0.0)

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

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

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

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

Бюджет

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

Ендпоїнти

GET https://api.flowtly.eu/budgets

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

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

POST https://api.flowtly.eu/budgets

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

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

GET https://api.flowtly.eu/budgets/{id}

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

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

PATCH https://api.flowtly.eu/budgets/{id}

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

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

DELETE https://api.flowtly.eu/budgets/{id}

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

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

GET https://api.flowtly.eu/budget-contractors

List budget-contractors

Retrieve budget-contractor records.

POST https://api.flowtly.eu/budget-contractors

Create budget-contractor

Create a new budget-contractor mapping.

GET https://api.flowtly.eu/budget-contractors/{id}

Get budget-contractor

Fetch a budget-contractor by ID.

DELETE https://api.flowtly.eu/budget-contractors/{id}

Delete budget-contractor

Remove a budget-contractor mapping.

GET https://api.flowtly.eu/budget-employees

List budget-employees

Retrieve employee budget allocations.

POST https://api.flowtly.eu/budget-employees

Create budget-employee

Create a new budget-employee allocation.

GET https://api.flowtly.eu/budget-employees/{id}

Get budget-employee

Fetch a budget-employee allocation.

DELETE https://api.flowtly.eu/budget-employees/{id}

Delete budget-employee

Remove a budget-employee allocation.

GET https://api.flowtly.eu/budget-groups

List budget-groups

Retrieve budget groups.

POST https://api.flowtly.eu/budget-groups

Create budget-group

Create a new budget group.

GET https://api.flowtly.eu/budget-groups/{id}

Get budget-group

Fetch a budget group by ID.

PATCH https://api.flowtly.eu/budget-groups/{id}

Update budget-group

Patch a budget group.

DELETE https://api.flowtly.eu/budget-groups/{id}

Delete budget-group

Remove a budget group.

GET https://api.flowtly.eu/budget-invoices

List budget-invoices

Retrieve budget-linked invoices.

POST https://api.flowtly.eu/budget-invoices

Create budget-invoice

Create a budget invoice mapping.

GET https://api.flowtly.eu/budget-invoices/{id}

Get budget-invoice

Fetch a budget invoice mapping.

DELETE https://api.flowtly.eu/budget-invoices/{id}

Delete budget-invoice

Remove a budget invoice mapping.

GET https://api.flowtly.eu/budget-projects

List budget-projects

Retrieve project allocations under budgets.

POST https://api.flowtly.eu/budget-projects

Create budget-project

Create a budget-project allocation.

GET https://api.flowtly.eu/budget-projects/{id}

Get budget-project

Fetch a budget-project allocation.

DELETE https://api.flowtly.eu/budget-projects/{id}

Delete budget-project

Remove a budget-project allocation.

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

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

Поля схеми

Budget-budget.read_budget_employee.read
Поле Тип Опис
id string Identifier of the budget.
name string Human-readable label (e.g. EMEA Marketing FY25).
type string Either global or employee-level budget.
granularity string Aggregation interval for reporting (month, quarter).
budgetGroup string | null Optional reference to a budget group.
dateFrom string | null Start of the validity window.
dateTo string | null End of the validity window.
config array Feature flags such as spend alerts.
budgetEmployees array Employee allocations tied to the budget.

Приклади

POST https://api.flowtly.eu/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 https://api.flowtly.eu/budget-transactions

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

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

POST https://api.flowtly.eu/budget-transactions

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

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

GET https://api.flowtly.eu/budget-transactions/{id}

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

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

PATCH https://api.flowtly.eu/budget-transactions/{id}

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

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

DELETE https://api.flowtly.eu/budget-transactions/{id}

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

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

GET https://api.flowtly.eu/income-transactions

List income-transactions

Retrieve income transactions.

POST https://api.flowtly.eu/income-transactions

Create income-transaction

Create an income transaction entry.

GET https://api.flowtly.eu/income-transactions/{id}

Get income-transaction

Fetch an income transaction by ID.

PATCH https://api.flowtly.eu/income-transactions/{id}

Update income-transaction

Patch an income transaction entry.

DELETE https://api.flowtly.eu/income-transactions/{id}

Delete income-transaction

Delete an income transaction entry.

GET https://api.flowtly.eu/project-transactions

List project-transactions

Retrieve project transactions.

POST https://api.flowtly.eu/project-transactions

Create project-transaction

Create a project transaction entry.

PATCH https://api.flowtly.eu/project-transactions/{id}

Update project-transaction

Patch a project transaction entry.

DELETE https://api.flowtly.eu/project-transactions/{id}

Delete project-transaction

Delete a project transaction entry.

GET https://api.flowtly.eu/transactions

List transactions

Retrieve generic transactions.

POST https://api.flowtly.eu/transactions

Create transaction

Create a generic transaction.

GET https://api.flowtly.eu/transactions/{id}

Get transaction

Fetch a transaction by ID.

PATCH https://api.flowtly.eu/transactions/{id}

Update transaction

Patch a transaction.

POST https://api.flowtly.eu/transactions/import

Import transactions

Bulk import transactions.

GET https://api.flowtly.eu/transactions/unassigned

List unassigned transactions

Retrieve transactions not yet linked to a budget.

GET https://api.flowtly.eu/transaction-attachments

List transaction-attachments

Retrieve transaction attachments.

POST https://api.flowtly.eu/transaction-attachments

Create transaction-attachment

Create a transaction attachment.

GET https://api.flowtly.eu/transaction-attachments/{id}

Get transaction-attachment

Fetch a transaction attachment by ID.

PATCH https://api.flowtly.eu/transaction-attachments/{id}

Update transaction-attachment

Patch a transaction attachment.

DELETE https://api.flowtly.eu/transaction-attachments/{id}

Delete transaction-attachment

Delete a transaction attachment.

POST https://api.flowtly.eu/transaction-attachments/create

Upload transaction-attachment

Upload a new transaction attachment.

GET https://api.flowtly.eu/transaction-attachments/search

Search transaction-attachments

Search transaction attachments by query.

POST https://api.flowtly.eu/transaction-attachments/{id}/apply-suggestion

Creates a TransactionAttachment resource.

Creates a TransactionAttachment resource.

POST https://api.flowtly.eu/transaction-attachments/{id}/apply-supplier-suggestion

Creates a TransactionAttachment resource.

Creates a TransactionAttachment resource.

POST https://api.flowtly.eu/transaction-attachments/{id}/detach

Creates a TransactionAttachment resource.

Creates a TransactionAttachment resource.

GET https://api.flowtly.eu/transaction-attachments/{id}/suggestions

Retrieves the collection of TransactionAttachment resources.

Retrieves the collection of TransactionAttachment resources.

GET https://api.flowtly.eu/transaction-attachments/{id}/suggestions-debug

Retrieves a TransactionAttachment resource.

Retrieves a TransactionAttachment resource.

POST https://api.flowtly.eu/transaction-attachments/{id}/suggestions/{suggestionId}/apply

Creates a TransactionAttachment resource.

Creates a TransactionAttachment resource.

POST https://api.flowtly.eu/transactions/attachments/zip

Download transaction attachments as zip

Creates a TransactionAttachmentsZipExport resource.

GET https://api.flowtly.eu/transactions/export/mt940

Retrieves a TransactionMt940Export resource.

Retrieves a TransactionMt940Export resource.

GET https://api.flowtly.eu/transactions/with-problems

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

GET https://api.flowtly.eu/transactions/{id}/suggestions

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

POST https://api.flowtly.eu/transactions/{id}/suggestions/{suggestionId}/apply

Creates a Transaction resource.

Creates a Transaction resource.

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

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

Поля схеми

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

Приклади

POST https://api.flowtly.eu/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
}

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

Рахунок

Відкрийте життєвий цикл рахунків, щоб фінанси, операції та клієнтські команди працювали з єдиним джерелом доходу.

Ендпоїнти

GET https://api.flowtly.eu/invoices

Список рахунків

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

POST https://api.flowtly.eu/invoices

Створити рахунок

Створіть новий рахунок із клієнтом, рядками та платіжними метаданими.

GET https://api.flowtly.eu/invoices/{id}

Отримати рахунок за ID

Перегляньте окремий рахунок із рядками та пов’язаними транзакціями.

PATCH https://api.flowtly.eu/invoices/{id}

Оновити рахунок

Оновіть статус, термін оплати або метадані після перевірки.

GET https://api.flowtly.eu/invoices/draft

Retrieves the collection of Invoice resources.

Retrieves the collection of Invoice resources.

GET https://api.flowtly.eu/invoices/name/{date}

Retrieves the collection of Invoice resources.

Retrieves the collection of Invoice resources.

POST https://api.flowtly.eu/invoices/send

Creates a Invoice resource.

Creates a Invoice resource.

DELETE https://api.flowtly.eu/invoices/{id}

Removes the Invoice resource.

Removes the Invoice resource.

GET https://api.flowtly.eu/invoices/{id}/send

Retrieves a Invoice resource.

Retrieves a Invoice resource.

POST https://api.flowtly.eu/invoices/{id}/send

Creates a Invoice resource.

Creates a Invoice resource.

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

Синхронізуйте рахунки з BI-дашбордами для контролю простроченої дебіторки та ризиків ліквідності.
Запускайте нагадування клієнтам, коли статус рахунку змінюється у Flowtly.

Поля схеми

Invoice-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Поле Тип Опис
id integer —
name string —
type string —
parent object —
childrenInvoices array —
client string —
tinType string —
tinCountry string | null —
tin string | null —
bankAccount string —
amountNet number —
amount number —
currency string | null —
conversionRate number | null —
generatedPdfExternalId string | null —
issueDate string —
saleDate string —
dueDate string —
targetAmount number | null —
paymentMethod string —
notes string | null —
invoiceRows array —
eInvoicing object —
invoiceTransactions array —
internalComment string —
targetAmountNet number | null —
status string —

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

Транзакція

Інтегруйте транзакційні дані між банком і ERP, щоб підтримувати контроль витрат і актуальну маржинальність.

Ендпоїнти

GET https://api.flowtly.eu/transactions

Список транзакцій

Отримуйте транзакції з фільтрами за призначенням і статусом.

POST https://api.flowtly.eu/transactions

Створити транзакцію

Створіть транзакцію із сумою, валютою та посиланнями на рахунок.

GET https://api.flowtly.eu/transactions/{id}

Отримати транзакцію за ID

Перегляньте окрему транзакцію з вкладеннями та зв’язком із витратами.

PATCH https://api.flowtly.eu/transactions/{id}

Оновити транзакцію

Оновіть класифікацію, призначення або поля звірки.

POST https://api.flowtly.eu/transactions/attachments/zip

Download transaction attachments as zip

Creates a TransactionAttachmentsZipExport resource.

GET https://api.flowtly.eu/transactions/export/mt940

Retrieves a TransactionMt940Export resource.

Retrieves a TransactionMt940Export resource.

POST https://api.flowtly.eu/transactions/import

Creates a Transaction resource.

Creates a Transaction resource.

GET https://api.flowtly.eu/transactions/unassigned

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

GET https://api.flowtly.eu/transactions/with-problems

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

GET https://api.flowtly.eu/transactions/{id}/suggestions

Retrieves the collection of Transaction resources.

Retrieves the collection of Transaction resources.

POST https://api.flowtly.eu/transactions/{id}/suggestions/{suggestionId}/apply

Creates a Transaction resource.

Creates a Transaction resource.

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

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

Поля схеми

Transaction-transaction.read
Поле Тип Опис
id string —
bankAccount string —
employeeOwner string | null —
cost string | null —
counterparty object —
counterpartyRole string | null —
statementNumber integer —
operationNumber string | null —
description string —
amount number —
endingBalance number —
orderDate string —
execDate string —
relatedDate string | null —
ignored integer —
note string | null —
transactionAttachments array —
budgetTransactions array —
projectTransactions array —
connectedMonth string —
Whatsapp