Serwer MCP
Połącz narzędzia AI z Flowtly poprzez Model Context Protocol na mcp.flowtly.eu.
Połącz
claude mcp add --transport http flowtly https://mcp.flowtly.eu/mcp
Na tej stronie
Allocations_get
Narzędzia
| allocations_get | Jedna alokacja po id — rezerwacja jednej osoby na projekcie, wraz z datami i procentem. allocations_list znajduje id; ten endpoint odczytuje pełny rekord. Alokacja bez pracownika to rola OTWARTA (niezaspokojone zapotrzebowanie), a nie rezerwacja. Wymaga modułu resourcing. Tylko do odczytu. |
Allocations_list
Narzędzia
| allocations_list | Listuje alokacje zasobowe — przypisania stanowiska na projekcie do pracownika (lub jeszcze do nikogo, rola otwarta) w danym zakresie dat. Brak filtrów; stronicowanie kursorem. Każdy element zawiera już rozwiązane employeeId/employeeName oraz projectId/projectName (null w employeeId oznacza rolę otwartą); positionId jest surowe — jego nazwę rozwiązuje się przez positions_list. source rozróżnia wiersze zaimportowane z arkusza od utworzonych bezpośrednio w Flowtly. Użyj tego, aby uzgodnić import arkusza zasobowego: odczytaj, co faktycznie trafiło do systemu, i porównaj z tym, co zostało przesłane. |
Bank Accounts_get
Narzędzia
| bankAccounts_get | Pobierz jedno konto bankowe po id — nazwa, waluta, bank oraz format, w jakim importowane są jego wyciągi. |
Bank Accounts_list
Narzędzia
| bankAccounts_list | Listuje konta bankowe organizacji. Filtruj po banku lub ustaw hidden, aby uwzględnić zarchiwizowane. Użyj tego, aby rozwiązać id bankAccount, po którym filtruje transactions_list. |
Clients_get
Narzędzia
| clients_get | Pobierz jednego klienta po id — nazwa, kraj, waluta, identyfikator podatkowy i status. |
Clients_list
Narzędzia
| clients_list | Listuje klientów (klientów organizacji). Filtruj po status lub po externalPaymentCustomerId, aby znaleźć klienta stojącego za id dostawcy płatności. Użyj tego, aby rozwiązać id client, po którym filtrują invoices_list, deals_list, projects_list i contracts_list. |
Config Keys_catalog
Narzędzia
| configKeys_catalog | Listuje każdy klucz konfiguracji organizacji rozpoznawany przez backend, wraz z jego typem i dozwolonymi wartościami. To katalog tego, co jest konfigurowalne — odczytaj go przed configs_get lub configs_update, zamiast zgadywać nazwę klucza. Uprawnienia są egzekwowane przez backend per klucz, więc obecność klucza tutaj nie gwarantuje, że połączony użytkownik może go zapisać. |
Configs_get
Narzędzia
| configs_get | Odczytuje jedną wartość konfiguracji organizacji po id, gdzie id jest kluczem z configKeys_catalog (np. organization-logo-url, organization-icon-url). |
Contracts_get
Narzędzia
| contracts_get | Pobierz jedną umowę po id — strony, kierunek, wartość, warunki cykliczności i daty. |
Contracts_list
Narzędzia
| contracts_list | Listuje umowy. Filtruj po direction (incoming / outgoing), counterparty, project, cyclic, name lub tags. Użyj tego, aby rozwiązać id contract, który odczytuje contracts_paymentScheduleLines i do którego deals_win może powiązać wygraną szansę sprzedaży. |
Contracts_payment Schedule Lines
Narzędzia
| contracts_paymentScheduleLines | Listuje harmonogram płatności umowy — raty, w jakich ma zostać zafakturowana lub opłacona. Przekaż contractId z contracts_list. To plan, a nie dane rzeczywiste: porównaj go z transactions_list, aby zobaczyć, co faktycznie zostało zapłacone. |
Cost Groups_list
Narzędzia
| costGroups_list | Listuje grupy kosztów / centra kosztów — kategorie, pod którymi ewidencjonowane są koszty, dostawcy i faktury przychodzące. Użyj tego, aby rozwiązać id costGroup, wymagane przez suppliers_create i proponowane przez sugestie faktur przychodzących. |
Counterparties_get
Narzędzia
| counterparties_get | Pobierz jednego kontrahenta po id. |
Counterparties_list
Narzędzia
| counterparties_list | Wylistuj kontrahentów — każdą stronę, z którą organizacja zawiera transakcje. Flagi supplier i client określają, jaką rolę(-e) pełni kontrahent, a jeden rekord może pełnić obie naraz. To strona widoczna na transakcji bankowej, więc to właśnie z nią dopasowywane są faktury przychodzące i transakcje. Filtruj po type, supplier, client, cyclic lub budgetNeutral. |
CRM Notes_get
Narzędzia
| crmNotes_get | Pobierz jedną notatkę CRM po id. |
CRM Notes_list
Narzędzia
| crmNotes_list | Wylistuj notatki zapisane na leadach i szansach sprzedaży. Filtruj po lead lub deal, aby odczytać bieżący komentarz do jednego rekordu. |
Deal Lost Reasons_get
Narzędzia
| dealLostReasons_get | Pobierz jeden powód utraty szansy sprzedaży po id. |
Deal Lost Reasons_list
Narzędzia
| dealLostReasons_list | Listuje w kolejności powody, dla których szansa sprzedaży może zostać oznaczona jako przegrana. deals_lose wymaga lostReasonId stąd. |
Deals_get
Narzędzia
| deals_get | Pobierz jedną szansę sprzedaży po id — tytuł, klient, etap, kwota, właściciel, kontakt, spodziewana i faktyczna data zamknięcia. |
Deals_list
Narzędzia
| deals_list | Wylistuj szanse sprzedaży/okazje — pipeline sprzedaży. Filtruj po status (open / won / lost), etapie, właścicielu, kliencie, leadzie lub po zakresach expectedCloseDate / closedAt. Kwoty podane są w jednostkach pomocniczych z jawną walutą; nie zakładaj domyślnej waluty organizacji. |
Deal Stage Histories_get
Narzędzia
| dealStageHistories_get | Pobierz jeden rekord zmiany etapu szansy sprzedaży po id. |
Deal Stage Histories_list
Narzędzia
| dealStageHistories_list | Listuje przejścia etapów szansy sprzedaży, od najnowszych. Filtruj po deal. Każde deals_update, które zmienia etap, jest tu automatycznie logowane, więc w ten sposób odtwarzasz, ile czasu szansa spędziła na każdym etapie — sama szansa przechowuje tylko etap bieżący. |
Holiday Requests_list
Narzędzia
| holidayRequests_list | WNIOSKI urlopowe i ich status — oczekujący, zatwierdzony, odrzucony. Odróżnij od holidays_list, które przedstawia zarezerwowany urlop: wniosek oczekujący na decyzję nie jest jeszcze nieobecnością, więc planuj na podstawie holidays_list, a tego endpointu użyj, aby zobaczyć, co czeka na czyjąś decyzję. Dostarcza holidayRequestId przyjmowane przez holidays_approve i holidays_bulkApprove. Tylko do odczytu. |
Holidays_active
Narzędzia
| holidays_active | Kto jest nieobecny WŁAŚNIE TERAZ — każdy aktualnie trwający urlop, w całej organizacji, dla wszystkich. To narzędzie do pytania „kto jest dziś nieobecny” i to, które warto sprawdzić krzyżowo, zanim freePercent z resourcingBench_get zostanie potraktowane jako dostępność, ponieważ bench nie odejmuje urlopów. W przeciwieństwie do holidays_list nie stosuje żadnego zawężenia do projektu i nie wymaga uprawnień poza zalogowaniem, więc jego odpowiedź obejmuje całą organizację. Zwraca każdą nieobecność wraz z typem i datami. Tylko do odczytu. |
Holidays_get
Narzędzia
| holidays_get | Jeden rekord urlopu po id, z typem, datami i czasem trwania. Pobierz id z holidays_list lub holidays_active. Tylko do odczytu. |
Holidays_list
Narzędzia
| holidays_list | Zarezerwowany urlop w danym okresie — widok planistyczny, podczas gdy holidays_active odpowiada wyłącznie na pytanie o dziś. Filtruj po employee, zakresie dat lub project. TO, CO WIDZISZ, ZALEŻY OD TWOICH UPRAWNIEŃ, a krótka lista nie jest dowodem, że nikt nie jest nieobecny: menedżer urlopów lub przeglądający dział księgowości widzi całą organizację, natomiast lider projektu lub przeglądający MUSI przekazać filtr project (lub zapytać o siebie) i bez niego zostaje wprost odrzucony — ta odmowa to granica uprawnień, a nie pusty kalendarz. Tylko do odczytu. |
Incoming Invoices_get
Narzędzia
| incomingInvoices_get | Pobierz jedną fakturę przychodzącą (od dostawcy) lub dokument uzupełniający po id, wraz z polami odczytanymi przez OCR i aktualnym stanem dopasowania. |
Incoming Invoices_list
Narzędzia
| incomingInvoices_list | Listuje faktury przychodzące (od dostawców) i dokumenty towarzyszące — skrzynkę księgowości. Faktura przychodząca JEST dokumentem dołączonym do transakcji bankowej, więc exists.transaction=false to sposób na znalezienie dokumentów jeszcze niedopasowanych do płatności. Filtruj też po status, relatedMonth, counterparty, project, tags lub hasDetectedProblems. Każdy dokument ma odcisk palca jako externalId 'upload_sha256:<sha256 bajtów>' — zahaszuj plik i sprawdź tu ten externalId PRZED incomingInvoices_create, inaczej zarejestrujesz duplikat. |
Incoming Invoices_match Candidates
Narzędzia
| incomingInvoices_matchCandidates | Wylistuj transakcje bankowe, które mogą być płatnością za tę fakturę przychodzącą, uszeregowane przez wbudowany matcher backendu. Sięgnij po to, gdy dokument nie ma dołączonej transakcji i musisz ją wybrać; wybieraj spośród tych kandydatów zamiast zgadywać samodzielnie na podstawie kwot. |
Incoming Invoices_suggestions
Narzędzia
| incomingInvoices_suggestions | Odczytuje własne propozycje Flowtly dla faktury przychodzącej — dopasowanie dostawcy, grupę kosztów, pasującą transakcję bankową, ostrzeżenie o duplikacie. To dokładnie te same propozycje, które widzi człowiek w aplikacji. Odczytaj je najpierw, a następnie zastosuj jedną po id za pomocą incomingInvoices_applySuggestion, albo przyjmij wszystkie za pomocą acceptAllSuggestions. Przekaż refresh, aby przeliczyć na nowo zamiast zwrócić buforowany zestaw. |
Incoming Invoices_suggestions Debug
Narzędzia
| incomingInvoices_suggestionsDebug | Wyjaśnia, DLACZEGO sugestie dla faktury przychodzącej wyszły takie, jakie wyszły — punktację mechanizmu dopasowującego, do diagnozowania brakującej lub błędnej sugestii. Wyłącznie do diagnostyki; do normalnej pracy używaj incomingInvoices_suggestions. |
Invoices_get
Narzędzia
| invoices_get | Pobierz jedną fakturę wychodzącą (sprzedażową) po id — klient, pozycje, sumy, daty sprzedaży i wystawienia, status. |
Invoices_list
Narzędzia
| invoices_list | Listuje faktury wychodzące (sprzedażowe). Filtruj po client, tags, search lub zakresie saleDate. Zauważ, że saleDate — a nie data wystawienia ani data utworzenia — to pole, po którym filtruje invoices_export, więc użyj tego samego pola tutaj przy uzgadnianiu eksportu. |
Lead Activities_get
Narzędzia
| leadActivities_get | Pobiera jedną aktywność leada (kontakt w ramach outreachu) po id. |
Lead Activities_list
Narzędzia
| leadActivities_list | Listuje kontakty outreachowe leada — oś czasu jego aktywności (wysłane zaproszenie, odpowiedzi, rozmowy, follow-upy). Filtruj po lead, aby odczytać historię jednego potencjalnego klienta. To ustrukturyzowany odpowiednik crmNotes_list: aktywności to typowany, datowany dziennik kontaktów; notatki to swobodny komentarz. |
Lead Contacts_get
Narzędzia
| leadContacts_get | Pobierz jeden kontakt leada po id. |
Lead Contacts_list
Narzędzia
| leadContacts_list | Wylistuj osoby kontaktowe przypisane do leadów. Filtruj po lead, aby odczytać kontakty jednego potencjalnego klienta, lub po email, aby znaleźć, z którego leada pochodzi wiadomość. |
Lead List Memberships_get
Narzędzia
| leadListMemberships_get | Pobierz jedną przynależność leada do listy po id. |
Lead List Memberships_list
Narzędzia
| leadListMemberships_list | Wylistuj, które leady znajdują się na których listach prospectingu wychodzącego, wraz ze statusem kontaktu każdego z nich (contacted / replied / bounced). Filtruj po list, lead lub status — w ten sposób odczytasz stan kampanii. |
Lead Lists_get
Narzędzia
| leadLists_get | Pobierz jedną listę prospectingu wychodzącego po id. |
Lead Lists_list
Narzędzia
| leadLists_list | Listuje listy prospectingu wychodzącego. Użyj tego, aby rozwiązać id list przyjmowane przez leadListMemberships_create. |
Lead Lost Reasons_get
Narzędzia
| leadLostReasons_get | Pobierz jeden powód utraty leada po id. |
Lead Lost Reasons_list
Narzędzia
| leadLostReasons_list | Wylistuj powody, dla których lead może zostać oznaczony jako utracony, w kolejności. |
Leads_dedupe Check
Narzędzia
| leads_dedupeCheck | Sprawdza, czy potencjalny klient jest już w CRM, używając tych samych filtrów co leads_list (companyName, source, owner, …). Wywołaj to PRZED leads_create: zduplikowany lead rozdziela historię kontaktów między dwa rekordy, a nic dalej w procesie nie scali ich za ciebie. |
Leads_get
Narzędzia
| leads_get | Pobierz jednego leada po id — firma, strona internetowa, źródło, status, właściciel i klient, w którego się przekształcił, jeśli dotyczy. |
Leads_list
Narzędzia
| leads_list | Listuje leady — cele prospectingowe przed kwalifikacją. Filtruj po status, source, owner, client, companyName lub zakresach createdAt/closedAt. Zakwalifikowany lead staje się klientem (Client) plus otwartą szansą sprzedaży (Deal) poprzez leads_convert; do tego czasu istnieje tylko tutaj, nie w clients_list. |
Lead Stages_get
Narzędzia
| leadStages_get | Pobierz jeden etap leada po id. |
Lead Stages_list
Narzędzia
| leadStages_list | Listuje w kolejności etapy, przez które przechodzi lead. Leady mają własny zestaw etapów — szanse sprzedaży (deals) korzystają ze stages_list, co jest czymś innym. |
Organizations_get
Narzędzia
| organizations_get | Pobiera organizację po id. UWAGA — to NIE mówi, z którą organizacją jesteś połączony. Połączenie OAuth jest przypięte do dokładnie jednej organizacji (powiązanej z tokenem), ale ten endpoint zwraca dowolną organizację, której członkiem jest połączony UŻYTKOWNIK, więc udany odczyt tutaj wygląda jak potwierdzenie, że pracujesz w tej organizacji, choć może tak nie być. Aby zweryfikować, na jakim tenancie faktycznie pracujesz, odczytaj dane zawężone do tenanta — people_list lub clients_list — i nigdy nie rozpoczynaj masowego zapisu na podstawie samego tego wywołania. |
People_get
Narzędzia
| people_get | Pobierz jeden rekord osoby/pracownika po id — imiona i nazwiska, e-maile, telefon, przełożony oraz informacja, czy jest aktywny. |
People_list
Narzędzia
| people_list | Wylistuj osoby/pracowników. Filtruj po isActive, reportsTo (id przełożonego), projectMembers.project lub search; stronicuj za pomocą cursor. Osoby i pracownicy współdzielą to samo id, więc w ten sposób ustalisz id pracownika, którego oczekują narzędzia do czasu pracy, odpowiedzialności, członkostwa w projekcie i uprawnień. |
Permission Groups_get
Narzędzia
| permissionGroups_get | Pobierz jedną grupę uprawnień po id, wraz z ciągami ROLE_*, które nadaje. |
Permission Groups_list
Narzędzia
| permissionGroups_list | Listuje grupy uprawnień organizacji oraz role, jakie każda z nich nadaje — np. grupa „Business Owner” nadaje ROLE_ADMIN. Odczytaj to przed people_setPermissionGroups: role w odpowiedzi są autorytatywnym źródłem tego, co grupa faktycznie zezwala, więc nigdy nie musisz zgadywać na podstawie jej nazwy. |
Pipelines_get
Narzędzia
| pipelines_get | Pobierz jeden pipeline sprzedaży po id. |
Pipelines_list
Narzędzia
| pipelines_list | Listuje lejki sprzedażowe (pipelines). Pipeline posiada uporządkowany zestaw etapów — odczytaj je za pomocą stages_list filtrowanego po pipeline. |
Positions_list
Narzędzia
| positions_list | Listuje stanowiska — nazwane role (np. „Backend Engineer”), które wypełnia alokacja projektowa. Brak filtrów; Position ma wyłączone stronicowanie, więc ten endpoint zawsze zwraca w jednym wywołaniu pełny katalog ról organizacji. Każdy element to {id, name, roles}. Użyj tego, aby rozwiązać nazwę stanowiska stojącą za positionId wiersza z allocations_list, oraz aby znaleźć id stanowiska, do którego musi dopasować się import zasobowy. |
Projects_get
Narzędzia
| projects_get | Pobierz jeden projekt po id — nazwa, typ, klient, daty, opis i cena. |
Projects_list
Narzędzia
| projects_list | Wylistuj projekty. Filtruj po type (fixed-price | time-and-material | non-billable | internal), client.name, employee, name lub zakresach dateFrom/dateTo. Użyj tego, aby ustalić id projektu, którego wymagają zadania, rejestrowanie czasu pracy, budżety i umowy. |
Resource Request Candidates_get
Narzędzia
| resourceRequestCandidates_get | Jeden kandydat rekrutacyjny po id. Id pochodzi z resourceRequestCandidates_list. Wymaga ROLE_HR_MANAGER. Tylko do odczytu. |
Resource Request Candidates_list
Narzędzia
| resourceRequestCandidates_list | Kandydaci zgłoszeni na zapotrzebowania rekrutacyjne — osoby w lejku rekrutacyjnym, a nie pracownicy dostępni do alokacji. Filtruj po id zapotrzebowania z resourceRequests_list. Wymaga ROLE_HR_MANAGER. Tylko do odczytu. |
Resource Requests_get
Narzędzia
| resourceRequests_get | Jedno zapotrzebowanie rekrutacyjne po id, ze stanowiskiem i statusem. Pobierz id z resourceRequests_list. Dotyczy HR/rekrutacji, a nie alokacji zasobowej. Wymaga ROLE_HR_MANAGER. Tylko do odczytu. |
Resource Requests_list
Narzędzia
| resourceRequests_list | Otwarte zapotrzebowania rekrutacyjne — prośba o rekrutację na stanowisko, w domenie HR. Mimo nazwy NIE jest to zapotrzebowanie na alokację zasobową: to rekrutacja. Zwraca kolekcję; resourceRequests_get odczytuje jedno, a resourceRequestCandidates_list podaje osoby zgłoszone na nie. Wymaga ROLE_HR_MANAGER. Tylko do odczytu. |
Resourcing Requests_list
Narzędzia
| resourcingRequests_list | Otwarte zapotrzebowania zasobowe — ktoś prosi o alokację osoby do projektu, czyli strona popytowa resourcingu. To przepływ renderowany przez widok Requests w interfejsie Resourcing. NIE myl tego z resourceRequests_list: to jest REKRUTACJA HR (zatrudnienie na stanowisko). Zestaw to z resourcingRequestsHistory_list, aby zobaczyć, co już zdecydowano, oraz z resourcingBench_get, aby zobaczyć, kto mógłby zaspokoić zapotrzebowanie. Wymaga modułu resourcing i ROLE_RESOURCING_MANAGER. Tylko do odczytu. |
Resourcing Requests History_list
Narzędzia
| resourcingRequestsHistory_list | Co już stało się z zapotrzebowaniami zasobowymi — ślad decyzji (potwierdzone, odrzucone, zmienione) stojący za otwartymi zapotrzebowaniami z resourcingRequests_list. Sięgnij po to, aby odpowiedzieć na pytanie „czy o to już proszono i odrzucono?”, zanim ponownie zaproponujesz tę samą alokację. Wymaga modułu resourcing i ROLE_RESOURCING_MANAGER. Tylko do odczytu. |
Responsibilities_get
Narzędzia
| responsibilities_get | Pobierz jedną odpowiedzialność po id. |
Responsibilities_list
Narzędzia
| responsibilities_list | Wylistuj odpowiedzialności w ramach grupy RACI. Filtruj po responsibilityGroup. Odpowiedzialności mogą się zagnieżdżać poprzez parent; osoby są do nich przypisywane przez responsibilityEmployees, a nie bezpośrednio. |
Responsibility Employees_get
Narzędzia
| responsibilityEmployees_get | Pobierz jedno przypisanie odpowiedzialności po id. |
Responsibility Employees_list
Narzędzia
| responsibilityEmployees_list | Wylistuj, kto jest przypisany do jakiej odpowiedzialności i w jakim procencie. Filtruj po employee, aby odczytać całe obciążenie RACI jednej osoby we wszystkich grupach. |
Responsibility Groups_get
Narzędzia
| responsibilityGroups_get | Pobierz jedną grupę odpowiedzialności po id. |
Responsibility Groups_list
Narzędzia
| responsibilityGroups_list | Wylistuj grupy odpowiedzialności / obszary RACI — pozycje najwyższego poziomu „Odpowiedzialności”, każda z osobą odpowiedzialną (accountable). Pojedyncze odpowiedzialności znajdują się pod nimi. |
Schedule Employees_get
Narzędzia
| scheduleEmployees_get | Jedno przypisanie harmonogramu do pracownika po id. Id pochodzi z scheduleEmployees_list. Wymaga ROLE_SCHEDULES_MANAGER. Tylko do odczytu. |
Schedule Employees_list
Narzędzia
| scheduleEmployees_list | Którzy pracownicy są przypisani do których harmonogramów czasu pracy. Użyj tego, aby przejść od harmonogramu (schedules_list) do jego osób, lub aby znaleźć harmonogram, którego przestrzega dany pracownik. Wymaga ROLE_SCHEDULES_MANAGER. Tylko do odczytu. |
Schedule Plan_list
Narzędzia
| schedulePlan_list | Harmonogramy obowiązujące w JEDNYM podanym dniu — przekaż datę w ścieżce. Sięgnij po to, aby odpowiedzieć na pytanie „kto pracuje dziś / w tym dniu” bez odczytywania każdego harmonogramu i samodzielnego rozwiązywania jego zakresów. W przeciwieństwie do innych odczytów harmonogramów wymaga to tylko ROLE_USER, więc jest to endpoint dostępny dla zwykłego pracownika. Tylko do odczytu. |
Schedule Ranges_get
Narzędzia
| scheduleRanges_get | Jeden zakres czasowy harmonogramu po id. Id pochodzi z scheduleRanges_list. Wymaga ROLE_SCHEDULES_MANAGER. Tylko do odczytu. |
Schedule Ranges_list
Narzędzia
| scheduleRanges_list | Zakresy czasowe składające się na harmonogramy czasu pracy — rzeczywiste godziny, jakie obejmuje harmonogram. Najpierw odczytaj rekord nadrzędny za pomocą schedules_get; ten endpoint rozwija jego zakresy. Wymaga ROLE_SCHEDULES_MANAGER. Tylko do odczytu. |
Schedules_get
Narzędzia
| schedules_get | Jeden harmonogram czasu pracy po id, z jego zakresami i przypisanymi pracownikami. Id pochodzi z schedules_list; scheduleRanges_list i scheduleEmployees_list odczytują jego części. Wymaga ROLE_SCHEDULES_MANAGER. Tylko do odczytu. |
Schedules_list
Narzędzia
| schedules_list | Harmonogramy czasu pracy — wzorce zmian/pracy definiowane przez organizację, a NIE alokacja projektowa. Użyj resourcingSchedule_get, aby sprawdzić, kto na czym jest zarezerwowany; tego endpointu użyj dla samych wzorców pracy. schedules_get odczytuje jeden po id. Wymaga ROLE_SCHEDULES_MANAGER. Tylko do odczytu. |
Stages_get
Narzędzia
| stages_get | Pobierz jeden etap szansy sprzedaży po id. |
Stages_list
Narzędzia
| stages_list | Listuje w kolejności etapy szans sprzedaży. Filtruj po pipeline. deals_create wymaga id etapu stąd, a przenoszenie szansy sprzedaży między etapami jest tym, co rejestruje dealStageHistories. |
Suppliers_list
Narzędzia
| suppliers_list | Wylistuj dostawców/kontrahentów — obsługiwane z /contractors, więc „supplier” i „contractor” to ten sam rekord. Filtruj po cyclic dla dostawców cyklicznych. Użyj tego, aby ustalić dostawcę, wobec którego zarejestrowany jest koszt, umowa lub faktura przychodząca. |
Tag Definitions_list
Narzędzia
| tagDefinitions_list | Listuje definicje tagów — tagi, które można dołączyć do rekordów, każdy w ramach grupy tagów. tags_create przyjmuje stąd id tagDefinition oraz rekord, do którego ma zostać dołączony. |
Tag Groups_list
Narzędzia
| tagGroups_list | Wylistuj grupy tagów — kontenery porządkujące definicje tagów. |
Task Comments_list
Narzędzia
| taskComments_list | Wylistuj komentarze do zadań projektowych, od najstarszych. Filtruj po task, aby odczytać dyskusję jednego zadania. |
Task Lists_list
Narzędzia
| taskLists_list | Listuje listy zadań — kolumny/sekcje tablicy, do których trafiają zadania. Filtruj po project. tasks_create przyjmuje stąd id listy. |
Tasks_get
Narzędzia
| tasks_get | Pobierz jedno zadanie projektowe po id — tytuł, projekt, status, lista, przypisane osoby, daty i powtarzalność. |
Tasks_list
Narzędzia
| tasks_list | Listuje zadania projektowe. Filtruj po project, list, status, assignees, isTemplate lub zakresach startAt/dueAt. Zadania cykliczne udostępniają recurrenceParent i recurrenceRule, więc wygenerowane wystąpienie można prześledzić do reguły, która je utworzyła. Aby ustalić, czy zadanie jest ZAKOŃCZONE, porównaj jego status z taskStatuses_list (isClosed), zamiast dopasowywać po nazwie statusu. |
Task Statuses_list
Narzędzia
| taskStatuses_list | Wylistuj statusy zadań projektowych, w kolejności na tablicy. isClosed oznacza stany zakończone, a isDefault status nadawany nowemu zadaniu. Przeczytaj to przed interpretacją statusu zadania — nazwy są konfigurowalne przez organizację, więc „Done” nie jest ciągiem, na którym można polegać przy dopasowywaniu. |
Tax Groups_list
Narzędzia
| taxGroups_list | Listuje grupy podatkowe. Użyj tego, aby rozwiązać id taxGroup, po którym filtruje taxRules_list i który niosą wiersze faktury. |
Tax Rules_list
Narzędzia
| taxRules_list | Wylistuj reguły podatkowe — stawki i okresy, których dotyczą. Filtruj po taxGroup. |
Transactions_list
Narzędzia
| transactions_list | Wylistuj transakcje bankowe — strumień bankowy, z którym dopasowywane są faktury przychodzące. Filtruj po bankAccount, counterpartyRole, cost, ignored, hasDetectedProblems, zakresie orderDate/execDate lub amount.between. Zwróć uwagę, że orderDate i execDate to różne pola: płatność może zostać zlecona w jednym miesiącu, a zrealizowana w kolejnym. |
Transactions_suggestions
Narzędzia
| transactions_suggestions | Odczytuje propozycje Flowtly dla jednej transakcji bankowej — do jakiego kontrahenta, grupy kosztów lub dokumentu powinna zostać przypisana. Lustrzane odbicie incomingInvoices_suggestions, od strony pieniędzy. |
Work Times_get
Narzędzia
| workTimes_get | Pobierz jeden wpis czasu pracy po id — data, minuty, projekt, notatki oraz pracownik, do którego należy. |
Work Times_list
Narzędzia
| workTimes_list | Wylistuj wpisy czasu pracy (zarejestrowanych godzin). Filtruj po zakresie dat (date.after / date.before, YYYY-MM-DD) oraz opcjonalnie po employee lub project; stronicuj za pomocą cursor. Każdy wiersz niesie employeeId/employeeName oraz projectId/projectName, więc w ten sposób eksportujesz wszystkie zarejestrowane godziny za dany okres. WAŻNE: wyniki obejmujące całą organizację wymagają ROLE_WORKING_HOURS_VIEWER. Bez tej roli backend NIE zwraca błędu — po cichu zwraca tylko wpisy połączonego użytkownika, więc eksport „godzin wszystkich” może wrócić z zawartością jednej osoby i wyglądać zupełnie poprawnie. Jeśli każdy wiersz należy do jednego pracownika, a nie filtrowałeś po employee, odpowiedź niesie scopeWarning informujący o tym — pokaż to użytkownikowi, zamiast prezentować wynik jako obejmujący całą organizację. |
Work Times_log
Narzędzia
| workTimes_log | Zarejestruj wpis czasu pracy dla połączonego użytkownika Flowtly (date, durationMinutes, project, notes). Zapis. |
Tasks_create
Narzędzia
| tasks_create | Utwórz zadanie projektowe (wymagane title + project; opcjonalnie status, list, assignees, dueAt, priority). Zapis. |
Tasks_update
Narzędzia
| tasks_update | Zaktualizuj zadanie projektowe po id — zmień status (w tym oznaczenie jako zakończone), assignees, dueAt, title itd. Zapis. |
Task Comments_create
Narzędzia
| taskComments_create | Dodaj komentarz do zadania projektowego (id zadania + content). Zapis. |
Suppliers_create
Narzędzia
| suppliers_create | Utwórz nowy rekord dostawcy/kontrahenta (wymagane name, tinType, costGroup). Zapis. |
Suppliers_update
Narzędzia
| suppliers_update | Zaktualizuj dane dostawcy/kontrahenta (name, identyfikator podatkowy, warunki płatności itd.) po id. Zapis. |
People_create
Narzędzia
| people_create | Utwórz rekord osoby/pracownika (wymagane firstname + lastname; opcjonalnie companyEmail, contactEmail, contactPhone). Zapis. |
People_update
Narzędzia
| people_update | Zaktualizuj rekord osoby/pracownika po id (name, companyEmail, contactEmail, contactPhone itd.). Zapis. |
People_delete
Narzędzia
| people_delete | Usuń rekord pracownika/osoby po id (np. aby usunąć zastępczego/testowego pracownika). Wymaga ROLE_EMPLOYEES_MANAGER; backend uruchamia procesor usuwania, który odłącza też powiązane rekordy. Wysoki wpływ, nieodwracalne. Zapis. |
Cost Groups_create
Narzędzia
| costGroups_create | Utwórz grupę kosztową / centrum kosztów (wymagane name + type). Zapis. |
Cost Groups_update
Narzędzia
| costGroups_update | Zaktualizuj nazwę lub typ grupy kosztowej / centrum kosztów po id. Zapis. |
Tag Groups_create
Narzędzia
| tagGroups_create | Utwórz grupę tagów (wymagane name), aby porządkować powiązane definicje tagów. Zapis. |
Tag Definitions_create
Narzędzia
| tagDefinitions_create | Utwórz definicję tagu (wymagane name, level, tagGroup) w ramach grupy tagów. Zapis. |
Clients_create
Narzędzia
| clients_create | Utwórz nowy rekord klienta (wymagane name, country, currency, status, tinType). Zapis. |
Clients_update
Narzędzia
| clients_update | Zaktualizuj rekord klienta po id. Zapis. |
Client Contacts_create
Narzędzia
| clientContacts_create | Utwórz osobę kontaktową dla klienta (wymagane client, type, name, email). Zapis. |
Bank Accounts_create
Narzędzia
| bankAccounts_create | Utwórz konto bankowe (wymagane type, name, currency, defaultImportFormat). Zapis. |
Bank Accounts_update
Narzędzia
| bankAccounts_update | Zaktualizuj konto bankowe po id. Zapis. |
Counterparty Bank Accounts_create
Narzędzia
| counterpartyBankAccounts_create | Dołącz konto bankowe do kontrahenta (counterparty + accountNumber). Zapis. |
Contracts_create
Narzędzia
| contracts_create | Utwórz umowę. Zapis. |
Contracts_update
Narzędzia
| contracts_update | Zaktualizuj umowę po id. Zapis. |
Contracts_delete
Narzędzia
| contracts_delete | Usuń umowę po id. Zapis. |
Tax Groups_create
Narzędzia
| taxGroups_create | Utwórz grupę podatkową (wymagane name + type). Zapis. |
Tax Groups_update
Narzędzia
| taxGroups_update | Zaktualizuj nazwę lub typ grupy podatkowej po id. Zapis. |
Tax Rules_create
Narzędzia
| taxRules_create | Utwórz regułę podatkową. Zapis. |
Tax Rules_update
Narzędzia
| taxRules_update | Zaktualizuj regułę podatkową po id. Zapis. |
Configs_update
Narzędzia
| configs_update | Zaktualizuj wartość konfiguracji organizacji po id (wymagane type + name; uprawnienia są egzekwowane przez backend dla każdego klucza konfiguracji osobno). Zapis. |
Permission Groups_create
Narzędzia
| permissionGroups_create | Utwórz grupę uprawnień (wymagane name; roles = lista ciągów ROLE_*, które nadaje). Zapis. |
Permission Groups_update
Narzędzia
| permissionGroups_update | Zaktualizuj nazwę, opis lub nadawane role grupy uprawnień po id. Zapis. |
People_set Permission Groups
Narzędzia
| people_setPermissionGroups | Ustawia (zastępuje) grupy uprawnień osoby po numerycznych id grup (zobacz permissionGroups_list — np. grupa „Business Owner” nadaje ROLE_ADMIN). Nadaje dostęp; NIE tworzy loginu ani nie wysyła e-maila do osoby. Zapis. |
Projects_create
Narzędzia
| projects_create | Utwórz projekt (wymagane name + type; type = fixed-price|time-and-material|non-billable|internal; opcjonalnie dateFrom/dateTo, client, publicDescription, notes, priceNet). Zapis. |
Projects_update
Narzędzia
| projects_update | Zaktualizuj projekt po id (name, type, daty, opis itd.). Zapis. |
Responsibility Groups_create
Narzędzia
| responsibilityGroups_create | Tworzy grupę odpowiedzialności / obszar RACI (wymagane name; opcjonalne description i responsibleEmployee = osoba odpowiedzialna, podana jako zwykłe id pracownika, np. 6 (z people_list), lub IRI /people/6). To pozycja najwyższego poziomu 'Odpowiedzialności'. Dodawaj pod nią poszczególne odpowiedzialności za pomocą responsibilities_create. Zapis. |
Responsibility Groups_update
Narzędzia
| responsibilityGroups_update | Zaktualizuj grupę odpowiedzialności po id (name, description, responsibleEmployee = id pracownika lub IRI). Zapis. |
Responsibilities_create
Narzędzia
| responsibilities_create | Tworzy odpowiedzialność wewnątrz grupy (responsibilityGroup = id grupy lub IRI, + name, wymagane; opcjonalne description; opcjonalne parent = IRI innej odpowiedzialności do zagnieżdżenia). Przypisuj do niej osoby za pomocą responsibilityEmployees_create. Zapis. |
Responsibilities_update
Narzędzia
| responsibilities_update | Zaktualizuj odpowiedzialność po id (name, description, parent, responsibilityGroup = id grupy lub IRI). Zapis. |
Responsibility Employees_create
Narzędzia
| responsibilityEmployees_create | Przypisz pracownika do odpowiedzialności (wymagane responsibility = id odpowiedzialności lub IRI, employee = id pracownika lub IRI, percentage 0-100; opcjonalnie targets i description). Zapis. |
Responsibility Employees_update
Narzędzia
| responsibilityEmployees_update | Zaktualizuj przypisanie odpowiedzialności po id (percentage, targets, description). Zapis. |
Responsibility Employees_delete
Narzędzia
| responsibilityEmployees_delete | Usuń przypisanie pracownika do odpowiedzialności po id. Zapis. |
Leads_create
Narzędzia
| leads_create | Utwórz leada (cel prospectingu wychodzącego/przychodzącego; opcjonalnie companyName, source, status, owner, powiązany client). Zapis. |
Leads_update
Narzędzia
| leads_update | Zaktualizuj leada po id (company, website, source, status, owner, powiązany client). Zapis. |
Leads_delete
Narzędzia
| leads_delete | Usuń leada po id (miękkie usunięcie). Zapis. |
Leads_convert
Narzędzia
| leads_convert | Przekształć zakwalifikowanego leada w klienta + jeden kontakt na każdy kontakt leada + otwartą szansę sprzedaży. Wymaga istniejącego klienta (klienta leada lub clientId w treści żądania). Zapis. |
Lead Activities_create
Narzędzia
| leadActivities_create | Rejestruje JEDEN kontakt outreachowy na leadzie — wysłane zaproszenie, zaakceptowane zaproszenie, wiadomość, odpowiedź, rozmowę, follow-up (wymagane lead + type + occurredAt; opcjonalne channel, contact, body). TO jest właściwe miejsce dla historii kontaktów potencjalnego klienta: crmNote to swobodny komentarz, activity to ustrukturyzowany, filtrowalny dziennik kontaktów renderowany przez oś czasu kolejki prospectingu. NIE opisuj kontaktów w notatce. type: invite_sent | invite_accepted | message_sent | reply_received | call | meeting | follow_up | …; channel: linkedin | email | phone | …. Zapis. |
Lead Activities_update
Narzędzia
| leadActivities_update | Aktualizuje zarejestrowaną aktywność outreachową po id (type, channel, occurredAt, body). Zapis. |
Lead Activities_delete
Narzędzia
| leadActivities_delete | Usuwa zarejestrowaną aktywność outreachową po id. Zapis. |
Lead Contacts_create
Narzędzia
| leadContacts_create | Dodaje osobę kontaktową do leada (wymagane lead + name; opcjonalne email, phone, role, linkedinUrl, isPrimary). Adres URL LinkedIn kontaktu należy umieścić w linkedinUrl, a NIE w crmNote. Zapis. |
Lead Contacts_update
Narzędzia
| leadContacts_update | Aktualizuje kontakt leada po id — np. ustaw linkedinUrl / email / phone, gdy je znajdziesz. Zapis. |
Lead Contacts_delete
Narzędzia
| leadContacts_delete | Usuń kontakt leada po id. Zapis. |
Deals_create
Narzędzia
| deals_create | Utwórz szansę sprzedaży/okazję (wymagane title, client, stage; opcjonalnie amountMinor, currency, expectedCloseDate, owner, contact). Zapis. |
Deals_update
Narzędzia
| deals_update | Zaktualizuj szansę sprzedaży po id (title, stage, kwota, data zamknięcia, owner, contact). Zmiana etapu jest rejestrowana automatycznie. Zapis. |
Deals_delete
Narzędzia
| deals_delete | Usuń szansę sprzedaży po id (miękkie usunięcie). Zapis. |
Deals_win
Narzędzia
| deals_win | Oznacz szansę sprzedaży jako wygraną — przenosi ją na etap wygranej i oznacza jako zamkniętą; opcjonalne contractId łączy z istniejącą umową. Zapis. |
Deals_lose
Narzędzia
| deals_lose | Oznacza szansę sprzedaży jako przegraną — wymaga lostReasonId (z dealLostReasons_list); opcjonalne lostReasonNote. Zapis. |
Deals_reopen
Narzędzia
| deals_reopen | Otwórz ponownie wygraną/utraconą szansę sprzedaży. Zapis. |
Lead Lists_create
Narzędzia
| leadLists_create | Utwórz listę prospectingu wychodzącego (wymagane name). Zapis. |
Lead Lists_update
Narzędzia
| leadLists_update | Zaktualizuj listę wychodzącą po id. Zapis. |
Lead Lists_delete
Narzędzia
| leadLists_delete | Usuń listę wychodzącą po id. Zapis. |
Lead List Memberships_create
Narzędzia
| leadListMemberships_create | Dodaj leada do listy wychodzącej (wymagane list + lead; opcjonalnie status). Zapis. |
Lead List Memberships_update
Narzędzia
| leadListMemberships_update | Zaktualizuj przynależność leada do listy — np. ustaw status kontaktu (contacted/replied/bounced). Zapis. |
Lead List Memberships_delete
Narzędzia
| leadListMemberships_delete | Usuń leada z listy wychodzącej. Zapis. |
CRM Notes_create
Narzędzia
| crmNotes_create | Dodaj notatkę do leada lub szansy sprzedaży (body + dokładnie jedno z lead/deal). Autorem jest połączony użytkownik. Zapis. |
CRM Notes_update
Narzędzia
| crmNotes_update | Zaktualizuj treść notatki CRM po id. Zapis. |
CRM Notes_delete
Narzędzia
| crmNotes_delete | Usuń notatkę CRM po id. Zapis. |
Organization Logo_upload
Narzędzia
| organizationLogo_upload | Przesyła/zastępuje logo organizacji (obraz base64 + contentType + filename). Odczytaj bieżące przez configs_get organization-logo-url. Zapis. |
Organization Icon_upload
Narzędzia
| organizationIcon_upload | Przesyła/zastępuje ikonę/favicon organizacji (obraz base64 + contentType + filename). Odczytaj bieżącą przez configs_get organization-icon-url. Zapis. |
Incoming Invoices_create
Narzędzia
| incomingInvoices_create | Rejestruje fakturę przychodzącą (od dostawcy) lub dokument towarzyszący w księgowości — przekaż bajty jako base64 wraz z fileName i receivedAt. Flowtly wykonuje na nim OCR i sugeruje dostawcę oraz pasującą transakcję bankową. Plik ma odcisk palca jako externalId 'upload_sha256:<sha256 bajtów>': aby uniknąć duplikatu, zahaszuj bajty i sprawdź incomingInvoices_list pod kątem tego externalId PRZED przesłaniem. Zapis. |
Invoices_export
Narzędzia
| invoices_export | Uruchamia eksport zip WYSTAWIONYCH faktur za okres (from/to, oba w formacie YYYY-MM-DD, włącznie), filtrowany po DACIE SPRZEDAŻY — nie dacie wystawienia ani utworzenia. Uwzględniane są tylko faktury WYSTAWIONE; wersje robocze i niewysłane faktury są wykluczone, ale korekty SĄ uwzględniane. Opcjonalne client ogranicza do jednego klienta (id lub IRI z clients_list). Maksymalnie 200 faktur na eksport — jeśli okres zawiera więcej, zawęź go (np. eksportuj po jednym miesiącu); okres z 0 wystawionymi fakturami również jest odrzucany. To wywołanie tylko dodaje zadanie do kolejki (renderowanie miesiąca może zająć minuty) — NIE zwraca linku do pobrania. Odpytuj invoices_exportStatus zwróconym exportId, aż zgłosi "ready". Zapis. |
Invoices_export Status
Narzędzia
| invoices_exportStatus | Odpytuje status eksportu zip uruchomionego przez invoices_export, po exportId. Gdy status to "ready", odpowiedź zawiera downloadUrl (krótkotrwały podpisany link — wygasa po 1 godzinie, zobacz expiresAt), filename i byteSize; bajty pliku nigdy nie są zwracane przez to narzędzie. Jeśli status to "failed", failureReason wyjaśnia dlaczego. |
Invoices_import
Narzędzia
| invoices_import | Rejestruje w organizacji JUŻ WYSTAWIONĄ fakturę wychodzącą (sprzedażową) — do wprowadzenia historii faktur podczas onboardingu. Przekazany zewnętrzny numer faktury jest zachowywany dosłownie, nabywca jest rozwiązywany po numerze podatkowym (tworzony, jeśli nie istnieje), a faktura trafia do systemu jako wystawiona BEZ renderowania PDF, wysyłania e-maila do klienta ani zgłaszania do KSeF. Import numeru, który już istnieje, jest operacją bezskutkową, która zgłasza istniejącą fakturę, więc masowy import jest bezpieczny do ponownego uruchomienia — ale ta gwarancja dotyczy tylko wywołań sekwencyjnych; dwa faktycznie równoczesne importy tego samego numeru mogą oba się powieść. Przekaż expectedGrossTotal (kwotę brutto wydrukowaną na dokumencie źródłowym), a import zostanie odrzucony, jeśli nie zgadza się z sumą obliczoną z wierszy. buyer.tin jest wymagane — nabywca nigdy nie jest dopasowywany po nazwie. Do wystawienia nowej, prawdziwej faktury użyj invoices_create, nie tego endpointu. Zapis. |
Invoice Transactions_create
Narzędzia
| invoiceTransactions_create | Rejestruje płatność dla faktury wychodzącej (sprzedażowej). `invoice` to IRI faktury z invoices_list; `date` to data, w której płatność jest traktowana jako dokonana. `transaction` jest opcjonalne — pomiń je, aby zarejestrować rozliczenie bez linii bankowej, co jest właściwe dla historycznych faktur, których wyciąg bankowy nigdy nie został zaimportowany. `amount` jest opcjonalne i domyślnie przyjmuje pozostałą do zapłaty kwotę faktury. Zarejestrowanie płatności to sposób na to, aby wystawiona, przeterminowana faktura przestała być traktowana jako niezapłacona, a więc również na to, aby przestały być dla niej kolejkowane przypomnienia o płatności. Nic nie zapobiega zarejestrowaniu dwóch płatności dla jednej faktury, więc jeśli nie masz pewności, czy jest już rozliczona, najpierw odczytaj invoices_get. Zapis. |
Invoice Transactions_update
Narzędzia
| invoiceTransactions_update | Aktualizuje istniejący rekord płatności faktury po id (z invoiceTransactions w invoices_get lub przez stronicowanie invoiceTransactions). Najczęstsze użycie: wskazanie płatności zarejestrowanej bez linii bankowej na transakcję właśnie zaimportowaną przez transactions_importStatement, poprzez ustawienie `transaction` na IRI/id transakcji z transactions_list. PUŁAPKA: to PATCH, ale backend nadal wymaga `invoice` i `date` przy każdym wywołaniu — NIE scala za ciebie istniejących wartości. Najpierw odczytaj rekord (lub miej go już z wywołania create) i wyślij ponownie niezmienione `invoice` i `date` obok tego, co faktycznie chcesz zmienić, inaczej aktualizacja zostanie odrzucona. `transaction` akceptuje null, aby odłączyć płatność od linii bankowej. `amount` jest opcjonalne. Zapis. |
Incoming Invoices_apply Suggestion
Narzędzia
| incomingInvoices_applySuggestion | Przyjmuje jedną z własnych sugestii Flowtly dla faktury przychodzącej — te same propozycje, które widzi człowiek w aplikacji (dopasowanie dostawcy, grupa kosztów, pasująca transakcja bankowa, ostrzeżenie o duplikacie). Najpierw odczytaj je za pomocą incomingInvoices_suggestions, a następnie zastosuj jedną po jej id. Preferuj to zamiast zgadywania: to mechanizm dopasowujący Flowtly, a nie agent, decyduje, co jest wiarygodne. Zapis. |
Incoming Invoices_accept All Suggestions
Narzędzia
| incomingInvoices_acceptAllSuggestions | Zaakceptuj wszystkie oczekujące sugestie dla faktury przychodzącej jednym wywołaniem — to, co robi człowiek przyciskiem „accept all” w aplikacji. Serwer stosuje, przebudowuje i ponownie stosuje sugestie, aż nic nowego się nie pojawi: dopasowanie transakcji NIE istnieje, dopóki nie zostaną zastosowane dostawca i kwota, więc pojedynczy przebieg zostawiłby dokument bez powiązania. Zwraca raport (co zostało zastosowane, co zostało odrzucone i dlaczego oraz transakcję, do której dokument ostatecznie trafił). Przekaż dryRun, aby zobaczyć podgląd bez zapisu. Nigdy nie akceptuje supplier_create ani ostrzeżenia o duplikacie. Zapis. |
Incoming Invoices_check EInvoices
Narzędzia
| incomingInvoices_checkEInvoices | Pobiera do organizacji nowe e-faktury z KSeF — to samo, co robi przycisk „Sprawdź e-faktury” w aplikacji. Wywołaj to, zanim uznasz, że brakuje faktury od dostawcy: bez tego nie da się odróżnić „dostawca nigdy jej nie wysłał” od „nasza synchronizacja jeszcze się nie odbyła”. Zwraca odpowiedź, gdy pobieranie zostanie skolejkowane; odczytaj potem incomingInvoices_list, aby zobaczyć, co dotarło. Zapis. |
Resourcing_import Timeline
Narzędzia
| resourcing_importTimeline | Importuje arkusz osi czasu alokacji zasobowych (pobierz go przez Drive MCP, przekaż jego CSV dosłownie). To PEŁNE ZASTĄPIENIE wierszy Allocation organizacji dla `year`: wiersze z arkusza są tworzone/aktualizowane, a każdy istniejący wiersz dla tego roku, nieobecny w arkuszu, zostaje USUNIĘTY — to nie scalenie. DOMYŚLNIE PRÓBA NA SUCHO: pominięte dryRun podglądowo nic nie zapisuje; przekaż dryRun:false, aby zastosować zmiany. Raport podaje `created` / `replaced` oraz `unmatchedPeople` / `unmatchedProjects`. DWIE RZECZY ŁATWO PRZEOCZYĆ: wiersz arkusza, którego projekt się nie rozwiązuje, jest POMIJANY, a wywołanie mimo to zgłasza sukces, więc pozytywny wynik może ukrywać częściowy import; a kod roli, którego katalog stanowisk jeszcze nie zawiera, jest TWORZONY jako nowe stanowisko zamiast odrzucony — zobacz `createdPositions`. Oba przypadki są sygnalizowane w `warnings`, gdy wystąpią; przekaż to użytkownikowi zamiast zgłaszać tylko `created`. Arkusz, który parsuje się do zera wierszy, jest odrzucany (wygląda dokładnie jak błędny odczyt, który za chwilę wyczyściłby całą oś czasu), chyba że przekażesz force:true. Odczytaj potem allocations_list, aby zobaczyć, co trafiło do systemu. Wysoki wpływ. Zapis. |
Transactions_import Statement
Narzędzia
| transactions_importStatement | Importuje plik wyciągu bankowego (np. plik MT940 .sta) — przekaż surową treść tekstową każdego pliku dosłownie (NIE base64) wraz z nazwą pliku. NIE MA PARAMETRU bankAccount: backend kieruje plik, usuwając wszystkie znaki niebędące cyframi z numerów twoich kont bankowych oraz z bajtów pliku, i importuje do każdego konta, którego cyfry pojawiają się gdziekolwiek w pliku — więc jeden plik może trafić na kilka kont, a wyciąg dla konta, które nie jest skonfigurowane w Flowtly (lub którego numer jest zapisany inaczej, niż zapisuje go bank), nie importuje się na żadne z nich, kończąc się błędem, który dokładnie wyjaśnia dlaczego — odczytaj tę wiadomość, to jedyna diagnostyka, jaką daje ten endpoint. Przy sukcesie odpowiedź to `{ imported, matching }`: `matching: "in_progress"` oznacza, że dopasowywanie kontrahenta/załącznika dla nowych wierszy nadal trwa po zwróceniu odpowiedzi przez to wywołanie, więc natychmiastowe transactions_list może pokazywać wiersze jeszcze niedopasowane — odczytaj ponownie nieco później, aby uzyskać stan końcowy. Ponowny import tego samego wyciągu nie tworzy duplikatów wierszy; importer rozpoznaje transakcje, które już widział. Gdy wyciąg jest już w systemie, wskaż istniejącą płatność bez linii bankowej na jeden z jego wierszy za pomocą… |
Organization_whoami
Narzędzia
| organization_whoami | Zwraca organizację, do której jest przypięte to połączenie MCP — { orgId, name, slug, userId }. Wywołaj to, aby potwierdzić, do KTÓREGO tenanta zamierzasz zapisywać, przed jakimkolwiek create/update: połączenie jest przypięte do dokładnie jednej organizacji przez token, a zapisanie prospektów/rekordów do niewłaściwej organizacji to prawdziwy incydent. Tylko do odczytu. |
Resourcing Actuals_get
Narzędzia
| resourcingActuals_get | Raportowane godziny w porównaniu z planem, per osoba i tydzień, w oknie from/to — odpowiada na pytanie „czy zespół faktycznie realizuje plan?”, na które NIE odpowiada żadne inne narzędzie zasobowe: alokacje mówią, co było ZAPLANOWANE, to narzędzie mówi, co zostało ZREALIZOWANE. Zwraca kolumny tygodni oraz jeden wiersz na osobę (planned %, reported %, wariancję, sumy i podział per projekt). reportedPercent równe null oznacza „brak umowy w tym tygodniu”, a 0 oznacza „umowa istniała, ale nic nie zaraportowano” — NIE utożsamiaj tych dwóch przypadków. Przekaż financials, aby uzyskać przychód/koszt/marżę, które w przeciwnym razie są pomijane. Wymaga modułu resourcing i ROLE_RESOURCING_MANAGER. Tylko do odczytu. |
Resourcing Bench_get
Narzędzia
| resourcingBench_get | Kto NIE jest obsadzony w oknie from/to — bench. Sięgnij po to, gdy pada pytanie, kogo przydzielić do nowego projektu lub gdzie moc przerobowa jest niewykorzystana; resourcingActuals_get mówi, jak obciążone są osoby, to narzędzie mówi, kto nie ma żadnego obciążenia. NIE WIE NIC O URLOPACH: freePercent to 100 minus potwierdzone alokacje, nic więcej, więc ktoś na trzytygodniowym zatwierdzonym urlopie pojawia się jako 100% wolny i żadne pole w odpowiedzi nie mówi inaczej. Odpowiadanie na pytanie „kto jest dostępny” wyłącznie na tej podstawie doprowadzi do przydzielenia do projektów osób, które są nieobecne — sprawdź krzyżowo holidays_active lub holidays_list. Wymaga modułu resourcing. Tylko do odczytu. |
Resourcing Schedule_get
Narzędzia
| resourcingSchedule_get | Planowany harmonogram zasobowy w oknie from/to — oś czasu alokacji taka, jaką pokazuje planista. Użyj go, aby zobaczyć, co jest ZAREZERWOWANE na przyszłość; użyj resourcingActuals_get, aby zobaczyć, co faktycznie zaraportowano wobec tego planu. Wymaga modułu resourcing i ROLE_RESOURCING_MANAGER. Tylko do odczytu. |
Leads_bulk Import
Narzędzia
| leads_bulkImport | Importuje wiele leadów w JEDNYM wywołaniu, każdy z zagnieżdżonymi kontaktami, przynależnością do listy i aktywnościami outreachowymi — serwer tworzy leada, a następnie przekazuje jego id do elementów podrzędnych, więc nigdy nie żonglujesz pośrednimi IRI. Idempotentne względem kluczy naturalnych (companyName / email / (list,lead) / (type,occurredAt,contact)): bezpieczne do ponownego uruchomienia i dzielenia na porcje (≤100 leadów/wywołanie). To ścieżka masowa, z jakiej powinien korzystać import kampanii zamiast N wywołań leads_create. Zapis. |