Wie kann ich Cura mit CashCtrl verknüpfen?

Die Schnittstelle zu CashCtrl ermöglicht die automatische Übermittlung von Spenden aus Cura. Die Spenden werden als Buchung im CashCtrl-Journal erfasst. Es werden keine Personendaten übermittelt.

Folgende Daten werden dabei an CashCtrl übertragen:

Cura CashCtrl
ID Referenz / Beleg
Beschreibung Beschreibung
Betrag Betrag
Konto Soll
Kampagne Ertragskonto Haben
Kampagne Kostenstelle (optional) Kostenstelle (optional)

Voraussetzungen

Für die Einrichtung der Schnittstelle benötigen Sie:

  • die Aktivierung der CashCtrl-Schnittstelle in Cura (kontaktieren Sie hierzu den Support)
  • einen API-Benutzer in CashCtrl (mind. "CashCtrl PRO" erforderlich)
  • eine Rolle für den API-Benutzer
  • den API-Key des API-Benutzers

API-Benutzer in CashCtrl erstellen

Gehen Sie in CashCtrl wie folgt vor:

  • Erstellen Sie eine neue Rolle für den API-Benutzer
  • Setzen Sie in dieser Rolle die erforderlichen Berechtigungen (z. B. Recht "Journal" > "Alle" oder nach Bedarf):
  • Erstellen Sie einen API-Benutzer und weisen Sie ihm diese Rolle zu:
  • Kopieren Sie nun den API-Key in die Zwischenablage

Schnittstelle in Cura verknüpfen

Gehen Sie in Cura wie folgt vor:

  • Fügen Sie Ihre CashCtrl Subdomain und den zuvor kopierten, 32-stelligen API-Key ein.
    Aktivieren Sie zudem die Synchronisation:

CashCtrl-Konten mit Cura abgleichen

Cura ist nun mit CashCtrl verknüpft. Holen Sie jetzt per Knopfdruck die Konten und Kostenstellen aus CashCtrl ab und machen Sie diese in Cura bekannt.

Führen Sie hierzu einfach die folgende Aktion aus. Alles weitere übernimmt Cura für Sie im Hintergrund:

Konten zuordnen

Nachdem Cura nun die Konten aus CashCtrl kennt, bestimmen Sie die Zuordnung zwischen Cura und CashCtrl. Rufen Sie hierzu das Modul "Konten" im Dropdown-Menü unter "Administration" auf:


Für jedes Cura-Konto können Sie definieren, welchem Konto in CashCtrl es zugeordnet werden soll. Wird eine Zuordnung gesetzt, werden Spenden, die auf diesem Cura-Konto eingehen (z. B. CH11...), künftig im Hintergrund automatisch an CashCtrl übermittelt. Dort wird dann das zugeordnete Sollkonto verwendet (z. B. "1020 Bank"):


Das Habenkonto in CashCtrl wird wiederum über das Ertragskonto der mit der Spende verknüpften Cura-Kampagne bestimmt (z. B. "3000"). Optional kann auch eine Kostenstelle in der Kampagne definiert und somit an CashCtrl übermittelt werden. Hierzu bearbeiten Sie die "erweiterten Einstellungen" der Kampagne:

Übermittlung von Spenden an CashCtrl

Wird nach erfolgter Zuordnung der Konten eine Spende erfasst, übermittelt Cura diese Daten sofort und im Hintergrund an CashCtrl. Dies geschieht automatisch.

Beispiel einer Cura Spende. Das Konto "CH11..." wurde zuvor dem CashCtrl-Konto "1020 Bank" zugeordnet. Die verknüpfte Kampagne hat das Ertragskonto "3000":


Die Spende erscheint anschliessend als kontierte Buchung im Journal von CashCtrl:


In Cura kann die Übermittlung im Kommentarverlauf der Spende nachvollzogen werden:

Wichtige Hinweise

Die Schnittstelle ist unidirektional: Das bedeutet, dass die Daten von Cura an CashCtrl übermittelt werden. Es erfolgt keine Übertragung von CashCtrl zurück nach Cura.

Eine Spende wird von Cura nur einmal an CashCtrl übermittelt. Bei einer nachträglichen Änderung in Cura, muss die Anpassung bei Bedarf direkt auf der Buchung in CashCtrl selbst vorgenommen werden.

Es werden ausschliesslich die für die Journalbuchung benötigten Daten übertragen. Personen- und Adressdaten etc. werden nicht an CashCtrl übermittelt.

Fehler bei der Übermittlung

Kann eine Spende nicht an CashCtrl übermittelt werden, wird der Fehler in Cura im "Postfach" angezeigt. Dort kann die Ursache der fehlgeschlagenen Übermittlung geprüft und behoben werden. Beispiel:

Fehlerbehebung

Bei Problemen sollten insbesondere folgende Punkte geprüft werden:

  • Sind der API-Schlüssel und die Subdomain aus CashCtrl korrekt in Cura hinterlegt?
  • Ist die Synchronisation in Cura aktiviert?
  • Verfügt der API-Benutzer in CashCtrl über die erforderliche Rolle bzw. Berechtigungen?
  • Wurden die Konten und Kostenstellen in Cura abgeholt?
  • Wurden die CashCtrl-Konten den gewünschten Cura-Konten zugeordnet?
  • Gibt es im "Postfach" eine Fehlermeldung?

Konnte Ihr Problem nicht behoben werden oder haben Sie Feedbacks zur Funktionsweise, Wünsche oder Ideen?
Kontaktieren Sie gerne unseren Support.