@kreiseck/kasseneck-api 0.7.0 → 0.7.2

package/dist/esm/register/pairing.js

@@ -109,6 +109,48 @@ export async function unpairRegisterDevice(options) {
     pflicht(name, 'deviceSecret', deviceSecret);
     await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret }, undefined, [deviceSecret]);
 }
+/**
+ * Welche Sitzungen haelt diese Kasse gerade?
+ *
+ * Fuer den Anmeldebildschirm: Sind alle Lizenzplaetze belegt, muss eine
+ * weichen -- und der Kassier soll sehen, WELCHE, statt dass das Backend still
+ * die aelteste nimmt. Die Wahl geht dann als
+ * [RegisterUserLoginOptions.takeoverSessionId] mit.
+ *
+ * Ausgewiesen wird sich ueber das Geraete-Geheimnis, wie bei
+ * [listRegisterUsersForDevice]: An diesem Punkt gibt es weder Sitzung noch
+ * Token. Die Kasse bestimmt das Backend aus dem Geraet, nicht aus dem Aufruf.
+ */
+export async function listRegisterSessionsForDevice(options) {
+    const { ownerUid, deviceId, deviceSecret, ...verbindung } = options;
+    const name = 'listRegisterSessionsForDevice';
+    pflicht(name, 'ownerUid', ownerUid);
+    pflicht(name, 'deviceId', deviceId);
+    pflicht(name, 'deviceSecret', deviceSecret);
+    const daten = await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret }, undefined, [deviceSecret]);
+    const liste = daten?.sessions;
+    if (!Array.isArray(liste)) {
+        throw antwortfehler(name, 'Antwort enthaelt keine Sitzungsliste (data.sessions fehlt)');
+    }
+    const sessions = liste.map((eintrag) => {
+        const roh = (typeof eintrag === 'object' && eintrag !== null ? eintrag : {});
+        return {
+            // Ohne Kennung waere die Zeile nicht waehlbar -- eine Schaltflaeche, die
+            // nichts tun kann, ist schlimmer als keine.
+            id: pflichtfeld(name, roh, 'id'),
+            deviceId: typeof roh['deviceId'] === 'string' && roh['deviceId'] ? roh['deviceId'] : null,
+            deviceLabel: text(roh['deviceLabel']) || 'Kasse',
+            startedAt: typeof roh['startedAt'] === 'number' ? roh['startedAt'] : null,
+            expiresAt: typeof roh['expiresAt'] === 'number' ? roh['expiresAt'] : null,
+            selbst: roh['selbst'] === true,
+            // Nur uebernehmen, wenn wirklich einer kam: ein leerer String stuende
+            // in der Oberflaeche als namenlose Zeile, statt die Spalte wegzulassen.
+            ...(typeof roh['userName'] === 'string' && roh['userName'] ? { userName: roh['userName'] } : {}),
+        };
+    });
+    const licenses = typeof daten?.licenses === 'number' && daten.licenses > 0 ? daten.licenses : 1;
+    return { licenses, sessions };
+}
 export async function listRegisterUsersForDevice(options) {
     const { ownerUid, deviceId, deviceSecret, ...verbindung } = options;
     const name = 'listRegisterUsersForDevice';
@@ -182,7 +224,7 @@ function regel(wert) {
  * sperren gestaffelt (ab dem fuenften 30 Sekunden, ab dem neunten 15 Minuten).
  */
 export async function registerUserLogin(options) {
-    const { ownerUid, deviceId, deviceSecret, userId, pin, cashregisterId, takeover, client, geo, ...verbindung } = options;
+    const { ownerUid, deviceId, deviceSecret, userId, pin, cashregisterId, takeover, takeoverSessionId, client, geo, ...verbindung } = options;
     const name = 'registerUserLogin';
     pflicht(name, 'ownerUid', ownerUid);
     pflicht(name, 'deviceId', deviceId);
@@ -200,6 +242,9 @@ export async function registerUserLogin(options) {
         // Nur die ausdrueckliche Uebernahme geht mit: das Backend prueft auf
         // `=== true`, und ein mitgesendetes `false` waere nur Rauschen.
         takeover: takeover === true ? true : undefined,
+        // Leerer String heisst „nichts gewaehlt" und gehoert nicht in die
+        // Nutzlast -- das Backend wiese ihn sonst als unbekannte Sitzung ab.
+        takeoverSessionId: takeoverSessionId ? takeoverSessionId : undefined,
         client, geo: geo ?? undefined,
     }, undefined, [pin, deviceSecret]);
     return sitzungAusAntwort(name, daten);
@@ -211,7 +256,7 @@ export async function registerUserLogin(options) {
  * zaehlen und sperren dort am **Geraet**, nicht an einem Benutzer.
  */
 export async function registerPinLogin(options) {
-    const { ownerUid, deviceId, deviceSecret, pin, cashregisterId, takeover, client, geo, ...verbindung } = options;
+    const { ownerUid, deviceId, deviceSecret, pin, cashregisterId, takeover, takeoverSessionId, client, geo, ...verbindung } = options;
     const name = 'registerPinLogin';
     pflicht(name, 'ownerUid', ownerUid);
     pflicht(name, 'deviceId', deviceId);
@@ -226,6 +271,9 @@ export async function registerPinLogin(options) {
         cashregisterId,
         // Nur die ausdrueckliche Uebernahme geht mit — wie bei registerUserLogin.
         takeover: takeover === true ? true : undefined,
+        // Leerer String heisst „nichts gewaehlt" und gehoert nicht in die
+        // Nutzlast -- das Backend wiese ihn sonst als unbekannte Sitzung ab.
+        takeoverSessionId: takeoverSessionId ? takeoverSessionId : undefined,
         client, geo: geo ?? undefined,
     }, undefined, [pin, deviceSecret]);
     return sitzungAusAntwort(name, daten);

package/fixtures/belege/storno-rabatt.json

@@ -58,11 +58,12 @@
     "legalMessage": [],
     "cancellationOf": {
       "receiptId": "AT0-KASSE1-55",
-      "fullReceiptId": null
+      "fullReceiptId": null,
+      "timeStamp": "2026-08-11T09:02:17"
     },
     "cancellationReason": "fehleingabe"
   },
   "options": {
     "paperSize": "mm80"
   }
-}
+}

