@kreiseck/kasseneck-api 1.17.0 → 1.18.0

package/fixtures/receipts/manual-receipt-single-system-outage-no-time.json

@@ -0,0 +1,49 @@
+{
+  "company": {
+    "companyName": "Blumen G'schenk e.U.",
+    "street": "Hauptplatz 1",
+    "zip": "4830",
+    "city": "Hallstatt",
+    "phone": "+43 6134 12345",
+    "isSmallBusiness": false,
+    "thanksMessage": [],
+    "showKreiseckLogo": false,
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "footer1": "Danke und schöne Tage",
+    "footer2": ""
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-108",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-11-20T12:41:09",
+    "items": [
+      {
+        "name": "Strauß der Saison",
+        "quantity": 1,
+        "unitPriceCents": 2490,
+        "vatRate": 13
+      }
+    ],
+    "vouchers": [],
+    "paymentMethod": "creditCard",
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-108_2026-11-20T12:41:09_0,00_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": [],
+    "creditCardProvider": "custom",
+    "manualReceipt": {
+      "number": "B-412",
+      "date": "2026-11-20",
+      "reason": "system_outage"
+    }
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}

package/fixtures/receipts/manual-receipt-single-system-outage-time.json

@@ -0,0 +1,50 @@
+{
+  "company": {
+    "companyName": "Blumen G'schenk e.U.",
+    "street": "Hauptplatz 1",
+    "zip": "4830",
+    "city": "Hallstatt",
+    "phone": "+43 6134 12345",
+    "isSmallBusiness": false,
+    "thanksMessage": [],
+    "showKreiseckLogo": false,
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "footer1": "Danke und schöne Tage",
+    "footer2": ""
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-107",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-11-20T12:41:09",
+    "items": [
+      {
+        "name": "Strauß der Saison",
+        "quantity": 1,
+        "unitPriceCents": 2490,
+        "vatRate": 13
+      }
+    ],
+    "vouchers": [],
+    "paymentMethod": "creditCard",
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-107_2026-11-20T12:41:09_0,00_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": [],
+    "creditCardProvider": "custom",
+    "manualReceipt": {
+      "number": "B-412",
+      "date": "2026-11-20",
+      "time": "11:05",
+      "reason": "system_outage"
+    }
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}

package/fixtures/receipts/zero-outage-end-period.json

@@ -0,0 +1,43 @@
+{
+  "company": {
+    "companyName": "Bäckerei Muster",
+    "street": "Hauptplatz 1",
+    "zip": "4830",
+    "city": "Hallstatt",
+    "phone": "+43 6134 12345",
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "isSmallBusiness": false,
+    "footer1": "Vielen Dank für Ihren Einkauf",
+    "footer2": "www.baeckerei-muster.at",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-50",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-08-13T10:15:30",
+    "items": [],
+    "vouchers": [],
+    "paymentMethod": null,
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "zero",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": [
+      "Sicherheitseinrichtung ausgefallen von 12.08.2026 08:10 bis 13.08.2026 10:14 (ab Beleg AT0-KASSE1-41)"
+    ],
+    "zeroKind": "outage_end"
+  },
+  "options": {
+    "paperSize": "mm80",
+    "registrationInfo": {
+      "cardRegisteredAt": "2024-03-12",
+      "cashregisterRegisteredAt": "2024-03-12"
+    }
+  }
+}

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.17.0",
+  "version": "1.18.0",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"

package/fixtures/v3/README.md

@@ -14,7 +14,7 @@ Erzeugt von Jest-Tests in zwei Codebases (jede übersetzt mit ihrem eigenen Rand
 
 | Test | schreibt |
 | --- | --- |
-| `functions/test/unit/v3-vertrag-export.test.js` | `v3-vokabular.json`, `antworten/belege.json`, `antworten/kasse-belege.json`, `antworten/storno.json`, `antworten/belegmail.json`, `antworten/rechnungen.json`, `stored/belege.json`, `stored/rechnungen.json`, `zahlbetrag-faelle.json` |
+| `functions/test/unit/v3-vertrag-export.test.js` | `v3-vokabular.json`, `antworten/belege.json`, `antworten/kasse-belege.json`, `antworten/storno.json`, `antworten/belegmail.json`, `antworten/rechnungen.json`, `antworten/berichte.json`, `stored/belege.json`, `stored/rechnungen.json`, `zahlbetrag-faelle.json` |
 | `functions/test/unit/v3-vertrag-export-kassenweg.test.js` | Teil `default` von `antworten/kasse.json` und `stored/kasse.json` (6 Beleg-Endpunkte der Kasse) |
 | `functions-kasse/test/unit/v3-vertrag-export.test.js` | Teil `kasse` derselben zwei Dateien (die übrigen 19 Kassen-Endpunkte) |
 | `functions-kasse/test/unit/v3-vertrag-export-lager.test.js` | `antworten/lager.json` (Lager-API, Stufe 5a) |
@@ -109,6 +109,13 @@ Code-Änderung zusammen einchecken.
   `platform_fallback`, Fehler).
 - **`antworten/rechnungen.json`**: Rechnungs-API (Probelauf, Festschreiben, Lesen,
   Liste, Storno, Gutschrift, Zahlung, Fehler).
+- **`antworten/berichte.json`**: `getCashregisterReport` unter `/v3` (Kanal `api`), der
+  Binärweg. Ein Fall mit `file` ist die Datei: HTTP 200, `Content-Type: application/pdf`,
+  die Bytes beginnen mit `file.startsWith` (`%PDF-`); mehr vom PDF steht hier nicht, der
+  Rest hängt an Schrift und Satz. Jede Ablehnung kommt ebenfalls mit HTTP 200, als Hülle
+  mit Code (`period_not_closed` für den laufenden Monat und heute, `period_in_future`,
+  `invalid_period`). Ein Paket entscheidet an den ersten Bytes, nicht am Inhaltstyp, und
+  wirft die Hülle wie auf dem JSON-Weg.
 - **`antworten/kasse.json`**: alle 25 Kassen-Endpunkte unter `/api/v3`, je Fall
   (englischer Name) Methode, Aufrufer, Parameter, HTTP-Status, Kopfzeilen und Antwort.
 - **`antworten/lager.json`**: Lager-API unter `/v3` (Kanal `api`) in Ablaufreihenfolge an