| ... |
... |
@@ -1,7 +5,3 @@ |
| 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 |
|
- |
| 5 |
5 |
{{info}} |
| 6 |
6 |
**Achtung:** |
| 7 |
7 |
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! |
| ... |
... |
@@ -176,9 +176,9 @@ |
| 176 |
176 |
: Der hier festgelegte Buchungstext wird dem Benutzer auf der PayPage angezeigt. |
| 177 |
177 |
{{/panel}} |
| 178 |
178 |
|
| 179 |
|
-{{panel title="Definition zusätzlicher Bestellpositionen" fullwidth="true" triggerable="true"}} |
|
175 |
+{{panel title="Kundenstammdaten" fullwidth="true" initial="visible" triggerable="true"}} |
| 180 |
180 |
|
| 181 |
|
-{{figure image="plugin_init_config_bestellposition.png"}} |
|
177 |
+{{figure image="plugin_init_config_akdb_bestellposition.png"}} |
| 182 |
182 |
Konfiguration von zusätzlichen Bestellpositionen |
| 183 |
183 |
{{/figure}} |
| 184 |
184 |
|
| ... |
... |
@@ -193,8 +193,6 @@ |
| 193 |
193 |
; Belegnummer |
| 194 |
194 |
: Die Belegnummer ist ein optionaler Wert, welcher zur weiterführenden Verarbeitung auf Seiten von ePay-BL dient. |
| 195 |
195 |
|
| 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 |
|
- |
| 198 |
198 |
{{/panel}} |
| 199 |
199 |
|
| 200 |
200 |
{{panel title="Konfiguration AKDB ePayment-Mandant" fullwidth="true" initial="visible" triggerable="true"}} |
| ... |
... |
@@ -224,61 +224,6 @@ |
| 224 |
224 |
|
| 225 |
225 |
{{/panel}} |
| 226 |
226 |
|
| 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. |
| 282 |
282 |
{{id name="plugin_event_epay_success"/}} |
| 283 |
283 |
|
| 284 |
284 |
=== 2.2. Workflow-Ereignis //Bezahlung erfolgreich// === |
| ... |
... |
@@ -333,43 +333,6 @@ |
| 333 |
333 |
|
| 334 |
334 |
== Versionshistorie == |
| 335 |
335 |
|
| 336 |
|
-(% class="wikigeneratedid" %) |
| 337 |
|
-=== 3.5.0 === |
| 338 |
|
- |
| 339 |
|
-* Erweiterungen: EPayment-Verifikation-Aktion (V6) um 'Zahlverfahren' erweitert. |
| 340 |
|
-Trigger (Workflow V7) um genutztes 'Zahlverfahren' innerhalb der Rückgabewerte erweitert. |
| 341 |
|
-Error-Trigger (Workflow V7) um 'PaymentVerifyUrl' erweitert. Dieser Parameter kann zum nochmaligen Aufruf der Verifizierung einer Bezahlung genutzt werden. |
| 342 |
|
-* Erweiterung AKDB ePay Setup: Eingabemöglichkeit für Daten des anzubindenden ePayment-Mandanten; Zusätzlicher Hinweis auf freizugebende URLs (notwendige Firewall-Freigaben) |
| 343 |
|
- |
| 344 |
|
-=== 3.4.3 === |
| 345 |
|
- |
| 346 |
|
-* Fehlerbehebung bei Rückleitung von der PayPage zum Formular: In einigen Fällen, insbesondere bei Kommunikation über den Frontend-Server, kam es zu Störungen beim Auslösen der nachgelagerten Workflow-Verarbeitung. Dies wurde behoben. |
| 347 |
|
- |
| 348 |
|
-=== 3.4.2 === |
| 349 |
|
- |
| 350 |
|
-* Fehlerbehebung: ein Anzeige-Fehler bei der Berechnung des Gesamtpreises für einen EPayment-Bestellartikel wurde behoben |
| 351 |
|
-* Fehlerbehebung: Aufgrund von Fehlern beim Decodieren und Entschlüsseln von URL-Parametern, wurde die Verschlüsselungs-Routine angepasst. |
| 352 |
|
- |
| 353 |
|
-=== 3.4.1 === |
| 354 |
|
- |
| 355 |
|
-* Fehlerbehebung EPayment Bestellartikel: Die Werte der widget-internen HTML-Elemente sind bei einer Zwischenspeicherung nicht berücksichtigt worden. Dies wurde behoben. |
| 356 |
|
- |
| 357 |
|
-=== 3.4.0 === |
| 358 |
|
- |
| 359 |
|
-* Erweiterung AKDB ePay Setup: Ein Verbindungstest ist jetzt auch ohne Konfiguration eines AKDB-Mandanten möglich. |
| 360 |
|
-* Anpassung EPayment Bestellartikel: HTML-Elemente innerhalb des Widgets um 'data-' Präfix erweitert |
| 361 |
|
-* Fehlerbehebung: Session-Replacer werden bei Verarbeitung der Workflow-Ereignisse berücksichtigt. |
| 362 |
|
- |
| 363 |
|
-=== 3.3.1 === |
| 364 |
|
- |
| 365 |
|
-* 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. |
| 366 |
|
- |
| 367 |
|
-=== 3.3.0 === |
| 368 |
|
- |
| 369 |
|
-* Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}} |
| 370 |
|
-* Erweiterung Workflow-Aktion //Bestellung übermitteln//: Möglichkeit für serverseitige Definition von Bestellpositionen |
| 371 |
|
-* 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. |
| 372 |
|
- |
| 373 |
373 |
=== 3.2.0 === |
| 374 |
374 |
|
| 375 |
375 |
* Erweiterung EPayment Bestellartikel: Am Element ist der Gesamtpreis (Anzahl * Einzelpreis) als verstecktes Element verfügbar. Dieser kann über die CSS-Klasse 'CXOrderItemTotalPrice' eingeblendet werden. |
