@kreiseck/kasseneck-api 1.1.1 → 1.2.0

package/dist/esm/stored/draht.d.ts

@@ -10,10 +10,12 @@ export declare function regel(eintrag: SchemaEintrag): {
 };
 /** Innere Namen einer Schema-Ebene (was der Server innen an dieser Stelle kennt). */
 export declare function innereNamen(schema: SchemaObjekt): Map<string, string>;
+/** Rueckgabe-Wahl innen -> aussen (Katalog RUECKGABE; stored.test.ts vergleicht mit dem Vertrag). */
+export declare const _RUECKGABE_NACH_AUSSEN: Readonly<Record<string, string>>;
 /**
  * Ein Belegdokument, wie Handler und Rand es vor der Uebersetzung sehen:
- * ohne Storno-Marke (storno-core.ohneInterneStornoFelder, Rand
- * ohneStornoMarke). Alles andere bleibt woertlich, auch `pruefangaben` im
+ * ohne Storno-Marke und Lager-Standort (storno-core.ohneInterneBelegFelder,
+ * Rand ohneStornoMarke). Alles andere bleibt woertlich, auch `pruefangaben` im
  * Beleg selbst (der Server reicht sie so durch). Wirft, wenn es kein
  * Belegdokument ist.
  */

package/dist/esm/stored/draht.js

@@ -81,7 +81,7 @@ const aeussereWerte = (name) => new Set(Object.values(KATALOGE[name] ?? {}));
 /**
  * Interne Marke der Storno-Reservierung: `stornoMarke` am Storno-Beleg,
  * `marke` im Bezug und in `cancellations[]`. Handler
- * (storno-core.ohneInterneStornoFelder) und Rand (ohneStornoMarke) nehmen sie
+ * (storno-core.ohneInterneBelegFelder) und Rand (ohneStornoMarke) nehmen sie
  * heraus; der Vertrag nennt die Namen nicht (nur `$function: belegJeKanal`).
  */
 const STORNO_MARKE = 'stornoMarke';
@@ -92,6 +92,44 @@ const ohneMarke = (o) => {
     const { [MARKE]: _m, ...rest } = o;
     return rest;
 };
+/**
+ * Interne Dokumentfelder eines Belegs, die keine Antwort traegt (Zwilling von
+ * storno-core.INTERNE_BELEG_FELDER): der Lager-Standort der Kasse, den
+ * createReceipt fuer die Lagerbuchung an den Beleg kopiert.
+ */
+const INTERNE_BELEG_FELDER = ['lagerStandortId'];
+/** Rueckgabe-Wahl innen -> aussen (Katalog RUECKGABE; stored.test.ts vergleicht mit dem Vertrag). */
+export const _RUECKGABE_NACH_AUSSEN = Object.freeze({ lager: 'restock', defekt: 'defective', entsorgt: 'disposed' });
+/**
+ * Zwilling von `rueckgabeUmbenennen` (Rand): `rueckgabe` heisst aussen
+ * `returnDisposition`, an Ort und Stelle; ein Wert ausserhalb des Katalogs
+ * faellt weg (der Server schreibt dafuer eine Warnzeile).
+ */
+function rueckgabeUmbenennen(o) {
+    if (!istObjekt(o) || !hat(o, 'rueckgabe'))
+        return o;
+    const raus = {};
+    for (const [k, w] of Object.entries(o)) {
+        if (k !== 'rueckgabe') {
+            raus[k] = w;
+            continue;
+        }
+        if (typeof w === 'string' && hat(_RUECKGABE_NACH_AUSSEN, w))
+            raus.returnDisposition = _RUECKGABE_NACH_AUSSEN[w];
+    }
+    return raus;
+}
+const zeilenMitRueckgabe = (items) => (Array.isArray(items) ? items.map(rueckgabeUmbenennen) : items);
+/** Zwilling von `belegRueckgabeNachAussen`: Storno-Zeilen und Eintraege in `cancellations[]`. */
+function belegRueckgabeNachAussen(beleg) {
+    const raus = { ...beleg };
+    if (Array.isArray(beleg.items))
+        raus.items = zeilenMitRueckgabe(beleg.items);
+    if (Array.isArray(beleg.cancellations)) {
+        raus.cancellations = beleg.cancellations.map((c) => (istObjekt(c) && Array.isArray(c.items) ? { ...c, items: zeilenMitRueckgabe(c.items) } : c));
+    }
+    return raus;
+}
 /**
  * Zwilling von `beleg-pruefangaben.alsIso`: leer (auch 0, '') -> null;
  * Firestore-Zeitstempel, Zahl oder Zeichenkette -> ISO-Zeitpunkt in UTC;
@@ -109,8 +147,8 @@ function alsIso(ts) {
 }
 /**
  * Ein Belegdokument, wie Handler und Rand es vor der Uebersetzung sehen:
- * ohne Storno-Marke (storno-core.ohneInterneStornoFelder, Rand
- * ohneStornoMarke). Alles andere bleibt woertlich, auch `pruefangaben` im
+ * ohne Storno-Marke und Lager-Standort (storno-core.ohneInterneBelegFelder,
+ * Rand ohneStornoMarke). Alles andere bleibt woertlich, auch `pruefangaben` im
  * Beleg selbst (der Server reicht sie so durch). Wirft, wenn es kein
  * Belegdokument ist.
  */
