| ... |
... |
@@ -2,9 +2,8 @@ |
| 2 |
2 |
|
| 3 |
3 |
{{info}} |
| 4 |
4 |
**Achtung:** |
| 5 |
|
-Mit diesem Plugin ist ein Anbindung an von der AKDB unabhängige ePayBL-Anbieter möglich. Alte AKDB spezifische Plugin-Versionen sind [[**unter diesem Link **>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/AKDB%3A%20EPayment%20plugin%20(plugin-bundle-akdb-epayment)&fileid=2674||rel="noopener noreferrer" target="_blank"]] (Anmeldung erforderlich) zu finden. |
| 6 |
|
-Formular-Elemente und Workflow-Aktionen müssen nicht neu eingerichtet werden, nach dem [[**Setup** >>url:https://help7.formcycle.de/xwiki/bin/view/Formcycle/PluginDocumentation/ePayBLEPaymentPlugin/ePayBLEPaymentSetup/]] können bestehende Formulare direkt weiter genutzt werden. |
| 7 |
|
-Bezahlvorgänge, welche im EPayment der AKDB gestartet und abgebrochen wurden, können nicht nach dem Wechsel auf dieses Plugin abgeschlossen werden. |
|
5 |
+Seit Plugin-Version {{version major="4" minor="0" patch="0"}}{{/version}} ist ein Anbindung an von der AKDB unabhängigen Anbietern möglich. Alte AKDB spezifische Plugin-Versionen sind [[**unter diesem Link **>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/AKDB%3A%20EPayment%20plugin%20(plugin-bundle-akdb-epayment)&fileid=2674||rel="noopener noreferrer" target="_blank"]] (Anmeldung erforderlich) zu finden. |
|
6 |
+Bezahlvorgänge, welche in einer früheren Version abgebrochen wurden, können nicht in der Plugin-Version {{version major="4" minor="0" patch="0"}}{{/version}} abgeschlossen werden. |
| 8 |
8 |
{{/info}} |
| 9 |
9 |
|
| 10 |
10 |
{{content/}} |
| ... |
... |
@@ -41,9 +41,9 @@ |
| 41 |
41 |
{{/figure}} |
| 42 |
42 |
|
| 43 |
43 |
Über das Formular-Element //EPayment Artikel// werden die für eine Bestell-Transaktion notwendigen Artikel definiert. |
| 44 |
|
-Das Formular-Element dient dabei zum Einen für eine visuelle Darstellung des Artikels (mit Bild, Beschreibung, Preisangabe, Eingabemöglichkeit für Bestellmenge) innerhalb eines Formulars, als auch als Vorlage für die Erstellung einer konkreten Bestellposition zum Zeitpunkt der Ausführung einer Bezahl-Transaktion. |
|
43 |
+Das Formular-Element dient dabei zum Einen für eine visuelle Darstellung des Artikels (mit Bild, Beschreibung, Preisangabe, Eingabemöglichkeit für Bestellmenge) innerhalb eines Formulars, als auch als Vorlage für die Erstellung einer konkreten Bestellposition zum Zeitpunkt der Ausführung einer Bezahl-Transaktion. |
| 45 |
45 |
|
| 46 |
|
-Bestellpositionen können auch direkt in der Workflow-Aktion definiert werden. |
|
45 |
+Ab Plugin-Version {{version major="3" minor="3" patch="0"}}{{/version}} können Bestellpositionen auch direkt in der Workflow-Aktion definiert werden. |
| 47 |
47 |
Dadurch muss kein //EPayment Artikel// zwingend im Formular vorhanden sein. Bei Konfiguration der Workflow-Aktion **[[Bestellung übermitteln>>doc:||anchor="plugin_epay_init"]]** wird geprüft, dass mindestens ein //EPayment Artikel// im Formular oder eine Bestellposition direkt in der Workflow-Aktion vorhanden ist. |
| 48 |
48 |
|
| 49 |
49 |
__Grundeigenschaften:__ |
| ... |
... |
@@ -163,10 +163,6 @@ |
| 163 |
163 |
; Telefon |
| 164 |
164 |
; Mobiltelefon |
| 165 |
165 |
|
| 166 |
|
-{{info}} |
| 167 |
|
-Aktuell muss die Eingabe der E-Mail dem Pattern **//^[a-zA-Z0-9_\.+\-]+@[a-zA-Z0-9\-]+\.[a-zA-Z0-9\-\.]+$//** entsprechen. Die Datentyp Reglementierung der EPayment Vorlage erlaubt auch Umlaute und Sonderzeichen, so dass es zu einem Fehler vor Start des Bezahlvorgangs kommen kann. |
| 168 |
|
-{{/info}} |
| 169 |
|
- |
| 170 |
170 |
{{/panel}} |
| 171 |
171 |
|
| 172 |
172 |
{{id name="config_paypage"/}} |
| ... |
... |
@@ -185,8 +185,6 @@ |
| 185 |
185 |
: Der konfigurierte Wert muss sich in ein gültiges Datum umwandeln lassen. Wenn an dieser Stelle ein Wert hinterlegt ist, wird dieser als Fälligkeitszeitpunkt für die Zahlung übermittelt und die globale Einstellung für den **Fälligkeitszeitraum** wird nicht beachtet. |
| 186 |
186 |
; Buchungstext auf PayPage |
| 187 |
187 |
: Der hier festgelegte Buchungstext wird dem Benutzer auf der PayPage angezeigt. |
| 188 |
|
-; Server für die Rücksprungadresse |
| 189 |
|
-: Der Standardwert ist ein Platzhalter, welcher den **aktuellen** Server zurück gibt. **Aktuell** richtet sich hier nach dem Zeitpunkt und Ort der Ausführung der "Bestellung übermitteln" Aktion. Falls die Aktion auf dem Master-Server ausgeführt (z.B.: im Postfach) wird, jedoch das Formular auf einem Frontend-Server ausgeliefert wird, muss dieser Frontend-Server hier ausgewählt werden. Ansonsten wird nach Abschluss der Bezahlung zurück auf den Master-Server geleitet, welcher möglicherweise nicht erreichbar ist für den/die Antragssteller*in. |
| 190 |
190 |
{{/panel}} |
| 191 |
191 |
|
| 192 |
192 |
{{panel title="Definition zusätzlicher Bestellpositionen" fullwidth="true" triggerable="true"}} |
| ... |
... |
@@ -199,15 +199,8 @@ |
| 199 |
199 |
: Definiert die für die Bestellposition geltende Anzahl. Der hier definierte Wert muss zur Laufzeit einer Zahl größer 0 entsprechen, damit die Bestellposition mit in die aktuelle Bestellung einbezogen wird. Die Anzahl dient weiterhin zur Berechnung des Gesamtpreises der Bestellposition innerhalb der Bestellung |
| 200 |
200 |
; Buchungstext |
| 201 |
201 |
: Der hier definierte Text wird als Buchungstext übermittelt. Er darf nur aus SEPA-konformen Zeichen bestehen und maximal 21 Zeichen lang sein. Der Text kann dabei auch aus Platzhaltern stammen. Er wird, wenn dies notwendig ist, automatisch auf 21 Zeichen eingekürzt. |
| 202 |
|
-; Netto-Preis (in Euro) |
| 203 |
|
-: Der (Einzel)Netto-Preis für die Bestellposition. Der an dieser Stelle konfigurierten Wert muss sich in eine kommaseparierte Zahl umwandeln lassen und dient zur Berechnung der Gesamtsumme für die Bestellposition. (Berechnung: Gesamtpreis = Anzahl x Preis) |
| 204 |
|
-; Steuersatz in % |
| 205 |
|
-: Der anzuwendende Steuersatz ist frei wählbar und wird mit den oben genannten Netto-Preis verrechnet zum endgültigen Brutto-Preis. |
| 206 |
|
- |
| 207 |
|
-{{info}} |
| 208 |
|
-Falls bereits Bestellpositionen im **AKDB: EPayment-Plugin** konfiguriert wurden, wird der Steuersatz auf 0% gesetzt. Somit ist initial Netto-Preis = Brutto-Preis. |
| 209 |
|
-{{/info}} |
| 210 |
|
- |
|
195 |
+; Preis (in Euro) |
|
196 |
+: Der (Einzel)Preis für die Bestellposition. Der an dieser Stelle konfigurierten Wert muss sich in eine kommaseparierte Zahl umwandeln lassen und dient zur Berechnung der Gesamtsumme für die Bestellposition. (Berechnung: Gesamtpreis = Anzahl x Preis) |
| 211 |
211 |
; Beschreibung |
| 212 |
212 |
: Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePayBL weiter gegeben. |
| 213 |
213 |
; Belegnummer |
| ... |
... |
@@ -223,12 +223,12 @@ |
| 223 |
223 |
Konfiguration ePayBL EPayment-Mandant |
| 224 |
224 |
{{/figure}} |
| 225 |
225 |
|
| 226 |
|
-In diesem Bereich können die globalen Einstellungen für den zu verwendenden ePayBL Mandanten übersteuert werden. Die Einstellungen zum ePayBL Mandanten sind notwendig, um später die Transaktion auf Seiten von ePayBL der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), dem Bewirtschafter und der Haushaltsstelle zuzuordnen. |
| 227 |
|
-Diese Einstellungen wurden möglicherweise bereits durch einen Xima® Formcycle-Administrator und/oder Mandant-Administrator global hinterlegt. Entsprechende Werte werden als Platzhalter angezeigt. |
|
212 |
+In diesem Bereich können die globalen Einstellungen für den zu verwendenden ePayBL Mandanten übersteuert werden. Die Einstellungen zum ePayBL Mandanten sind notwendig, um später die Transaktion auf Seiten von ePayBL |
|
213 |
+der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), dem Bewirtschafter und der Haushaltsstelle zuzuordnen. |
|
214 |
+In den meisten Fällen sind diese Einstellungen bereits durch einen Plugin-Administrator global hinterlegt worden, sodass an dieser Stelle keine Konfiguration notwendig ist. |
| 228 |
228 |
|
|
216 |
+Die einzelnen Parameter können per Platzhalter oder fest definiert hinterlegt werden. Weiterhin kann über den Button [[image:icon_update.png]] //Webservice Erreichbarkeit prüfen// die generelle Erreichbarkeit des EPayment Webservice geprüft werden. |
| 229 |
229 |
|
| 230 |
|
-Die einzelnen Parameter können per Platzhalter oder fest definiert hinterlegt werden. Weiterhin kann über den Button //Verbindung prüfen// die generelle Erreichbarkeit des EPayment Webservice geprüft werden. |
| 231 |
|
- |
| 232 |
232 |
; Mandant-Nummer |
| 233 |
233 |
: ePayBL-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePayBL-System vorgegeben) |
| 234 |
234 |
; Bewirtschafter-Nummer |
| ... |
... |
@@ -315,7 +315,7 @@ |
| 315 |
315 |
: Bezeichnung des Status, wie er vom ePayBL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV) |
| 316 |
316 |
; **[%$TRIGGER.paymentStatusText%]** |
| 317 |
317 |
: Eine Nachricht, die den zurück gelieferten Status näher beschreibt |
| 318 |
|
-; **[%$TRIGGER.paymentMethod%]** |
|
304 |
+; **[%$TRIGGER.paymentMethod%] {{version major="3" minor="5"}}{{/version}}** |
| 319 |
319 |
: Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren |
| 320 |
320 |
|
| 321 |
321 |
{{id name="plugin_event_epay_error"/}} |
| ... |
... |
@@ -346,9 +346,9 @@ |
| 346 |
346 |
: Eine Nachricht, die den zurückgelieferten Status näher beschreibt |
| 347 |
347 |
; **[%$TRIGGER.paypageUrl%]** |
| 348 |
348 |
: URL zur Paypage mit der aktuellen Transaktionsnummer. Damit ist ein nochmaliges Aufrufen und Bezahlen der offenen Transaktion möglich. |
| 349 |
|
-; **[%$TRIGGER.paymentMethod%]** |
|
335 |
+; **[%$TRIGGER.paymentMethod%]** {{version major="3" minor="5"}}{{/version}} |
| 350 |
350 |
: Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren |
| 351 |
|
-; **[%$TRIGGER.paymentVerifyUrl%]** |
|
337 |
+; **[%$TRIGGER.paymentVerifyUrl%] {{version major="3" minor="5"}}{{/version}}** |
| 352 |
352 |
: URL zum erneuten Prüfen des Bezahlstatus. Ein Aufruf der URL löst im Anschluss, an die Überprüfung des aktuellen Bezahlstatus, die entsprechenden Workflow-Ereignisse aus |
| 353 |
353 |
|
| 354 |
354 |
== 3. Ergebnisanzeige == |
| ... |
... |
@@ -364,3 +364,15 @@ |
| 364 |
364 |
Die durch das Plugin bereitgestellten HTML-Templates können bearbeitet werden. Änderungen haben dabei auf alle Formulare mit Bezahl-Workflow Auswirkungen, wenn Sie diese Standard-Templates nutzen. |
| 365 |
365 |
Möchte man in einem einzelnen Bezahl-Workflow ein eigenes Abschluss-Seiten Template verwenden, so kann man dies über eine Aktion //HTML-Abschlussseite// in der jeweiligen Verarbeitungskette realisieren. |
| 366 |
366 |
{{/info}} |
|
353 |
+ |
|
354 |
+== Versionshistorie == |
|
355 |
+ |
|
356 |
+=== 4.0.0 === |
|
357 |
+ |
|
358 |
+**//Re-Release des AKDB: ePayment Plugins als ePayBL: ePayment//** |
|
359 |
+ |
|
360 |
+* Wechsel von der SOAP Schnittstelle zu REST. Dadurch ist immer ein Zertifikat und Passwort notwendig sowie die Angabe der Zahlverfahren. |
|
361 |
+* Umstellung von AKDB spezifischer ePayBL Umgebung zu einer freien Festlegung der anzubindenden Umgebung. |
|
362 |
+* Umbennung aller Vorkommnisse von AKDB zu ePayBL. |
|
363 |
+* Umstellung auf System-Plugin. |
|
364 |
+* Überarbeitung der Konfigurationsoberfläche. |
