finance-flow

Weg des Belegs

Wird geladen…

Noch keine Transaktion geholt — der Trichter bleibt leer.

Wartet auf dich

Was	Details
	Bexio-Ausgabe öffnen
Nichts offen — alle Händler zugeordnet, keine Stornos.

Verbindungen

Geplante Läufe

Ein Sync-Job pro gemappter Karte, plus die Belegprüfung. Takt und Mapping stehen unter bzw. .

Automatik aus Es läuft nichts von selbst — der Hauptschalter steht auf aus.

Job	Karte	Takt
		abgeschaltet

Keine Jobs — es ist noch keine Karte gemappt, also wird nichts automatisch gebucht.

Letzte Sync-Läufe

ID	Start	Auslöser	Karte	Status	Geholt	Gebucht	Fehler

Noch kein Lauf.

Revolut ID	Betrag	Währung	Beschreibung	Weg des Belegs	Nächster Schritt	Händler → Kontakt	Bexio
Keine Transaktionen für diesen Filter.
							Storno erledigt
Bexio-Abgleich nie abgeglichen Beleg

Bexio-Kontakte alles zugeordnet

Jede Transaktion soll einen Bexio-Kontakt aus ihrem Revolut-Händler tragen. Ein eindeutiger Treffer wird automatisch verknüpft, ein Händler ohne jede Ähnlichkeit automatisch angelegt — alles dazwischen landet hier.

Wie die Zuordnung entscheidet

Die Suche läuft fuzzy und möglichst grosszügig (voller Name, Namensteile, plus alle Firmenkontakte). Zur Entscheidung kommt hier vor allem der klassische Merge-Fall: zwei fast gleich gute Kandidaten — den soll kein Automat raten.

Ein Entscheid gilt danach für alle Transaktionen dieses Händlers, auch rückwirkend, und wird nie erneut gesucht. Der konfigurierte Mattermost-Admin (siehe Konfiguration) wird pro Pendenz genau einmal informiert. Die Schwellenwerte stehen unter .

Händler	Mögliche Kontakte	Entscheid
	Kein ähnlicher Kontakt gefunden — neu erstellen oder von Hand suchen.
Keine offenen Kontakt-Pendenzen.

Zugeordnete Händler

Händler	Bexio-Kontakt	Entscheid	Transaktionen

Noch nichts zugeordnet.

Stornierte Transaktionen keine offenen Stornos

Wurde eine zurückgenommene Zahlung vorher schon verbucht, bleibt die Bexio-Ausgabe bestehen — sie ist ein Buchhaltungsbeleg.

Warum nichts automatisch gelöscht wird

Revolut kann eine Zahlung nachträglich zurücknehmen (storniert, abgelehnt, fehlgeschlagen). Wie korrigiert wird (löschen, gegenbuchen, stornieren), entscheidet die Buchhaltung — in einer abgeschlossenen MWST-Periode wäre Löschen fachlich falsch. Erkannt wird das über den Webhook TransactionStateChanged und über den periodischen Sync.

War die Transaktion noch nicht verbucht, erscheint sie hier gar nicht: sie wird ab dann einfach nicht mehr gebucht. Der konfigurierte Mattermost-Admin und der Kanal werden pro Storno genau einmal informiert.

Transaktion	Karte	Revolut	Bexio-Ausgabe

Keine offenen Stornos.

Erledigte Stornos

Transaktion	Revolut	Bexio-Ausgabe	Erledigt

Noch nichts abgehakt.

Statistik

Wird geladen…

Bexio — Verbindung

Der Zugriff auf Bexio läuft über OpenID Connect: eine App im Bexio Developer Portal, einmalige Zustimmung, danach erneuert sich der Zugang von selbst. Der statische API-Token bleibt nur noch als Rückfallebene.

Status Es wird nichts gebucht, gelesen oder abgeglichen.

App (Client-ID) Keine App hinterlegt — BEXIO_CLIENT_ID und BEXIO_CLIENT_SECRET in der .env setzen und den Server neu starten.

Redirect-URI

