@kreiseck/kasseneck-api 1.5.1 → 1.6.0

package/CHANGELOG.md

@@ -4,6 +4,72 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 1.6.0
+
+Inventory API, variants: `./inventory` gains the five endpoints of backend
+stage 5c. Reason: a shop sells the same apron in three sizes and two colours.
+Until now it had to create six unrelated articles and keep their names, prices
+and codes in step by hand; nothing told the shop or the register that they
+belong together, and nothing stopped a second "M red". A variant group holds
+what they share and guarantees that each combination exists once.
+
+Additive at runtime; existing calls send the same bytes as in 1.5.1. Two
+things change for code that relies on the old shape: the unions
+`InventoryWebhookEvent`/`InventoryWebhookEventType`, `InventoryErrorCode`,
+`InventoryEndpoint` and `ApiCall` gain members, so an exhaustive `switch` with a
+`never` check (or a `Record<…>` over them) needs the new cases; and
+`parseInventoryWebhookEvent` now returns an event for `variant_group.*` where
+1.5.x returned `null`.
+
+- **Variant groups**: `createVariantGroup` (with `createMatrix: true` every
+  combination of the values, at most 100, or the listed `variants[]`, at most
+  100; never both), `updateVariantGroup` (name, defaults as a partial update,
+  `addAttributeValues`, or `active: false` to deactivate the group and all its
+  variants for good), `getVariantGroup`, `listVariantGroups` and
+  `iterateVariantGroups` (sorted by `updatedAt` ascending, filters `active`
+  and `updatedSince`). `VariantGroup` carries `attributes` (1 to 3, each with
+  `key`, `label` and 1 to 30 `values`, in group order), `defaults`
+  (`unitPriceCents`, `vatRate`, `unit`, `groupId`, `stockTracked`), `active`,
+  `variants[]` (`articleId` and `variantAttributes` of every active variant)
+  and the times. The group answers carry no articles: read them with
+  `listArticles({ variantGroupId })`.
+- **Variants are articles**: `addVariant` creates one more variant and answers
+  with the article as `createArticle` does. Each variant takes the article
+  fields of `createArticle`; fields it does not name are filled from the group
+  defaults at creation, the name defaults to "<group> <value1> <value2>" in
+  attribute order. `Article.variantGroupId` and `Article.variantAttributes`
+  are set only on variants; the keys of `variantAttributes` come sorted by code
+  point, the attribute order is in `VariantGroup.attributes`.
+- **Idempotency**: the three writes take `idempotencyKey` (required in the
+  type and refused before sending without a valid one) and are in
+  `UNKNOWN_OUTCOME_CALLS`: after `outcome: 'unknown'` resend with the same key.
+  `getVariantGroup` and `listVariantGroups` are reads.
+- **Checked before sending**, nothing else: the key, `variantGroupId`,
+  `createMatrix: true` together with `variants`, `variants` that is no list or
+  holds an entry without a `variantAttributes` object, integer prices,
+  quantities and purchase prices (also in `defaults` and in every variant), an
+  update without a change, `active` other than `false` or not alone,
+  `addAttributeValues` that is no object. The limits (3 attributes, 30 values,
+  matrix 100, 250 active variants per group) are left to the server, so it can
+  raise them; they are exported as `VARIANT_ATTRIBUTES_MAX`,
+  `VARIANT_VALUES_MAX`, `VARIANT_MATRIX_MAX`, `VARIANT_GROUP_ACTIVE_MAX`.
+- **Events**: `variant_group.created` and `variant_group.updated` in
+  `INVENTORY_WEBHOOK_EVENTS` and `parseInventoryWebhookEvent`, carrying the
+  group as `getVariantGroup` returns it. `updated` fires only on a visible
+  change (new value, new or deactivated variant, name, defaults, deactivating
+  the group). Two deliveries may overtake each other: keep the one with the
+  later `updatedAt`.
+- **Errors**: `INVENTORY_ERROR_CODES` appends `variant_group_not_found`,
+  `variant_already_exists` (with `field`, and `articleId` of the existing
+  variant), `invalid_variant_attributes` (with `field` and `errors[]`),
+  `variant_group_inactive` and `variant_limit`. `too_many_positions` now also
+  answers a variant request that would need more writes than fit into one
+  operation, with `field` (`variants`, `createMatrix`, or `externalIds` for
+  `addVariant`); nothing is written then.
+- **Contract**: `fixtures/v3/` pulled from the backend (stage 5c); the
+  vocabulary of `./stored` regenerated from it (fingerprint only, no schema
+  change for stored documents).
+
 ## 1.5.1
 
 Every call with an effect reports `outcome: 'unknown'` when it fails after

