| ... |
... |
@@ -3,7 +3,7 @@ |
| 3 |
3 |
{{info}} |
| 4 |
4 |
**Achtung:** |
| 5 |
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 |
|
-**Es wird eine minor Version folgen, welche die Migration von alten Plugin-Versionen erleichtert.** |
|
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. |
| 7 |
7 |
{{/info}} |
| 8 |
8 |
|
| 9 |
9 |
{{content/}} |
| ... |
... |
@@ -189,42 +189,42 @@ |
| 189 |
189 |
{{/figure}} |
| 190 |
190 |
|
| 191 |
191 |
; Anzahl |
| 192 |
|
-: 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 |
| 193 |
|
-; Buchungstext |
|
192 |
+: 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 |
|
193 |
+; Buchungstext |
| 194 |
194 |
: 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. |
| 195 |
195 |
; Preis (in Euro) |
| 196 |
|
-: 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) |
|
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) |
| 197 |
197 |
; Beschreibung |
| 198 |
|
-: Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePay-BL weiter gegeben. |
|
198 |
+: Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePayBL weiter gegeben. |
| 199 |
199 |
; Belegnummer |
| 200 |
|
-: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient. |
|
200 |
+: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePayBL dient. |
| 201 |
201 |
|
| 202 |
|
-Ü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. |
|
202 |
+Ü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. |
| 203 |
203 |
|
| 204 |
204 |
{{/panel}} |
| 205 |
205 |
|
| 206 |
|
-{{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
|
206 |
+{{panel title="Konfiguration ePayBL ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
| 207 |
207 |
|
| 208 |
208 |
{{figure image="plugin_init_config_akdb_mandant.png"}} |
| 209 |
|
-Konfiguration AKDB EPayment-Mandant |
|
209 |
+Konfiguration ePayBL EPayment-Mandant |
| 210 |
210 |
{{/figure}} |
| 211 |
211 |
|
| 212 |
|
-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 |
| 213 |
|
-der richtigen Behörde (entspricht der festgelegten Mandant-Nummer), dem Bewirtschafter und der Haushaltsstelle zuzuordnen. |
|
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 |
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. |
| 215 |
215 |
|
| 216 |
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. |
| 217 |
217 |
|
| 218 |
218 |
; Mandant-Nummer |
| 219 |
|
-: AKDB-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePay-BL-System vorgegeben) |
|
219 |
+: ePayBL-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePayBL-System vorgegeben) |
| 220 |
220 |
; Bewirtschafter-Nummer |
| 221 |
|
-: Bewirtschafternummer (Wird durch ePay-BL-System vorgegeben) |
|
221 |
+: Bewirtschafternummer (Wird durch ePayBL-System vorgegeben) |
| 222 |
222 |
; Haushaltsstelle |
| 223 |
|
-: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePay-BL-System vorgegeben) |
|
223 |
+: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePayBL-System vorgegeben) |
| 224 |
224 |
; Objektnummer |
| 225 |
|
-: Dient der internen Verbuchung im EPayment-System. (Wird durch ePay-BL-System vorgegeben) |
|
225 |
+: Dient der internen Verbuchung im EPayment-System. (Wird durch ePayBL-System vorgegeben) |
| 226 |
226 |
; Kennzeichen-Mahnverfahren |
| 227 |
|
-: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePay-BL-System vorgegeben) |
|
227 |
+: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePayBL-System vorgegeben) |
| 228 |
228 |
; Fälligkeitszeitraum |
| 229 |
229 |
: Einstellung für die Berechnung des Fälligkeitszeitraumes der Zahlung (Dauer in Tagen). |
| 230 |
230 |
|
| ... |
... |
@@ -269,19 +269,19 @@ |
| 269 |
269 |
; [%$[Name der Aktion].RESULT.Gesamtbetrag%] |
| 270 |
270 |
: Der in der Zahlungstransaktion ausgewiesene zu zahlende Geldbetrag. Angabe in Euro |
| 271 |
271 |
; [%$[Name der Aktion].RESULT.Kassenzeichen%] |
| 272 |
|
-: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePay-BL Portal geführt wird. |
|
272 |
+: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePayBL Portal geführt wird. |
| 273 |
273 |
; [%$[Name der Aktion].RESULT.UrlToPaypage%] |
| 274 |
|
-: Die URL zur Bezahlseite auf Seiten von ePay-BL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann. |
|
274 |
+: Die URL zur Bezahlseite auf Seiten von ePayBL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann. |
| 275 |
275 |
|
| 276 |
276 |
__Fehlercodes__ |
| 277 |
277 |
|
| 278 |
278 |
; NO_ORDER_DATA |
| 279 |
|
-: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte. |
|
279 |
+: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte. |
| 280 |
280 |
; SRV_NOT_AVIALABLE |
| 281 |
|
-: Fehlercode, wenn der ePay-BL Service nicht verfügbar ist. |
|
281 |
+: Fehlercode, wenn der ePayBL Service nicht verfügbar ist. |
| 282 |
282 |
; SRV_METHOD_ERROR |
| 283 |
|
-: Fehlercode, wenn eine ePay-BL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das |
| 284 |
|
-{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
|
283 |
+: Fehlercode, wenn eine ePayBL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das |
|
284 |
+{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
| 285 |
285 |
; INTERNAL_ERROR |
| 286 |
286 |
: Fehlercode für einen nicht nähere beschriebenen Fehler. Bei Auftreten von solchen Fehlertypen sollte das |
| 287 |
287 |
{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
| ... |
... |
@@ -293,12 +293,12 @@ |
| 293 |
293 |
Workflow-Ereignis bei erfolgreicher Bezahlung |
| 294 |
294 |
{{/figure}} |
| 295 |
295 |
|
| 296 |
|
-Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgt |
|
296 |
+Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePayBL Portal erfolgt |
| 297 |
297 |
und die Bezahlung erfolgreich durchgeführt wurde. Pro Formular-Vorgang kann dieses Ereignis genau einmal eintreten. |
| 298 |
298 |
Das Ereignis stellt dabei folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
| 299 |
299 |
|
| 300 |
300 |
; **[%$TRIGGER.paymentStatus%]** |
| 301 |
|
-: Bezeichnung des Status, wie er vom ePay-BL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV) |
|
301 |
+: Bezeichnung des Status, wie er vom ePayBL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV) |
| 302 |
302 |
; **[%$TRIGGER.paymentStatusText%]** |
| 303 |
303 |
: Eine Nachricht, die den zurück gelieferten Status näher beschreibt |
| 304 |
304 |
; **[%$TRIGGER.paymentMethod%] {{version major="3" minor="5"}}{{/version}}** |
| ... |
... |
@@ -312,14 +312,14 @@ |
| 312 |
312 |
Workflow-Ereignis bei nicht erfolgreicher Bezahlung |
| 313 |
313 |
{{/figure}} |
| 314 |
314 |
|
| 315 |
|
-Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePay-BL Portal erfolgte |
| 316 |
|
-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). |
|
315 |
+Eine Workflow-Verarbeitungskette mit diesem Ereignis wird immer dann ausgeführt, wenn eine Rückleitung aus dem ePayBL Portal erfolgte |
|
316 |
+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). |
| 317 |
317 |
Das Ereignis stellt folgende Werte bereit, die per Platzhalter in nachfolgenden Aktionen ausgewertet werden können: |
| 318 |
318 |
|
| 319 |
319 |
; **[%$TRIGGER.paymentStatus%]** |
| 320 |
|
-: Bezeichnung des Status, wie er vom ePay-BL Portal zurückgeliefert wird. |
|
320 |
+: Bezeichnung des Status, wie er vom ePayBL Portal zurückgeliefert wird. |
| 321 |
321 |
: Folgende Werte sind möglich: |
| 322 |
|
-: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt (z.B. weil der Nutzer den Bezahlvorgang auf Seiten von ePay-BL abgebrochen hat). |
|
322 |
+: **AKTIV**: Die Bezahlung über die PayPage ist noch nicht erfolgt (z.B. weil der Nutzer den Bezahlvorgang auf Seiten von ePayBL abgebrochen hat). |
| 323 |
323 |
: **MANDANT_NICHT_GEFUNDEN**: Der Mandant wurde im ePayment-System nicht gefunden. |
| 324 |
324 |
: **MANDANT_INAKTIV**: Der Mandant ist im ePayment-System derzeit als inaktiv gekennzeichnet. |
| 325 |
325 |
: **VERBINDUNG_OHNE_HTTPS**: Die Verbindung zum Webservice erfolgte nicht über HTTPS mit Client-Zertifikaten. |
| ... |
... |
@@ -342,9 +342,9 @@ |
| 342 |
342 |
Die Anzeige des Ergebnisses bzw. des Status einer Bezahl-Transaktion erfolgt standardmäßig mittels einer extra Abschluss-Seite. |
| 343 |
343 |
Dafür stellt das Plugin 3 HTML-Templates bereit: |
| 344 |
344 |
|
| 345 |
|
-* **AKDB ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung. |
| 346 |
|
-* **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. |
| 347 |
|
-* **AKDB ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen. |
|
345 |
+* **ePayBL ePayment Bezahlung Erfolg**: Standard-Template für Anzeige bei erfolgreich abgeschlossener Bezahlung. |
|
346 |
+* **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. |
|
347 |
+* **ePayBL ePayment Fehler**: Standard-Template für Anzeige bei allgemeinen technischen Fehlern. Der genaue Fehler wird mittels enthaltener Platzhalter ausgewiesen. |
| 348 |
348 |
|
| 349 |
349 |
{{info}} |
| 350 |
350 |
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. |
| ... |
... |
@@ -353,6 +353,12 @@ |
| 353 |
353 |
|
| 354 |
354 |
== Versionshistorie == |
| 355 |
355 |
|
|
356 |
+=== 4.0.0 === |
|
357 |
+ |
|
358 |
+* Wechsel von der SOAP Schnittstelle zu REST. Dadurch ist immer ein Zertifikat und Passwort notwendig sowie die Angabe der Zahlverfahren. |
|
359 |
+* Umstellung von AKDB spezifischer ePayBL Umgebung zu einer freien Festlegung der anzubindenden Umgebung. |
|
360 |
+* Umbennung aller Vorkommnisse von AKDB zu ePayBL. |
|
361 |
+ |
| 356 |
356 |
=== 3.6.0 === |
| 357 |
357 |
|
| 358 |
358 |
* Erweiterung AKDB ePay Setup: Konfigurationsmöglichkeit für Proxy-Server-Einstellungen |
