FashionCheque

FashionCheque in BE-terna POS einrichten und Aktivierung, Guthabenabfrage, Einlösung und Auszahlung an der Kasse verwenden.

Zweck

Mit FashionCheque wird der externe Gutscheinkartenanbieter Fashioncheque an BE-terna POS angebunden. Nach der Einrichtung können FashionCheque-Karten an den zugeordneten Kassen aktiviert, das Guthaben abgefragt sowie Guthaben eingelöst und ausgezahlt werden.

Die Kommunikation mit Fashioncheque erfolgt über die FCCS-API. BE-terna POS authentifiziert jede Anfrage mit den Zugangsdaten aus der Gutscheinkarten-Einrichtung und protokolliert Anfrage, Antwort und Transaktionsstatus im Gutscheinkartenposten.

Voraussetzungen

  • BE-terna POS und die betroffenen Kassenstämme sind eingerichtet.
  • Ein Standardzahlungsmittel der Art Gutscheinkarte ist vorhanden.
  • Die API-Basis-URL, der API-Schlüssel, das API-Secret und die Händler-ID wurden von Fashioncheque bereitgestellt.
  • Der dreistellige Währungscode für die Transaktionen ist bekannt.
  • Für einen Funktionstest stehen eine Testkasse und geeignete Testkarten zur Verfügung.

Empfohlene Reihenfolge

  1. Die Gutscheinkarten-Einrichtung wird geöffnet und ein Eintrag für die gewünschte Kombination aus Lagerort und Kasse angelegt.
  2. Als Anbieter wird Fashioncheque und als Art Gutscheinkarte gewählt.
  3. Die von Fashioncheque bereitgestellten Verbindungsdaten werden erfasst.
  4. Die benötigten Vorgänge und anschließend die Einrichtung werden aktiviert.
  5. Aktivierung, Guthabenabfrage, Einlösung und gegebenenfalls Auszahlung werden vollständig an einer Testkasse getestet.
  6. Erst nach erfolgreichem Test werden die produktiven Zugangsdaten hinterlegt.

Einrichtungen

Gutscheinkarten-Einrichtung öffnen

Die Gutscheinkarten-Einrichtung wird über die Suche in Business Central geöffnet. Für jede Kasse, die FashionCheque verwenden soll, wird ein eigener Eintrag angelegt. Die Kombination aus Lagerort und Kasse bestimmt, an welcher Kasse die Einrichtung und die zugehörigen Funktionen verfügbar sind.

Im Feld Anbieter wird der Wert Fashioncheque gewählt. Dadurch wird der Bereich Fashioncheque mit den anbieterspezifischen Verbindungsfeldern eingeblendet. Die Einrichtung wird erst aktiviert, nachdem alle Pflichtfelder ausgefüllt und geprüft wurden.

FashionCheque-Einrichtung mit allgemeinen Einstellungen und Verbindungsdaten Zum Vergrößern anklicken

Allgemeine Einstellungen

Feld Beschreibung
Lagerort Lagerort der Kasse, für die FashionCheque eingerichtet wird.
Kasse Kassenstamm, an dem die FashionCheque-Funktionen bereitgestellt werden.
Anbieter Hier wird Fashioncheque gewählt.
Aktiv Aktiviert die Gutscheinkarten-Einrichtung für die zugeordnete Kasse.
Art Bezeichnung der Kartenart an der Kasse, üblicherweise Gutscheinkarte.

Vorgänge festlegen

Einstellung Empfehlung und Wirkung
Betrag abtragen Diese Einstellung wird aktiviert, damit Einlösungen vom verfügbaren Kartenguthaben abgezogen werden.
Restbetrag drucken Gibt an, ob das verbleibende Guthaben auf dem Bon ausgegeben wird.
Aktivierung erlaubt Blendet die Kassenfunktion zur Aktivierung ein und erlaubt die Aktivierung einer neuen Karte.
Aufladung erlaubt Eine Aufladung einer bestehenden Gutscheinkarte ist bei diesem Anbieter nicht möglich.
Guthabenabfrage erlaubt Blendet die Kassenfunktion zur Abfrage des aktuellen Guthabens ein.
Einlösung erlaubt Erlaubt die Verwendung einer FashionCheque-Karte als Zahlungsmittel.
Auszahlung erlaubt Blendet die Kassenfunktion zur Auszahlung von Kartenguthaben ein. Diese Funktion darf nur aktiviert werden, wenn Auszahlungen organisatorisch zulässig sind.

