Polska firma — tworzymy w Polsce 🇵🇱

Fakturowanie & płatności – 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.

Fakturowanie & płatności

Cykl życia faktury, pozycje, transakcje, e-fakturowanie i metody płatności.

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

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

Utwórz wysyłkę

Tworzy zasób faktury.

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/draft

Lista wersji roboczych

Pobiera kolekcję zasobów Invoice.

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

Pobierz fakturę po ID

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

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

Utwórz wysyłkę

Tworzy zasób faktury.

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

Pobierz fakturę po ID

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

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

Usuń fakturę

Usuwa zasób.

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/{id}/send

Pobierz fakturę po ID

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

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

Tworzy zasób faktury.

Tworzy zasób faktury.

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 Pole ID.
name string Pole nazwy.
type string Pole typu.
parent object Pole nadrzędne.
childrenInvoices array Pole faktur podrzędnych.
client string Pole klienta.
tinType string Pole typu NIP.
tinCountry string | null Pole kraju NIP.
tin string | null Pole NIP.
bankAccount string Pole konta bankowego.
amountNet number Pole kwoty netto.
amount number Pole kwoty.
currency string | null Pole waluty.
conversionRate number | null Pole kursu wymiany.
generatedPdfExternalId string | null Pole zewnętrznego identyfikatora wygenerowanego pliku PDF.
issueDate string —
saleDate string —
dueDate string —
targetAmount number | null —
paymentMethod string —
paidInAdvance boolean —
notes string | null —
correctionReason string | null —
invoiceRows array —
eInvoicing object —
invoiceTransactions array —
internalComment string —
targetAmountNet number | null —
status string —

Przegląd encji

Wiersz faktury

Zarządzaj pozycjami faktury z ilością, ceną jednostkową, podatkiem i opisem dla szczegółowej kontroli rozliczeń.

Endpointy

GET https://api.flowtly.eu/invoice-rows

Lista pozycji faktur

Pobiera kolekcję zasobów pozycji faktury.

POST https://api.flowtly.eu/invoice-rows

Utwórz pozycję faktury

Tworzy zasób pozycji faktury.

GET https://api.flowtly.eu/invoice-rows/{id}

Pobierz pozycję faktury po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

PATCH https://api.flowtly.eu/invoice-rows/{id}

Aktualizuj pozycję faktury

Aktualizuje pola zasobu za pomocą JSON Merge Patch.

Przypadki użycia

Automatyczne generowanie wierszy faktur z zatwierdzonych arkuszy czasu pracy.
Wysyłanie poprawek pozycji wierszy z systemu księgowego.

Pola schematu

InvoiceRow-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Pole Typ Opis
id integer Pole ID.
classificationNumber string | null Pole numeru klasyfikacyjnego.
unit string | null Pole jednostki.
quantity number Pole ilości.
vatRate string Pole vatRate.
netPrice string Pole ceny netto.
netDiscountAmount string Pole kwoty rabatu netto.
productName string Pole nazwy produktu.
project string | null Pole projektu.
parentInvoiceRow object Pole nadrzędnej pozycji faktury.
invoiceChildrenRows array Pole podrzędnych pozycji faktury.

Przegląd encji

Transakcja faktury

Śledź, które transakcje bankowe regulują które faktury, w celu automatycznego uzgadniania.

Endpointy

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

Lista transakcji faktur

Pobiera kolekcję zasobów InvoiceTransaction.

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

Utwórz transakcję faktury

Tworzy zasób InvoiceTransaction.

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

Pobierz transakcję faktury po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

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

Usuń transakcję faktury

Usuń zasób.

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

Zaktualizuj transakcję faktury

Aktualizuj pola zasobów za pomocą JSON Merge Patch.

Przypadki użycia

Dopasuj przychodzące płatności do otwartych faktur z Twojego feedu bankowego.
Uzgadniaj częściowe płatności i nadpłaty w zestawach faktur.

Pola schematu

InvoiceTransaction-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Pole Typ Opis
id integer Pole id.
invoice object Pole invoice.
transaction object Pole transaction.
amount number | null Pole amount.
date string Pole date.

Przegląd encji

E-fakturowanie (KSeF)

Wysyłaj, odbieraj i wyszukuj e-faktury za pośrednictwem platformy rządowej KSeF w celu zapewnienia zgodności podatkowej.

