@kreiseck/kasseneck-api 1.12.0 → 1.14.0

package/fixtures/v3/antworten/storno.json

@@ -1,9 +1,9 @@
 {
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
-    "sha256": "c5db01aa176f4449a18bf0affdf984a8b3fef75b9e3344721cb03cb3a6fdb272",
-    "inputsSha256": "29f295ee139942d79758255d7b6284e2810477e4e22249d9b703c0110129e78b",
-    "backendPackage": "@kreiseck/kasseneck-api@0.33.1",
+    "sha256": "53bacb07e03ff6e46d2d78d0aed71daa450dde715a9f79c927f6953f76f81997",
+    "inputsSha256": "ef1648206351fe21b4cb0cb35e6235d45f938b548b20ca1a70f1de6d43fe9f47",
+    "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
     "inputs": [
       "docs/api/fehlercodes.json",
       "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",
@@ -482,6 +482,109 @@
         }
       }
     },
+    {
+      "channel": "api",
+      "name": "cancel_payout_voucher",
+      "endpoint": "cancelReceipt",
+      "path": "/v3/cancelReceipt",
+      "params": {
+        "reason": "input_error",
+        "payments": [
+          {
+            "method": "cash",
+            "amountCents": 3000
+          }
+        ],
+        "cashregisterId": "KECK-1",
+        "originalReceiptId": "KECK-1-ID-9"
+      },
+      "httpStatus": 200,
+      "headers": {
+        "Kasseneck-Api-Version": "v3",
+        "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+      },
+      "response": {
+        "status": "success",
+        "message": "",
+        "data": {
+          "cancellationOf": {
+            "receiptId": "KECK-1-ID-9",
+            "fullReceiptId": "00000000000000000000000000000000.00000000000000000000000000000000000000000000000000000000676d8c59",
+            "timeStamp": "2026-09-26T10:00:00"
+          },
+          "remaining": [
+            0
+          ],
+          "receipt": {
+            "counter": 11,
+            "receiptType": "cancellation",
+            "zeroKind": null,
+            "receiptId": "KECK-1-ID-11",
+            "cashregisterId": "KECK-1",
+            "timeStamp": "2026-09-26T10:00:00",
+            "vouchers": [
+              {
+                "action": "payout",
+                "type": "value",
+                "code": "····-····-8CN5",
+                "name": "Auszahlung Gutschein",
+                "value": 30,
+                "voucherType": "multi_purpose",
+                "voucherId": "gmz2",
+                "valueCents": 3000,
+                "codeSuffix": "8CN5",
+                "zeroRateBucket": true
+              }
+            ],
+            "paymentMethod": "cash",
+            "customerDetails": null,
+            "legalMessage": "STORNO zu KECK-1-ID-9 – Fehleingabe",
+            "customProjectId": null,
+            "creditCardProvider": null,
+            "amountRateStandard": 0,
+            "amountRateReduced1": 0,
+            "amountRateReduced2": 0,
+            "amountRateZero": 30,
+            "amountRateSpecial": 0,
+            "turnoverCounterAES256ICM": "05KgKPi7tces/pQSFUHUVQ==",
+            "signaturePreviousReceipt": "uE+AyYjTOZ4=",
+            "certificateSerialNumber": "ABC123",
+            "fullReceiptId": "00000000000000000000000000000000.00000000000000000000000000000000000000000000000000000000c8061ae9",
+            "payments": [
+              {
+                "id": "p1",
+                "method": "cash",
+                "amountCents": 3000
+              }
+            ],
+            "sig": "eyJhbGciOiJFUzI1NiJ9.X1IxLUFUMTAwX0tFQ0stMV9LRUNLLTEtSUQtMTFfMjAyNi0wOS0yNlQxMDowMDowMF8wLDAwXzAsMDBfMCwwMF8zMCwwMF8wLDAwX1UxUlBfQUJDMTIzX3VFK0F5WWpUT1o0PQ.rF5B98DFaF6IGqjEk_i_ve3H6dq5-f9MGO57Y4wG3n34N4fQoV6Di6djJA0JZUF-jVGe6K-Wv12toVBOfoUxvg",
+            "signatureSuccess": true,
+            "qr": "_R1-AT100_KECK-1_KECK-1-ID-11_2026-09-26T10:00:00_0,00_0,00_0,00_30,00_0,00_U1RP_ABC123_uE+AyYjTOZ4=_rF5B98DFaF6IGqjEk/i/ve3H6dq5+f9MGO57Y4wG3n34N4fQoV6Di6djJA0JZUF+jVGe6K+Wv12toVBOfoUxvg==",
+            "cancellationOf": {
+              "receiptId": "KECK-1-ID-9",
+              "fullReceiptId": "00000000000000000000000000000000.00000000000000000000000000000000000000000000000000000000676d8c59",
+              "timeStamp": "2026-09-26T10:00:00"
+            },
+            "cancellationReason": "input_error",
+            "headerVersionId": "auto1",
+            "layoutRuleset": 2,
+            "items": [
+              {
+                "name": "Auszahlung Gutschein ····-8CN5",
+                "quantity": 1,
+                "unitPriceCents": 3000,
+                "vatRate": 0,
+                "kind": "voucher_float",
+                "amount": 1,
+                "vat": 0,
+                "priceOneCents": 3000,
+                "priceOne": 30
+              }
+            ]
+          }
+        }
+      }
+    },
     {
       "channel": "app",
       "name": "cancel_full_card_refund",
@@ -943,6 +1046,111 @@
           }
         }
       }