Verbindung konfigurieren

Feld Beschreibung
URL Basis-URL der FCCS-API. Je nach Umgebung wird die von Fashioncheque bereitgestellte Test- oder Produktiv-URL verwendet.
API-Schlüssel API-Schlüssel für die Authentifizierung. Das Feld ist ein Pflichtfeld und wird maskiert dargestellt.
API-Secret Geheimer Schlüssel für die Signierung der Anfragen. Das Feld ist ein Pflichtfeld und wird maskiert dargestellt.
Händler-ID Von Fashioncheque bereitgestellte Kennung des Händlers.
Währungscode Dreistelliger Währungscode der Transaktionen. Wenn möglich, wird der lokale Währungscode vorgeschlagen; andernfalls wird EUR verwendet.
Timeout Maximale Wartezeit für eine FCCS-Anfrage in Millisekunden. Der Wert 0 verwendet die Standardwartezeit der HTTP-Kommunikation.

API-Schlüssel und API-Secret müssen vertraulich aufbewahrt werden. Für Test- und Produktivsysteme werden die jeweils vorgesehenen Zugangsdaten verwendet.

FashionCheque-Karte aktivieren

  1. An der Kasse wird Aktivierung Gutscheinkarte gewählt.
  2. Die Kartennummer wird gescannt oder manuell eingegeben.
  3. Der Aktivierungsbetrag wird erfasst und der Vorgang bestätigt.
  4. Die FashionCheque-Transaktion wird in der Bonrolle geprüft.

Kassenfunktion zur Aktivierung einer FashionCheque-Karte Zum Vergrößern anklicken

Guthaben abfragen

  1. An der Kasse werden die Funktionen geöffnet.
  2. Guthaben Gutscheinkarte wird gewählt.
  3. Die Karte wird gescannt oder die Kartennummer manuell eingegeben.
  4. Die Eingabe wird bestätigt. Die Kasse zeigt das verfügbare Guthaben und, sofern von Fashioncheque geliefert, das Ablaufdatum an.

Kassenfunktion zur Guthabenabfrage einer FashionCheque-Karte Zum Vergrößern anklicken

Guthaben einlösen

Für die Einlösung müssen die Gutscheinkarten-Einrichtung aktiv, Einlösung erlaubt eingeschaltet und ein Standardzahlungsmittel der Art Gutscheinkarte vorhanden sein.

Die Einstellung Betrag abtragen bestimmt, welcher Betrag eingelöst wird:

Einstellung Verhalten
Aktiviert Es kann ein Teilbetrag eingegeben werden. Der Betrag darf weder den offenen Bonbetrag noch das verfügbare Kartenguthaben überschreiten. Über Total wird automatisch der kleinere Wert aus offenem Bonbetrag und Kartenguthaben vorgeschlagen.
Deaktiviert Die Kasse verwendet das gesamte verfügbare Kartenguthaben als Einlösungsbetrag. Diese Einstellung sollte nur verwendet werden, wenn FashionCheque-Karten immer vollständig eingelöst werden sollen.

Die Einlösung erfolgt in diesen Schritten:

  1. Die Verkaufspositionen werden erfasst und der Bezahlvorgang gestartet.
  2. Das Zahlungsmittel der Art Gutscheinkarte wird gewählt.
  3. Die FashionCheque-Karte wird gescannt oder die Kartennummer eingegeben.
  4. Der einzulösende Betrag wird eingegeben oder der Vorschlag über Total übernommen.
  5. Der Betrag wird bestätigt. Erst jetzt sendet die Kasse die Einlösung an Fashioncheque.