Diese URI muss im Bexio Developer Portal zeichengenau hinterlegt sein — der IdP vergleicht sie buchstäblich. Sie zeigt nicht auf diese Instanz: die Rückleitung landet dort, wo nichts läuft, und der Code muss unten eingelöst werden.

Berechtigungen ändern sich erst mit der nächsten Zustimmung: ankreuzen, dann „Neu verbinden".

Code einlösen

Nach dem Zustimmen landet der Browser auf — die Seite kann damit nichts anfangen, das ist erwartet. Die ganze Adresse aus der Adresszeile kopieren und hier einfügen.

Bexio — Buchungsvorgaben

Grundeinstellung für jede Ausgabe. Karten- und MCC-Regeln unter überstimmen sie. Alle Felder sind optional — ohne alles entstehen Entwürfe, die in Bexio fertiggestellt werden.

Aufwandskonto Bankkonto (bezahlt ab) MWST Bexio-Benutzer (Eigentümer neuer Kontakte) Ausgaben verbuchen automatisch auf DONE setzen Aus: jede Ausgabe bleibt Entwurf (DRAFT). An: sie wird verbucht, sobald ihre Belegregel erfüllt ist — sofort bei „kein Beleg nötig", sonst erst, wenn der Beleg in Bexio hängt. Reversibel. Beleg — Grundeinstellung Beleg nötig, bevor verbucht wird Gilt, wo weder Karte noch MCC-Regel etwas anderes sagt. Aus ist nur für Gebühren ohne Vorsteuerabzug sinnvoll (ESTA/eTA). Beleg aus Revolut holen Quittung aus Revolut an die Bexio-Ausgabe hängen Läuft mit dem Beleg-Check. Die Ausgabe wird dadurch nicht verbucht — sie bleibt Entwurf, bis jemand den Beleg in Bexio angeschaut hat.

Händler → Bexio-Kontakt

Wie grosszügig der Sync einen Revolut-Händler einem bestehenden Kontakt zuordnen darf. Was er nicht eindeutig entscheiden kann, landet unter .

Kontaktgruppe für neue Kontakte Mattermost-Admin (bekommt die Pendenzen) Bekommt eine DM, sobald ein Händler keinem Kontakt eindeutig zuzuordnen ist. Unbekannte Händler automatisch als Kontakt anlegen Aus: auch ein Händler ohne jeden ähnlichen Kontakt wandert in die Pendenzliste — dann wird nichts ohne Freigabe nach Bexio geschrieben. Auto-Zuordnung ab Score (0–1) Ab hier wird ein eindeutig bester Treffer ohne Rückfrage verknüpft. Zwei fast gleich gute Kandidaten gehen trotzdem in die Pendenzliste. Zur Prüfung vorschlagen ab Score (0–1) Darunter gilt ein Kontakt als „passt nicht" und wird gar nicht erst vorgeschlagen.

Takt der Jobs

Zwei getrennte Fragen je Job: ob er automatisch läuft (Schalter) und wie oft (Minuten). Über den Takt abzuschalten geht auch — 0 oder leer —, nur ist die eingestellte Zahl danach weg; der Schalter lässt sie stehen. Leer fällt auf den Env-Vorgabewert zurück. Änderungen greifen sofort, ohne Neustart.

Automatik aus Es läuft nichts von selbst. Takte und Einzelschalter bleiben gespeichert, und Handläufe („Jetzt syncen", „Abgleich jetzt") gehen weiterhin.

Warum es einen Job pro Karte gibt

Synchronisiert wird pro gemappter Karte: jede Zeile in „Karte → Benutzer" bekommt einen eigenen Lauf im hier gesetzten Takt, damit der Bexio-Fehler einer Karte die übrigen nicht mitreisst. Eine Karte ohne Mapping wird nie automatisch gebucht — sie wird nur gespeichert und bleibt sichtbar.