+    },
+    {
+      "channel": "app",
+      "name": "cancel_payout_voucher",
+      "endpoint": "cancelReceipt",
+      "path": "/api/v3/cancelReceipt",
+      "params": {
+        "reason": "input_error",
+        "payments": [
+          {
+            "method": "cash",
+            "amountCents": 3000
+          }
+        ],
+        "cashregisterId": "KECK-1",
+        "originalReceiptId": "KECK-1-ID-9"
+      },
+      "httpStatus": 200,
+      "headers": {
+        "Kasseneck-Api-Version": "v3",
+        "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+      },
+      "response": {
+        "status": "success",
+        "message": "",
+        "data": {
+          "cancellationOf": {
+            "receiptId": "KECK-1-ID-9",
+            "fullReceiptId": "00000000000000000000000000000000.00000000000000000000000000000000000000000000000000000000676d8c59",
+            "timeStamp": "2026-09-26T10:00:00"
+          },
+          "remaining": [
+            0
+          ],
+          "receipt": {
+            "counter": 11,
+            "receiptType": "cancellation",
+            "zeroKind": null,
+            "receiptId": "KECK-1-ID-11",
+            "cashregisterId": "KECK-1",
+            "timeStamp": "2026-09-26T10:00:00",
+            "vouchers": [
+              {
+                "action": "payout",
+                "type": "value",
+                "code": "····-····-8CN5",
+                "name": "Auszahlung Gutschein",
+                "value": 30,
+                "voucherType": "multi_purpose",
+                "voucherId": "gmz2",
+                "valueCents": 3000,
+                "codeSuffix": "8CN5",
+                "zeroRateBucket": true
+              }
+            ],
+            "paymentMethod": "cash",
+            "customerDetails": null,
+            "legalMessage": "STORNO zu KECK-1-ID-9 – Fehleingabe",
+            "customProjectId": null,
+            "creditCardProvider": null,
+            "cardPaymentId": null,
+            "cardPaymentData": null,
+            "amountRateStandard": 0,
+            "amountRateReduced1": 0,
+            "amountRateReduced2": 0,
+            "amountRateZero": 30,
+            "amountRateSpecial": 0,
+            "turnoverCounterAES256ICM": "05KgKPi7tces/pQSFUHUVQ==",
+            "signaturePreviousReceipt": "uE+AyYjTOZ4=",
+            "certificateSerialNumber": "ABC123",
+            "fullReceiptId": "00000000000000000000000000000000.00000000000000000000000000000000000000000000000000000000c8061ae9",
+            "payments": [
+              {
+                "id": "p1",
+                "method": "cash",
+                "amountCents": 3000
+              }
+            ],
+            "sig": "eyJhbGciOiJFUzI1NiJ9.X1IxLUFUMTAwX0tFQ0stMV9LRUNLLTEtSUQtMTFfMjAyNi0wOS0yNlQxMDowMDowMF8wLDAwXzAsMDBfMCwwMF8zMCwwMF8wLDAwX1UxUlBfQUJDMTIzX3VFK0F5WWpUT1o0PQ.rF5B98DFaF6IGqjEk_i_ve3H6dq5-f9MGO57Y4wG3n34N4fQoV6Di6djJA0JZUF-jVGe6K-Wv12toVBOfoUxvg",
+            "signatureSuccess": true,
+            "qr": "_R1-AT100_KECK-1_KECK-1-ID-11_2026-09-26T10:00:00_0,00_0,00_0,00_30,00_0,00_U1RP_ABC123_uE+AyYjTOZ4=_rF5B98DFaF6IGqjEk/i/ve3H6dq5+f9MGO57Y4wG3n34N4fQoV6Di6djJA0JZUF+jVGe6K+Wv12toVBOfoUxvg==",
+            "cancellationOf": {
+              "receiptId": "KECK-1-ID-9",
+              "fullReceiptId": "00000000000000000000000000000000.00000000000000000000000000000000000000000000000000000000676d8c59",
+              "timeStamp": "2026-09-26T10:00:00"
+            },
+            "cancellationReason": "input_error",
+            "headerVersionId": "auto1",
+            "layoutRuleset": 2,
+            "items": [
+              {
+                "name": "Auszahlung Gutschein ····-8CN5",
+                "quantity": 1,
+                "unitPriceCents": 3000,
+                "vatRate": 0,
+                "kind": "voucher_float",
+                "amount": 1,
+                "vat": 0,
+                "priceOneCents": 3000,
+                "priceOne": 30
+              }
+            ]
+          }
+        }
+      }
     }
   ]
 }

