Polska firma — tworzymy w Polsce 🇵🇱

Umowy i zgodność – 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.

Umowy i zgodność

Zarządzaj umowami, retencją danych i procesami zakupowymi.

Przegląd encji

Umowa

Udostępniaj metadane kontraktów innym systemom, aby budżety, zakupy i HR działały na jednym źródle prawdy.

Endpointy

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

Lista umów

Pobierz kolekcję Hydra z możliwością filtrowania po typie, pracowniku i statusie aktywności.

GET https://api.flowtly.eu/agreements/action-needed

Lista umów wymagających akcji

Pobierz umowy oznaczone brakującymi akceptacjami lub danymi.

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

Utwórz umowę

Prześlij nową umowę z metadanymi o kontrahencie, rozliczeniach i kwotach.

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

Pobierz umowę po ID

Odczytaj pojedynczą umowę, aby sprawdzić status, wartość i powiązanego pracownika.

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

Zaktualizuj umowę

Zmień status, daty lub właściciela umowy.

GET https://api.flowtly.eu/agreements/without-file

Retrieves the collection of Agreement resources.

Retrieves the collection of Agreement resources.

GET https://api.flowtly.eu/agreements/without-file/active

Retrieves the collection of Agreement resources.

Retrieves the collection of Agreement resources.

Przypadki użycia

Synchronizuj podpisane kontrakty klientów z CLM, by prognozy przychodów i kontrole zgodności były zsynchronizowane.
Przesyłaj umowy z dostawcami i limitami wydatków, aby finanse mogły automatycznie pilnować odnowień.

Pola schematu

Agreement-agreement.read
Pole Typ Opis
id integer Wewnętrzny identyfikator umowy w Flowtly.
employee string | null IRI pracownika odpowiedzialnego za umowę.
type string Typ umowy, np. vendor, klient lub zatrudnienie.
variant string Własny podtyp wykorzystywany w automatyzacjach.
amount number Kwota netto/brutto przypisana do umowy.
minutesPerWeek integer Zakładana liczba minut pracy tygodniowo.
jobSize integer Parametr wielkości etatu używany w prognozach.
amountType string Określa, czy kwota jest netto czy brutto.
billingType string Częstotliwość rozliczeń (np. miesięcznie).
positionName string | null Wolny opis stanowiska związany z kontraktem.
position string | null IRI odnoszące się do słownikowego stanowiska.
dateFrom string Data rozpoczęcia obowiązywania umowy.
dateTo string | null Data zakończenia (może być pusta).
currency string Waluta referencyjna dla kwot.
cost string | null IRI powiązanego kosztu.
active boolean Czy umowa jest aktywna w Flowtly.
hoursPerWeek integer Liczba godzin w tygodniu wynikająca z umowy.
status string Status workflow (np. draft, active).

Przykłady

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

Rejestracja umowy z dostawcą

Tworzy umowę subskrypcyjną z dostawcą i wiąże ją z właściwym pracownikiem oraz odniesieniem waluty w Flowtly.

Ładunek żądania 
{
    "employee": "/api/employees/emp_439",
    "type": "vendor",
    "variant": "software",
    "amount": 18500,
    "currency": "/api/currencies/EUR",
    "dateFrom": "2024-07-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "amountType": "netto",
    "billingType": "per-month",
    "positionName": "Implementation partner",
    "hoursPerWeek": 12
}
Ładunek odpowiedzi 
{
    "@id": "/api/agreements/agr_Y29H",
    "@type": "Agreement",
    "id": 5021,
    "employee": "/api/employees/emp_439",
    "type": "vendor",
    "variant": "software",
    "amount": 18500,
    "currency": "/api/currencies/EUR",
    "dateFrom": "2024-07-01T00:00:00+00:00",
    "dateTo": "2024-12-31T00:00:00+00:00",
    "amountType": "netto",
    "billingType": "per-month",
    "positionName": "Implementation partner",
    "hoursPerWeek": 12,
    "active": true,
    "status": "draft"
}

Przegląd encji

Pracownik

Twórz i zarządzaj pracownikami do przydziałów, akceptacji i dostępu.

Endpointy

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

Lista pracowników

Pobierz profile pracowników z paginacją i filtrami.

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

Utwórz pracownika

Dodaj pracownika z imieniem, nazwiskiem, e-mailem i opcjonalnym avatarem.

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

Pobierz pracownika po ID

Odczytaj konkretny profil pracownika.

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

Zaktualizuj pracownika

Zmień dane pracownika, np. imię lub e-mail.

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

Usuń pracownika

Usuń profil pracownika.

GET https://api.flowtly.eu/employees/{id}/working-hours-stats/{date}

Statystyki godzin pracy

Pobierz zagregowane statystyki godzin dla wskazanej daty.

GET https://api.flowtly.eu/employees/me

Retrieves the collection of Employee resources.

Retrieves the collection of Employee resources.

GET https://api.flowtly.eu/employees/preview

Retrieves the collection of Employee resources.

Retrieves the collection of Employee resources.

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

Retrieves the collection of Employee resources.

Retrieves the collection of Employee resources.

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

Retrieves a Employee resource.

Retrieves a Employee resource.

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

Retrieves a Employee resource.

Retrieves a Employee resource.

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

Retrieves a Employee resource.

Retrieves a Employee resource.

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

Removes the Employee resource.

Removes the Employee resource.

POST https://api.flowtly.eu/employees/{id}/user

Creates a Employee resource.

Creates a Employee resource.

Pola schematu

User-user.read
Pole Typ Opis
id integer Wewnętrzny identyfikator pracownika.
email string | null Adres e-mail pracownika.
firstname string Imię pracownika.
lastname string Nazwisko pracownika.
interestedInModules array | null —
avatarUrl string | null URL avatara pracownika.

Przegląd encji

Klient

Utrzymuj spójność CRM i delivery z rekordami klientów, kontaktami i dokumentami w Flowtly.

Endpointy

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

Lista klientów

Pobieraj klientów z paginacją do przeglądu kont i segmentacji.

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

Utwórz klienta

Utwórz rekord klienta z danymi formalnymi i kontaktowymi.

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

Pobierz klienta po ID

Odczytaj profil klienta i powiązane kontakty.

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

Zaktualizuj klienta

Zmień dane klienta po onboardingu lub zmianach na koncie.

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

Retrieves the collection of Client resources.

Retrieves the collection of Client resources.

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

Retrieves a Client resource.

Retrieves a Client resource.

Przypadki użycia

Synchronizuj zakwalifikowane konta CRM do Flowtly przed startem projektu.
Wykorzystuj aktualizacje klientów, by utrzymać spójność faktur, umów i ownerów kont.

Pola schematu

Client-client.read_client_contact.read_storage.read
Pole Typ Opis
id integer —
country string —
currency string —
defaultCost string | null —
status string —
attributeSet string | null —
name string —
dueDays integer —
tinType string —
tinCountry string | null —
tin string | null —
externalPaymentCustomerId string | null —
invoiceComment string | null —
defaultTaxRate string | null —
documentsLanguage string —
addressPhoneNumber string | null —
addressCity string | null —
addressPostCode string | null —
addressStreetLine string | null —
addressBuildingNumber string | null —
addressLocaleNumber string | null —
addressCountry string | null —
clientContacts array —
costGroup array | null —
costGroupIcon string | null —
vatNumber string | null —
Whatsapp