@kreiseck/kasseneck-api 1.13.0 → 1.15.0

package/fixtures/v3/antworten/kasse.json

@@ -2,10 +2,10 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "default": {
-      "sha256": "016031af787794cf6e72932fd203138b45b7a758510af990475d9f68d35ac556",
+      "sha256": "ca4d4b3b682333ac6dc4345e5876323c60ee7e00896ccbe1c5f3d49ce37a52aa",
       "head": [],
-      "inputsSha256": "684e236f4e84e7befba5ebda44021eefc4de50a6f2507cf4de5b456e9a2ed790",
-      "backendPackage": "@kreiseck/kasseneck-api@0.33.1",
+      "inputsSha256": "8f4e49cab74d8786c76d8130be585dab2713cb241fd12a8e1e8ae8167067fcf4",
+      "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": "d4cf64a3983e96e272d2934a4e9d0e17752ce772ef817d91836593419a680e1c",
+      "sha256": "de42edbec8757863eadac3cefca79e66cecf17186ee7ce617f5ea70baa53a99c",
       "head": [
         "channel",
         "note"
       ],
-      "inputsSha256": "1efd9f548d9b578193c3dbf4aae041f4ffaa1adcaba01a7c5e2df7ba882efa94",
+      "inputsSha256": "690f2ab0217ada255d62bbe6f35ec1d393941d5403ee37f7fef6ddbc42693d86",
       "backendPackage": "@kreiseck/kasseneck-api@0.14.0",
       "inputs": [
         "functions-kasse/gemeinsam/api-rand.js",
@@ -329,7 +329,7 @@
           },
           "response": {
             "status": "error",
-            "message": "4 von 2 Lizenzplätzen dieser Kasse sind vergeben — zuerst ein Gerät entkoppeln (Kassen-Geräte) oder Lizenzen erweitern.",
+            "message": "4 von 2 Lizenzplätzen dieser Kasse sind vergeben – zuerst ein Gerät entkoppeln (Kassen-Geräte) oder Lizenzen erweitern.",
             "data": {
               "pairedDevices": 4,
               "licenses": 2,
@@ -352,7 +352,7 @@
           },
           "response": {
             "status": "error",
-            "message": "4 von 1 Lizenzplatz dieser Kasse sind vergeben — zuerst ein Gerät entkoppeln (Kassen-Geräte) oder Lizenzen erweitern.",
+            "message": "4 von 1 Lizenzplatz dieser Kasse sind vergeben – zuerst ein Gerät entkoppeln (Kassen-Geräte) oder Lizenzen erweitern.",
             "data": {
               "pairedDevices": 4,
               "licenses": 1,
@@ -3327,7 +3327,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Anmeldung derzeit nicht möglich — bitte den Betreiber verständigen.",
+            "message": "Anmeldung derzeit nicht möglich – bitte den Betreiber verständigen.",
             "data": {
               "code": "login_unavailable"
             },
@@ -3834,7 +3834,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Diese Kasse verwendet die Benutzerauswahl — bitte die Seite neu laden.",
+            "message": "Diese Kasse verwendet die Benutzerauswahl – bitte die Seite neu laden.",
             "data": {
               "code": "login_mode_select_user"
             },
@@ -4333,7 +4333,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Anmeldung abgelaufen oder ungültig — bitte neu einloggen.",
+            "message": "Anmeldung abgelaufen oder ungültig – bitte neu einloggen.",
             "data": {
               "code": "unauthorized"
             },
@@ -4390,7 +4390,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -4409,7 +4409,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -4529,7 +4529,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Anmeldung abgelaufen oder ungültig — bitte neu einloggen.",
+            "message": "Anmeldung abgelaufen oder ungültig – bitte neu einloggen.",
             "data": {
               "code": "unauthorized"
             },
@@ -4586,7 +4586,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -4605,7 +4605,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -4928,7 +4928,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Anmeldung abgelaufen oder ungültig — bitte neu einloggen.",
+            "message": "Anmeldung abgelaufen oder ungültig – bitte neu einloggen.",
             "data": {
               "code": "unauthorized"
             },
@@ -4947,7 +4947,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -6146,7 +6146,8 @@
                     "tone": "warning"
                   }
                 ]
-              }
+              },
+              "outputs": []
             }
           }
         },
@@ -6462,7 +6463,8 @@
                     "tone": "warning"
                   }
                 ]
-              }
+              },
+              "outputs": []
             }
           }
         },