Bei erfolgreicher Einlösung legt die Kasse eine eigene Zahlungszeile mit Kartennummer, Betrag und Transaktions-ID an. Wenn Restbetrag drucken aktiviert ist, erscheint das verbleibende Guthaben in der Bonrolle und auf dem Bon.

Mehrere FashionCheque-Karten verwenden

Ein Bon kann mit mehreren unterschiedlichen FashionCheque-Karten bezahlt werden. Der Einlösungsvorgang wird für jede Karte wiederholt. Dieselbe Kartennummer kann innerhalb eines Bons nicht erneut verwendet werden.

Jede erfolgreiche Einlösung erzeugt eine separate Zahlungszeile und reduziert den offenen Bonbetrag. Dadurch lassen sich auch kleine und variable Beträge ab 0,01 EUR verarbeiten, sofern die Betragsgrenzen der Karte und des Fashioncheque-Produkts dies zulassen.

Mit anderen Zahlungsarten kombinieren

Reicht das FashionCheque-Guthaben nicht aus, wird der verbleibende Bonbetrag mit einer weiteren FashionCheque-Karte oder einem anderen zulässigen Zahlungsmittel, beispielsweise Bar- oder Kartenzahlung, beglichen. Jede Teilzahlung wird separat im Bon geführt.

Schlägt eine weitere Teilzahlung fehl, wird für diesen Versuch keine erfolgreiche Zahlungszeile angelegt. Bereits bestätigte FashionCheque- oder andere Zahlungszeilen bleiben im offenen Bon bestehen. Der fehlgeschlagene Vorgang kann wiederholt werden. Alternativ werden die bereits erfassten Zahlungen wie im folgenden Abschnitt beschrieben storniert.

Guthaben auszahlen

Die Taste Gutscheinkartenauszahlung ist nur verfügbar, wenn die Einrichtung aktiv, Auszahlung erlaubt eingeschaltet und ein Standardzahlungsmittel der Art Gutscheinkarte vorhanden ist. Außerdem darf der aktuelle Verkaufsbon noch keine Verkaufsposition enthalten.

  1. Gutscheinkartenauszahlung wird gewählt.
  2. Die Karte wird gescannt oder die Kartennummer eingegeben.
  3. Der Auszahlungsbetrag wird erfasst und bestätigt.
  4. Der Abschluss des Vorgangs wird an der Kasse geprüft.

Kassenfunktion zur Auszahlung von FashionCheque-Guthaben Zum Vergrößern anklicken

Stornierung

FashionCheque unterstützt die Stornierung einer erfolgreichen Aktivierung und einer erfolgreichen Einlösung, solange der Bon noch nicht abgeschlossen ist. Für die Bedienung ist die Berechtigung zum Stornieren an der Kasse erforderlich.

Ursprünglicher Vorgang Verhalten beim Storno
Aktivierung Die Kasse sendet die Transaktions-ID der Aktivierung an Fashioncheque und hebt die Aktivierung auf.
Einlösung Die Kasse sendet eine Gegenbuchung mit Betrag und ursprünglicher Transaktions-ID an Fashioncheque.
Guthabenabfrage Kein Storno erforderlich oder möglich, da kein Guthaben verändert wurde.
Auszahlung Eine direkte FashionCheque-Stornierung ist nicht implementiert.

Aktivierung stornieren

  1. Im offenen Bon wird die Zeile der FashionCheque-Aktivierung markiert.
  2. Storno wird gewählt.
  3. Die Bestätigung von Fashioncheque wird abgewartet.
  4. Anschließend wird geprüft, ob die Aktivierungszeile als storniert gekennzeichnet ist.

Da die Aktivierung erst nach der Bestätigung von Kartennummer und Betrag übertragen wird, löst das Abbrechen während der Erfassung noch kein Storno aus. Wird der Bon erst nach einer erfolgreichen Aktivierung abgebrochen, führt die Kasse die Stornierung über Fashioncheque aus.

