Änderungen von Dokument Verwendung

Von 6.1 nach 6.2 Von 15.3 nach 15.4

Von Version 6.2

bearbeitet von rth
am 04.10.2021, 10:16

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 15.3

bearbeitet von rth
am 06.01.2022, 15:05

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
Anhänge (0 geändert, 8 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

@@ -30,9 +30,11 @@
  {{/figure}}
  Über das Formular-Element //EPayment Artikel// werden die für eine Bestell-Transaktion notwendigen Artikel definiert.
--Das Formular-Element dient dabei zum Einen für eine visuelle Darstellung des Artikels (mit Bild, Preisangabe, Eingabemöglichkeit für Bestellmenge) innerhalb eines Formulars, als auch als Vorlage für die Erstellung einer
--konkreten Bestell-Position zum Zeitpunkt der Ausführung einer Bezahl-Transaktion.
++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.
++Ab Plugin-Version {{version major="3" minor="3" patch="0"}}{{/version}} können Bestellpositionen auch direkt in der Workflow-Aktion definiert werden.
++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.
++
  __Grundeigenschaften:__
  ; Versteckt
@@ -53,7 +53,7 @@
  ; Max. Bestellmenge
  : Hier kann die für den Nutzer maximal auswählbare Bestellmenge für einen Artikel definiert werden.
  ; Belegnummer
--: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient
++: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient.
  {{info}}
  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.
@@ -83,12 +83,11 @@
  === 1.3. Bestellung an den Server übermitteln: ===
  Um eine Bestellung auszulösen und die bestellten Artikel zum Server zu übertragen muss dem Formular eine //Senden//-Schaltfläche hinzugefügt werden.
--
--{{id name="config_process"/}}
++\\{{id name="config_process"/}}
  == 2. Workflow für EPayment konfigurieren ==
--Um eine Bezahl-Transaktion in einen Formularprozess einzubauen werden folgende Workflow Elemente zur Verfügung gestellt:
++Um eine Bezahl-Transaktion in einen Formularprozess einzubauen werden folgende Elemente vom Plugin zur Verfügung gestellt:
  * 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.
  * 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.
@@ -96,8 +96,10 @@
  Ein Workflow für einen einfachen Fall kann folgendermaßen konfiguriert sein:
--(% style="background-color:transparent; border:none" %)
--|(% style="border-style:none; width:180px" %)[[image:hilfe_workflow.png||alt="Workflow mit EPayment Anbindung"]]|(% style="border-style:none; width:700px" %)(((
++{{figure image="hilfe_workflow.png"}}
++Workflow mit EPayment Anbindung
++{{/figure}}
++
  __Kurze Ablaufbeschreibung zum dargestellten Workflow:__
  ~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.
@@ -104,21 +104,19 @@
 . 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.
--3. Im Falle das die Bezahlung erfolgt ist, wird im Beispiel in den Status //Bezahlt// gewechselt und dem Nutzer wird eine entsprechende Abschlussseite angezeigt.
++3. Ist die Bezahlung erfolgt, wird in den Status //Bezahlt// gewechselt und dem Nutzer wird eine entsprechende Abschlussseite angezeigt.
--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 Fall eien E-Mail erzeugt, in der der Benutzer auf die noch ausstehende Zahlung hingewiesen wird. Der Workflow wird in diesem Beispiel mit einem Wechsel in den Status //Nicht bezahlt//
--abgeschlossen. Dem Nutzer wird eine entsprechende Abschlussseite angezeigt.
--
--)))
++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
++wird eine entsprechende Abschlussseite angezeigt.
  {{id name="plugin_epay_init"/}}
--=== 2.1. Konfigurationsmöglichkeiten des Aktions-Plugins //AKDB:EPayment initialisieren// ===
++=== 2.1. Konfigurationsmöglichkeiten des Aktions-Plugins //Bestellung übermitteln// ===
--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, Rechnungsadresse etc.), festgelegt. Weiterhin erfolgt die Festlegung in welchen Status, nach Rückkehr aus dem ePay-BL Portal, gewechselt werden soll.
++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.
  {{info}}
