@kreiseck/kasseneck-api 1.2.1 → 1.3.0

package/CHANGELOG.md

@@ -4,6 +4,45 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 1.3.0
+
+Article codes on `PosArticle` and the stock words of the register in the
+shared catalogue. Reason: the backend already sends `number`, `ean`,
+`internalCode` and `stockTracked` per article in `listMyArticles` under
+`/api/v3`, but the package dropped them, so the browser register could not
+search by scanned code nor tell a stock-tracked article without guessing. The
+stock labels lived locally in the browser register; the browser register and
+the register app have to use the same words.
+
+Additive, no breaking change; requests send the same bytes as in 1.2.2.
+
+- **`PosArticle`** gains `number`, `ean`, `internalCode` (`string | null`) and
+  `stockTracked` (`boolean | null`). Optional on the type like
+  `stockLocationIds`, so existing object literals keep compiling; the reader
+  `fromPosArticlePayload` always sets them. Texts pass through unchanged
+  (leading zeros, case, spaces); an empty or whitespace-only text and a
+  value of the wrong type become `null`. `stockTracked: null` means the
+  response carries no statement (older backends), not `false`. `./stored`
+  (`fromStoredArticle`) returns the same fields.
+- **Labels** (`LABELS`, `labelText`): `stock.all_articles`, `stock.location`,
+  `stock.default_location`, `stock.resolved`, `stock.where_to`,
+  `stock.available`, `stock.return_restock`, `stock.return_defective`,
+  `stock.return_disposed`. New `RETURN_DISPOSITION_LABELS` (`./pos`) maps each
+  `ReturnDisposition` to its label key.
+- **Message** (`MESSAGES`, `messageText`): `cancellation.input_rejected`, for
+  a cancellation whose reason, note or lines the server rejected.
+- **`fixtures/pos-texts.json`**: the new keys and a new top-level key
+  `returnDispositionLabels` after `labels`. `surface.json` and the other
+  contract files change only in their version.
+
+## 1.2.2
+
+The receipt fixtures, goldens and tests carried the serial number of a real
+signature card (signature card line, machine-readable code). It is replaced by
+the made-up `5A1C3E07` (same length); the dependent ESC/POS hex goldens are
+regenerated. Reason: fixtures only carry made-up identifiers; backend and web
+use the same replacement. No code change. Same change as 0.32.2 on the legacy line.
+
 ## 1.2.1
 
 En dash instead of em dash in the visible texts of the invoice catalog

package/README.md

@@ -823,7 +823,9 @@ sending a German value.
 
 The rest of `…/pos`: `listMyArticles` and `listMyArticleGroups` for the tiles
 (`visible`, `quantityRule: 'piece' | 'decimal'`, `askQuantity`,
-`maxQuantity`), `listMyPrinters`, `createPrintJob` and `getPrintJob` for
+`maxQuantity`; for scanner search `number`, `ean` and `internalCode`, passed
+through unchanged and `null` when empty; `stockTracked`, `null` when the
+response says nothing), `listMyPrinters`, `createPrintJob` and `getPrintJob` for
 network printers (poll until `isPrintJobFinished(job)`; an unknown state is
 `'unknown'` and ends the polling), `listMyTipRecipients`, `setMyPosLogo`, and
 the register's text catalogue (`MESSAGES`, `LABELS`, `messageText`,
@@ -855,7 +857,10 @@ names none), registers `stockLocationId` (absent for the default location;
 only the result of `setMyCashregisterStockLocation` uses `null` for it), and
 `listRegisterUsersForDevice` returns `cashregister.stockLocationId`;
 errors such as `location_not_found` and `location_inactive` are in
-`POS_ERROR_CODES`.
+`POS_ERROR_CODES`. The register's stock words are in the catalogue as
+`stock.*` labels (`labelText('stock.where_to')`), and
+`RETURN_DISPOSITION_LABELS` gives the label of each return choice
+(`labelText(RETURN_DISPOSITION_LABELS.restock)` is "Zurück ins Lager").
 
 `stockViewOf(perms)` (also exported from the package root) tells whether a
 register user may see locations and quantities: a missing `stockView` counts

