> ## 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.

# Workflows

> So verarbeitet der KI-Assistent komplexe Anfragen Schritt für Schritt – am Beispiel von Zahlungen, Transaktionen und Belegen.

Der KI-Assistent nutzt für bestimmte Fragestellungen fest definierte **Workflows** – mehrstufige Abläufe, die im Code verankert sind und automatisch die richtigen Daten in der richtigen Reihenfolge abrufen. Du stellst eine Frage, und der Assistent liefert ein vollständiges Ergebnis.

***

## Letzte Zahlung eines Kunden

Wenn du fragst, wann ein Kunde zuletzt bezahlt hat, nutzt der Assistent den **Letzte-Zahlung-Workflow**. Dieser sucht direkt nach der letzten Zahlungstransaktion – nicht nach Belegen.

<Info>
  Der Workflow sucht immer zuerst die **Transaktion** (die tatsächliche Zahlung), nicht den Beleg. Die Beleginformationen werden automatisch aus der Transaktion abgeleitet.
</Info>

### Beispiel-Anfragen

| Anfrage                                        | Kontext                                                |
| ---------------------------------------------- | ------------------------------------------------------ |
| "Was ist die letzte Zahlung von D26-00100030?" | Von jeder Seite aus                                    |
| "Wann hat der Kunde zuletzt bezahlt?"          | Auf der Kundendetailseite                              |
| "Letzte Zahlung?"                              | Auf der Kundendetailseite (Seitenkontext wird genutzt) |
| "Wann hat Kunde Müller zuletzt bezahlt?"       | Von jeder Seite aus (Kunde wird per Name gesucht)      |

### Ablauf

<Steps>
  <Step title="Kunde ermitteln">
    Der Assistent ermittelt den Kunden. Auf einer **Kundendetailseite** wird der Seitenkontext verwendet – keine zusätzliche Suche nötig. Von anderen Seiten aus sucht er per Kundennummer oder Name. Bei mehreren Treffern zeigt er eine **Auswahlkarte** an.
  </Step>

  <Step title="Letzte Transaktion abrufen">
    Der Assistent ruft die **letzte Zahlungstransaktion** des Kunden ab. Das Ergebnis enthält: Status, Zahlungsmethode, Gateway (z.B. Stripe, SEPA), Betrag, Datum und den verknüpften Beleg.
  </Step>

  <Step title="Ergebnis anzeigen">
    Das Ergebnis wird als Transaktionskarte angezeigt – mit direkten Links zum Beleg und zur Transaktionsübersicht.
  </Step>
</Steps>

### Szenarien

<AccordionGroup>
  <Accordion title="Erfolgreiche Zahlung" icon="circle-check" defaultOpen>
    Die letzte Transaktion hat den Status **Erfasst** (captured) oder **Gebucht** (booked).

    Der Assistent zeigt:

    * Zahlungsdatum und Betrag
    * Zahlungsmethode und Gateway (z.B. "SEPA-Lastschrift via GoCardless")
    * Verknüpfter Beleg (z.B. "RE-2025-0042")

    **Beispiel-Antwort:**

    > "Die letzte Zahlung von Kevin Szymura war am 03.02.2026 über 149,90 € per SEPA-Lastschrift (GoCardless). Der verknüpfte Beleg ist RE-2026-0015."
  </Accordion>

  <Accordion title="Fehlgeschlagene oder ausstehende Zahlung" icon="triangle-exclamation">
    Die letzte Transaktion hat einen **nicht-erfolgreichen Status** (z.B. `failed`, `pending`, `cancelled`).

    Der Assistent zeigt dann **zwei Informationen**:

    1. **Die letzte Transaktion** mit ihrem Status (z.B. "Fehlgeschlagen"), Datum, Betrag und verknüpftem Beleg
    2. **Die letzte erfolgreiche Zahlung** als Zusatzinfo – damit du weißt, wann die letzte *tatsächliche* Zahlung stattfand

    **Beispiel-Antwort:**

    > "Der letzte Zahlungsversuch von Kevin Szymura am 10.02.2026 über 149,90 € ist fehlgeschlagen (Beleg RE-2026-0018). Die letzte erfolgreiche Zahlung war am 03.01.2026 über 149,90 € per SEPA-Lastschrift."

    <Warning>
      Wenn es **keine einzige erfolgreiche Zahlung** gibt, meldet der Assistent das ebenfalls – z.B. "Es gibt keine erfolgreichen Zahlungen für diesen Kunden."
    </Warning>
  </Accordion>

  <Accordion title="Keine Transaktionen vorhanden" icon="circle-xmark">
    Der Kunde hat **keine Zahlungstransaktionen** (z.B. ein neuer Kunde ohne Belege).

    **Beispiel-Antwort:**

    > "Für Kevin Szymura wurden keine Zahlungstransaktionen gefunden."
  </Accordion>
