@kreiseck/kasseneck-api 1.5.0 → 1.6.0

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

@@ -1,10 +1,10 @@
 /**
  * Fassade ueber den Aufrufen der Lager-API (lesen, Webhooks, schreiben,
- * reservieren): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
+ * reservieren, Varianten): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
  * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
  */
 import { type FetchLike } from '../client/transport.js';
-import type { Article, ChangeStockConditionRequest, CreateArticleRequest, CreateReservationRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptPreview, GoodsReceiptPreviewRequest, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationRequest, Reservation, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockOperation, TransferStockRequest, UpdateArticleRequest, ArticleListQuery, ArticleLookup, ArticlePage, CreateInventoryWebhookOptions, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookList, InventoryWebhookPatch, InventoryWebhookTestResult, InventoryWebhookWithSecret, Location, StockLevel, StockListQuery, StockMovement, StockMovementPage, StockMovementQuery, StockPage, StockResult } from './typen.js';
+import type { AddVariantRequest, CreateVariantGroupRequest, UpdateVariantGroupRequest, VariantGroup, VariantGroupListQuery, VariantGroupPage, Article, ChangeStockConditionRequest, CreateArticleRequest, CreateReservationRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptPreview, GoodsReceiptPreviewRequest, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationRequest, Reservation, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockOperation, TransferStockRequest, UpdateArticleRequest, ArticleListQuery, ArticleLookup, ArticlePage, CreateInventoryWebhookOptions, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookList, InventoryWebhookPatch, InventoryWebhookTestResult, InventoryWebhookWithSecret, Location, StockLevel, StockListQuery, StockMovement, StockMovementPage, StockMovementQuery, StockPage, StockResult } from './typen.js';
 import type { InventoryWebhookEventType } from './vertrag.js';
 export interface InventoryClientOptions {
     /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
@@ -57,5 +57,13 @@ export interface InventoryClient {
     getReservation(reservationId: string): Promise<Reservation>;
     listReservations(query?: ReservationListQuery): Promise<ReservationPage>;
     iterateReservations(query?: ReservationListQuery): AsyncGenerator<Reservation, void, undefined>;
+    createVariantGroup(request: CreateVariantGroupRequest): Promise<VariantGroup>;
+    /** Name, Vorgaben, neue Werte; oder `active: false` (Gruppe und alle Varianten stilllegen, endgueltig). */
+    updateVariantGroup(request: UpdateVariantGroupRequest): Promise<VariantGroup>;
+    /** Eine Variante mehr; Antwort: der Artikel wie `createArticle`. */
+    addVariant(request: AddVariantRequest): Promise<Article>;
+    getVariantGroup(variantGroupId: string): Promise<VariantGroup>;
+    listVariantGroups(query?: VariantGroupListQuery): Promise<VariantGroupPage>;
+    iterateVariantGroups(query?: VariantGroupListQuery): AsyncGenerator<VariantGroup, void, undefined>;
 }
 export declare function createInventoryClient(options: InventoryClientOptions): InventoryClient;

package/dist/cjs/inventory/api.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Fassade ueber den Aufrufen der Lager-API (lesen, Webhooks, schreiben,
- * reservieren): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
+ * reservieren, Varianten): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
  * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -10,6 +10,7 @@ const transport_js_1 = require("../client/transport.js");
 const auth_js_1 = require("./auth.js");
 const endpunkte_js_1 = require("./endpunkte.js");
 const schreiben_js_1 = require("./schreiben.js");
