@kreiseck/kasseneck-api 1.1.1 → 1.2.1

package/dist/esm/pos/lager.js

@@ -0,0 +1,154 @@
+import { KasseneckValidationError } from '../client/errors.js';
+import { liste } from './artikel.js';
+/**
+ * Lager an der Kasse (Lager-Kern Stufe 2, Backend lager-endpoints.js):
+ * Standorte, Bestand und der Standort der Kasse. Alle drei Aufrufe gibt es
+ * nur ueber den Kassenweg `/api/v3` (registerInternal); Rechte am Server:
+ * `stockView` (lesen), `stockCosts` (Werte), `stockLocation` (Standort setzen).
+ *
+ * **Ganzzahlen:** Mengen sind Tausendstel der Basiseinheit (`1000` = 1 Stueck,
+ * `250` = 0,250 kg), Werte ganze Cent bzw. Mikro-Euro. Nichts wird geteilt,
+ * gerundet oder geklemmt -- ein negativer Bestand (mehr verkauft als gebucht)
+ * ist eine Aussage des Servers und bleibt negativ. Eine Zahl, die keine
+ * Ganzzahl ist, oder eine fehlende Menge wird **nie** zu `0`: der Aufruf
+ * endet mit `KasseneckValidationError` (`scope: 'response'`), denn „kein
+ * Bestand“ und „Antwort kaputt“ sind verschiedene Aussagen.
+ */
+/** Standort-Typen (Katalog `STANDORT_TYP`), englisch wie am Draht. */
+export const STOCK_LOCATION_TYPES = Object.freeze(['warehouse', 'store', 'vehicle', 'other']);
+const TYPEN = new Set(STOCK_LOCATION_TYPES);
+function antwortfehler(name, grund) {
+    return new KasseneckValidationError(name, grund, 'response');
+}
+const objekt = (w) => (w !== null && typeof w === 'object' && !Array.isArray(w) ? w : null);
+/** Freitext, der fehlen darf (Name, Adressteile, Kennzeichen): leer = `null`. */
+const textOderNull = (w) => (typeof w === 'string' && w !== '' ? w : null);
+/**
+ * Eine Kennung, die da sein muss: ohne sie ist die Zeile nicht zuzuordnen,
+ * und ein leerer Text als `stockLocationId` setzte die Kasse zurueck.
+ */
+function kennung(name, pfad, w) {
+    if (typeof w !== 'string' || w === '')
+        throw antwortfehler(name, `Antwort enthaelt keine Kennung (data.${pfad} fehlt)`);
+    return w;
+}
+/** Eine Zahl des Servers: Ganzzahl oder Antwortfehler, nie ein Ersatzwert. */
+function ganzzahl(name, pfad, w) {
+    if (typeof w !== 'number' || !Number.isInteger(w)) {
+        throw antwortfehler(name, `Antwort enthaelt keine ganze Zahl (data.${pfad})`);
+    }
+    return w;
+}
+function standort(name, e, i) {
+    const s = objekt(e) ?? {};
+    const pfad = `locations[${i}]`;
+    const a = objekt(s.address);
+    const teile = a ? { street: textOderNull(a.street), zip: textOderNull(a.zip), city: textOderNull(a.city), country: textOderNull(a.country) } : null;
+    // Eine Adresse ohne einen einzigen Teil ist keine Adresse.
+    const address = teile && Object.values(teile).some((t) => t !== null) ? teile : null;
+    return {
+        id: kennung(name, `${pfad}.id`, s.id),
+        name: typeof s.name === 'string' ? s.name : '',
+        type: typeof s.type === 'string' && TYPEN.has(s.type) ? s.type : null,
+        address,
+        licensePlate: textOderNull(s.licensePlate),
+        active: s.active !== false,
+        virtual: s.virtual === true,
+    };
+}
+function bestand(name, e, i) {
+    const b = objekt(e) ?? {};
+    const pfad = `stock[${i}]`;
+    return {
+        articleId: kennung(name, `${pfad}.articleId`, b.articleId),
+        locationId: kennung(name, `${pfad}.locationId`, b.locationId),
+        sellable: ganzzahl(name, `${pfad}.sellable`, b.sellable),
+        defective: ganzzahl(name, `${pfad}.defective`, b.defective),
+        reserved: ganzzahl(name, `${pfad}.reserved`, b.reserved),
+        available: ganzzahl(name, `${pfad}.available`, b.available),
+    };
+}
+function wert(name, e, i) {
+    const w = objekt(e) ?? {};
+    const pfad = `values[${i}]`;
+    return {
+        articleId: kennung(name, `${pfad}.articleId`, w.articleId),
+        stockValueCents: ganzzahl(name, `${pfad}.stockValueCents`, w.stockValueCents),
+        // Fehlt der Durchschnitt oder ist er null, ist die Menge 0 -- eine
+        // vorhandene, aber unbrauchbare Zahl ist dagegen ein Antwortfehler.
+        averageCostMicros: w.averageCostMicros === undefined || w.averageCostMicros === null
+            ? null
+            : ganzzahl(name, `${pfad}.averageCostMicros`, w.averageCostMicros),
+    };
+}
+/** Standorte des Betriebs, samt aufgeloesten (`active: false`) und dem Hauptstandort. */
+export async function listMyStockLocations(transport) {
+    const name = 'listMyStockLocations';
+    const daten = await transport(name);
+    return liste(daten, 'locations', name, (e, i) => standort(name, e, i));
+}
+/** Bestand je Artikel und Standort; Werte nur mit dem Recht `stockCosts`. */
+export async function listMyStock(transport, options = {}) {
+    const name = 'listMyStock';
+    if (options === null || typeof options !== 'object')
+        throw new KasseneckValidationError(name, 'options muss ein Objekt sein', 'request');
+    const params = {};
+    for (const feld of ['locationId', 'articleId']) {
+        const w = options[feld];
+        if (w === undefined || w === '')
+            continue;
+        if (typeof w !== 'string')
+            throw new KasseneckValidationError(name, `${feld} muss Text sein`, 'request');
+        params[feld] = w;
+    }
+    if (options.belowMinimum !== undefined) {
+        if (typeof options.belowMinimum !== 'boolean')
+            throw new KasseneckValidationError(name, 'belowMinimum muss true oder false sein', 'request');
+        // false filtert am Server nicht; gesendet wird nur der Filter selbst.
+        if (options.belowMinimum)
+            params.belowMinimum = true;
+    }
+    const daten = await transport(name, params);
+    const stock = liste(daten, 'stock', name, (e, i) => bestand(name, e, i));
+    const roh = objekt(daten)?.values;
+    // Fehlt `values`, fehlt dem Aufrufer das Recht `stockCosts`: `null`, nie `[]`.
+    // Etwas anderes als eine Liste ist dagegen kein „kein Recht“, sondern kaputt.
+    if (roh === undefined || roh === null)
+        return { stock, values: null };
+    return { stock, values: liste(daten, 'values', name, (e, i) => wert(name, e, i)) };
+}
+/**
+ * Standort der Kasse setzen -- von dort bucht der Server Verkauf und Storno
+ * ab. `stockLocationId: null` setzt zurueck (am Draht der leere Text).
+ * Fehler am Code: `location_not_found`, `location_inactive`,
+ * `cashregister_not_found`, `cashregister_not_assigned`, `not_permitted`,
+ * `module_inactive`.
+ */
+export async function setMyCashregisterStockLocation(transport, options) {
+    const name = 'setMyCashregisterStockLocation';
+    const ziel = options?.stockLocationId;
+    if (ziel !== null && typeof ziel !== 'string') {
+        throw new KasseneckValidationError(name, 'stockLocationId fehlt (Kennung, oder null zum Zuruecksetzen)', 'request');
+    }
+    // Leer setzt zurueck. Nur Leerraum wuerde der Server kuerzen und damit still
+    // auf den Standard-Standort zuruecksetzen: das ist kein Standort, sondern ein Fehler.
+    if (ziel !== null && ziel !== '' && ziel.trim() === '') {
+        throw new KasseneckValidationError(name, 'stockLocationId ist nur Leerraum (Kennung angeben, oder null zum Zuruecksetzen)', 'request');
+    }
+    const params = { stockLocationId: ziel === null ? '' : ziel };
+    if (options.cashregisterId !== undefined) {
+        if (typeof options.cashregisterId !== 'string' || options.cashregisterId.trim() === '') {
+            throw new KasseneckValidationError(name, 'cashregisterId ist leer', 'request');
+        }
+        params.cashregisterId = options.cashregisterId;
+    }
+    const daten = objekt(await transport(name, params));
+    if (!daten || typeof daten.cashregisterId !== 'string' || daten.cashregisterId === '') {
+        throw antwortfehler(name, 'Antwort enthaelt keine Kasse (data.cashregisterId fehlt)');
+    }
+    const stand = daten.stockLocationId;
+    if (stand !== null && stand !== undefined && typeof stand !== 'string') {
+        throw antwortfehler(name, 'Antwort enthaelt einen unbrauchbaren Standort (data.stockLocationId)');
+    }
+    return { cashregisterId: daten.cashregisterId, stockLocationId: textOderNull(stand) };
+}