@@ -119,6 +157,8 @@ export function _storedReceiptInner(doc, functionName) {
         throw new KasseneckValidationError(functionName, 'Kein Belegdokument (receiptId fehlt)', 'response');
     }
     const { [STORNO_MARKE]: _s, ...beleg } = doc;
+    for (const feld of INTERNE_BELEG_FELDER)
+        delete beleg[feld];
     if (hat(beleg, 'cancellationOf'))
         beleg.cancellationOf = ohneMarke(beleg.cancellationOf);
     if (Array.isArray(beleg.cancellations))
@@ -140,7 +180,8 @@ export function pruefangabenDerHuelle(p) {
  */
 export function _receiptEnvelopeToWire(huelle) {
     const schema = SCHEMAS.getReceipt;
-    return werteNachAussen(schluesselNachAussen(huelle, schema.data), schema.werte);
+    const draht = werteNachAussen(schluesselNachAussen(huelle, schema.data), schema.werte);
+    return istObjekt(draht.receipt) ? { ...draht, receipt: belegRueckgabeNachAussen(draht.receipt) } : draht;
 }
 /**
  * Ein Belegdokument (`users/{uid}/cashregisters/{id}/receipts/{id}`) in der

package/dist/esm/stored/vokabular.d.ts

@@ -1,5 +1,5 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "29994ca53adc96e7cb49b9e3688b102a69c126544ef092fc6579a2e1fcd0d555";
+export declare const VOKABULAR_QUELLE = "b1049e2f65e9261cf8f729481d9ce1e5afda2cf620333f38ae6bf1afb36c8712";
 /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
 export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
 export interface SchemaObjekt {

package/dist/esm/stored/vokabular.js

@@ -1,7 +1,7 @@
 // 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";
+export const VOKABULAR_QUELLE = "b1049e2f65e9261cf8f729481d9ce1e5afda2cf620333f38ae6bf1afb36c8712";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 export const SCHEMAS = {
     "getReceipt": {
@@ -219,7 +219,8 @@ export const SCHEMAS = {
                         "__": "kasse",
                         "visible": "sichtbar",
                         "sort": "sort"
-                    }
+                    },
+                    "stockLocationIds": "standorte"
                 }
             ]
         },
@@ -256,7 +257,8 @@ export const ARTIKEL_FELDER = [
     "revenueGroupId",
     "active",
     "groupId",
-    "tile"
+    "tile",
+    "stockLocationIds"
 ];
 /** Wertkataloge innen (deutsch) -> aussen (englisch). */
 export const KATALOGE = {

package/dist/esm/version.d.ts

@@ -4,4 +4,4 @@
  * 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.1.1";
+export declare const PACKAGE_VERSION = "1.2.0";

package/dist/esm/version.js

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export const PACKAGE_VERSION = '1.1.1';
+export const PACKAGE_VERSION = '1.2.0';

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.1",
+  "version": "1.2.0",
   "measuredOn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/invoice-api-examples/cancel-error-return-disposition.json

@@ -0,0 +1,17 @@
+{
+  "endpoint": "cancelInvoice",
+  "description": "Unbekannte Rueckgabe-Wahl beim Vollstorno",
+  "request": {
+    "idempotencyKey": "ex-16",
+    "invoiceId": "invoice_example",
+    "reason": "return",
+    "returnDisposition": "lost"
+  },
+  "expected": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "returnDisposition"
+    ]
+  }
+}

package/fixtures/invoice-api-examples/credit-error-return-disposition.json

