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.
Überblick
| Daten | Richtung | Beschreibung |
|---|---|---|
| Einzelspenden | Soulclick → OM | Spende mit Betrag, Datum, Sprache und OM-Kampagne, dazu die Zahlung |
| Dauerspenden | Soulclick → OM | Die erste Zahlung als Spendenzusage mit Intervall, jede weitere Belastung als eigene Zahlung |
| Multi-Checkout | Soulclick → OM | Eine Spende über den Gesamtbetrag, aufgeteilt auf die OM-Kampagnen der Positionen |
| Spendende Person | Soulclick → OM | Anrede, Name, E-Mail, Adresse und Firma |
| Valutadatum | Soulclick → OM | Am nächsten Wochentag (Mo–Fr), nachdem dein Zahlungsanbieter die Zahlung ausbezahlt hat |
| Kampagnen | OM → Soulclick | Die 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
- 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.
- Übermitteln: Alle 15 Minuten sendet Soulclick die eingereihten Spenden an OM und gibt sie dort frei.
- Folgezahlungen: Jede erfolgreiche Belastung einer Dauerspende geht als eigene Zahlung an OM, sobald die Spendenzusage in OM freigegeben ist.
- 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
- Öffne OM - CRM → Zuordnungen & Einstellungen → Einstellungen.
- Trage die Zugangsdaten von Creativ Software ein und speichere.
| Feld | Beschreibung |
|---|---|
| OM Basis-URL | Vollständige URL der OM REST Web-API, z. B. https://om.example.ch/api |
| Benutzername | Der API-Benutzer von Creativ Software |
| Passwort | Das 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:
- Öffne OM - CRM → Zuordnungen & Einstellungen → Zuordnungen und klicke auf Zuordnung hinzufügen.
- Wähle unter Zuordnen zu eine Spendenaktion oder einen Kampagnenlink und wähle ihn aus.
- 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
| Daten | Beschreibung |
|---|---|
| Betrag | Was 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. |
| Datum | Das Datum der Spende, nicht der Tag der Übermittlung |
| Kampagne | Die zugeordnete OM-Kampagne. Bei einem Multi-Checkout der Anteil jeder Kampagne am Gesamtbetrag. |
| Intervall | Bei Dauerspenden: monatlich, vierteljährlich, halbjährlich oder jährlich |
| Zahlungsart | Online-Zahlung mit Zahlungsmethode oder QR-Rechnung |
| Sprache | Die Sprache der spendenden Person: DE, FR, IT oder EN |
Spendende Person
| Daten | Beschreibung |
|---|---|
| Anrede | Herr, Frau oder neutral |
| Name und E-Mail | Vorname, Nachname und E-Mail-Adresse |
| Adresse | Strasse, 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.
| Status | Bedeutung |
|---|---|
| Offen | Eingereiht, geht mit dem nächsten Durchgang an OM |
| Übermittelt | In OM angelegt und freigegeben, in der Spalte Erfolgreich mit ✓ |
| Fehlgeschlagen | Nicht ü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
- Markiere die Übermittlungen in der Liste.
- 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
| Problem | Lö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 Auswahl | Prü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 leer | Die Spendenaktion hat keine OM-Kampagne. Ordne sie zu und sende die Spende mit Ausgewählte erneut senden erneut. |
| Zahlung in OM ohne Valutadatum | Das 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ählbar | So vorgesehen: Solange die OM-Integration aktiv ist, gibt es Dauerspenden nur mit Online-Zahlung. |
| Unklare Fehlermeldung | Kontaktiere den Soulclick-Support mit der Nr. der Übermittlung. |
Updated 7 days ago