--Wenn vor der Konfiguration des Plugins bereits mindestens ein **[[EPayment-Artikel>>doc:||anchor="epay_artikel"]]**, der **[[EPayment Bestellen Button>>doc:||anchor="epay_btn"]]** sowie die **[[Vorlage>>doc:||anchor="epay_vorlage"]]** für die **persönlichen Daten** im Formular hinterlegt wurden, werden bei einer Neueinrichtung der //AKDB:EPayment initialisieren// Plugin-Aktion die notwendigen Pflicht-Konfigurationen bereits mit den ermittelten Daten aus dem Formular vorbelegt. Es muss anschließend nur noch der Ziel-Status für eine erfolgreiche / nicht erfolgreiche Transaktion festgelegt werden.
++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.
  Es empfiehlt sich deshalb die in diesem Artikel beschriebene [[Konfigurations-Reihenfolge>>doc:||anchor="config_reihenfolge"]] einzuhalten.
@@ -127,34 +127,30 @@
  Die Konfigurationsoberfläche des Aktions-Plugins ist in einzelne Bereiche unterteilt die nachfolgend kurz beschrieben werden.
--{{panel title="Konfiguration AKDB EPayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}}
++{{panel title="Kundenstammdaten" fullwidth="true" initial="visible" triggerable="true"}}
--{{figure image="plugin_init_config_akdb_mandant.png"}}
--Konfiguration AKDB EPayment-Mandant
++{{figure image="plugin_init_config_kundenstammdaten.png"}}
++Konfiguration für die Kundenstammdaten
  {{/figure}}
--In diesem Bereich werden die für den Formular-Prozess zu verwendenden Einstellungen des ePay-BL Mandanten hinterlegt. Diese sind notwendig, um später die Transaktion auf Seiten von ePay-BL
--der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), Bewirtschafter und Haushaltsstelle zuzuordnen. Die Daten in diesem Bereich sind meistens bereits mit globalen Einstellungen vorbefüllt,
--sofern diese durch einen Plugin-Administrator korrekt hinterlegt wurden.
++In diesem Bereich werden die Daten des Benutzers hinterlegt, für den die Bezahl-Transaktion erzeugt werden soll.
++Die einzelnen Parameter können per Platzhalter oder fest definiert hinterlegt werden.
++{{info}}
++Über den [[image:icon_update.png]]-Button können diese Felder durch Nutzung der EPayment-Vorlage //Persönliche Daten// vorbelegt werden.
++{{/info}}
--Die einzelnen Parameter können per Platzhalter oder fest definiert hinterlegt werden. Weiterhin kann über den Button [[image:icon_update.png]] //EPayment Webservice Erreichbarkeit prüfen// die generelle Erreichbarkeit des EPayment Webservice geprüft werden.
++; Anrede
++; Titel
++; Vorname
++; Nachname (Pflichtfeld)
++; Geburtsdatum
++: Geburtsdatum muss in der Form **dd.MM.yyyy** übermittelt werden.
++; E-Mail
++: Wird für die Zustellung von Emails an den Kunden in Abhängigkeit von der ePay-BL-Mandantkonfiguration benötigt.
++; Telefon
++; Mobiltelefon
--; Mandant-Nummer (Pflichtfeld)
--: AKDB-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePay-BL-System vorgegeben)
--; Bewirtschafter-Nummer (Pflichtfeld)
--: Bewirtschafternummer (Wird durch ePay-BL-System vorgegeben)
--; Haushaltsstelle (Pflichtfeld)
--: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePay-BL-System vorgegeben)
--; Objektnummer (Pflichtfeld)
--: Dient der internen Verbuchung im EPayment-System. (Wird durch ePay-BL-System vorgegeben)
--; Kennzeichen-Mahnverfahren (Pflichtfeld)
--: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePay-BL-System vorgegeben)
--; Fälligkeitszeitraum (Pflichtfeld)
--: Einstellung für die Berechnung des Fälligkeitszeitraumes der Zahlung (Dauer in Tagen).
--; Währung
--: Währung in welcher der Betrag ausgewiesen wird. Ist nichts definiert wird als Wert **EUR** angenommen.
--
  {{/panel}}
  {{id name="config_paypage"/}}
@@ -161,51 +161,213 @@
  {{panel title="Konfiguration für die PayPage" fullwidth="true" initial="visible" triggerable="true"}}
--Bei der "PayPage" handelt es sich dabei um eine bereits ausgefüllte Bezahlseite zur Online-Bezahlung der vom Gläubiger, für die jeweils erbrachten Leistungen, veranschlagten Gebühren, Entgelte etc.
++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.
  {{figure image="plugin_init_config_paypage.png"}}
  Konfiguration für die PayPage
  {{/figure}}