package/fixtures/v3/stored/belege.json

@@ -2,8 +2,8 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "sha256": "2781c0716b6ba63ef2c14eb5a3e6abab37adf42af72c9aee60bbbb1ebd716cf1",
-    "inputsSha256": "29f295ee139942d79758255d7b6284e2810477e4e22249d9b703c0110129e78b",
-    "backendPackage": "@kreiseck/kasseneck-api@0.33.1",
+    "inputsSha256": "ef1648206351fe21b4cb0cb35e6235d45f938b548b20ca1a70f1de6d43fe9f47",
+    "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
     "inputs": [
       "docs/api/fehlercodes.json",
       "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",

package/fixtures/v3/stored/kasse.json

@@ -4,8 +4,8 @@
     "default": {
       "sha256": "2cc77736cae05b3d7c2e67d59bd6bd7cfb9f5484eed54cf236e3a412ab9e78f9",
       "head": [],
-      "inputsSha256": "684e236f4e84e7befba5ebda44021eefc4de50a6f2507cf4de5b456e9a2ed790",
-      "backendPackage": "@kreiseck/kasseneck-api@0.33.1",
+      "inputsSha256": "17ad91ff10d3654e40e5a2aa4f049158acaf04f6ea1cb07da3ae656dd557aca0",
+      "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
       "inputs": [
         "functions-kasse/test/unit/fixtures/kassen-welt.js",
         "functions/gemeinsam/api-rand.js",
@@ -19,12 +19,12 @@
       ]
     },
     "kasse": {
-      "sha256": "9fe8af1be0eb68c393b9ec35f27ecd055dee206fd43f579449a7d8e8f75ac82c",
+      "sha256": "46e9d3ca2c8c176710891dc12c94d26314692bdd0f81c44be782bbfbe623e636",
       "head": [
         "note",
         "baseline"
       ],
-      "inputsSha256": "1efd9f548d9b578193c3dbf4aae041f4ffaa1adcaba01a7c5e2df7ba882efa94",
+      "inputsSha256": "43f37b0b04ce56bd73d8758a4fda0a3d4d514cefe3a438aaa6c2f3a758eb8b80",
       "backendPackage": "@kreiseck/kasseneck-api@0.14.0",
       "inputs": [
         "functions-kasse/gemeinsam/api-rand.js",
@@ -9027,6 +9027,116 @@
           }
         }
       }
