Änderungen von Dokument Verwendung


Von Version 46.1
bearbeitet von fse
am 17.02.2023, 11:18
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 17.1
bearbeitet von fse
am 15.02.2023, 14:24
Änderungskommentar: Neues Bild hilfe_epay_artikel_form.png hochladen

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -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 -Bezahlvorgänge, welche in einer früheren Version abgebrochen wurden, können nicht nach dem Wechsel auf dieses Plugin abgeschlossen werden.
7 -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.
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:__
... ... @@ -193,15 +193,8 @@
193 193  : 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
194 194  ; Buchungstext
195 195  : 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.
196 -; Netto-Preis (in Euro)
197 -: 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)
198 -; Steuersatz in %
199 -: Der anzuwendende Steuersatz ist frei wählbar und wird mit den oben genannten Netto-Preis verrechnet zum endgültigen Brutto-Preis.
200 -
201 -{{info}}
202 -Falls bereits Bestellpositionen im **AKDB: EPayment-Plugin** konfiguriert wurden, wird der Steuersatz auf 0% gesetzt. Somit ist initial Netto-Preis = Brutto-Preis.
203 -{{/info}}
204 -
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)
205 205  ; Beschreibung
206 206  : Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePayBL weiter gegeben.
207 207  ; Belegnummer
... ... @@ -213,16 +213,16 @@
213 213  
214 214  {{panel title="Konfiguration ePayBL ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}}
215 215  
216 -{{figure image="plugin_init_config_mandant.png"}}
208 +{{figure image="plugin_init_config_akdb_mandant.png"}}
217 217  Konfiguration ePayBL EPayment-Mandant
218 218  {{/figure}}
219 219  
220 -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.
221 -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.
222 222  
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.
223 223  
224 -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.
225 -
226 226  ; Mandant-Nummer
227 227  : ePayBL-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePayBL-System vorgegeben)
228 228  ; Bewirtschafter-Nummer
... ... @@ -309,7 +309,7 @@
309 309  : Bezeichnung des Status, wie er vom ePayBL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV)
310 310  ; **[%$TRIGGER.paymentStatusText%]**
311 311  : Eine Nachricht, die den zurück gelieferten Status näher beschreibt
312 -; **[%$TRIGGER.paymentMethod%]**
304 +; **[%$TRIGGER.paymentMethod%] {{version major="3" minor="5"}}{{/version}}**
313 313  : Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren
314 314  
315 315  {{id name="plugin_event_epay_error"/}}
... ... @@ -340,9 +340,9 @@
340 340  : Eine Nachricht, die den zurückgelieferten Status näher beschreibt
341 341  ; **[%$TRIGGER.paypageUrl%]**
342 342  : URL zur Paypage mit der aktuellen Transaktionsnummer. Damit ist ein nochmaliges Aufrufen und Bezahlen der offenen Transaktion möglich.
343 -; **[%$TRIGGER.paymentMethod%]**
335 +; **[%$TRIGGER.paymentMethod%]** {{version major="3" minor="5"}}{{/version}}
344 344  : Parameter gibt Auskunft über das in der Bezahl-Transaktion angewendete Zahlverfahren
345 -; **[%$TRIGGER.paymentVerifyUrl%]**
337 +; **[%$TRIGGER.paymentVerifyUrl%] {{version major="3" minor="5"}}{{/version}}**
346 346  : 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
347 347  
348 348  == 3. Ergebnisanzeige ==
... ... @@ -363,11 +363,89 @@
363 363  
364 364  === 4.0.0 ===
365 365  
366 -**//Re-Release des AKDB: ePayment Plugins als ePayBL: ePayment//**
367 -
368 368  * Wechsel von der SOAP Schnittstelle zu REST. Dadurch ist immer ein Zertifikat und Passwort notwendig sowie die Angabe der Zahlverfahren.
369 369  * Umstellung von AKDB spezifischer ePayBL Umgebung zu einer freien Festlegung der anzubindenden Umgebung.
370 370  * Umbennung aller Vorkommnisse von AKDB zu ePayBL.
371 -* Umstellung auf System-Plugin.
372 -* Überarbeitung der Konfigurationsoberfläche.
373 -* Bestelloptionen um Steuersatz erweitert.
361 +
362 +=== 3.6.0 ===
363 +
364 +* Erweiterung AKDB ePay Setup: Konfigurationsmöglichkeit für Proxy-Server-Einstellungen
365 +* 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.
366 +
367 +=== 3.5.1 ===
368 +
369 +* 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.
370 +
371 +=== 3.5.0 ===
372 +
373 +* Erweiterungen: EPayment-Verifikation-Aktion (V6) um 'Zahlverfahren' erweitert.
374 +Trigger (Workflow V7) um genutztes 'Zahlverfahren' innerhalb der Rückgabewerte erweitert.
375 +Error-Trigger (Workflow V7) um 'PaymentVerifyUrl' erweitert. Dieser Parameter kann zum nochmaligen Aufruf der Verifizierung einer Bezahlung genutzt werden.
376 +* Erweiterung AKDB ePay Setup: Eingabemöglichkeit für Daten des anzubindenden ePayment-Mandanten; Zusätzlicher Hinweis auf freizugebende URLs (notwendige Firewall-Freigaben)
377 +
378 +=== 3.4.3 ===
379 +
380 +* 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.
381 +
382 +=== 3.4.2 ===
383 +
384 +* Fehlerbehebung: ein Anzeige-Fehler bei der Berechnung des Gesamtpreises für einen EPayment-Bestellartikel wurde behoben
385 +* Fehlerbehebung: Aufgrund von Fehlern beim Decodieren und Entschlüsseln von URL-Parametern, wurde die Verschlüsselungs-Routine angepasst.
386 +
387 +=== 3.4.1 ===
388 +
389 +* Fehlerbehebung EPayment Bestellartikel: Die Werte der widget-internen HTML-Elemente sind bei einer Zwischenspeicherung nicht berücksichtigt worden. Dies wurde behoben.
390 +
391 +=== 3.4.0 ===
392 +
393 +* Erweiterung AKDB ePay Setup: Ein Verbindungstest ist jetzt auch ohne Konfiguration eines AKDB-Mandanten möglich.
394 +* Anpassung EPayment Bestellartikel: HTML-Elemente innerhalb des Widgets um 'data-' Präfix erweitert
395 +* Fehlerbehebung: Session-Replacer werden bei Verarbeitung der Workflow-Ereignisse berücksichtigt. 
396 +
397 +=== 3.3.1 ===
398 +
399 +* 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.
400 +
401 +=== 3.3.0 ===
402 +
403 +* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}}
404 +* Erweiterung Workflow-Aktion //Bestellung übermitteln//: Möglichkeit für serverseitige Definition von Bestellpositionen
405 +* 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.
406 +
407 +=== 3.2.0 ===
408 +
409 +* Erweiterung EPayment Bestellartikel: Am Element ist der Gesamtpreis (Anzahl * Einzelpreis) als verstecktes Element verfügbar. Dieser kann über die CSS-Klasse 'CXOrderItemTotalPrice' eingeblendet werden.
410 +* Erweiterung Anzahl-Eingabe-Element am EPayment Bestellartikel: Bei einer direkten Werteingabe wird diese sofort gegen die definierte untere und obere Wertgrenze validiert.
411 +
412 +=== 3.1.4 ===
413 +
414 +* Formatierung des Rückgabewertes für den Gesamtbetrag auf #0,00 €
415 +
416 +=== 3.1.3 ===
417 +
418 +* Fehlerbehebung: Es wurden Problem behoben, welche beim Öffnen von EPayment-Formularen im Designe aufgetreten sind.
419 +
420 +=== 3.1.2 ===
421 +
422 +* Neuer Pluginparameter *epayment.webservice.timeout* zum Konfigurieren des Timeouts zum Webservice in Sekunden.
423 +
424 +=== 3.1.1 ===
425 +
426 +* Fehlerbehebung: Bei EPayment-Artikel Objekt werden bei fehlenden Werten, Defaultwerte angenommen.
427 +
428 +=== 3.1.0 ===
429 +
430 +* Neue Eigenschaften am EPayment-Artikel Objekte hinzugefügt:
431 +** 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
432 +** Maximale Bestellmenge: Die durch den Nutzer maximal auswählbare Bestellmenge lässt sich begrenzen
433 +
434 +=== 3.0.1 ===
435 +
436 +* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="1"}}{{/version}}
437 +** Anpassungen der Validierungen im Designer für EPayment-Artikel Objekte
438 +
439 +=== 3.0.0 ===
440 +
441 +* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="0"}}{{/version}}
442 +** Neue Workflow-Aktion für Initialisierung der Bezahl-Transaktion
443 +** Einführung Ereignisse für Absenden der Bestellung, sowie Verifizierung der erfolgreichen / nicht erfolgreichen Bezahltransaktion
plugin_init_config_bestellposition.png
Größe
... ... @@ -1,1 +1,1 @@
1 -22.6 KB
1 +32.2 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