Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt

Use this file to discover all available pages before exploring further.

Viele Organisationen bestehen aus einer übergeordneten Einheit mit mehreren Abteilungen, Standorten oder Tochtergesellschaften. Die Organisationsstruktur ermöglicht es, diese Beziehungen direkt in Fynn abzubilden — mit einer klaren Parent-Child-Hierarchie zwischen Kunden.
Die Organisationsstruktur erfordert die Aktivierung des Feature-Flags customer.hierarchy. Kontaktiere den Support, um diese Funktion für deinen Mandanten freizuschalten.

​
Überblick

Mit der Organisationsstruktur kannst du:
  • Parent-Child-Beziehungen zwischen Kunden definieren (z. B. Hauptunternehmen → Abteilungen)
  • Bis zu 3 Hierarchieebenen abbilden (Hauptunternehmen → Tochtergesellschaft → Abteilung)
  • Abonnements, Rechnungen und Transaktionen gefiltert nach Organisationszugehörigkeit einsehen
  • Aktivitäten zur Nachverfolgung von Hierarchieänderungen nutzen
Die Organisationsstruktur ist eine rein organisatorische Funktion. Sie hat in der aktuellen Version keinen Einfluss auf die Rechnungsstellung oder Zahlungsabwicklung. Sie bildet die Grundlage für zukünftige Funktionen wie die organisationsbasierte Abrechnung (Consolidated Billing).

​
Anwendungsbeispiele

BrancheParent-KundeChild-Kunden
GesundheitswesenKlinik MusterstadtRadiologie, Orthopädie, Kardiologie
RechtKanzlei Schmidt & PartnerStandort Berlin, Standort München
EinzelhandelRetail Group GmbHFiliale Nord, Filiale Süd, Filiale West

​
Hierarchie verwalten

​
Parent-Kunde zuweisen

1

Kundendetails öffnen

Navigiere zum Kunden, der als Child-Kunde einem übergeordneten Kunden zugewiesen werden soll.
2

Parent-Kunde zuweisen

Im Bereich Organisationsstruktur kannst du den übergeordneten Kunden (Parent) auswählen und zuweisen.

​
Parent-Kunde entfernen

1

Kundendetails öffnen

Navigiere zum Child-Kunden, dessen Parent-Zuweisung entfernt werden soll.
2

Parent-Zuweisung entfernen

Im Bereich Organisationsstruktur kannst du die bestehende Parent-Zuweisung entfernen. Der Kunde wird dadurch wieder zu einem eigenständigen Kunden ohne Hierarchie.

​
Child-Kunden einsehen

Auf der Kundendetailseite eines Parent-Kunden wird die Anzahl der Child-Kunden angezeigt. Über den Bereich Organisationsstruktur kannst du direkt zu den Child-Kunden navigieren.

​
Gesamte Hierarchie anzeigen

Über die API kannst du die vollständige Hierarchie eines Kunden als Baumstruktur abrufen — unabhängig davon, ob du den Parent- oder einen Child-Kunden angibst. Die Antwort beginnt immer beim Root-Kunden. 
GET /customers/{customerId}/hierarchy

{
    "root": {
        "id": "uuid-100",
        "name": "Klinik Musterstadt",
        "customerNumber": "CUST-100",
        "isCurrentCustomer": false,
        "children": [
            {
                "id": "uuid-101",
                "name": "Radiologie",
                "customerNumber": "CUST-101",
                "isCurrentCustomer": true,
                "children": []
            },
            {
                "id": "uuid-102",
                "name": "Orthopädie",
                "customerNumber": "CUST-102",
                "isCurrentCustomer": false,
                "children": []
            }
        ]
    }
}

​
Kundenliste filtern

Die Kundenliste unterstützt zusätzliche Filter für die Organisationsstruktur:
FilterBeschreibung
parentCustomerIdZeigt nur die direkten Child-Kunden eines bestimmten Parent-Kunden
isParent=trueZeigt nur Kunden, die Child-Kunden haben
hasParent=trueZeigt nur Kunden, die einem Parent-Kunden zugewiesen sind
Beispiel über die API: 
GET /customers?parentCustomerId={parentId}
GET /customers?isParent=true
GET /customers?hasParent=true

​
Organisationsübergreifende Ansichten

Wenn ein Parent-Kunde ausgewählt ist, können Abonnements, Rechnungen und Transaktionen aller zugehörigen Child-Kunden über den parentCustomer-Filter zusammen eingesehen werden. 
GET /subscriptions?parentCustomer={parentCustomerId}
GET /invoices?parentCustomer={parentCustomerId}
GET /transactions?parentCustomer={parentCustomerId}

​
Validierungsregeln

Bei der Verwaltung der Organisationsstruktur gelten folgende Regeln:
RegelBeschreibung
Maximale TiefeDie Hierarchie unterstützt maximal 3 Ebenen (Root → Child → Grandchild)
Keine ZirkelbezügeEin Kunde kann nicht sein eigener Parent sein, weder direkt noch indirekt
Gleicher MandantParent- und Child-Kunde müssen zum selben Mandanten gehören
Aktiver ParentDer Parent-Kunde darf nicht archiviert sein
ArchivierungEin Kunde mit aktiven (nicht archivierten) Child-Kunden kann nicht archiviert werden

​
Webhooks

Änderungen an der Organisationsstruktur lösen Webhook-Events aus:
EventBeschreibung
customer.parent.assignedEin Parent-Kunde wurde zugewiesen
customer.parent.removedEin Parent-Kunde wurde entfernt
Weitere Informationen zur Konfiguration von Webhooks findest du unter Webhooks.

​
Ausblick

Die Organisationsstruktur ist die Grundlage für zukünftige Abrechnungsfunktionen auf Organisationsebene. Geplant sind unter anderem:
  • Organisationsbasierte Abrechnung (Consolidated Billing): Rechnungen für Child-Kunden können an den Parent-Kunden gerichtet werden.
  • Flexible Zahlungssteuerung: Pro Child-Kunde kann festgelegt werden, wer Rechnungsempfänger und Zahlungspflichtiger ist.
  • Konsolidierungszeiträume: Rechnungen können monatlich oder quartalsweise zusammengefasst werden.