@kreiseck/kasseneck-api 1.17.0 → 1.18.0

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": "f7f7091faee9c671b006237afa8c7dbba340d0120105259fce69ddad3bf10d93",
+    "backendPackage": "@kreiseck/kasseneck-api@0.36.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": "3c75e607989f9f116b6c93de52fe8b48bc29103422f4bb8698baed64f89cc9b0",
-    "inputsSha256": "2fc82d7d936fbb7e239ae5ce0eb3166a12034a6dc6f3d94482b33ef92068be26",
-    "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
+    "sha256": "d354e8a1424c465dab37d166dbda8c9a9ed0b4021e0564dfe23f744ecc4f4918",
+    "inputsSha256": "f7f7091faee9c671b006237afa8c7dbba340d0120105259fce69ddad3bf10d93",
+    "backendPackage": "@kreiseck/kasseneck-api@0.36.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",
@@ -4711,6 +4714,436 @@
         "code": "receipt_not_found"
       }
     },
+    {
+      "name": "sale_manual_receipt",
+      "endpoint": "createReceipt",
+      "path": "/api/v3/createReceipt",
+      "params": {
+        "receiptType": "standard",
+        "items": [
+          {
+            "name": "Behandlung",
+            "amount": 1,
+            "priceOneCents": 12000,
+            "vat": 0
+          }
+        ],
+        "payments": [
+          {
+            "method": "cash",
+            "amountCents": 12000
+          }
+        ],
+        "manualReceipt": {
+          "number": "H-17",
+          "date": "2026-09-25",
+          "time": "14:30",
+          "reason": "network_outage"
+        }
+      },
+      "httpStatus": 200,
+      "headers": {
+        "Kasseneck-Api-Version": "v3",
+        "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+      },
+      "response": {
+        "status": "success",
+        "message": "",
+        "data": {
+          "is_small_business": false,
+          "company": "Bäckerei Kornblum",
+          "phone": "+43 1 234",
+          "street": "Hauptplatz 1",
+          "zip": "1010",
+          "city": "Wien",
+          "footer1": "Danke",
+          "footer2": null,
+          "footer3": null,
+          "footer4": null,
+          "logo_url": null,
+          "kreiseck_logo": false,
+          "thanks_message": "Bis bald",
+          "receipt": {
+            "counter": 9,
+            "receiptType": "standard",
+            "zeroKind": null,
+            "receiptId": "KECK-1-ID-9",
+            "cashregisterId": "KECK-1",
+            "timeStamp": "2026-09-26T10:00:00",
+            "vouchers": [],
+            "paymentMethod": "cash",
+            "customerDetails": null,
+            "legalMessage": null,
+            "customProjectId": null,
+            "creditCardProvider": null,
+            "cardPaymentId": null,
+            "cardPaymentData": null,
+            "amountRateStandard": 0,
+            "amountRateReduced1": 0,
+            "amountRateReduced2": 0,
+            "amountRateZero": 120,
+            "amountRateSpecial": 0,
+            "turnoverCounterAES256ICM": "TBYB9m2bWcnljmcjdebbLQ==",
+            "signaturePreviousReceipt": "rXWdCT1GHhM=",
+            "certificateSerialNumber": "ABC123",
+            "fullReceiptId": "00000000000000000000000000000000.00000000000000000000000000000000000000000000000000000000f34182c3",
+            "payments": [
+              {
+                "id": "p1",
+                "method": "cash",
+                "amountCents": 12000
+              }
+            ],
+            "sig": "eyJhbGciOiJFUzI1NiJ9.X1IxLUFUMTAwX0tFQ0stMV9LRUNLLTEtSUQtOV8yMDI2LTA5LTI2VDEwOjAwOjAwXzAsMDBfMCwwMF8wLDAwXzEyMCwwMF8wLDAwX1RCWUI5bTJiX0FCQzEyM19yWFdkQ1QxR0hoTT0.DdN3NqCojZl5CNuTYbwOhBxNNvWenBgTVe34mpFO6iwVkzmTnaMfXWzix7th-fQ9x2mRqf4FPKSkiKON_zrCKA",
+            "signatureSuccess": true,
+            "qr": "_R1-AT100_KECK-1_KECK-1-ID-9_2026-09-26T10:00:00_0,00_0,00_0,00_120,00_0,00_TBYB9m2b_ABC123_rXWdCT1GHhM=_DdN3NqCojZl5CNuTYbwOhBxNNvWenBgTVe34mpFO6iwVkzmTnaMfXWzix7th+fQ9x2mRqf4FPKSkiKON/zrCKA==",
+            "headerVersionId": "auto1",
+            "layoutRuleset": 2,
+            "items": [
+              {
+                "name": "Behandlung",
+                "amount": 1,
+                "priceOneCents": 12000,
+                "vat": 0,
+                "priceOne": 120
+              }
+            ],
+            "manualReceipt": {
+              "number": "H-17",
+              "date": "2026-09-25",
+              "time": "14:30",
+              "reason": "network_outage"
+            }
+          },
+          "taxNumber": "91-123/4565",
+          "vatId": "ATU12345675",
+          "headerVersionId": "auto1",
+          "registrationInfo": null,
+          "testCashregister": true,
+          "testSignature": false,
+          "logo_scale": "M",
+          "layout": {
+            "paperSize": "mm80",
+            "ruleset": 2,
+            "lines": [
+              {
+                "kind": "banner",
+                "text": "TESTKASSE — kein gültiger Beleg",
+                "tone": "warning"
+              },
+              {
+                "kind": "text",
+                "text": "Bäckerei Kornblum",
+                "align": "center",
+                "bold": true
+              },
+              {
+                "kind": "text",
+                "text": "Hauptplatz 1",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "text",
+                "text": "1010 Wien",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "text",
+                "text": "ATU12345675",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "text",
+                "text": "+43 1 234",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "space",
+                "lines": 1
+              },
+              {
+                "kind": "banner",
+                "text": "NACHERFASSUNG",
+                "tone": "receipt_type"
+              },
+              {
+                "kind": "text",
+                "text": "nach Ausfall der Kasse",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "text",
+                "text": "Grund: Internet",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "space",
+                "lines": 1
+              },
+              {
+                "kind": "text",
+                "text": "Handbeleg Nr. H-17",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "text",
+                "text": "vom 25.09.2026, 14:30 Uhr",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "text",
+                "text": "USt: Duplikat des Handbelegs",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "space",
+                "lines": 1
+              },
+              {
+                "kind": "columns",
+                "columns": [
+                  {
+                    "text": "Datum:",
+                    "width": 4,
+                    "align": "left"
+                  },
+                  {
+                    "text": "26.09.2026 10:00:00",
+                    "width": 8,
+                    "align": "right"
+                  }
+                ]
+              },
+              {
+                "kind": "columns",
+                "columns": [
+                  {
+                    "text": "Kassen-ID:",
+                    "width": 6,
+                    "align": "left"
+                  },
+                  {
+                    "text": "KECK-1",
+                    "width": 6,
+                    "align": "right"
+                  }
+                ]
+              },
+              {
+                "kind": "columns",
+                "columns": [
+                  {
+                    "text": "Beleg-ID:",
+                    "width": 6,
+                    "align": "left"
+                  },
+                  {
+                    "text": "KECK-1-ID-9",
+                    "width": 6,
+                    "align": "right"
+                  }
+                ]
+              },
+              {
+                "kind": "space",
+                "lines": 1
+              },
+              {
+                "kind": "columns",
+                "columns": [
+                  {
+                    "text": "1  x Behandlung",
+                    "width": 7,
+                    "align": "left"
+                  },
+                  {
+                    "text": "120,00 D",
+                    "width": 5,
+                    "align": "right"
+                  }
+                ]
+              },
+              {
+                "kind": "space",
+                "lines": 1
+              },
+              {
+                "kind": "columns",
+                "columns": [
+                  {
+                    "text": "MwSt%",
+                    "width": 3,
+                    "align": "left"
+                  },
+                  {
+                    "text": "MwSt",
+                    "width": 4,
+                    "align": "left"
+                  },
+                  {
+                    "text": "Netto",
+                    "width": 3,
+                    "align": "left"
+                  },
+                  {
+                    "text": "Brutto",
+                    "width": 2,
+                    "align": "right"
+                  }
+                ]
+              },
+              {
+                "kind": "columns",
+                "columns": [
+                  {
+                    "text": "D 0%",
+                    "width": 3,
+                    "align": "left"
+                  },
+                  {
+                    "text": "0,00",
+                    "width": 4,
+                    "align": "left"
+                  },
+                  {
+                    "text": "120,00",
+                    "width": 3,
+                    "align": "left"
+                  },
+                  {
+                    "text": "120,00",
+                    "width": 2,
+                    "align": "right"
+                  }
+                ]
+              },
+              {
+                "kind": "rule",
+                "char": "-"
+              },
+              {
+                "kind": "columns",
+                "columns": [
+                  {
+                    "text": "Gesamt:",
+                    "width": 6,
+                    "align": "left"
+                  },
+                  {
+                    "text": "120,00 €",
+                    "width": 6,
+                    "align": "right"
+                  }
+                ]
+              },
+              {
+                "kind": "columns",
+                "columns": [
+                  {
+                    "text": "Zahlungsart:",
+                    "width": 6,
+                    "align": "left"
+                  },
+                  {
+                    "text": "Barzahlung",
+                    "width": 6,
+                    "align": "right"
+                  }
+                ]
+              },
+              {
+                "kind": "space",
+                "lines": 1
+              },
+              {
+                "kind": "qr",
+                "data": "_R1-AT100_KECK-1_KECK-1-ID-9_2026-09-26T10:00:00_0,00_0,00_0,00_120,00_0,00_TBYB9m2b_ABC123_rXWdCT1GHhM=_DdN3NqCojZl5CNuTYbwOhBxNNvWenBgTVe34mpFO6iwVkzmTnaMfXWzix7th+fQ9x2mRqf4FPKSkiKON/zrCKA=="
+              },
+              {
+                "kind": "space",
+                "lines": 1
+              },
+              {
+                "kind": "space",
+                "lines": 1
+              },
+              {
+                "kind": "text",
+                "text": "Bis bald",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "text",
+                "text": "Danke",
+                "align": "center",
+                "bold": false
+              },
+              {
+                "kind": "space",
+                "lines": 1
+              },
+              {
+                "kind": "banner",
+                "text": "TESTKASSE — kein gültiger Beleg",
+                "tone": "warning"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "name": "error_manual_receipt_duplicate",
+      "endpoint": "createReceipt",
+      "path": "/api/v3/createReceipt",
+      "params": {
+        "receiptType": "standard",
+        "items": [
+          {
+            "name": "Behandlung",
+            "amount": 1,
+            "priceOneCents": 12000,
+            "vat": 0
+          }
+        ],
+        "payments": [
+          {
+            "method": "cash",
+            "amountCents": 12000
+          }
+        ],
+        "manualReceipt": {
+          "number": "H-17",
+          "date": "2026-09-25",
+          "time": "14:30",
+          "reason": "network_outage"
+        }
+      },
+      "httpStatus": 200,
+      "headers": {
+        "Kasseneck-Api-Version": "v3",
+        "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+      },
+      "response": {
+        "status": "error",
+        "message": "Dieser Handbeleg ist auf dieser Kasse für diesen Tag schon nacherfasst.",
+        "data": {
+          "code": "manual_receipt_duplicate",
+          "receiptId": "KECK-1-ID-9"
+        },
+        "code": "manual_receipt_duplicate"
+      }
+    },
     {
       "name": "sale_single_purpose_voucher",
       "endpoint": "createReceipt",

package/fixtures/v3/antworten/kasse.json

@@ -4,8 +4,8 @@
     "default": {
       "sha256": "1c9e54a06b1851753d793301dd351bc9179079bcc53fa4a5205959a34373e172",
       "head": [],
-      "inputsSha256": "c18e7adc7420e634394fb1b1e738dc18aeed9d31cc7d2ac5847d3e06b9ca7130",
-      "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
+      "inputsSha256": "f75bd64e874cb1a2712d4057a0d58930d60b6bb07e36fecd6adbd0d91bba3878",
+      "backendPackage": "@kreiseck/kasseneck-api@0.36.0",
       "inputs": [
         "functions-kasse/test/unit/fixtures/kassen-welt.js",
         "functions/gemeinsam/api-rand.js",
@@ -24,7 +24,7 @@
         "channel",
         "note"
       ],
-      "inputsSha256": "7567e06f91a415e03ce4c459050006f7b3f4e06644f5731559261d05f0eb23a5",
+      "inputsSha256": "325a168fe57e8d6205a00d3faae8d5599080c187d721a276b07d28f623499fd6",
       "backendPackage": "@kreiseck/kasseneck-api@0.14.0",
       "inputs": [
         "functions-kasse/gemeinsam/api-rand.js",

package/fixtures/v3/antworten/lager.json

@@ -2,7 +2,7 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "sha256": "6d19c6313438a44d5f522bcaf248de293c6e285dd891185a773e05e9eef6f45b",
-    "inputsSha256": "407c79805f7927a0335eecff1888408b6153f5a38d8b85e7d57e004eb4832ad9",
+    "inputsSha256": "971cbbae43b71b6ccc006ab34522e45d7e61ac1b696c19793c078ba3ec1ebee0",
     "backendPackage": "@kreiseck/kasseneck-api@0.14.0",
     "inputs": [
       "functions-kasse/article-endpoints.js",

package/fixtures/v3/antworten/rechnungen.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": "a5d2e578f0ee866e539320866624dc9337459479bfcdcb955c8c3b821cd1c689",
-    "inputsSha256": "2fc82d7d936fbb7e239ae5ce0eb3166a12034a6dc6f3d94482b33ef92068be26",
-    "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
+    "inputsSha256": "f7f7091faee9c671b006237afa8c7dbba340d0120105259fce69ddad3bf10d93",
+    "backendPackage": "@kreiseck/kasseneck-api@0.36.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",