Polska firma — tworzymy w Polsce 🇵🇱

Budżety i wydatki – platforma deweloperska Flowtly

Korzystaj z kuratowanego wycinka schematu OpenAPI Flowtly, aby planować integracje, automatyzować procesy i synchronizować kluczowe dane.

Status dokumentacji

Ostatnia synchronizacja: 2026-02-23 12:40 (wersja aplikacji 2.0.0)

Publicznie udostępniamy tylko część encji. Po każdej aktualizacji Flowtly uruchom obie komendy synchronizacji, by odświeżyć dane.

Budżety i wydatki

Kontroluj plany finansowe, przydziały i transakcje.

Przegląd encji

Budżet

Udostępniaj budżety Flowtly narzędziom finansowym, aby limity, alerty i akceptacje były zsynchronizowane.

Endpointy

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

Lista budżetów

Pobierz paginowane budżety z filtrami po typie i datach.

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

Utwórz budżet

Dodaj budżet z zakresem dat, grupą i flagami konfiguracyjnymi.

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

Pobierz budżet po ID

Odczytaj szczegóły budżetu oraz przydziały.

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

Zaktualizuj budżet

Skoryguj daty, granularność lub konfigurację budżetu.

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

Usuń budżet

Usuń budżet, którego nie trzeba dalej śledzić.

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.

Przypadki użycia

Twórz roczne centra kosztów w ERP i aktualizuj Flowtly najnowszymi limitami.
Synchronizuj budżety kampanii marketingowych, aby narzędzia performance zatrzymały wydatki przy alertach Flowtly.

Pola schematu

Budget-budget.read_budget_employee.read
Pole Typ Opis
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.

Przykłady

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

Utwórz globalny budżet marketingowy

Zakłada budżet FY25 powiązany z grupą i automatycznymi alertami.

Ładunek żądania 
{
    "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"
    ]
}
Ładunek odpowiedzi 
{
    "@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"
    ]
}

Przegląd encji

Transakcja budżetowa

Udostępniaj dane o wydatkach, aby zakupy i Flowtly widziały te same kwoty.

Endpointy

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

Lista transakcji budżetowych

Pobierz dziennik zdarzeń finansowych wpływających na budżet.

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

Utwórz transakcję budżetową

Powiąż transakcję i opcjonalnego pracownika z budżetem Flowtly.

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

Pobierz transakcję budżetową

Odczytaj transakcję powiązaną z budżetem, aby zobaczyć wpływ na wydatki.

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

Zaktualizuj transakcję budżetową

Dostosuj powiązany budżet, pracownika lub kwotę.

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

Usuń transakcję budżetową

Usuń błędne powiązanie transakcji z budżetem.

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.

Przypadki użycia

Przesyłaj płatności faktur z systemu księgowego, by Flowtly pokazywało aktualne zużycie.
Dołączaj koszty HR i vendorów do budżetów natychmiast po zatwierdzeniu.

Pola schematu

BudgetTransaction-budget_transaction.read_transaction.read
Pole Typ Opis
budget string IRI budżetu, którego dotyczy wydatek.
transaction object IRI źródłowej transakcji ERP.
employee string | null Pracownik odpowiedzialny za wydatek (opcjonalnie).
amount integer | null Kwota zaksięgowana na budżet.

Przykłady

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

Powiąż transakcję ERP z budżetem

Przypisuje fakturę dostawcy do budżetu FY25 i zapisuje właściciela wydatku.

Ładunek żądania 
{
    "budget": "/api/budgets/bgt_fy25",
    "transaction": "/api/transactions/txn_904",
    "employee": "/api/employees/emp_777",
    "amount": 125000
}
Ładunek odpowiedzi 
{
    "@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
}

Przegląd encji

Faktura

Udostępniaj dane cyklu życia faktury, aby finanse, operacje i zespoły obsługi pracowały na jednym źródle prawdy przychodów.

Endpointy

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

Lista faktur

Pobieraj kolekcję faktur z paginacją i filtrami statusu.

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

Utwórz fakturę

Utwórz nową fakturę z klientem, pozycjami i metadanymi płatności.

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

Pobierz fakturę po ID

Odczytaj pojedynczą fakturę wraz z pozycjami i powiązanymi transakcjami.

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

Zaktualizuj fakturę

Zmień status faktury, termin płatności lub metadane po weryfikacji.

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.

Przypadki użycia

Synchronizuj faktury do dashboardów BI, aby monitorować przeterminowane należności i ryzyko płynności.
Uruchamiaj przypomnienia do klientów, gdy status faktury zmieni się w Flowtly.

Pola schematu

Invoice-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Pole Typ Opis
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 —

Przegląd encji

Transakcja

Integruj dane transakcyjne między bankowością i ERP, aby utrzymać kontrolę kosztów i aktualne raporty marżowe.

Endpointy

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

Lista transakcji

Pobieraj kolekcję transakcji z filtrowaniem przypisań i statusu.

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

Utwórz transakcję

Utwórz transakcję z kwotą, walutą i referencjami konta.

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

Pobierz transakcję po ID

Odczytaj pojedynczą transakcję wraz z załącznikami i powiązaniem kosztów.

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

Zaktualizuj transakcję

Zmień klasyfikację, przypisanie lub pola uzgodnień transakcji.

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.

Przypadki użycia

Synchronizuj zaksięgowane transakcje do narzędzi zamknięcia miesiąca dla szybszych uzgodnień.
Zasilaj alerty budżetowe i widoki rentowności strumieniem transakcji w czasie rzeczywistym.

Pola schematu

Transaction-transaction.read
Pole Typ Opis
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