@@ -6574,7 +6576,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung gehört zu einer anderen Kasse — bitte dort neu anmelden.",
+            "message": "Sitzung gehört zu einer anderen Kasse – bitte dort neu anmelden.",
             "data": {
               "code": "session_other_cashregister"
             },
@@ -9688,7 +9690,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Zu viele Versandversuche — bitte später erneut versuchen.",
+            "message": "Zu viele Versandversuche – bitte später erneut versuchen.",
             "data": {
               "code": "too_many_requests"
             },
@@ -9842,7 +9844,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -10055,7 +10057,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -10310,7 +10312,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Anmeldung abgelaufen oder ungültig — bitte neu einloggen.",
+            "message": "Anmeldung abgelaufen oder ungültig – bitte neu einloggen.",
             "data": {
               "code": "unauthorized"
             },
@@ -10329,7 +10331,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -10546,7 +10548,20 @@
               "vouchers": {
                 "sale": false,
                 "valueVoucherType": null,
-                "vatRateBp": null
+                "vatRateBp": null,
+                "label": {
+                  "layout": "a",
+                  "size": "40x30",
+                  "fields": {
+                    "logo": true,
+                    "qr": true,
+                    "business": true,
+                    "value": true,
+                    "validity": true,
+                    "checkPage": true
+                  },
+                  "freeText": []
+                }
               }
             }
           }
@@ -10717,7 +10732,20 @@
               "vouchers": {
                 "sale": false,
                 "valueVoucherType": null,
-                "vatRateBp": null
+                "vatRateBp": null,
+                "label": {
+                  "layout": "a",
+                  "size": "40x30",
+                  "fields": {
+                    "logo": true,
+                    "qr": true,
+                    "business": true,
+                    "value": true,
+                    "validity": true,
+                    "checkPage": true
+                  },
+                  "freeText": []
+                }
               }
             }
           }
@@ -10734,7 +10762,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Live-Umgebung noch nicht freigeschaltet. Bitte im Test-Modus arbeiten — die Freischaltung erfolgt durch Kasseneck.",
+            "message": "Live-Umgebung noch nicht freigeschaltet. Bitte im Test-Modus arbeiten – die Freischaltung erfolgt durch Kasseneck.",
             "data": {
               "code": "live_not_enabled"
             },
@@ -10926,7 +10954,20 @@
               "vouchers": {
                 "sale": false,
                 "valueVoucherType": null,
-                "vatRateBp": null
+                "vatRateBp": null,
+                "label": {
+                  "layout": "a",
+                  "size": "40x30",
+                  "fields": {
+                    "logo": true,
+                    "qr": true,
+                    "business": true,
+                    "value": true,
+                    "validity": true,
+                    "checkPage": true
+                  },
+                  "freeText": []
+                }
               }
             }
           }
@@ -11097,7 +11138,20 @@
               "vouchers": {
                 "sale": false,
                 "valueVoucherType": null,
-                "vatRateBp": null
+                "vatRateBp": null,
+                "label": {
+                  "layout": "a",
+                  "size": "40x30",
+                  "fields": {
+                    "logo": true,
+                    "qr": true,
+                    "business": true,
+                    "value": true,
+                    "validity": true,
+                    "checkPage": true
+                  },
+                  "freeText": []
+                }
               }
             }
           }
@@ -11268,7 +11322,20 @@
               "vouchers": {
                 "sale": false,
                 "valueVoucherType": null,
-                "vatRateBp": null
+                "vatRateBp": null,
+                "label": {
+                  "layout": "a",
+                  "size": "40x30",
+                  "fields": {
+                    "logo": true,
+                    "qr": true,
+                    "business": true,
+                    "value": true,
+                    "validity": true,
+                    "checkPage": true
+                  },
+                  "freeText": []
+                }
               }
             }
           }
@@ -11503,7 +11570,7 @@
                 "logoEnabled": true,
                 "logoSize": "M",
                 "watermark": "login",
-                "color": "#136B6B",
+                "color": "#222222",
                 "theme": "clear",
                 "fontSize": "M",
                 "settingsFontSize": "S",
@@ -11597,7 +11664,7 @@
                 "logoSize": "M",
                 "watermark": "login",
                 "color": "#136B6B",
-                "theme": "clear",
+                "theme": "night",
                 "fontSize": "L",
                 "settingsFontSize": "S",
                 "tileStyle": "stripe",
@@ -12378,7 +12445,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -13196,7 +13263,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung gehört zu einer anderen Kasse — bitte dort neu anmelden.",
+            "message": "Sitzung gehört zu einer anderen Kasse – bitte dort neu anmelden.",
             "data": {
               "code": "session_other_cashregister"
             },
