OM-Integration

Die OM-Integration überträgt deine Spenden automatisch an OM, die CRM-Software von Creativ Software. Jede bezahlte Spende kommt mit der spendenden Person, der OM-Kampagne und der Zahlung in OM an, ohne Export und Import von Hand.

📍

Voraussetzung: Die OM-Integration ist ein optionales Modul. Kontaktiere den Soulclick-Support für die Aktivierung. Die Zugangsdaten zur OM REST Web-API erhältst du von Creativ Software.

📍

Navigation: Admin → OM - CRM


Überblick

DatenRichtungBeschreibung
EinzelspendenSoulclick → OMSpende mit Betrag, Datum, Sprache und OM-Kampagne, dazu die Zahlung
DauerspendenSoulclick → OMDie erste Zahlung als Spendenzusage mit Intervall, jede weitere Belastung als eigene Zahlung
Multi-CheckoutSoulclick → OMEine Spende über den Gesamtbetrag, aufgeteilt auf die OM-Kampagnen der Positionen
Spendende PersonSoulclick → OMAnrede, Name, E-Mail, Adresse und Firma
ValutadatumSoulclick → OMAm nächsten Wochentag (Mo–Fr), nachdem dein Zahlungsanbieter die Zahlung ausbezahlt hat
KampagnenOM → SoulclickDie Liste deiner OM-Kampagnen, damit du sie zuordnen kannst

Aus OM liest Soulclick nur die Kampagnen. Kontakte und Spenden fliessen nie zurück.


So funktioniert die Synchronisation

  1. Einreihen: Sobald eine Spende bezahlt ist, reiht Soulclick sie für OM ein. Spenden per QR-Rechnung gelten als bezahlt, sobald die Rechnung erstellt ist.
  2. Übermitteln: Alle 15 Minuten sendet Soulclick die eingereihten Spenden an OM und gibt sie dort frei.
  3. Folgezahlungen: Jede erfolgreiche Belastung einer Dauerspende geht als eigene Zahlung an OM, sobald die Spendenzusage in OM freigegeben ist.
  4. Valutadatum: Am nächsten Wochentag (Mo–Fr), nachdem dein Zahlungsanbieter eine Zahlung ausbezahlt hat, ergänzt Soulclick sie in OM um das Auszahlungsdatum als Valutadatum. Erst dann bucht OM die Zahlung.

Spenden, die vor der Aktivierung bezahlt wurden, überträgt Soulclick nicht nachträglich.

⚠️

Solange die OM-Integration aktiv ist, bietet der Checkout Dauerspenden nur mit Online-Zahlung an, nicht per QR-Rechnung. Einmalige Spenden per QR-Rechnung bleiben möglich.


Einrichtung

Schritt 1: Zugangsdaten hinterlegen

  1. Öffne OM - CRM → Zuordnungen & Einstellungen → Einstellungen.
  2. Trage die Zugangsdaten von Creativ Software ein und speichere.
FeldBeschreibung
OM Basis-URLVollständige URL der OM REST Web-API, z. B. https://om.example.ch/api
BenutzernameDer API-Benutzer von Creativ Software
PasswortDas Passwort zum API-Benutzer

Beim Speichern prüft Soulclick die Verbindung zu OM. Lehnt OM die Zugangsdaten ab, wird nichts gespeichert und du siehst die Antwort von OM. Solange keine Zugangsdaten gespeichert sind, zeigt der Verbindungsstatus «Nicht verbunden», und Kampagnen und Zuordnungen sind ausgegraut.

Schritt 2: Kampagnen laden

Unter Kampagnen siehst du alle Kampagnen aus OM mit Nummer (Fremd-ID), Bezeichnung, Gültig ab und Gültig bis. Ist die Liste älter als 10 Minuten, aktualisiert sie sich beim Öffnen. Mit Jetzt aktualisieren lädst du sie sofort neu, etwa nachdem du in OM eine Kampagne angelegt hast.

Kampagnen, die OM nicht mehr liefert, setzt Soulclick auf inaktiv. Gelöscht wird nichts.

Schritt 3: Kampagnen zuordnen

Jede Spende braucht in OM eine Kampagne. Du legst deshalb für jede Spendenaktion fest, zu welcher OM-Kampagne ihre Spenden gehören. Dafür gibt es zwei Wege.

An der Spendenaktion oder am Kampagnen-Link: Wähle im Abschnitt OM die OM Kampagne. Ein Kampagnen-Link hat je ein Feld für einmalige und wiederkehrende Spenden: OM Kampagne (einmalig) und OM Kampagne (wiederkehrend).

Unter Zuordnungen:

  1. Öffne OM - CRM → Zuordnungen & Einstellungen → Zuordnungen und klicke auf Zuordnung hinzufügen.
  2. Wähle unter Zuordnen zu eine Spendenaktion oder einen Kampagnenlink und wähle ihn aus.
  3. Wähle die OM Kampagne und speichere.

Dabei gilt:

  • Jede Spendenaktion und jeder Kampagnen-Link hat höchstens eine Zuordnung.
  • Zur Auswahl stehen nur aktive OM-Kampagnen, deren Gültig bis nicht abgelaufen ist.
  • Hat eine Spendenaktion eine eigene Zuordnung, gilt diese. Sonst gilt die Zuordnung ihres Kampagnen-Links.
  • Eine Standard-Kampagne gibt es nicht. Eine Spende ohne OM-Kampagne überträgt Soulclick nicht: Sie steht unter Spendenübermittlungen als fehlgeschlagen, bis du die Kampagne zuordnest und sie erneut sendest.

Übertragene Daten

Spende