Automatik geplante Läufe zulassen Der Schalter über allen dreien. Aus heisst: kein Timer läuft — unabhängig davon, was darunter steht. Karten-Sync — alle (Minuten) automatisch laufen lassen Pro gemappter Karte: Revolut → Bexio → Mattermost. Der Schalter gilt für alle Karten gemeinsam; eine einzelne stoppt man, indem man ihre Zuordnung unter „Stammdaten" entfernt. Belegprüfung — alle (Minuten) automatisch laufen lassen Prüft nur, ob zu gebuchten Ausgaben inzwischen ein Beleg in Bexio hängt — und verbucht die, die genau darauf gewartet haben. Bexio-Abgleich — alle (Minuten) automatisch laufen lassen Liest gebuchte Ausgaben aus Bexio zurück und meldet, was dort fehlt: Konto, MWST, Beleg, Titel. Schreibt nie nach Bexio. Ein Aufruf pro Ausgabe — empfohlen: 1440 (täglich). Der Handlauf-Knopf bleibt unabhängig davon.

Revolut-Webhooks

Eine signierte Zustellung ist innert Sekunden in Bexio verbucht; der periodische Sync bleibt als Sicherheitsnetz an. Der Signing Secret wird hier automatisch gespeichert, wenn unten ein Webhook erstellt oder rotiert wird.

Empfänger-Endpunkt

Signing Secret

Ohne Secret wird jede Zustellung abgewiesen (503) und aus Webhooks nichts gebucht. Unten einen Webhook erstellen (speichert automatisch) oder ein bestehendes einfügen:

Signing Secret — wird nur dieses eine Mal angezeigt.

für

URL	Events

Letzte Zustellungen

Empfangen	Event	Transaktion	Status	Detail

Noch keine Zustellung empfangen.

Karte → Benutzer

Jedes Mapping ist zugleich ein Sync-Job. Eine Karte zu mappen startet sie im Takt aus der , das Mapping zu entfernen stoppt sie. Nur gemappte Karten werden je nach Bexio gebucht.

Was ein Mapping sonst noch entscheidet

Der Bexio-Benutzer wird Eigentümer der Ausgabe, der Mattermost-Benutzer bekommt eine DM über seine Transaktionen. Beides ist optional.

Eine Karte, die nur eine Sorte Zahlung macht (die eVisa-Karte), kann zusätzlich ein Aufwandskonto festnageln — das überstimmt die MCC-Regel.

Die Verwendung sagt, wofür die Karte da ist. Spesenkarte heisst Belegtracking: die Bexio-Ausgabe bleibt Entwurf, bis der Beleg dort hängt, danach wird sie automatisch verbucht. Geschäftsbezogen heisst: die Ausgabe läuft über die MCC-Regel auf ihr Konto, der automatische Titel genügt, und sie wird ohne Beleg sofort verbucht. Ist die Verwendung gesetzt, entscheidet sie allein — die Belegregel der MCC-Zeile wird dann nicht mehr gefragt. Bei gemischt genutzten Karten „nicht gesetzt" lassen.

Karte	Label	Bexio-Benutzer	Mattermost	Aufwandskonto	Verwendung	Aktion

Noch kein Mapping — es wird nichts synchronisiert.

MCC → Konto, MWST, Beleg

Eine Regel pro Revolut-Händlerkategorie (MCC/„NCC"). Sie entscheidet Aufwandskonto, MWST-Behandlung und Belegpflicht in einem — leer heisst jeweils „Grundeinstellung aus der Konfiguration".

Warum MWST und Beleg an der Regel hängen

Ein einziger globaler MWST-Satz kann nicht stimmen: Gebühren ausländischer Behörden (Visa/ESTA) tragen gar keine Vorsteuer, Inlandreisen 8.1 % Vorsteuer, Hotels den Sondersatz 3.8 %, ausländische digitale Dienste unterliegen der Bezugsteuer.

Dieselbe Regel entscheidet die Belegpflicht: ESTA/eTA/Visa haben nie einen zweiten Beleg und keinen Vorsteuerabzug — sie werden direkt verbucht. Spesen (Uber, Hotel, Restaurant) tragen Vorsteuer, die es nur mit Beleg gibt: sie bleiben Entwurf, bis der Beleg in Bexio hängt, und werden dann automatisch verbucht.

MCC	Konto	MWST	Beleg	Label	Aktion

Noch keine Regel.