package/fixtures/belege/storno-teil.json

@@ -38,7 +38,8 @@
     "legalMessage": [],
     "cancellationOf": {
       "receiptId": "AT0-KASSE1-42",
-      "fullReceiptId": null
+      "fullReceiptId": null,
+      "timeStamp": "2026-08-11T09:02:17"
     },
     "cancellationReason": "fehleingabe"
   },

package/fixtures/belege/storno-voll.json

@@ -44,7 +44,8 @@
     "legalMessage": [],
     "cancellationOf": {
       "receiptId": "AT0-KASSE1-42",
-      "fullReceiptId": null
+      "fullReceiptId": null,
+      "timeStamp": "2026-08-11T09:02:17"
     },
     "cancellationReason": "kunde_storniert"
   },

package/fixtures/erwartet/storno-rabatt.grid32.txt

@@ -7,6 +7,7 @@
           STORNOBELEG           
      Stornobuchung zu Beleg     
          AT0-KASSE1-55          
+   vom 11.08.2026, 09:02 Uhr    
        Grund: Fehleingabe       
                                 
 Datum:       13.08.2026 10:15:30

package/fixtures/erwartet/storno-rabatt.grid48.txt

@@ -6,6 +6,7 @@
                                                 
                   STORNOBELEG                   
       Stornobuchung zu Beleg AT0-KASSE1-55      
+           vom 11.08.2026, 09:02 Uhr            
                Grund: Fehleingabe               
                                                 
 Datum:                       13.08.2026 10:15:30

package/fixtures/erwartet/storno-rabatt.lines.json

@@ -45,6 +45,12 @@
       "align": "center",
       "bold": false
     },
+    {
+      "kind": "text",
+      "text": "vom 11.08.2026, 09:02 Uhr",
+      "align": "center",
+      "bold": false
+    },
     {
       "kind": "text",
       "text": "Grund: Fehleingabe",

package/fixtures/erwartet/storno-teil.grid32.txt

@@ -7,6 +7,7 @@
           STORNOBELEG           
      Stornobuchung zu Beleg     
          AT0-KASSE1-42          
+   vom 11.08.2026, 09:02 Uhr    
        Grund: Fehleingabe       
                                 
 Datum:       13.08.2026 10:15:30

package/fixtures/erwartet/storno-teil.grid48.txt

@@ -6,6 +6,7 @@
                                                 
                   STORNOBELEG                   
       Stornobuchung zu Beleg AT0-KASSE1-42      
+           vom 11.08.2026, 09:02 Uhr            
                Grund: Fehleingabe               
                                                 
 Datum:                       13.08.2026 10:15:30

package/fixtures/erwartet/storno-teil.lines.json

@@ -45,6 +45,12 @@
       "align": "center",
       "bold": false
     },
