Zum Hauptinhalt gehen

Grundsätzlicher Prozess bei der Übertragung von Belegen

Harald Krondorfer
  • Aktualisiert

Erstellen des Fiskalmoduls

Für das Senden von Fiskaldaten (Belegen) muss ein Fiskalmodul kreiert werden. 

  • Wird der Trusted Fiscal Service verwendet, so wird das Fiskalmodul für den jeweiligen konfigurierten Client automatisch instanziert und kreiert.
  • Wird eine Integration mittels direkter Anbindung der .net DLL angestrebt, so ist das Fiskalmodul selbst zu instantiieren. Eine genauere Beschreibung dafür ist hier zu finden:
    Erstellen / Instantiieren eines Fiskalmoduls
Achtung: Das Fiskalmodul initialisiert einige Submodule und sollte nicht für jeden Beleg neu instanziiert werden (z.B. der Selbsttest einer Hardware-Tse dauert ca. 30 Sekunden). Zusätzlich ist die Methode CloudConnect vor der Übertragung von Belegen aufzurufen, ansonsten schlägt die Cloud-Archivierung fehl (nur notwendig, wenn Cloud-Archivierung aktiviert ist).

Belegübermittlung

Um Belege zu übertragen sind folgende 2 Schritte notwendig:

  • CreateDocument
  • StoreDocument

Unabhängig vom jeweiligen implementierten Land empfehlen wir den Aufruf der Methode CreateDocument.

Achtung: CreateDocument muss am Beginn eines Beleges (beim Erfassen eines Artikels) aufgerufen werden. Dies ist zwingend erforderlich um die Fiskalisierung rechtsicher (z.B.: in Deutschland) zu implementieren.

Beispielbeleg als json:

"UniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
"DocumentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
"DocumentId": "2021-02-02T05:31:08.9450964+01:00",
"CreateDate": "2021-02-02T05:31:08.9450964+01:00",
"BookDate": "2021-02-02T05:31:08.9450964+01:00",
"DocumentNumber": null,
"CancellationDocument": false,
"DocumentReference": null,
"IsTraining": false,
"DocumentType": 0,
"DocumentTypeCaption": null,
"User": {
"Id": "1234",
"Caption": "Testuser"
},
"AllocationGroups": [],
"Partner": null,
"FiscalResponse": null, 
"FiscalDocumentNumber": 0, // set fiscaldocument of create document here
"FiscalDocumentRevision": 0, // set fisacldocument revision of create document here
"Positions": [
{
"ItemCaption": "Blume grün", // the caption of the item
"ItemShortCaption": null,
"Discounts": [],
"Type": 0,
"UseSubItemVatCalculation": true,
"SubItems": null,
"Quantity": 1.0,
"QuantityUnit": null,
"ItemId": "000714", // the item id
"BaseNetValue": 3.61, // base value (without discounts)
"BaseGrossValue": 4.3,
"BaseTaxValue": 0.69,
"GTIN": null,
"BusinessTransactionType": 0,
"VatIdentification": 1, 
"VatPercent": 19.0, 
"NetValue": 3.61, // net value (quantity * price)
"GrossValue": 4.3, // gross value of the position
"TaxValue": 0.69,
"AccountingIdentifier": null,
"PositionNumber": 0,
"PositionReference": null,
"CancellationPosition": false
}
],
"Payments": [
{
"Amount": 5.0, // payment with over payment
"IsCash": false,
"CurrencyIsoCode": "EUR",
"Caption": null,
"UniqueReadablePaymentIdentifier": null,
"ForeignAmount": 0.0,
"ForeignAmountExchangeRate": 0.0
},
{
"Amount": -0.7, // cash return (second payment)
"IsCash": false,
"CurrencyIsoCode": "EUR",
"Caption": null,
"UniqueReadablePaymentIdentifier": null,
"ForeignAmount": 0.0,
"ForeignAmountExchangeRate": 0.0
}
]
}

Der Beleg enthält:

  • eine Artikel Position mit Artikel "000714", "Blume grün", mit einem Preis von 4,3 EUR brutto (Menge 1).
  • 2 Zahlungen, 1x 5 EUR und dann 0,7 EUR Rückgeld.
