Änderungen von Dokument Verwendung


Von Version 15.1
bearbeitet von rth
am 06.01.2022, 14:24
Änderungskommentar: Neues Bild plugin_init_result.png hochladen
Auf Version 16.4
bearbeitet von rth
am 02.02.2022, 09:44
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -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!
... ... @@ -223,9 +223,58 @@
223 223  ==== 2.1.1 Rückgabewerte der Workflow-Aktion ====
224 224  
225 225  {{figure image="plugin_init_result.png"}}
226 -Konfiguration AKDB EPayment-Mandant
230 +Rückgabewert und Fehlercodes der Aktion
227 227  {{/figure}}
228 228  
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.
229 229  {{id name="plugin_event_epay_success"/}}
230 230  
231 231  === 2.2. Workflow-Ereignis //Bezahlung erfolgreich// ===
... ... @@ -280,6 +280,31 @@
280 280  
281 281  == Versionshistorie ==
282 282  
336 +(% class="wikigeneratedid" %)
337 +=== 3.4.3 ===
338 +
339 +* 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.
340 +
341 +(% class="wikigeneratedid" %)
342 +=== 3.4.2 ===
343 +
344 +* Fehlerbehebung: ein Anzeige-Fehler bei der Berechnung des Gesamtpreises für einen EPayment-Bestellartikel wurde behoben
345 +* Fehlerbehebung: Aufgrund von Fehlern beim Decodieren und Entschlüsseln von URL-Parametern, wurde die Verschlüsselungs-Routine angepasst.
346 +
347 +=== 3.4.1 ===
348 +
349 +* Fehlerbehebung EPayment Bestellartikel: Die Werte der widget-internen HTML-Elemente sind bei einer Zwischenspeicherung nicht berücksichtigt worden. Dies wurde behoben.
350 +
351 +=== 3.4.0 ===
352 +
353 +* Erweiterung AKDB ePay Setup: Ein Verbindungstest ist jetzt auch ohne Konfiguration eines AKDB-Mandanten möglich.
354 +* Anpassung EPayment Bestellartikel: HTML-Elemente innerhalb des Widgets um 'data-' Präfix erweitert
355 +* Fehlerbehebung: Session-Replacer werden bei Verarbeitung der Workflow-Ereignisse berücksichtigt. 
356 +
357 +=== 3.3.1 ===
358 +
359 +* 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.
360 +
283 283  === 3.3.0 ===
284 284  
285 285  * Plugin benötigt mindestens {{formcycle/}} in der Version {{version major="7" patch="9"}}{{/version}}