package/dist/cjs/client/status.d.ts

@@ -34,7 +34,7 @@ export type SignatureStatus = CashboxStatus | 'NOT_REGISTERED';
 export declare function getCashboxStatus(transport: InternerTransport): Promise<CashboxStatus>;
 /**
  * Status der Signatureinheit mit der Zertifikatsseriennummer [certificateSerialHex]
- * (hexadezimal, z. B. `6F0404F0`).
+ * (hexadezimal, z. B. `5A1C3E07`).
  *
  * **Der Returncode wird vor dem Status gelesen** (wie im Dart-Vorbild): `B33`
  * heisst "nicht registriert" und schlaegt jedes Statusfeld, das daneben stehen

package/dist/cjs/client/status.js

@@ -20,7 +20,7 @@ async function getCashboxStatus(transport) {
 }
 /**
  * Status der Signatureinheit mit der Zertifikatsseriennummer [certificateSerialHex]
- * (hexadezimal, z. B. `6F0404F0`).
+ * (hexadezimal, z. B. `5A1C3E07`).
  *
  * **Der Returncode wird vor dem Status gelesen** (wie im Dart-Vorbild): `B33`
  * heisst "nicht registriert" und schlaegt jedes Statusfeld, das daneben stehen

package/dist/cjs/pos/artikel.d.ts

@@ -72,6 +72,22 @@ export interface PosArticle {
      * (`fromPosArticlePayload`) setzt das Feld immer (`null` oder Liste).
      */
     stockLocationIds?: string[] | null;
+    /**
+     * Artikelnummer des Betriebs; null = keine. Diese und die drei folgenden
+     * Felder (Scanner-Suche, Lager) sind optional wie `stockLocationIds`, der
+     * Leser setzt sie immer. Texte kommen unveraendert durch (fuehrende Nullen,
+     * Schreibweise); nur ein leerer Text (auch reiner Leerraum) wird `null`.
+     */
+    number?: string | null;
+    /** EAN/GTIN, wie gespeichert; null = keine. */
+    ean?: string | null;
+    /** Interner Code des Betriebs (eigener Barcode/QR); null = keiner. */
+    internalCode?: string | null;
+    /**
+     * Bestandsgefuehrt (Lager-Modul). `null`, wenn die Antwort keine Angabe
+     * traegt (aeltere Backends) -- dann nicht aus anderen Feldern ableiten.
+     */
+    stockTracked?: boolean | null;
 }
 /** Deckelt eine gewuenschte Menge an der Hoechstmenge des Artikels (null = keine Grenze). */
 export declare function allowedQuantity(a: Pick<PosArticle, 'maxQuantity'>, wanted: number): number;