Einzelne Einlösung stornieren

  1. Die betreffende FashionCheque-Zahlungszeile wird markiert.
  2. Zahlung stornieren wird gewählt.
  3. Die Bestätigung von Fashioncheque wird abgewartet.
  4. Anschließend wird geprüft, ob die Zahlungszeile als storniert gekennzeichnet und der Betrag wieder als offen angezeigt wird.

Bei mehreren FashionCheque-Karten wird die Zahlungszeile der betroffenen Karte ausgewählt. Die Kasse verwendet deren Transaktions-ID, sodass nur diese Einlösung zurückgesetzt wird.

Gesamten Bon stornieren

  1. Im noch offenen Bon wird Bon stornieren gewählt.
  2. Die Rückfrage zum vollständigen Storno wird bestätigt.
  3. Die Kasse verarbeitet alle nicht stornierten Verkaufs- und Zahlungszeilen nacheinander. Jede erfolgreiche FashionCheque-Aktivierung und -Einlösung wird dabei separat zurückgesetzt.
  4. Bei Mehrkarten- oder Split-Zahlungen werden jede betroffene Zahlungszeile und der zugehörige Gutscheinkartenposten geprüft.

Schlägt ein Teil des Rollbacks fehl, kann der Bon bereits zuvor erfolgreich zurückgesetzte Transaktionen enthalten. Das gesamte Storno darf nicht pauschal wiederholt werden. Zuerst müssen die einzelnen Gutscheinkartenposten und die Fashioncheque-Fehlermeldung geprüft werden. Ein bereits zurückgesetzter Vorgang wird von Fashioncheque mit einer entsprechenden Meldung abgewiesen.

Mögliche Fehlermeldungen

Die Kasse zeigt Fashioncheque-Fehler zusammen mit der vom Anbieter gelieferten Ursache an. Die genaue Sprache der Meldung hängt von der installierten Übersetzung ab.