package/dist/esm/register/errors.d.ts

@@ -22,7 +22,7 @@ import { KasseneckApiError } from '../client/errors.js';
  * ueber `KasseneckApiError.code` lesbar; die Kasse braucht dafuer einen
  * Rueckfallzweig.
  */
-export declare const REGISTER_ERROR_CODES: readonly ["account_not_found", "admin_required", "cashregister_in_use", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "device_bound_elsewhere", "device_not_found", "device_not_paired", "device_takeover_required", "dialect_mismatch", "internal_translation_error", "licenses_exhausted", "live_not_enabled", "location_outside", "location_required", "login_failed", "login_mode_select_user", "login_unavailable", "method_not_allowed", "mfa_required", "not_found", "pairing_code_expired", "pairing_code_unknown", "pairing_code_used", "pairing_failed", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "session_ended", "session_expired", "session_not_running", "session_other_cashregister", "too_many_attempts", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
+export declare const REGISTER_ERROR_CODES: readonly ["account_not_found", "admin_required", "api_not_approved", "cashregister_in_use", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "device_bound_elsewhere", "device_not_found", "device_not_paired", "device_takeover_required", "dialect_mismatch", "internal_translation_error", "licenses_exhausted", "live_not_enabled", "location_outside", "location_required", "login_failed", "login_mode_select_user", "login_unavailable", "method_not_allowed", "mfa_required", "not_found", "pairing_code_expired", "pairing_code_unknown", "pairing_code_used", "pairing_failed", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "session_ended", "session_expired", "session_not_running", "session_other_cashregister", "too_many_attempts", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
 export type RegisterErrorCode = typeof REGISTER_ERROR_CODES[number];
 export declare function isRegisterErrorCode(value: unknown): value is RegisterErrorCode;
 /** Der Code eines geworfenen Fehlers, wenn es einer der Kassen-Anmeldung ist; sonst `undefined`. */

package/dist/esm/register/errors.js

@@ -26,6 +26,7 @@ import { feldfehlerVon } from '../client/fehlercodes.js';
 export const REGISTER_ERROR_CODES = Object.freeze([
     'account_not_found',
     'admin_required',
+    'api_not_approved',
     'cashregister_in_use',
     'cashregister_not_assigned',
     'cashregister_not_found',

package/dist/esm/register/pairing.d.ts

@@ -137,10 +137,12 @@ export interface RegisterDeviceUsers {
      * nennt den Grund als Menschentext (ausser Betrieb, keine Signaturkarte,
      * Startbeleg fehlt): die Kasse sperrt das Kassieren VOR dem ersten Beleg
      * statt an createReceipt zu scheitern. Fehlt das Feld, gilt bereit.
+     * `stockLocationId`: Lager-Standort der Kasse, fehlt = Standard-Standort.
      */
     cashregister?: {
         ready: boolean;
         reason?: string | null;
+        stockLocationId?: string;
     };
     /** Das Geraet haengt an der Test-Umgebung des Betriebs. */
     testEnvironment: boolean;
@@ -179,6 +181,24 @@ export interface RegisterUserPerms {
     discount?: boolean;
     /** Trinkgeld anderen zuweisen. */
     tipAssign?: boolean;
+    /**
+     * Lager: Standorte und Mengen sehen (listMyStockLocations, listMyStock).
+     * Fehlt das Recht, gilt es als erteilt – anders als alle anderen
+     * (siehe [stockViewOf]); ein ausdrueckliches `false` sperrt.
+     */
+    stockView?: boolean;
+    /** Lager: Einkaufswerte sehen (`values` in listMyStock); gibt nur der Inhaber frei. */
+    stockCosts?: boolean;
+    /** Lager: Wareneingang, Umbuchen. */
+    stockMove?: boolean;
+    /** Lager: Abgang, Zustand, Gegenbuchung. */
+    stockLoss?: boolean;
+    /** Inventur: zaehlen. */
+    stocktakeCount?: boolean;
+    /** Inventur: abschliessen. */
+    stocktakeClose?: boolean;
+    /** Standort der Kasse waehlen (setMyCashregisterStockLocation). */
+    stockLocation?: boolean;
     [weiteresRecht: string]: boolean | RegisterScope | undefined;
 }
 /**
@@ -189,10 +209,16 @@ export interface RegisterUserPerms {
  * nicht fuehrt (Tippfehler, umbenanntes Recht), kommt hier nicht durch.
  * Die Gegenrichtung schliesst [_RechteVollstaendig] direkt darunter.
  */
-export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign"];
+export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign", "stockView", "stockCosts", "stockMove", "stockLoss", "stocktakeCount", "stocktakeClose", "stockLocation"];
 /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
 export declare function cancelScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
 export declare function receiptsScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
+/**
+ * Darf der Benutzer Standorte und Mengen sehen? Wie im Backend (lager-core):
+ * ohne Schluessel gilt `stockView` als erteilt, ein ausdrueckliches `false`
+ * sperrt; alle anderen Lager-Rechte gelten ohne Schluessel als verweigert.
+ */
+export declare function stockViewOf(perms: RegisterUserPerms | null | undefined): boolean;
 /** Der angemeldete Kassen-Benutzer. */
 export interface RegisterUser {
     id: string;

package/dist/esm/register/pairing.js

@@ -49,6 +49,7 @@ const ohneAnmeldung = () => ({ headers: {}, params: {} });
 export const REGISTER_PERMS = [
     'sell', 'cancel', 'articles', 'layout', 'reports', 'takeover',
     'cancelScope', 'receiptsScope', 'drawer', 'discount', 'tipAssign',
+    'stockView', 'stockCosts', 'stockMove', 'stockLoss', 'stocktakeCount', 'stocktakeClose', 'stockLocation',
 ];
 /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
 export function cancelScopeOf(perms) {
@@ -65,6 +66,16 @@ export function receiptsScopeOf(perms) {
         return 'all';
     return ['none', 'own', 'all'].includes(perms.receiptsScope) ? perms.receiptsScope : 'none';
 }
+/**
+ * Darf der Benutzer Standorte und Mengen sehen? Wie im Backend (lager-core):
+ * ohne Schluessel gilt `stockView` als erteilt, ein ausdrueckliches `false`
+ * sperrt; alle anderen Lager-Rechte gelten ohne Schluessel als verweigert.
+ */
+export function stockViewOf(perms) {
+    if (!perms)
+        return false;
+    return perms.stockView === undefined ? true : perms.stockView === true;
+}
 /**
  * Geraet koppeln: der Kopplungs-Code wird gegen den dauerhaften Ausweis dieses
  * Geraets getauscht. **Ohne Anmeldung** — der Code ist der Nachweis.
@@ -199,7 +210,12 @@ function kasseBereit(wert) {
     const roh = wert;
     if (typeof roh['ready'] !== 'boolean')
         return undefined;
-    return { ready: roh['ready'], reason: typeof roh['reason'] === 'string' ? roh['reason'] : null };
+    const standort = roh['stockLocationId'];
+    return {
+        ready: roh['ready'],
+        reason: typeof roh['reason'] === 'string' ? roh['reason'] : null,
+        ...(typeof standort === 'string' && standort !== '' ? { stockLocationId: standort } : {}),
+    };
 }
 /** Die Regel aus der Antwort — oder `null`, wenn keine brauchbare kommt. */
 function regel(wert) {

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

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.1",
+  "version": "1.2.1",
   "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.1",
   "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": [