@kreiseck/kasseneck-api 1.16.0 → 1.17.1

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.16.0",
+  "version": "1.17.1",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"
@@ -832,12 +832,20 @@
       "vehicle",
       "other"
     ],
+    "voucherAmountModes": [
+      "free",
+      "fixed"
+    ],
     "voucherKinds": [
       "multi_purpose",
       "single_purpose",
       "service",
       "promotion"
     ],
+    "voucherPayouts": [
+      "allowed",
+      "never"
+    ],
     "voucherStatuses": [
       "active",
       "used_up",
@@ -845,6 +853,14 @@
       "paid_out",
       "cancelled",
       "blocked"
+    ],
+    "voucherTypeKinds": [
+      "multi_purpose",
+      "single_purpose"
+    ],
+    "voucherTypeValidityPatterns": [
+      "unlimited",
+      "years"
     ]
   },
   "partner": {

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

package/fixtures/v3/antworten/belege.json

@@ -1,14 +1,15 @@
 {
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
-    "sha256": "474a5fe11f758f005bce30cefb74b9e122284b09bf0a4677a4a7b16b19c33211",
-    "inputsSha256": "6c693f1ef121a4f4e5d1670929ea336233c0c20476993264f989bdf4f548a797",
+    "sha256": "34ee7654a5df2ecf75982d65af731b9a501d978b4ef7fae041817cb2d4915343",
+    "inputsSha256": "931df962ad989229c326fa42dbfda9a5535c23bdd9a52425f19d53dfaa2d6abc",
     "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
     "inputs": [
       "docs/api/fehlercodes.json",
       "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",
       "functions/aktivierung-api-core.js",
       "functions/beleg-mail-core.js",
+      "functions/bericht-v2-liefern.js",
       "functions/gemeinsam/api-rand.js",
       "functions/gemeinsam/api-vokabular-v3.js",
       "functions/gemeinsam/beleg-toepfe.js",
@@ -19,6 +20,8 @@
       "functions/gemeinsam/zahlungen-core.js",
       "functions/invoice-api-core.js",
       "functions/invoice-api-endpoints.js",
+      "functions/report-endpoints.js",
+      "functions/report-v2.js",
       "functions/test/unit/fixtures/v3-belege/beleg-welt.js",
       "functions/test/unit/fixtures/v3-rechnungen/rechnungs-welt.js",
       "functions/test/unit/fixtures/vertrag-v3/ablage.js",
@@ -5153,6 +5156,7 @@
         "vouchers": [
           {
             "action": "sell",
+            "typeId": "vt_ez20",
             "type": "single_purpose",
             "amountCents": 5000
           }
@@ -5200,7 +5204,10 @@
                 "voucherType": "single_purpose",
                 "amountCents": 5000,
                 "vatRateBp": 2000,
-                "name": "Einzweckgutschein 20 %",
+                "name": "Geschenkgutschein (Einzweckgutschein 20 %)",
+                "typeId": "vt_ez20",
+                "typeName": "Geschenkgutschein",
+                "payout": "never",
                 "code": "····-····-JJJ2",
                 "codeSuffix": "JJJ2",
                 "voucherId": "auto2"
@@ -5234,7 +5241,7 @@
             "layoutRuleset": 2,
             "items": [
               {
-                "name": "Einzweckgutschein 20 %",
+                "name": "Geschenkgutschein (Einzweckgutschein 20 %)",
                 "vat": 20,
                 "vatRate": 20,
                 "priceOne": 50,
@@ -5349,7 +5356,7 @@
                 "kind": "columns",
                 "columns": [
                   {
-                    "text": "1  x Einzweckgutschein 20 % ····-JJJ2",
+                    "text": "1  x Geschenkgutschein (Einzweckgutschein 20 %) ····-JJJ2",
                     "width": 7,
                     "align": "left"
                   },
@@ -5495,10 +5502,12 @@
               "index": 0,
               "codeSuffix": "JJJ2",
               "faceValueCents": 5000,
+              "typeId": "vt_ez20",
+              "typeName": "Geschenkgutschein",
               "validity": {
-                "pattern": "1+3",
-                "redeemableUntil": "2027-09-26",
-                "refundableUntil": "2030-09-26",
+                "pattern": "unlimited",
+                "redeemableUntil": null,
+                "refundableUntil": null,
                 "validUntil": null
               }
             }
@@ -5516,7 +5525,7 @@
         "vouchers": [
           {
             "action": "sell",
-            "type": "multi_purpose",
+            "typeId": "vt_mz",
             "amountCents": 5000
           }
         ],
@@ -5563,7 +5572,10 @@
                 "voucherType": "multi_purpose",
                 "value": 50,
                 "valueCents": 5000,
-                "name": "Mehrzweckgutschein",
+                "name": "Geschenkgutschein (Mehrzweckgutschein)",
+                "typeId": "vt_mz",
+                "typeName": "Geschenkgutschein",
+                "payout": "allowed",
                 "code": "····-····-NNNY",
                 "codeSuffix": "NNNY",
                 "voucherId": "auto4"
@@ -5852,10 +5864,13 @@
               "index": 0,
               "codeSuffix": "NNNY",
               "faceValueCents": 5000,
+              "typeId": "vt_mz",
+              "typeName": "Geschenkgutschein",
               "validity": {
                 "pattern": "1+3",
-                "redeemableUntil": "2027-09-26",
-                "refundableUntil": "2030-09-26",
+                "redeemableYears": 3,
+                "redeemableUntil": "2029-09-26",
+                "refundableUntil": "2032-09-26",
                 "validUntil": null
               }
             }

package/fixtures/v3/antworten/belegmail.json

@@ -2,13 +2,14 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "sha256": "265bcf3e14cdea33ec3c4df399eb487d40c0d7793ee23d2ee12bcf664bcad550",
-    "inputsSha256": "6c693f1ef121a4f4e5d1670929ea336233c0c20476993264f989bdf4f548a797",
+    "inputsSha256": "931df962ad989229c326fa42dbfda9a5535c23bdd9a52425f19d53dfaa2d6abc",
     "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
     "inputs": [
       "docs/api/fehlercodes.json",
       "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",
       "functions/aktivierung-api-core.js",
       "functions/beleg-mail-core.js",
+      "functions/bericht-v2-liefern.js",
       "functions/gemeinsam/api-rand.js",
       "functions/gemeinsam/api-vokabular-v3.js",
       "functions/gemeinsam/beleg-toepfe.js",
@@ -19,6 +20,8 @@
       "functions/gemeinsam/zahlungen-core.js",
       "functions/invoice-api-core.js",
       "functions/invoice-api-endpoints.js",
+      "functions/report-endpoints.js",
+      "functions/report-v2.js",
       "functions/test/unit/fixtures/v3-belege/beleg-welt.js",
       "functions/test/unit/fixtures/v3-rechnungen/rechnungs-welt.js",
       "functions/test/unit/fixtures/vertrag-v3/ablage.js",

package/fixtures/v3/antworten/berichte.json

@@ -0,0 +1,151 @@
+{
+  "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
+  "_quelle": {
+    "sha256": "497fe59db3414bf3143c0102eedfd371e165ad2f1878e74a9e1e31bd9413f1b0",
+    "inputsSha256": "931df962ad989229c326fa42dbfda9a5535c23bdd9a52425f19d53dfaa2d6abc",
+    "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
+    "inputs": [
+      "docs/api/fehlercodes.json",
+      "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",
+      "functions/aktivierung-api-core.js",
+      "functions/beleg-mail-core.js",
+      "functions/bericht-v2-liefern.js",
+      "functions/gemeinsam/api-rand.js",
+      "functions/gemeinsam/api-vokabular-v3.js",
+      "functions/gemeinsam/beleg-toepfe.js",
+      "functions/gemeinsam/gutschein-beleg.js",
+      "functions/gemeinsam/storno-core.js",
+      "functions/gemeinsam/tip-core.js",
+      "functions/gemeinsam/vat-buckets.js",
+      "functions/gemeinsam/zahlungen-core.js",
+      "functions/invoice-api-core.js",
+      "functions/invoice-api-endpoints.js",
+      "functions/report-endpoints.js",
+      "functions/report-v2.js",
+      "functions/test/unit/fixtures/v3-belege/beleg-welt.js",
+      "functions/test/unit/fixtures/v3-rechnungen/rechnungs-welt.js",
+      "functions/test/unit/fixtures/vertrag-v3/ablage.js",
+      "functions/test/unit/fixtures/vertrag-v3/gutschein-belege.js",
+      "functions/test/unit/fixtures/vertrag-v3/vokabular.js",
+      "functions/test/unit/fixtures/vertrag-v3/zahlbetrag.js",
+      "functions/test/unit/helpers/kassen-fehlerstellen.js",
+      "functions/test/unit/v3-vertrag-export.test.js"
+    ]
+  },
+  "channel": "api",
+  "note": "Binaerweg: ein Fall mit file ist die Datei (HTTP 200, Content-Type application/pdf, die Bytes beginnen mit file.startsWith), ein Fall mit response die Ablehnung als Huelle, ebenfalls mit HTTP 200. Entschieden wird an den ersten Bytes, nicht am Inhaltstyp.",
+  "cases": [
+    {
+      "name": "report_closed_day",
+      "endpoint": "getCashregisterReport",
+      "path": "/v3/getCashregisterReport",
+      "params": {
+        "year": 2026,
+        "month": 9,
+        "day": 25
+      },
+      "httpStatus": 200,
+      "headers": {
+        "Kasseneck-Api-Version": "v3",
+        "Access-Control-Expose-Headers": "Kasseneck-Api-Version",
+        "Content-Type": "application/pdf",
+        "Content-Disposition": "attachment; filename=daily-report_KECK-1_2026-09-25.pdf"
+      },
+      "file": {
+        "startsWith": "%PDF-"
+      }
+    },
+    {
+      "name": "error_period_not_closed",
+      "endpoint": "getCashregisterReport",
+      "path": "/v3/getCashregisterReport",
+      "params": {
+        "year": 2026,
+        "month": 9
+      },
+      "httpStatus": 200,
+      "headers": {
+        "Kasseneck-Api-Version": "v3",
+        "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+      },
+      "response": {
+        "status": "error",
+        "message": "Ungültige Daten: Der Monat ist noch nicht abgeschlossen – Monatsbericht erst ab dem Folgemonat.",
+        "data": {
+          "code": "period_not_closed"
+        },
+        "code": "period_not_closed"
+      }
+    },
+    {
+      "name": "error_period_not_closed_today",
+      "endpoint": "getCashregisterReport",
+      "path": "/v3/getCashregisterReport",
+      "params": {
+        "year": 2026,
+        "month": 9,
+        "day": 26
+      },
+      "httpStatus": 200,
+      "headers": {
+        "Kasseneck-Api-Version": "v3",
+        "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+      },
+      "response": {
+        "status": "error",
+        "message": "Der Tag ist noch nicht abgeschlossen – der Tagesbericht ist ab morgen verfügbar.",
+        "data": {
+          "code": "period_not_closed"
+        },
+        "code": "period_not_closed"
+      }
+    },
+    {
+      "name": "error_period_in_future",
+      "endpoint": "getCashregisterReport",
+      "path": "/v3/getCashregisterReport",
+      "params": {
+        "year": 2026,
+        "month": 9,
+        "day": 27
+      },
+      "httpStatus": 200,
+      "headers": {
+        "Kasseneck-Api-Version": "v3",
+        "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+      },
+      "response": {
+        "status": "error",
+        "message": "Ungültige Daten: day liegt in der Zukunft.",
+        "data": {
+          "code": "period_in_future"
+        },
+        "code": "period_in_future"
+      }
+    },
+    {
+      "name": "error_invalid_period",
+      "endpoint": "getCashregisterReport",
+      "path": "/v3/getCashregisterReport",
+      "params": {
+        "year": 2026,
+        "month": 9,
+        "start": "2026-09-01",
+        "end": "2026-09-15"
+      },
+      "httpStatus": 200,
+      "headers": {
+        "Kasseneck-Api-Version": "v3",
+        "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+      },
+      "response": {
+        "status": "error",
+        "message": "Ungültige Daten: genau eine Form – year+month(, day) oder start+end.",
+        "data": {
+          "code": "invalid_period"
+        },
+        "code": "invalid_period"
+      }
+    }
+  ]
+}

package/fixtures/v3/antworten/kasse-belege.json

@@ -1,14 +1,15 @@
 {
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
-    "sha256": "ec87fe9ec152900f6fe85659e54d78a67de2271470e8564cd2c8eabb6197a4f1",
-    "inputsSha256": "6c693f1ef121a4f4e5d1670929ea336233c0c20476993264f989bdf4f548a797",
+    "sha256": "3c75e607989f9f116b6c93de52fe8b48bc29103422f4bb8698baed64f89cc9b0",
+    "inputsSha256": "931df962ad989229c326fa42dbfda9a5535c23bdd9a52425f19d53dfaa2d6abc",
     "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
     "inputs": [
       "docs/api/fehlercodes.json",
       "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",
       "functions/aktivierung-api-core.js",
       "functions/beleg-mail-core.js",
+      "functions/bericht-v2-liefern.js",
       "functions/gemeinsam/api-rand.js",
       "functions/gemeinsam/api-vokabular-v3.js",
       "functions/gemeinsam/beleg-toepfe.js",
@@ -19,6 +20,8 @@
       "functions/gemeinsam/zahlungen-core.js",
       "functions/invoice-api-core.js",
       "functions/invoice-api-endpoints.js",
+      "functions/report-endpoints.js",
+      "functions/report-v2.js",
       "functions/test/unit/fixtures/v3-belege/beleg-welt.js",
       "functions/test/unit/fixtures/v3-rechnungen/rechnungs-welt.js",
       "functions/test/unit/fixtures/vertrag-v3/ablage.js",
@@ -4721,6 +4724,7 @@
         "vouchers": [
           {
             "action": "sell",
+            "typeId": "vt_ez20",
             "type": "single_purpose",
             "amountCents": 5000
           }
@@ -4768,7 +4772,10 @@
                 "voucherType": "single_purpose",
                 "amountCents": 5000,
                 "vatRateBp": 2000,
-                "name": "Einzweckgutschein 20 %",
+                "name": "Geschenkgutschein (Einzweckgutschein 20 %)",
+                "typeId": "vt_ez20",
+                "typeName": "Geschenkgutschein",
+                "payout": "never",
                 "code": "····-····-JJJ2",
                 "codeSuffix": "JJJ2",
                 "voucherId": "auto2"
@@ -4804,7 +4811,7 @@
             "layoutRuleset": 2,
             "items": [
               {
-                "name": "Einzweckgutschein 20 %",
+                "name": "Geschenkgutschein (Einzweckgutschein 20 %)",
                 "vat": 20,
                 "vatRate": 20,
                 "priceOne": 50,
@@ -4919,7 +4926,7 @@
                 "kind": "columns",
                 "columns": [
                   {
-                    "text": "1  x Einzweckgutschein 20 % ····-JJJ2",
+                    "text": "1  x Geschenkgutschein (Einzweckgutschein 20 %) ····-JJJ2",
                     "width": 7,
                     "align": "left"
                   },
@@ -5065,10 +5072,12 @@
               "index": 0,
               "codeSuffix": "JJJ2",
               "faceValueCents": 5000,
+              "typeId": "vt_ez20",
+              "typeName": "Geschenkgutschein",
               "validity": {
-                "pattern": "1+3",
-                "redeemableUntil": "2027-09-26",
-                "refundableUntil": "2030-09-26",
+                "pattern": "unlimited",
+                "redeemableUntil": null,
+                "refundableUntil": null,
                 "validUntil": null
               }
             }
@@ -5086,7 +5095,7 @@
         "vouchers": [
           {
             "action": "sell",
-            "type": "multi_purpose",
+            "typeId": "vt_mz",
             "amountCents": 5000
           }
         ],
@@ -5133,7 +5142,10 @@
                 "voucherType": "multi_purpose",
                 "value": 50,
                 "valueCents": 5000,
-                "name": "Mehrzweckgutschein",
+                "name": "Geschenkgutschein (Mehrzweckgutschein)",
+                "typeId": "vt_mz",
+                "typeName": "Geschenkgutschein",
+                "payout": "allowed",
                 "code": "····-····-NNNY",
                 "codeSuffix": "NNNY",
                 "voucherId": "auto4"
@@ -5424,10 +5436,13 @@
               "index": 0,
               "codeSuffix": "NNNY",
               "faceValueCents": 5000,
+              "typeId": "vt_mz",
+              "typeName": "Geschenkgutschein",
               "validity": {
                 "pattern": "1+3",
-                "redeemableUntil": "2027-09-26",
-                "refundableUntil": "2030-09-26",
+                "redeemableYears": 3,
+                "redeemableUntil": "2029-09-26",
+                "refundableUntil": "2032-09-26",
                 "validUntil": null
               }
             }