@@ -93,6 +109,10 @@ export interface PosArticlePayload {
     askQuantity?: boolean | null;
     maxQuantity?: number | null;
     stockLocationIds?: string[] | null;
+    number?: string | null;
+    ean?: string | null;
+    internalCode?: string | null;
+    stockTracked?: boolean | null;
 }
 export declare function fromPosArticlePayload(p: PosArticlePayload): PosArticle;
 /**

package/dist/cjs/pos/artikel.js

@@ -56,6 +56,10 @@ function quantityDefaults(a) {
 function allowedQuantity(a, wanted) {
     return a.maxQuantity != null && a.maxQuantity > 0 ? Math.min(wanted, a.maxQuantity) : wanted;
 }
+/** Ein Text mit Inhalt, unveraendert; leer, nur Leerraum oder kein Text -> null. */
+function textOderNull(wert) {
+    return typeof wert === 'string' && wert.trim() !== '' ? wert : null;
+}
 function fromPosArticlePayload(p) {
     return {
         id: p.id ?? '',
@@ -74,6 +78,10 @@ function fromPosArticlePayload(p) {
         stockLocationIds: Array.isArray(p.stockLocationIds)
             ? p.stockLocationIds.filter((s) => typeof s === 'string' && s !== '')
             : null,
+        number: textOderNull(p.number),
+        ean: textOderNull(p.ean),
+        internalCode: textOderNull(p.internalCode),
+        stockTracked: typeof p.stockTracked === 'boolean' ? p.stockTracked : null,
     };
 }
 /**

package/dist/cjs/pos/index.d.ts

@@ -15,4 +15,4 @@ export { type NetworkPrinter, type PrintJob, type PrintJobStatus, PRINT_JOB_STAT
 export { listMyTipRecipients } from './trinkgeld.js';
 export { STOCK_LOCATION_TYPES, type StockLocationType, type StockLocation, type StockLocationAddress, type StockLevel, type StockValue, type StockList, type ListMyStockOptions, type SetMyCashregisterStockLocationOptions, type CashregisterStockLocation, listMyStockLocations, listMyStock, setMyCashregisterStockLocation, } from './lager.js';
 export { RETURN_DISPOSITIONS, isReturnDisposition, type ReturnDisposition } from '../models/cancellation.js';
-export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';
+export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, RETURN_DISPOSITION_LABELS, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';

package/dist/cjs/pos/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPosSettings = exports.allowedQuantity = exports.quantityDefaults = exports.quantityRuleForUnit = exports.QUANTITY_RULES = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = exports.posShortcutConflict = exports.POS_SHORTCUT_SHARED_PAIRS = exports.posSettingsChanges = exports.unknownPosSettingValues = exports.sanitizePosSettings = exports.mergePosSettings = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = void 0;
-exports.labelText = exports.LABELS = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = void 0;
+exports.RETURN_DISPOSITION_LABELS = exports.labelText = exports.LABELS = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = void 0;
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
  * Rabattverteilung, Drucker, Trinkgeld-Empfaenger, Lager (Standorte, Bestand,
@@ -116,3 +116,4 @@ Object.defineProperty(exports, "CANCELLATION_PAYMENT_ERROR_MESSAGES", { enumerab
 Object.defineProperty(exports, "cancellationPaymentErrorMessage", { enumerable: true, get: function () { return texte_js_1.cancellationPaymentErrorMessage; } });
 Object.defineProperty(exports, "LABELS", { enumerable: true, get: function () { return texte_js_1.LABELS; } });
 Object.defineProperty(exports, "labelText", { enumerable: true, get: function () { return texte_js_1.labelText; } });
+Object.defineProperty(exports, "RETURN_DISPOSITION_LABELS", { enumerable: true, get: function () { return texte_js_1.RETURN_DISPOSITION_LABELS; } });

package/dist/cjs/pos/texte.d.ts

@@ -300,6 +300,9 @@ declare const MELDUNGEN_ROH: {
     readonly 'cancellation.cards_not_checked': {
         readonly text: "Noch ist nicht jede Karte abgehakt – bitte jede am Terminal gutschreiben. Ist das schon geschehen, zum Schließen noch einmal drücken.";
     };
+    readonly 'cancellation.input_rejected': {
+        readonly text: "Die Eingabe wurde abgelehnt – bitte das Storno neu beginnen.";
+    };
     readonly 'split.setting_hint': {
         readonly text: "Ein Tisch zahlt in Teilen: jede Zahlung bar oder mit Karte, mit eigenem Trinkgeld – am Ende ein Beleg für alles.";
     };
@@ -1015,9 +1018,47 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'codetable.other_row': {
         readonly text: "Andere Zeile";
     };
+    readonly 'stock.all_articles': {
+        readonly text: "Alle Artikel";
+    };
+    readonly 'stock.location': {
+        readonly text: "Lager-Standort";
+    };
+    readonly 'stock.default_location': {
+        readonly text: "Standard-Standort";
+    };
+    readonly 'stock.resolved': {
+        readonly text: "aufgelöst";
+    };
+    readonly 'stock.where_to': {
+        readonly text: "Wohin mit der Ware?";
+    };
+    readonly 'stock.available': {
+        readonly text: "verfügbar";
+    };
+    readonly 'stock.return_restock': {
+        readonly text: "Zurück ins Lager";
+    };
+    readonly 'stock.return_defective': {
+        readonly text: "Defekt";
+    };
+    readonly 'stock.return_disposed': {
+        readonly text: "Entsorgt";
+    };
 };
 export type LabelKey = keyof typeof BESCHRIFTUNGEN_ROH;
 export declare const LABELS: Record<LabelKey, TextEntry>;
+/**
+ * Rueckgabe beim Storno (`returnDisposition`): welche Beschriftung jede Wahl
+ * traegt. Ein Objekt wie CANCELLATION_PAYMENT_ERROR_MESSAGES, keine Liste in
+ * GROSSSCHRIFT (der Oberflaechen-Vertrag liest Listen als Enums ein); die
+ * App liest die Zuordnung aus `fixtures/pos-texts.json`.
+ */
+export declare const RETURN_DISPOSITION_LABELS: {
+    readonly restock: "stock.return_restock";
+    readonly defective: "stock.return_defective";
+    readonly disposed: "stock.return_disposed";
+};
 /** Die Beschriftung zum Schluessel, Platzhalter ersetzt; fehlt ein Wert, wirft es wie `messageText`. */
 export declare function labelText(key: LabelKey, values?: Record<string, string | number>): string;
 /** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */

package/dist/cjs/pos/texte.js

@@ -22,7 +22,7 @@
  * `placeholders` und `structure`).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LABELS = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = void 0;