@@ -0,0 +1,26 @@
+{
+  "endpoint": "createCreditNote",
+  "description": "Unbekannte Rueckgabe-Wahl an der Position",
+  "request": {
+    "idempotencyKey": "ex-15",
+    "invoiceId": "invoice_example",
+    "reason": "return",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 1,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "articleId": "rye-bread",
+        "returnDisposition": "lost"
+      }
+    ]
+  },
+  "expected": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].returnDisposition"
+    ]
+  }
+}

package/fixtures/invoice-api-examples/credit-return-disposition.json

@@ -0,0 +1,23 @@
+{
+  "endpoint": "createCreditNote",
+  "description": "Rueckgabe: Vorgabe zurueck ins Lager, eine Position defekt",
+  "request": {
+    "idempotencyKey": "ex-14",
+    "invoiceId": "invoice_example",
+    "reason": "return",
+    "returnDisposition": "restock",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 1,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "articleId": "rye-bread",
+        "returnDisposition": "defective"
+      }
+    ]
+  },
+  "expected": {
+    "ok": true
+  }
+}

package/fixtures/invoice-api-examples/issue-error-return-disposition.json

@@ -0,0 +1,25 @@
+{
+  "endpoint": "issueInvoice",
+  "description": "Die Rueckgabe-Wahl gehoert an die Gutschrift, nicht an die Rechnung",
+  "request": {
+    "idempotencyKey": "ex-17",
+    "priceMode": "gross",
+    "serviceStart": "2026-10-01",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 1,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "returnDisposition": "restock"
+      }
+    ]
+  },
+  "expected": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].returnDisposition"
+    ]
+  }
+}

package/fixtures/invoice-api-examples/issue-error-stock-id.json

@@ -0,0 +1,27 @@
+{
+  "endpoint": "issueInvoice",
+  "description": "Lager-Kennungen ohne Schraegstrich und nicht nur Punkte",
+  "request": {
+    "idempotencyKey": "ex-18",
+    "priceMode": "gross",
+    "serviceStart": "2026-10-01",
+    "stockLocationId": "..",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 1,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "articleId": "a/b"
+      }
+    ]
+  },
+  "expected": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "stockLocationId",
+      "items[0].articleId"
+    ]
+  }
+}

package/fixtures/invoice-api-examples/issue-stock.json

@@ -0,0 +1,22 @@
+{
+  "endpoint": "issueInvoice",
+  "description": "Bestandsgefuehrter Artikel, abgebucht vom Lieferwagen",
+  "request": {
+    "idempotencyKey": "ex-13",
+    "priceMode": "gross",
+    "serviceStart": "2026-10-01",
+    "stockLocationId": "van-1",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 2,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "articleId": "rye-bread"
+      }
+    ]
+  },
+  "expected": {
+    "ok": true
+  }
+}

package/fixtures/invoice-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 2,
-  "package": "1.1.1",
+  "package": "1.2.0",
   "endpoints": {
     "createCustomer": {
       "request": {
@@ -461,6 +461,11 @@
                   "minimum": 0,
                   "maximum": 100,
                   "x-decimals": 2
+                },
+                "articleId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128
                 }
               },
               "required": [
@@ -505,6 +510,11 @@
             "minLength": 1,
             "maxLength": 128
           },
+          "stockLocationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
           "payment": {
             "type": "object",
             "properties": {
@@ -579,6 +589,13 @@
           "note": {
             "type": "string",
             "maxLength": 2000
+          },
+          "returnDisposition": {
+            "enum": [
+              "restock",
+              "defective",
+              "disposed"
+            ]
           }
         },
         "required": [
@@ -720,6 +737,18 @@
                   "minimum": 0,
                   "maximum": 100,
                   "x-decimals": 2
+                },
+                "articleId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128
+                },
+                "returnDisposition": {
+                  "enum": [
+                    "restock",
+                    "defective",
+                    "disposed"
+                  ]
                 }
               },
               "required": [
@@ -741,6 +770,13 @@
               ],
               "additionalProperties": false
             }
