@kreiseck/kasseneck-api 0.31.0 → 1.0.0-rc.2

package/dist/esm/stored/vokabular.js

@@ -0,0 +1,386 @@
+// Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
+// Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
+/** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
+export const VOKABULAR_QUELLE = "29994ca53adc96e7cb49b9e3688b102a69c126544ef092fc6579a2e1fcd0d555";
+/** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
+export const SCHEMAS = {
+    "getReceipt": {
+        "data": {
+            "receipt": {
+                "__": "receipt",
+                "headerVersionId": "kopfId",
+                "layoutRuleset": "layoutRegeln",
+                "registrationInfo": {
+                    "__": "pruefangaben",
+                    "cardRegisteredAt": "karteRegistriertAm",
+                    "cashregisterRegisteredAt": "kasseRegistriertAm"
+                },
+                "items": [
+                    {
+                        "__": "items",
+                        "receivedImmediately": "sofortErhalten"
+                    }
+                ]
+            },
+            "taxNumber": "taxnr",
+            "vatId": "uid",
+            "headerVersionId": "kopfId",
+            "registrationInfo": {
+                "__": "pruefangaben",
+                "cardRegisteredAt": "karteRegistriertAm",
+                "cashregisterRegisteredAt": "kasseRegistriertAm"
+            },
+            "testCashregister": "testKasse",
+            "testSignature": "testSignatur",
+            "logo_scale": "logo_skala",
+            "layout": {
+                "__": "layout",
+                "ruleset": "regelwerk",
+                "lines": [
+                    {
+                        "__": "lines",
+                        "tone": "ton"
+                    }
+                ]
+            }
+        },
+        "werte": {
+            "receipt.cancellationReason": {
+                "$catalog": "STORNO_GRUND"
+            },
+            "layout.lines[].tone": {
+                "$catalog": "LAYOUT_TON"
+            }
+        }
+    },
+    "getKasseSettings": {
+        "data": {
+            "business": {
+                "__": "betrieb",
+                "logoText": "logoText",
+                "logoEnabled": "logoAn",
+                "logoSize": "logoGroesse",
+                "watermark": "wasserzeichen",
+                "color": "farbe",
+                "theme": "stil",
+                "fontSize": "schrift",
+                "settingsFontSize": "schriftEinst",
+                "tileStyle": "kachelstil",
+                "clock": "uhr",
+                "lockScreen": "sperrbild",
+                "staffPhotos": "foto",
+                "autoLogoutMinutes": "autoAbMin",
+                "logoutAfterSale": "abNachVerkauf",
+                "fastLogin": "schnellLogin",
+                "showPrices": "preisAnzeigen",
+                "showVat": "ustAnzeigen",
+                "emoji": "emoji",
+                "categoryColors": "katFarben",
+                "customAmountAllowed": "freiErlaubt",
+                "vatRates": "saetze",
+                "quantity": "menge",
+                "note": "notiz",
+                "search": "suche",
+                "discount": "rabatt",
+                "payCash": "zahlBar",
+                "payCard": "zahlKarte",
+                "paySplit": "zahlGetrennt",
+                "cardProvider": "kartenanbieter",
+                "tip": "trinkgeld",
+                "tipMode": "tgModus",
+                "tipSteps": "tgStufen",
+                "tipSplit": "tgSplit",
+                "change": "rueckgeld",
+                "tipChips": "tgChips",
+                "exactCash": "schnellbar",
+                "checkoutMode": "kassierenModus",
+                "receiptOutput": "belegAusgabe",
+                "doneScreenSeconds": "fertigSekunden",
+                "logoImage": "logoBild",
+                "watermarkSide": "wzSeite",
+                "watermarkX": "wzPos",
+                "watermarkY": "wzPosV",
+                "watermarkStrength": "wzStaerke",
+                "logoScale": "logoSkala",
+                "watermarkScale": "wzSkala",
+                "glass": "glas",
+                "hints": "hinweise",
+                "discountChips": "rabattChips"
+            },
+            "device": {
+                "__": "geraet",
+                "layout": "layout",
+                "categoryPosition": "katpos",
+                "extraColumns": "spaltenExtra",
+                "tileHeight": "hoehe",
+                "touch": "touch",
+                "shortcuts": {
+                    "__": "tasten",
+                    "checkout": "kassieren",
+                    "complete": "abschliessen",
+                    "cancel": "abbrechen",
+                    "customAmount": "frei",
+                    "cash": "bar",
+                    "card": "karte",
+                    "exactAmount": "passend",
+                    "receipts": "belege",
+                    "undoLast": "letzteZurueck",
+                    "settings": "einstellungen",
+                    "logout": "abmelden",
+                    "tip": "trinkgeld",
+                    "fullscreen": "vollbild",
+                    "clearTendered": "gegebenLeeren",
+                    "clearCart": "korbLeeren",
+                    "splitPayment": "getrennt"
+                },
+                "printerEnabled": "druckerAn",
+                "printerType": "druckerArt",
+                "printerIp": "druckerIp",
+                "printerPort": "druckerPort",
+                "printerBluetoothId": "druckerBt",
+                "printerName": "druckerName",
+                "printerId": "druckerId",
+                "printerDeviceId": "druckerDevid",
+                "connectPrinterId": "connectDruckerId",
+                "paperSize": "papier",
+                "codePage": "zeichensatz",
+                "cut": "schnitt",
+                "qrMode": "qrModus",
+                "drawerEnabled": "ladeAn",
+                "drawerAutoOpen": "ladeAuto",
+                "terminalIp": "terminalIp",
+                "terminalPort": "terminalPort",
+                "terminalTid": "terminalTid",
+                "terminalVia": "terminalVia",
+                "terminalType": "terminalArt",
+                "shortcutHints": "tastenMarken"
+            }
+        },
+        "werte": {
+            "business.watermark": {
+                "$catalog": "KASSE_BETRIEB_WERTE.watermark"
+            },
+            "business.theme": {
+                "$catalog": "KASSE_BETRIEB_WERTE.theme"
+            },
+            "business.tileStyle": {
+                "$catalog": "KASSE_BETRIEB_WERTE.tileStyle"
+            },
+            "business.quantity": {
+                "$catalog": "KASSE_BETRIEB_WERTE.quantity"
+            },
+            "business.discount": {
+                "$catalog": "KASSE_BETRIEB_WERTE.discount"
+            },
+            "business.cardProvider": {
+                "$catalog": "KASSE_BETRIEB_WERTE.cardProvider"
+            },
+            "business.tipMode": {
+                "$catalog": "KASSE_BETRIEB_WERTE.tipMode"
+            },
+            "business.checkoutMode": {
+                "$catalog": "KASSE_BETRIEB_WERTE.checkoutMode"
+            },
+            "business.receiptOutput": {
+                "$catalog": "KASSE_BETRIEB_WERTE.receiptOutput"
+            },
+            "business.watermarkSide": {
+                "$catalog": "KASSE_BETRIEB_WERTE.watermarkSide"
+            },
+            "device.layout": {
+                "$catalog": "KASSE_GERAET_WERTE.layout"
+            },
+            "device.categoryPosition": {
+                "$catalog": "KASSE_GERAET_WERTE.categoryPosition"
+            },
+            "device.printerType": {
+                "$catalog": "KASSE_GERAET_WERTE.printerType"
+            },
+            "device.drawerAutoOpen": {
+                "$catalog": "KASSE_GERAET_WERTE.drawerAutoOpen"
+            },
+            "device.terminalVia": {
+                "$catalog": "KASSE_GERAET_WERTE.terminalVia"
+            },
+            "device.terminalType": {
+                "$catalog": "KASSE_GERAET_WERTE.terminalType"
+            }
+        }
+    },
+    "listMyArticles": {
+        "data": {
+            "articles": [
+                {
+                    "__": "articles",
+                    "quantityRule": "mengenregel",
+                    "askQuantity": "mengeFragen",
+                    "maxQuantity": "maxMenge",
+                    "tile": {
+                        "__": "kasse",
+                        "visible": "sichtbar",
+                        "sort": "sort"
+                    }
+                }
+            ]
+        },
+        "werte": {
+            "articles[].quantityRule": {
+                "$catalog": "MENGENREGEL"
+            },
+            "articles[].e1aGroup": {
+                "$catalog": "E1A_GRUPPE"
+            }
+        }
+    }
+};
+/** Die Felder eines Artikels in der Antwort (`listMyArticles`), aussen. */
+export const ARTIKEL_FELDER = [
+    "id",
+    "source",
+    "number",
+    "name",
+    "description",
+    "unit",
+    "unitPriceCents",
+    "vatRate",
+    "ean",
+    "internalCode",
+    "codeSpec",
+    "stockTracked",
+    "stockQty",
+    "minStock",
+    "e1aGroup",
+    "quantityRule",
+    "askQuantity",
+    "maxQuantity",
+    "revenueGroupId",
+    "active",
+    "groupId",
+    "tile"
+];
+/** Wertkataloge innen (deutsch) -> aussen (englisch). */
+export const KATALOGE = {
+    "E1A_GRUPPE": {
+        "waren": "goods_materials",
+        "fremdleistungen": "third_party_services",
+        "personal": "staff_costs",
+        "afa": "depreciation",
+        "gwg": "low_value_assets",
+        "miete": "rent_lease",
+        "instandhaltung_gebaeude": "building_maintenance",
+        "reise": "travel_expenses",
+        "oeffi_pauschale": "public_transport_allowance",
+        "kfz": "vehicle_costs",
+        "provisionen": "commissions_royalties",
+        "werbung": "advertising_hospitality",
+        "zinsen": "interest",
+        "sv_beitraege": "social_insurance_contributions",
+        "arbeitsplatz_klein": "workspace_allowance_small",
+        "arbeitsplatz_gross": "workspace_allowance_large",
+        "anlagenabgang": "asset_disposal_book_value",
+        "telefon_buero": "phone_internet_office_supplies",
+        "beratung": "legal_advisory",
+        "uebrige_ausgaben": "other_expenses",
+        "erloese": "revenue",
+        "erloese_109a": "revenue_109a",
+        "anlagenverkauf": "asset_sales_withdrawals",
+        "uebrige_einnahmen": "other_income"
+    },
+    "KASSE_BETRIEB_WERTE.cardProvider": {
+        "keiner": "none",
+        "extern": "external",
+        "gptom": "gptom",
+        "hobex": "hobex",
+        "mypos": "mypos",
+        "stripe": "stripe"
+    },
+    "KASSE_BETRIEB_WERTE.checkoutMode": {
+        "seite": "page",
+        "panel": "panel"
+    },
+    "KASSE_BETRIEB_WERTE.discount": {
+        "aus": "off",
+        "an": "on"
+    },
+    "KASSE_BETRIEB_WERTE.quantity": {
+        "aus": "off",
+        "x": "x",
+        "kg": "kg"
+    },
+    "KASSE_BETRIEB_WERTE.receiptOutput": {
+        "qr": "qr",
+        "druck": "print",
+        "mail": "email",
+        "sms": "sms",
+        "fragen": "ask"
+    },
+    "KASSE_BETRIEB_WERTE.theme": {
+        "klar": "clear",
+        "warm": "warm",
+        "nacht": "night",
+        "kontrast": "contrast"
+    },
+    "KASSE_BETRIEB_WERTE.tileStyle": {
+        "streifen": "stripe",
+        "voll": "full"
+    },
+    "KASSE_BETRIEB_WERTE.tipMode": {
+        "betrag": "amount",
+        "gesamt": "total",
+        "beides": "both"
+    },
+    "KASSE_BETRIEB_WERTE.watermark": {
+        "aus": "off",
+        "anmeldung": "login",
+        "ueberall": "everywhere"
+    },
+    "KASSE_BETRIEB_WERTE.watermarkSide": {
+        "links": "left",
+        "mitte": "center",
+        "rechts": "right"
+    },
+    "KASSE_GERAET_WERTE.categoryPosition": {
+        "oben": "top",
+        "links": "left"
+    },
+    "KASSE_GERAET_WERTE.drawerAutoOpen": {
+        "bar": "cash",
+        "immer": "always",
+        "nie": "never"
+    },
+    "KASSE_GERAET_WERTE.layout": {
+        "rechts": "right",
+        "links": "left",
+        "vollbild": "fullscreen"
+    },
+    "KASSE_GERAET_WERTE.printerType": {
+        "sdp": "sdp",
+        "netz": "network",
+        "bt": "bluetooth",
+        "usb": "usb",
+        "connect": "connect"
+    },
+    "KASSE_GERAET_WERTE.terminalType": {
+        "keins": "none",
+        "hps": "hps"
+    },
+    "KASSE_GERAET_WERTE.terminalVia": {
+        "direkt": "direct",
+        "connect": "connect"
+    },
+    "LAYOUT_TON": {
+        "belegart": "receipt_type",
+        "warnung": "warning"
+    },
+    "MENGENREGEL": {
+        "stueck": "piece",
+        "dezimal": "decimal"
+    },
+    "STORNO_GRUND": {
+        "fehleingabe": "input_error",
+        "kunde_storniert": "customer_cancelled",
+        "falsche_zahlart": "wrong_payment_method",
+        "doppelt_erfasst": "duplicate",
+        "sonstiges": "other"
+    }
+};

