MCP Server
Verbinde AI-Tools mit Flowtly über das Model Context Protocol unter mcp.flowtly.eu.
Verbinden
claude mcp add --transport http flowtly https://mcp.flowtly.eu/mcp
Auf dieser Seite
Allocations_get
Tools
| allocations_get | Eine Zuweisung nach id — die Buchung einer Person auf einem Projekt, mit ihren Daten und ihrem Prozentsatz. allocations_list findet die id; dieses Tool liest den vollständigen Datensatz. Eine Zuweisung ohne Mitarbeiter ist eine OFFENE Rolle (ungedeckter Bedarf), keine Buchung. Erfordert das Resourcing-Modul. Nur lesend. |
Allocations_list
Tools
| allocations_list | Listet Resourcing-Zuweisungen — datumsbezogene Zuordnungen einer Position auf einem Projekt zu einem Mitarbeiter (oder noch zu niemandem, eine offene Rolle). Keine Filter; Paginierung per Cursor. Jedes Element enthält employeeId/employeeName und projectId/projectName bereits aufgelöst (null bei employeeId bedeutet eine offene Rolle); positionId ist unaufgelöst — den Namen über positions_list ermitteln. source unterscheidet aus einem Sheet importierte Zeilen von solchen, die direkt in Flowtly erstellt wurden. Damit lässt sich ein Resourcing-Sheet-Import abgleichen: auslesen, was tatsächlich angekommen ist, und mit dem Übermittelten vergleichen. |
Bank Accounts_get
Tools
| bankAccounts_get | Ruft ein Bankkonto anhand der id ab — Name, Währung, Bank und das Format, in dem seine Kontoauszüge importiert werden. |
Bank Accounts_list
Tools
| bankAccounts_list | Listet die Bankkonten der Organisation. Filterung nach Bank, oder hidden setzen, um archivierte Konten einzuschließen. Damit lässt sich die bankAccount-id ermitteln, nach der transactions_list filtert. |
Clients_get
Tools
| clients_get | Ruft einen Kunden anhand der id ab — Name, Land, Währung, Steuernummer und Status. |
Clients_list
Tools
| clients_list | Listet Kunden (die Kunden der Organisation). Filterung nach status, oder nach externalPaymentCustomerId, um den Kunden hinter einer Zahlungsanbieter-id zu finden. Damit lässt sich die client-id ermitteln, nach der invoices_list, deals_list, projects_list und contracts_list filtern. |
Config Keys_catalog
Tools
| configKeys_catalog | Listet jeden vom Backend erkannten Konfigurationsschlüssel der Organisation, mit Typ und zulässigen Werten. Dies ist der Katalog dessen, was konfigurierbar ist — vor configs_get oder configs_update lesen, statt einen Schlüsselnamen zu erraten. Berechtigungen werden vom Backend pro Schlüssel durchgesetzt, ein hier erscheinender Schlüssel garantiert also nicht, dass der verbundene Benutzer ihn schreiben darf. |
Configs_get
Tools
| configs_get | Liest einen Konfigurationswert der Organisation nach id, wobei die id ein Schlüssel aus configKeys_catalog ist (z. B. organization-logo-url, organization-icon-url). |
Contracts_get
Tools
| contracts_get | Ruft einen Vertrag anhand der id ab — Parteien, Richtung, Wert, wiederkehrende Konditionen und Daten. |
Contracts_list
Tools
| contracts_list | Listet Verträge. Filterung nach direction (incoming / outgoing), Vertragspartner, Projekt, cyclic, Name oder Tags. Damit lässt sich die contract-id ermitteln, die contracts_paymentScheduleLines liest und mit der deals_win einen gewonnenen Deal verknüpfen kann. |
Contracts_payment Schedule Lines
Tools
| contracts_paymentScheduleLines | Listet den Zahlungsplan eines Vertrags — die Raten, in denen voraussichtlich fakturiert oder gezahlt wird. contractId aus contracts_list übergeben. Dies ist der Plan, nicht die Ist-Daten: mit transactions_list abgleichen, um zu sehen, was tatsächlich gezahlt wurde. |
Cost Groups_list
Tools
| costGroups_list | Listet Kostengruppen / Kostenstellen — die Kategorien, unter denen Kosten, Lieferanten und Eingangsrechnungen abgelegt werden. Damit lässt sich die costGroup-id ermitteln, die suppliers_create benötigt und die von Eingangsrechnungs-Vorschlägen vorgeschlagen wird. |
Counterparties_get
Tools
| counterparties_get | Ruft einen Geschäftspartner anhand der id ab. |
Counterparties_list
Tools
| counterparties_list | Listet Geschäftspartner auf — jede Partei, mit der die Organisation Geschäfte macht. Die Flags supplier und client geben an, welche Rolle(n) ein Geschäftspartner einnimmt; ein Datensatz kann beides sein. Dies ist die Partei auf einer Banktransaktion, gegen die Eingangsrechnungen und Transaktionen abgeglichen werden. Filtern Sie nach type, supplier, client, cyclic oder budgetNeutral. |
CRM Notes_get
Tools
| crmNotes_get | Ruft eine CRM-Notiz anhand der id ab. |
CRM Notes_list
Tools
| crmNotes_list | Listet Notizen zu Leads und Deals auf. Filtern Sie nach lead oder deal, um den laufenden Kommentarverlauf zu einem Datensatz zu lesen. |
Deal Lost Reasons_get
Tools
| dealLostReasons_get | Ruft einen Deal-Verlustgrund anhand der id ab. |
Deal Lost Reasons_list
Tools
| dealLostReasons_list | Listet die Gründe, aus denen ein Deal als verloren markiert werden kann, in Reihenfolge. deals_lose benötigt eine lostReasonId von hier. |
Deals_get
Tools
| deals_get | Ruft einen Deal anhand der id ab — Titel, Kunde, Phase, Betrag, Eigentümer, Kontakt, voraussichtliches und tatsächliches Abschlussdatum. |
Deals_list
Tools
| deals_list | Listet Deals/Opportunities auf — die Vertriebspipeline. Filtern Sie nach status (offen / gewonnen / verloren), stage, owner, client, lead oder nach expectedCloseDate-/closedAt-Zeiträumen. Beträge sind in Kleinsteinheiten mit expliziter Währung angegeben; verlassen Sie sich nicht auf die Standardwährung der Organisation. |
Deal Stage Histories_get
Tools
| dealStageHistories_get | Ruft einen Deal-Phasenwechsel-Datensatz anhand der id ab. |
Deal Stage Histories_list
Tools
| dealStageHistories_list | Listet die Phasenübergänge eines Deals, neueste zuerst. Filterung nach Deal. Jedes deals_update, das die Phase ändert, wird hier automatisch protokolliert — so lässt sich rekonstruieren, wie lange ein Deal in jeder Phase verbracht hat; der Deal selbst führt nur seine aktuelle Phase. |
Holiday Requests_list
Tools
| holidayRequests_list | Urlaubs-ANTRÄGE und ihr Status — ausstehend, genehmigt, abgelehnt. Zu unterscheiden von holidays_list, das gebuchten Urlaub abbildet: Ein noch nicht entschiedener Antrag ist noch keine Abwesenheit, daher für die Planung holidays_list verwenden und dieses Tool, um zu sehen, was noch auf eine Entscheidung wartet. Liefert die holidayRequestId, die holidays_approve und holidays_bulkApprove benötigen. Nur lesend. |
Holidays_active
Tools
| holidays_active | Wer ist GERADE JETZT abwesend — jeder aktuell laufende Urlaub, organisationsweit, für alle. Dies ist das Tool für 'Wer ist heute nicht da', und dasjenige, mit dem gegengeprüft werden sollte, bevor freePercent aus resourcingBench_get als Verfügbarkeit interpretiert wird, denn der Pool zieht Urlaub nicht ab. Anders als holidays_list wendet es keine Projekteinschränkung an und erfordert keine Berechtigung über das Angemeldetsein hinaus, seine Antwort deckt also die gesamte Organisation ab. Gibt jede Abwesenheit mit Typ und Daten zurück. Nur lesend. |
Holidays_get
Tools
| holidays_get | Ein Urlaubsdatensatz nach id, mit Typ, Daten und Dauer. Die id aus holidays_list oder holidays_active beziehen. Nur lesend. |
Holidays_list
Tools
| holidays_list | Gebuchter Urlaub über einen Zeitraum — die Planungsansicht, während holidays_active nur über heute Auskunft gibt. Filterung nach Mitarbeiter, Datumsbereich oder Projekt. WAS SIE SEHEN, HÄNGT VON IHREN BERECHTIGUNGEN AB, und eine kurze Liste ist kein Beweis dafür, dass niemand abwesend ist: Ein Urlaubs-Manager oder Buchhaltungs-Betrachter erhält die gesamte Organisation, während eine Projektleitung oder ein Betrachter EINEN Projektfilter übergeben MUSS (oder nach sich selbst fragen) und ohne diesen rundweg abgewiesen wird — diese Ablehnung ist eine Berechtigungsgrenze, kein leerer Kalender. Nur lesend. |
Incoming Invoices_get
Tools
| incomingInvoices_get | Ruft eine Eingangsrechnung (Lieferant) oder einen Beleg anhand der id ab, mit den per OCR erfassten Feldern und dem aktuellen Abgleichsstatus. |
Incoming Invoices_list
Tools
| incomingInvoices_list | Listet Eingangsrechnungen (Lieferanten) und Belegdokumente — der Buchhaltungs-Posteingang. Eine Eingangsrechnung IST ein an eine Banktransaktion angehängtes Dokument, daher findet man mit exists.transaction=false Dokumente, die noch keiner Zahlung zugeordnet sind. Filterung außerdem nach status, relatedMonth, Vertragspartner, Projekt, Tags oder hasDetectedProblems. Jedes Dokument ist als externalId 'upload_sha256:<sha256 der Bytes>' fingerprintet — eine Datei hashen und VOR incomingInvoices_create hier nach dieser externalId suchen, sonst wird ein Duplikat abgelegt. |
Incoming Invoices_match Candidates
Tools
| incomingInvoices_matchCandidates | Listet die Banktransaktionen auf, die die Zahlung für diese Eingangsrechnung sein könnten, bewertet vom backend-eigenen Matcher. Nutzen Sie dies, wenn einem Dokument keine Transaktion zugeordnet ist und Sie eine auswählen müssen; bevorzugen Sie diese Kandidaten, statt selbst anhand von Beträgen zu raten. |
Incoming Invoices_suggestions
Tools
| incomingInvoices_suggestions | Liest Flowtlys eigene Vorschläge für eine Eingangsrechnung — Lieferantenabgleich, Kostengruppe, passende Banktransaktion, Duplikatswarnung. Dies sind genau die Vorschläge, die ein Mensch in der App sieht. Zuerst lesen, dann einen davon per id mit incomingInvoices_applySuggestion anwenden, oder alle mit acceptAllSuggestions übernehmen. refresh übergeben, um neu zu berechnen, statt die zwischengespeicherte Menge zu liefern. |
Incoming Invoices_suggestions Debug
Tools
| incomingInvoices_suggestionsDebug | Erklärt, WARUM die Vorschläge einer Eingangsrechnung so ausgefallen sind, wie sie sind — die Bewertung des Matchers, zur Diagnose eines fehlenden oder falschen Vorschlags. Nur zu Diagnosezwecken; für die normale Arbeit incomingInvoices_suggestions verwenden. |
Invoices_get
Tools
| invoices_get | Ruft eine Ausgangsrechnung (Verkauf) anhand der id ab — Kunde, Positionen, Summen, Verkaufs- und Ausstellungsdatum, Status. |
Invoices_list
Tools
| invoices_list | Listet Ausgangsrechnungen (Verkauf). Filterung nach Kunde, Tags, Suche oder einem saleDate-Bereich. Zu beachten: saleDate — nicht das Ausstellungsdatum und nicht das Erstellungsdatum — ist das Feld, nach dem invoices_export filtert; beim Abgleich eines Exports hier dasselbe Feld verwenden. |
Lead Activities_get
Tools
| leadActivities_get | Ruft eine Lead-Aktivität (Kontaktaufnahme) nach id ab. |
Lead Activities_list
Tools
| leadActivities_list | Listet die Kontaktaufnahmen eines Leads — dessen Aktivitätsverlauf (Einladung gesendet, Antworten, Anrufe, Follow-ups). Filterung nach Lead, um die Historie eines Interessenten zu lesen. Dies ist das strukturierte Gegenstück zu crmNotes_list: Aktivitäten sind das typisierte, datierte Kontaktprotokoll; Notizen sind freier Kommentartext. |
Lead Contacts_get
Tools
| leadContacts_get | Ruft einen Lead-Kontakt anhand der id ab. |
Lead Contacts_list
Tools
| leadContacts_list | Listet die Kontaktpersonen auf, die Leads zugeordnet sind. Filtern Sie nach lead, um die Kontakte eines Interessenten zu lesen, oder nach email, um herauszufinden, von welchem Lead eine Nachricht stammt. |
Lead List Memberships_get
Tools
| leadListMemberships_get | Ruft eine Lead-Listen-Mitgliedschaft anhand der id ab. |
Lead List Memberships_list
Tools
| leadListMemberships_list | Listet auf, welche Leads auf welchen Outbound-Prospecting-Listen stehen, samt jeweiligem Kontaktstatus (contacted / replied / bounced). Filtern Sie nach list, lead oder status — so lesen Sie den Stand einer Kampagne ab. |
Lead Lists_get
Tools
| leadLists_get | Ruft eine Outbound-Prospecting-Liste anhand der id ab. |
Lead Lists_list
Tools
| leadLists_list | Listet Outbound-Prospecting-Listen. Damit lässt sich die list-id ermitteln, die leadListMemberships_create benötigt. |
Lead Lost Reasons_get
Tools
| leadLostReasons_get | Ruft einen Lead-Verlustgrund anhand der id ab. |
Lead Lost Reasons_list
Tools
| leadLostReasons_list | Listet die Gründe auf, aus denen ein Lead als verloren markiert werden kann, in Reihenfolge. |
Leads_dedupe Check
Tools
| leads_dedupeCheck | Prüft, ob ein Interessent bereits im CRM vorhanden ist, mit denselben Filtern wie leads_list (companyName, source, owner, …). Dies VOR leads_create aufrufen: Ein doppelter Lead verteilt die Kontakthistorie auf zwei Datensätze, und nichts nachgelagert führt sie für Sie wieder zusammen. |
Leads_get
Tools
| leads_get | Ruft einen Lead anhand der id ab — Unternehmen, Website, Quelle, Status, Eigentümer und, falls vorhanden, den Kunden, zu dem er konvertiert wurde. |
Leads_list
Tools
| leads_list | Listet Leads — Interessenten-Ziele vor der Qualifizierung. Filterung nach status, source, owner, client, companyName oder createdAt/closedAt-Bereichen. Ein qualifizierter Lead wird über leads_convert zu einem Kunden plus einem offenen Deal; bis dahin existiert er nur hier, nicht in clients_list. |
Lead Stages_get
Tools
| leadStages_get | Ruft eine Lead-Phase anhand der id ab. |
Lead Stages_list
Tools
| leadStages_list | Listet die Phasen, die ein Lead durchläuft, in Reihenfolge. Leads haben ihren eigenen Phasensatz — Deals verwenden stages_list, was etwas anderes ist. |
Organizations_get
Tools
| organizations_get | Ruft eine Organisation nach id ab. WARNUNG — dies sagt NICHT aus, mit welcher Organisation Sie verbunden sind. Eine OAuth-Verbindung ist an genau eine Organisation gebunden (token-gebunden), aber dieser Endpunkt liefert jede Organisation, in der der verbundene BENUTZER Mitglied ist — ein erfolgreiches Lesen hier wirkt also wie eine Bestätigung, dass Sie in dieser Organisation arbeiten, obwohl das nicht der Fall sein muss. Um den tatsächlich aktiven Mandanten zu verifizieren, stattdessen mandantenbezogene Daten lesen — people_list oder clients_list — und niemals allein aufgrund dieses Aufrufs einen Massen-Schreibvorgang beginnen. |
People_get
Tools
| people_get | Ruft einen Personen-/Mitarbeiterdatensatz anhand der id ab — Namen, E-Mails, Telefon, Vorgesetzter und ob die Person aktiv ist. |
People_list
Tools
| people_list | Listet Personen/Mitarbeiter auf. Filtern Sie nach isActive, reportsTo (die id eines Vorgesetzten), projectMembers.project oder search; paginieren Sie mit cursor. Personen und Mitarbeiter teilen sich dieselbe id — so ermitteln Sie die employee-id, die Arbeitszeit, Zuständigkeiten, Projektmitgliedschaft und Berechtigungstools erwarten. |
Permission Groups_get
Tools
| permissionGroups_get | Ruft eine Berechtigungsgruppe anhand der id ab, einschließlich der ROLE_*-Strings, die sie gewährt. |
Permission Groups_list
Tools
| permissionGroups_list | Listet die Berechtigungsgruppen der Organisation und die Rollen, die jede davon gewährt — z. B. gewährt die Gruppe "Business Owner" ROLE_ADMIN. Dies vor people_setPermissionGroups lesen: Die Rollen in der Antwort sind maßgeblich dafür, was eine Gruppe tatsächlich erlaubt, sodass nie anhand des Namens geraten werden muss. |
Pipelines_get
Tools
| pipelines_get | Ruft eine Vertriebspipeline anhand der id ab. |
Pipelines_list
Tools
| pipelines_list | Listet Vertriebs-Pipelines. Eine Pipeline besitzt eine geordnete Menge von Phasen — diese mit stages_list, gefiltert nach pipeline, lesen. |
Positions_list
Tools
| positions_list | Listet Positionen — die benannten Rollen (z. B. "Backend Engineer"), die eine Projektzuweisung besetzt. Keine Filter; für Position ist Paginierung deaktiviert, daher liefert dies stets den vollständigen Rollenkatalog der Organisation in einem Aufruf. Jedes Element ist {id, name, roles}. Damit lässt sich der Positionsname hinter der positionId einer allocations_list-Zeile ermitteln, sowie die position-id finden, gegen die ein Resourcing-Import abgleichen muss. |
Projects_get
Tools
| projects_get | Ruft ein Projekt anhand der id ab — Name, Typ, Kunde, Daten, Beschreibung und Preis. |
Projects_list
Tools
| projects_list | Listet Projekte auf. Filtern Sie nach type (fixed-price | time-and-material | non-billable | internal), client.name, employee, name oder dateFrom-/dateTo-Zeiträumen. Damit ermitteln Sie die project-id, die Aufgaben, Arbeitszeiterfassung, Budgets und Verträge allesamt benötigen. |
Resource Request Candidates_get
Tools
| resourceRequestCandidates_get | Ein Recruiting-Kandidat nach id. Die id stammt aus resourceRequestCandidates_list. Erfordert ROLE_HR_MANAGER. Nur lesend. |
Resource Request Candidates_list
Tools
| resourceRequestCandidates_list | Die für Stellenanfragen vorgeschlagenen Kandidaten — Personen in einer Recruiting-Pipeline, keine für Zuweisungen verfügbaren Mitarbeiter. Filterung nach der request-id aus resourceRequests_list. Erfordert ROLE_HR_MANAGER. Nur lesend. |
Resource Requests_get
Tools
| resourceRequests_get | Eine Stellenanfrage nach id, mit Position und Status. Die id aus resourceRequests_list beziehen. HR/Recruiting, keine Resourcing-Zuweisung. Erfordert ROLE_HR_MANAGER. Nur lesend. |
Resource Requests_list
Tools
| resourceRequests_list | Offene Stellenanfragen — eine Anfrage zur Rekrutierung für eine Position, im HR-Bereich. Trotz des Namens ist dies KEIN Resourcing-Zuweisungsbedarf: Es ist Recruiting. Liefert die Sammlung; resourceRequests_get liest eine einzelne, und resourceRequestCandidates_list liefert die dafür vorgeschlagenen Personen. Erfordert ROLE_HR_MANAGER. Nur lesend. |
Resourcing Requests_list
Tools
| resourcingRequests_list | Offene Resourcing-Anfragen — jemand bittet darum, eine Person einem Projekt zuzuweisen; dies ist die Bedarfsseite des Resourcing. Dies ist der Ablauf, den die Requests-Ansicht der Resourcing-UI darstellt. NICHT mit resourceRequests_list verwechseln: Jenes ist HR-RECRUITING (Einstellung für eine Position). Zusammen mit resourcingRequestsHistory_list verwenden, um zu sehen, was bereits entschieden wurde, und mit resourcingBench_get, um zu sehen, wer eine Anfrage erfüllen könnte. Erfordert das Resourcing-Modul und ROLE_RESOURCING_MANAGER. Nur lesend. |
Resourcing Requests History_list
Tools
| resourcingRequestsHistory_list | Was mit Resourcing-Anfragen bereits geschehen ist — der Entscheidungsverlauf (bestätigt, abgelehnt, geändert) hinter den offenen Anfragen in resourcingRequests_list. Damit beantworten, ob 'dies bereits angefragt und abgelehnt wurde', bevor dieselbe Zuweisung erneut vorgeschlagen wird. Erfordert das Resourcing-Modul und ROLE_RESOURCING_MANAGER. Nur lesend. |
Responsibilities_get
Tools
| responsibilities_get | Ruft eine Zuständigkeit anhand der id ab. |
Responsibilities_list
Tools
| responsibilities_list | Listet Zuständigkeiten innerhalb einer RACI-Gruppe auf. Filtern Sie nach responsibilityGroup. Zuständigkeiten können über parent verschachtelt werden; Personen werden ihnen über responsibilityEmployees zugewiesen, nicht direkt. |
Responsibility Employees_get
Tools
| responsibilityEmployees_get | Ruft eine Zuständigkeitszuweisung anhand der id ab. |
Responsibility Employees_list
Tools
| responsibilityEmployees_list | Listet auf, wer welcher Zuständigkeit zugewiesen ist und zu welchem Prozentsatz. Filtern Sie nach employee, um die gesamte RACI-Auslastung einer Person über alle Gruppen hinweg zu lesen. |
Responsibility Groups_get
Tools
| responsibilityGroups_get | Ruft eine Zuständigkeitsgruppe anhand der id ab. |
Responsibility Groups_list
Tools
| responsibilityGroups_list | Listet Zuständigkeitsgruppen / RACI-Bereiche auf — die übergeordneten "Odpowiedzialności"-Einträge, jeweils mit einer verantwortlichen Person. Einzelne Zuständigkeiten hängen darunter. |
Schedule Employees_get
Tools
| scheduleEmployees_get | Eine Zuordnung Zeitplan-zu-Mitarbeiter nach id. Die id stammt aus scheduleEmployees_list. Erfordert ROLE_SCHEDULES_MANAGER. Nur lesend. |
Schedule Employees_list
Tools
| scheduleEmployees_list | Welche Mitarbeiter welchen Arbeitszeit-Zeitplänen zugeordnet sind. Damit von einem Zeitplan (schedules_list) zu seinen Personen gelangen, oder den Zeitplan eines bestimmten Mitarbeiters finden. Erfordert ROLE_SCHEDULES_MANAGER. Nur lesend. |
Schedule Plan_list
Tools
| schedulePlan_list | Die an EINEM bestimmten Datum geltenden Zeitpläne — das Datum im Pfad übergeben. Damit beantworten, 'wer heute / an diesem Datum arbeitet', ohne jeden Zeitplan zu lesen und dessen Zeiträume selbst aufzulösen. Anders als die übrigen Zeitplan-Lesevorgänge benötigt dies nur ROLE_USER und steht damit auch einem gewöhnlichen Mitarbeiter zur Verfügung. Nur lesend. |
Schedule Ranges_get
Tools
| scheduleRanges_get | Ein Zeitplan-Zeitraum nach id. Die id stammt aus scheduleRanges_list. Erfordert ROLE_SCHEDULES_MANAGER. Nur lesend. |
Schedule Ranges_list
Tools
| scheduleRanges_list | Die Zeiträume, aus denen sich Arbeitszeit-Zeitpläne zusammensetzen — die tatsächlichen Stunden, die ein Zeitplan abdeckt. Zuerst das übergeordnete Element mit schedules_get lesen; dies liefert dessen Zeiträume im Detail. Erfordert ROLE_SCHEDULES_MANAGER. Nur lesend. |
Schedules_get
Tools
| schedules_get | Ein Arbeitszeit-Zeitplan nach id, mit seinen Zeiträumen und zugeordneten Mitarbeitern. Die id stammt aus schedules_list; scheduleRanges_list und scheduleEmployees_list lesen seine Bestandteile. Erfordert ROLE_SCHEDULES_MANAGER. Nur lesend. |
Schedules_list
Tools
| schedules_list | Arbeitszeit-Zeitpläne — die von einer Organisation definierten Schicht-/Arbeitsmuster, KEINE Projektzuweisung. resourcingSchedule_get verwenden, um zu sehen, wer worauf gebucht ist; dieses Tool für die Arbeitsmuster selbst. schedules_get liest einen einzelnen nach id. Erfordert ROLE_SCHEDULES_MANAGER. Nur lesend. |
Stages_get
Tools
| stages_get | Ruft eine Deal-Phase anhand der id ab. |
Stages_list
Tools
| stages_list | Listet Deal-Phasen, in Reihenfolge. Filterung nach pipeline. deals_create benötigt eine stage-id von hier, und das Verschieben eines Deals zwischen Phasen ist das, was dealStageHistories protokolliert. |
Suppliers_list
Tools
| suppliers_list | Listet Lieferanten/Auftragnehmer auf — ausgeliefert von /contractors, "supplier" und "contractor" sind also derselbe Datensatz. Filtern Sie nach cyclic für wiederkehrende Lieferanten. Damit ermitteln Sie den Lieferanten, gegen den eine Kosten-, Vertrags- oder Eingangsrechnungsposition verbucht ist. |
Tag Definitions_list
Tools
| tagDefinitions_list | Listet Tag-Definitionen — die Tags, die Datensätzen angehängt werden können, jeweils innerhalb einer Tag-Gruppe. tags_create benötigt eine tagDefinition-id von hier sowie den Datensatz, an den sie angehängt wird. |
Tag Groups_list
Tools
| tagGroups_list | Listet Tag-Gruppen auf — die Container, die Tag-Definitionen organisieren. |
Task Comments_list
Tools
| taskComments_list | Listet Kommentare zu Projektaufgaben auf, älteste zuerst. Filtern Sie nach task, um die Diskussion zu einer Aufgabe zu lesen. |
Task Lists_list
Tools
| taskLists_list | Listet Aufgabenlisten — die Board-Spalten/Bereiche, in denen Aufgaben abgelegt werden. Filterung nach project. tasks_create benötigt eine list-id von hier. |
Tasks_get
Tools
| tasks_get | Ruft eine Projektaufgabe anhand der id ab — Titel, Projekt, Status, Liste, Zugewiesene, Daten und Wiederholung. |
Tasks_list
Tools
| tasks_list | Listet Projektaufgaben. Filterung nach project, list, status, assignees, isTemplate oder startAt/dueAt-Bereichen. Wiederkehrende Aufgaben stellen recurrenceParent und recurrenceRule bereit, sodass ein generiertes Vorkommen bis zur erzeugenden Regel zurückverfolgt werden kann. Um zu entscheiden, ob eine Aufgabe ERLEDIGT ist, deren status mit taskStatuses_list (isClosed) abgleichen, statt den Statusnamen zu vergleichen. |
Task Statuses_list
Tools
| taskStatuses_list | Listet die Projektaufgabenstatus auf, in Board-Reihenfolge. isClosed kennzeichnet die abgeschlossenen Zustände und isDefault den Status, den eine neue Aufgabe erhält. Lesen Sie dies, bevor Sie den Status einer Aufgabe interpretieren — die Namen sind organisationsseitig konfigurierbar, sodass "Done" kein verlässlicher String zum Abgleich ist. |
Tax Groups_list
Tools
| taxGroups_list | Listet Steuergruppen. Damit lässt sich die taxGroup-id ermitteln, nach der taxRules_list filtert und die Rechnungspositionen führen. |
Tax Rules_list
Tools
| taxRules_list | Listet Steuerregeln auf — die Sätze und die Zeiträume, für die sie gelten. Filtern Sie nach taxGroup. |
Transactions_list
Tools
| transactions_list | Listet Banktransaktionen auf — den Kontoauszugs-Feed, gegen den Eingangsrechnungen abgeglichen werden. Filtern Sie nach bankAccount, counterpartyRole, cost, ignored, hasDetectedProblems, einem orderDate-/execDate-Zeitraum oder amount.between. Beachten Sie: orderDate und execDate sind unterschiedlich — eine Zahlung kann in einem Monat beauftragt werden und im nächsten ausgeführt werden. |
Transactions_suggestions
Tools
| transactions_suggestions | Liest Flowtlys Vorschläge für eine Banktransaktion — welchem Vertragspartner, welcher Kostengruppe oder welchem Dokument sie zugeordnet werden sollte. Das Gegenstück zu incomingInvoices_suggestions, von der Geldseite aus. |
Work Times_get
Tools
| workTimes_get | Ruft einen einzelnen Arbeitszeiteintrag anhand der id ab — Datum, Minuten, Projekt, Notizen und der zugehörige Mitarbeiter. |
Work Times_list
Tools
| workTimes_list | Listet Arbeitszeiteinträge (erfasste Stunden) auf. Filtern Sie nach Zeitraum (date.after / date.before, YYYY-MM-DD) und optional nach employee oder project; paginieren Sie mit cursor. Jede Zeile führt employeeId/employeeName und projectId/projectName, damit exportieren Sie alle erfassten Stunden für einen Zeitraum. WICHTIG: Organisationsweite Ergebnisse erfordern ROLE_WORKING_HOURS_VIEWER. Ohne diese Rolle meldet das Backend KEINEN Fehler — es liefert stillschweigend nur die eigenen Einträge des verbundenen Benutzers, sodass ein Export "aller Stunden" nur eine Person enthalten kann und dabei völlig unauffällig aussieht. Wenn jede Zeile zu einem einzigen Mitarbeiter gehört und Sie nicht nach employee gefiltert haben, führt die Antwort ein scopeWarning, das dies anzeigt — weisen Sie den Benutzer darauf hin, statt das Ergebnis als organisationsweit darzustellen. |
Work Times_log
Tools
| workTimes_log | Erfasst einen Arbeitszeiteintrag für den verbundenen Flowtly-Benutzer (date, durationMinutes, project, notes). Schreibend. |
Tasks_create
Tools
| tasks_create | Erstellt eine Projektaufgabe (title + project erforderlich; optional status, list, assignees, dueAt, priority). Schreibend. |
Tasks_update
Tools
| tasks_update | Aktualisiert eine Projektaufgabe anhand der id — ändert status (inkl. als erledigt markieren), assignees, dueAt, title usw. Schreibend. |
Task Comments_create
Tools
| taskComments_create | Fügt einer Projektaufgabe einen Kommentar hinzu (task-id + content). Schreibend. |
Suppliers_create
Tools
| suppliers_create | Erstellt einen neuen Lieferanten-/Auftragnehmerdatensatz (name, tinType, costGroup erforderlich). Schreibend. |
Suppliers_update
Tools
| suppliers_update | Aktualisiert die Angaben eines Lieferanten/Auftragnehmers (name, Steuernummer, Zahlungsbedingungen usw.) anhand der id. Schreibend. |
People_create
Tools
| people_create | Erstellt einen Personen-/Mitarbeiterdatensatz (firstname + lastname erforderlich; optional companyEmail, contactEmail, contactPhone). Schreibend. |
People_update
Tools
| people_update | Aktualisiert einen Personen-/Mitarbeiterdatensatz anhand der id (name, companyEmail, contactEmail, contactPhone usw.). Schreibend. |
People_delete
Tools
| people_delete | Löscht einen Mitarbeiter-/Personendatensatz anhand der id (z. B. um einen Platzhalter-/Dummy-Mitarbeiter zu entfernen). Erfordert ROLE_EMPLOYEES_MANAGER; das Backend führt einen Löschprozessor aus, der auch verknüpfte Datensätze löst. Hohe Auswirkung, unumkehrbar. Schreibend. |
Cost Groups_create
Tools
| costGroups_create | Erstellt eine Kostengruppe / Kostenstelle (name + type erforderlich). Schreibend. |
Cost Groups_update
Tools
| costGroups_update | Aktualisiert Name oder Typ einer Kostengruppe / Kostenstelle anhand der id. Schreibend. |
Tag Groups_create
Tools
| tagGroups_create | Erstellt eine Tag-Gruppe (name erforderlich), um zusammengehörige Tag-Definitionen zu organisieren. Schreibend. |
Tag Definitions_create
Tools
| tagDefinitions_create | Erstellt eine Tag-Definition (name, level, tagGroup erforderlich) innerhalb einer Tag-Gruppe. Schreibend. |
Clients_create
Tools
| clients_create | Erstellt einen neuen Kundendatensatz (name, country, currency, status, tinType erforderlich). Schreibend. |
Clients_update
Tools
| clients_update | Aktualisiert einen Kundendatensatz anhand der id. Schreibend. |
Client Contacts_create
Tools
| clientContacts_create | Erstellt eine Kontaktperson für einen Kunden (client, type, name, email erforderlich). Schreibend. |
Bank Accounts_create
Tools
| bankAccounts_create | Erstellt ein Bankkonto (type, name, currency, defaultImportFormat erforderlich). Schreibend. |
Bank Accounts_update
Tools
| bankAccounts_update | Aktualisiert ein Bankkonto anhand der id. Schreibend. |
Counterparty Bank Accounts_create
Tools
| counterpartyBankAccounts_create | Ordnet einem Geschäftspartner ein Bankkonto zu (counterparty + accountNumber). Schreibend. |
Contracts_create
Tools
| contracts_create | Erstellt einen Vertrag. Schreibend. |
Contracts_update
Tools
| contracts_update | Aktualisiert einen Vertrag anhand der id. Schreibend. |
Contracts_delete
Tools
| contracts_delete | Löscht einen Vertrag anhand der id. Schreibend. |
Tax Groups_create
Tools
| taxGroups_create | Erstellt eine Steuergruppe (name + type erforderlich). Schreibend. |
Tax Groups_update
Tools
| taxGroups_update | Aktualisiert Name oder Typ einer Steuergruppe anhand der id. Schreibend. |
Tax Rules_create
Tools
| taxRules_create | Erstellt eine Steuerregel. Schreibend. |
Tax Rules_update
Tools
| taxRules_update | Aktualisiert eine Steuerregel anhand der id. Schreibend. |
Configs_update
Tools
| configs_update | Aktualisiert einen Organisationskonfigurationswert anhand der id (type + name erforderlich; Berechtigungen werden vom Backend pro Konfigurationsschlüssel durchgesetzt). Schreibend. |
Permission Groups_create
Tools
| permissionGroups_create | Erstellt eine Berechtigungsgruppe (name erforderlich; roles = Liste der gewährten ROLE_*-Strings). Schreibend. |
Permission Groups_update
Tools
| permissionGroups_update | Aktualisiert Name, Beschreibung oder gewährte Rollen einer Berechtigungsgruppe anhand der id. Schreibend. |
People_set Permission Groups
Tools
| people_setPermissionGroups | Setzt (ersetzt) die Berechtigungsgruppen einer Person anhand numerischer group-ids (siehe permissionGroups_list — z. B. gewährt die Gruppe "Business Owner" ROLE_ADMIN). Gewährt Zugriff; erstellt KEINEN Login und sendet KEINE E-Mail an die Person. Schreibend. |
Projects_create
Tools
| projects_create | Erstellt ein Projekt (name + type erforderlich; type = fixed-price|time-and-material|non-billable|internal; optional dateFrom/dateTo, client, publicDescription, notes, priceNet). Schreibend. |
Projects_update
Tools
| projects_update | Aktualisiert ein Projekt anhand der id (name, type, Daten, Beschreibung usw.). Schreibend. |
Responsibility Groups_create
Tools
| responsibilityGroups_create | Erstellt eine Verantwortungsgruppe / einen RACI-Bereich (name erforderlich; optional description und responsibleEmployee = die verantwortliche Person, angegeben als einfache employee-id wie 6 (aus people_list) oder die IRI /people/6). Dies ist das übergeordnete 'Odpowiedzialności'-Element. Einzelne Verantwortlichkeiten darunter über responsibilities_create hinzufügen. Schreibend. |
Responsibility Groups_update
Tools
| responsibilityGroups_update | Aktualisiert eine Zuständigkeitsgruppe anhand der id (name, description, responsibleEmployee = employee-id oder IRI). Schreibend. |
Responsibilities_create
Tools
| responsibilities_create | Erstellt eine Verantwortlichkeit innerhalb einer Gruppe (responsibilityGroup = group-id oder IRI, + name, erforderlich; optional description; optional parent = eine weitere responsibility-IRI zur Verschachtelung). Personen dafür über responsibilityEmployees_create zuweisen. Schreibend. |
Responsibilities_update
Tools
| responsibilities_update | Aktualisiert eine Zuständigkeit anhand der id (name, description, parent, responsibilityGroup = group-id oder IRI). Schreibend. |
Responsibility Employees_create
Tools
| responsibilityEmployees_create | Weist einer Zuständigkeit einen Mitarbeiter zu (responsibility = responsibility-id oder IRI, employee = employee-id oder IRI, percentage 0-100, alle erforderlich; optional targets und description). Schreibend. |
Responsibility Employees_update
Tools
| responsibilityEmployees_update | Aktualisiert eine Zuständigkeitszuweisung anhand der id (percentage, targets, description). Schreibend. |
Responsibility Employees_delete
Tools
| responsibilityEmployees_delete | Entfernt die Zuweisung eines Mitarbeiters zu einer Zuständigkeit anhand der id. Schreibend. |
Leads_create
Tools
| leads_create | Erstellt einen Lead (Outbound-/Inbound-Interessent; companyName, source, status, owner, linked client optional). Schreibend. |
Leads_update
Tools
| leads_update | Aktualisiert einen Lead anhand der id (company, website, source, status, owner, linked client). Schreibend. |
Leads_delete
Tools
| leads_delete | Löscht einen Lead anhand der id (Soft-Delete). Schreibend. |
Leads_convert
Tools
| leads_convert | Konvertiert einen qualifizierten Lead in einen Client + einen Kontakt pro Lead-Kontakt + einen offenen Deal. Erfordert einen bestehenden Client (den client des Leads oder eine clientId im Body). Schreibend. |
Lead Activities_create
Tools
| leadActivities_create | Protokolliert EINE Kontaktaufnahme bei einem Lead — eine gesendete Einladung, eine akzeptierte Einladung, eine Nachricht, eine Antwort, ein Anruf, ein Follow-up (lead + type + occurredAt erforderlich; channel, contact, body optional). HIER gehört die Kontakthistorie eines Interessenten hin: Eine crmNote ist freier Kommentartext, eine Aktivität ist das strukturierte, filterbare Kontaktprotokoll, das die Timeline der Prospecting-Warteschlange darstellt. Kontakte NICHT in einer Notiz beschreiben. type: invite_sent | invite_accepted | message_sent | reply_received | call | meeting | follow_up | …; channel: linkedin | email | phone | …. Schreibend. |
Lead Activities_update
Tools
| leadActivities_update | Aktualisiert eine protokollierte Kontaktaktivität nach id (type, channel, occurredAt, body). Schreibend. |
Lead Activities_delete
Tools
| leadActivities_delete | Löscht eine protokollierte Kontaktaktivität nach id. Schreibend. |
Lead Contacts_create
Tools
| leadContacts_create | Fügt eine Kontaktperson zu einem Lead hinzu (lead + name erforderlich; email, phone, role, linkedinUrl, isPrimary optional). Die LinkedIn-URL eines Kontakts gehört in linkedinUrl, NICHT in eine crmNote. Schreibend. |
Lead Contacts_update
Tools
| leadContacts_update | Aktualisiert einen Lead-Kontakt nach id — z. B. linkedinUrl / email / phone setzen, sobald diese gefunden wurden. Schreibend. |
Lead Contacts_delete
Tools
| leadContacts_delete | Löscht einen Lead-Kontakt anhand der id. Schreibend. |
Deals_create
Tools
| deals_create | Erstellt einen Deal/eine Opportunity (title, client, stage erforderlich; amountMinor, currency, expectedCloseDate, owner, contact optional). Schreibend. |
Deals_update
Tools
| deals_update | Aktualisiert einen Deal anhand der id (title, stage, amount, Abschlussdatum, owner, contact). Der Phasenwechsel wird automatisch protokolliert. Schreibend. |
Deals_delete
Tools
| deals_delete | Löscht einen Deal anhand der id (Soft-Delete). Schreibend. |
Deals_win
Tools
| deals_win | Markiert einen Deal als gewonnen — verschiebt ihn in eine Gewonnen-Phase und markiert ihn als abgeschlossen; optional verknüpft contractId einen bestehenden Vertrag. Schreibend. |
Deals_lose
Tools
| deals_lose | Markiert einen Deal als verloren — erfordert lostReasonId (aus dealLostReasons_list); optional lostReasonNote. Schreibend. |
Deals_reopen
Tools
| deals_reopen | Öffnet einen gewonnenen/verlorenen Deal wieder. Schreibend. |
Lead Lists_create
Tools
| leadLists_create | Erstellt eine Outbound-Prospecting-Liste (name erforderlich). Schreibend. |
Lead Lists_update
Tools
| leadLists_update | Aktualisiert eine Outbound-Liste anhand der id. Schreibend. |
Lead Lists_delete
Tools
| leadLists_delete | Löscht eine Outbound-Liste anhand der id. Schreibend. |
Lead List Memberships_create
Tools
| leadListMemberships_create | Fügt einer Outbound-Liste einen Lead hinzu (list + lead erforderlich; status optional). Schreibend. |
Lead List Memberships_update
Tools
| leadListMemberships_update | Aktualisiert die Mitgliedschaft eines Leads in einer Liste — z. B. den Kontaktstatus setzen (contacted/replied/bounced). Schreibend. |
Lead List Memberships_delete
Tools
| leadListMemberships_delete | Entfernt einen Lead aus einer Outbound-Liste. Schreibend. |
CRM Notes_create
Tools
| crmNotes_create | Fügt einem Lead oder Deal eine Notiz hinzu (body + genau eines von lead/deal). Autor ist der verbundene Benutzer. Schreibend. |
CRM Notes_update
Tools
| crmNotes_update | Aktualisiert den Text einer CRM-Notiz anhand der id. Schreibend. |
CRM Notes_delete
Tools
| crmNotes_delete | Löscht eine CRM-Notiz anhand der id. Schreibend. |
Organization Logo_upload
Tools
| organizationLogo_upload | Lädt das Logo der Organisation hoch bzw. ersetzt es (Base64-Bild + contentType + filename). Das aktuelle Logo über configs_get organization-logo-url lesen. Schreibend. |
Organization Icon_upload
Tools
| organizationIcon_upload | Lädt das Icon/Favicon der Organisation hoch bzw. ersetzt es (Base64-Bild + contentType + filename). Das aktuelle Icon über configs_get organization-icon-url lesen. Schreibend. |
Incoming Invoices_create
Tools
| incomingInvoices_create | Legt eine Eingangsrechnung (Lieferant) oder ein Belegdokument in der Buchhaltung ab — die Bytes als Base64 mit fileName und receivedAt übergeben. Flowtly führt eine OCR durch und schlägt einen Lieferanten sowie eine passende Banktransaktion vor. Die Datei wird als externalId 'upload_sha256:<sha256 der Bytes>' fingerprintet: Um ein Duplikat zu vermeiden, die Bytes hashen und VOR dem Upload incomingInvoices_list auf diese externalId prüfen. Schreibend. |
Invoices_export
Tools
| invoices_export | Startet einen ZIP-Export AUSGESTELLTER Rechnungen für einen Zeitraum (from/to, beide YYYY-MM-DD, einschließlich), gefiltert nach VERKAUFSDATUM — nicht Ausstellungs- oder Erstellungsdatum. Es werden nur AUSGESTELLTE Rechnungen eingeschlossen; Entwürfe und nicht versendete Rechnungen sind ausgeschlossen, Korrekturen SIND jedoch eingeschlossen. Optionales client schränkt auf einen Kunden ein (id oder IRI aus clients_list). Max. 200 Rechnungen pro Export — hat der Zeitraum mehr, ihn eingrenzen (z. B. jeweils einen Monat exportieren); ein Zeitraum mit 0 ausgestellten Rechnungen wird ebenfalls abgelehnt. Dieser Aufruf reiht den Job nur ein (das Rendern eines Monats kann Minuten dauern) — er liefert KEINEN Download-Link. invoices_exportStatus mit der zurückgegebenen exportId abfragen, bis "ready" gemeldet wird. Schreibend. |
Invoices_export Status
Tools
| invoices_exportStatus | Fragt den Status eines von invoices_export gestarteten ZIP-Exports nach exportId ab. Sobald status "ready" ist, enthält die Antwort downloadUrl (ein kurzlebiger signierter Link — läuft nach 1 Stunde ab, siehe expiresAt), filename und byteSize; die Bytes der Datei werden über dieses Tool niemals zurückgegeben. Bei status "failed" erklärt failureReason den Grund. |
Invoices_import
Tools
| invoices_import | Legt eine BEREITS AUSGESTELLTE Ausgangsrechnung (Verkauf) in der Organisation ab — zum Einbringen der Rechnungshistorie beim Onboarding. Die übergebene externe Rechnungsnummer wird unverändert übernommen, der Käufer wird per Steuer-ID aufgelöst (bei Fehlen angelegt), und die Rechnung landet als ausgestellt, OHNE ein PDF zu rendern, den Kunden per E-Mail zu benachrichtigen oder an KSeF zu übermitteln. Der Import einer bereits vorhandenen Nummer ist eine Nulloperation, die die bestehende Rechnung meldet — ein Massenimport lässt sich also gefahrlos erneut ausführen. Diese Garantie gilt jedoch nur für sequenzielle Aufrufe; zwei tatsächlich gleichzeitige Importe derselben Nummer können beide durchgehen. expectedGrossTotal übergeben (der auf dem Quelldokument aufgedruckte Bruttobetrag), und der Import wird abgelehnt, falls dieser vom aus den Zeilen berechneten Gesamtbetrag abweicht. buyer.tin ist erforderlich — der Käufer wird nie über den Namen abgeglichen. Für eine echte neue Rechnung invoices_create verwenden, nicht dieses Tool. Schreibend. |
Invoice Transactions_create
Tools
| invoiceTransactions_create | Erfasst eine Zahlung zu einer Ausgangsrechnung (Verkauf). `invoice` ist eine invoice-IRI aus invoices_list; `date` ist der Zeitpunkt, zu dem die Zahlung als erfolgt gilt. `transaction` ist optional — weglassen, um eine Ausgleichung ohne Bankposition zu erfassen, was bei historischen Rechnungen erwünscht ist, deren Kontoauszug nie importiert wurde. `amount` ist optional und entspricht standardmäßig dem offenen Betrag der Rechnung. Das Erfassen einer Zahlung sorgt dafür, dass eine ausgestellte, überfällige Rechnung nicht mehr als unbezahlt behandelt wird, und stoppt damit auch das Einreihen von Zahlungserinnerungen dafür. Nichts verhindert das Erfassen zweier Zahlungen zu einer Rechnung — bei Unsicherheit, ob bereits ausgeglichen wurde, zuerst invoices_get lesen. Schreibend. |
Invoice Transactions_update
Tools
| invoiceTransactions_update | Aktualisiert einen bestehenden Rechnungszahlungs-Datensatz nach id (aus den invoiceTransactions von invoices_get, oder durch Paginieren von invoiceTransactions). Häufigste Verwendung: eine ohne Bankposition erfasste Zahlung mit einer gerade über transactions_importStatement importierten Transaktion verknüpfen, indem `transaction` auf eine transaction-IRI/id aus transactions_list gesetzt wird. DIE FALLE: Dies ist ein PATCH, das Backend verlangt bei jedem Aufruf dennoch `invoice` und `date` — es führt bestehende Werte NICHT automatisch zusammen. Zuerst den Datensatz lesen (oder ihn bereits aus dem Erstellungsaufruf vorliegen haben) und dessen `invoice` und `date` unverändert erneut senden, zusammen mit dem, was tatsächlich geändert werden soll, sonst wird die Aktualisierung abgelehnt. `transaction` akzeptiert null, um eine Zahlung von einer Bankposition zu lösen. `amount` ist optional. Schreibend. |
Incoming Invoices_apply Suggestion
Tools
| incomingInvoices_applySuggestion | Übernimmt einen von Flowtlys eigenen Vorschlägen zu einer Eingangsrechnung — dieselben Vorschläge, die ein Mensch in der App sieht (Lieferantenabgleich, Kostengruppe, passende Banktransaktion, Duplikatswarnung). Zuerst mit incomingInvoices_suggestions lesen, dann einen davon per id anwenden. Dies dem Raten vorziehen: Flowtlys Matcher entscheidet, was plausibel ist, nicht der Agent. Schreibend. |
Incoming Invoices_accept All Suggestions
Tools
| incomingInvoices_acceptAllSuggestions | Übernimmt in einem Aufruf jeden ausstehenden Vorschlag zu einer Eingangsrechnung — das, was ein Mensch mit dem "Alle übernehmen"-Button der App tut. Der Server wendet an, baut neu auf und wendet erneut an, bis nichts Neues mehr erscheint: Der Transaktionsabgleich existiert erst, wenn Lieferant und Betrag angewendet sind, ein einziger Durchlauf würde das Dokument also unverknüpft lassen. Liefert einen Bericht zurück (was angewendet wurde, was abgelehnt wurde und warum, sowie die Transaktion, gegen die am Ende verbucht wurde). Übergeben Sie dryRun, um ohne Schreibvorgang eine Vorschau zu erhalten. Übernimmt niemals supplier_create oder eine Duplikatswarnung. Schreibend. |
Incoming Invoices_check EInvoices
Tools
| incomingInvoices_checkEInvoices | Holt neue KSeF-E-Rechnungen in die Organisation — das, was der Button "Sprawdź e-faktury" in der App tut. Dies aufrufen, bevor der Schluss gezogen wird, dass die Rechnung eines Lieferanten fehlt: Ohne diesen Aufruf lässt sich "der Lieferant hat sie nie gesendet" nicht von "unsere Synchronisierung ist noch nicht gelaufen" unterscheiden. Kehrt zurück, sobald der Abruf eingereiht ist; anschließend incomingInvoices_list erneut lesen, um zu sehen, was eingetroffen ist. Schreibend. |
Resourcing_import Timeline
Tools
| resourcing_importTimeline | Importiert ein Resourcing-Allokations-Zeitplanblatt (über den Drive-MCP abrufen, dessen CSV unverändert übergeben). Dies ist ein VOLLSTÄNDIGER ERSATZ-Abgleich der Allocation-Zeilen der Organisation für `year`: Zeilen im Sheet werden erstellt/aktualisiert, und jede bestehende Zeile dieses Jahres, die im Sheet fehlt, wird GELÖSCHT — kein Merge. STANDARDMÄSSIG DRY-RUN: Ein weggelassenes dryRun zeigt nur eine Vorschau und schreibt nichts; dryRun:false übergeben, um anzuwenden. Der Bericht liefert `created` / `replaced` sowie `unmatchedPeople` / `unmatchedProjects`. ZWEI DINGE WERDEN LEICHT ÜBERSEHEN: Eine Sheet-Zeile, deren Projekt sich nicht auflösen lässt, wird ÜBERSPRUNGEN, während der Aufruf dennoch Erfolg meldet — ein grünes Ergebnis kann also einen teilweisen Import verbergen; und ein Rollencode, den der Positionskatalog noch nicht enthält, wird als NEUE Position ANGELEGT statt abgelehnt — siehe `createdPositions`. Beides wird, wenn es auftritt, in `warnings` genannt; dies dem Benutzer mitteilen, statt nur `created` zu melden. Ein Sheet, das zu null Zeilen geparst wird, wird abgelehnt (es sieht genau wie ein fehlerhaftes Lesen aus, das den gesamten Zeitplan löschen würde), es sei denn, force:true wird übergeben. Anschließend allocations_list lesen, um zu sehen, was angekommen ist. Große Auswirkung. Schreibend. |
Transactions_import Statement
Tools
| transactions_importStatement | Importiert eine Kontoauszugsdatei (z. B. eine MT940-.sta-Datei) — den Rohtextinhalt jeder Datei unverändert (NICHT Base64) mit einem filename übergeben. ES GIBT KEINEN bankAccount-PARAMETER: Das Backend leitet eine Datei, indem es alle Nicht-Ziffernzeichen aus den Nummern Ihrer Bankkonten sowie aus den Bytes der Datei entfernt und in jedes Konto importiert, dessen Ziffern irgendwo in der Datei vorkommen — eine Datei kann also in mehreren Konten landen, und ein Auszug für ein Konto, das in Flowtly nicht angelegt ist (oder dessen Nummer anders erfasst ist, als die Bank sie schreibt), wird in keines davon importiert und schlägt mit einer Fehlermeldung fehl, die genau erklärt, warum — diese Meldung lesen, sie ist die einzige Diagnose, die dieser Endpunkt liefert. Bei Erfolg lautet die Antwort `{ imported, matching }`: `matching: "in_progress"` bedeutet, dass der Auftragnehmer-/Anhang-Abgleich für die neuen Zeilen nach Rückkehr dieses Aufrufs noch läuft, sodass ein sofortiges transactions_list Zeilen zeigen kann, die noch nicht abgeglichen sind — etwas später erneut lesen für den endgültigen Zustand. Das erneute Importieren desselben Auszugs erzeugt keine doppelten Zeilen; der Importer erkennt bereits gesehene Transaktionen. Sobald ein Auszug vorliegt, eine bestehende Zahlung ohne Bankposition mit einer ihrer Zeilen verknüpfen mit… |
Organization_whoami
Tools
| organization_whoami | Gibt die Organisation zurück, an die diese MCP-Verbindung gebunden ist — { orgId, name, slug, userId }. Vor jedem create/update aufrufen, um zu bestätigen, IN WELCHEN Mandanten geschrieben wird: Die Verbindung ist per Token an genau eine Organisation gebunden, und das Schreiben von Interessenten/Datensätzen in die falsche Organisation ist ein realer Vorfall. Nur lesend. |
Resourcing Actuals_get
Tools
| resourcingActuals_get | Gemeldete Stunden im Vergleich zum Plan, pro Person und Woche, über ein from/to-Fenster — die Frage 'liegt das Team tatsächlich im Plan?', die KEIN anderes Resourcing-Tool beantwortet: Zuweisungen zeigen, was GEPLANT war, dies zeigt, was GELEISTET wurde. Liefert Wochenspalten plus eine Zeile pro Person (geplanter %, gemeldeter %, Abweichung, Summen und eine Aufschlüsselung pro Projekt). reportedPercent = null bedeutet 'kein Vertrag in dieser Woche' und 0 bedeutet 'ein Vertrag bestand und nichts wurde gemeldet' — die beiden NICHT gleichsetzen. financials übergeben für Umsatz/Kosten/Marge, die sonst weggelassen werden. Erfordert das Resourcing-Modul und ROLE_RESOURCING_MANAGER. Nur lesend. |
Resourcing Bench_get
Tools
| resourcingBench_get | Wer über ein from/to-Fenster NICHT eingesetzt ist — der Pool. Damit klären, wer einem neuen Projekt zugeteilt werden könnte oder wo Kapazität ungenutzt bleibt; resourcingActuals_get zeigt, wie ausgelastet Personen sind, dieses Tool zeigt, wer gar keine Auslastung hat. ES KENNT KEINEN URLAUB: freePercent ist 100 minus bestätigte Zuweisungen, nichts weiter — jemand mit drei Wochen genehmigtem Urlaub erscheint als 100 % frei, und kein Feld der Antwort weist auf etwas anderes hin. Wird 'wer ist verfügbar' allein hieraus beantwortet, werden Personen Projekten zugeteilt, während sie abwesend sind — mit holidays_active oder holidays_list gegenprüfen. Erfordert das Resourcing-Modul. Nur lesend. |
Resourcing Schedule_get
Tools
| resourcingSchedule_get | Der geplante Resourcing-Zeitplan über ein from/to-Fenster — der Zuweisungs-Zeitplan, wie ihn der Planer anzeigt. Damit sehen, was künftig GEBUCHT ist; resourcingActuals_get verwenden für das, was tatsächlich dagegen gemeldet wurde. Erfordert das Resourcing-Modul und ROLE_RESOURCING_MANAGER. Nur lesend. |
Leads_bulk Import
Tools
| leads_bulkImport | Importiert viele Leads in EINEM Aufruf, jeweils mit verschachtelten Kontakten, Listenmitgliedschaft und Kontaktaktivitäten — der Server legt den Lead an und reicht dessen id dann an die untergeordneten Elemente weiter, sodass niemals mit Zwischen-IRIs jongliert werden muss. Idempotent anhand natürlicher Schlüssel (companyName / email / (list,lead) / (type,occurredAt,contact)): gefahrlos erneut ausführbar und in Blöcken (≤100 Leads/Aufruf) nutzbar. Dies ist der Massenweg, den ein Kampagnenimport statt N einzelner leads_create-Aufrufe verwenden sollte. Schreibend. |