@kreiseck/kasseneck-api 1.4.0 → 1.5.0

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

@@ -1,7 +1,8 @@
 /**
  * `@kreiseck/kasseneck-api/inventory` – die Lager-API: Artikel, Standorte,
  * Bestand und Lagerprotokoll lesen, Konto-Webhooks verwalten und eingehende
- * Zustellungen pruefen (Backend Stufe 5a).
+ * Zustellungen pruefen (Backend Stufe 5a); Artikel anlegen und aendern,
+ * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0).
  *
  * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
  * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
@@ -12,8 +13,9 @@
  */
 export { createInventoryClient, type InventoryClient, type InventoryClientOptions } from './api.js';
 export { inventoryKeyAuth, type InventoryKeyAuthOptions } from './auth.js';
-export { isInventoryError, isInventoryErrorCode, inventoryErrorCode, inventoryFieldErrors, inventoryRetryAfterSec, type InventoryApiErrorCode, type InventoryFieldError, } from './fehler.js';
+export { isInventoryError, isInventoryErrorCode, inventoryErrorCode, inventoryFieldErrors, inventoryRetryAfterSec, inventoryShortfalls, isInventoryWarningCode, type InventoryApiErrorCode, type InventoryFieldError, } from './fehler.js';
 export { createWebhook, deleteWebhook, getArticle, getStock, iterateArticles, iterateStock, iterateStockMovements, listArticles, listLocations, listStock, listStockMovements, listWebhookDeliveries, listWebhooks, lookupArticleByCode, rotateWebhookSecret, sendWebhookTest, updateWebhook, } from './endpunkte.js';
+export { changeStockCondition, createArticle, createReservation, deactivateArticle, extendReservation, getReservation, iterateReservations, listReservations, previewGoodsReceipt, receiveGoods, recordStockLoss, releaseReservation, reverseStockMovement, transferStock, updateArticle, } from './schreiben.js';
 export { verifyInventoryWebhookSignature, parseInventoryWebhookEvent, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, type VerifyInventoryWebhookOptions, } from './webhook.js';
-export type { Article, ArticleListQuery, ArticleLookup, ArticlePage, CreateInventoryWebhookOptions, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookEnvelope, InventoryWebhookEvent, InventoryWebhookList, InventoryWebhookPatch, InventoryWebhookTestDelivery, InventoryWebhookTestResult, InventoryWebhookWithSecret, Location, LocationAddress, StockBelowMinimumEventData, StockChangedEventData, StockLevel, StockListQuery, StockMovement, StockMovementLot, StockMovementPage, StockMovementQuery, StockMovementSourceRef, StockPage, StockResult, StockValue, } from './typen.js';
-export { INVENTORY_ENDPOINTS, INVENTORY_ERROR_CODES, INVENTORY_REQUEST_ERROR_CODES, INVENTORY_WEBHOOK_EVENTS, INVENTORY_WEBHOOK_ENVELOPE_FIELDS, INVENTORY_WEBHOOK_LIMIT, INVENTORY_LIST_LIMIT_MAX, LOCATION_TYPES, STOCK_MOVEMENT_TYPES, STOCK_MOVEMENT_SOURCES, STOCK_CONDITIONS, STOCK_CHANGE_CAUSES, WEBHOOK_DELIVERY_STATUSES, type InventoryEndpoint, type InventoryErrorCode, type InventoryRequestErrorCode, type InventoryWebhookEventType, type LocationType, type StockMovementType, type StockMovementSource, type StockCondition, type StockChangeCause, type WebhookDeliveryStatus, } from './vertrag.js';
+export type { Article, ArticleInput, ArticleListQuery, ArticleLookup, ArticlePage, ChangeStockConditionRequest, CreateArticleRequest, CreateInventoryWebhookOptions, CreateReservationRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptItem, GoodsReceiptPreview, GoodsReceiptPreviewLine, GoodsReceiptPreviewRequest, InventoryShortfall, InventoryWarning, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookEnvelope, InventoryWebhookEvent, InventoryWebhookList, InventoryWebhookPatch, InventoryWebhookTestDelivery, InventoryWebhookTestResult, InventoryWebhookWithSecret, LandedCost, Location, LocationAddress, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationItem, ReleaseReservationRequest, Reservation, ReservationItem, ReservationItemInput, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockBelowMinimumEventData, StockChangedEventData, StockItem, StockLevel, StockListQuery, StockMovement, StockMovementLot, StockMovementPage, StockMovementQuery, StockMovementSourceRef, StockOperation, StockPage, StockResult, StockValue, TransferStockRequest, UpdateArticleRequest, } from './typen.js';
+export { INVENTORY_ENDPOINTS, INVENTORY_ERROR_CODES, INVENTORY_REQUEST_ERROR_CODES, INVENTORY_WEBHOOK_EVENTS, INVENTORY_WEBHOOK_ENVELOPE_FIELDS, INVENTORY_WEBHOOK_LIMIT, INVENTORY_LIST_LIMIT_MAX, LOCATION_TYPES, STOCK_MOVEMENT_TYPES, STOCK_MOVEMENT_SOURCES, STOCK_CONDITIONS, STOCK_CHANGE_CAUSES, WEBHOOK_DELIVERY_STATUSES, INVENTORY_WARNING_CODES, STOCK_KINDS, STOCK_LOSS_REASONS, WITHDRAWAL_TYPES, LANDED_COST_TYPES, LANDED_COST_ALLOCATIONS, RESERVATION_STATUSES, INVENTORY_IDEMPOTENCY_KEY_MAX, RESERVATION_MINUTES_MIN, RESERVATION_MINUTES_MAX, type InventoryEndpoint, type InventoryErrorCode, type InventoryRequestErrorCode, type InventoryWebhookEventType, type LocationType, type StockMovementType, type StockMovementSource, type StockCondition, type StockChangeCause, type WebhookDeliveryStatus, type InventoryWarningCode, type StockKind, type StockLossReason, type WithdrawalType, type LandedCostType, type LandedCostAllocation, type ReservationStatus, } from './vertrag.js';

