Das Programm "Fiscal Service Client Sample" dient als Hilfestellung bei der Implementierung von diversen Geschäftsfällen. Der "Sample-Client" erzeugt die im Normalfall an den Fiskal Client zu übermittelnde JSON-Struktur bei bestimmten Geschäftsfällen.

Die Applikation wird mit jeder Version des Fiskal-Clients ausgeliefert und steht im Verzeichnis .../Samples/ als Download zur Verfügung. Nach dem Entpacken der .zip-Datei, empfiehlt es sich, diese in das RetailForce Verzeichnis zu kopieren (unter Windows: C:\ProgramData\RetailForce\>).

Der Sample-Client selbst befindet sich dann unter: \FiscalServiceClientSample\bin\Debug>FiscalServiceClientSample.exe 

Test Client

Das Programm stellt mehrere Test-Client zur Verfügung. Damit die Applikation auch verwendet werden kann, muss nach dem Programmstart ein Test-Client ausgewählt werden. In den nachfolgenden Beispielen wird der Test-Client c1062c55-57c4-4ed2-9c53-aff1762326a4: (001-01 Testfiliale 001 (Germany, {c1062c55-57c4-4ed2-9c53-aff1762326a4})) verwendet.

Anschließend können über die bereitgestellten Funktionen diverse Geschäftsfälle konstruiert werden. 

Beispiel - einfacher Verkaufsbeleg

In diesem Beispiel wird der Verkauf eines Artikels bei Barzahlung des Kunden abgebildet und die JSON-Struktur ausgegeben.

1. Dokumenten-Type (DocumentType) auswählen - in diesem Fall "Receipt" für einen regulären Verkaufsbeleg.
2. Einen Artikel über das Drop-Down Menü auswählen - im Beispiel wird ein Laib Brot verkauft.
3. Auf den Button "Add" klicken, um den gewählten Artikel hinzuzufügen.
4. Bezahlart (PaymentType) auswählen - im Beispiel "Cash" für eine Zahlung in Bargeld.

Anschließend kann die JSON-Struktur des Geschäftsfalls ausgegeben werden.

1. Klicken Sie auf den Button "Show document json".
2. über den Button "Copy Json" wird das gesamte JSON-Dokument in die Zwischenablage kopiert.

Bedienelemente

• Client - Auswahl des zu verwendeten Clients
• DocType - Auswahl des Dokumenten Typs (DocumentType) es stehen die im Artikel Dokumenttypen und Verwendung in den spezifischen Ländern beschriebenen Dokumententypen zur Verfügung.
  • User (Id/Caption) - Eingabemöglichkeit für Bedienerdaten (ID und Bezeichnung/Name).
  • Training - Checkbox für die Aktivierung des Trainingsmodus für den Beleg (Beleg = Trainingsbeleg).
  • Tischauswahl - Drop-Down zur Auswahl der Tischzuordnung.
  • Void with ref. - Stornierungsbeleg mit Referenz auf einen zuvor ausgestellten Beleg.
• Item/Qty - Artikelauswahl und Menge (Zahlenfeld ganz rechts).
  • Inhouse - markieren einer Inhaus-Konsumation (Gastronomie).
  • Zahlenfeld - festlegen der Artikelmenge.
  • Add - hinzufügen des Artikels und der gewählten Menge zum Dokument.
• Booking - festlegen des Geschäftsfalls (je Beleg können mehrere Geschäftsfälle definiert werden); die im Artikel Geschäftsfälle - BusinessTransactionTypes beschriebenen Geschäftsfälle stehen zur Auswahl.
  • Dropdown-Menü USt. - Auswahl der USt.
  • Zahlenfeld - Festlegen des Wertes in der gewählten Währung (EUR)
  • Add - hinzufügen des Artikels und der gewählten Menge zum Dokument.
• Client control
  • Get status - Abfrage Client Status 
  • Add customer - Hinzufügen von Kundeninformationen (Eingabe in Feld links)
  • Rem customer - 
  • Delete Position - Position löschen
  • 10% discount - hinzufügen 10% Rabatt
  • Allowan - hinzufügen von X (Wert in EUR) Zuschuss
  • Sub Total - Hinzufügen Zwischensumme
  • Cancel pos. - stornieren der Position
• Auswahl PaymentTypes
  • Cash - Zahlungsmittel Bargeld
  • EC Payment - Zahlungsmittel Bankkarte
  • CreditCard - Zahlungsmittel Kreditkarte
  • MultiPurpose Voucher - Zahlungsmittel Mehrzweck-Gutschein
  • Deposit dissolve - Zahlungsmittel Auflösung Anzahlung
  • SinglePurposeVoucher - Zahlungsmittel Einzweck-Gutschein
• Send document json - JSON-Dokument schicken
• Show document json - Anzeigen des JSON-Dokuments 
• Clear document - Dokument bereinigen - zum Start eines neuen Geschäftsfalles
• Validate - Funktion validateDocument
• Store - Funktion storeDocument
• Get EndofDay - Erzeugen Tagesabschluss
• Qr Code - Anzeigen QR-Code