Endpointy

GET https://api.flowtly.eu/e-invoicing/invoices/inbound/download/xml

Lista xml

Pobiera kolekcję zasobów InvoiceDownload.

GET https://api.flowtly.eu/e-invoicing/invoices/inbound/{id}/download/upo

Pobierz e-fakturowanie (KSeF) według ID

Pobiera pojedynczy zasób po jego identyfikatorze.

GET https://api.flowtly.eu/e-invoicing/invoices/inbound/{id}/download/xml

Pobierz e-fakturowanie (KSeF) według ID

Pobiera pojedynczy zasób po jego identyfikatorze.

POST https://api.flowtly.eu/e-invoicing/invoices/inbound/queue

Utwórz kolejkę

Tworzy zasób InboundInvoiceQueue.

POST https://api.flowtly.eu/e-invoicing/invoices/inbound/sync

Utwórz synchronizację

Tworzy zasób InboundInvoiceSync.

POST https://api.flowtly.eu/e-invoicing/invoices/{id}/correction

Tworzy zasób InvoiceCorrectionSend.

Tworzy zasób InvoiceCorrectionSend.

GET https://api.flowtly.eu/e-invoicing/invoices/download/xml

Lista xml

Pobiera kolekcję zasobów InvoiceDownload.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/pdf

Pobierz e-fakturowanie (KSeF) według ID

Pobiera pojedynczy zasób po jego identyfikatorze.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/preview/pdf

Pobierz e-fakturowanie (KSeF) według ID

Pobiera pojedynczy zasób po jego identyfikatorze.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/upo

Pobierz e-fakturowanie (KSeF) według ID

Pobiera pojedynczy zasób po jego identyfikatorze.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/xml

Pobierz e-fakturowanie (KSeF) według ID

Pobiera pojedynczy zasób po jego identyfikatorze.

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

Tworzy zasób InvoiceSend.

Tworzy zasób InvoiceSend.

POST https://api.flowtly.eu/e-invoicing/ksef/session

Utwórz sesję

Tworzy zasób KsefSession.

Przypadki użycia

Automatyczne przesyłanie faktur sprzedaży do KSeF i przechowywanie oficjalnego UPO.
Pobieraj przychodzące faktury zakupu z KSeF do swojego obiegu pracy AP.

Pola schematu

InvoiceEInvoicing.jsonld-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Pole Typ Opis
@context object —
@id string —
@type string —
id integer —
provider string —
status string —
referenceNumber string | null —
documentId string | null —
acquisitionTimestamp string | null —
upoUrl string | null —
verificationLink string | null —
rejectionReason string | null —
providerPayload array | null —
einvoicingNumber string | null —

Przegląd encji

Metoda płatności

Konfiguruj metody płatności (przelew bankowy, karta itp.) i śledź transakcje płatnicze.

Endpointy

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

Lista metod płatności

Pobiera kolekcję zasobów PaymentMethod.

GET https://api.flowtly.eu/payment-methods

Lista metod płatności

Pobiera kolekcję zasobów PaymentMethod.

POST https://api.flowtly.eu/payment-methods/create-setup-intent

Utwórz zamiar konfiguracji

Tworzy zasób PaymentMethod.

GET https://api.flowtly.eu/payment-methods/{id}

Pobierz metodę płatności po ID

Pobiera pojedynczy zasób za pomocą jego identyfikatora.

DELETE https://api.flowtly.eu/payment-methods/{id}

Usuń metodę płatności

Usuwa zasób.

PATCH https://api.flowtly.eu/payment-methods/{id}

Zaktualizuj metodę płatności

Aktualizuje pola zasobu za pomocą JSON Merge Patch.

Przypadki użycia

Ustaw domyślne warunki płatności dla każdego klienta do generowania faktur.
Zapytanie o historię płatności dla wyciągów z konta klienta.

Pola schematu

PaymentMethod-payment_method.read
Pole Typ Opis
id string pole id.
type string pole typu.
ccBrand string pole ccBrand.
ccLastDigits string pole ccLastDigits.
ccExpMonth integer pole ccExpMonth.
ccExpYear integer pole ccExpYear.
externalId string pole externalId.
Whatsapp