Dieser Endpunkt ist der Erste Schritt bei der Übermittlung von Transaktionen vom elektronischen Aufzeichnungssystem ("Registrierkasse") an das Fiskal Service. Der Prozess besteht immer aus zwei Schritten. Dieser zweistufige Prozess der Transaktionsübermittlung ist an die Anforderungen der KassenSichV in Deutschland angelehnt und muss, im Sinne einer standardisierten Schnittstelle, in allen Fiskalländern ausgeführt werden. In Deutschland wird beim Aufruf PUT /api/v1/transactions/createDocument eine Transaktion in der s.g. Technischen Sicherheitseinrichtung (TSE) registriert.
Transaktionsregistrierung
Hier wird eine Transaktion / ein Dokument in der Fiskaleinheit registriert:
- PUT /api/v1/transactions/createDocument und
- POST /api/v1/transactions/storeDocument
Transaktionsabbruch
Hier wird der Abbruch einer Transaktion in der Fiskaleinheit registriert:
- PUT /api/v1/transactions/createDocument und
- POST /api/v1/transactions/cancelDocument
Hinweis: sämtliche Transaktionen, welche mit PUT /api/v1/transactions/createDocument gestartet wurden, müssen unbedingt entweder mit POST /api/v1/transactions/storeDocument oder mit POST /api/v1/transactions/cancelDocument abgeschlossen werden! Beachten Sie dazu listTransactions (DELETE).
Ergebnis
Ein erfolgreicher Aufruf des Endpunktes (200)
- registriert den Start einer Transaktion in der Fiskaleinheit und
- gibt eine fiscalResponse an das Vorsystem (elektronisches Aufzeichnungssystem) zurück.
Verwendung
- jedes Mal, wenn eine neue Transaktion an das Fiskaleinheit geschickt werde soll, vor POST /api/v1/transactions/storeDocument bzw. POST /api/v1/transactions/cancelDocument.
Voraussetzungen
- Fiskal Client initialisiert
Formularfelder
Folgende Informationen müssen übermittelt werden:
Bezeichnung | Beschreibung | Beispiele |
clientId |
Die uniqueClientId der Registrierkasse (aus RetailForce System) |
c1062c55-57c4-4ed2-9c53-aff1762326a4 |
documentType |
Der Typ des zu registrierenden Dokuments. Enum:
|
- |
Antwort
Mögliche Antworten:
Code | Beschreibung | Beispiel |
200 |
Die Transaktion wurde gestartet und eine fiscalResponse wird an das Vorsystem zurückgegeben |
- |
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.