--
--; URL zur PayPage (Pflichtfeld)
--: URL zur PayPage des EPayment-Systems. Die hier hinterlegte URL wird durch das ePay-BL-System vorgegeben und beinhaltete den Verweis auf die PayPage im ePay-BL-System.
  ; Automatische Weiterleitung zur PayPage verhindern
  : Bei aktivierter Einstellung kann eine automatische Weiterleitung zur PayPage unterbunden werden.
--; Status, in welchen nach erfolgreicher Transaktion gewechselt wird (Pflichtfeld)
--: Hier muss ein Status festgelegt werden, in welchen gewechselt wird, wenn der Bezahlvorgang auf Seiten des ePay-BL-Systems erfolgreich durchlaufen wurde.
--; Status, in welchen nach fehlerhafter oder abgebrochener Transaktion gewechselt wird (Pflichtfeld)
--: Hier muss ein Status festgelegt werden, in welchen gewechselt wird, wenn der Bezahlvorgang auf Seiten des ePay-BL-Systems abgebrochen wurde.
--; PayPage Buchungstext
--: Dieser Buchungstext wird dem Benutzer auf der PayPage angezeigt.
  ; Fälligkeitsdatum
--: 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 Einstellung für den **Fälligkeitszeitraum** wird nicht beachtet.
++: 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.
++; Buchungstext auf PayPage
++: Der hier festgelegte Buchungstext wird dem Benutzer auf der PayPage angezeigt.
  {{/panel}}
--{{panel title="Kundenstammdaten" fullwidth="true" initial="visible" triggerable="true"}}
++{{panel title="Definition zusätzlicher Bestellpositionen" fullwidth="true" triggerable="true"}}
--{{figure image="plugin_init_config_kundenstammdaten.png"}}
--Konfiguration für die Kundenstammdaten
++{{figure image="plugin_init_config_bestellposition.png"}}
++Konfiguration von zusätzlichen Bestellpositionen
  {{/figure}}
