Zahlverfahren konfigurieren
Auf diese Seite gelangt man beim Anlegen eines neuen Zahlverfahrens oder beim Bearbeiten eines vorhandenen Zahlverfahrens.
Eingabefelder
Beim Anlegen eines neuen Zahlverfahrens sind die Beträge mit „0,00“ vorbelegt bzw. die Eingabefelder leer. Beim Bearbeiten eines vorhandenen Zahlverfahrens sind die Eingabefelder mit den zuvor gespeicherten Daten vorbelegt.
Die Basis-Konfiguration für die Zahlverfahren „Rechnung“ bzw. „Vorkasse“ besteht aus einem Minimal-Betrag und einem Maximal-Betrag. Die ePayBL erlaubt die Verwendung dieser Zahlverfahren nur für Beträge innerhalb des jeweils angegebenen Bereichs.
Die Zahlverfahren „Kreditkarte“, „PayPal“, „giropay“ und „Lastschrift“ können nur über einen Zahlverkehrsprovider abgewickelt werden. Bei der Konfiguration für den Zahlverkehrsprovider „Girocheckout“ kann neben der Basis-Konfiguration außerdem ein Verwendungszweck-Muster zur Identifikation der Buchungsliste angegeben werden. Darüber hinaus ist die Eingabe einer Projekt-ID und eines Projekt-Passworts sowie die Angabe über die Verwendung von Pseudokartennummern erforderlich.
Bei den Zahlverfahren „Kreditkarte“ und „Lastschrift“ muss zusätzlich angegeben werden, ob eine Reservierung und ob Pseudokartennummern verwendet werden sollen. Bei der Verwendung einer Reservierung wird dem Fachverfahren erlaubt, die Buchungen mit Reservierung anzulegen. In diesem Fall werden die Beträge eines Zahlvorgangs für einen bestimmten Zeitraum (i.d.R. 14 – 20 Tage) reserviert. Eine Belastung des Betrags erfolgt erst durch Anstoßen einer Buchung. Bei der Verwendung von Pseudokartennummern wiederum werden die Kreditkartendaten beim Zahlverkehrsprovider gespeichert.
Aktivierung
Zahlverfahren, die über einen Zahlverkehrsprovider durchgeführt werden, lassen sich in der Konfigurationsmaske über die Radio-Buttons erst dann aktivieren, wenn zuvor der zugehörige Zahlverkehrsprovider vollständig konfiguriert wurde. Ohne eine Konfiguration des Zahlverkehrsproviders sind die Radio-Buttons zur Aktivierung des Zahlverfahrens zunächst abgeschaltet (deaktiviert).
Verwendungszweck-Muster
Das Verwendungszweck-Muster wird verwendet, um die Buchungen auf den jeweiligen Kontoauszügen der Zahlverkehrsprovider wiederzufinden.
Bei der Übertragung an den Zahlverkehrsprovider stehen folgende Parameter zur Verfügung, die im Verwendungszweck-Muster als Platzhalter genutzt werden können:
| Platzhalter | Parameter |
|---|---|
| ##VERWENDUNGSZWECK## | Verwendungszweck der Buchungsliste |
| ##KASSENZEICHEN## | Kassenzeichen der Buchungsliste |
| ##ZAHLVORGANGSID## | Zahlvorgangs-ID |
| ##ZVP## | Kürzel des verwendeten Zahlverkehrsproviders |
| ##ZAHLVERFAHREN## | Name des Zahlverfahrens |
| ##MANDANT## | Mandantennummer zum Zahlvorgang |
| ##ORGEINHEIT## | Organisationseinheitennummer zum Zahlvorgang |
Außerdem können konkrete Schlüssel aus der Liste der Haushaltsparameter der Buchungsliste als Platzhalter benutzt werden (im Eingabefeld mit „##“ umrahmt), sofern sie vom Fachverfahren mitgegeben wurden.
Zwischen den Platzhaltern können beliebige Zeichen verwendet werden.
Beispiel für ein Verwendungszweck-Muster mit mitgegebenem Haushaltsparameter „hh1“:
##VERWENDUNGSZWECK##/##KASSENZEICHEN##/##ZAHLVORGANGSID##/##ZVP##/##ZAHLVERFAHREN##/##MANDANT##/##ORGEINHEIT##/##hh1##
Beim Übertragen der Buchung an den Zahlverkehrsprovider ersetzt die ePayBL die Platzhalter durch die aktuellen Werte. Platzhalter, für die kein Wert gefunden wird, werden entfernt. Insbesondere gilt dies für diejenigen Platzhalter, die Haushaltsparametern der Buchungsliste entsprechen sollen und eventuell nicht übergeben werden.
Es ist allerdings zu beachten, dass der über die Schnittstelle an den Zahlverkehrsprovider übergebene Verwendungszweck in der Regel nur eine bestimmte Länge haben kann. D.h. die ePayBL ersetzt die Platzhalter durch die aktuellen Werte und kürzt dann den resultierenden String auf die erforderliche Länge ohne weitere inhaltliche Prüfung.
Bei der Übertragung des Verwendungszwecks an den Zahlverkehrsprovider „Girocheckout“ gelten dabei folgende Längenbegrenzungen:
- für das Zahlverfahren „Kreditkarte“: Längenbegrenzung 40 Zeichen
- für das Zahlverfahren „PayPal“: Längenbegrenzung 27 Zeichen
- für das Zahlverfahren „giropay“: Längenbegrenzung 27 Zeichen
- für das Zahlverfahren „Lastschrift“: Längenbegrenzung 50 Zeichen
| Eingabefeld | Pflichtfeld | Typ | Längenbegrenzung | Format |
|---|---|---|---|---|
| Minimaler Betrag (€) | ja | Dezimal-Zahl | 4 – 12 Zeichen inklusive Komma und zwei Stellen nach dem Komma | positive Zahl mit zwei Stellen nach dem Komma |
| Maximaler Betrag (€) | ja | Dezimal-Zahl | 4 – 12 Zeichen inklusive Komma und zwei Stellen nach dem Komma | positive Zahl mit zwei Stellen nach dem Komma |
| Verwendungszweck-Muster (nur für Zahlverfahren über Provider „Girocheckout“) |
nein | String | 1 – 255 Zeichen | Beliebige Zeichen |
| Projekt-ID (nur für die Zahlverfahren „Kreditkarte“ und „Lastschrift“ über Provider „Girocheckout“) |
ja | String | 1 – 10 Zeichen | Ziffern 0 – 9 |
| Projekt-Passwort (nur für die Zahlverfahren „Kreditkarte“ und „Lastschrift“ über Provider „Girocheckout“) |
ja | String | 1 – 255 Zeichen | Beliebige Zeichen |
Buttons
Über den Button „Speichern“ werden die Eingaben validiert und das Zahlverfahren angelegt bzw. geändert. Kommt es zu Fehlern, werden diese am entsprechenden Eingabefeld angezeigt.
Wenn man auf den Button „Abbrechen“, auf das Kreuz in der rechten oberen Ecke oder außerhalb der Lightbox klickt bzw. die „Esc“-Taste betätigt, wird die Lightbox ohne zu speichern geschlossen.