@kreiseck/kasseneck-api 1.2.2 → 1.4.0

package/dist/esm/inventory/vertrag.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Der Vertrag der Lager-API (Backend Stufe 5a) als Daten: Endpunkte,
+ * Wertkataloge, Ereignisse und Fehlercodes, englisch wie am Draht `/v3`.
+ *
+ * Quelle ist der Vertrags-Export des Backends (`fixtures/v3/v3-vokabular.json`):
+ * `endpoints.public`, die Kataloge `STANDORT_TYP`, `BEWEGUNG_ART`,
+ * `BEWEGUNG_QUELLE`, `LAGER_ZUSTAND`, `LAGER_URSACHE`, `ZUSTELLUNG` und
+ * `events`. `test/inventory.test.ts` haelt jede Liste deckungsgleich mit
+ * dieser Datei; nichts hier wird geraten.
+ */
+/** Die 14 Endpunkte, in der Reihenfolge von `endpoints.public`. */
+export declare const INVENTORY_ENDPOINTS: readonly ["getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries"];
+export type InventoryEndpoint = (typeof INVENTORY_ENDPOINTS)[number];
+/** Art eines Standorts (Katalog `STANDORT_TYP`). */
+export declare const LOCATION_TYPES: readonly ["warehouse", "store", "vehicle", "other"];
+export type LocationType = (typeof LOCATION_TYPES)[number];
+/**
+ * Art einer Lagerbewegung (Katalog `BEWEGUNG_ART`); zugleich der Filter `type`.
+ * `goods_receipt` ist der Wareneingang, `takeover` der uebernommene Anfangsbestand
+ * (auch per Import). `receipt` gibt es hier nicht: das ist der Kassenbeleg (Quelle).
+ */
+export declare const STOCK_MOVEMENT_TYPES: readonly ["sale", "goods_receipt", "loss", "return", "transfer_out", "transfer_in", "condition_out", "condition_in", "stocktake", "adjustment", "takeover", "reversal", "revaluation", "method_change"];
+export type StockMovementType = (typeof STOCK_MOVEMENT_TYPES)[number];
+/**
+ * Woher eine Bewegung kommt (Katalog `BEWEGUNG_QUELLE`); zugleich der Filter
+ * `source`. `receipt` ist der Kassenbeleg wie ueberall in der API (der
+ * Wareneingang ist die Bewegungsart `goods_receipt`).
+ */
+export declare const STOCK_MOVEMENT_SOURCES: readonly ["receipt", "invoice", "cancellation", "credit_note", "panel", "register", "api", "stocktake", "system"];
+export type StockMovementSource = (typeof STOCK_MOVEMENT_SOURCES)[number];
+/** Zustand der Ware an einer Bewegung (Katalog `LAGER_ZUSTAND`). */
+export declare const STOCK_CONDITIONS: readonly ["sellable", "defective"];
+export type StockCondition = (typeof STOCK_CONDITIONS)[number];
+/**
+ * Ursache eines `stock.changed` (Katalog `LAGER_URSACHE`), abgeleitet aus der
+ * juengsten Bewegung mit Mengenwirkung. `other`: keine Regel passt oder es
+ * gibt keine Bewegung (dann ist `movementId` `null`).
+ */
+export declare const STOCK_CHANGE_CAUSES: readonly ["sale", "invoice", "credit_note", "cancellation", "goods_receipt", "transfer", "loss", "condition", "reversal", "reservation", "stocktake", "takeover", "other"];
+export type StockChangeCause = (typeof STOCK_CHANGE_CAUSES)[number];
+/** Stand einer Zustellung (Katalog `ZUSTELLUNG`, derselbe wie bei Partner-Webhooks). */
+export declare const WEBHOOK_DELIVERY_STATUSES: readonly ["delivered", "pending", "failed", "dropped"];
+export type WebhookDeliveryStatus = (typeof WEBHOOK_DELIVERY_STATUSES)[number];
+/**
+ * Die Ereignisse, die ein Konto-Webhook abonnieren kann (Stufe 5a). Spaetere
+ * Stufen ergaenzen `reservation.*` und `variant_group.*`.
+ */
+export declare const INVENTORY_WEBHOOK_EVENTS: readonly ["stock.changed", "stock.below_minimum", "article.created", "article.updated", "article.deactivated"];
+export type InventoryWebhookEventType = (typeof INVENTORY_WEBHOOK_EVENTS)[number];
+/**
+ * Die Felder der Huelle jeder Zustellung, in der Reihenfolge am Draht. Statt
+ * `partnerId` (Partner-Webhooks) traegt sie `accountId`; `test` steht nur auf
+ * Probesendungen.
+ */
+export declare const INVENTORY_WEBHOOK_ENVELOPE_FIELDS: readonly ["id", "type", "createdAt", "accountId", "test", "data"];
+/** Hoechstzahl der Webhooks je Konto (`webhook_limit`, wie bei Partner-Webhooks). */
+export declare const INVENTORY_WEBHOOK_LIMIT = 5;
+/** Groesstes `limit` einer Liste; ohne Angabe liefert der Server 50. */
+export declare const INVENTORY_LIST_LIMIT_MAX = 200;
+/**
+ * Die Codes, die die Lager-Endpunkte selbst senden. `validation` traegt
+ * `errors: [{ field, message }]`, `rate_limited` traegt `retryAfterSec`
+ * (dazu die Kopfzeile `Retry-After`) – auch bei `sendWebhookTest` nach 20
+ * Probesendungen je Wiener Kalendertag (dann bis Mitternacht in Wien).
+ */
+export declare const INVENTORY_ERROR_CODES: readonly ["validation", "invalid_cursor", "article_not_found", "webhook_not_found", "webhook_limit", "invalid_webhook_url", "event_not_subscribed", "webhook_inactive", "inventory_api_not_enabled", "module_inactive", "rate_limited", "server_error"];
+export type InventoryErrorCode = (typeof INVENTORY_ERROR_CODES)[number];
+/**
+ * Codes, die Anmeldung und Rand auf jedem Lager-Aufruf erzeugen koennen,
+ * soweit sie nicht schon in [INVENTORY_ERROR_CODES] stehen: `errorCodes.auth`
+ * ohne die des Partner-Zugangs und `errorCodes.edge` (sortiert), zuletzt
+ * `route_missing` (Code des Pakets). Dieselbe Ableitung wie bei der
+ * Rechnungs-API.
+ */
+export declare const INVENTORY_REQUEST_ERROR_CODES: readonly ["account_not_found", "admin_required", "api_not_approved", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing"];
+export type InventoryRequestErrorCode = (typeof INVENTORY_REQUEST_ERROR_CODES)[number];

package/dist/esm/inventory/vertrag.js

@@ -0,0 +1,163 @@
+/**
+ * Der Vertrag der Lager-API (Backend Stufe 5a) als Daten: Endpunkte,
+ * Wertkataloge, Ereignisse und Fehlercodes, englisch wie am Draht `/v3`.
+ *
+ * Quelle ist der Vertrags-Export des Backends (`fixtures/v3/v3-vokabular.json`):
+ * `endpoints.public`, die Kataloge `STANDORT_TYP`, `BEWEGUNG_ART`,
+ * `BEWEGUNG_QUELLE`, `LAGER_ZUSTAND`, `LAGER_URSACHE`, `ZUSTELLUNG` und
+ * `events`. `test/inventory.test.ts` haelt jede Liste deckungsgleich mit
+ * dieser Datei; nichts hier wird geraten.
+ */
+/** Die 14 Endpunkte, in der Reihenfolge von `endpoints.public`. */
+export const INVENTORY_ENDPOINTS = [
+    'getArticle',
+    'listArticles',
+    'lookupArticleByCode',
+    'listLocations',
+    'getStock',
+    'listStock',
+    'listStockMovements',
+    'createWebhook',
+    'updateWebhook',
+    'deleteWebhook',
+    'listWebhooks',
+    'sendWebhookTest',
+    'rotateWebhookSecret',
+    'listWebhookDeliveries',
+];
+/** Art eines Standorts (Katalog `STANDORT_TYP`). */
+export const LOCATION_TYPES = ['warehouse', 'store', 'vehicle', 'other'];
+/**
+ * Art einer Lagerbewegung (Katalog `BEWEGUNG_ART`); zugleich der Filter `type`.
+ * `goods_receipt` ist der Wareneingang, `takeover` der uebernommene Anfangsbestand
+ * (auch per Import). `receipt` gibt es hier nicht: das ist der Kassenbeleg (Quelle).
+ */
+export const STOCK_MOVEMENT_TYPES = [
+    'sale',
+    'goods_receipt',
+    'loss',
+    'return',
+    'transfer_out',
+    'transfer_in',
+    'condition_out',
+    'condition_in',
+    'stocktake',
+    'adjustment',
+    'takeover',
+    'reversal',
+    'revaluation',
+    'method_change',
+];
+/**
+ * Woher eine Bewegung kommt (Katalog `BEWEGUNG_QUELLE`); zugleich der Filter
+ * `source`. `receipt` ist der Kassenbeleg wie ueberall in der API (der
+ * Wareneingang ist die Bewegungsart `goods_receipt`).
+ */
+export const STOCK_MOVEMENT_SOURCES = [
+    'receipt',
+    'invoice',
+    'cancellation',
+    'credit_note',
+    'panel',
+    'register',
+    'api',
+    'stocktake',
+    'system',
+];
+/** Zustand der Ware an einer Bewegung (Katalog `LAGER_ZUSTAND`). */
+export const STOCK_CONDITIONS = ['sellable', 'defective'];
+/**
+ * Ursache eines `stock.changed` (Katalog `LAGER_URSACHE`), abgeleitet aus der
+ * juengsten Bewegung mit Mengenwirkung. `other`: keine Regel passt oder es
+ * gibt keine Bewegung (dann ist `movementId` `null`).
+ */
+export const STOCK_CHANGE_CAUSES = [
+    'sale',
+    'invoice',
+    'credit_note',
+    'cancellation',
+    'goods_receipt',
+    'transfer',
+    'loss',
+    'condition',
+    'reversal',
+    'reservation',
+    'stocktake',
+    'takeover',
+    'other',
+];
+/** Stand einer Zustellung (Katalog `ZUSTELLUNG`, derselbe wie bei Partner-Webhooks). */
+export const WEBHOOK_DELIVERY_STATUSES = ['delivered', 'pending', 'failed', 'dropped'];
+/**
+ * Die Ereignisse, die ein Konto-Webhook abonnieren kann (Stufe 5a). Spaetere
+ * Stufen ergaenzen `reservation.*` und `variant_group.*`.
+ */
+export const INVENTORY_WEBHOOK_EVENTS = [
+    'stock.changed',
+    'stock.below_minimum',
+    'article.created',
+    'article.updated',
+    'article.deactivated',
+];
+/**
+ * Die Felder der Huelle jeder Zustellung, in der Reihenfolge am Draht. Statt
+ * `partnerId` (Partner-Webhooks) traegt sie `accountId`; `test` steht nur auf
+ * Probesendungen.
+ */
+export const INVENTORY_WEBHOOK_ENVELOPE_FIELDS = ['id', 'type', 'createdAt', 'accountId', 'test', 'data'];
+/** Hoechstzahl der Webhooks je Konto (`webhook_limit`, wie bei Partner-Webhooks). */
+export const INVENTORY_WEBHOOK_LIMIT = 5;
+/** Groesstes `limit` einer Liste; ohne Angabe liefert der Server 50. */
+export const INVENTORY_LIST_LIMIT_MAX = 200;
+/**
+ * Die Codes, die die Lager-Endpunkte selbst senden. `validation` traegt
+ * `errors: [{ field, message }]`, `rate_limited` traegt `retryAfterSec`
+ * (dazu die Kopfzeile `Retry-After`) – auch bei `sendWebhookTest` nach 20
+ * Probesendungen je Wiener Kalendertag (dann bis Mitternacht in Wien).
+ */
+export const INVENTORY_ERROR_CODES = [
+    'validation',
+    'invalid_cursor',
+    'article_not_found',
+    'webhook_not_found',
+    'webhook_limit',
+    'invalid_webhook_url',
+    'event_not_subscribed',
+    'webhook_inactive',
+    'inventory_api_not_enabled',
+    'module_inactive',
+    'rate_limited',
+    'server_error',
+];
+/**
+ * Codes, die Anmeldung und Rand auf jedem Lager-Aufruf erzeugen koennen,
+ * soweit sie nicht schon in [INVENTORY_ERROR_CODES] stehen: `errorCodes.auth`
+ * ohne die des Partner-Zugangs und `errorCodes.edge` (sortiert), zuletzt
+ * `route_missing` (Code des Pakets). Dieselbe Ableitung wie bei der
+ * Rechnungs-API.
+ */
+export const INVENTORY_REQUEST_ERROR_CODES = [
+    'account_not_found',
+    'admin_required',
+    'api_not_approved',
+    'cashregister_not_assigned',
+    'cashregister_not_found',
+    'cashregister_token_invalid',
+    'cashregister_token_missing',
+    'dialect_mismatch',
+    'internal_translation_error',
+    'live_not_enabled',
+    'method_not_allowed',
+    'mfa_required',
+    'not_found',
+    'register_user_no_business',
+    'register_user_not_allowed',
+    'register_user_not_found',
+    'response_translation_failed',
+    'session_expired',
+    'session_other_cashregister',
+    'unauthorized',
+    'user_disabled',
+    'user_verification_failed',
+    'route_missing',
+];

package/dist/esm/inventory/webhook.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Eingehende Konto-Webhooks der Lager-API: Signatur pruefen, Ereignis lesen.
+ *
+ * Dasselbe Verfahren wie bei Partner-Webhooks (Backend
+ * `gemeinsam/webhook-core.js`, `signaturKopf`/`pruefeSignatur`): Kopf
+ * `X-Kasseneck-Signature: t=<unix-sekunden>,v1=<hex>` mit
+ * `v1 = HMAC-SHA256(secret, "<t>.<roher Rumpf>")`, Zeitfenster 300 Sekunden in
+ * beide Richtungen, zeitkonstanter Vergleich, mehrere `v1=`-Anteile erlaubt.
+ * Die Pruefung selbst liegt in `partner/webhook-signatur.ts` und wird hier nur
+ * mit der Form `(secret, kopf, rumpf, optionen)` angeboten.
+ *
+ * Reihenfolge im Empfaenger: **erst pruefen, dann lesen**, und dabei den
+ * **rohen** Rumpf nehmen (in Express `express.raw({ type: '*\/*' })` vor jedem
+ * JSON-Parser).
+ */
+import type { InventoryWebhookEvent } from './typen.js';
+export { WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, } from '../partner/webhook-signatur.js';
+export interface VerifyInventoryWebhookOptions {
+    /** Erlaubte Abweichung des Zeitstempels in Sekunden, in beide Richtungen; Vorgabe 300. */
+    toleranceSec?: number;
+    /** Jetzt: ein `Date` oder Millisekunden seit 1970 (wie `Date.now()`). Vorgabe: die Systemuhr. */
+    now?: Date | number;
+}
+/**
+ * Prueft die Signatur einer Zustellung. `true` nur, wenn Kopf, Zeitfenster
+ * und HMAC stimmen; jede schlechte Eingabe und jede Ausnahme ist `false`,
+ * nie ein Wurf.
+ *
+ * **Asynchron**, weil die Pruefung WebCrypto (`crypto.subtle`) benutzt: das
+ * Paket hat keine Laufzeitabhaengigkeit und laeuft auch im Browser.
+ *
+ * @param secret  das Secret aus `createWebhook`/`rotateWebhookSecret`; eine
+ *                Liste erlaubt den Wechsel (es reicht, wenn eines passt)
+ * @param header  der Wert von `X-Kasseneck-Signature`, unveraendert
+ * @param rawBody der **rohe** Rumpf (Text oder Bytes), nicht `JSON.parse` + `stringify`
+ */
+export declare function verifyInventoryWebhookSignature(secret: string | readonly string[], header: string | null | undefined, rawBody: string | Uint8Array, options?: VerifyInventoryWebhookOptions): Promise<boolean>;
+/**
+ * Liest eine Zustellung als typisiertes Ereignis. Vorher die Signatur pruefen
+ * ([verifyInventoryWebhookSignature]).
+ *
+ * - Ein Ereignis, das diese Paketversion nicht kennt (etwa `reservation.*`
+ *   einer spaeteren Stufe), ergibt `null`: mit 2xx antworten und uebergehen.
+ * - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
+ *   `KasseneckValidationError` (`scope: 'response'`).
+ *
+ * **Entdoppeln** auf `event.id`; **Stand statt Aenderung**: einen gespeicherten
+ * Bestand nur ueberschreiben, wenn `data.sequence` groesser ist.
+ */
+export declare function parseInventoryWebhookEvent(rawBody: string | Uint8Array): InventoryWebhookEvent | null;

package/dist/esm/inventory/webhook.js

@@ -0,0 +1,101 @@
+/**
+ * Eingehende Konto-Webhooks der Lager-API: Signatur pruefen, Ereignis lesen.
+ *
+ * Dasselbe Verfahren wie bei Partner-Webhooks (Backend
+ * `gemeinsam/webhook-core.js`, `signaturKopf`/`pruefeSignatur`): Kopf
+ * `X-Kasseneck-Signature: t=<unix-sekunden>,v1=<hex>` mit
+ * `v1 = HMAC-SHA256(secret, "<t>.<roher Rumpf>")`, Zeitfenster 300 Sekunden in
+ * beide Richtungen, zeitkonstanter Vergleich, mehrere `v1=`-Anteile erlaubt.
+ * Die Pruefung selbst liegt in `partner/webhook-signatur.ts` und wird hier nur
+ * mit der Form `(secret, kopf, rumpf, optionen)` angeboten.
+ *
+ * Reihenfolge im Empfaenger: **erst pruefen, dann lesen**, und dabei den
+ * **rohen** Rumpf nehmen (in Express `express.raw({ type: '*\/*' })` vor jedem
+ * JSON-Parser).
+ */
+import { KasseneckValidationError } from '../client/errors.js';
+import { verifyWebhookSignature as pruefeSignatur } from '../partner/webhook-signatur.js';
+import { artikel, bestandGeaendert, objekt, unterMindestbestand } from './lesen.js';
+import { INVENTORY_WEBHOOK_EVENTS } from './vertrag.js';
+export { WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, } from '../partner/webhook-signatur.js';
+/**
+ * Prueft die Signatur einer Zustellung. `true` nur, wenn Kopf, Zeitfenster
+ * und HMAC stimmen; jede schlechte Eingabe und jede Ausnahme ist `false`,
+ * nie ein Wurf.
+ *
+ * **Asynchron**, weil die Pruefung WebCrypto (`crypto.subtle`) benutzt: das
+ * Paket hat keine Laufzeitabhaengigkeit und laeuft auch im Browser.
+ *
+ * @param secret  das Secret aus `createWebhook`/`rotateWebhookSecret`; eine
+ *                Liste erlaubt den Wechsel (es reicht, wenn eines passt)
+ * @param header  der Wert von `X-Kasseneck-Signature`, unveraendert
+ * @param rawBody der **rohe** Rumpf (Text oder Bytes), nicht `JSON.parse` + `stringify`
+ */
+export async function verifyInventoryWebhookSignature(secret, header, rawBody, options = {}) {
+    try {
+        const jetzt = options.now instanceof Date ? options.now.getTime() : options.now;
+        const nowSec = typeof jetzt === 'number' && Number.isFinite(jetzt) ? Math.floor(jetzt / 1000) : undefined;
+        const r = await pruefeSignatur({
+            secret,
+            signatureHeader: header,
+            body: rawBody,
+            ...(nowSec === undefined ? {} : { nowSec }),
+            ...(options.toleranceSec === undefined ? {} : { toleranceSec: options.toleranceSec }),
+        });
+        return r.ok;
+    }
+    catch {
+        return false;
+    }
+}
+const BEKANNT = new Set(INVENTORY_WEBHOOK_EVENTS);
+function kaputt(grund) {
+    return new KasseneckValidationError('parseInventoryWebhookEvent', grund, 'response');
+}
+/**
+ * Liest eine Zustellung als typisiertes Ereignis. Vorher die Signatur pruefen
+ * ([verifyInventoryWebhookSignature]).
+ *
+ * - Ein Ereignis, das diese Paketversion nicht kennt (etwa `reservation.*`
+ *   einer spaeteren Stufe), ergibt `null`: mit 2xx antworten und uebergehen.
+ * - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
+ *   `KasseneckValidationError` (`scope: 'response'`).
+ *
+ * **Entdoppeln** auf `event.id`; **Stand statt Aenderung**: einen gespeicherten
+ * Bestand nur ueberschreiben, wenn `data.sequence` groesser ist.
+ */
+export function parseInventoryWebhookEvent(rawBody) {
+    const text = typeof rawBody === 'string' ? rawBody : new TextDecoder('utf-8').decode(rawBody);
+    let roh;
+    try {
+        roh = JSON.parse(text);
+    }
+    catch {
+        throw kaputt('Rumpf ist kein JSON');
+    }
+    const e = objekt(roh);
+    if (!e)
+        throw kaputt('Rumpf ist kein Ereignis (kein Objekt)');
+    const { id, type, createdAt, accountId, data } = e;
+    if (typeof id !== 'string' || id === '' || typeof type !== 'string' || type === '')
+        throw kaputt('Ereignis ohne id oder type');
+    if (typeof createdAt !== 'number' || !Number.isFinite(createdAt))
+        throw kaputt('Ereignis ohne createdAt');
+    if (typeof accountId !== 'string' || accountId === '')
+        throw kaputt('Ereignis ohne accountId');
+    if (!BEKANNT.has(type))
+        return null;
+    const ort = { name: 'parseInventoryWebhookEvent', pfad: 'data' };
+    if (!objekt(data))
+        throw kaputt('Ereignis ohne data');
+    // Nur ein ausdrueckliches `true` ist eine Probe; im Zweifel der Ernstfall.
+    const huelle = { id, type: type, createdAt, accountId, test: e.test === true };
+    switch (huelle.type) {
+        case 'stock.changed':
+            return { ...huelle, type: huelle.type, data: bestandGeaendert(ort, data) };
+        case 'stock.below_minimum':
+            return { ...huelle, type: huelle.type, data: unterMindestbestand(ort, data) };
+        default:
+            return { ...huelle, type: huelle.type, data: artikel(ort, data) };
+    }
+}

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/stored/vokabular.d.ts

@@ -1,5 +1,5 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "b1049e2f65e9261cf8f729481d9ce1e5afda2cf620333f38ae6bf1afb36c8712";
+export declare const VOKABULAR_QUELLE = "79931a40ccaea45777da4713bba475c2f74e1fe7d6264f294cecd321964f9ded";
 /** 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 = "b1049e2f65e9261cf8f729481d9ce1e5afda2cf620333f38ae6bf1afb36c8712";
+export const VOKABULAR_QUELLE = "79931a40ccaea45777da4713bba475c2f74e1fe7d6264f294cecd321964f9ded";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 export const SCHEMAS = {
     "getReceipt": {

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.2";
+export declare const PACKAGE_VERSION = "1.4.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.2';
+export const PACKAGE_VERSION = '1.4.0';

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.2",
+  "version": "1.4.0",
   "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.2.2",
+  "package": "1.4.0",
   "endpoints": {
     "createCustomer": {
       "request": {

package/fixtures/invoice-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.2",
+  "version": "1.4.0",
   "languages": [
     "de",
     "en"