--In diesem Bereich werden die Daten des Benutzers hinterlegt, für den die Bezahl-Transaktion erzeugt werden soll.
--Die einzelnen Parameter können per Platzhalter oder fest definiert hinterlegt werden.
++; Anzahl
++: 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
++; Buchungstext
++: 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.
++; Preis (in Euro)
++: 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)
++; Beschreibung
++: Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePay-BL weiter gegeben.
++; Belegnummer
++: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient.
++Ü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.
++
++{{/panel}}
++
++{{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}}
++
++{{figure image="plugin_init_config_akdb_mandant.png"}}
++Konfiguration AKDB EPayment-Mandant
++{{/figure}}
++
++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
++der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), dem Bewirtschafter und der Haushaltsstelle zuzuordnen.
++In den meisten Fällen sind diese Einstellungen bereits durch einen Plugin-Administrator global hinterlegt worden, sodass an dieser Stelle keine Konfiguration notwendig ist.
++
++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.
++
++; Mandant-Nummer
++: AKDB-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePay-BL-System vorgegeben)
++; Bewirtschafter-Nummer
++: Bewirtschafternummer (Wird durch ePay-BL-System vorgegeben)
++; Haushaltsstelle
++: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePay-BL-System vorgegeben)
++; Objektnummer
++: Dient der internen Verbuchung im EPayment-System. (Wird durch ePay-BL-System vorgegeben)
++; Kennzeichen-Mahnverfahren
++: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePay-BL-System vorgegeben)
++; Fälligkeitszeitraum
++: Einstellung für die Berechnung des Fälligkeitszeitraumes der Zahlung (Dauer in Tagen).
++
++{{/panel}}
++
++==== 2.1.1 Rückgabewerte der Workflow-Aktion ====
++
++{{figure image="plugin_init_result.png"}}
++Rückgabewert und Fehlercodes der Aktion
++{{/figure}}
++
++__Rückgabewerte__
++
++; [%$[Name der Aktion].RESULT.BestellPosition[i]['key']%]
++: Eine Auflistung über alle Bestell-Positionen, welche in der aktuellen Bestellung enthalten sind.
++: Zu jeder Bestell-Position können folgende Werte abgefragt werden:
++:
++: * Artikelnummer: Die am //EPayment Artikel// hinterlegte eindeutige Kennung für den Artikel
++: * Buchungstext: Der übermittelte Buchungstext (max.21 Zeichen, SEPA konform)
++: * Menge: Die bestellte Menge für die aktuelle Bestell-Position
++: * Beschreibung: Die am //EPayment Artikel// hinterlegte Artikel-Beschreibung
++: * Einzelpreis: Der am //EPayment Artikel// hinterlegte Preis für ein Stück. Ausgabe mit Währungssymbol.
++: * Preis: Der errechnete Gesamtpreis für die aktuelle Bestell-Position. Ergibt sich aus //Menge x Einzelpreis//. Ausgabe mit Währungssysmbol
++:
++: Nachfolgend einige Beispiele für die Datenabfrage aus den Bestellpositionen:
++: \\Für die Beispiele wird folgender durch die Aktion bereitgestellter Platzhalter zu Grunde gelegt *[%$[Name der Aktion].RESULT.Bestellung[i][''key'']%]*
++: Die in den eckigen Klammern hinterlegten Werte sind variabel und haben folgende Bedeutung:
++:
++: * i: Zählvariable für den Zugriff auf eine Bestell-Position aus der Gruppe aller Bestell-Positionen.
++: Ein möglicher Wert muss sich im Bereich von 0 bis zum Wert der BestellPositionAnzahl -1 befinden.
++: * key: Schlüssel für den Zugriff auf die jeweilige Eigenschaft
++:
++: Beispiele (mit einer Aktion mit Namen _Bestellung übermitteln_):
++: Abfrage des Einzelpreises an der 1. Bestell-Position: *[%$Bestellung übermitteln.RESULT.Bestellung[0][''Einzelpreis'']%]*
++: Abfrage der Menge an der 3. Bestell-Position: *[%$Bestellung übermitteln.RESULT.Bestellung[2][''Menge'']%]*
++; [%$[Name der Aktion].RESULT.BestellPositionAnzahl%]
++: Die Gesamtanzahl der Bestellpositionen, welche in der aktuellen Bestellung enthalten sind
++; [%$[Name der Aktion].RESULT.Gesamtbetrag%]
++: Der in der Zahlungstransaktion ausgewiesene zu zahlende Geldbetrag. Angabe in Euro
++; [%$[Name der Aktion].RESULT.Kassenzeichen%]
++: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePay-BL Portal geführt wird.
++; [%$[Name der Aktion].RESULT.UrlToPaypage%]
++: Die URL zur Bezahlseite auf Seiten von ePay-BL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann.
++
++__Fehlercodes__
++
++; NO_ORDER_DATA
++: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte.
++; SRV_NOT_AVIALABLE
++: Fehlercode, wenn der ePay-BL Service nicht verfügbar ist.
++; SRV_METHOD_ERROR
++: Fehlercode, wenn eine ePay-BL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das
++{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
++; INTERNAL_ERROR
++: Fehlercode für einen nicht nähere beschriebenen Fehler. Bei Auftreten von solchen Fehlertypen sollte das
++{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden.
++{{id name="plugin_event_epay_success"/}}
++
++=== 2.2. Workflow-Ereignis //Bezahlung erfolgreich// ===
++
++Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt
++und die Bezahlung erfolgreich durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis genau einmal eintreten.
++Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können:
++
++; **[%$TRIGGER.paymentStatus%]**
++: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird. (Möglicher Wert: INAKTIV)
++; **[%$TRIGGER.paymentStatusText%]**
++: Eine Nachricht, die den zurückgelieferten Status näher beschreibt
++
++{{id name="plugin_event_epay_error"/}}
++
++=== 2.3. Workflow-Ereignis //Bezahlung nicht erfolgreich// ===
++
++Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte
++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).
++Das Ereignis stellt folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können:
++
++; **[%$TRIGGER.paymentStatus%]**
++: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird.
++: Folgende Werte sind möglich:
++: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt.
++: **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden.
++: **MANDANT_INAKTIV**: Der Mandant ist im ePayment-System derzeit als inaktiv gekennzeichnet.
++: **VERBINDUNG_OHNE_HTTPS**: Die Verbindung zum Webservice erfolgte nicht über HTTPS mit Client-Zertifikaten.
++: **VERBINDUNG_ZERTIFIKAT_FEHLER**: Das für die Verbindung verwendete Client-Zertifikat darf nicht für den gewählten Mandanten verwendet werden.
++: **KASSENZEICHEN_NICHT_VORHANDEN**: Das gewählte Kassenzeichen ist nicht vorhanden.
++: **KASSENZEICHEN_NICHT_GEFUNDEN**: Das gewählte Kassenzeichen konnte nicht gefunden werden.
++: **INTERNER_EPAYMENT_FEHLER**: Interner nicht dokumentierter Fehler im ePayment-System.
++: **UNDEFINIERT**: Ein im System nicht bekannter Status
++; **[%$TRIGGER.paymentStatusText%]**
++: Eine Nachricht, die den zurückgelieferten Status näher beschreibt
++; **[%$TRIGGER.paypageUrl%]**
++: URL zur Paypage mit der aktuellen Transaktionsnummer. Damit ist ein nochmaliges Aufrufen und Bezahlen der offenen Transaktion möglich.
++
++== 3. Ergebnisanzeige ==
++
++Die Anzeige des Ergebnisses bzw. des Status einer Bezahl-Transaktion erfolgt standardmäßig mittels einer extra Abschluss-Seite.
++Dafür stellt das Plugin 3 HTML-Templates bereit:
++
++* **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung.
++* **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.
++* **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen.
++
  {{info}}
--Über den Link [[image:icon_update.png]] //Formular-Elemente für Kundenstammdaten ermitteln// können die Felder bei Nutzung der EPayment-Vorlage //Persönliche Daten// vorbelegt werden.
++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.
++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.
  {{/info}}
--; Anrede
--; Titel
--; Vorname
--; Nachname (Pflichtfeld)
--; Geburtsdatum
--: Geburtsdatum muss in der Form **dd.MM.yyyy** übermittelt werden.
--; E-Mail
--: Wird für die Zustellung von Emails an den Kunden in Abhängigkeit von der ePay-BL-Mandantkonfiguration benötigt.
--; Telefon (privat)
--; Telefon (dienstlich)
--; Mobiltelefon
++== Versionshistorie ==
--{{/panel}}
++=== 3.3.0 ===
++
++* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}}
++* Erweiterung Workflow-Aktion //Bestellung übermitteln//: Möglichkeit für serverseitige Definition von Bestellpositionen
++* 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.
++
++=== 3.2.0 ===
++
++* Erweiterung EPayment Bestellartikel: Am Element ist der Gesamtpreis (Anzahl * Einzelpreis) als verstecktes Element verfügbar. Dieser kann über die CSS-Klasse 'CXOrderItemTotalPrice' eingeblendet werden.
++* Erweiterung Anzahl-Eingabe-Element am EPayment Bestellartikel: Bei einer direkten Werteingabe wird diese sofort gegen die definierte untere und obere Wertgrenze validiert.
++
++=== 3.1.4 ===
++
++* Formatierung des Rückgabewertes für den Gesamtbetrag auf #0,00 €
++
++=== 3.1.3 ===
++
++* Fehlerbehebung: Es wurden Problem behoben, welche beim Öffnen von EPayment-Formularen im Designe aufgetreten sind.
++
++=== 3.1.2 ===
++
++* Neuer Pluginparameter *epayment.webservice.timeout* zum Konfigurieren des Timeouts zum Webservice in Sekunden.
++
++=== 3.1.1 ===
++
++* Fehlerbehebung: Bei EPayment-Artikel Objekt werden bei fehlenden Werten, Defaultwerte angenommen.
++
++=== 3.1.0 ===
++
++* Neue Eigenschaften am EPayment-Artikel Objekte hinzugefügt:
++** 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
++** Maximale Bestellmenge: Die durch den Nutzer maximal auswählbare Bestellmenge lässt sich begrenzen
++
++=== 3.0.1 ===
++
++* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="1"}}{{/version}}
++** Anpassungen der Validierungen im Designer für EPayment-Artikel Objekte
++
++=== 3.0.0 ===
++
++* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" minor="0" patch="0"}}{{/version}}
++** Neue Workflow-Aktion für Initialisierung der Bezahl-Transaktion
++** Einführung Ereignisse für Absenden der Bestellung, sowie Verifizierung der erfolgreichen / nicht erfolgreichen Bezahltransaktion

icon_add.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+384 bytes

Inhalt

icon_del.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+307 bytes

Inhalt

icon_update.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+410 bytes

Inhalt

plugin_init_config_akdb_mandant.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+17.1 KB

Inhalt

plugin_init_config_bestellposition.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+32.2 KB

Inhalt

plugin_init_config_kundenstammdaten.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+25.6 KB

Inhalt

plugin_init_config_paypage.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+10.1 KB

Inhalt

plugin_init_result.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.rth

Größe

...	...	@@ -1,0 +1,1 @@
	1	+95.8 KB

Inhalt