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-04-03 18:31 (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.

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

Usuń budżet

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

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

Zaktualizuj budżet

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

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_budget_project.read

Pole	Typ	Opis
`id`	string	Unikalny identyfikator budżetu.
`name`	string	Nazwa budżetu widoczna dla użytkowników.
`type`	string	Zakres budżetu (globalny lub pracowniczy).
`granularity`	string	Granularność raportowania, np. miesiąc.
`budgetGroup`	string \| null	Pole budgetGroup.
`attributeSet`	string \| null	Pole attributeSet.
`dateFrom`	string \| null	Pole dateFrom.
`dateTo`	string \| null	Pole dateTo.
`config`	array	Lista włączonych opcji (np. alerty wydatków).
`budgetEmployees`	array	Pole budgetEmployees.
`budgetProjects`	array	Pole budgetProjects.

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.

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

Usuń transakcję budżetową

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

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

Zaktualizuj transakcję budżetową

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

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`	string \| null	Kwota zaksięgowana na budżet.

Przegląd encji

Grupa budżetowa

Organizuj budżety w logiczne grupy (departamenty, projekty, centra kosztów) dla raportowania zbiorczego.

Endpointy

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

Lista grup budżetowych

Pobiera kolekcję zasobów BudgetGroup.

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

Utwórz grupę budżetową

Tworzy zasób BudgetGroup.

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

Pobierz grupę budżetową po ID

Pobierz pojedynczy zasób za pomocą jego identyfikatora.

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

Usuń grupę budżetową

Usuń zasób.

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

Zaktualizuj grupę budżetową

Zaktualizuj pola zasobu za pomocą JSON Merge Patch.

Przypadki użycia

Odwzoruj hierarchię swojego planu kont w grupach budżetowych Flowtly.

Twórz grupy budżetowe dla każdej jednostki biznesowej na potrzeby skonsolidowanych pulpitów wydatków.

Pola schematu

BudgetGroup-budget_group.read_budget_group.projects.read

Pole	Typ	Opis
`id`	string	Pole id.
`name`	string	Pole nazwy.
`projects`	array	Pole projektów.

Przegląd encji

Koszt i dostawca

Śledź koszty operacyjne, grupuj je do analizy i zarządzaj relacjami z wykonawcami/dostawcami.

Endpointy

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

Lista kosztów i dostawców

Pobiera kolekcję zasobów CostGroup.

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

Utwórz koszt i dostawcę

Tworzy zasób CostGroup.

POST https://api.flowtly.eu/contractors/nip-validation

Utwórz walidację NIP

Tworzy zasób Cost.

GET https://api.flowtly.eu/contractors/search

Lista wyszukiwania

Pobiera kolekcję zasobów Cost.

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

Pobierz koszt i dostawcę po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

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

Usuń koszt i dostawcę

Usuwa zasób.

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

Zaktualizuj koszt i dostawcę

Aktualizuje pola zasobu za pomocą JSON Merge Patch.

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

Lista kosztów i dostawców

Pobiera kolekcję zasobów CostGroup.

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

Utwórz koszt i dostawcę

Tworzy zasób CostGroup.

GET https://api.flowtly.eu/costs/payment-due/{date}

Pobierz koszt i dostawcę po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

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

Pobierz koszt i dostawcę po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

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

Zaktualizuj koszt i dostawcę

Aktualizuje pola zasobu za pomocą JSON Merge Patch.

GET https://api.flowtly.eu/costs/{id}/documents

Pobierz koszt i dostawcę po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

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

Lista kosztów i dostawców

Pobiera kolekcję zasobów CostGroup.

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

Utwórz koszt i dostawcę

Tworzy zasób CostGroup.

POST https://api.flowtly.eu/suppliers/nip-validation

Utwórz walidację NIP

Tworzy zasób Cost.

GET https://api.flowtly.eu/suppliers/search

Lista wyszukiwania

Pobiera kolekcję zasobów Cost.

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

Pobierz koszt i dostawcę po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

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

Usuń koszt i dostawcę

Usuwa zasób.

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

Zaktualizuj koszt i dostawcę

Aktualizuje pola zasobu za pomocą JSON Merge Patch.

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

Lista kosztów i dostawców

Pobiera kolekcję zasobów CostGroup.

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

Utwórz koszt i dostawcę

Tworzy zasób CostGroup.

POST https://api.flowtly.eu/cost-groups/assign-icons-ai

Utwórz przypisanie ikon AI

Przypisz ikony grup kosztów przez AI

GET https://api.flowtly.eu/cost-groups/chart

Lista wykresów

Pobierz wykres grup kosztów

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

Pobierz koszt i dostawcę po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

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

Zaktualizuj koszt i dostawcę

Aktualizuje pola zasobu za pomocą JSON Merge Patch.

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

Pobierz koszt i dostawcę po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

POST https://api.flowtly.eu/cost-groups/{id}/merge

Scal grupy kosztów

Przypadki użycia

Synchronizuj faktury dostawców z rejestrami kosztów w celu śledzenia marży w czasie rzeczywistym.

Importuj stawki wykonawców z zamówień publicznych, aby zautomatyzować kalkulację kosztów projektu.

Pola schematu

Cost-cost.read_cost_group.read

Pole	Typ	Opis
`id`	integer	Pole id.
`costGroup`	object	Pole costGroup.
`ownerEmployee`	string \| null	Pole ownerEmployee.
`tinType`	string	Pole tinType.
`tin`	string \| null	Pole tin.
`tinCountry`	string \| null	Pole tinCountry.
`cyclic`	boolean	Pole cyclic.
`paymentDeadline`	integer \| null	Pole paymentDeadline.
`name`	string	Pole name.
`description`	string \| null	Pole description.
`matchRegex`	string \| null	Pole matchRegex.
`requireAttachment`	boolean \| null	Pole requireAttachment.
`taxAmount`	string \| null	Pole taxAmount.
`notIncludeInChart`	boolean	Pole notIncludeInChart.
`eInvoicingReferenceNumber`	string \| null	Pole eInvoicingReferenceNumber.
`eInvoicingSourceXmlUrl`	string \| null	—
`eInvoicingVisualUrl`	string \| null	—
`createdAt`	string	—
`costGroupIcon`	string \| null	—
`contractorGroup`	object	—

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.

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

Utwórz import

Tworzy zasób Transaction.

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

Lista nieprzypisanych

Pobiera kolekcję zasobów Transaction.

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

Lista z problemami

Pobiera kolekcję zasobów Transaction.

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

Pobierz transakcję po ID

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

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

Usuń transakcję

Usuwa zasób.

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

Zaktualizuj transakcję

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

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

Pobierz transakcję po ID

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

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

Tworzy zasób TransactionAttachment.

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

Pobierz transakcję po ID

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

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

Tworzy zasób TransactionAttachment.

POST https://api.flowtly.eu/transactions/{id}/allocation/preview

Tworzy zasób TransactionAllocationPreviewInput.

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

Lista transakcji

Pobieraj kolekcję transakcji z filtrowaniem przypisań i statusu.

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

Utwórz transakcję

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

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

Utwórz

Tworzy zasób TransactionAttachment.

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

Lista wyszukiwania

Pobiera kolekcję zasobów TransactionAttachment.

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

Pobierz transakcję po ID

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

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

Usuń transakcję

Usuwa zasób.

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

Zaktualizuj transakcję

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

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

Tworzy zasób TransactionAttachment.

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

Tworzy zasób TransactionAttachment.

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

Tworzy zasób TransactionAttachment.

POST https://api.flowtly.eu/transaction-attachments/{id}/mark-manual-paid

Tworzy zasób TransactionAttachment.

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

Pobierz transakcję po ID

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

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

Pobierz transakcję po ID

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

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

Tworzy zasób TransactionAttachment.

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

Utwórz zip

Pobierz załączniki transakcji jako zip

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

Lista mt940

Pobiera zasób TransactionMt940Export.

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

Lista pdf

Pobiera zasób TransactionPdfExport.

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

TransactionAttachment-transaction.read_transaction_attachment.read_cost.read_storage.read

Pole	Typ	Opis
`id`	integer	Pole id.
`cost`	object	Pole cost.
`counterparty`	object	Pole counterparty.
`currency`	string \| null	Pole currency.
`relatedMonth`	string \| null	Pole relatedMonth.
`externalId`	string	Pole externalId.
`employee`	string \| null	Pole employee.
`amount`	integer \| null	Pole amount.
`amountNet`	integer \| null	Pole amountNet.
`name`	string	Pole name.
`description`	string	Pole description.
`note`	string \| null	Pole note.
`receivedAt`	string	Pole receivedAt.
`approvalsCount`	integer	Pole approvalsCount.
`suggestionsCount`	integer	Pole suggestionsCount.
`sourceType`	string	—
`type`	string	—
`paidAt`	string \| null	—
`transaction`	object	—
`invoiceLines`	array	—
`createdAt`	string	—
`counterpartyName`	string \| null	—
`status`	string	—

Przegląd encji

Rachunek bankowy

Zarządzaj zapisami rachunków bankowych używanymi do routingu płatności, uzgadniania i raportowania skarbowego.

Endpointy

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

Lista rachunków bankowych

Pobiera kolekcję zasobów BankAccount.

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

Utwórz rachunek bankowy

Tworzy zasób BankAccount.

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

Pobierz rachunek bankowy po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

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

Aktualizuj rachunek bankowy

Aktualizuj pola zasobu za pomocą JSON Merge Patch.

GET https://api.flowtly.eu/bank-accounts

Lista rachunków bankowych

Pobiera kolekcję zasobów BankAccount.

POST https://api.flowtly.eu/bank-accounts

Utwórz rachunek bankowy

Tworzy zasób BankAccount.

GET https://api.flowtly.eu/bank-accounts/{id}

Pobierz rachunek bankowy po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

PATCH https://api.flowtly.eu/bank-accounts/{id}

Aktualizuj rachunek bankowy

Aktualizuj pola zasobu za pomocą JSON Merge Patch.

Przypadki użycia

Rejestruj nowe rachunki bankowe ze swojego systemu skarbowego w celu dopasowywania płatności.

Synchronizuj salda kont w celu prognozowania przepływów pieniężnych w Flowtly.

Pola schematu

BankAccount-bank_account.read_bank.read

Pole	Typ	Opis
`id`	integer	pole id.
`bank`	object	pole banku.
`type`	string	pole typu.
`default`	boolean	pole domyślne.
`hidden`	boolean	pole ukryte.
`name`	string	pole nazwy.
`number`	string \| null	pole numeru.
`prefix`	string \| null	pole prefiksu.
`currency`	string \| null	pole waluty.
`defaultImportFormat`	string	pole defaultImportFormat.

Przegląd encji

Grupa i reguła podatkowa

Zdefiniuj grupy podatkowe z powiązanymi regułami dla dokładnego obliczania podatków od faktur i transakcji.

Endpointy

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

Lista grup podatkowych i reguł

Pobiera kolekcję zasobów TaxRule.

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

Utwórz grupę i regułę podatkową

Tworzy zasób TaxRule.

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

Pobierz grupę i regułę podatkową po ID

Pobiera pojedynczy zasób na podstawie jego identyfikatora.

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

Zaktualizuj grupę i regułę podatkową

Aktualizuje pola zasobu za pomocą JSON Merge Patch.

GET https://api.flowtly.eu/tax-rules

Lista grup podatkowych i reguł

Pobiera kolekcję zasobów TaxRule.

POST https://api.flowtly.eu/tax-rules

Utwórz grupę i regułę podatkową

Tworzy zasób TaxRule.

GET https://api.flowtly.eu/tax-rules/{id}

Pobierz grupę i regułę podatkową po ID

Pobiera pojedynczy zasób na podstawie jego identyfikatora.

DELETE https://api.flowtly.eu/tax-rules/{id}

Usuń grupę i regułę podatkową

Usuwa zasób.

PATCH https://api.flowtly.eu/tax-rules/{id}

Zaktualizuj grupę i regułę podatkową

Aktualizuje pola zasobu za pomocą JSON Merge Patch.

Przypadki użycia

Importuj tabele stawek VAT z systemu księgowego dla spójnego fakturowania.

Konfiguruj reguły podatkowe specyficzne dla kraju dla rozliczeń w wielu jurysdykcjach.

Pola schematu

TaxGroup-tax_group.read_tax_rule.read

Pole	Typ	Opis
`id`	string	Pole id.
`name`	string	Pole name.
`isDefault`	boolean	Pole isDefault.
`taxRules`	array	Pole taxRules.

Przegląd encji

Waluta

Zapytaj o dostępne waluty używane w fakturach, budżetach i transakcjach.

Endpointy

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

Lista walut

Pobiera kolekcję zasobów Waluta.

GET https://api.flowtly.eu/currencies/{!sourceCurrency}/rates/{!targetCurrency}/{date}

Pobierz walutę według ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

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

Pobierz walutę według ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

Przypadki użycia

Wyszukaj obsługiwane waluty przed tworzeniem faktur wielowalutowych.

Synchronizuj kursy wymiany dla skonsolidowanego raportowania finansowego.

Pola schematu

Currency-currency.read

Pole	Typ	Opis
`id`	string	Pole id.
`name`	string	Pole name.