+exports.RETURN_DISPOSITION_LABELS = exports.LABELS = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = void 0;
 exports.findErrorRule = findErrorRule;
 exports.messageOutcome = messageOutcome;
 exports.receiptEmailErrorMessage = receiptEmailErrorMessage;
@@ -172,6 +172,10 @@ const MELDUNGEN_ROH = {
     // nicht jede Karte abgehakt ist: einmal nachfragen -- eine vergessene
     // Gutschrift faellt sonst erst dem Gast auf.
     'cancellation.cards_not_checked': { text: 'Noch ist nicht jede Karte abgehakt – bitte jede am Terminal gutschreiben. Ist das schon geschehen, zum Schließen noch einmal drücken.' },
+    // Das Backend weist Grund, Notiz oder Positionen des Stornos zurueck
+    // (`unknown_reason`, `note_too_long`, `invalid_items`): am Server geschah
+    // nichts, der Kassier beginnt das Storno von vorn.
+    'cancellation.input_rejected': { text: 'Die Eingabe wurde abgelehnt – bitte das Storno neu beginnen.' },
     // --- Getrennt zahlen -----------------------------------------------------
     // Ein Tisch zahlt in Teilen, ein Beleg fuer alles. Das Teure ist eine schon
     // belastete Karte: jeder Satz, der sie betrifft, nennt den Betrag, und keiner
@@ -598,8 +602,32 @@ const BESCHRIFTUNGEN_ROH = {
     'codetable.preview_title': { text: 'So steht es dann am Bon:' },
     'codetable.apply': { text: 'Übernehmen' },
     'codetable.other_row': { text: 'Andere Zeile' },
+    // --- Lager an der Kasse ----------------------------------------------------
+    // Standort-Auswahl, Bestandsanzeige und die Rueckgabe-Wahl beim Storno
+    // (`RETURN_DISPOSITION_LABELS`). „aufgelöst“ steht an einem Standort mit
+    // `active: false`, „verfügbar“ an der Menge `available`.
+    'stock.all_articles': { text: 'Alle Artikel' },
+    'stock.location': { text: 'Lager-Standort' },
+    'stock.default_location': { text: 'Standard-Standort' },
+    'stock.resolved': { text: 'aufgelöst' },
+    'stock.where_to': { text: 'Wohin mit der Ware?' },
+    'stock.available': { text: 'verfügbar' },
+    'stock.return_restock': { text: 'Zurück ins Lager' },
+    'stock.return_defective': { text: 'Defekt' },
+    'stock.return_disposed': { text: 'Entsorgt' },
 };
 exports.LABELS = BESCHRIFTUNGEN_ROH;
+/**
+ * Rueckgabe beim Storno (`returnDisposition`): welche Beschriftung jede Wahl
+ * traegt. Ein Objekt wie CANCELLATION_PAYMENT_ERROR_MESSAGES, keine Liste in
+ * GROSSSCHRIFT (der Oberflaechen-Vertrag liest Listen als Enums ein); die
+ * App liest die Zuordnung aus `fixtures/pos-texts.json`.
+ */
+exports.RETURN_DISPOSITION_LABELS = {
+    restock: 'stock.return_restock',
+    defective: 'stock.return_defective',
+    disposed: 'stock.return_disposed',
+};
 /** Die Beschriftung zum Schluessel, Platzhalter ersetzt; fehlt ein Wert, wirft es wie `messageText`. */
 function labelText(key, values = {}) {
     return ersetze(`labelText(${key})`, exports.LABELS[key].text, values);

package/dist/cjs/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.2.1";
+export declare const PACKAGE_VERSION = "1.3.0";

package/dist/cjs/version.js

@@ -7,4 +7,4 @@ exports.PACKAGE_VERSION = void 0;
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-exports.PACKAGE_VERSION = '1.2.1';
+exports.PACKAGE_VERSION = '1.3.0';

package/dist/esm/client/status.d.ts

@@ -34,7 +34,7 @@ export type SignatureStatus = CashboxStatus | 'NOT_REGISTERED';
 export declare function getCashboxStatus(transport: InternerTransport): Promise<CashboxStatus>;
 /**
  * Status der Signatureinheit mit der Zertifikatsseriennummer [certificateSerialHex]
- * (hexadezimal, z. B. `6F0404F0`).
+ * (hexadezimal, z. B. `5A1C3E07`).
  *
  * **Der Returncode wird vor dem Status gelesen** (wie im Dart-Vorbild): `B33`
  * heisst "nicht registriert" und schlaegt jedes Statusfeld, das daneben stehen

package/dist/esm/client/status.js

@@ -16,7 +16,7 @@ export async function getCashboxStatus(transport) {
 }
 /**
  * Status der Signatureinheit mit der Zertifikatsseriennummer [certificateSerialHex]
- * (hexadezimal, z. B. `6F0404F0`).
+ * (hexadezimal, z. B. `5A1C3E07`).
  *
  * **Der Returncode wird vor dem Status gelesen** (wie im Dart-Vorbild): `B33`
  * heisst "nicht registriert" und schlaegt jedes Statusfeld, das daneben stehen

package/dist/esm/pos/artikel.d.ts

@@ -72,6 +72,22 @@ export interface PosArticle {
      * (`fromPosArticlePayload`) setzt das Feld immer (`null` oder Liste).
      */
     stockLocationIds?: string[] | null;
+    /**
+     * Artikelnummer des Betriebs; null = keine. Diese und die drei folgenden
+     * Felder (Scanner-Suche, Lager) sind optional wie `stockLocationIds`, der
+     * Leser setzt sie immer. Texte kommen unveraendert durch (fuehrende Nullen,
+     * Schreibweise); nur ein leerer Text (auch reiner Leerraum) wird `null`.
+     */
+    number?: string | null;
+    /** EAN/GTIN, wie gespeichert; null = keine. */
+    ean?: string | null;
+    /** Interner Code des Betriebs (eigener Barcode/QR); null = keiner. */
+    internalCode?: string | null;
+    /**
+     * Bestandsgefuehrt (Lager-Modul). `null`, wenn die Antwort keine Angabe
+     * traegt (aeltere Backends) -- dann nicht aus anderen Feldern ableiten.
+     */
+    stockTracked?: boolean | null;
 }
 /** Deckelt eine gewuenschte Menge an der Hoechstmenge des Artikels (null = keine Grenze). */
 export declare function allowedQuantity(a: Pick<PosArticle, 'maxQuantity'>, wanted: number): number;
@@ -93,6 +109,10 @@ export interface PosArticlePayload {
     askQuantity?: boolean | null;
     maxQuantity?: number | null;
     stockLocationIds?: string[] | null;
+    number?: string | null;
+    ean?: string | null;
+    internalCode?: string | null;
+    stockTracked?: boolean | null;
 }
 export declare function fromPosArticlePayload(p: PosArticlePayload): PosArticle;
 /**

package/dist/esm/pos/artikel.js

@@ -45,6 +45,10 @@ export function quantityDefaults(a) {
 export function allowedQuantity(a, wanted) {
     return a.maxQuantity != null && a.maxQuantity > 0 ? Math.min(wanted, a.maxQuantity) : wanted;
 }
+/** Ein Text mit Inhalt, unveraendert; leer, nur Leerraum oder kein Text -> null. */
+function textOderNull(wert) {
+    return typeof wert === 'string' && wert.trim() !== '' ? wert : null;
+}
 export function fromPosArticlePayload(p) {
     return {
         id: p.id ?? '',
@@ -63,6 +67,10 @@ export function fromPosArticlePayload(p) {
         stockLocationIds: Array.isArray(p.stockLocationIds)
             ? p.stockLocationIds.filter((s) => typeof s === 'string' && s !== '')
             : null,
+        number: textOderNull(p.number),
+        ean: textOderNull(p.ean),
+        internalCode: textOderNull(p.internalCode),
+        stockTracked: typeof p.stockTracked === 'boolean' ? p.stockTracked : null,
     };
 }
 /**

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

@@ -15,4 +15,4 @@ export { type NetworkPrinter, type PrintJob, type PrintJobStatus, PRINT_JOB_STAT
 export { listMyTipRecipients } from './trinkgeld.js';
 export { STOCK_LOCATION_TYPES, type StockLocationType, type StockLocation, type StockLocationAddress, type StockLevel, type StockValue, type StockList, type ListMyStockOptions, type SetMyCashregisterStockLocationOptions, type CashregisterStockLocation, listMyStockLocations, listMyStock, setMyCashregisterStockLocation, } from './lager.js';
 export { RETURN_DISPOSITIONS, isReturnDisposition, type ReturnDisposition } from '../models/cancellation.js';
-export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';
+export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, RETURN_DISPOSITION_LABELS, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';

package/dist/esm/pos/index.js

@@ -21,4 +21,4 @@ export { STOCK_LOCATION_TYPES, listMyStockLocations, listMyStock, setMyCashregis
 // Rueckgabe-Wahl beim Storno (Kassen-Dialog); dieselbe Liste wie an der Wurzel.
 export { RETURN_DISPOSITIONS, isReturnDisposition } from '../models/cancellation.js';
 // Was die Kasse selbst sagt: ein Katalog fuer Browser-Kasse und App.
-export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, } from './texte.js';
+export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, RETURN_DISPOSITION_LABELS, } from './texte.js';

package/dist/esm/pos/texte.d.ts

@@ -300,6 +300,9 @@ declare const MELDUNGEN_ROH: {
     readonly 'cancellation.cards_not_checked': {
         readonly text: "Noch ist nicht jede Karte abgehakt – bitte jede am Terminal gutschreiben. Ist das schon geschehen, zum Schließen noch einmal drücken.";
     };
+    readonly 'cancellation.input_rejected': {
+        readonly text: "Die Eingabe wurde abgelehnt – bitte das Storno neu beginnen.";
+    };
     readonly 'split.setting_hint': {
         readonly text: "Ein Tisch zahlt in Teilen: jede Zahlung bar oder mit Karte, mit eigenem Trinkgeld – am Ende ein Beleg für alles.";
     };
@@ -1015,9 +1018,47 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'codetable.other_row': {
         readonly text: "Andere Zeile";
     };
+    readonly 'stock.all_articles': {
+        readonly text: "Alle Artikel";
+    };
+    readonly 'stock.location': {
+        readonly text: "Lager-Standort";
+    };
+    readonly 'stock.default_location': {
+        readonly text: "Standard-Standort";
+    };
+    readonly 'stock.resolved': {
+        readonly text: "aufgelöst";
+    };
+    readonly 'stock.where_to': {
+        readonly text: "Wohin mit der Ware?";
+    };
+    readonly 'stock.available': {
+        readonly text: "verfügbar";
+    };
+    readonly 'stock.return_restock': {
+        readonly text: "Zurück ins Lager";
+    };
+    readonly 'stock.return_defective': {
+        readonly text: "Defekt";
+    };
+    readonly 'stock.return_disposed': {
+        readonly text: "Entsorgt";
+    };
 };
 export type LabelKey = keyof typeof BESCHRIFTUNGEN_ROH;
 export declare const LABELS: Record<LabelKey, TextEntry>;
+/**
+ * Rueckgabe beim Storno (`returnDisposition`): welche Beschriftung jede Wahl
+ * traegt. Ein Objekt wie CANCELLATION_PAYMENT_ERROR_MESSAGES, keine Liste in
+ * GROSSSCHRIFT (der Oberflaechen-Vertrag liest Listen als Enums ein); die
+ * App liest die Zuordnung aus `fixtures/pos-texts.json`.
+ */
+export declare const RETURN_DISPOSITION_LABELS: {
+    readonly restock: "stock.return_restock";
+    readonly defective: "stock.return_defective";
+    readonly disposed: "stock.return_disposed";
+};
 /** Die Beschriftung zum Schluessel, Platzhalter ersetzt; fehlt ein Wert, wirft es wie `messageText`. */
 export declare function labelText(key: LabelKey, values?: Record<string, string | number>): string;
 /** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */

package/dist/esm/pos/texte.js

@@ -162,6 +162,10 @@ const MELDUNGEN_ROH = {
     // nicht jede Karte abgehakt ist: einmal nachfragen -- eine vergessene
     // Gutschrift faellt sonst erst dem Gast auf.
     'cancellation.cards_not_checked': { text: 'Noch ist nicht jede Karte abgehakt – bitte jede am Terminal gutschreiben. Ist das schon geschehen, zum Schließen noch einmal drücken.' },
+    // Das Backend weist Grund, Notiz oder Positionen des Stornos zurueck
+    // (`unknown_reason`, `note_too_long`, `invalid_items`): am Server geschah
+    // nichts, der Kassier beginnt das Storno von vorn.
+    'cancellation.input_rejected': { text: 'Die Eingabe wurde abgelehnt – bitte das Storno neu beginnen.' },
     // --- Getrennt zahlen -----------------------------------------------------
     // Ein Tisch zahlt in Teilen, ein Beleg fuer alles. Das Teure ist eine schon
     // belastete Karte: jeder Satz, der sie betrifft, nennt den Betrag, und keiner
@@ -588,8 +592,32 @@ const BESCHRIFTUNGEN_ROH = {
     'codetable.preview_title': { text: 'So steht es dann am Bon:' },
     'codetable.apply': { text: 'Übernehmen' },
     'codetable.other_row': { text: 'Andere Zeile' },
+    // --- Lager an der Kasse ----------------------------------------------------
+    // Standort-Auswahl, Bestandsanzeige und die Rueckgabe-Wahl beim Storno
+    // (`RETURN_DISPOSITION_LABELS`). „aufgelöst“ steht an einem Standort mit
+    // `active: false`, „verfügbar“ an der Menge `available`.
+    'stock.all_articles': { text: 'Alle Artikel' },
+    'stock.location': { text: 'Lager-Standort' },
+    'stock.default_location': { text: 'Standard-Standort' },
+    'stock.resolved': { text: 'aufgelöst' },
+    'stock.where_to': { text: 'Wohin mit der Ware?' },
+    'stock.available': { text: 'verfügbar' },
+    'stock.return_restock': { text: 'Zurück ins Lager' },
+    'stock.return_defective': { text: 'Defekt' },
+    'stock.return_disposed': { text: 'Entsorgt' },
 };
 export const LABELS = BESCHRIFTUNGEN_ROH;
+/**
+ * Rueckgabe beim Storno (`returnDisposition`): welche Beschriftung jede Wahl
+ * traegt. Ein Objekt wie CANCELLATION_PAYMENT_ERROR_MESSAGES, keine Liste in
+ * GROSSSCHRIFT (der Oberflaechen-Vertrag liest Listen als Enums ein); die
+ * App liest die Zuordnung aus `fixtures/pos-texts.json`.
+ */
+export const RETURN_DISPOSITION_LABELS = {
+    restock: 'stock.return_restock',
+    defective: 'stock.return_defective',
+    disposed: 'stock.return_disposed',
+};
 /** Die Beschriftung zum Schluessel, Platzhalter ersetzt; fehlt ein Wert, wirft es wie `messageText`. */
 export function labelText(key, values = {}) {
     return ersetze(`labelText(${key})`, LABELS[key].text, values);

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.2.1";
+export declare const PACKAGE_VERSION = "1.3.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.2.1';
+export const PACKAGE_VERSION = '1.3.0';

package/fixtures/code-table-receipts.json

@@ -67,10 +67,10 @@
           "paymentMethod": "cash",
           "turnoverCounterAES256ICM": "UMSATZ",
           "signaturePreviousReceipt": "VORGAENGER",
-          "certificateSerialNumber": "6F0404F0",
+          "certificateSerialNumber": "5A1C3E07",
           "receiptType": "standard",
           "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
-          "qr": "_R1-AT1_KASSE1_AT0-KASSE1-43_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_6F0404F0_SIGNATUR",
+          "qr": "_R1-AT1_KASSE1_AT0-KASSE1-43_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
           "fullReceiptId": "VOLL",
           "customerDetails": [],
           "legalMessage": []

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

@@ -299,7 +299,7 @@
     },
     {
       "kind": "qr",
-      "data": "_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"
+      "data": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR"
     },
     {
       "kind": "space",

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

@@ -212,7 +212,7 @@
     },
     {
       "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",
+      "payload": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
       "widthFraction": 0.828125
     },
     {

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

@@ -200,7 +200,7 @@
     },
     {
       "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",
+      "payload": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
       "widthFraction": 0.5520833333333334
     },
     {

package/fixtures/expected/cancellation-full.lines.json

@@ -259,7 +259,7 @@
     },
     {
       "kind": "qr",
-      "data": "_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"
+      "data": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR"
     },
     {
       "kind": "space",

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

@@ -182,7 +182,7 @@
     },
     {
       "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",
+      "payload": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
       "widthFraction": 0.828125
     },
     {

package/fixtures/expected/cancellation-full.sheet48.json

@@ -176,7 +176,7 @@
     },
     {
       "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",
+      "payload": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
       "widthFraction": 0.5520833333333334
     },
     {

package/fixtures/expected/cancellation-partial.lines.json

@@ -219,7 +219,7 @@
     },
     {
       "kind": "qr",
-      "data": "_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"
+      "data": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR"
     },
     {
       "kind": "space",

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

@@ -170,7 +170,7 @@
     },
     {
       "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",
+      "payload": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
       "widthFraction": 0.828125
     },
     {

package/fixtures/expected/cancellation-partial.sheet48.json

@@ -164,7 +164,7 @@
     },
     {
       "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",
+      "payload": "_R1-AT1_KASSE1_AT0-KASSE1-42_2026-08-13T10:15:30_5,00_2,70_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
       "widthFraction": 0.5520833333333334
     },
     {

package/fixtures/expected/cancellation-split-full.lines.json

@@ -310,7 +310,7 @@
     },
     {
       "kind": "qr",
-      "data": "_R1-AT1_KASSE1_AT0-KASSE1-76_2026-09-25T10:15:30_-20,00_-25,45_0,00_0,00_0,00_UMSATZ_VORGAENGER_6F0404F0_SIGNATUR"
+      "data": "_R1-AT1_KASSE1_AT0-KASSE1-76_2026-09-25T10:15:30_-20,00_-25,45_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR"
     },
     {
       "kind": "space",