package/README.md

@@ -1482,7 +1482,8 @@ ledger, and get every stock change pushed by webhook within seconds, also the
 ones made at the register in the shop. Since 1.5.0 also the write side:
 create and update articles, book goods receipts, transfers, losses and
 condition changes, and reserve stock at checkout (see
-[Shop: reserve and invoice](#shop-reserve-and-invoice)). Uses the `api_key` of
+[Shop: reserve and invoice](#shop-reserve-and-invoice)); since 1.6.0 variant
+groups (sizes, colours, see [Variants](#variants)). Uses the `api_key` of
 the account and belongs on a **server**. Reading needs the module `lager`,
 writing additionally the account switch *Lager-API schreiben*, which Kasseneck
 turns on (always on in the test environment, `kr_test_…`; otherwise
@@ -1603,8 +1604,13 @@ answer of the first call, the same key with different content gives
 **same** key, never with a new one. Since 1.5.1 every write, reservation and
 webhook call reports `outcome: 'unknown'` in that case (also after HTTP 5xx or
 an unreadable answer; before: `'rejected'`), so `isOutcomeUnknown(error)` is
-the signal to resend with the same key; `previewGoodsReceipt` and the reading
-calls stay `'rejected'`. The client refuses to send a write without
+the signal to resend writes and reservations with the same key;
+`previewGoodsReceipt` and the reading calls stay `'rejected'`. The webhook
+calls (`createWebhook`, `updateWebhook`, `deleteWebhook`,
+`rotateWebhookSecret`, `sendWebhookTest`) have no key: after `'unknown'` look
+the state up first (`listWebhooks`, `listWebhookDeliveries`) instead of
+resending, or you get a second webhook, a second new secret or a used-up test
+delivery. The client refuses to send a write without
 a valid key, and checks before sending only what is certainly wrong without the
 network (required ids, integer quantities, amounts and prices, the range of
 `expiresInMinutes`); everything else the server decides and reports with its
@@ -1747,6 +1753,116 @@ function onDelivery(rawBody: Buffer) {
   net without webhooks; the stock ledger shows reservations as movements of
   type `reservation` with `quantityDelta: 0` and the change in `reservedDelta`.
 
+### Variants
+
+A variant is an ordinary article with `variantGroupId` and
+`variantAttributes`: its own id, code, stock and tile at the register; it is
+read, booked, reserved and invoiced like any other article. The variant group
+holds what the variants share (name, attributes with their values, defaults
+for new variants) and guarantees that each combination exists only once. The
+writes take an `idempotencyKey` and the account switch *Lager-API schreiben*,
+like every other write.
+
+```ts
+import { createInventoryClient, isInventoryError, parseInventoryWebhookEvent } from '@kreiseck/kasseneck-api/inventory';
+
+const inventory = createInventoryClient({ apiKey: process.env.KASSENECK_API_KEY! });
+
+// 1. Create the group with every combination (3 sizes × 2 colours = 6 variants).
+const apron = await inventory.createVariantGroup({
+  idempotencyKey: 'shop-group-3001',
+  name: 'Schürze',
+  attributes: [
+    { key: 'size', label: 'Größe', values: ['S', 'M', 'L'] },
+    { key: 'colour', label: 'Farbe', values: ['rot', 'blau'] },
+  ],
+  defaults: { unitPriceCents: 2490, vatRate: 20, stockTracked: true },
+  createMatrix: true,
+});
+// apron.variants: [{ articleId, variantAttributes: { colour: 'rot', size: 'S' } }, …]
+
+// 2. The answer carries ids only. Read the articles of the group (names
+//    "Schürze S rot" …, own codes) and map them to the shop's products.
+for await (const article of inventory.iterateArticles({ variantGroupId: apron.id })) {
+  await shop.linkVariant(article.variantAttributes!, article.id, article.internalCode);
+}
+
+// 3. A new size later: add the value, then the variants you want.
+await inventory.updateVariantGroup({
+  idempotencyKey: 'shop-group-3001-xl',
+  variantGroupId: apron.id,
+  addAttributeValues: { size: ['S', 'M', 'L', 'XL'] },   // known values are skipped
+});
+try {
+  await inventory.addVariant({
+    idempotencyKey: 'shop-variant-3001-xl-rot',
+    variantGroupId: apron.id,
+    variantAttributes: { size: 'XL', colour: 'rot' },
+    ean: '9001234567834',                                  // optional: a foreign article with this code
+  });
+} catch (error) {
+  if (!isInventoryError(error, 'variant_already_exists')) throw error;
+  // Exists already (error.details.articleId): link that one instead.
+}
+
+// 4. Webhooks: keep the group state with the latest updatedAt.
+function onDelivery(rawBody: Buffer) {
+  const event = parseInventoryWebhookEvent(rawBody);
+  if (event && !event.test && (event.type === 'variant_group.created' || event.type === 'variant_group.updated')) {
+    return shop.saveGroupIfNewer(event.data.id, event.data, event.data.updatedAt);
+  }
+}
+```
+
+- **Limits.** At most 3 attributes per group (keys `^[a-z0-9_]{1,32}$`,
+  `__…__` is reserved), at most 30 values per attribute (1 to 30 characters,
+  unique ignoring case), at most 100 combinations with `createMatrix` and at
+  most 100 entries in `variants[]` per request, at most 250 active variants
+  per group (`variant_limit`). The client does not check these before sending
+  (the server may raise them); they are exported as
+  `VARIANT_ATTRIBUTES_MAX`, `VARIANT_VALUES_MAX`, `VARIANT_MATRIX_MAX` and
+  `VARIANT_GROUP_ACTIVE_MAX`. A request that would need more writes than fit
+  into one operation (about 187 external ids with 100 variants) is refused as
+  a whole with `too_many_positions` and `field` (`variants`, `createMatrix`,
+  or `externalIds` for `addVariant`); nothing is written. Send fewer variants
+  and add the rest with `addVariant`.
+- **Order.** `attributes` keeps the order of the group: it decides the default
+  name "<group> <value1> <value2>" and the matrix (the first attribute runs
+  outermost). `variantAttributes` on articles, in `variants[]` and in webhooks
+  comes with its keys **sorted by code point**, not in attribute order; compare
+  by key, never by position. Values are stored trimmed and in Unicode NFC; a
+  variant's value must match a listed value exactly (case and spaces are not
+  adjusted), otherwise `invalid_variant_attributes` names the `field`.
+- **Variants are articles.** `addVariant` answers with the article as
+  `createArticle` does. Each variant takes the fields of `createArticle`;
+  fields it does not name are filled from the group defaults **at creation
+  only**: changing the group name or defaults later changes no existing
+  variant (use `updateArticle`). `createArticle` and `updateArticle` refuse
+  `variantGroupId` and `variantAttributes`; a variant is never moved to another
+  group, and an existing article never becomes a variant.
+- **Deactivating.** `deactivateArticle` on one variant of an active group
+  takes it out of the group's `variants[]` and frees its combination for a new
+  variant.
+  `updateVariantGroup({ active: false })` deactivates the group and every
+  variant (codes and external ids become free), stands alone and is final; a
+  deactivated group answers every other change and `addVariant` with
+  `variant_group_inactive`. The answer comes when all variants are
+  deactivated; after `outcome: 'unknown'` simply repeat it, also with a new
+  key, it completes an interrupted run.
+- **After `unknown`.** As with every write: resend with the **same**
+  `idempotencyKey`. A new key would create the group a second time (the
+  combination check is per group). `variant_already_exists` on `addVariant`
+  carries `articleId` of the existing variant.
+- **Events.** `variant_group.created` and `variant_group.updated` carry the
+  group as `getVariantGroup` returns it (with `variants[]`, without articles).
+  `updated` fires only on a visible change; creating a variant also sends
+  `article.created`, deactivating the group one `variant_group.updated` and
+  one `article.deactivated` per variant. Deliveries can overtake each other:
+  keep a group state only if its `updatedAt` is later than the stored one.
+  Without webhooks, `listVariantGroups({ updatedSince })` and
+  `listArticles({ variantGroupId, updatedSince })` are sorted by `updatedAt`
+  ascending and include the boundary.
+
 ## Migrating from 0.x
 
 1.0 is one breaking step: the wire, the exported names and the contract files

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

@@ -13,7 +13,7 @@
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
 import type { TransportBodyFields, TransportCallOptions } from './transport.js';
-export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations"];
+export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant"];
 export type ApiCall = typeof ALL_CALLS[number];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -21,7 +21,7 @@ export type ApiCall = typeof ALL_CALLS[number];
  * (`fixtures/v3/v3-vokabular.json`, `endpoints.public`, umbenannt nach
  * `names`). Ein Test haelt beide Listen deckungsgleich.
  */
-export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations"];
+export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant"];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
  * Web-Kasse: gleicher Ursprung `/api/v3`), in der Reihenfolge von
@@ -49,7 +49,7 @@ export type PosCall = typeof POS_CALLS[number];
  * [ALL_CALLS], [PUBLIC_CALLS] und [POS_CALLS] steht entweder hier oder in
  * [CALLS_WITHOUT_EFFECT] (Waechter `test/ausgang-einordnung.test.ts`).
  */
-export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "changeStockCondition", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordStockLoss", "releaseReservation", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateWebhook", "withdrawInvoiceItem"];
+export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "changeStockCondition", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordStockLoss", "releaseReservation", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateVariantGroup", "updateWebhook", "withdrawInvoiceItem"];
 /** Warum ein Aufruf keine Wirkung hat, die ein Zeitlimit offen lassen koennte. */
 export type CallWithoutEffectReason = 'read' | 'repeatable';
 /**

package/dist/cjs/client/aufrufe.js

@@ -105,6 +105,12 @@ exports.ALL_CALLS = [
     'releaseReservation',
     'getReservation',
     'listReservations',
+    // Lager-API Varianten (Stufe 5c, ./inventory)
+    'createVariantGroup',
+    'updateVariantGroup',
+    'getVariantGroup',
+    'listVariantGroups',
+    'addVariant',
 ];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -205,6 +211,12 @@ exports.PUBLIC_CALLS = [
     'releaseReservation',
     'getReservation',
     'listReservations',
+    // Lager-API Varianten (Backend Stufe 5c), umhuellt in `./inventory`.
+    'createVariantGroup',
+    'updateVariantGroup',
+    'getVariantGroup',
+    'listVariantGroups',
+    'addVariant',
 ];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
@@ -263,6 +275,7 @@ exports.POS_CALLS = [
  */
 exports.UNKNOWN_OUTCOME_CALLS = [
     'activateCashregister',
+    'addVariant',
     'cancelInvoice',
     'cancelReceipt',
     'changeStockCondition',
@@ -276,6 +289,7 @@ exports.UNKNOWN_OUTCOME_CALLS = [
     'createPrintJob',
     'createReceipt',
     'createReservation',
+    'createVariantGroup',
     'createWebhook',
     'deactivateArticle',
     'deletePartnerWebhook',
@@ -312,6 +326,7 @@ exports.UNKNOWN_OUTCOME_CALLS = [
     'updateCustomer',
     'updateInvoiceItem',
     'updatePartnerWebhook',
+    'updateVariantGroup',
     'updateWebhook',
     'withdrawInvoiceItem',
 ];
@@ -367,6 +382,7 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
     getReportV2: 'read',
     getReservation: 'read',
     getStock: 'read',
+    getVariantGroup: 'read',
     hobexGetStatus: 'read',
     listArticles: 'read',
     listBrands: 'read',
@@ -390,6 +406,7 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
     listReservations: 'read',
     listStock: 'read',
     listStockMovements: 'read',
+    listVariantGroups: 'read',
     listWebhookDeliveries: 'read',
     listWebhooks: 'read',
     lookupArticleByCode: 'read',

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) {