package/dist/cjs/inventory/index.js

@@ -2,7 +2,8 @@
 /**
  * `@kreiseck/kasseneck-api/inventory` – die Lager-API: Artikel, Standorte,
  * Bestand und Lagerprotokoll lesen, Konto-Webhooks verwalten und eingehende
- * Zustellungen pruefen (Backend Stufe 5a).
+ * Zustellungen pruefen (Backend Stufe 5a); Artikel anlegen und aendern,
+ * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0).
  *
  * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
  * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
@@ -12,7 +13,8 @@
  * Mikro-Euro; alles Ganzzahlen.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.INVENTORY_WEBHOOK_EVENTS = exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_ENDPOINTS = exports.WEBHOOK_TOLERANCE_SEC = exports.WEBHOOK_DELIVERY_HEADER = exports.WEBHOOK_EVENT_HEADER = exports.WEBHOOK_SIGNATURE_HEADER = exports.parseInventoryWebhookEvent = exports.verifyInventoryWebhookSignature = exports.updateWebhook = exports.sendWebhookTest = exports.rotateWebhookSecret = exports.lookupArticleByCode = exports.listWebhooks = exports.listWebhookDeliveries = exports.listStockMovements = exports.listStock = exports.listLocations = exports.listArticles = exports.iterateStockMovements = exports.iterateStock = exports.iterateArticles = exports.getStock = exports.getArticle = exports.deleteWebhook = exports.createWebhook = exports.inventoryRetryAfterSec = exports.inventoryFieldErrors = exports.inventoryErrorCode = exports.isInventoryErrorCode = exports.isInventoryError = exports.inventoryKeyAuth = exports.createInventoryClient = void 0;
+exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_ENDPOINTS = exports.WEBHOOK_TOLERANCE_SEC = exports.WEBHOOK_DELIVERY_HEADER = exports.WEBHOOK_EVENT_HEADER = exports.WEBHOOK_SIGNATURE_HEADER = exports.parseInventoryWebhookEvent = exports.verifyInventoryWebhookSignature = exports.updateArticle = exports.transferStock = exports.reverseStockMovement = exports.releaseReservation = exports.recordStockLoss = exports.receiveGoods = exports.previewGoodsReceipt = exports.listReservations = exports.iterateReservations = exports.getReservation = exports.extendReservation = exports.deactivateArticle = exports.createReservation = exports.createArticle = exports.changeStockCondition = exports.updateWebhook = exports.sendWebhookTest = exports.rotateWebhookSecret = exports.lookupArticleByCode = exports.listWebhooks = exports.listWebhookDeliveries = exports.listStockMovements = exports.listStock = exports.listLocations = exports.listArticles = exports.iterateStockMovements = exports.iterateStock = exports.iterateArticles = exports.getStock = exports.getArticle = exports.deleteWebhook = exports.createWebhook = exports.isInventoryWarningCode = exports.inventoryShortfalls = exports.inventoryRetryAfterSec = exports.inventoryFieldErrors = exports.inventoryErrorCode = exports.isInventoryErrorCode = exports.isInventoryError = exports.inventoryKeyAuth = exports.createInventoryClient = void 0;
+exports.RESERVATION_MINUTES_MAX = exports.RESERVATION_MINUTES_MIN = exports.INVENTORY_IDEMPOTENCY_KEY_MAX = exports.RESERVATION_STATUSES = exports.LANDED_COST_ALLOCATIONS = exports.LANDED_COST_TYPES = exports.WITHDRAWAL_TYPES = exports.STOCK_LOSS_REASONS = exports.STOCK_KINDS = exports.INVENTORY_WARNING_CODES = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.INVENTORY_WEBHOOK_EVENTS = void 0;
 var api_js_1 = require("./api.js");
 Object.defineProperty(exports, "createInventoryClient", { enumerable: true, get: function () { return api_js_1.createInventoryClient; } });
 var auth_js_1 = require("./auth.js");
@@ -23,6 +25,8 @@ Object.defineProperty(exports, "isInventoryErrorCode", { enumerable: true, get:
 Object.defineProperty(exports, "inventoryErrorCode", { enumerable: true, get: function () { return fehler_js_1.inventoryErrorCode; } });
 Object.defineProperty(exports, "inventoryFieldErrors", { enumerable: true, get: function () { return fehler_js_1.inventoryFieldErrors; } });
 Object.defineProperty(exports, "inventoryRetryAfterSec", { enumerable: true, get: function () { return fehler_js_1.inventoryRetryAfterSec; } });
+Object.defineProperty(exports, "inventoryShortfalls", { enumerable: true, get: function () { return fehler_js_1.inventoryShortfalls; } });
+Object.defineProperty(exports, "isInventoryWarningCode", { enumerable: true, get: function () { return fehler_js_1.isInventoryWarningCode; } });
 var endpunkte_js_1 = require("./endpunkte.js");
 Object.defineProperty(exports, "createWebhook", { enumerable: true, get: function () { return endpunkte_js_1.createWebhook; } });
 Object.defineProperty(exports, "deleteWebhook", { enumerable: true, get: function () { return endpunkte_js_1.deleteWebhook; } });
@@ -41,6 +45,22 @@ Object.defineProperty(exports, "lookupArticleByCode", { enumerable: true, get: f
 Object.defineProperty(exports, "rotateWebhookSecret", { enumerable: true, get: function () { return endpunkte_js_1.rotateWebhookSecret; } });
 Object.defineProperty(exports, "sendWebhookTest", { enumerable: true, get: function () { return endpunkte_js_1.sendWebhookTest; } });
 Object.defineProperty(exports, "updateWebhook", { enumerable: true, get: function () { return endpunkte_js_1.updateWebhook; } });
+var schreiben_js_1 = require("./schreiben.js");
+Object.defineProperty(exports, "changeStockCondition", { enumerable: true, get: function () { return schreiben_js_1.changeStockCondition; } });
+Object.defineProperty(exports, "createArticle", { enumerable: true, get: function () { return schreiben_js_1.createArticle; } });
+Object.defineProperty(exports, "createReservation", { enumerable: true, get: function () { return schreiben_js_1.createReservation; } });
+Object.defineProperty(exports, "deactivateArticle", { enumerable: true, get: function () { return schreiben_js_1.deactivateArticle; } });
+Object.defineProperty(exports, "extendReservation", { enumerable: true, get: function () { return schreiben_js_1.extendReservation; } });
+Object.defineProperty(exports, "getReservation", { enumerable: true, get: function () { return schreiben_js_1.getReservation; } });
+Object.defineProperty(exports, "iterateReservations", { enumerable: true, get: function () { return schreiben_js_1.iterateReservations; } });
+Object.defineProperty(exports, "listReservations", { enumerable: true, get: function () { return schreiben_js_1.listReservations; } });
+Object.defineProperty(exports, "previewGoodsReceipt", { enumerable: true, get: function () { return schreiben_js_1.previewGoodsReceipt; } });
+Object.defineProperty(exports, "receiveGoods", { enumerable: true, get: function () { return schreiben_js_1.receiveGoods; } });
+Object.defineProperty(exports, "recordStockLoss", { enumerable: true, get: function () { return schreiben_js_1.recordStockLoss; } });
+Object.defineProperty(exports, "releaseReservation", { enumerable: true, get: function () { return schreiben_js_1.releaseReservation; } });
+Object.defineProperty(exports, "reverseStockMovement", { enumerable: true, get: function () { return schreiben_js_1.reverseStockMovement; } });
+Object.defineProperty(exports, "transferStock", { enumerable: true, get: function () { return schreiben_js_1.transferStock; } });
+Object.defineProperty(exports, "updateArticle", { enumerable: true, get: function () { return schreiben_js_1.updateArticle; } });
 var webhook_js_1 = require("./webhook.js");
 Object.defineProperty(exports, "verifyInventoryWebhookSignature", { enumerable: true, get: function () { return webhook_js_1.verifyInventoryWebhookSignature; } });
 Object.defineProperty(exports, "parseInventoryWebhookEvent", { enumerable: true, get: function () { return webhook_js_1.parseInventoryWebhookEvent; } });
@@ -62,3 +82,13 @@ Object.defineProperty(exports, "STOCK_MOVEMENT_SOURCES", { enumerable: true, get
 Object.defineProperty(exports, "STOCK_CONDITIONS", { enumerable: true, get: function () { return vertrag_js_1.STOCK_CONDITIONS; } });
 Object.defineProperty(exports, "STOCK_CHANGE_CAUSES", { enumerable: true, get: function () { return vertrag_js_1.STOCK_CHANGE_CAUSES; } });
 Object.defineProperty(exports, "WEBHOOK_DELIVERY_STATUSES", { enumerable: true, get: function () { return vertrag_js_1.WEBHOOK_DELIVERY_STATUSES; } });
+Object.defineProperty(exports, "INVENTORY_WARNING_CODES", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_WARNING_CODES; } });
+Object.defineProperty(exports, "STOCK_KINDS", { enumerable: true, get: function () { return vertrag_js_1.STOCK_KINDS; } });
+Object.defineProperty(exports, "STOCK_LOSS_REASONS", { enumerable: true, get: function () { return vertrag_js_1.STOCK_LOSS_REASONS; } });
+Object.defineProperty(exports, "WITHDRAWAL_TYPES", { enumerable: true, get: function () { return vertrag_js_1.WITHDRAWAL_TYPES; } });
+Object.defineProperty(exports, "LANDED_COST_TYPES", { enumerable: true, get: function () { return vertrag_js_1.LANDED_COST_TYPES; } });
+Object.defineProperty(exports, "LANDED_COST_ALLOCATIONS", { enumerable: true, get: function () { return vertrag_js_1.LANDED_COST_ALLOCATIONS; } });
+Object.defineProperty(exports, "RESERVATION_STATUSES", { enumerable: true, get: function () { return vertrag_js_1.RESERVATION_STATUSES; } });
+Object.defineProperty(exports, "INVENTORY_IDEMPOTENCY_KEY_MAX", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_IDEMPOTENCY_KEY_MAX; } });
+Object.defineProperty(exports, "RESERVATION_MINUTES_MIN", { enumerable: true, get: function () { return vertrag_js_1.RESERVATION_MINUTES_MIN; } });
+Object.defineProperty(exports, "RESERVATION_MINUTES_MAX", { enumerable: true, get: function () { return vertrag_js_1.RESERVATION_MINUTES_MAX; } });

package/dist/cjs/inventory/lesen.d.ts

@@ -12,7 +12,7 @@
  * wenn der Server sie sendet: „fehlt“ heisst dort „kein Recht“, nicht „leer“.
  */
 import { KasseneckValidationError } from '../client/errors.js';
