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 Übertragungn 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 ist die Methode CreateDocument auf alle Fälle aufzurufen.

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.

Beispiel Beleg 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.

Verwandte Beiträge

Kommentare

0 Kommentare

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

Powered by Zendesk