... |
... |
@@ -20,6 +20,23 @@ |
20 |
20 |
|
21 |
21 |
Falls Sie bereits das [[**AKDB: EPayment-Plugin** >>url:https://help.formcycle.de/xwiki/bin/view/Formcycle/PluginDocumentation/AkdbEPaymentPlugin/]] in Ihren Mandanten installiert haben, können Sie wie folgt vorgehen: |
22 |
22 |
|
|
23 |
+1. Gehen Sie in den Menüpunkt //AKDB ePay Setup// |
|
24 |
+1. Notieren Sie sich Ihre bisherigen Angaben |
|
25 |
+1.1 Mandant-Nummer |
|
26 |
+1.2 Bewirtschafter-Nummer |
|
27 |
+1.3 Haushaltsstelle |
|
28 |
+1.4 Objektnummer |
|
29 |
+1.5 Kennzeichen-Manverfahren |
|
30 |
+1.6 Proxy (falls vorhanden) |
|
31 |
+1. Ermitteln Sie die URL Ihres ePayBL Providers |
|
32 |
+1. Stellen Sie Zertifikat und Zertifikatspasswort sicher |
|
33 |
+1. Ermitteln Sie die erlaubten Zahlverfahren Ihres ePayBL Providers |
|
34 |
+1. Deaktivieren Sie das //AKDB: EPayment-Plugin// in Ihrem Mandanten |
|
35 |
+1. Loggen Sie sich als Systemadministrator an |
|
36 |
+1. Hinterlegen Sie das //ePayBL: EPayment-Plugin// in den System-Plugins |
|
37 |
+1. Gehen Sie in den neuen Menüpunkt //ePayBL Setup// |
|
38 |
+1. Hinterlegen Sie Ihre notierten Angaben, nähere Informationen sind in den folgenden Abschnitten hinterlegt. |
|
39 |
+ |
23 |
23 |
=== Vorbereitung === |
24 |
24 |
|
25 |
25 |
Um die neue ePayBL Schnittstelle anzubinden, benötigen Sie ein Zertifikat von der AKDB. Wenn Sie es für die Produktivumgebung noch nicht haben, wenden Sie sich an Ihren Ansprechpartner bei der AKDB. |
... |
... |
@@ -27,33 +27,33 @@ |
27 |
27 |
=== Migration === |
28 |
28 |
|
29 |
29 |
1. Datensicherung |
30 |
|
-1.1 Gehen Sie im {{formcycle/}} Hauptmenü auf **AKDB ePay Setup**. |
|
47 |
+1.1 Gehen Sie im FORMCYCLE Hauptmenü auf **AKDB ePay Setup**. |
31 |
31 |
1.2 Klicken Sie auf **Zur Anbindung ePay-BL Umgebung**. |
32 |
32 |
1.3 Notieren Sie die Informationen für Mandant-Nummer, Bewirtschafter-Nummer, Haushaltsstelle, Objektnummer, Kennzeichen-Mahnverfahren, Fälligkeitszeitraum (in Tagen) und Buchungstext für die PayPage. |
33 |
33 |
1. Bestimmen der URL Ihres ePayBL Providers |
34 |
|
-2.1 Wenn unter "Anzubindende Umgebung" der Wert "TEST" ausgewählt ist, verwenden Sie in Zukunft die Adresse "https://infra-pre.buergerserviceportal.de" oder "https://epay-pre.akdb.de" zur Anbindung. Welche Umgebung in Ihrem Fall greift können Sie bei der AKDB nachfragen. |
35 |
|
-2.2 Wenn unter "Anzubindende Umgebung" der Wert "LIVE" ausgewählt ist, verwenden Sie in Zukunft die Adresse "https://epay.akdb.de" zur Anbindung. |
|
51 |
+2.1 Wenn unter "Anzubindende Umgebung" der Wert "TEST" ausgewählt ist, verwenden Sie in Zukunft die Adresse "xxxxxxxxxxxxxxxx" zur Anbindung. |
|
52 |
+2.2 Wenn unter "Anzubindende Umgebung" der Wert "LIVE" ausgewählt ist, verwenden Sie in Zukunft die Adresse "xxxxxxxxxxxxxxxx" zur Anbindung. |
36 |
36 |
1. Deaktivieren des AKDB: EPayment-Plugin |
37 |
|
-3.1 Gehen Sie im {{formcycle/}} Hauptmenü auf "Mandant" -> "Plugin". |
|
54 |
+3.1 Gehen Sie im FORMCYCLE Hauptmenü auf "Mandant" -> "Plugin". |
38 |
38 |
3.2 Fahren Sie mit der Maus über den Eintrag //plugin-bundle-akdb-epayment.jar//. Es erscheint das Symbol zum Deaktivieren des Plugins. |
39 |
39 |
3.3 Klicken Sie auf das Symbol, um das Plugin zu deaktivieren. |
40 |
40 |
3.4 Das Plugin wird nun durchgestrichen dargestellt. |
41 |
41 |
1. Löschen der Datei //epay_wf_result.js// |
42 |
|
-4.1 Gehen Sie im {{formcycle/}} Hauptmenü auf "Dateien & Templates" -> "Dateien". |
|
59 |
+4.1 Gehen Sie im FORMCYCLE Hauptmenü auf "Dateien & Templates" -> "Dateien". |
43 |
43 |
4.2 Wählen Sie den Eintrag //epay_wf_result.js// aus indem Sie das Kästchen links davon anhaken. |
44 |
44 |
4.3 Klicken Sie auf das löschen Symbolüberhalb der Auflistung. |
45 |
|
-1. Installation des //plugin-bundle-epaybl.jar// |
46 |
|
-5.1 Melden Sie sich als Systemadministrator (sadmin) am {{formcycle/}} Backend an. |
47 |
|
-5.2 Gehen Sie im {{formcycle/}} Hauptmenü auf "System" -> "Systemplugins". |
48 |
|
-5.3 Klicken Sie auf den Plus-Button, um die Datei //plugin-bundle-epaybl.jar// hinzuzufügen. |
|
62 |
+1. Installation des //plugin-bundle-epaybl.jar |
|
63 |
+5.1 Melden Sie sich als Systemadministrator (sadmin) am FORMCYCLE Backend an. |
|
64 |
+5.2 Gehen Sie im FORMCYCLE Hauptmenü auf "System" -> "Systemplugins". |
|
65 |
+5.3 Klicken Sie auf den Plus-Button, um die Datei //plugin-bundle-epaybl.jar// hinzuzufügen.// |
49 |
49 |
1. Einrichten mit ePayBL Setup |
50 |
|
-6.1 Im {{formcycle/}} Hauptmenü steht Ihnen nun ein neuer Punkt **ePayBL Setup** zur Verfügung. Eventuell müssen Sie sich erneut anmelden um diesen zu sehen. |
|
67 |
+6.1 Im FORMCYCLE Hauptmenü steht Ihnen nun ein neuer Punkt **ePayBL Setup** zur Verfügung. |
51 |
51 |
6.2 Klicken Sie auf dem Menüpunk **ePayBL Setup** |
52 |
52 |
6.3 Tragen Sie die URL aus Schritt 2 ein. |
53 |
53 |
6.4 Geben Sie nun die Informationen für Mandant-Nummer, Bewirtschafter-Nummer, Haushaltsstelle, Objektnummer, Kennzeichen-Mahnverfahren, Fälligkeitszeitraum (in Tagen) und Buchungstext für die PayPage ein, die für alle Mandanten gelten sollen. |
54 |
54 |
6.5 Laden Sie das Zertifikat hoch, das Sie von der AKDB erhalten haben, und geben Sie das dazugehörige Passwort ein. |
55 |
55 |
6.6 Klicken Sie auf „Speichern“. |
56 |
|
-6.7 Alle Angaben, die Sie als Systemadministrator in den Systemeinstellungen hinterlegen, sind optional und sind als Standardeinstellungen, die für alle Mandanten in Ihrer {{formcycle/}} Umgebung gelten zu verstehen. |
|
73 |
+6.7 Alle Angaben, die Sie als Systemadministrator in den Systemeinstellungen hinterlegen, sind optional und sind als Standardeinstellungen, die für alle Mandanten in Ihrer FORMCYCLE Umgebung gelten zu verstehen. |
57 |
57 |
6.8 Informationen, die nicht durch den Systemadministrator hinterlegt wurden, werden im Mandanten als Pflichtangabe angezeigt und müssen später dort angegeben werden. |
58 |
58 |
1. Vervollständigung des Setups im Mandanten |
59 |
59 |
7.1 Melden Sie sich beim Mandanten an, in dem Sie zuvor das AKDB: EPayment-Plugin deaktiviert haben. |
... |
... |
@@ -83,7 +83,7 @@ |
83 |
83 |
|
84 |
84 |
=== Obligatorische Installationsschritte === |
85 |
85 |
|
86 |
|
-* Anmeldung als **sadmin **am {{formcycle/}}-System. |
|
103 |
+* Anmeldung als **sadmin **am FORMCYCLE-System. |
87 |
87 |
* Registrierung des **//plugin-bundle-epaybl.jar//** Plugins im Bereich der System-Plugins. |
88 |
88 |
|
89 |
89 |
=== Fakultative Installationsschritte === |
... |
... |
@@ -136,8 +136,7 @@ |
136 |
136 |
Falls bereits eine Eingabe durch den {{formcycle/}} Systemadministrator getätigt wurde, ist das Eingabefeld für den Mandanten kein Pflichtfeld mehr und der Default-Wert wird als Platzhalter angezeigt. Jeder Mandant kann die Default-Werte überschreiben, indem das entsprechende Eingabefeld ausgefüllt wird. |
137 |
137 |
|
138 |
138 |
; URL des Providers |
139 |
|
-: Die URL der anzubindenen Umgebung. Der Default-Wert wird als Platzhalter angezeigt. |
140 |
|
-: Für die Anbindung ePayBL-Systeme der AKDB muss hier https://infra-pre.buergerserviceportal.de für das Testsytem und https://epay.akdb.de für das Livesystem eingetragen werden. |
|
156 |
+: Die URL der anzubindenen Umgebung. Default-Wert wird als Platzhalter angezeigt. |
141 |
141 |
; Mandant-Nummer |
142 |
142 |
: Die Mandant-Nummer ist den ePayBL Vertragsdaten zu entnehmen. Default-Wert wird als Platzhalter angezeigt. |
143 |
143 |
; Bewirtschafter-Nummer |
... |
... |
@@ -152,7 +152,6 @@ |
152 |
152 |
: Der Fälligkeitszeitraum ist frei wählbar. Default-Wert wird als Platzhalter angezeigt. |
153 |
153 |
; Buchungstext auf der PayPage |
154 |
154 |
: Der Buchungstext ist frei wählbar. Default-Wert wird als Platzhalter angezeigt. |
155 |
|
-: Eingabe muss dem Pattern //^[\w\-\./+\ @,\:\&\'\?\#{}\(\)\[\]\u00C0-\u017F\u1E9E]*$// entsprechen |
156 |
156 |
; Unterstütze Zahlverfahren |
157 |
157 |
: Eingrenzung der Zahlverfahren nötig. Default-Auswahl wird initial übernommen. |
158 |
158 |
; Zertifikat |
... |
... |
@@ -163,16 +163,3 @@ |
163 |
163 |
: Default-Wert wird als Platzhalter angezeigt. |
164 |
164 |
; Port |
165 |
165 |
: Der Port zum Proxy-Host. Default-Wert wird als Platzhalter angezeigt. |
166 |
|
- |
167 |
|
-=== Zahlverfahren === |
168 |
|
- |
169 |
|
-In {{formcycle/}} müssen die verfügbaren Zahlverfahren ausgewählt werden, welche von Ihrem ePayBL-System unterstützt werden. Aktuell werden folgende Zahlverfahren unterstützt: |
170 |
|
- |
171 |
|
-; Giropay |
172 |
|
-; Kreditkarte |
173 |
|
-; PayPal |
174 |
|
-; PayDirekt |
175 |
|
-; Überweisung |
176 |
|
-; Lastschrift ohne Einzugsermächtigung |
177 |
|
- |
178 |
|
-Sobald in {{formcycle/}} Zahlverfahren angegeben werden, welche nicht im ePayBL-System erlaubt sind, kommt eine Fehlermeldung. Sie können die Zahlverfahren auf ein Minimum von einem Zahlverfahren eingrenzen. |