+    },
+    "logReceiptOutputs": {
+      "codebase": "kasse",
+      "cases": {
+        "success_cashier": {
+          "users/kw_betrieb1/cashregisters/KASSE1/receipts/KASSE1-ID-7/ausgaben/k_69919d29fa2b786430fd789114dce973": {
+            "art": "link_geteilt",
+            "at": "2026-09-26T09:59:30+02:00",
+            "eingangAt": "2026-09-26T08:00:00.000Z",
+            "ergebnis": "ok",
+            "durch": {
+              "id": "ru_kellner",
+              "name": "Ben Kellner"
+            },
+            "geraet": "dev_auswahl",
+            "quelle": "kasse"
+          },
+          "users/kw_betrieb1/cashregisters/KASSE1/receipts/KASSE1-ID-7/ausgaben/k_7d73e44c72a29d4133a8d374e7d03ccc": {
+            "art": "erstdruck",
+            "at": "2026-09-26T09:58:00+02:00",
+            "eingangAt": "2026-09-26T08:00:00.000Z",
+            "ergebnis": "ok",
+            "durch": {
+              "id": "ru_kellner",
+              "name": "Ben Kellner"
+            },
+            "geraet": "dev_auswahl",
+            "quelle": "kasse"
+          },
+          "users/kw_betrieb1/cashregisters/KASSE1/receipts/KASSE1-ID-7/ausgaben/k_94f986f06fa19684b51bd2af37238607": {
+            "art": "duplikat",
+            "at": "2026-09-26T09:59:00+02:00",
+            "eingangAt": "2026-09-26T08:00:00.000Z",
+            "ergebnis": "unklar",
+            "durch": {
+              "id": "ru_kellner",
+              "name": "Ben Kellner"
+            },
+            "geraet": "dev_auswahl",
+            "quelle": "kasse"
+          }
+        },
+        "success_duplicate": {
+          "users/kw_betrieb1/cashregisters/KASSE1/receipts/KASSE1-ID-7/ausgaben/k_69919d29fa2b786430fd789114dce973": {
+            "art": "link_geteilt",
+            "at": "2026-09-26T09:59:30+02:00",
+            "eingangAt": "2026-09-26T08:00:00.000Z",
+            "ergebnis": "ok",
+            "durch": {
+              "id": "ru_kellner",
+              "name": "Ben Kellner"
+            },
+            "geraet": "dev_auswahl",
+            "quelle": "kasse"
+          },
+          "users/kw_betrieb1/cashregisters/KASSE1/receipts/KASSE1-ID-7/ausgaben/k_94f986f06fa19684b51bd2af37238607": {
+            "art": "duplikat",
+            "at": "2026-09-26T09:59:00+02:00",
+            "eingangAt": "2026-09-26T08:00:00.000Z",
+            "ergebnis": "unklar",
+            "durch": {
+              "id": "ru_kellner",
+              "name": "Ben Kellner"
+            },
+            "geraet": "dev_auswahl",
+            "quelle": "kasse"
+          }
+        },
+        "success_api_key": {
+          "users/kw_betrieb1/cashregisters/KASSE1/receipts/KASSE1-ID-7/ausgaben/k_4bba899d58d3f36d211b46bf211e8b30": {
+            "art": "pdf_geteilt",
+            "at": "2026-09-26T09:59:59+02:00",
+            "eingangAt": "2026-09-26T08:00:00.000Z",
+            "ergebnis": "ok",
+            "durch": {
+              "id": null,
+              "name": null
+            },
+            "geraet": null,
+            "quelle": "kasse"
+          }
+        },
+        "mixed": {
+          "users/kw_betrieb1/cashregisters/KASSE1/receipts/KASSE1-ID-7/ausgaben/k_1b87f4f0183cfa1a62ee047b4288bbe1": {
+            "art": "erstdruck",
+            "at": "2026-09-26T10:00:00+02:00",
+            "eingangAt": "2026-09-26T08:00:00.000Z",
+            "ergebnis": "ok",
+            "durch": {
+              "id": "ru_chef",
+              "name": "Anna Chef"
+            },
+            "geraet": "dev_pin",
+            "quelle": "kasse",
+            "atGeraet": "2026-09-26T10:10:00+02:00"
+          },
+          "users/kw_betrieb1/cashregisters/KASSE1/receipts/KASSE1-ID-7/ausgaben/k_21ee50bd38fcb1309cf9f30e62885efb": {
+            "art": "duplikat",
+            "at": "2026-09-26T09:59:59+02:00",
+            "eingangAt": "2026-09-26T08:00:00.000Z",
+            "ergebnis": "fehler",
+            "durch": {
+              "id": "ru_chef",
+              "name": "Anna Chef"
+            },
+            "geraet": "dev_pin",
+            "quelle": "kasse"
+          }
+        }
+      }
     }
   }
 }

