| ... |
... |
@@ -1,3 +1,7 @@ |
|
1 |
+[[**Plugin download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-akdb-epayment&fileid=2674||rel="noopener noreferrer" target="_blank"]] (requires login) |
|
2 |
+ |
|
3 |
+{{content/}} |
|
4 |
+ |
| 1 |
1 |
{{info}} |
| 2 |
2 |
**Achtung:** |
| 3 |
3 |
Bevor Sie die AKDB EPayment in ihren Formular-Prozessen einbinden, stellen Sie bitte sicher, dass die konfigurative Anbindung des Dienstes durch den {{formcycle/}}-Administrator erfolgt ist! |
| ... |
... |
@@ -172,9 +172,9 @@ |
| 172 |
172 |
: Der hier festgelegte Buchungstext wird dem Benutzer auf der PayPage angezeigt. |
| 173 |
173 |
{{/panel}} |
| 174 |
174 |
|
| 175 |
|
-{{panel title="Kundenstammdaten" fullwidth="true" initial="visible" triggerable="true"}} |
|
179 |
+{{panel title="Definition zusätzlicher Bestellpositionen" fullwidth="true" triggerable="true"}} |
| 176 |
176 |
|
| 177 |
|
-{{figure image="plugin_init_config_akdb_bestellposition.png"}} |
|
181 |
+{{figure image="plugin_init_config_bestellposition.png"}} |
| 178 |
178 |
Konfiguration von zusätzlichen Bestellpositionen |
| 179 |
179 |
{{/figure}} |
| 180 |
180 |
|
| ... |
... |
@@ -189,6 +189,8 @@ |
| 189 |
189 |
; Belegnummer |
| 190 |
190 |
: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient. |
| 191 |
191 |
|
|
196 |
+Ü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. |
|
197 |
+ |
| 192 |
192 |
{{/panel}} |
| 193 |
193 |
|
| 194 |
194 |
{{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
| ... |
... |
@@ -218,6 +218,61 @@ |
| 218 |
218 |
|
| 219 |
219 |
{{/panel}} |
| 220 |
220 |
|
|
227 |
+==== 2.1.1 Rückgabewerte der Workflow-Aktion ==== |
|
228 |
+ |
|
229 |
+{{figure image="plugin_init_result.png"}} |
|
230 |
+Rückgabewert und Fehlercodes der Aktion |
|
231 |
+{{/figure}} |
|
232 |
+ |
|
233 |
+__Rückgabewerte__ |
|
234 |
+ |
|
235 |
+; [%$[Name der Aktion].RESULT.BestellPosition[i]['key']%] |
|
236 |
+: Eine Auflistung über alle Bestell-Positionen, welche in der aktuellen Bestellung enthalten sind. |
|
237 |
+Zu jeder Bestell-Position können folgende Werte abgefragt werden: |
|
238 |
+ |
|
239 |
+((( |
|
240 |
+* **Artikelnummer**: Die am //EPayment Artikel// hinterlegte eindeutige Kennung für den Artikel |
|
241 |
+* **Buchungstext**: Der übermittelte Buchungstext (max.21 Zeichen, SEPA konform) |
|
242 |
+* **Menge**: Die bestellte Menge für die aktuelle Bestell-Position |
|
243 |
+* **Beschreibung**: Die am //EPayment Artikel// hinterlegte Artikel-Beschreibung |
|
244 |
+* **Einzelpreis**: Der am //EPayment Artikel// hinterlegte Preis für ein Stück. Ausgabe mit Währungssymbol. |
|
245 |
+* **Preis**: Der errechnete Gesamtpreis für die aktuelle Bestell-Position. Ergibt sich aus //Menge x Einzelpreis//. Ausgabe mit Währungssysmbol |
|
246 |
+ |
|
247 |
+ Nachfolgend einige Beispiele für die Datenabfrage aus den Bestellpositionen: |
|
248 |
+ Für die Beispiele wird folgender durch eine Aktion mit Namen //Bestellung übermitteln// bereitgestellter Platzhalter zu Grunde |
|
249 |
+ gelegt: **[%$Bestellung übermitteln.RESULT.Bestellung[i][''key'']%]** |
|
250 |
+ Die in den eckigen Klammern hinterlegten Werte sind variabel und haben folgende Bedeutung: |
|
251 |
+ |
|
252 |
+ |
|
253 |
+* **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. |
|
254 |
+* **key**: Schlüssel für den Zugriff auf die jeweilige Eigenschaft |
|
255 |
+ |
|
256 |
+ Beispiele: |
|
257 |
+ Abfrage des Einzelpreises an der 1. Bestell-Position: **[%$Bestellung übermitteln.RESULT.Bestellung[0][''Einzelpreis'']%]** |
|
258 |
+ Abfrage der Menge an der 3. Bestell-Position: **[%$Bestellung übermitteln.RESULT.Bestellung[2][''Menge'']%]** |
|
259 |
+))) |
|
260 |
+ |
|
261 |
+; [%$[Name der Aktion].RESULT.BestellPositionAnzahl%] |
|
262 |
+: Die Gesamtanzahl der Bestellpositionen, welche in der aktuellen Bestellung enthalten sind |
|
263 |
+; [%$[Name der Aktion].RESULT.Gesamtbetrag%] |
|
264 |
+: Der in der Zahlungstransaktion ausgewiesene zu zahlende Geldbetrag. Angabe in Euro |
|
265 |
+; [%$[Name der Aktion].RESULT.Kassenzeichen%] |
|
266 |
+: Das aktuelle Kassenzeichen unter dem die Zahlungstransaktion im ePay-BL Portal geführt wird. |
|
267 |
+; [%$[Name der Aktion].RESULT.UrlToPaypage%] |
|
268 |
+: Die URL zur Bezahlseite auf Seiten von ePay-BL, wo die Bezahlung der aktuellen Transaktion durchgeführt werden kann. |
|
269 |
+ |
|
270 |
+__Fehlercodes__ |
|
271 |
+ |
|
272 |
+; NO_ORDER_DATA |
|
273 |
+: Fehlercode, wenn zur Laufzeit keine Bestellpositionen übermittelt wurden. Diese kann beispielweise auftreten, wenn der Formular-Nutzer beispielsweise keine Artikel zum Bestellen ausgewählt hatte. |
|
274 |
+; SRV_NOT_AVIALABLE |
|
275 |
+: Fehlercode, wenn der ePay-BL Service nicht verfügbar ist. |
|
276 |
+; SRV_METHOD_ERROR |
|
277 |
+: Fehlercode, wenn eine ePay-BL Webservice-Methode einen Fehler lieferte. Bei Auftreten von solchen Fehlertypen sollte das |
|
278 |
+{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
|
279 |
+; INTERNAL_ERROR |
|
280 |
+: Fehlercode für einen nicht nähere beschriebenen Fehler. Bei Auftreten von solchen Fehlertypen sollte das |
|
281 |
+{{formcycle/}} interne Fehler-Protokoll für eine tiefere Analyse einbezogen werden. |
| 221 |
221 |
{{id name="plugin_event_epay_success"/}} |
| 222 |
222 |
|
| 223 |
223 |
=== 2.2. Workflow-Ereignis //Bezahlung erfolgreich// === |
| ... |
... |
@@ -272,6 +272,16 @@ |
| 272 |
272 |
|
| 273 |
273 |
== Versionshistorie == |
| 274 |
274 |
|
|
336 |
+=== 3.3.1 === |
|
337 |
+ |
|
338 |
+* 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. |
|
339 |
+ |
|
340 |
+=== 3.3.0 === |
|
341 |
+ |
|
342 |
+* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}} |
|
343 |
+* Erweiterung Workflow-Aktion //Bestellung übermitteln//: Möglichkeit für serverseitige Definition von Bestellpositionen |
|
344 |
+* 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. |
|
345 |
+ |
| 275 |
275 |
=== 3.2.0 === |
| 276 |
276 |
|
| 277 |
277 |
* Erweiterung EPayment Bestellartikel: Am Element ist der Gesamtpreis (Anzahl * Einzelpreis) als verstecktes Element verfügbar. Dieser kann über die CSS-Klasse 'CXOrderItemTotalPrice' eingeblendet werden. |
