Änderungen von Dokument Verwendung

Von Version 53.1
bearbeitet von fse
am 10.03.2023, 10:18
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 1.4
bearbeitet von fse
am 23.12.2022, 15:02
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -2,9 +2,7 @@
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.
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.
42 +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.
44 +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:__
... ... @@ -66,7 +66,7 @@
66 66  ; Max. Bestellmenge
67 67  : Hier kann die für den Nutzer maximal auswählbare Bestellmenge für einen Artikel definiert werden.
68 68  ; Belegnummer
69 -: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePayBL dient.
67 +: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient.
70 70  
71 71  {{info}}
72 72  Bei Übermittlung einer Bestellung werden nur die Artikelnummer, sowie die jeweilige Anzahl von einem Bestellartikel, zum Server übertragen. Damit ein Artikel innerhalb einer Bestellung übermittelt wird, muss die "Bestellen"-Option angehakt sein.
... ... @@ -102,9 +102,9 @@
102 102  
103 103  Um eine Bezahl-Transaktion in einen Formularprozess einzubauen werden folgende Elemente vom Plugin zur Verfügung gestellt:
104 104  
105 -* Workflow-Aktion **[[Bestellung übermitteln>>doc:||anchor="plugin_epay_init"]]**: Diese erzeugt eine neue Bezahl-Transaktion auf Seiten des ePayBL Anbieters und leitet den Benutzer auf dessen Portalseite weiter.
106 -* Workflow-Ereignis **[[Bezahlung erfolgreich>>doc:||anchor="plugin_event_epay_success"]]**: Verarbeitet ein Ereignis, welches auf der Rückmeldung über eine erfolgreiche Bezahlung auf dem ePayBL Portal basiert.
107 -* Workflow-Ereignis **[[Bezahlung nicht erfolgreich>>doc:||anchor="plugin_event_epay_error"]]**: Verarbeitet ein Ereignis, welches auf der Rückmeldung über eine noch offene Bezahlung auf dem ePayBL Portal basiert. Dabei kann dies verschiedene Ursachen haben. Zum einen kann die Bezahlvorgang durch den Nutzer abgebrochen worden sein oder es ist zu einem Fehler im ePayBL Portal gekommen.
103 +* Workflow-Aktion **[[Bestellung übermitteln>>doc:||anchor="plugin_epay_init"]]**: Diese erzeugt eine neue Bezahl-Transaktion auf Seiten der AKDB und leitet den Benutzer auf dessen Portalseite weiter.
104 +* Workflow-Ereignis **[[Bezahlung erfolgreich>>doc:||anchor="plugin_event_epay_success"]]**: Verarbeitet ein Ereignis, welches auf der Rückmeldung über eine erfolgreiche Bezahlung auf dem ePay-BL Portal basiert.
105 +* Workflow-Ereignis **[[Bezahlung nicht erfolgreich>>doc:||anchor="plugin_event_epay_error"]]**: Verarbeitet ein Ereignis, welches auf der Rückmeldung über eine noch offene Bezahlung auf dem ePay-BL Portal basiert. Dabei kann dies verschiedene Ursachen haben. Zum einen kann die Bezahlvorgang durch den Nutzer abgebrochen worden sein oder es ist zu einem Fehler im ePay-BL Portal gekommen.
108 108  
109 109  Ein Workflow für einen einfachen Fall kann folgendermaßen konfiguriert sein:
110 110  
... ... @@ -114,13 +114,13 @@
114 114  
115 115  __Kurze Ablaufbeschreibung zum dargestellten Workflow:__
116 116  
117 -~1. Durch das Absenden des Bestellformulars wird das Ereignis //Bestellen// aufgerufen und dort das Aktions-Plugin **[[ePayBL:Bestellung übermitteln>>doc:||anchor="plugin_epay_init"]]** ausgeführt. Dieses ermittelt die für den Bestellvorgang notwendigen Daten aus dem Formular und startet eine Bezahl-Transaktion auf Seiten des ePayBL Anbieters. Wenn dies erfolgreich war, wird der Benutzer zum [[ePayBL>>https://www.epaybl.de/||rel="noopener noreferrer" target="_blank" title="E-Payment Bund und Länder"]] Portal der angebundenden Umgebung weitergeleitet.
115 +~1. Durch das Absenden des Bestellformulars wird das Ereignis //Bestellen// aufgerufen und dort das Aktions-Plugin **[[AKDB:Bestellung übermitteln>>doc:||anchor="plugin_epay_init"]]** ausgeführt. Dieses ermittelt die für den Bestellvorgang notwendigen Daten aus dem Formular und startet eine Bezahl-Transaktion auf Seiten der AKDB. Wenn dies erfolgreich war, wird der Benutzer zum [[ePay-BL>>https://www.epaybl.de/||rel="noopener noreferrer" target="_blank" title="E-Payment Bund und Länder"]] Portal der AKDB weitergeleitet.
118 118  
119 -2. Nach Abschluss des Bezahlvorgangs im ePayBL Portal wird der Benutzer wieder zu {{formcycle/}} zurückgeleitet. Dort erfolgt automatisch eine Überprüfung des Bezahlstatus am EPayment-System. Aus dem Ergebnis dieser Überprüfung ergibt sich das vom System ausgelöste Ereignis. Wenn die Überprüfung ergeben hat, dass die Bezahlung erfolgreich war, wird ein **[[Bezahlung erfolgreich>>doc:||anchor="plugin_event_epay_success"]]**-Ereignis durch das System ausgelöst. In allen anderen Fällen ist es ein **[[Bezahlung nicht erfolgreich>>doc:||anchor="plugin_event_epay_error"]]** Ereignis.
117 +2. Nach Abschluss des Bezahlvorgangs im ePay-BL Portal wird der Benutzer wieder zu {{formcycle/}} zurückgeleitet. Dort erfolgt automatisch eine Überprüfung des Bezahlstatus am EPayment-System. Aus dem Ergebnis dieser Überprüfung ergibt sich das vom System ausgelöste Ereignis. Wenn die Überprüfung ergeben hat, dass die Bezahlung erfolgreich war, wird ein **[[Bezahlung erfolgreich>>doc:||anchor="plugin_event_epay_success"]]**-Ereignis durch das System ausgelöst. In allen anderen Fällen ist es ein **[[Bezahlung nicht erfolgreich>>doc:||anchor="plugin_event_epay_error"]]** Ereignis.
120 120  
121 121  3. Ist die Bezahlung erfolgt, wird in den Status //Bezahlt// gewechselt und dem Nutzer wird eine entsprechende Abschlussseite angezeigt.
122 122  
123 -4. Im Falle eines negativen Ergebnisses der Überprüfung des Bezahlvorgangs (z.B.: der Nutzer hat den Bezahlvorgang im ePayBL Portal abgebrochen; während des Bezahlvorgangs ist ein Fehler aufgetreten), wird im vorliegenden Beispiel eine E-Mail erzeugt, in der der Benutzer auf die noch ausstehende Zahlung hingewiesen wird. Der Workflow wird in den Status //Nicht bezahlt// versetzt und dem Nutzer
121 +4. Im Falle eines negativen Ergebnisses der Überprüfung des Bezahlvorgangs (z.B.: der Nutzer hat den Bezahlvorgang im ePay-BL Portal abgebrochen; während des Bezahlvorgangs ist ein Fehler aufgetreten), wird im vorliegenden Beispiel eine E-Mail erzeugt, in der der Benutzer auf die noch ausstehende Zahlung hingewiesen wird. Der Workflow wird in den Status //Nicht bezahlt// versetzt und dem Nutzer
124 124  wird eine entsprechende Abschlussseite angezeigt.
125 125  
126 126  {{id name="plugin_epay_init"/}}
... ... @@ -127,7 +127,7 @@
127 127  
128 128  === 2.1. Konfigurationsmöglichkeiten des Aktions-Plugins //Bestellung übermitteln// ===
129 129  
130 -Dieses Aktions-Plugin ist für das Erzeugen einer Bezahl-Transaktion im [[ePayBL>>https://www.epaybl.de/||rel="noopener noreferrer" target="_blank" title="E-Payment Bund und Länder"]] Portal zuständig. Hier werden im Vorfeld die Daten, welche im Zusammenhang mit der Transaktion stehen (bestellte Artikel, Preisbestimmung, persönliche Daten des Käufers etc.), festgelegt.
128 +Dieses Aktions-Plugin ist für das Erzeugen einer Bezahl-Transaktion im [[ePay-BL>>https://www.epaybl.de/||rel="noopener noreferrer" target="_blank" title="E-Payment Bund und Länder"]] Portal zuständig. Hier werden im Vorfeld die Daten, welche im Zusammenhang mit der Transaktion stehen (bestellte Artikel, Preisbestimmung, persönliche Daten des Käufers etc.), festgelegt.
131 131  
132 132  {{info}}
133 133  Wenn vor der Konfiguration des Plugins bereits mindestens ein **[[EPayment-Artikel>>doc:||anchor="epay_artikel"]]**, sowie die **[[Vorlage>>doc:||anchor="epay_vorlage"]]** für die **persönlichen Daten** im Formular hinterlegt wurden, werden bei einer Neueinrichtung der //Bestellung übermitteln// Plugin-Aktion die notwendigen Pflicht-Konfigurationen bereits mit den ermittelten Daten aus dem Formular vorbelegt.
... ... @@ -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"/}}
... ... @@ -173,7 +173,7 @@
173 173  
174 174  {{panel title="Konfiguration für die PayPage" fullwidth="true" initial="visible" triggerable="true"}}
175 175  
176 -Bei der "PayPage" handelt es sich um eine bereits vorbefüllte Bezahlseite zur Online-Bezahlung. Der Nutzer hat hier noch die Auswahl, mit welchem Bezahl-Dienstleister er bezahlen möchte (Paypal, giropay etc.). Die Art und Anzahl der dem Nutzer zur Auswahl stehenden Bezahl-Dienstleister hängt dabei davon ab, was im Vorfeld vertraglich mit dem ePayBL Anbieter vereinbart wurde.
170 +Bei der "PayPage" handelt es sich um eine bereits vorbefüllte Bezahlseite zur Online-Bezahlung. Der Nutzer hat hier noch die Auswahl, mit welchem Bezahl-Dienstleister er bezahlen möchte (Paypal, SEPA-Lastschrift, giropay etc.). Die Art und Anzahl der dem Nutzer zur Auswahl stehenden Bezahl-Dienstleister hängt dabei davon ab, was im Vorfeld vertraglich mit der AKDB verbart wurde.
177 177  
178 178  {{figure image="plugin_init_config_paypage.png"}}
179 179  Konfiguration für die PayPage
... ... @@ -194,49 +194,42 @@
194 194  {{/figure}}
195 195  
196 196  ; Anzahl
197 -: 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
198 -; Buchungstext
191 +: 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
192 +; Buchungstext
199 199  : 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.
200 -; Netto-Preis (in Euro)
201 -: 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)
202 -; Steuersatz in %
203 -: Der anzuwendende Steuersatz ist frei wählbar und wird mit den oben genannten Netto-Preis verrechnet zum endgültigen Brutto-Preis.
204 -
205 -{{info}}
206 -Falls bereits Bestellpositionen im **AKDB: EPayment-Plugin** konfiguriert wurden, wird der Steuersatz auf 0% gesetzt. Somit ist initial Netto-Preis = Brutto-Preis.
207 -{{/info}}
208 -
194 +; Preis (in Euro)
195 +: Der (Einzel)Preis für die Bestellposition. Der an dieser Stelle konfigurierte Wert muss sich in eine kommaseparierte Zahl umwandeln lassen und dient zur Berechnung der Gesamtsumme für die Bestellposition. (Berechnung: Gesamtpreis = Anzahl x Preis)
209 209  ; Beschreibung
210 -: Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePayBL weiter gegeben.
197 +: Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePay-BL weiter gegeben.
211 211  ; Belegnummer
212 -: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePayBL dient.
199 +: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient.
213 213  
214 -Über den Button [[image:icon_add.png]] können neue Bestellpositionen hinzugefügt werden. Über den Button [[image:icon_del.png]] lässt sich die jeweilige Bestellposition wieder aus der Tabelle entfernen.
201 +Über den Button [[image:icon_add.png]] können neue Bestellpositionen hinzugefügt werden. Über den Button [[image:icon_del.png]] lässt sich die jeweilige Bestellposition wieder aus der Tabelle entfernen.
215 215  
216 216  {{/panel}}
217 217  
218 -{{panel title="Konfiguration ePayBL ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}}
205 +{{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}}
219 219  
220 -{{figure image="plugin_init_config_mandant.png"}}
221 -Konfiguration ePayBL EPayment-Mandant
207 +{{figure image="plugin_init_config_akdb_mandant.png"}}
208 +Konfiguration AKDB EPayment-Mandant
222 222  {{/figure}}
223 223  
224 -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.
225 -Diese Einstellungen wurden möglicherweise bereits durch einen Xima® Formcycle-Administrator und/oder Mandant-Administrator global hinterlegt. Entsprechende Werte werden als Platzhalter angezeigt.
211 +In diesem Bereich können die globalen Einstellungen für den zu verwendenden ePay-BL Mandanten übersteuert werden. Die Einstellungen zum ePay-BL Mandanten sind notwendig, um später die Transaktion auf Seiten von ePay-BL
212 +der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), dem Bewirtschafter und der Haushaltsstelle zuzuordnen.
213 +In den meisten Fällen sind diese Einstellungen bereits durch einen Plugin-Administrator global hinterlegt worden, sodass an dieser Stelle keine Konfiguration notwendig ist.
226 226  
215 +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.
227 227  
228 -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.
229 -
230 230  ; Mandant-Nummer
231 -: ePayBL-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePayBL-System vorgegeben)
218 +: AKDB-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePay-BL-System vorgegeben)
232 232  ; Bewirtschafter-Nummer
233 -: Bewirtschafternummer (Wird durch ePayBL-System vorgegeben)
220 +: Bewirtschafternummer (Wird durch ePay-BL-System vorgegeben)
234 234  ; Haushaltsstelle
235 -: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePayBL-System vorgegeben)
222 +: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePay-BL-System vorgegeben)
236 236  ; Objektnummer
237 -: Dient der internen Verbuchung im EPayment-System. (Wird durch ePayBL-System vorgegeben)
224 +: Dient der internen Verbuchung im EPayment-System. (Wird durch ePay-BL-System vorgegeben)
238 238  ; Kennzeichen-Mahnverfahren
239 -: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePayBL-System vorgegeben)
226 +: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePay-BL-System vorgegeben)
240 240  ; Fälligkeitszeitraum
241 241  : Einstellung für die Berechnung des Fälligkeitszeitraumes der Zahlung (Dauer in Tagen).
242 242  
... ... @@ -281,19 +281,19 @@
281 281  ; [%$[Name der Aktion].RESULT.Gesamtbetrag%]
282 282  : Der in der Zahlungstransaktion ausgewiesene zu zahlende Geldbetrag. Angabe in Euro
283 283  ; [%$[Name der Aktion].RESULT.Kassenzeichen%]
284 -: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePayBL Portal geführt wird.
271 +: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePay-BL Portal geführt wird.
285 285  ; [%$[Name der Aktion].RESULT.UrlToPaypage%]
286 -: Die URL zur Bezahlseite auf Seiten von ePayBL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann.
273 +: Die URL zur Bezahlseite auf Seiten von ePay-BL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann.
287 287  
288 288  __Fehlercodes__
289 289  
290 290  ; NO_ORDER_DATA
291 -: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte.
278 +: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte.
292 292  ; SRV_NOT_AVIALABLE
293 -: Fehlercode, wenn der ePayBL Service nicht verfügbar ist.
280 +: Fehlercode, wenn der ePay-BL Service nicht verfügbar ist.
294 294  ; SRV_METHOD_ERROR
295 -: Fehlercode, wenn eine ePayBL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das
296 -{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
282 +: Fehlercode, wenn eine ePay-BL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das
283 +{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
297 297  ; INTERNAL_ERROR
298 298  : Fehlercode für einen nicht nähere beschriebenen Fehler. Bei Auftreten von solchen Fehlertypen sollte das
299 299  {{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
... ... @@ -305,15 +305,15 @@
305 305  Workflow-Ereignis bei erfolgreicher Bezahlung
306 306  {{/figure}}
307 307  
308 -Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePayBL Portal erfolgt
295 +Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt
309 309  und die Bezahlung erfolgreich durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis genau einmal eintreten.
310 310  Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können:
311 311  
312 312  ; **[%$TRIGGER.paymentStatus%]**
313 -: Bezeichnung des Status, wie er vom ePayBL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV)
300 +: Bezeichnung des Status, wie er vom ePay-BL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV)
314 314  ; **[%$TRIGGER.paymentStatusText%]**
315 315  : Eine Nachricht, die den zurück gelieferten Status näher beschreibt
316 -; **[%$TRIGGER.paymentMethod%]**
303 +; **[%$TRIGGER.paymentMethod%] {{version major="3" minor="5"}}{{/version}}**
317 317  : Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren
318 318  
319 319  {{id name="plugin_event_epay_error"/}}
... ... @@ -324,14 +324,14 @@
324 324  Workflow-Ereignis bei nicht erfolgreicher Bezahlung
325 325  {{/figure}}
326 326  
327 -Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePayBL Portal erfolgte
328 -und die Bezahlung nicht durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis mehrfach eintreten (Bei Fehlern im ePayBL Portal oder bei Abbruch des Bezahlvorgangs durch den Nutzer).
314 +Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte
315 +und die Bezahlung nicht durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis mehrfach eintreten (Bei Fehlern im ePay-BL Portal oder bei Abbruch des Bezahlvorgangs durch den Nutzer).
329 329  Das Ereignis stellt folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können:
330 330  
331 331  ; **[%$TRIGGER.paymentStatus%]**
332 -: Bezeichnung des Status, wie er vom ePayBL Portal zurückgeliefert wird.
319 +: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird.
333 333  : Folgende Werte sind möglich:
334 -: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt (z.B. weil der Nutzer den Bezahlvorgang auf Seiten von ePayBL abgebrochen hat).
321 +: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt (z.B. weil der Nutzer den Bezahlvorgang auf Seiten von ePay-BL abgebrochen hat).
335 335  : **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden.
336 336  : **MANDANT_INAKTIV**: Der Mandant ist im ePayment-System derzeit als inaktiv gekennzeichnet.
337 337  : **VERBINDUNG_OHNE_HTTPS**: Die Verbindung zum Webservice erfolgte nicht über HTTPS mit Client-Zertifikaten.
... ... @@ -344,9 +344,9 @@
344 344  : Eine Nachricht, die den zurückgelieferten Status näher beschreibt
345 345  ; **[%$TRIGGER.paypageUrl%]**
346 346  : URL zur Paypage mit der aktuellen Transaktionsnummer. Damit ist ein nochmaliges Aufrufen und Bezahlen der offenen Transaktion möglich.
347 -; **[%$TRIGGER.paymentMethod%]**
334 +; **[%$TRIGGER.paymentMethod%]** {{version major="3" minor="5"}}{{/version}}
348 348  : Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren
349 -; **[%$TRIGGER.paymentVerifyUrl%]**
336 +; **[%$TRIGGER.paymentVerifyUrl%] {{version major="3" minor="5"}}{{/version}}**
350 350  : 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
351 351  
352 352  == 3. Ergebnisanzeige ==
... ... @@ -354,9 +354,9 @@
354 354  Die Anzeige des Ergebnisses bzw. des Status einer Bezahl-Transaktion erfolgt standardmäßig mittels einer extra Abschluss-Seite.
355 355  Dafür stellt das Plugin 3 HTML-Templates bereit:
356 356  
357 -* **ePayBL ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung.
358 -* **ePayBL ePayment Bezahlung Fehler**: Standard-Template für Anzeige bei offenen bzw. fehlerhaft beendeten Bezahlvorgang. Dieser Template enthält Platzhalter für Anzeige des konkreten Fehlers und einen Link zum Wiederaufruf des noch ausstehenden Bezahlvorgangs.
359 -* **ePayBL ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen.
344 +* **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung.
345 +* **AKDB ePayment Bezahlung Fehler**: Standard-Template für Anzeige bei offenen bzw. fehlerhaft beendeten Bezahlvorgang. Dieser Template enthält Platzhalter für Anzeige des konkreten Fehlers und einen Link zum Wiederaufruf des noch ausstehenden Bezahlvorgangs.
346 +* **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen.
360 360  
361 361  {{info}}
362 362  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.
... ... @@ -363,3 +363,87 @@
363 363  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.
364 364  {{/info}}
365 365  
353 +== Versionshistorie ==
354 +
355 +=== 3.6.0 ===
356 +
357 +* Erweiterung AKDB ePay Setup: Konfigurationsmöglichkeit für Proxy-Server-Einstellungen
358 +* Platzhalter für Payment Verify-Url: Mit dem Platzhalter [%$PAYMENT_VERIFY_URL%] kann Status-übergreifend auf den URL zum nochmaligen Prüfen des Status einer Bezahltransaktion zugegriffen werden.
359 +
360 +=== 3.5.1 ===
361 +
362 +* Fehlerbehebung: Im Zusammenspiel mit der {{formcycle/}} Version {{version major="7" patch="10"}}{{/version}} konnten Zertifikatsdateien nicht über das AKDB ePay Setup hochgeladen werden. Dieser Fehler wurde behoben.
363 +
364 +=== 3.5.0 ===
365 +
366 +* Erweiterungen: EPayment-Verifikation-Aktion (V6) um 'Zahlverfahren' erweitert.
367 +Trigger (Workflow V7) um genutztes 'Zahlverfahren' innerhalb der Rückgabewerte erweitert.
368 +Error-Trigger (Workflow V7) um 'PaymentVerifyUrl' erweitert. Dieser Parameter kann zum nochmaligen Aufruf der Verifizierung einer Bezahlung genutzt werden.
369 +* Erweiterung AKDB ePay Setup: Eingabemöglichkeit für Daten des anzubindenden ePayment-Mandanten; Zusätzlicher Hinweis auf freizugebende URLs (notwendige Firewall-Freigaben)
370 +
371 +=== 3.4.3 ===
372 +
373 +* Fehlerbehebung bei Rückleitung von der PayPage zum Formular: In einigen Fällen, insbesondere bei Kommunikation über den Frontend-Server, kam es zu Störungen beim Auslösen der nachgelagerten Workflow-Verarbeitung. Dies wurde behoben.
374 +
375 +=== 3.4.2 ===
376 +
377 +* Fehlerbehebung: ein Anzeige-Fehler bei der Berechnung des Gesamtpreises für einen EPayment-Bestellartikel wurde behoben
378 +* Fehlerbehebung: Aufgrund von Fehlern beim Decodieren und Entschlüsseln von URL-Parametern, wurde die Verschlüsselungs-Routine angepasst.
379 +
380 +=== 3.4.1 ===
381 +
382 +* Fehlerbehebung EPayment Bestellartikel: Die Werte der widget-internen HTML-Elemente sind bei einer Zwischenspeicherung nicht berücksichtigt worden. Dies wurde behoben.
383 +
384 +=== 3.4.0 ===
385 +
386 +* Erweiterung AKDB ePay Setup: Ein Verbindungstest ist jetzt auch ohne Konfiguration eines AKDB-Mandanten möglich.
387 +* Anpassung EPayment Bestellartikel: HTML-Elemente innerhalb des Widgets um 'data-' Präfix erweitert
388 +* Fehlerbehebung: Session-Replacer werden bei Verarbeitung der Workflow-Ereignisse berücksichtigt. 
389 +
390 +=== 3.3.1 ===
391 +
392 +* Fehlerbehebung: Mehrfache Anfragen auf den gleichen Vorgang bei Rückleitung vom ePay-BL-Portal werden jetzt vom System abgelehnt, solange der aktuell angefragte Vorgang sich in Verarbeitung befindet.
393 +
394 +=== 3.3.0 ===
395 +
396 +* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}}
397 +* Erweiterung Workflow-Aktion //Bestellung übermitteln//: Möglichkeit für serverseitige Definition von Bestellpositionen
398 +* Einführung AKDB ePay Setup: Je nach Umgebung (Test oder Live) werden die korrekten URL's zum WS-Endpoint und zur PayPage hinterlegt. Weiterhin kann das Zertifikat für die Anbindung des ePay-Live Systems hinterlegt werden.
399 +
400 +=== 3.2.0 ===
401 +
402 +* Erweiterung EPayment Bestellartikel: Am Element ist der Gesamtpreis (Anzahl * Einzelpreis) als verstecktes Element verfügbar. Dieser kann über die CSS-Klasse 'CXOrderItemTotalPrice' eingeblendet werden.
403 +* Erweiterung Anzahl-Eingabe-Element am EPayment Bestellartikel: Bei einer direkten Werteingabe wird diese sofort gegen die definierte untere und obere Wertgrenze validiert.
404 +
405 +=== 3.1.4 ===
406 +
407 +* Formatierung des Rückgabewertes für den Gesamtbetrag auf #0,00 €
408 +
409 +=== 3.1.3 ===
410 +
411 +* Fehlerbehebung: Es wurden Problem behoben, welche beim Öffnen von EPayment-Formularen im Designe aufgetreten sind.
412 +
413 +=== 3.1.2 ===
414 +
415 +* Neuer Pluginparameter *epayment.webservice.timeout* zum Konfigurieren des Timeouts zum Webservice in Sekunden.
416 +
417 +=== 3.1.1 ===
418 +
419 +* Fehlerbehebung: Bei EPayment-Artikel Objekt werden bei fehlenden Werten, Defaultwerte angenommen.
420 +
421 +=== 3.1.0 ===
422 +
423 +* Neue Eigenschaften am EPayment-Artikel Objekte hinzugefügt:
424 +** Pflicht-Artikel: Ein Artikel kann als Pflicht definiert werden und wird dadurch automatisch der Bestellung hinzugefügt, egal ob dieser durch Manipulation vor dem Absenden aus der Bestellung entfernt wurde
425 +** Maximale Bestellmenge: Die durch den Nutzer maximal auswählbare Bestellmenge lässt sich begrenzen
426 +
427 +=== 3.0.1 ===
428 +
429 +* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="1"}}{{/version}}
430 +** Anpassungen der Validierungen im Designer für EPayment-Artikel Objekte
431 +
432 +=== 3.0.0 ===
433 +
434 +* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="0"}}{{/version}}
435 +** Neue Workflow-Aktion für Initialisierung der Bezahl-Transaktion
436 +** Einführung Ereignisse für Absenden der Bestellung, sowie Verifizierung der erfolgreichen / nicht erfolgreichen Bezahltransaktion
hilfe_epay_artikel_form.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -148.2 KB
Inhalt
hilfe_epay_vorlagen_form.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -139.2 KB
Inhalt
hilfe_workflow.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -40.8 KB
Inhalt
icon_add.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -384 bytes
Inhalt
icon_del.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -307 bytes
Inhalt
icon_update.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -410 bytes
Inhalt
plugin_init_config_bestellposition.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -22.6 KB
Inhalt
plugin_init_config_kundenstammdaten.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -25.6 KB
Inhalt
plugin_init_config_mandant.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -28.6 KB
Inhalt
plugin_init_config_paypage.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -10.1 KB
Inhalt
plugin_init_result.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -95.8 KB
Inhalt
trigger_error.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -58.3 KB
Inhalt
trigger_success.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.fse
Größe
... ... @@ -1,1 +1,0 @@
1 -54.7 KB
Inhalt