DatenBeschreibung
BetragWas bezahlt wurde, inklusive der Gebühren, die die spendende Person übernommen hat, in der Währung der Spende. Gebühren und Nettobeträge führt OM nicht.
DatumDas Datum der Spende, nicht der Tag der Übermittlung
KampagneDie zugeordnete OM-Kampagne. Bei einem Multi-Checkout der Anteil jeder Kampagne am Gesamtbetrag.
IntervallBei Dauerspenden: monatlich, vierteljährlich, halbjährlich oder jährlich
ZahlungsartOnline-Zahlung mit Zahlungsmethode oder QR-Rechnung
SpracheDie Sprache der spendenden Person: DE, FR, IT oder EN

Spendende Person

DatenBeschreibung
AnredeHerr, Frau oder neutral
Name und E-MailVorname, Nachname und E-Mail-Adresse
AdresseStrasse, Hausnummer, PLZ, Ort, Land, Postfach und Firma. Die Adresse geht nur mit, wenn Strasse, PLZ, Ort und Land vollständig sind.

Die Telefonnummer überträgt Soulclick nicht.

Zahlungsmethoden

Bei Online-Zahlungen übermittelt Soulclick die Zahlungsmethode: Mastercard, Visa, American Express, Maestro, PostFinance Card, PostFinance E-Finance, PostFinance Pay, TWINT, PayPal, Apple Pay und Google Pay. Andere Methoden kommen in OM als unbekannt an.

Eine QR-Rechnung übermittelt Soulclick als Überweisung ohne Zahlung, denn das Geld geht direkt auf deinem Konto ein. Ist Referenznummer in QR-Rechnung verwenden? aktiv, geht die QR-Referenz mit.

Valutadatum

OM bucht eine Zahlung erst, wenn sie ein Valutadatum hat. Soulclick setzt dafür das Datum, an dem dein Zahlungsanbieter die Zahlung ausbezahlt hat, und übermittelt es am nächsten Wochentag von Montag bis Freitag, auch an Feiertagen: Eine Auszahlung vom Freitag geht am Montag an OM. Das funktioniert mit Payrexx und Stripe. Setzt deine Plattform Datatrans ein, kläre die Aktivierung vorher mit dem Soulclick-Support.

Wartet ein Geschäftsfall in OM auf einen manuellen Schritt, etwa wegen eines Konflikts, nimmt OM das Valutadatum noch nicht an. Die Übermittlung bleibt erfolgreich, zeigt aber unter Letzter Fehler die Antwort von OM mit HTTP 550. Soulclick versucht es alle zwei Stunden erneut, bis du den Fall in OM erledigt hast.


Übermittlungen prüfen

Unter OM - CRM → Spendenübermittlungen siehst du jede Spende und jede Folgezahlung mit ihrem Stand. Die Reiter trennen Einzelspenden, Dauerspenden (1. Zahlung) und Dauerspenden (Wiederhol-Zlg.). Beim Öffnen zeigt die Liste die letzten 365 Tage. Filtern kannst du nach Status und Datum.

StatusBedeutung
OffenEingereiht, geht mit dem nächsten Durchgang an OM
ÜbermitteltIn OM angelegt und freigegeben, in der Spalte Erfolgreich mit ✓
FehlgeschlagenNicht übermittelt, in der Spalte Erfolgreich mit ✗

Die Detailansicht zeigt jeden Schritt einzeln, zum Beispiel Spende übermittelt, Zahlung übermittelt, Freigegeben und Valutadatum übermittelt, dazu die Versuche und den Letzten Fehler.

Automatische Wiederholung

Ist OM nicht erreichbar oder vorübergehend ausgelastet, versucht Soulclick es bis zu fünfmal, nach 10, 30, 60 und 120 Minuten. Andere Fehler wiederholt Soulclick nicht automatisch, etwa eine fehlende OM-Kampagne oder einen Datensatz, den OM ablehnt. Technische Fehler meldet Soulclick automatisch dem Soulclick-Team.

Erneut senden

  1. Markiere die Übermittlungen in der Liste.
  2. Wähle die Aktion Ausgewählte erneut senden und klicke auf Ausführen.

Soulclick sendet sie sofort und setzt die Versuche zurück. Bereits übermittelte Einträge überspringt die Aktion. Sendest du die erste Zahlung einer Dauerspende erneut, gehen ihre offenen Folgezahlungen mit.


Fehlerbehebung

ProblemLösung
Einstellungen: «OM hat die Zugangsdaten abgelehnt»Prüfe Benutzername und Passwort. Stimmen sie, frage bei Creativ Software nach, ob der API-Benutzer aktiv ist.
Einstellungen: «OM ist nicht erreichbar»Prüfe die OM Basis-URL. Ist sie korrekt, versuche es später erneut.
Eine Kampagne fehlt in der AuswahlPrüfe in OM, ob sie aktiv ist und ihr Gültig bis nicht abgelaufen ist. Klicke danach unter Kampagnen auf Jetzt aktualisieren.
Spende fehlgeschlagen, Spalte OM Kampagne leerDie Spendenaktion hat keine OM-Kampagne. Ordne sie zu und sende die Spende mit Ausgewählte erneut senden erneut.
Zahlung in OM ohne ValutadatumDas Valutadatum folgt am nächsten Wochentag (Mo–Fr) nach der Auszahlung deines Zahlungsanbieters. Steht unter Letzter Fehler HTTP 550, wartet der Geschäftsfall in OM auf einen manuellen Schritt. Erledige ihn in OM.
Dauerspende per QR-Rechnung nicht wählbarSo vorgesehen: Solange die OM-Integration aktiv ist, gibt es Dauerspenden nur mit Online-Zahlung.
Unklare FehlermeldungKontaktiere den Soulclick-Support mit der Nr. der Übermittlung.

Did this page help you?