# FinAPI: Verbinden Sie Ihre Bank und zahlen Sie von diesem Konto

Verbinden Sie eine Bank in den FinAPI-Einstellungen, synchronisieren Sie Transaktionen in Banking und autorisieren Sie SEPA-Zahlungen vom ausgewählten Konto.

Verbinden Sie eine deutsche Bank über **FinAPI**, importieren Sie ihre Transaktionen in **Banking** und autorisieren Sie SEPA-Zahlungen von dem von Ihnen ausgewählten Konto.

**Für wen dies gedacht ist:** Finanzadministratoren, die Lieferanten von einem verbundenen Bankkonto bezahlen und diese Transaktionen zur Abstimmung in Banking haben möchten.

FinAPI muss für den Workspace aktiviert sein, und die Zahlungsabwicklung muss aktiviert sein. Wenn die Integration fehlt, wenden Sie sich an den Cortena-Support.

## 1. Eine Bank verbinden

1. Öffnen Sie **Settings → Integrations → FinAPI treasury**.
2. Wählen Sie unter **Sync bank transactions from** das früheste Buchungsdatum aus, ab dem Transaktionen importiert werden sollen. Lassen Sie das Feld leer, um den standardmäßigen Rückblick zu verwenden, der bei der ersten Synchronisierung 90 Tage beträgt. Legen Sie dies fest, bevor Sie die Verbindung herstellen.
3. Klicken Sie auf **Connect bank**. Cortena öffnet ein sicheres FinAPI-Fenster, in dem Sie sich bei Ihrer Bank anmelden können.
4. Sobald die Verbindung hergestellt ist, wird die Bank unter **Bank connections** angezeigt.

Cortena erstellt die FinAPI-Verbindung für Sie, sobald Sie eine Bank verbinden oder eine Synchronisierung starten. Sie müssen keinen separaten Aktivierungsschritt durchführen.

Wenn Sie das Startdatum der Synchronisierung auf einen früheren Tag ändern, werden bei der nächsten Synchronisierung ältere Transaktionen nachgeladen.

## 2. Transaktionen in Banking synchronisieren

Die Synchronisierung von Banktransaktionen ist standardmäßig aktiviert.

1. Klicken Sie auf derselben FinAPI-Einstellungsseite auf **Sync now**.
2. Beobachten Sie **Bank sync in progress**. Zuerst werden die Konten synchronisiert, danach die Transaktionen. Die Konten werden in **Banking** angezeigt, sobald sie bereit sind. Sie müssen nicht auf den vollständigen Import warten.
3. Öffnen Sie **Banking**, um die importierten Transaktionen zu prüfen. Bankzeilen zeigen das Logo des Instituts an, wenn FinAPI eines bereitstellt.

Die geplante Synchronisierung hält Banking nach dem ersten Durchlauf auf dem aktuellen Stand. **Sync now** dient zur sofortigen Aktualisierung.

Tabellenkalkulationsbanken verwenden einen separaten Ablauf. Siehe [Banken und Datenaustausch](https://help.cortena.ai/guides/integrations/banks-data-exchange).

## 3. Das Zahlungskonto auswählen

Zahlungen werden von einem verbundenen Bankkonto und nicht von einer manuell eingegebenen IBAN gesendet.

1. Öffnen Sie weiterhin in **FinAPI treasury** den Bereich **Payment account** und wählen Sie das Konto aus, von dem die Zahlung erfolgen soll.
2. Speichern Sie, falls die Seite Sie dazu auffordert.

Solange kein Konto ausgewählt ist, sendet Cortena keine Zahlungen. Der Hinweis lautet **Connect a bank account before sending payments** oder **Select which connected account to pay from**.

Einige Workspaces können stattdessen die IBAN unter **Settings → Legal profile** verwenden (eigenständige Zahlungen). Diese Option ist deaktiviert, sofern Cortena sie nicht für den Workspace aktiviert hat. In der Regel wird das oben beschriebene Zahlungskonto verwendet.

## 4. Eine Zahlung autorisieren

1. Senden Sie bei einer zahlbaren Rechnung die Rechnung zur Zahlung. Sie wird einem Zahlungsstapel hinzugefügt.
2. Öffnen Sie **Payments**.
3. Klicken Sie beim Stapel auf **Authorize payment**. FinAPI öffnet ein Web Form, damit eine autorisierte Person bei der Bank die SEPA-Zahlung genehmigen kann.
4. Nachdem die Bank die Zahlung akzeptiert hat, wechselt der Stapel zu **Authorized and completed**.

Embat- und Agicap-Stapel auf derselben Seite werden beim Senden exportiert. FinAPI-Stapel bleiben hier, bis jemand sie autorisiert.

Verwenden Sie für **International**-FinAPI-Stapel (nicht SEPA) **Download pain XML** anstelle des Web Forms. Siehe [SEPA- und internationale Zahlungsstapel](https://help.cortena.ai/guides/integrations/sepa-international-payments).

Verwandt: [Embat Treasury](https://help.cortena.ai/guides/integrations/embat-treasury).

## 5. Wenn die Autorisierung nicht abgeschlossen wird

Wenn die betreffende Person das Bankfenster schließt oder die Bank das Formular ablehnt, bleibt der Stapel unter **Action required** in **Payments**.

| Anzeige | Vorgehensweise |
| --- | --- |
| **Rejected by user** | Die unterzeichnende Person hat das FinAPI-Fenster abgebrochen. Klicken Sie auf **Retry authorization**. Cortena öffnet ein neues Fenster. Der alte Link wird nicht erneut verwendet. |
| **Payment authorization expired** | Das Fenster ist abgelaufen. Klicken Sie auf **Retry authorization**. |
| **Payment authorization failed** | Die Bank hat eine Zahlung nicht bestätigt. Klicken Sie auf **Retry authorization**. |

Die Rückkehr zu Cortena über eine Browserweiterleitung mit dem Status „completed“ reicht allein nicht aus. Der Stapel verlässt die Warteschlange erst, nachdem FinAPI die Zahlung bestätigt hat.

## 6. Verbindung trennen

- **Disconnect** bei einer Bankverbindung entfernt diese Bank. Sie können sie später erneut verbinden.
- Wenn Sie die Verbindung zur **letzten** FinAPI-Bank trennen, wird die FinAPI-Verbindung für den Workspace gelöscht. Beim nächsten **Connect bank** oder **Sync now** wird sie erneut eingerichtet.
- **Disconnect FinAPI** entfernt die Verbindung, ohne auf die Entfernung der letzten Bank zu warten. In der Bestätigung wird angegeben, dass sie beim nächsten Verbinden einer Bank, bei der nächsten Synchronisierung oder bei der nächsten Zahlung erneut erstellt wird.

Konten einer getrennten Bank werden beim Abgleich und bei Zahlungsvorschlägen ignoriert.

## Kurzübersicht

| Aufgabe | Ort |
| --- | --- |
| Festlegen, wie weit zurück importiert werden soll | **Settings → Integrations → FinAPI treasury** → **Sync bank transactions from** |
| Eine Bank verbinden | **Connect bank** |
| Jetzt importieren | **Sync now** |
| Das zahlende Konto auswählen | **Payment account** |
| Einen SEPA-Stapel genehmigen | **Payments** → **Authorize payment** |
| Nach einem Abbruch erneut versuchen | **Retry authorization** |