package/dist/esm/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Version dieses Pakets, wie sie in `package.json` steht. Sie geht als
+ * `Kasseneck-Client: kasseneck-api/<version>` an das Backend (Zaehlung je
+ * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
+ * beim Anheben der Version beide Stellen aendern.
+ */
+export declare const PACKAGE_VERSION = "1.0.0-rc.2";

package/dist/esm/version.js

@@ -0,0 +1,7 @@
+/**
+ * Version dieses Pakets, wie sie in `package.json` steht. Sie geht als
+ * `Kasseneck-Client: kasseneck-api/<version>` an das Backend (Zaehlung je
+ * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
+ * beim Anheben der Version beide Stellen aendern.
+ */
+export const PACKAGE_VERSION = '1.0.0-rc.2';

package/dist/esm/vienna-time.d.ts

@@ -20,4 +20,4 @@ export interface ViennaWallClock {
  * die Hinrichtung; hier ist er direkt anwendbar, weil der Zeitpunkt schon
  * feststeht.
  */
-export declare function toViennaWallClock(zeitpunkt: Date): ViennaWallClock;
+export declare function toViennaWallClock(instant: Date): ViennaWallClock;

package/dist/esm/vienna-time.js

@@ -62,8 +62,8 @@ export function parseServerTimeStamp(raw) {
  * die Hinrichtung; hier ist er direkt anwendbar, weil der Zeitpunkt schon
  * feststeht.
  */
-export function toViennaWallClock(zeitpunkt) {
-    const utcMs = zeitpunkt.getTime();
+export function toViennaWallClock(instant) {
+    const utcMs = instant.getTime();
     // Ein Invalid Date wuerde hier lautlos zu NaN in jedem Feld — und damit zu
     // einem NaN-Berichtsmonat beim Aufrufer.
     if (Number.isNaN(utcMs)) {

package/fixtures/{erwartet/storno-rabatt.lines.json → expected/cancellation-discount.lines.json}

@@ -37,7 +37,7 @@
     {
       "kind": "banner",
       "text": "STORNOBELEG",
-      "ton": "belegart"
+      "tone": "receipt_type"
     },
     {
       "kind": "text",
@@ -319,5 +319,5 @@
     }
   ],
   "paperSize": "mm80",
-  "regelwerk": 2
+  "ruleset": 2
 }

package/fixtures/expected/cancellation-discount.sheet32.json

@@ -0,0 +1,248 @@
+{
+  "charsPerLine": 32,
+  "blocks": [
+    {
+      "kind": "logo",
+      "widthFraction": 0.62,
+      "heightLines": 3.968
+    },
+    {
+      "kind": "line",
+      "text": "                                ",
+      "bold": false,
+      "blank": true
+    },
+    {
+      "kind": "line",
+      "text": "        Bäckerei Muster         ",
+      "bold": true,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "          Hauptplatz 1          ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "         4830 Hallstatt         ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "          ATU12345678           ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "         +43 6134 12345         ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "                                ",
+      "bold": false,
+      "blank": true
+    },
+    {
+      "kind": "line",
+      "text": "================================",
+      "bold": true,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "          STORNOBELEG           ",
+      "bold": true,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "================================",
+      "bold": true,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "     Stornobuchung zu Beleg     ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "         AT0-KASSE1-55          ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "   vom 11.08.2026, 09:02 Uhr    ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "       Grund: Fehleingabe       ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "                                ",
+      "bold": false,
+      "blank": true
+    },
+    {
+      "kind": "line",
+      "text": "Datum:       13.08.2026 10:15:30",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "Kassen-ID:                KASSE1",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "Beleg-ID:          AT0-KASSE1-58",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "                                ",
+      "bold": false,
+      "blank": true
+    },
+    {
+      "kind": "line",
+      "text": "4  x Semmel              -3,16 B",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "je -0,79                        ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "1  x Kaffee klein        -2,80 A",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "--------------------------------",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "Zwischensumme            -5,96  ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "Rabatt 10 %               0,60 *",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "* davon 0,28 A, 0,32 B          ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "                                ",
+      "bold": false,
+      "blank": true
+    },
+    {
+      "kind": "line",
+      "text": "MwSt%   MwSt      Netto   Brutto",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "B 10%   -0,26     -2,58    -2,84",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "A 20%   -0,42     -2,10    -2,52",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "--------------------------------",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "Gesamt:                  -5,36 €",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "Zahlungsart:          Barzahlung",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "                                ",
+      "bold": false,
+      "blank": true
+    },
+    {
+      "kind": "qr",
+      "payload": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_6F0404F0_SIGNATUR",
+      "widthFraction": 0.828125
+    },
+    {
+      "kind": "line",
+      "text": "                                ",
+      "bold": false,
+      "blank": true
+    },
+    {
+      "kind": "line",
+      "text": " Vielen Dank für Ihren Einkauf  ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "    www.baeckerei-muster.at     ",
+      "bold": false,
+      "blank": false
+    },
+    {
+      "kind": "line",
+      "text": "                                ",
+      "bold": false,
+      "blank": true
+    },
+    {
+      "kind": "brandMark",
+      "width": 234,
+      "height": 34
+    }
+  ]
+}