+    {
+      "kind": "text",
+      "text": "vom 11.08.2026, 09:02 Uhr",
+      "align": "center",
+      "bold": false
+    },
     {
       "kind": "text",
       "text": "Grund: Fehleingabe",

package/fixtures/erwartet/storno-voll.grid32.txt

@@ -7,6 +7,7 @@
           STORNOBELEG           
      Stornobuchung zu Beleg     
          AT0-KASSE1-42          
+   vom 11.08.2026, 09:02 Uhr    
    Grund: Kunde hat storniert   
                                 
 Datum:       13.08.2026 10:15:30

package/fixtures/erwartet/storno-voll.grid48.txt

@@ -6,6 +6,7 @@
                                                 
                   STORNOBELEG                   
       Stornobuchung zu Beleg AT0-KASSE1-42      
+           vom 11.08.2026, 09:02 Uhr            
            Grund: Kunde hat storniert           
                                                 
 Datum:                       13.08.2026 10:15:30

package/fixtures/erwartet/storno-voll.lines.json

@@ -45,6 +45,12 @@
       "align": "center",
       "bold": false
     },
+    {
+      "kind": "text",
+      "text": "vom 11.08.2026, 09:02 Uhr",
+      "align": "center",
+      "bold": false
+    },
     {
       "kind": "text",
       "text": "Grund: Kunde hat storniert",

package/fixtures/hobex-hps-codes.json

@@ -0,0 +1,83 @@
+{
+  "version": "0.7.2",
+  "gemessenAn": {
+    "tid": "3600335",
+    "hpsVersion": "1.10.0",
+    "firmware": "7.3.6",
+    "zeitraum": "26.-28.08.2026"
+  },
+  "ergaenztAn": [
+    {
+      "tid": "3556988",
+      "hpsVersion": "1.11.4",
+      "firmware": "2.3.9",
+      "zeitraum": "02.09.2026",
+      "codes": [
+        "55"
+      ]
+    }
+  ],
+  "codes": [
+    {
+      "code": "0",
+      "meaning": "genehmigt",
+      "conclusive": true
+    },
+    {
+      "code": "9002",
+      "meaning": "ungueltiger Vorgang -- das Terminal hat den Vorgang selbst als unzulaessig verworfen, bevor irgendetwas in Bewegung kam",
+      "conclusive": true
+    },
+    {
+      "code": "9011",
+      "meaning": "aufgehoben (\"Transaction Canceled\") -- der Vorgang unter dieser Kennung wurde storniert",
+      "conclusive": true
+    },
+    {
+      "code": "9027",
+      "meaning": "keine Aussage -- steht gleichermassen fuer \"nie gesehen\", \"laeuft gerade\", \"Karte nicht aufgelegt\" und \"abgebrochen\"",
+      "conclusive": false
+    },
+    {
+      "code": "9900",
+      "meaning": "\"Technical Error Database\" -- gemessen im Zusammenhang mit einer nicht rein numerischen Kennung; keine Aussage ueber den Vorgang selbst",
+      "conclusive": false
+    },
+    {
+      "code": "9003",
+      "meaning": "\"Invalid Amount\" -- der Betrag wird abgewiesen, BEVOR eine Karte verlangt wird (28.08.2026: 99999,99 EUR, Antwort nach 15,7 s ohne Kartenaufforderung); nichts belastet",
+      "conclusive": true
+    },
+    {
+      "code": "100002",
+      "meaning": "abgebrochen (\"Aborted\")",
+      "conclusive": true
+    },
+    {
+      "code": "100003",
+      "meaning": "Karte nicht aufgelegt (\"Card not present\")",
+      "conclusive": true
+    },
+    {
+      "code": "100010",
+      "meaning": "nicht mehr abbrechbar -- der Vorgang ist bereits abgeschlossen",
+      "conclusive": true
+    },
+    {
+      "code": "100019",
+      "meaning": "\"Amount is not in a valid range\" -- Betrag ausserhalb des zulaessigen Bereichs, gemessen mit negativem Betrag; Abweisung vor dem Kartenfluss, nichts belastet",
+      "conclusive": true
+    },
+    {
+      "code": "100108",
+      "meaning": "\"Invalid TID\" -- die Terminal-Kennung gibt es an diesem Geraet nicht; der Vorgang wird abgewiesen, bevor etwas geschieht",
+      "conclusive": true
+    },
+    {
+      "code": "55",
+      "meaning": "\"PIN falsch\" -- Host-Ablehnung wegen falscher PIN, die erste gemessene Host-Ablehnung ueberhaupt (02.09.2026 im Betrieb, TID 3556988, HPS 1.11.4, Firmware 2.3.9): die Zahlung antwortete direkt damit, die Statusabfrage danach elfmal in Folge ebenso -- eine Host-Ablehnung bleibt am Terminal abrufbar; nichts belastet",
+      "conclusive": true
+    }
+  ],
+  "terminalBusyHttpStatus": 409
+}

package/fixtures/manifest.json

@@ -80,22 +80,22 @@
       "grid48": "e0f4e73c873ae0a70623c7c05673a5ca9b736822375c13f6ed0cd3351ab767f9"
     },
     "storno-rabatt": {
-      "eingabe": "80021cbf2da292c6d82baf92c51fb7fb67ad5bb3d55a452efaa67bf2cc6b4c72",
-      "erwartet": "7a0ce1111094dcc8effb1fffde56f0f69de621318212eec3ac375cc188a5cb56",
-      "grid32": "85a0dae903f3bf81b8c1736f4d5ea252472b684d14c26cc77483818080c59a69",
-      "grid48": "6cb23805cff69c09d7941f184b5b741667010a9da660eb3e06fec095995988dc"
+      "eingabe": "d6bd978f4cc3e9c8c4315c573c7a3f5c8dfea4bf65fce6789f268056a521ec15",
+      "erwartet": "a10fc0dbbfd46366feab7431ab1608ad5a76418e80b50d2903c574ee2cb70040",
+      "grid32": "5f932ee49c9b7ee1e1dfc5fe703a18da43c782072012280ca93b177b0c535c20",
+      "grid48": "dc84efa238626d782cb049df6299d65fa2a5740795e610ecaf903ac4ca296434"
     },
     "storno-teil": {
-      "eingabe": "80320cbc1f48fa6b1668662f8aad766733ae7e0695c9c1680f8a115e0c927239",
-      "erwartet": "5638fe514e620d8bad9531f706d9a986fff386b41b8cfd1126302272fca55f5b",
-      "grid32": "d36d0e37bf342a1e50d6b8aa41f4664196fa61fa1c5c43fc0097db77d8e89c90",
-      "grid48": "2e2b691119144cbb5e7c4d5ccadee7e46454723a62371fabc2d30766d7d42e1b"
+      "eingabe": "2f4cab11c1c9e8bb4722dd6c4a279825a9e31e3b6a9335c017bc587d97af0fd4",
+      "erwartet": "dcf388d74261171b3b004f1abb51650dd7d2d53f7b2c8a4ae453ce47ec3e01e6",
+      "grid32": "e340077738bb0e336cc64a5c8e15a6712624e7d3ecbe7a3f981580c2efe446c7",
+      "grid48": "c62513749f18d8cb230b96607cfae46e49e99b50799b57308c747f8a12973d0a"
     },
     "storno-voll": {
-      "eingabe": "53ecbfa12576bee3e3077bbf104324794790008e5d54efe6135664388fdab80d",
-      "erwartet": "069700f0321116b427d47ee38bc2a3d9a1cacc49673d482b3bbb82e5d1cc62ab",
-      "grid32": "cb9950d335a90d58a0445014100ac1c9040326928965053d079fb6144dede380",
-      "grid48": "7509be1eb23ceedff40edc5b070e4bc20cd72d15b6d6d4acb4d7771bc86dec21"
+      "eingabe": "11f4f58f4f06cd2d414f982b85a017c2a3f62cd23fb8c54d000c16ce1490d2f8",
+      "erwartet": "8e595d6afb36e9c2d2dd77ec71927a039435d74eafe2321c73fff48d321d3602",
+      "grid32": "e8c20dc0ea199b6ee5418205e498dcda3e1bb8fb8b1d0d639af353b1df98740c",
+      "grid48": "81aa151523ae7fa542d58b8c4835a690b686a9aeb9fb7872950419cd370f418c"
     },
     "testkasse-verkauf": {
       "eingabe": "5cd594029a3d7af4a7c502719763d8b5df0063ff7e46da43c9c7dc4fd2638e1f",

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.7.0",
+  "version": "0.7.2",
   "aufrufe": [
     "activateCashregister",
     "cancelReceipt",
@@ -37,6 +37,7 @@
     "listPartnerWebhookDeliveries",
     "listPartnerWebhooks",
     "listRegisterUsersForDevice",
+    "listRegisterSessionsForDevice",
     "pairRegisterDevice",
     "registerPinLogin",
     "registerUserLogin",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "JavaScript-Zwilling von kasseneck_api (Flutter) fuer das Kasseneck-Backend",
   "license": "Apache-2.0",
   "author": "Kreiseck",
@@ -128,7 +128,8 @@
     "prepublishOnly": "npm run build",
     "fixtures:erneuern": "npm run build && node scripts/belege-fixtures.mjs",
     "fixtures:kasse": "npm run build && node scripts/kasse-settings-fixture.mjs",
-    "fixtures:oberflaeche": "npm run build && node scripts/oberflaeche.mjs"
+    "fixtures:oberflaeche": "npm run build && node scripts/oberflaeche.mjs",
+    "fixtures:hobex-hps-codes": "npm run build && node scripts/hobex-hps-codes.mjs"
   },
   "peerDependencies": {
     "react": ">=18.0.0"