Bridge — Docs

Die Bridge ist ein kleiner Windows-Dienst, der einen Ordner überwacht, neue CAMT.053-Dateien verschlüsselt und hochlädt. Sie ist der einzige Teil von Yupana, der bei euch läuft.

Was sie tut — und was nicht

Sie liest nur den konfigurierten Ordner.
Sie baut ausgehende HTTPS-Verbindungen auf. Es gibt keinen eingehenden Port und keinen Fernzugriff.
Sie verschlüsselt jede Datei vor dem Versand (libsodium), zusätzlich zur Transportverschlüsselung.
Sie kann keine Überweisung auslösen und hat keine Bankzugangsdaten.

Installation

Installationspaket ausführen (yupana-bridge-setup.msi). Es installiert nach C:\Program Files\Yupana\Bridge und registriert den Dienst YupanaBridge.
yupana-bridge.yaml in C:\ProgramData\Yupana\Bridge anlegen — die Vorlage liegt daneben.
Dienst starten: yupana-bridge.exe install und yupana-bridge.exe start, oder über die Dienste-Verwaltung.
Prüfen: yupana-bridge.exe status.

StarMoney Business einrichten

Der Export liegt nicht im normalen Umsatz-Dialog, sondern in der Automatisierung:

Automatisieren → Neue Automatisierung → Umsatzexport
Format CAMT.053.001.08, Zeichensatz UTF-8
Zielordner: derselbe wie incoming_dir in der Konfiguration
Zeitplan: täglich, nach dem Abholen der Umsätze

Wichtig: Alle Konten einzeln anlegen — Kontokorrent, Tagesgeld, Kreditkarte. Fehlt ein Konto, fehlt es in der Auswertung, ohne dass das auffällt.

Fehlersuche

Symptom	Ursache	Abhilfe
Keine neuen Buchungen	Dienst gestoppt	`yupana-bridge.exe status`, dann `start`
Dateien bleiben liegen	Ordner falsch konfiguriert	Pfad in `yupana-bridge.yaml` gegen den StarMoney-Zielordner prüfen
Upload schlägt fehl	Ausgehendes HTTPS blockiert	`api.yupana.de:443` in der Firewall freigeben
Doppelte Buchungen	Dieselbe Datei zweimal exportiert	Kein Eingriff nötig — Yupana erkennt Duplikate über einen Fingerabdruck je Buchung

Das Protokoll liegt in C:\ProgramData\Yupana\Bridge\bridge.log.

Updates

Neue Versionen werden über das Installationspaket eingespielt; die Konfiguration bleibt erhalten. Solange die Bridge steht, bleiben die Dateien im Ordner liegen und werden danach nachgeholt — es geht nichts verloren.