So verbindest du CashCtrl
- Lege in CashCtrl einen API-Benutzer an: Zahnrad oben rechts, Einstellungen, Benutzer & Rollen. Der Knopf zum Hinzufügen lädt eine Person per Mail ein; den API-Benutzer gibt es über den kleinen Pfeil daneben. Wähle die Rolle Treuhänder oder Administrator, vorgewählt ist Gast. Eine eigene Rolle ist nicht erprobt; sie bräuchte Konten, Währungen, Steuercodes, Rechnungsperioden und die Einstellungen der Organisation zum Lesen, das Journal zum Lesen, Erstellen und Bearbeiten, dazu Dateien.
- CashCtrl zeigt den Schlüssel nur einmal, im Fenster «API Key»: Kopiere ihn gleich. Ist das Fenster zu, legst du den API-Benutzer neu an.
- Öffne «Integrationen» und wähle die Kachel CashCtrl. Trage die Adresse der Organisation ein, wie CashCtrl sie nach der Anmeldung in der Adresszeile zeigt, ohne den Teil ab «/#». Dazu den Schlüssel; Finapse speichert ihn verschlüsselt.
- Bestätige in «Bereit für den Export» die Organisation (Finapse nennt sie bei ihrer Adresse) und dass CashCtrl keine eigenen Bankbewegungen einliest: Ein Kontoauszug-Import dort, und alles steht doppelt.
- Importiere Kontenplan und MwSt-Codes aus CashCtrl (Kontenplan und MwSt-Codes importieren) und ordne unter «Geldkonten» jedem Geldkonto sein Bilanzkonto zu, etwa 1020 Bank.
Steckt in der Organisation schon echte Buchhaltung und willst du zuerst testen, kopiere sie in CashCtrl unter Einstellungen, Organisationen. Die Kopie hat ihre eigene Adresse und braucht ihren eigenen API-Benutzer. Eine neue Organisation mit leerem Journal braucht keine Kopie.
Was in CashCtrl stimmen muss
Finapse prüft vor jeder Buchung, ob CashCtrl sie so bucht, wie Finapse sie schickt. Sonst bleibt die Zeile unter «Gebucht», und die Meldung nennt den Grund. Die Einstellungen dazu stehen in CashCtrl unter Einstellungen:
- Hauptwährung CHF, unter «Währungen»: Die Währung ohne Kurs ist die Hauptwährung.
- Das Geschäftsjahr der Buchung offen und ihr Monat nicht abgeschlossen, unter «Rechnungsperioden».
- Ein Bankkonto in Fremdwährung in derselben Währung, im Kontenplan von CashCtrl; die Währung selbst unter «Währungen».
- Die MwSt-Methode gleich wie in Finapse (effektiv, Saldosteuersatz oder Pauschalsteuersatz), unter «Steuercodes» mit dem Knopf für die Abrechnungsmethode. In Finapse steht sie unter «Mehrwertsteuer». Finapse prüft vor jeder Buchung mit MwSt-Code, ob beide im Jahr der Buchung auf der effektiven Methode stehen oder beide auf einer ohne Vorsteuerabzug; eine Zeile ohne MwSt-Code geht unter jeder Methode nach CashCtrl. Saldo- und Pauschalsteuersatz unterscheidet die Prüfung nicht: Achte selbst darauf, dass in CashCtrl derselbe gewählt ist wie in Finapse.
Finapse schickt den Bruttobetrag und den Code; Satz und Konto stehen in CashCtrl beim Steuercode. Weicht der Satz am Buchungstag ab oder würde die Regel des Codes die MwSt auf ein anderes Konto legen, bei einer Rückzahlung auf einer Anlage etwa auf die Bank, bleibt die Zeile ebenfalls draussen.
Nach dem Export
- Lade das Journal in CashCtrl neu: Neue Buchungen zeigt es erst dann. Jede trägt im Feld Referenz «finapse-…», der Beleg hängt als Anhang daran. Eine aufgeteilte Buchung steht dort als Sammelbuchung mit «Diverse Konten».
- In Fremdwährung steht die Bank darin einmal pro Position, nicht einmal mit der Summe. Nur so geht die Buchung auch in Franken auf: CashCtrl rundet die Franken jeder Position für sich. Die Franken der Bank können darum um wenige Rappen vom Betrag unter «In Franken» abweichen; die Bewertung am Jahresende gleicht das aus.
- Reichst du einen Beleg nach, bekommt CashCtrl ihn mit dem nächsten Export, oder sofort unter «Integrationen» mit «Belege nachliefern».
- Bricht ein Export ab, schreibt der nächste die Buchungen, die schon in CashCtrl stehen, nicht nochmals.
- Eine Buchung zurücknehmen: Lösche sie zuerst in CashCtrl, dann «Export zurücksetzen» mit dem Kästchen. Kreuzt du es an, ohne zu löschen, steht sie nach dem nächsten Export doppelt.
Gut zu wissen
- Eine Buchung in Fremdwährung, etwa EUR oder USD, geht mit dem Kurs, den Finapse an der Buchung unter «In Franken» zeigt: dem Monatsmittel der ESTV, bei einer Rechnung in Franken, vom Konto in Fremdwährung bezahlt, dem Kurs aus ihrem Frankenbetrag (Fremdwährungen); CashCtrl rechnet daraus die Franken. Draussen bleiben ein Übertrag in Fremdwährung und eine Zeile ohne Kurs, etwa mit mehreren Belegen in einer anderen Währung: Buche sie in CashCtrl von Hand und markiere sie mit «Schon im Buchhaltungssystem».
- Eine Bezugsteuer und eine Minus-Position mit MwSt-Code lässt der Export aus und nennt sie. Buche sie in CashCtrl von Hand und markiere sie mit «Schon im Buchhaltungssystem».
- CashCtrl führt eine MwSt-Methode für alle Jahre. Hat die Firma zwischen der effektiven Methode und dem Saldo- oder Pauschalsteuersatz gewechselt, bleiben die Zeilen des früheren Jahrs mit MwSt-Code draussen: Buche sie in CashCtrl von Hand und markiere sie mit «Schon im Buchhaltungssystem».
- Hat ein Konto in CashCtrl einen Steuercode voreingestellt, übernimmt ihn der Import als Standard-Code, und Finapse schlägt ihn auf diesem Konto vor. CashCtrl selbst setzt ihn bei einer Buchung ohne Code nicht ein. Entfernst du ihn in CashCtrl, entferne ihn auch in Finapse unter «Kontenplan»: Der Import nimmt ihn nicht weg.
- Ein Schlüssel gilt nur für seine Organisation. Einen neuen bekommst du, indem du den API-Benutzer neu anlegst; trage ihn mit «API-Schlüssel ersetzen» ein. Die Zuordnungen bleiben, die Organisation bestätigst du nochmals.
Von der Kopie zur echten Organisation
- Lösche die Testbuchungen in der Kopie und nimm sie mit «Export zurücksetzen» zurück. Sonst gehen sie nie in die echte Organisation: Finapse führt sie weiter als exportiert.
- Klicke auf «Trennen». «API-Schlüssel ersetzen» reicht nicht: Ein Schlüssel gilt nur für seine Organisation.
- Lege in der echten Organisation einen API-Benutzer an und verbinde ihre Adresse.
- Bestätige die Liste nochmals und importiere Kontenplan und MwSt-Codes neu: Zuordnungen gelten pro Organisation.
Diese Seite beantwortet
- Wie verbinde ich CashCtrl?
- Wo bekomme ich in CashCtrl den API-Schlüssel?
- Warum sehe ich die exportierten Buchungen in CashCtrl nicht?
- Wie kommt ein nachgereichter Beleg nach CashCtrl?