Meldung oder Situation Ursache Maßnahme
Gutscheinkartenaktion ist nicht erlaubt Die zugehörige Einstellung, beispielsweise Einlösung erlaubt, ist ausgeschaltet. In der Gutscheinkarten-Einrichtung darf nur die fachlich freigegebene Aktion aktiviert werden.
Kein aktives Gutscheinkarten-Setup oder kein Standardzahlungsmittel gefunden Die Einrichtung ist nicht aktiv oder das Standardzahlungsmittel der Art Gutscheinkarte fehlt. Lagerort, Kasse, Aktiv und das Standardzahlungsmittel werden geprüft.
Pflichtfeld ist nicht ausgefüllt URL, API-Schlüssel, API-Secret, Händler-ID oder Währungscode fehlt. Das genannte Feld wird in der FashionCheque-Einrichtung ergänzt.
Karte bereits im Bon Dieselbe Kartennummer wurde im aktuellen Bon bereits aktiviert oder eingelöst. Es wird eine andere Karte verwendet oder zuerst die vorhandene Zeile storniert.
Einlösungsbetrag ist höher als Restguthaben Der eingegebene Betrag überschreitet das von Fashioncheque gemeldete Guthaben. Der Betrag wird reduziert oder Total verwendet.
Überzahlung nicht erlaubt Der Betrag überschreitet den noch offenen Bonbetrag und das Zahlungsmittel erlaubt keine Überzahlung. Der Betrag wird auf den offenen Bonbetrag reduziert.
Karte ist noch nicht aktiv, inaktiv, abgelaufen oder hat einen ungültigen Status Der Kartenstatus erlaubt den angeforderten Vorgang nicht. Dies betrifft beispielsweise Testkarten mit Status inactive, suspended oder expired. Karte und Vorgang werden geprüft. Es wird eine gültige Karte verwendet oder der Status mit Fashioncheque geklärt.
Karte nicht gefunden oder Kartennummer nicht erkannt Die Kartennummer ist unvollständig, unbekannt oder nicht lesbar. Die Karte wird erneut gescannt oder die manuelle Eingabe geprüft.
Ungültiger Betrag oder Betragsgrenze verletzt Der Betrag liegt unter dem Mindestbetrag, über dem Transaktionslimit oder besitzt ein ungültiges Format. Der Betrag wird gemäß den Produktgrenzen korrigiert.
Unzureichendes Guthaben Das Kartenguthaben reicht für die Einlösung nicht aus. Es wird ein kleinerer Teilbetrag verwendet und der Rest mit einer weiteren Zahlungsart beglichen.
Währung wird nicht unterstützt oder stimmt nicht überein Einrichtung und Karte verwenden unterschiedliche Währungen oder der Währungscode wird nicht unterstützt. Der dreistellige Währungscode wird in der Einrichtung geprüft.
Händler nicht gefunden oder Händler inaktiv Die Händler-ID ist falsch oder das Händlerkonto ist nicht aktiv. Die Händler-ID wird geprüft und der Händlerstatus durch Fashioncheque kontrolliert.
Händler ist für Annahme, Aktivierung oder Auszahlung nicht berechtigt Der konfigurierte Händler darf den angeforderten Vorgang oder das Produkt nicht verwenden. Freischaltung und Produktzuordnung werden bei Fashioncheque geprüft.
Produkt nicht aktiv oder kein digitaler Gutschein verfügbar Das Fashioncheque-Produkt ist für den Händler nicht aktiv oder momentan nicht verfügbar. Die Produktfreischaltung wird bei Fashioncheque geprüft.
HTTP-Fehler oder keine bestätigten Transaktionsdaten Die FCCS-API ist nicht erreichbar, antwortet mit einem Fehlerstatus oder liefert keine bestätigte Transaktion. URL, Netzwerk, Timeout und Anbieterstatus werden geprüft. Vor einem erneuten Versuch wird der Gutscheinkartenposten kontrolliert.
Originaltransaktion nicht gefunden Für die ausgewählte Zeile wurde keine erfolgreiche, noch nicht stornierte FashionCheque-Transaktion gefunden. Bon-, Zeilen- und Transaktions-ID werden im Gutscheinkartenposten geprüft.
Transaktion bereits zurückgesetzt Die Originaltransaktion wurde bereits erfolgreich storniert. Es darf kein weiteres Storno ausgeführt werden. Der Kassenstatus wird mit dem Gutscheinkartenposten abgeglichen.
Transaktion kann nicht zurückgesetzt werden Fashioncheque lehnt das Storno für den Vorgang oder Status ab. Vorgangsart und Kartenstatus werden geprüft; der Fall wird gegebenenfalls mit Fashioncheque geklärt.
Process FashionCheque vor dem Produktivbetrieb prüfen Einrichtung, Kommunikation und alle freigegebenen Kassenfunktionen werden getestet.
  • Die korrekte Zuordnung von Lagerort und Kasse wird geprüft.
  • Während des Tests werden ausschließlich die Test-URL, Testzugangsdaten und Testkarten verwendet.
  • Bei der Aktivierung werden der Kartenscan, verschiedene Beträge und der Zeitpunkt der Übertragung nach der Betragsbestätigung geprüft.
  • Ein Bon wird nach erfolgreicher Aktivierung abgebrochen und der Rollback geprüft.
  • Aktivierung und Einlösung werden mit abgelaufenen, gesperrten und inaktiven Testkarten sowie mit nicht freigeschaltetem Produkt und inaktiver Händler-ID getestet.
  • Einlösungen von 0,01 bis 0,10 sowie weitere variable Beträge werden getestet.
  • Ein Bon wird mit mehreren unterschiedlichen FashionCheque-Karten bezahlt.
  • FashionCheque wird mit Bar- oder Kartenzahlung kombiniert und der offene Restbetrag nach jeder Teilzahlung geprüft.
  • Bei einer Mehrkarten- oder Split-Zahlung wird ein Fehler simuliert. Anschließend werden alle bereits erfolgreichen Teilzahlungen storniert.
  • Nach jeder Transaktion und jedem Storno werden der Bon sowie der zugehörige Gutscheinkartenposten geprüft.

Links

Weiterführende Informationen

Weiterführende Seiten