package/fixtures/v3/stored/rechnungen.json

@@ -1,9 +1,9 @@
 {
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
-    "sha256": "364d5c9d290532b0a41d1077ee9fdd1b78f69a1372e98d8bad405e5893b0ad53",
-    "inputsSha256": "29f295ee139942d79758255d7b6284e2810477e4e22249d9b703c0110129e78b",
-    "backendPackage": "@kreiseck/kasseneck-api@0.33.1",
+    "sha256": "8307d3b935f124ed1c8f6faa826daa450daae51fae8f187031c461baa1103769",
+    "inputsSha256": "ef1648206351fe21b4cb0cb35e6235d45f938b548b20ca1a70f1de6d43fe9f47",
+    "backendPackage": "@kreiseck/kasseneck-api@0.35.0",
     "inputs": [
       "docs/api/fehlercodes.json",
       "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",
@@ -187,9 +187,9 @@
         "id": null,
         "name": "Standard",
         "logoUrl": null,
-        "logoAlt": "Bäckerei Welt",
+        "logoAlt": "Bäckerei Kornblum",
         "farbe": "#17150F",
-        "absenderName": "Bäckerei Welt",
+        "absenderName": "Bäckerei Kornblum",
         "fusszeile": []
       },
       "created_at": "2026-09-26T08:00:00.000Z",
@@ -299,9 +299,9 @@
         "id": null,
         "name": "Standard",
         "logoUrl": null,
-        "logoAlt": "Bäckerei Welt",
+        "logoAlt": "Bäckerei Kornblum",
         "farbe": "#17150F",
-        "absenderName": "Bäckerei Welt",
+        "absenderName": "Bäckerei Kornblum",
         "fusszeile": []
       },
       "uidNachweis": {
@@ -434,9 +434,9 @@
         "id": null,
         "name": "Standard",
         "logoUrl": null,
-        "logoAlt": "Bäckerei Welt",
+        "logoAlt": "Bäckerei Kornblum",
         "farbe": "#17150F",
-        "absenderName": "Bäckerei Welt",
+        "absenderName": "Bäckerei Kornblum",
         "fusszeile": []
       },
       "uidRisiko": {
@@ -547,9 +547,9 @@
         "id": null,
         "name": "Standard",
         "logoUrl": null,
-        "logoAlt": "Bäckerei Welt",
+        "logoAlt": "Bäckerei Kornblum",
         "farbe": "#17150F",
-        "absenderName": "Bäckerei Welt",
+        "absenderName": "Bäckerei Kornblum",
         "fusszeile": []
       },
       "created_at": "2026-09-26T08:00:00.000Z",
@@ -653,9 +653,9 @@
         "id": null,
         "name": "Standard",
         "logoUrl": null,
-        "logoAlt": "Bäckerei Welt",
+        "logoAlt": "Bäckerei Kornblum",
         "farbe": "#17150F",
-        "absenderName": "Bäckerei Welt",
+        "absenderName": "Bäckerei Kornblum",
         "fusszeile": []
       },
       "created_at": "2026-09-26T08:00:00.000Z",
@@ -789,9 +789,9 @@
         "id": null,
         "name": "Standard",
         "logoUrl": null,
-        "logoAlt": "Bäckerei Welt",
+        "logoAlt": "Bäckerei Kornblum",
         "farbe": "#17150F",
-        "absenderName": "Bäckerei Welt",
+        "absenderName": "Bäckerei Kornblum",
         "fusszeile": []
       },
       "created_at": "2026-09-26T08:00:00.000Z",
@@ -895,9 +895,9 @@
         "id": null,
         "name": "Standard",
         "logoUrl": null,
-        "logoAlt": "Bäckerei Welt",
+        "logoAlt": "Bäckerei Kornblum",
         "farbe": "#17150F",
-        "absenderName": "Bäckerei Welt",
+        "absenderName": "Bäckerei Kornblum",
         "fusszeile": []
       },
       "created_at": "2026-09-26T08:00:00.000Z",