-import type { Article, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookTestDelivery, Location, StockBelowMinimumEventData, StockChangedEventData, StockLevel, StockMovement, StockValue } from './typen.js';
+import type { Article, GoodsReceiptPreviewLine, InventoryShortfall, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookTestDelivery, Location, Reservation, StockBelowMinimumEventData, StockChangedEventData, StockLevel, StockMovement, StockOperation, StockValue } from './typen.js';
 type Roh = Record<string, unknown>;
 /** Ein Leser bekommt den Vorgang (fuer die Meldung) und den Pfad im Rumpf. */
 export interface Ort {
@@ -31,6 +31,13 @@ export declare function zustellung(ort: Ort, w: unknown): InventoryWebhookDelive
 export declare function probeZustellung(ort: Ort, w: unknown, webhookId: string): InventoryWebhookTestDelivery;
 export declare function bestandGeaendert(ort: Ort, w: unknown): StockChangedEventData;
 export declare function unterMindestbestand(ort: Ort, w: unknown): StockBelowMinimumEventData;
+/** Antwort einer Buchung; ohne `operationId` ist nicht belegt, dass gebucht wurde. */
+export declare function vorgang(name: string, daten: unknown): StockOperation;
+/** Eine Zeile der Wareneingangs-Vorschau; Werte nur, wenn der Server sie sendet (Recht `costs`). */
+export declare function vorschauZeile(ort: Ort, w: unknown): GoodsReceiptPreviewLine;
+export declare function reservierung(ort: Ort, w: unknown): Reservation;
+/** Die fehlenden Positionen aus `insufficient_available` (`data.details[]`); ein kaputter Eintrag faellt weg. */
+export declare function fehlmengen(roh: unknown): InventoryShortfall[];
 /** Eine zugesagte Liste `data.<feld>`, Eintrag fuer Eintrag gelesen. */
 export declare function liste<T>(name: string, daten: unknown, feld: string, lesen: (ort: Ort, e: unknown) => T): T[];
 /** Der Cursor der naechsten Seite; `null` am Ende. Etwas anderes als Text oder `null` ist kaputt. */

package/dist/cjs/inventory/lesen.js

@@ -25,6 +25,10 @@ exports.zustellung = zustellung;
 exports.probeZustellung = probeZustellung;
 exports.bestandGeaendert = bestandGeaendert;
 exports.unterMindestbestand = unterMindestbestand;
+exports.vorgang = vorgang;
+exports.vorschauZeile = vorschauZeile;
+exports.reservierung = reservierung;
+exports.fehlmengen = fehlmengen;
 exports.liste = liste;
 exports.naechsterCursor = naechsterCursor;
 const errors_js_1 = require("../client/errors.js");
@@ -75,6 +79,30 @@ function textAbbildung(w) {
             raus[k] = v;
     return raus;
 }
+/**
+ * Mengen je Standort (`minStockByLocation`): jeder Wert eine Ganzzahl. Fehlt
+ * das Feld (Server vor Stufe 5b), gilt „keiner“ (`{}`).
+ */
+function mengenJeStandort(ort, feld, w) {
+    if (w === undefined || w === null)
+        return {};
+    const o = objekt(w);
+    if (!o)
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.${feld} ist kein Objekt)`);
+    const raus = {};
+    for (const [k, v] of Object.entries(o))
+        raus[k] = ganzzahl(ort, `${feld}.${k}`, v);
+    return raus;
+}
+/** Eine Liste von Kennungen (`movementIds`, `lotIds`); fehlt sie, ist sie leer. */
+function kennungsliste(ort, feld, w) {
+    if (w === undefined || w === null)
+        return [];
+    if (!Array.isArray(w) || !w.every((x) => typeof x === 'string')) {
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}${ort.pfad ? '.' : ''}${feld} ist keine Liste von Kennungen)`);
+    }
+    return [...w];
+}
 // ---- Artikel ------------------------------------------------------------------
 function artikel(ort, w) {
     const a = eintrag(ort, w);
@@ -92,6 +120,7 @@ function artikel(ort, w) {
     const raus = {
         id: kennung(ort, 'id', a.id),
         name: text(a.name),
+        description: text(a.description),
         unitPriceCents: ganzzahlOderNull(ort, 'unitPriceCents', a.unitPriceCents),
         vatRate: typeof vatRate === 'number' ? vatRate : null,
         unit: text(a.unit),
@@ -101,8 +130,10 @@ function artikel(ort, w) {
         groupId: text(a.groupId),
         revenueGroupId: text(a.revenueGroupId),
         stockTracked: a.stockTracked === true,
+        stockKind: textOderNull(a.stockKind),
         stockLocationIds: standorte,
         minStock: ganzzahlOderNull(ort, 'minStock', a.minStock),
+        minStockByLocation: mengenJeStandort(ort, 'minStockByLocation', a.minStockByLocation),
         active: a.active !== false,
         createdAt: text(a.createdAt),
         updatedAt: text(a.updatedAt),
@@ -189,8 +220,14 @@ function bewegung(ort, w) {
         locationId: text(b.locationId),
         condition: text(b.condition),
         quantityDelta: ganzzahl(ort, 'quantityDelta', b.quantityDelta),
+        // Server vor Stufe 5b senden das Feld nicht: dort aenderte keine Bewegung `reserved`.
+        reservedDelta: b.reservedDelta === undefined ? 0 : ganzzahl(ort, 'reservedDelta', b.reservedDelta),
         stockAfter: nachher
-            ? { sellable: ganzzahl(nachherOrt, 'sellable', nachher.sellable), defective: ganzzahl(nachherOrt, 'defective', nachher.defective) }
+            ? {
+                sellable: ganzzahl(nachherOrt, 'sellable', nachher.sellable),
+                defective: ganzzahl(nachherOrt, 'defective', nachher.defective),
+                reserved: ganzzahlOderNull(nachherOrt, 'reserved', nachher.reserved),
+            }
             : null,
         operationId: text(b.operationId),
         source: quelle
@@ -271,6 +308,99 @@ function unterMindestbestand(ort, w) {
         minStock: ganzzahl(ort, 'minStock', d.minStock),
     };
 }
+// ---- Schreiben (Stufe 5b) ------------------------------------------------------------
+function warnung(ort, w) {
+    const h = eintrag(ort, w);
+    if (typeof h.code !== 'string' || h.code === '')
+        throw antwortfehler(ort.name, `Hinweis ohne Code (data.${ort.pfad}.code)`);
+    return {
+        code: h.code,
+        articleId: textOderNull(h.articleId),
+        locationId: textOderNull(h.locationId),
+        message: typeof h.message === 'string' ? h.message : '',
+    };
+}
+/** Antwort einer Buchung; ohne `operationId` ist nicht belegt, dass gebucht wurde. */
+function vorgang(name, daten) {
+    const d = objekt(daten);
+    if (!d)
+        throw antwortfehler(name, 'Antwort ist unbrauchbar (data ist kein Objekt)');
+    const ort = { name, pfad: '' };
+    if (typeof d.operationId !== 'string' || d.operationId === '') {
+        throw antwortfehler(name, 'Antwort enthaelt keine Kennung (data.operationId fehlt)');
+    }
+    const hinweise = d.warnings === undefined || d.warnings === null ? [] : d.warnings;
+    if (!Array.isArray(hinweise))
+        throw antwortfehler(name, 'Antwort ist unbrauchbar (data.warnings ist keine Liste)');
+    return {
+        operationId: d.operationId,
+        movementIds: kennungsliste(ort, 'movementIds', d.movementIds),
+        lotIds: kennungsliste(ort, 'lotIds', d.lotIds),
+        warnings: hinweise.map((h, i) => warnung({ name, pfad: `warnings[${i}]` }, h)),
+    };
+}
+/** Eine Zeile der Wareneingangs-Vorschau; Werte nur, wenn der Server sie sendet (Recht `costs`). */
+function vorschauZeile(ort, w) {
+    const z = eintrag(ort, w);
+    const serien = z.serialNumbers === undefined || z.serialNumbers === null ? [] : z.serialNumbers;
+    if (!Array.isArray(serien) || !serien.every((x) => typeof x === 'string')) {
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.serialNumbers ist keine Liste)`);
+    }
+    const raus = {
+        articleId: kennung(ort, 'articleId', z.articleId),
+        quantity: ganzzahl(ort, 'quantity', z.quantity),
+        expiresOn: textOderNull(z.expiresOn),
+        batch: textOderNull(z.batch),
+        serialNumbers: [...serien],
+        priceFromArticle: z.priceFromArticle === true,
+    };
+    for (const feld of ['baseCents', 'landedCostCents', 'valueCents', 'unitCostMicros']) {
+        if (hat(z, feld))
+            raus[feld] = ganzzahlOderNull(ort, feld, z[feld]);
+    }
+    return raus;
+}
+function reservierungsPosition(ort, w) {
+    const p = eintrag(ort, w);
+    return {
+        articleId: kennung(ort, 'articleId', p.articleId),
+        locationId: kennung(ort, 'locationId', p.locationId),
+        quantity: ganzzahl(ort, 'quantity', p.quantity),
+        redeemed: ganzzahl(ort, 'redeemed', p.redeemed),
+        released: ganzzahl(ort, 'released', p.released),
+    };
+}
+function reservierung(ort, w) {
+    const r = eintrag(ort, w);
+    if (!Array.isArray(r.items))
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.items ist keine Liste)`);
+    return {
+        id: kennung(ort, 'id', r.id),
+        status: textOderNull(r.status),
+        reference: text(r.reference),
+        items: r.items.map((p, i) => reservierungsPosition({ name: ort.name, pfad: `${ort.pfad}.items[${i}]` }, p)),
+        expiresAt: text(r.expiresAt),
+        createdAt: text(r.createdAt),
+    };
+}
+/** Die fehlenden Positionen aus `insufficient_available` (`data.details[]`); ein kaputter Eintrag faellt weg. */
+function fehlmengen(roh) {
+    if (!Array.isArray(roh))
+        return [];
+    const raus = [];
+    for (const e of roh) {
+        const o = objekt(e);
+        if (!o)
+            continue;
+        const { articleId, locationId, requested, available } = o;
+        if (typeof articleId !== 'string' || typeof locationId !== 'string')
+            continue;
+        if (!Number.isSafeInteger(requested) || !Number.isSafeInteger(available))
+            continue;
+        raus.push({ articleId, locationId, requested: requested, available: available });
+    }
+    return raus;
+}
 // ---- Listen ------------------------------------------------------------------
 /** Eine zugesagte Liste `data.<feld>`, Eintrag fuer Eintrag gelesen. */
 function liste(name, daten, feld, lesen) {

package/dist/cjs/inventory/schreiben.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Die schreibenden Aufrufe der Lager-API (Backend Stufe 5b): Artikel anlegen,
+ * aendern und stilllegen, Bestand buchen (Wareneingang, Umbuchung, Abgang,
+ * Zustand, Gegenbuchung) und reservieren.
+ *
+ * Wie in `endpunkte.ts` nimmt jede Funktion den Transport als ersten Parameter
+ * und ist einzeln importierbar. Die Anfrage geht flach hinaus, genau mit den
+ * Feldern, die der Aufrufer nennt (`undefined` faellt weg, `null` bleibt: es
+ * leert ein Feld bzw. heisst bei der Anlage „nicht angegeben“).
+ *
+ * **Vor dem Senden geprueft wird nur, was ohne Netz sicher falsch ist:**
+ * - `idempotencyKey` fehlt, ist leer oder laenger als 120 Zeichen. Ohne
+ *   Schluessel gaebe es keine sichere Wiederholung, und der Server wiese die
+ *   Anfrage ohnehin ab (`idempotency_key_required` bzw. `validation`);
+ * - eine Pflichtkennung fehlt oder ist leer;
+ * - eine Menge, ein Betrag oder ein Preis ist keine Ganzzahl (Tausendstel,
+ *   Cent, Mikro-Euro): `1.5` waere nie „1,5 Stueck“, sondern ein Fehler;
+ * - `expiresInMinutes` liegt ausserhalb 5 … 43 200;
+ * - eine Aenderung nennt kein Feld, eine Freigabe eine leere Liste.
+ * Alles Fachliche (Pruefziffer der EAN, Kataloge, Bestand, Rechte) prueft der
+ * Server und meldet es mit seinem Code.
+ *
+ * **Wiederholen:** nach einem Zeitlimit oder Netzfehler denselben Aufruf mit
+ * **demselben** `idempotencyKey` noch einmal senden. Er wirkt genau einmal und
+ * liefert die gespeicherte Antwort; ein neuer Schluessel buchte ein zweites Mal.
+ */
+import type { InternerTransport } from '../client/aufrufe.js';
+import type { Article, ChangeStockConditionRequest, CreateArticleRequest, CreateReservationRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptPreview, GoodsReceiptPreviewRequest, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationRequest, Reservation, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockOperation, TransferStockRequest, UpdateArticleRequest } from './typen.js';
+/**
+ * Legt einen Artikel an. Mit `ean` ein Fremdartikel mit diesem Code (gueltige
+ * Pruefziffer, frei im Konto), sonst vergibt der Server den naechsten eigenen
+ * Code. Antwort: der Artikel wie `getArticle`.
+ */
+export declare function createArticle(transport: InternerTransport, request: CreateArticleRequest): Promise<Article>;
+/** Aendert nur die genannten Felder eines Artikels (siehe [UpdateArticleRequest]). */
+export declare function updateArticle(transport: InternerTransport, request: UpdateArticleRequest): Promise<Article>;
+/** Legt einen Artikel still (`active: false`); Code und eigene Kennungen werden frei. */
+export declare function deactivateArticle(transport: InternerTransport, request: DeactivateArticleRequest): Promise<Article>;
+/**
+ * Bucht einen Wareneingang. Ohne `locationId` am Standard-Standort; die
+ * Antwort traegt keine Werte, auch mit dem Recht `costs` nicht. Fuer die
+ * Vorschau mit Werten: [previewGoodsReceipt].
+ */
+export declare function receiveGoods(transport: InternerTransport, request: ReceiveGoodsRequest): Promise<StockOperation>;
+/**
+ * Vorschau eines Wareneingangs (`receiveGoods` mit `dryRun: true`): prueft
+ * Positionen, Artikel, Preise und Nebenkosten und rechnet die Verteilung,
+ * schreibt aber nichts. Ein `idempotencyKey` ist freigestellt (`null` wie nicht
+ * angegeben, geht nicht hinaus) und wird nicht verbraucht; dieselbe Anfrage
+ * laesst sich danach mit ihm buchen. Werte
+ * (`baseCents` …) nur mit dem Recht `costs`. Den Standort prueft erst die Buchung.
+ */
+export declare function previewGoodsReceipt(transport: InternerTransport, request: GoodsReceiptPreviewRequest): Promise<GoodsReceiptPreview>;
+/** Bucht Ware von einem Standort an einen anderen; ueberzieht nie (`exceeds_stock`). */
+export declare function transferStock(transport: InternerTransport, request: TransferStockRequest): Promise<StockOperation>;
+/** Bucht einen Abgang (Bruch, Schwund, Diebstahl, Entnahme …); ueberzieht nie (`exceeds_stock`). */
+export declare function recordStockLoss(transport: InternerTransport, request: RecordStockLossRequest): Promise<StockOperation>;
+/** Bucht Ware zwischen `sellable` und `defective` um; ueberzieht nie (`exceeds_stock`). */
+export declare function changeStockCondition(transport: InternerTransport, request: ChangeStockConditionRequest): Promise<StockOperation>;
+/** Nimmt einen ganzen Vorgang (`operationId`) mit einer Gegenbuchung zurueck. */
+export declare function reverseStockMovement(transport: InternerTransport, request: ReverseStockMovementRequest): Promise<StockOperation>;
+/**
+ * Reserviert Ware (Checkout im Shop): ganz oder gar nicht, gemessen am
+ * verfuegbaren Bestand (`onHand − reserved`). Fehlt etwas, entsteht nichts:
+ * `insufficient_available`, die fehlenden Positionen in [inventoryShortfalls].
+ * Eingeloest wird ueber eine Rechnung (`issueInvoice` mit `items[].reservationId`),
+ * sonst laeuft die Reservierung ab und gibt die Ware wieder frei.
+ */
+export declare function createReservation(transport: InternerTransport, request: CreateReservationRequest): Promise<Reservation>;
+/** Verlaengert eine aktive Reservierung: neuer Ablauf = jetzt + `expiresInMinutes`. */
+export declare function extendReservation(transport: InternerTransport, request: ExtendReservationRequest): Promise<Reservation>;
+/**
+ * Gibt reservierte Ware frei: ohne `items` alles, sonst je Position (ohne
+ * `quantity` der ganze offene Rest). Die Antwort traegt den Stand danach;
+ * `released` wird der Status erst, wenn nichts mehr offen ist.
+ */
+export declare function releaseReservation(transport: InternerTransport, request: ReleaseReservationRequest): Promise<Reservation>;
+/** Eine Reservierung mit ihrem aktuellen Stand. */
+export declare function getReservation(transport: InternerTransport, reservationId: string): Promise<Reservation>;
+/** Reservierungen, neueste zuerst; Filter `status` und/oder `reference`. */
+export declare function listReservations(transport: InternerTransport, query?: ReservationListQuery): Promise<ReservationPage>;
+/** Alle Reservierungen der Abfrage, Seite fuer Seite ueber `nextCursor`. */
+export declare function iterateReservations(transport: InternerTransport, query?: ReservationListQuery): AsyncGenerator<Reservation, void, undefined>;