+const varianten_js_1 = require("./varianten.js");
 function createInventoryClient(options) {
     const rufen = (0, transport_js_1.createTransport)({
         auth: (0, auth_js_1.inventoryKeyAuth)({ apiKey: options.apiKey }),
@@ -50,5 +51,11 @@ function createInventoryClient(options) {
         getReservation: (id) => (0, schreiben_js_1.getReservation)(rufen, id),
         listReservations: (q) => (0, schreiben_js_1.listReservations)(rufen, q),
         iterateReservations: (q) => (0, schreiben_js_1.iterateReservations)(rufen, q),
+        createVariantGroup: (r) => (0, varianten_js_1.createVariantGroup)(rufen, r),
+        updateVariantGroup: (r) => (0, varianten_js_1.updateVariantGroup)(rufen, r),
+        addVariant: (r) => (0, varianten_js_1.addVariant)(rufen, r),
+        getVariantGroup: (id) => (0, varianten_js_1.getVariantGroup)(rufen, id),
+        listVariantGroups: (q) => (0, varianten_js_1.listVariantGroups)(rufen, q),
+        iterateVariantGroups: (q) => (0, varianten_js_1.iterateVariantGroups)(rufen, q),
     };
 }

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

@@ -1,7 +1,8 @@
 /**
  * Die Aufrufe der Lager-API: Artikel, Standorte, Bestand und Bewegungen
  * lesen, Konto-Webhooks verwalten (Backend Stufe 5a). Die schreibenden
- * Aufrufe (Stufe 5b) stehen in `schreiben.ts` und teilen die Helfer hier.
+ * Aufrufe (Stufe 5b) stehen in `schreiben.ts`, die Variantengruppen (Stufe 5c)
+ * in `varianten.ts`; beide teilen die Helfer hier.
  *
  * Jede Funktion nimmt den Transport als ersten Parameter und ist einzeln
  * importierbar; die Fassade [createInventoryClient] bindet ihn nur einmal.

package/dist/cjs/inventory/endpunkte.js

@@ -2,7 +2,8 @@
 /**
  * Die Aufrufe der Lager-API: Artikel, Standorte, Bestand und Bewegungen
  * lesen, Konto-Webhooks verwalten (Backend Stufe 5a). Die schreibenden
- * Aufrufe (Stufe 5b) stehen in `schreiben.ts` und teilen die Helfer hier.
+ * Aufrufe (Stufe 5b) stehen in `schreiben.ts`, die Variantengruppen (Stufe 5c)
+ * in `varianten.ts`; beide teilen die Helfer hier.
  *
  * Jede Funktion nimmt den Transport als ersten Parameter und ist einzeln
  * importierbar; die Fassade [createInventoryClient] bindet ihn nur einmal.

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

@@ -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); Artikel anlegen und aendern,
- * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0).
+ * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0);
+ * Variantengruppen (Stufe 5c, seit 1.6.0).
  *
  * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
  * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
@@ -16,6 +17,7 @@ export { inventoryKeyAuth, type InventoryKeyAuthOptions } from './auth.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 { addVariant, createVariantGroup, getVariantGroup, iterateVariantGroups, listVariantGroups, updateVariantGroup, } from './varianten.js';
 export { verifyInventoryWebhookSignature, parseInventoryWebhookEvent, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, type VerifyInventoryWebhookOptions, } from './webhook.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';
+export type { AddVariantRequest, Article, ArticleInput, ArticleListQuery, ArticleLookup, ArticlePage, ChangeStockConditionRequest, CreateArticleRequest, CreateInventoryWebhookOptions, CreateReservationRequest, CreateVariantGroupRequest, 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, UpdateVariantGroupRequest, VariantAttribute, VariantGroup, VariantGroupDefaults, VariantGroupDefaultsInput, VariantGroupListQuery, VariantGroupMember, VariantGroupPage, VariantInput, } 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, VARIANT_ATTRIBUTES_MAX, VARIANT_VALUES_MAX, VARIANT_MATRIX_MAX, VARIANT_GROUP_ACTIVE_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

@@ -3,7 +3,8 @@
  * `@kreiseck/kasseneck-api/inventory` – die Lager-API: Artikel, Standorte,
  * Bestand und Lagerprotokoll lesen, Konto-Webhooks verwalten und eingehende
  * Zustellungen pruefen (Backend Stufe 5a); Artikel anlegen und aendern,
- * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0).
+ * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0);
+ * Variantengruppen (Stufe 5c, seit 1.6.0).
  *
  * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
  * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
@@ -13,8 +14,8 @@
  * Mikro-Euro; alles Ganzzahlen.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.WEBHOOK_SIGNATURE_HEADER = exports.parseInventoryWebhookEvent = exports.verifyInventoryWebhookSignature = exports.updateVariantGroup = exports.listVariantGroups = exports.iterateVariantGroups = exports.getVariantGroup = exports.createVariantGroup = exports.addVariant = 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.VARIANT_GROUP_ACTIVE_MAX = exports.VARIANT_MATRIX_MAX = exports.VARIANT_VALUES_MAX = exports.VARIANT_ATTRIBUTES_MAX = 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 = exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_ENDPOINTS = exports.WEBHOOK_TOLERANCE_SEC = exports.WEBHOOK_DELIVERY_HEADER = exports.WEBHOOK_EVENT_HEADER = 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");
@@ -61,6 +62,13 @@ Object.defineProperty(exports, "releaseReservation", { enumerable: true, get: fu
 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 varianten_js_1 = require("./varianten.js");
+Object.defineProperty(exports, "addVariant", { enumerable: true, get: function () { return varianten_js_1.addVariant; } });
+Object.defineProperty(exports, "createVariantGroup", { enumerable: true, get: function () { return varianten_js_1.createVariantGroup; } });
+Object.defineProperty(exports, "getVariantGroup", { enumerable: true, get: function () { return varianten_js_1.getVariantGroup; } });
+Object.defineProperty(exports, "iterateVariantGroups", { enumerable: true, get: function () { return varianten_js_1.iterateVariantGroups; } });
+Object.defineProperty(exports, "listVariantGroups", { enumerable: true, get: function () { return varianten_js_1.listVariantGroups; } });
+Object.defineProperty(exports, "updateVariantGroup", { enumerable: true, get: function () { return varianten_js_1.updateVariantGroup; } });
 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; } });
@@ -92,3 +100,7 @@ Object.defineProperty(exports, "RESERVATION_STATUSES", { enumerable: true, get:
 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; } });
+Object.defineProperty(exports, "VARIANT_ATTRIBUTES_MAX", { enumerable: true, get: function () { return vertrag_js_1.VARIANT_ATTRIBUTES_MAX; } });
+Object.defineProperty(exports, "VARIANT_VALUES_MAX", { enumerable: true, get: function () { return vertrag_js_1.VARIANT_VALUES_MAX; } });
+Object.defineProperty(exports, "VARIANT_MATRIX_MAX", { enumerable: true, get: function () { return vertrag_js_1.VARIANT_MATRIX_MAX; } });
+Object.defineProperty(exports, "VARIANT_GROUP_ACTIVE_MAX", { enumerable: true, get: function () { return vertrag_js_1.VARIANT_GROUP_ACTIVE_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, GoodsReceiptPreviewLine, InventoryShortfall, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookTestDelivery, Location, Reservation, StockBelowMinimumEventData, StockChangedEventData, StockLevel, StockMovement, StockOperation, StockValue } from './typen.js';
+import type { Article, GoodsReceiptPreviewLine, InventoryShortfall, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookTestDelivery, Location, Reservation, StockBelowMinimumEventData, StockChangedEventData, StockLevel, StockMovement, StockOperation, StockValue, VariantGroup } from './typen.js';
 type Roh = Record<string, unknown>;
 /** Ein Leser bekommt den Vorgang (fuer die Meldung) und den Pfad im Rumpf. */
 export interface Ort {
@@ -38,6 +38,12 @@ export declare function vorschauZeile(ort: Ort, w: unknown): GoodsReceiptPreview
 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 Variantengruppe. `attributes` und `variants` sind zugesagte Listen:
+ * fehlen sie, ist die Antwort kaputt (eine leere Liste hiesse „keine Merkmale“
+ * bzw. „keine Varianten“).
+ */
+export declare function variantengruppe(ort: Ort, w: unknown): VariantGroup;
 /** 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

@@ -29,6 +29,7 @@ exports.vorgang = vorgang;
 exports.vorschauZeile = vorschauZeile;
 exports.reservierung = reservierung;
 exports.fehlmengen = fehlmengen;
+exports.variantengruppe = variantengruppe;
 exports.liste = liste;
 exports.naechsterCursor = naechsterCursor;
 const errors_js_1 = require("../client/errors.js");
@@ -401,6 +402,80 @@ function fehlmengen(roh) {
     }
     return raus;
 }
+// ---- Varianten (Stufe 5c) ------------------------------------------------------------
+/** Eine Liste von Texten (Werte eines Merkmals); etwas anderes ist kaputt. */
+function textliste(ort, feld, w) {
+    if (!Array.isArray(w) || !w.every((x) => typeof x === 'string')) {
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.${feld} ist keine Liste von Texten)`);
+    }
+    return [...w];
+}
+function merkmal(ort, w) {
+    const m = eintrag(ort, w);
+    return { key: kennung(ort, 'key', m.key), label: typeof m.label === 'string' ? m.label : '', values: textliste(ort, 'values', m.values) };
+}
+/**
+ * Vorgaben einer Gruppe: nur die Felder, die der Server sendet. Ein Preis als
+ * Bruchzahl ist kaputt (er fuellte sonst jede neue Variante falsch), ein Feld
+ * mit fremdem Typ ebenso.
+ */
+function vorgaben(ort, w) {
+    if (w === undefined || w === null)
+        return {};
+    const v = objekt(w);
+    const vOrt = { name: ort.name, pfad: `${ort.pfad}.defaults` };
+    if (!v)
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${vOrt.pfad} ist kein Objekt)`);
+    const raus = {};
+    if (v.unitPriceCents !== undefined && v.unitPriceCents !== null)
+        raus.unitPriceCents = ganzzahl(vOrt, 'unitPriceCents', v.unitPriceCents);
+    if (v.vatRate !== undefined && v.vatRate !== null) {
+        if (typeof v.vatRate !== 'number' || !Number.isFinite(v.vatRate))
+            throw antwortfehler(ort.name, `Antwort enthaelt keinen USt-Satz (data.${vOrt.pfad}.vatRate)`);
+        raus.vatRate = v.vatRate;
+    }
+    for (const feld of ['unit', 'groupId']) {
+        const t = v[feld];
+        if (t === undefined || t === null)
+            continue;
+        if (typeof t !== 'string')
+            throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${vOrt.pfad}.${feld} ist kein Text)`);
+        raus[feld] = t;
+    }
+    if (v.stockTracked !== undefined && v.stockTracked !== null) {
+        if (typeof v.stockTracked !== 'boolean')
+            throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${vOrt.pfad}.stockTracked ist kein Wahrheitswert)`);
+        raus.stockTracked = v.stockTracked;
+    }
+    return raus;
+}
+function mitglied(ort, w) {
+    const x = eintrag(ort, w);
+    return { articleId: kennung(ort, 'articleId', x.articleId), variantAttributes: textAbbildung(x.variantAttributes) ?? {} };
+}
+/**
+ * Eine Variantengruppe. `attributes` und `variants` sind zugesagte Listen:
+ * fehlen sie, ist die Antwort kaputt (eine leere Liste hiesse „keine Merkmale“
+ * bzw. „keine Varianten“).
+ */
+function variantengruppe(ort, w) {
+    const g = eintrag(ort, w);
+    for (const feld of ['attributes', 'variants']) {
+        if (!Array.isArray(g[feld]))
+            throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.${feld} ist keine Liste)`);
+    }
+    const unter = (feld, i) => ({ name: ort.name, pfad: `${ort.pfad}.${feld}[${i}]` });
+    return {
+        id: kennung(ort, 'id', g.id),
+        name: text(g.name),
+        attributes: g.attributes.map((m, i) => merkmal(unter('attributes', i), m)),
+        defaults: vorgaben(ort, g.defaults),
+        active: g.active !== false,
+        variants: g.variants.map((x, i) => mitglied(unter('variants', i), x)),
+        createdAt: text(g.createdAt),
+        updatedAt: text(g.updatedAt),
+    };
+}
 // ---- Listen ------------------------------------------------------------------
 /** Eine zugesagte Liste `data.<feld>`, Eintrag fuer Eintrag gelesen. */
 function liste(name, daten, feld, lesen) {

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

@@ -23,9 +23,33 @@
  * **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.
+ * Darum meldet jeder schreibende Aufruf in diesen Faellen (auch HTTP 5xx und
+ * unlesbare Antwort) `outcome: 'unknown'`, nie `'rejected'`. Lesen und der
+ * Probelauf (`previewGoodsReceipt`) bleiben `'rejected'`.
  */
-import type { InternerTransport } from '../client/aufrufe.js';
+import type { ApiCall, 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';
+type Params = Record<string, unknown>;
+/** Die Anfrage als flache Kopie ohne `undefined`; der Aufrufer behaelt sein Objekt. Paketintern, auch fuer `varianten.ts`. */
+export declare function anfrage(name: ApiCall, request: unknown): Params;
+/**
+ * `idempotencyKey`: Text mit 1–120 Zeichen, nicht nur Leerraum. Er wird nie
+ * getrimmt oder gekuerzt: ein veraenderter Schluessel waere ein anderer.
+ */
+export declare function schluessel(name: ApiCall, p: Params, { pflicht }: {
+    pflicht: boolean;
+}): void;
+/** Eine Ganzzahl (Tausendstel, Cent, Mikro-Euro); fehlt sie, nur wenn sie darf. `null` nur, wo es leert. */
+export declare function ganz(name: ApiCall, feld: string, w: unknown, { pflicht, leerbar }?: {
+    pflicht?: boolean | undefined;
+    leerbar?: boolean | undefined;
+}): void;
+/**
+ * Zahlenfelder eines Artikels; `null` leert sie (bzw. heisst bei der Anlage
+ * „nicht angegeben“). `praefix` nennt die Stelle in der Anfrage (`variants[2].`).
+ */
+export declare function artikelZahlen(name: ApiCall, p: Params, praefix?: string): void;
+export declare const artikelAus: (name: ApiCall, daten: unknown) => Article;
 /**
  * Legt einen Artikel an. Mit `ean` ein Fremdartikel mit diesem Code (gueltige
  * Pruefziffer, frei im Konto), sonst vergibt der Server den naechsten eigenen
@@ -81,3 +105,4 @@ export declare function getReservation(transport: InternerTransport, reservation
 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>;
+export {};

package/dist/cjs/inventory/schreiben.js

@@ -24,8 +24,16 @@
  * **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.
+ * Darum meldet jeder schreibende Aufruf in diesen Faellen (auch HTTP 5xx und
+ * unlesbare Antwort) `outcome: 'unknown'`, nie `'rejected'`. Lesen und der
+ * Probelauf (`previewGoodsReceipt`) bleiben `'rejected'`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.artikelAus = void 0;
+exports.anfrage = anfrage;
+exports.schluessel = schluessel;
+exports.ganz = ganz;
+exports.artikelZahlen = artikelZahlen;
 exports.createArticle = createArticle;
 exports.updateArticle = updateArticle;
 exports.deactivateArticle = deactivateArticle;
@@ -45,7 +53,7 @@ const endpunkte_js_1 = require("./endpunkte.js");
 const lesen_js_1 = require("./lesen.js");
 const vertrag_js_1 = require("./vertrag.js");
 // ---- Pruefung vor dem Senden ------------------------------------------------------
-/** Die Anfrage als flache Kopie ohne `undefined`; der Aufrufer behaelt sein Objekt. */
+/** Die Anfrage als flache Kopie ohne `undefined`; der Aufrufer behaelt sein Objekt. Paketintern, auch fuer `varianten.ts`. */
 function anfrage(name, request) {
     if (request === null || typeof request !== 'object' || Array.isArray(request)) {
         throw (0, endpunkte_js_1.anfragefehler)(name, 'Anfrage muss ein Objekt sein');
@@ -121,19 +129,23 @@ function positionen(name, w, { pflicht, menge }, weiter = () => { }) {
     });
 }
 // ---- Artikel ------------------------------------------------------------------
-/** Zahlenfelder eines Artikels; `null` leert sie (bzw. heisst bei der Anlage „nicht angegeben“). */
-function artikelZahlen(name, p) {
+/**
+ * Zahlenfelder eines Artikels; `null` leert sie (bzw. heisst bei der Anlage
+ * „nicht angegeben“). `praefix` nennt die Stelle in der Anfrage (`variants[2].`).
+ */
+function artikelZahlen(name, p, praefix = '') {
     for (const feld of ['unitPriceCents', 'minStock', 'purchasePriceMicros'])
-        ganz(name, feld, p[feld], { leerbar: true });
+        ganz(name, `${praefix}${feld}`, p[feld], { leerbar: true });
     const jeStandort = p.minStockByLocation;
     if (jeStandort === undefined || jeStandort === null)
         return;
     if (typeof jeStandort !== 'object' || Array.isArray(jeStandort))
-        throw (0, endpunkte_js_1.anfragefehler)(name, 'minStockByLocation muss ein Objekt { standort: Tausendstel } sein');
+        throw (0, endpunkte_js_1.anfragefehler)(name, `${praefix}minStockByLocation muss ein Objekt { standort: Tausendstel } sein`);
     for (const [standort, w] of Object.entries(jeStandort))
-        ganz(name, `minStockByLocation.${standort}`, w, { leerbar: true });
+        ganz(name, `${praefix}minStockByLocation.${standort}`, w, { leerbar: true });
 }
 const artikelAus = (name, daten) => (0, lesen_js_1.artikel)({ name, pfad: 'article' }, (0, lesen_js_1.objekt)(daten)?.article);
+exports.artikelAus = artikelAus;
 /**
  * Legt einen Artikel an. Mit `ean` ein Fremdartikel mit diesem Code (gueltige
  * Pruefziffer, frei im Konto), sonst vergibt der Server den naechsten eigenen
@@ -144,7 +156,7 @@ async function createArticle(transport, request) {
     const p = anfrage(name, request);
     schluessel(name, p, { pflicht: true });
     artikelZahlen(name, p);
-    return artikelAus(name, await transport(name, p));
+    return (0, exports.artikelAus)(name, await transport(name, p));
 }
 /** Aendert nur die genannten Felder eines Artikels (siehe [UpdateArticleRequest]). */
 async function updateArticle(transport, request) {
@@ -156,7 +168,7 @@ async function updateArticle(transport, request) {
         throw (0, endpunkte_js_1.anfragefehler)(name, 'die Aenderung nennt kein Feld');
     }
     artikelZahlen(name, p);
-    return artikelAus(name, await transport(name, p));
+    return (0, exports.artikelAus)(name, await transport(name, p));
 }
 /** Legt einen Artikel still (`active: false`); Code und eigene Kennungen werden frei. */
 async function deactivateArticle(transport, request) {
@@ -164,7 +176,7 @@ async function deactivateArticle(transport, request) {
     const p = anfrage(name, request);
     schluessel(name, p, { pflicht: true });
     (0, endpunkte_js_1.kennung)(name, 'articleId', p.articleId);
-    return artikelAus(name, await transport(name, p));
+    return (0, exports.artikelAus)(name, await transport(name, p));
 }
 // ---- Buchen ------------------------------------------------------------------
 function eingangZahlen(name, p) {
@@ -214,7 +226,9 @@ async function previewGoodsReceipt(transport, request) {
         delete p.idempotencyKey;
     schluessel(name, p, { pflicht: false });
     eingangZahlen(name, p);
-    const daten = await transport(name, { ...p, dryRun: true });
+    // Ein Probelauf schreibt nichts: nach einem Zeitlimit bleibt er `rejected`,
+    // obwohl `receiveGoods` sonst Wirkung hat.
+    const daten = await transport(name, { ...p, dryRun: true }, undefined, undefined, { hasEffect: false });
     return { preview: (0, lesen_js_1.liste)(name, daten, 'preview', lesen_js_1.vorschauZeile) };
 }
 const stueckPositionen = (name, p) => positionen(name, p.items, { pflicht: true, menge: 'pflicht' });

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

@@ -19,7 +19,7 @@ import type { InventoryWarningCode, InventoryWebhookEventType, LandedCostAllocat
  * `purchasePriceMicros` nur mit dem Recht `costs` (Konto-Schalter
  * `lagerApi.kosten`, sonst fehlt das Feld, nicht `null`), `externalIds`,
  * `metadata`, `variantGroupId` und `variantAttributes` nur, wenn der Artikel
- * sie traegt.
+ * sie traegt (eine Variante, siehe [VariantGroup]).
  */
 export interface Article {
     id: string;
@@ -59,7 +59,14 @@ export interface Article {
     active: boolean;
     externalIds?: Record<string, string>;
     metadata?: Record<string, string>;
+    /** Nur an einer Variante: die Variantengruppe. Gesetzt nur ueber `createVariantGroup`/`addVariant`, nie umgehaengt. */
     variantGroupId?: string;
+    /**
+     * Nur an einer Variante: je Merkmal der Gruppe genau ein Wert
+     * (`{ farbe: 'rot', groesse: 'S' }`). Die Schluessel kommen nach Codepunkt
+     * sortiert, nicht in der Merkmalsreihenfolge der Gruppe; die steht in
+     * [VariantGroup.attributes].
+     */
     variantAttributes?: Record<string, string>;
     createdAt: string | null;
     updatedAt: string | null;
@@ -78,6 +85,12 @@ export interface ArticleListQuery {
      */
     updatedSince?: string | Date;
     groupId?: string;
+    /**
+     * Nur die Varianten dieser Gruppe (Backend ab Stufe 5c), wie ohne Filter
+     * nach `updatedAt` aufsteigend; mit `updatedSince` der Abgleich
+     * einer Gruppe. Die Artikel einer neuen Gruppe liest man so, die Antwort von
+     * `createVariantGroup` traegt nur ihre Kennungen.
+     */
     variantGroupId?: string;
     active?: boolean;
     stockTracked?: boolean;
@@ -342,7 +355,7 @@ export interface InventoryWebhookEnvelope<T extends InventoryWebhookEventType, D
     test: boolean;
     data: D;
 }
-export type InventoryWebhookEvent = InventoryWebhookEnvelope<'stock.changed', StockChangedEventData> | InventoryWebhookEnvelope<'stock.below_minimum', StockBelowMinimumEventData> | InventoryWebhookEnvelope<'article.created', Article> | InventoryWebhookEnvelope<'article.updated', Article> | InventoryWebhookEnvelope<'article.deactivated', Article> | InventoryWebhookEnvelope<'reservation.expired', Reservation> | InventoryWebhookEnvelope<'reservation.released', Reservation> | InventoryWebhookEnvelope<'reservation.redeemed', Reservation>;
+export type InventoryWebhookEvent = InventoryWebhookEnvelope<'stock.changed', StockChangedEventData> | InventoryWebhookEnvelope<'stock.below_minimum', StockBelowMinimumEventData> | InventoryWebhookEnvelope<'article.created', Article> | InventoryWebhookEnvelope<'article.updated', Article> | InventoryWebhookEnvelope<'article.deactivated', Article> | InventoryWebhookEnvelope<'reservation.expired', Reservation> | InventoryWebhookEnvelope<'reservation.released', Reservation> | InventoryWebhookEnvelope<'reservation.redeemed', Reservation> | InventoryWebhookEnvelope<'variant_group.created', VariantGroup> | InventoryWebhookEnvelope<'variant_group.updated', VariantGroup>;
 /**
  * Die Felder eines Artikels beim Anlegen. Bei der Anlage heisst `null` „nicht
  * angegeben“ (ausser bei `name`, der Pflicht ist).
@@ -677,3 +690,144 @@ export interface InventoryShortfall {
     /** Verfuegbar (`onHand − reserved`), Tausendstel; darf negativ sein. */
     available: number;
 }
+/** Ein Merkmal einer Variantengruppe mit seinen Werten, in der Reihenfolge der Gruppe. */
+export interface VariantAttribute {
+    /** `^[a-z0-9_]{1,32}$`, eindeutig in der Gruppe; Schluessel in `variantAttributes`. */
+    key: string;
+    /** Beschriftung, 1–40 Zeichen, z. B. „Größe“. */
+    label: string;
+    /**
+     * 1–30 Werte zu je 1–30 Zeichen, eindeutig ohne Gross/Klein, getrimmt und in
+     * Unicode-NFC gespeichert. Werte kommen nur dazu (`addAttributeValues`), nie weg.
+     */
+    values: string[];
+}
+/**
+ * Vorgaben einer Gruppe: sie fuellen bei der **Anlage** einer Variante die
+ * Felder, die die Variante nicht selbst nennt. Ein spaeteres Aendern der
+ * Vorgaben aendert keine bestehende Variante (dafuer `updateArticle`).
+ * Ein Feld ohne Vorgabe fehlt.
+ */
+export interface VariantGroupDefaults {
+    unitPriceCents?: number;
+    vatRate?: number;
+    unit?: string;
+    groupId?: string;
+    /** Ohne Vorgabe gilt wie bei `createArticle` `false` (dann nicht reservierbar). */
+    stockTracked?: boolean;
+}
+/** Eine Variante in der Liste ihrer Gruppe. */
+export interface VariantGroupMember {
+    articleId: string;
+    /** Je Merkmal ein Wert, Schluessel nach Codepunkt sortiert. */
+    variantAttributes: Record<string, string>;
+}
+/**
+ * Eine Variantengruppe, wie `getVariantGroup`, `listVariantGroups`, die
+ * schreibenden Gruppenaufrufe und die Ereignisse `variant_group.*` sie senden.
+ */
+export interface VariantGroup {
+    id: string;
+    /** 1–100 Zeichen; Standardname einer Variante: „<Gruppe> <Wert1> <Wert2>“. */
+    name: string | null;
+    /** 1–3 Merkmale in der Reihenfolge der Gruppe (sie bestimmt den Standardnamen). */
+    attributes: VariantAttribute[];
+    defaults: VariantGroupDefaults;
+    /** `false` = stillgelegt: alle Varianten stillgelegt, kein `addVariant`, endgueltig. */
+    active: boolean;
+    /**
+     * Die aktiven Varianten einer aktiven Gruppe; eine einzeln stillgelegte
+     * Variante faellt heraus (ihre Kombination ist dann wieder frei). Beim
+     * Stilllegen der Gruppe wird die Liste eingefroren. Die Artikel selbst
+     * liest `listArticles({ variantGroupId })`.
+     */
+    variants: VariantGroupMember[];
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+/** Vorgaben in einer Anfrage. Bei der Anlage heisst `null` „nicht angegeben“, bei einer Aenderung „leeren“. */
+export interface VariantGroupDefaultsInput {
+    unitPriceCents?: number | null;
+    vatRate?: number | null;
+    unit?: string | null;
+    /** Artikelgruppe; unbekannt = `group_not_found` (bei einer Variante mit `field: 'defaults.groupId'`). */
+    groupId?: string | null;
+    stockTracked?: boolean | null;
+}
+/**
+ * Eine neue Variante: ihre Merkmalswerte und die Felder eines Artikels wie bei
+ * `createArticle`. Was fehlt (oder `null` ist), fuellen die Vorgaben der
+ * Gruppe; ohne `name` heisst sie „<Gruppe> <Wert1> <Wert2>“ in
+ * Merkmalsreihenfolge. Mit `ean` wird sie ein Fremdartikel, sonst vergibt der
+ * Server den naechsten eigenen Code.
+ */
+export interface VariantInput extends Omit<ArticleInput, 'name'> {
+    /**
+     * Jedes Merkmal der Gruppe genau einmal, Wert exakt aus der Werteliste
+     * (Gross/Klein und Leerraum werden nicht angeglichen), sonst
+     * `invalid_variant_attributes` mit `field`.
+     */
+    variantAttributes: Record<string, string>;
+    /** 1–200 Zeichen; ohne Angabe der Standardname. */
+    name?: string | null;
+}
+/**
+ * Legt eine Variantengruppe an, mit `createMatrix: true` samt allen
+ * Kombinationen (hoechstens 100) oder mit den genannten `variants[]`
+ * (hoechstens 100), nie beides. Ohne beides entsteht die Gruppe ohne Variante.
+ * Die Antwort traegt die Gruppe mit `variants[]` (Kennungen und Merkmale),
+ * nicht die Artikel.
+ */
+export interface CreateVariantGroupRequest {
+    idempotencyKey: string;
+    /** 1–100 Zeichen. */
+    name: string;
+    /** 1–3 Merkmale; ihre Reihenfolge bestimmt Standardnamen und Matrix (das erste laeuft aussen). */
+    attributes: VariantAttribute[];
+    defaults?: VariantGroupDefaultsInput | null;
+    /** `true`: alle Kombinationen der Werte als Varianten. Schliesst `variants` aus. */
+    createMatrix?: boolean;
+    variants?: VariantInput[];
+}
+/**
+ * Aendert eine aktive Gruppe: nur die genannten Felder, mindestens eines.
+ * `defaults` ist ein Teil-Update (`null` je Feld leert es, `defaults: null`
+ * alle). `addAttributeValues` haengt Werte an bestehende Merkmale an und
+ * uebergeht still, was es schon gibt (auch in anderer Gross-/Kleinschreibung):
+ * der Shop darf immer alle seine Werte senden. Werte entfernen und Merkmale
+ * ergaenzen gibt es nicht.
+ *
+ * `active: false` legt die Gruppe und alle ihre Varianten still, steht allein
+ * und ist endgueltig (`true` gibt es nicht). Eine stillgelegte Gruppe ergibt
+ * bei jeder anderen Aenderung `variant_group_inactive`.
+ */
+export interface UpdateVariantGroupRequest {
+    idempotencyKey: string;
+    variantGroupId: string;
+    name?: string;
+    defaults?: VariantGroupDefaultsInput | null;
+    /** `{ groesse: ['XL'] }`: hoechstens 30 Werte je Merkmal danach. */
+    addAttributeValues?: Record<string, string[]>;
+    active?: false;
+}
+/** Legt eine Variante in einer aktiven Gruppe an. Antwort: der Artikel wie `createArticle`. */
+export interface AddVariantRequest extends VariantInput {
+    idempotencyKey: string;
+    variantGroupId: string;
+}
+export interface VariantGroupListQuery {
+    active?: boolean;
+    /**
+     * Nur Gruppen, die seitdem geaendert wurden (inklusive). Die Liste ist nach
+     * `updatedAt` aufsteigend sortiert, gleiche Zeit nach Kennung.
+     */
+    updatedSince?: string | Date;
+    /** 1–200, Vorgabe des Servers 50. */
+    limit?: number;
+    cursor?: string;
+}
+export interface VariantGroupPage {
+    variantGroups: VariantGroup[];
+    /** `null` = letzte Seite. */
+    nextCursor: string | null;
+}