Manuelles Senden von Dokumenten

Die "obligatorischen Abrechnungsmassnahmen" ("mandatory billing measures") der Provinz Québec erfordern eine Funktion, die nach Offline-Situationen die manuellen Übermittung von Transaktionen an das WEB-SRM-System auslöst.

Dies wird auch im Testfall FO-105 von SW-78 (Testfälle für SRS-Entwickler: Nachweis der Konformität) überprüft.

Im regulären Betrieb versucht der RetailForce Fiscalisation Service automatisch, alle noch nicht gesendeten Transaktionen als Stapel (Batch) zu versenden, sobald es ein Dokument vom vorgelagerten System erhält.

Prozess

1. Das Vorsystem (Kassensystem) sendet ein Dokument (JSON Payload) an den RetailForce-Client, doch die Internetverbindung ist nicht verfügbar;
2. Der Client versucht, einen "transaction"-Request bezüglich der Transaktion an WEB-SRM zu senden
   1. da dies fehlschlägt, wechselt er in den Offline-Modus und
   2. fügt den Beleg dem Stapel der noch nicht gesendeten Transaktionen hinzu;
3. Das Vorsystem sendet das nächste Dokument, die Internetverbindung ist weiterhin unterbrochen;
4. Der Client versucht erneut, einen "transaction"-Request an WEB-SRM zu senden,
   1. falls dies erneut fehlschlägt, wird im Offline-Modus fortgesetzt und 
   2. das Dokument erneut dem Stapel der nicht gesendeten Transaktionen hinzugefügt;
   3. Schritte 3 und 4 werden wiederholt, bis zum Zeitpunkt des Versands eine Internetverbindung verfügbar ist;
5. Die Internetverbindung ist wieder verfügbar,
6. sendet das Vorsystem das nächste Dokument und die Internetverbindung ist wieder verfügbar;
7. übermittelt der Client alle noch nicht gesendeten Transaktionen als Stapel (Batch) an WEB-SRM;

Falls die Internetverbindung zwar wieder verfügbar ist, anschließend jedoch keine Transaktionen mehr an den RetailForce-Client gesendet werden, bleibt auch der Stapel der offenen Transaktionen ungesendet.

Tritt eine Unterbrechung zwischen Schritt 5 und 6 auf, muss eine manuelle Übertragung der Dokumente initiiert werden.

Die manuelle Übertragung kann über den Endpunkt ausgelöst werden: POST /api/v1/management/canada/sendQueuedDocuments/{clientId}. Einzelheiten werden im verlinkten Artikel erläutert.