... |
... |
@@ -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 Plugin-Version {{version major="4" minor="1" patch="0"}}{{/version}} folgen, welche die Migration von alten Plugin-Versionen erleichtert. 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. Bitte warten Sie dafür auf die kommende Plugin-Version {{version major="4" minor="1" patch="0"}}{{/version}}.** |
|
6 |
+**Es wird eine minor Version folgen, welche die Migration von alten Plugin-Versionen erleichtert.** |
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 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) |
|
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) |
197 |
197 |
; Beschreibung |
198 |
|
-: Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePayBL weiter gegeben. |
|
198 |
+: Dient der interne Beschreibung der Bestellposition. Diese Information wird nicht an ePay-BL weiter gegeben. |
199 |
199 |
; Belegnummer |
200 |
|
-: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePayBL dient. |
|
200 |
+: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL 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 ePayBL ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
|
206 |
+{{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
207 |
207 |
|
208 |
208 |
{{figure image="plugin_init_config_akdb_mandant.png"}} |
209 |
|
-Konfiguration ePayBL EPayment-Mandant |
|
209 |
+Konfiguration AKDB EPayment-Mandant |
210 |
210 |
{{/figure}} |
211 |
211 |
|
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. |
|
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. |
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 |
|
-: ePayBL-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePayBL-System vorgegeben) |
|
219 |
+: AKDB-Mandantennummer des aufrufenden eShops (FORMCYCLE) (Wird durch ePay-BL-System vorgegeben) |
220 |
220 |
; Bewirtschafter-Nummer |
221 |
|
-: Bewirtschafternummer (Wird durch ePayBL-System vorgegeben) |
|
221 |
+: Bewirtschafternummer (Wird durch ePay-BL-System vorgegeben) |
222 |
222 |
; Haushaltsstelle |
223 |
|
-: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePayBL-System vorgegeben) |
|
223 |
+: Nummer der Haushaltsstelle, welcher die Buchung zugeordnet werden soll. (Wird durch ePay-BL-System vorgegeben) |
224 |
224 |
; Objektnummer |
225 |
|
-: Dient der internen Verbuchung im EPayment-System. (Wird durch ePayBL-System vorgegeben) |
|
225 |
+: Dient der internen Verbuchung im EPayment-System. (Wird durch ePay-BL-System vorgegeben) |
226 |
226 |
; Kennzeichen-Mahnverfahren |
227 |
|
-: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePayBL-System vorgegeben) |
|
227 |
+: Einstellung für das Kennzeichen in einem Mahnverfahren. (Mögliche Werte werden durch ePay-BL-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 ePayBL Portal geführt wird. |
|
272 |
+: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePay-BL Portal geführt wird. |
273 |
273 |
; [%$[Name der Aktion].RESULT.UrlToPaypage%] |
274 |
|
-: Die URL zur Bezahlseite auf Seiten von ePayBL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann. |
|
274 |
+: Die URL zur Bezahlseite auf Seiten von ePay-BL, 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 ePayBL Service nicht verfügbar ist. |
|
281 |
+: Fehlercode, wenn der ePay-BL Service nicht verfügbar ist. |
282 |
282 |
; SRV_METHOD_ERROR |
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. |
|
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. |
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 ePayBL Portal erfolgt |
|
296 |
+Eine Workflow-Verarbeitungskette mit diesem Ereignis wird ausgeführt, wenn eine Rückleitung aus dem ePay-BL 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 ePayBL Portal zurück geliefert wird. (Möglicher Wert: INAKTIV) |
|
301 |
+: Bezeichnung des Status, wie er vom ePay-BL 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 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). |
|
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). |
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 ePayBL Portal zurückgeliefert wird. |
|
320 |
+: Bezeichnung des Status, wie er vom ePay-BL 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 ePayBL abgebrochen hat). |
|
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). |
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 |
|
-* **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. |
|
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. |
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,12 +353,6 @@ |
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 |
|
- |
362 |
362 |
=== 3.6.0 === |
363 |
363 |
|
364 |
364 |
* Erweiterung AKDB ePay Setup: Konfigurationsmöglichkeit für Proxy-Server-Einstellungen |