</AccordionGroup>

***

## Belegzahlungen

Wenn du wissen möchtest, wie ein bestimmter Beleg bezahlt wurde, nutzt der Assistent den **Belegzahlungen-Workflow**.

### Beispiel-Anfragen

| Anfrage                                     | Kontext                  |
| ------------------------------------------- | ------------------------ |
| "Wie wurde dieser Beleg bezahlt?"           | Auf der Belegdetailseite |
| "Welche Zahlungen gibt es zu diesem Beleg?" | Auf der Belegdetailseite |
| "Wie wurde Beleg RE-2025-0042 bezahlt?"     | Von jeder Seite aus      |

### Ablauf

<Steps>
  <Step title="Beleg ermitteln">
    Auf einer **Belegdetailseite** wird der Seitenkontext verwendet. Von anderen Seiten aus sucht der Assistent den Beleg per Nummer. Bei mehreren Treffern zeigt er eine **Auswahlkarte** an.
  </Step>

  <Step title="Transaktionen abrufen">
    Der Assistent sucht alle Zahlungstransaktionen, die mit diesem Beleg verknüpft sind.
  </Step>

  <Step title="Ergebnis anzeigen">
    Alle Transaktionen werden als Liste angezeigt – jeweils mit Zahlungsmethode, Gateway, Datum, Betrag und Status.
  </Step>
</Steps>

### Szenarien

<AccordionGroup>
  <Accordion title="Beleg mit Zahlungen" icon="circle-check" defaultOpen>
    **Beispiel-Antwort:**

    > "Beleg RE-2025-0042 wurde am 15.01.2025 über 299,00 € per Kreditkarte (Stripe) bezahlt."

    Bei mehreren Teilzahlungen werden alle aufgelistet.
  </Accordion>

  <Accordion title="Beleg ohne Transaktionen" icon="circle-xmark">
    Der Beleg hat keine verknüpften Zahlungstransaktionen (z.B. ein noch unbezahlter Beleg).

    **Beispiel-Antwort:**

    > "Zu Beleg RE-2025-0042 wurden keine Zahlungstransaktionen gefunden."
  </Accordion>
</AccordionGroup>

***

## Unterschied: Letzte Zahlung vs. Zahlungen eines Belegs

|                               | Letzte Zahlung                                               | Belegzahlungen                                              |
| ----------------------------- | ------------------------------------------------------------ | ----------------------------------------------------------- |
| **Frage**                     | "Wann hat der Kunde zuletzt bezahlt?"                        | "Wie wurde dieser Beleg bezahlt?"                           |
| **Ausgangspunkt**             | Kunde                                                        | Beleg                                                       |
| **Sucht nach**                | Letzter Transaktion des Kunden                               | Allen Transaktionen eines Belegs                            |
| **Fehlgeschlagene Zahlungen** | Werden mit Hinweis auf letzte erfolgreiche Zahlung angezeigt | Alle Transaktionen werden angezeigt (inkl. fehlgeschlagene) |