@@ -13424,7 +13491,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -13624,7 +13691,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -14083,7 +14150,7 @@
           },
           "response": {
             "status": "error",
-            "message": "Sitzung abgelaufen oder übernommen — bitte neu anmelden.",
+            "message": "Sitzung abgelaufen oder übernommen – bitte neu anmelden.",
             "data": {
               "code": "session_expired"
             },
@@ -22941,6 +23008,380 @@
           }
         }
       ]
+    },
+    "logReceiptOutputs": {
+      "codebase": "kasse",
+      "cases": [
+        {
+          "case": "without_token",
+          "method": "POST",
+          "caller": "none",
+          "params": {
+            "cashregisterId": "KASSE1",
+            "entries": [
+              {
+                "key": "druck-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409480000,
+                "kind": "print",
+                "result": "ok"
+              },
+              {
+                "key": "druck-0002",
+                "receiptId": "KASSE1-ID-7",
+                "at": "2026-09-26T09:59:00+02:00",
+                "kind": "reprint",
+                "result": "unclear"
+              },
+              {
+                "key": "teilen-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409570000,
+                "kind": "link_shared"
+              }
+            ]
+          },
+          "httpStatus": 200,
+          "headers": {
+            "Kasseneck-Api-Version": "v3",
+            "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+          },
+          "response": {
+            "status": "error",
+            "message": "Ungültiger Request: Authorization key erwartet.",
+            "data": {
+              "code": "unauthorized"
+            },
+            "code": "unauthorized"
+          }
+        },
+        {
+          "case": "data_missing",
+          "method": "POST",
+          "caller": "register_user_cashier",
+          "params": {
+            "cashregisterId": "KASSE1"
+          },
+          "httpStatus": 200,
+          "headers": {
+            "Kasseneck-Api-Version": "v3",
+            "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+          },
+          "response": {
+            "status": "error",
+            "message": "Ungültige Daten: Nicht alle erforderlichen Parameter wurden übergeben oder Typen stimmen nicht überein: entries",
+            "data": {
+              "code": "validation",
+              "errors": [
+                {
+                  "field": "entries",
+                  "message": "Pflichtfeld fehlt."
+                }
+              ]
+            },
+            "code": "validation"
+          }
+        },
+        {
+          "case": "foreign_cashregister",
+          "method": "POST",
+          "caller": "register_user_other_cashregister",
+          "params": {
+            "cashregisterId": "KASSE1",
+            "entries": [
+              {
+                "key": "druck-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409480000,
+                "kind": "print",
+                "result": "ok"
+              },
+              {
+                "key": "druck-0002",
+                "receiptId": "KASSE1-ID-7",
+                "at": "2026-09-26T09:59:00+02:00",
+                "kind": "reprint",
+                "result": "unclear"
+              },
+              {
+                "key": "teilen-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409570000,
+                "kind": "link_shared"
+              }
+            ]
+          },
+          "httpStatus": 200,
+          "headers": {
+            "Kasseneck-Api-Version": "v3",
+            "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+          },
+          "response": {
+            "status": "error",
+            "message": "Diese Kasse ist dem Benutzer nicht zugewiesen.",
+            "data": {
+              "code": "cashregister_not_assigned"
+            },
+            "code": "cashregister_not_assigned"
+          }
+        },
+        {
+          "case": "entries_empty",
+          "method": "POST",
+          "caller": "register_user_cashier",
+          "params": {
+            "cashregisterId": "KASSE1",
+            "entries": []
+          },
+          "httpStatus": 200,
+          "headers": {
+            "Kasseneck-Api-Version": "v3",
+            "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+          },
+          "response": {
+            "status": "error",
+            "message": "Bitte Eingaben prüfen.",
+            "data": {
+              "errors": [
+                {
+                  "field": "entries",
+                  "message": "Ein bis 50 Einträge angeben."
+                }
+              ],
+              "code": "validation"
+            },
+            "code": "validation"
+          }
+        },
+        {
+          "case": "success_cashier",
+          "method": "POST",
+          "caller": "register_user_cashier",
+          "params": {
+            "cashregisterId": "KASSE1",
+            "entries": [
+              {
+                "key": "druck-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409480000,
+                "kind": "print",
+                "result": "ok"
+              },
+              {
+                "key": "druck-0002",
+                "receiptId": "KASSE1-ID-7",
+                "at": "2026-09-26T09:59:00+02:00",
+                "kind": "reprint",
+                "result": "unclear"
+              },
+              {
+                "key": "teilen-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409570000,
+                "kind": "link_shared"
+              }
+            ]
+          },
+          "httpStatus": 200,
+          "headers": {
+            "Kasseneck-Api-Version": "v3",
+            "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+          },
+          "response": {
+            "status": "success",
+            "message": "",
+            "data": {
+              "accepted": 3,
+              "rejected": []
+            }
+          }
+        },
+        {
+          "case": "success_duplicate",
+          "method": "POST",
+          "caller": "register_user_cashier",
+          "params": {
+            "cashregisterId": "KASSE1",
+            "entries": [
+              {
+                "key": "druck-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409480000,
+                "kind": "print",
+                "result": "ok"
+              },
+              {
+                "key": "druck-0002",
+                "receiptId": "KASSE1-ID-7",
+                "at": "2026-09-26T09:59:00+02:00",
+                "kind": "reprint",
+                "result": "unclear"
+              },
+              {
+                "key": "teilen-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409570000,
+                "kind": "link_shared"
+              }
+            ]
+          },
+          "httpStatus": 200,
+          "headers": {
+            "Kasseneck-Api-Version": "v3",
+            "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+          },
+          "response": {
+            "status": "success",
+            "message": "",
+            "data": {
+              "accepted": 3,
+              "rejected": []
+            }
+          }
+        },
+        {
+          "case": "success_api_key",
+          "method": "POST",
+          "caller": "device_api_key",
+          "params": {
+            "entries": [
+              {
+                "key": "teilen-0002",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409599000,
+                "kind": "pdf_shared",
+                "result": "ok"
+              }
+            ]
+          },
+          "httpStatus": 200,
+          "headers": {
+            "Kasseneck-Api-Version": "v3",
+            "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+          },
+          "response": {
+            "status": "success",
+            "message": "",
+            "data": {
+              "accepted": 1,
+              "rejected": []
+            }
+          }
+        },
+        {
+          "case": "mixed",
+          "method": "POST",
+          "caller": "register_user_manager",
+          "params": {
+            "cashregisterId": "KASSE1",
+            "entries": [
+              {
+                "key": "mail-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409599000,
+                "kind": "email",
+                "result": "ok"
+              },
+              {
+                "key": "abruf-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409599000,
+                "kind": "opened",
+                "result": "ok"
+              },
+              {
+                "key": "fremd-0001",
+                "receiptId": "KASSE3-ID-1",
+                "at": 1790409599000,
+                "kind": "print",
+                "result": "ok"
+              },
+              {
+                "key": "zeit-0001",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790410200000,
+                "kind": "print",
+                "result": "ok"
+              },
+              {
+                "key": "kurz",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409599000,
+                "kind": "print",
+                "result": "ok"
+              },
+              {
+                "key": "druck-0009",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409599000,
+                "kind": "reprint"
+              },
+              {
+                "key": "druck-0010",
+                "receiptId": "KASSE1-ID-7",
+                "at": 1790409599000,
+                "kind": "reprint",
+                "result": "failed"
+              }
+            ]
+          },
+          "httpStatus": 200,
+          "headers": {
+            "Kasseneck-Api-Version": "v3",
+            "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+          },
+          "response": {
+            "status": "success",
+            "message": "",
+            "data": {
+              "accepted": 2,
+              "rejected": [
+                {
+                  "key": "mail-0001",
+                  "code": "invalid_output_kind"
+                },
+                {
+                  "key": "abruf-0001",
+                  "code": "invalid_output_kind"
+                },
+                {
+                  "key": "fremd-0001",
+                  "code": "receipt_not_found"
+                },
+                {
+                  "key": "kurz",
+                  "code": "idempotency_key_required"
+                },
+                {
+                  "key": "druck-0009",
+                  "code": "validation"
+                }
+              ]
+            }
+          }
+        },
+        {
+          "case": "preflight_options",
+          "method": "OPTIONS",
+          "caller": "other",
+          "params": {
+            "$body": {}
+          },
+          "httpStatus": 200,
+          "headers": {
+            "Kasseneck-Api-Version": "v3",
+            "Access-Control-Expose-Headers": "Kasseneck-Api-Version"
+          },
+          "response": {
+            "status": "error",
+            "message": "Bitte verwenden Sie eine POST-Anfrage",
+            "data": {
+              "code": "method_not_allowed"
+            },
+            "code": "method_not_allowed"
+          }
+        }
+      ]
     }
   }
 }