Hinweis: Um zu sehen wie ein Fiskal Beleg (document) zusammengesetzt wird sehen Sie sich bitte das Beispiel "Fiscal Service Client Sample" unter downloads an (http://www.retailforce.cloud/downloads). In diesem Beispiel kann man auch das resultierende JSON ausgeben um es zu veranschaulichen. Stellen Sie bitte sicher, dass der Fiskalservice auf der selben Maschine installiert ist und läuft.

Um ein erstelltes Dokument wieder abzubrechen kann folgende Methode aufgerufen werden:

  • CancelDocument
Achtung: Jedes mit CreateDocument gestartete Dokument muss auch abgeschlossen oder abgebrochen werden.

Um ein Dokument vor der Übertragung zu validieren kann folgende Methode aufgerufen werden

  • ValidateDocument
Info: Das Dokument wird bei jedem Übertragungsvorgang (StoreDocument, CancelDocument) validiert. Im Falle eines Validierungsfehlers wird eine Exception ausgelöst.

Prozesse im Detail

Verkaufsprozess Handel

Der Verkauf von Waren, etwa im Handel, stellt sich wie folgt dar:

Bediener Kassensystem RetailForce Fiscalisation Service
1. Bediener (Kassenbenutzer) erfasst den ersten Artikel, den der Kunde erwerben möchte.    
  2. Kassensystem übermittelt Request an Fiscal Service (createDocument) um den Beginn der entsprechenden Transaktion zu registrieren.  
    3. Fiscal Service nimmt Request vom Vorsystem entgegen und verarbeitet diesen entsprechend der länderspezifischen Anforderungen (z.B. Signierung o.a.).
    4. Fiscal Service antwortet mit einer Response (fiscalResponse) an das Vorsystem.
  5. Kassensystem (Vorsystem) nimmt Response entgegen und speichert Teile davon (bzw. das gesamte Response-Objekt) zur die Weiterverwendung (Referenz) beim Abschluss der Transaktion  
6. Bediener erfasst sämtliche Artikel des Kunden und leitet den Zahlungsprozess ein.    
 

7. Wenn sämtliche Daten der Transaktion feststehen (Artikel, Zahlungsmethode,...), erzeugt das Kassensystem den Payload der Transaktion (JSON) und übermittelt einen weiteren Request an das Fiscal Service (storeDocument), mit dem die Transaktion abgeschlossen (gespeichert) wird.

Bestimmte Informationen aus der im Zuge von createDocument empfangenen fiscalResponse müssen in die Payload mit aufgenommen werden ("fiscalDocumentNumber", "fiscalDocumentStartTime" und ggf. länderspezifische Elemente, wie z.B. "fiscalDocumentRevision" in Deutschland).

Achtung: es darf NICHT das gesamte fiscalResponse-Objekt in die Payload integriert werden sonder nur die oben angeführten Elemente!
  
    8. Fiscal Service nimmt Request vom Vorsystem entgegen und verarbeitet diesen entsprechend der länderspezifischen Anforderungen (z.B. Signierung o.a.).
    9. Fiscal Service antwortet mit einer Response (fiscalResponse) an das Vorsystem.
  10. Kassensystem empfängt die fiscalResponse, extrahiert die für die Belegerstellung notwendigen Informationen (z.B. Belegsignatur, QR-Code,...) und druckt den Beleg.  
11. Bediener übergibt den fertig gedruckten Beleg an den Kunden    

Verkaufsprozess im Handel mit Transaktionsabbruch

Sollte der Verkaufsprozess, wie oben dargestellt, während Schritt 6., also NACH dem Übermitteln von createDocument (Schritt 2.) und VOR dem dem Übermitteln von storeDocument (Schritt 7.), übermittelt das Kassensystem ein cancelDocument ANSTATT eines storeDocuments.

Achtung: cancelDocument wird zum Abbruch einer unvollständigen Transaktion verwendet und NICHT (!) um etwa Retouren abzubilden.

Retouren werden, wie normale Verkaufstransaktionen, mit createDocument und storeDocument abgewickelt.

 

Verwandte Beiträge

Kommentare

0 Kommentare

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.

Powered by Zendesk