@kreiseck/kasseneck-api 1.16.0 → 1.17.1

package/dist/esm/receipt/gutschein-plan.js

@@ -1,5 +1,5 @@
 import { VoucherCode } from '@kreiseck/validator';
-import { isNewFormVoucher, voucherIsValid, voucherServerFields } from '../models/voucher.js';
+import { isNewFormVoucher, istWertVerkauf, voucherIsValid, voucherServerFields, wunschFormGueltig } from '../models/voucher.js';
 /**
  * Stichtag des 0-%-Topfs fuer Mehrzweck-Verkaeufe (Backend
  * `gutschein-core.NULLTOPF_AB`). Solange er in der Zukunft liegt, zaehlt ein
@@ -44,6 +44,23 @@ function satzBp(vat) {
 function position(satzBpWert, cents, kind) {
     return { amount: 1, priceOne: cents / 100, vat: satzBpWert / 100, tip: null, kind };
 }
+/** Reservierte Kennung (`__…__`): gibt es am Server nie als Sorte (gutschein-core.RESERVIERTE_ID). */
+const RESERVIERTE_ID = /^__.*__$/;
+/**
+ * Die Sorte zum Wunsch, wie der Server sie verkaufen wuerde, oder null
+ * (unbekannt): Mehrzweck ohne Satz, Einzweck mit Satz > 0, Betrag frei oder
+ * fest von 1,00 bis 10.000,00 €. Eine unstimmige Sorte verkauft der Server
+ * nicht (`gutschein-beleg.sorteFuerVerkauf` ueber `gutschein-core.pruefeSorte`).
+ */
+function sorteZumWunsch(typen, typeId) {
+    const t = (typen ?? []).find((x) => x.id === typeId);
+    if (t == null)
+        return null;
+    const satzOk = t.kind === 'multi_purpose' ? t.vatRateBp == null : t.kind === 'single_purpose' && Number.isInteger(t.vatRateBp) && t.vatRateBp > 0;
+    const betragOk = t.amount?.mode === 'free'
+        || (t.amount?.mode === 'fixed' && Number.isInteger(t.amount.cents) && t.amount.cents >= 100 && t.amount.cents <= 1_000_000);
+    return satzOk && betragOk ? t : null;
+}
 /** Code in Normalform (tolerant eingelesen, Pruefzeichen stimmt) oder null. */
 function normalerCode(code) {
     if (typeof code !== 'string')
@@ -152,7 +169,23 @@ export function planeGutscheine(kunde, vouchers, art, o) {
     for (const [i, v] of vouchers.entries()) {
         if (istGelesen(v))
             return nein('voucher_invalid', `Gutschein ${i + 1}: Serverfelder an einem Wunsch.`);
-        if (isNewFormVoucher(v) && !voucherIsValid(v))
+        if (!isNewFormVoucher(v))
+            continue;
+        if (istWertVerkauf(v) && v.typeId == null) {
+            // Wie gutschein-beleg.pruefeWuensche: ein Wert-Verkauf ohne Sorte ist voucher_type_required.
+            // Nur eine alte Gutschein-Einstellung MIT Art (Aufrufer bis 1.16) rechnet wie bisher; ein Server ab
+            // Stufe 4b schickt `valueVoucherType` immer null, dort hilft kein Neuladen – die Sorte fehlt.
+            if (o.voucherSettings?.valueVoucherType == null)
+                return nein('voucher_type_required', `Gutschein ${i + 1}: die Gutschein-Sorte fehlt (typeId).`);
+            if (!wunschFormGueltig(v, false))
+                return nein('voucher_invalid', `Gutschein ${i + 1} ist unvollstaendig.`);
+            continue;
+        }
+        // Eine reservierte Kennung weist der Server vor jeder anderen Pruefung als unbekannt ab.
+        if (istWertVerkauf(v) && typeof v.typeId === 'string' && RESERVIERTE_ID.test(v.typeId)) {
+            return nein('voucher_type_not_found', `Gutschein ${i + 1}: diese Gutschein-Sorte gibt es nicht.`);
+        }
+        if (!voucherIsValid(v))
             return nein('voucher_invalid', `Gutschein ${i + 1} ist unvollstaendig.`);
     }
     // Kein Gutschein mit Gutschein bezahlen, sobald einer der beiden die neue Form hat.
@@ -210,6 +243,34 @@ export function planeGutscheine(kunde, vouchers, art, o) {
             gutscheine.push(g);
             continue;
         }
+        if (istWertVerkauf(v) && v.typeId != null) {
+            // Verkauf ueber eine Sorte (gutschein-beleg.plane): unbekannt, andere Art, falscher Fixbetrag. Eine andere Art
+            // heisst: die Kasse hat eine alte Sicht (Sorte umgestellt) – wie ein anderer Fixbetrag voucher_amount_mismatch,
+            // die Kasse laedt die Sorten neu.
+            const sorte = sorteZumWunsch(o.voucherTypes, v.typeId);
+            if (sorte == null)
+                return nein('voucher_type_not_found', `Gutschein ${i + 1}: die Gutschein-Sorte fehlt (voucherTypes).`);
+            if (v.type != null && v.type !== sorte.kind)
+                return nein('voucher_amount_mismatch', `Gutschein ${i + 1}: die Art passt nicht (mehr) zur Gutschein-Sorte.`);
+            if (sorte.amount.mode === 'fixed' && v.amountCents !== sorte.amount.cents) {
+                return nein('voucher_amount_mismatch', `Gutschein ${i + 1}: der Betrag passt nicht zum Fixbetrag der Gutschein-Sorte.`);
+            }
+            const c = v.amountCents;
+            if (sorte.kind === 'multi_purpose') {
+                if (nulltopf) {
+                    zusatz.push(position(0, c, 'voucher_float'));
+                    gutscheine.push({ action: 'sell', type: 'value', value: c / 100, imNullTopf: true });
+                }
+                else {
+                    gutscheine.push({ action: 'sell', type: 'value', value: c / 100 });
+                }
+            }
+            else {
+                // Kleinunternehmer: befreit verkauft, der Satz der Sorte legt nur fest, wofuer der Gutschein gilt.
+                zusatz.push(position(ku ? 0 : sorte.vatRateBp, c, 'voucher'));
+            }
+            continue;
+        }
         if (!ARTEN.includes(String(v.type)))
             return nein('voucher_invalid', `Gutschein ${i + 1}: unbekannte Art.`);
         if (v.action === 'sell') {
@@ -239,6 +300,8 @@ export function planeGutscheine(kunde, vouchers, art, o) {
                 const a = (o.voucherArticles ?? []).find((x) => x.id === v.articleId);
                 if (a == null)
                     return nein('voucher_item_mismatch', `Gutschein ${i + 1}: der Artikel fehlt (voucherArticles).`);
+                if (a.serviceVoucher === false)
+                    return nein('voucher_service_not_allowed', `Gutschein ${i + 1}: der Artikel ist nicht als Leistungsgutschein freigegeben.`);
                 if (!Number.isInteger(a.priceCents) || a.priceCents <= 0 || !Number.isInteger(a.vatRateBp) || a.vatRateBp < 0) {
                     return nein('voucher_invalid', `Gutschein ${i + 1}: Artikel ohne Preis oder Satz.`);
                 }
@@ -253,7 +316,9 @@ export function planeGutscheine(kunde, vouchers, art, o) {
         if ('fehler' in check)
             return check;
         if (v.action === 'payout') {
-            // `gutschein-core.darfAuszahlen`: aktiv, oder abgelaufen bis zum Ende der Rueckzahlbarkeit.
+            // `gutschein-core.darfAuszahlen`: Auszahlung nicht gesperrt, aktiv oder abgelaufen bis zum Ende der Rueckzahlbarkeit.
+            if (check.payout === 'never')
+                return nein('voucher_payout_not_allowed', `Gutschein ${i + 1}: dieser Gutschein wird nie ausgezahlt.`);
             if (!((check.balanceCents ?? 0) > 0))
                 return nein('voucher_used_up', `Gutschein ${i + 1}: kein Saldo.`);
             if (check.status === 'expired') {

package/dist/esm/receipt/index.d.ts

@@ -8,4 +8,4 @@ export { rasterizeLogo } from './bild.js';
 export { type BrandMarkRaster, BRAND_MARK_RASTERS, BRAND_MARK_PATHS } from './marke-daten.js';
 export { brandMarkImage } from './marke.js';
 export { type CodeTableTestSheetInput, type CodeTableTestSheetRow, type CodeTableTestSheet, CODE_TABLE_TEST_SHEET_CHARS, codeTableTestSheet, codeTableTestSheetBytes, codeTableReferenceImage, } from './code-table-test-sheet.js';
-export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, type VoucherDueInfo, type VoucherDueArticle, type VoucherRedeemContext, voucherRedeemMaxCents, VOUCHER_ZERO_RATE_BUCKET_FROM, } from './due.js';
+export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, type VoucherDueInfo, type VoucherDueArticle, type VoucherDueType, type VoucherRedeemContext, voucherRedeemMaxCents, VOUCHER_ZERO_RATE_BUCKET_FROM, } from './due.js';

package/dist/esm/stored/draht.js

@@ -137,12 +137,17 @@ function belegRueckgabeNachAussen(beleg) {
     return raus;
 }
 // ---- Gutschein-Eintraege am Beleg ---------------------------------------------
-/** Zwilling von `BELEG_GUTSCHEIN` (api-vokabular-v3): aussen -> innen. */
+/**
+ * Zwilling von `BELEG_GUTSCHEIN` (api-vokabular-v3): aussen -> innen. Sorte,
+ * Sortenname und Auszahlung friert der Server beim Verkauf ueber eine Sorte
+ * ein (Gutscheine Stufe 4b); die Auszahlung traegt dazu einen Wert aus dem
+ * Katalog `GUTSCHEIN_AUSZAHLUNG` (erlaubt/nie).
+ */
 const BELEG_GUTSCHEIN = {
     voucherType: 'art', voucherId: 'gutscheinId', codeSuffix: 'codeEnde', amountCents: 'betragCents', vatRateBp: 'satzBp',
     article: 'artikel', articleId: 'artikelId', quantity: 'stueck', positions: 'positionen',
     balanceAfterCents: 'saldoNachCents', remainingQuantityAfter: 'stueckOffenNach', taxedWith: 'versteuertMit', exempt: 'befreit',
-    reason: 'grund', zeroRateBucket: 'imNullTopf',
+    reason: 'grund', zeroRateBucket: 'imNullTopf', typeId: 'sorteId', typeName: 'sorteName', payout: 'auszahlung',
 };
 const BELEG_GUTSCHEIN_AUSSEN = Object.fromEntries(Object.entries(BELEG_GUTSCHEIN).map(([aussen, innen]) => [innen, aussen]));
 const GUTSCHEIN_ARTIKEL_AUSSEN = { satzBp: 'vatRateBp', preisCents: 'priceCents' };
@@ -154,6 +159,7 @@ function gutscheinEintragNachAussen(v) {
     if (!istObjekt(v))
         return v;
     const art = KATALOGE.GUTSCHEIN_ART ?? {};
+    const auszahlung = KATALOGE.GUTSCHEIN_AUSZAHLUNG ?? {};
     const typNeu = typeof v.type === 'string' && hat(art, v.type);
     if (!typNeu && !Object.keys(v).some((k) => hat(BELEG_GUTSCHEIN_AUSSEN, k)))
         return v;
@@ -165,6 +171,8 @@ function gutscheinEintragNachAussen(v) {
             raus.voucherType = typeof w === 'string' && hat(art, w) ? art[w] : w;
         else if (k === 'artikel')
             raus.article = istObjekt(w) ? umbenannt(w, GUTSCHEIN_ARTIKEL_AUSSEN) : w;
+        else if (k === 'auszahlung')
+            raus.payout = typeof w === 'string' && hat(auszahlung, w) ? auszahlung[w] : w;
         else
             raus[hat(BELEG_GUTSCHEIN_AUSSEN, k) ? BELEG_GUTSCHEIN_AUSSEN[k] : k] = w;
     }

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 = "d11de425770bc431be9766199e4c9b3e712eb8e0eea84658f771a0f79d98e90e";
+export declare const VOKABULAR_QUELLE = "3088cb472f3fef3ed4ff969bf0d37d051363714096616a9263270c58266bde14";
 /** 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 = "d11de425770bc431be9766199e4c9b3e712eb8e0eea84658f771a0f79d98e90e";
+export const VOKABULAR_QUELLE = "3088cb472f3fef3ed4ff969bf0d37d051363714096616a9263270c58266bde14";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 export const SCHEMAS = {
     "getReceipt": {
@@ -51,9 +51,12 @@ export const SCHEMAS = {
                     "faceValueCents": "nennwertCents",
                     "quantity": "stueck",
                     "articleName": "artikelName",
+                    "typeId": "sorteId",
+                    "typeName": "sorteName",
                     "validity": {
                         "__": "gueltigkeit",
                         "pattern": "muster",
+                        "redeemableYears": "jahre",
                         "redeemableUntil": "einloesbarBis",
                         "refundableUntil": "rueckzahlbarBis",
                         "validUntil": "gueltigBis"
@@ -201,20 +204,72 @@ export const SCHEMAS = {
             "vouchers": {
                 "__": "gutscheine",
                 "sale": "verkauf",
+                "typeSale": "sortenVerkauf",
                 "valueVoucherType": "wertArt",
                 "vatRateBp": "satzBp",
                 "label": {
                     "__": "etikett",
                     "size": "groesse",
+                    "rotation": "drehung",
                     "fields": {
                         "__": "felder",
                         "business": "betrieb",
                         "value": "wert",
                         "validity": "gueltigkeit",
-                        "checkPage": "pruefseite"
+                        "checkPage": "pruefseite",
+                        "designation": "bezeichnung"
                     },
                     "freeText": "freitext"
-                }
+                },
+                "labelDefault": {
+                    "__": "etikettStandard",
+                    "size": "groesse",
+                    "rotation": "drehung",
+                    "fields": {
+                        "__": "felder",
+                        "business": "betrieb",
+                        "value": "wert",
+                        "validity": "gueltigkeit",
+                        "checkPage": "pruefseite",
+                        "designation": "bezeichnung"
+                    },
+                    "freeText": "freitext"
+                },
+                "types": [
+                    {
+                        "__": "sorten",
+                        "kind": "art",
+                        "vatRateBp": "satzBp",
+                        "amount": {
+                            "__": "betrag",
+                            "mode": "modus"
+                        },
+                        "validity": {
+                            "__": "gueltigkeit",
+                            "pattern": "muster",
+                            "years": "jahre"
+                        },
+                        "payout": "auszahlung",
+                        "label": {
+                            "__": "etikett",
+                            "size": "groesse",
+                            "rotation": "drehung",
+                            "fields": {
+                                "__": "felder",
+                                "business": "betrieb",
+                                "value": "wert",
+                                "validity": "gueltigkeit",
+                                "checkPage": "pruefseite",
+                                "designation": "bezeichnung"
+                            },
+                            "freeText": "freitext"
+                        },
+                        "order": "reihenfolge",
+                        "active": "aktiv",
+                        "soldCount": "verkauft"
+                    }
+                ],
+                "serviceArticles": "leistungsArtikel"
             }
         },
         "werte": {
@@ -269,6 +324,18 @@ export const SCHEMAS = {
             "vouchers.valueVoucherType": {
                 "mehrzweck": "multi_purpose",
                 "einzweck": "single_purpose"
+            },
+            "vouchers.types[].kind": {
+                "$catalog": "GUTSCHEIN_ART"
+            },
+            "vouchers.types[].amount.mode": {
+                "$catalog": "GUTSCHEIN_BETRAG_MODUS"
+            },
+            "vouchers.types[].validity.pattern": {
+                "$catalog": "GUTSCHEIN_SORTE_MUSTER"
+            },
+            "vouchers.types[].payout": {
+                "$catalog": "GUTSCHEIN_AUSZAHLUNG"
             }
         }
     },
@@ -279,6 +346,7 @@ export const SCHEMAS = {
                     "__": "articles",
                     "quantityRule": "mengenregel",
                     "askQuantity": "mengeFragen",
+                    "serviceVoucher": "gutscheinLeistung",
                     "maxQuantity": "maxMenge",
                     "tile": {
                         "__": "kasse",
@@ -321,6 +389,7 @@ export const ARTIKEL_FELDER = [
     "askQuantity",
     "maxQuantity",
     "revenueGroupId",
+    "serviceVoucher",
     "active",
     "groupId",
     "tile",
@@ -481,11 +550,23 @@ export const KATALOGE = {
         "leistung": "service",
         "aktion": "promotion"
     },
+    "GUTSCHEIN_AUSZAHLUNG": {
+        "erlaubt": "allowed",
+        "nie": "never"
+    },
+    "GUTSCHEIN_BETRAG_MODUS": {
+        "frei": "free",
+        "fix": "fixed"
+    },
     "GUTSCHEIN_MUSTER": {
         "unbefristet": "unlimited",
         "1+3": "1+3",
         "frei": "custom"
     },
+    "GUTSCHEIN_SORTE_MUSTER": {
+        "unbefristet": "unlimited",
+        "jahre": "years"
+    },
     "KASSE_BETRIEB_WERTE.cardProvider": {
         "keiner": "none",
         "extern": "external",

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.16.0";
+export declare const PACKAGE_VERSION = "1.17.1";

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.16.0';
+export const PACKAGE_VERSION = '1.17.1';

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.16.0",
+  "version": "1.17.1",
   "measuredOn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

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.16.0",
+  "package": "1.17.1",
   "endpoints": {
     "createCustomer": {
       "request": {

package/fixtures/invoice-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.16.0",
+  "version": "1.17.1",
   "languages": [
     "de",
     "en"

package/fixtures/pos-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.16.0",
+  "version": "1.17.1",
   "messages": {
     "network.no_connection": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."
@@ -405,6 +405,24 @@
     "voucher_error.sale_off": {
       "text": "Gutscheine verkaufen geht hier noch nicht."
     },
+    "voucher_error.type_required": {
+      "text": "Bitte eine Gutschein-Sorte wählen."
+    },
+    "voucher_error.type_not_found": {
+      "text": "Diese Gutschein-Sorte gibt es nicht mehr. Die Kasse lädt die Sorten neu."
+    },
+    "voucher_error.amount_mismatch": {
+      "text": "Die Gutschein-Sorte hat sich geändert. Die Kasse lädt die Sorten neu."
+    },
+    "voucher_error.service_not_allowed": {
+      "text": "Dieser Artikel ist nicht als Leistungsgutschein freigegeben."
+    },
+    "voucher_error.payout_not_allowed": {
+      "text": "Dieser Gutschein kann nicht ausgezahlt werden."
+    },
+    "voucher.type_changed": {
+      "text": "Diese Gutschein-Sorte hat sich geändert. Bitte die Zeile entfernen und die Kachel neu antippen."
+    },
     "voucher.reentry_needed": {
       "text": "Die Karte ist belastet, der Beleg fehlt noch: zu jedem Gutschein den Code erneut eingeben, dann den Beleg abschließen."
     },
@@ -1141,7 +1159,12 @@
     "voucher_already_used": "voucher_error.already_used",
     "voucher_partial_cancel": "voucher_error.partial_cancel",
     "voucher_settings_missing": "voucher_error.settings_missing",
-    "too_many_voucher_checks": "voucher_error.too_many_checks"
+    "too_many_voucher_checks": "voucher_error.too_many_checks",
+    "voucher_type_required": "voucher_error.type_required",
+    "voucher_type_not_found": "voucher_error.type_not_found",
+    "voucher_amount_mismatch": "voucher_error.amount_mismatch",
+    "voucher_service_not_allowed": "voucher_error.service_not_allowed",
+    "voucher_payout_not_allowed": "voucher_error.payout_not_allowed"
   },
   "labels": {
     "common.cancel": {
@@ -2061,6 +2084,24 @@
     "voucher.add": {
       "text": "Hinzufügen"
     },
+    "voucher.tab": {
+      "text": "Gutscheine"
+    },
+    "voucher.enter_amount": {
+      "text": "Betrag eingeben"
+    },
+    "voucher.service_tile": {
+      "text": "Leistungsgutschein"
+    },
+    "voucher.kind_multi_short": {
+      "text": "Mehrzweck"
+    },
+    "voucher.kind_single_short": {
+      "text": "Einzweck {rate} %",
+      "placeholders": [
+        "rate"
+      ]
+    },
     "shift.all_payments": {
       "text": "Alle Zahlungen dieser Schicht (bar + unbar)"
     },