+          },
+          "returnDisposition": {
+            "enum": [
+              "restock",
+              "defective",
+              "disposed"
+            ]
           }
         },
         "required": [

package/fixtures/invoice-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.1",
+  "version": "1.2.0",
   "languages": [
     "de",
     "en"

package/fixtures/pos-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.1",
+  "version": "1.2.0",
   "messages": {
     "network.no_connection": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.1",
+  "version": "1.2.0",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"
@@ -70,6 +70,8 @@
       "listMyCashregisters",
       "listMyPrinters",
       "listMyReceipts",
+      "listMyStock",
+      "listMyStockLocations",
       "listMyTipRecipients",
       "listRegisterUsersForDevice",
       "listRegisterSessionsForDevice",
@@ -78,6 +80,7 @@
       "registerUserLogin",
       "renewRegisterSession",
       "sendReceiptEmail",
+      "setMyCashregisterStockLocation",
       "setMyKasseLogo",
       "setMyKasseSettings",
       "setMyRegisterDeviceSettings",
@@ -123,6 +126,8 @@
       "listCustomerCashregisters",
       "getCustomerCredentials",
       "reportCustomerContract",
+      "getPartnerBilling",
+      "getPartnerBillingMonth",
       "createCustomer",
       "getCustomer",
       "updateCustomer",
@@ -136,7 +141,14 @@
       "getInvoiceXml",
       "getInvoiceSetupStatus",
       "listBrands",
-      "recordInvoicePayment"
+      "recordInvoicePayment",
+      "createInvoiceItem",
+      "updateInvoiceItem",
+      "withdrawInvoiceItem",
+      "getInvoiceItem",
+      "listInvoiceItems",
+      "setCustomerMandate",
+      "revokeCustomerMandate"
     ],
     "pos": [
       "pairRegisterDevice",
@@ -163,7 +175,10 @@
       "listMyPrinters",
       "createPrintJob",
       "getPrintJob",
-      "listMyTipRecipients"
+      "listMyTipRecipients",
+      "listMyStockLocations",
+      "listMyStock",
+      "setMyCashregisterStockLocation"
     ]
   },
   "enums": {
@@ -334,11 +349,19 @@
     "receiptsScope",
     "drawer",
     "discount",
-    "tipAssign"
+    "tipAssign",
+    "stockView",
+    "stockCosts",
+    "stockMove",
+    "stockLoss",
+    "stocktakeCount",
+    "stocktakeClose",
+    "stockLocation"
   ],
   "registerErrorCodes": [
     "account_not_found",
     "admin_required",
+    "api_not_approved",
     "cashregister_in_use",
     "cashregister_not_assigned",
     "cashregister_not_found",
@@ -412,6 +435,7 @@
     "posErrorCodes": [
       "account_not_found",
       "admin_required",
+      "api_not_approved",
       "cashregister_not_assigned",
       "cashregister_not_found",
       "cashregister_token_invalid",
@@ -420,6 +444,8 @@
       "dialect_mismatch",
       "internal_translation_error",
       "live_not_enabled",
+      "location_inactive",
+      "location_not_found",
       "logo_invalid",
       "logo_invalid_type",
       "logo_too_large",
@@ -435,6 +461,7 @@
       "register_user_not_allowed",
       "register_user_not_found",
       "response_translation_failed",
+      "server_error",
       "session_expired",
       "session_other_cashregister",
       "unauthorized",
@@ -457,6 +484,17 @@
     "quantityRules": [
       "piece",
       "decimal"
+    ],
+    "returnDispositions": [
+      "restock",
+      "defective",
+      "disposed"
+    ],
+    "stockLocationTypes": [
+      "warehouse",
+      "store",
+      "vehicle",
+      "other"
     ]
   },
   "partner": {
@@ -761,6 +799,7 @@
     "invoiceRequestErrorCodes": [
       "account_not_found",
       "admin_required",
+      "api_not_approved",
       "cashregister_not_assigned",
       "cashregister_not_found",
       "cashregister_token_invalid",
@@ -851,6 +890,11 @@
       "net",
       "gross"
     ],
+    "returnDispositions": [
+      "restock",
+      "defective",
+      "disposed"
+    ],
     "taxSchemes": [
       "normal",
       "smallBusiness",

package/fixtures/v3/antworten/belege.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": "61892b91e6a8a0f273dcfdeb63809d92d98fb837a3c0baa782f03b29dd3b8b7a",
-    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
+    "inputsSha256": "62e0d9891baa5049aa7634f11fcfd9a44d80b2cb8da79da4fee13140ccd96c2a",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/antworten/belegmail.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": "265bcf3e14cdea33ec3c4df399eb487d40c0d7793ee23d2ee12bcf664bcad550",
-    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
+    "inputsSha256": "62e0d9891baa5049aa7634f11fcfd9a44d80b2cb8da79da4fee13140ccd96c2a",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/antworten/kasse-belege.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": "aad7147db385e4a6d88ba5fb59d24c04e7e1f01195778aa70ccdc68fb90adcd7",
-    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
+    "inputsSha256": "62e0d9891baa5049aa7634f11fcfd9a44d80b2cb8da79da4fee13140ccd96c2a",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",