@kreiseck/kasseneck-api 1.7.1 → 1.8.0

package/dist/esm/client/transport.js

@@ -93,7 +93,19 @@ export function createBinaryTransport(options) {
     return (functionName, params) => kern(functionName, params, undefined, undefined, undefined, alsBytes, pdfAuswerten);
 }
 /**
- * Gemeinsamer Kern beider Einstiegspunkte: Anmeldung, Zeitlimit, Anfrage und
+ * Dritter Einstiegspunkt, fuer Aufrufe, die eine Datei oder eine Nutzlast
+ * liefern (`getStocktakePdf` aus `./inventory`). Wie [createBinaryTransport]
+ * wird die Antwort nur als Bytes gelesen; die ersten Bytes entscheiden: `%PDF`
+ * ergibt `{ pdf }`, eine Erfolgshuelle `{ data }`, eine Fehlerhuelle denselben
+ * fachlichen Fehler wie auf dem JSON-Weg. Leer, kein JSON oder ohne Statusfeld
+ * ist unlesbar mit denselben Gruenden wie dort.
+ */
+export function createPdfOrDataTransport(options) {
+    const kern = createCore(options);
+    return (functionName, params) => kern(functionName, params, undefined, undefined, undefined, alsBytes, pdfOderDatenAuswerten);
+}
+/**
+ * Gemeinsamer Kern aller Einstiegspunkte: Anmeldung, Zeitlimit, Anfrage und
  * HTTP-Status. Was danach mit dem Rumpf geschieht, entscheiden `lesen` und
  * `auswerten`.
  */
@@ -107,9 +119,9 @@ function createCore(options) {
     pruefeKennung(kennung);
     const kopfzeilenSenden = options.omitKasseneckHeaders !== true;
     /**
-     * Basis je Aufruf. Die 22 reinen Kassenaufrufe gehen immer an den
+     * Basis je Aufruf. Die 27 reinen Kassenaufrufe gehen immer an den
      * Kassenweg (unter der oeffentlichen Basis gibt es sie nicht), und die
-     * Kassen-Anmeldung ruft alle 28 Aufrufe des Kassenwegs dort, auch die sechs
+     * Kassen-Anmeldung ruft alle 33 Aufrufe des Kassenwegs dort, auch die sechs
      * oeffentlichen (Kanal `app`). Was der Kassenweg gar nicht fuehrt
      * (Berichte, Zahlungen, FinanzOnline), geht an die oeffentliche Basis.
      */
@@ -431,6 +443,19 @@ function pdfAuswerten(bytes, functionName, statusCode, inhaltstyp, geheimnisse,
     // es keinen Unterschied, ob er ein PDF oder eine Nutzlast erwartet hat.
     throw fachfehler(functionName, huelle.message, huelle.data, geheimnisse, huelle.code);
 }
+/**
+ * Auswertung von [createPdfOrDataTransport]: ein PDF geht als Bytes zurueck,
+ * eine Erfolgshuelle als ihre `data`, eine Fehlerhuelle als derselbe
+ * fachliche Fehler wie auf dem JSON-Weg. Alles andere (leer, kein JSON, ohne
+ * Statusfeld) ist unlesbar mit denselben Gruenden wie dort.
+ */
+function pdfOderDatenAuswerten(bytes, functionName, statusCode, inhaltstyp, geheimnisse, unlesbar) {
+    if (istPdf(bytes)) {
+        return { pdf: bytes };
+    }
+    const text = new TextDecoder('utf-8').decode(bytes);
+    return { data: jsonAuswerten(text, functionName, statusCode, inhaltstyp, geheimnisse, unlesbar) };
+}
 /** `%PDF` am Anfang — die Kennung jeder PDF-Datei. */
 function istPdf(bytes) {
     return bytes.length >= 4 && bytes[0] === 0x25 && bytes[1] === 0x50 && bytes[2] === 0x44 && bytes[3] === 0x46;

package/dist/esm/index.d.ts

@@ -1,6 +1,6 @@
 export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
 export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError, type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, type CashregisterAutoLogout, type CashregisterAutoLogoutPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
-export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
+export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, type KasseneckPdfOrDataTransport, type PdfOrData, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, createPdfOrDataTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
 export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './receipt/due.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type PosBusinessSettings, type PosDeviceSettings, type PosSettings, type ArticleGroup, type PosArticle, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, mergePosSettings, fromArticleGroupPayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, distributeDiscount, cancelScopeOf, receiptsScopeOf, stockViewOf, } from './pos/index.js';

package/dist/esm/index.js

@@ -1,6 +1,6 @@
 export { ReceiptType, VatRate, KeckPaymentMethod, CreditCardProvider, VoucherType, VoucherAction, StripeLinkMode, } from './enums/index.js';
 export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, toVoucherPayload, fromVoucherPayload, voucherIsValid, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, fromReceiptPaymentPayload, toReceiptPaymentPayload, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, fromReceiptCompanyPayload, receiptCompanyTaxInfo, fromCashregisterPayload, fromReceiptSummaryPayload, ZERO_KINDS, isZeroKind, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
-export { apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, ALL_CALLS, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, CLIENT_ERROR_CODES, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, listMyCashregisters, checkVoucherCombinationError, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/index.js';
+export { apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, ALL_CALLS, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, createTransport, createBinaryTransport, createPdfOrDataTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, CLIENT_ERROR_CODES, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, listMyCashregisters, checkVoucherCombinationError, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/index.js';
 export { receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './receipt/due.js';
 export { parseServerTimeStamp, toViennaWallClock } from './vienna-time.js';
 export { POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, mergePosSettings, fromArticleGroupPayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, distributeDiscount, cancelScopeOf, receiptsScopeOf, stockViewOf, } from './pos/index.js';

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

@@ -1,10 +1,10 @@
 /**
  * Fassade ueber den Aufrufen der Lager-API (lesen, Webhooks, schreiben,
- * reservieren, Varianten): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
+ * reservieren, Varianten, Inventur): 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 { 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 { CancelStocktakeRequest, CloseStocktakeRequest, CloseStocktakeResult, CreateStocktakeRequest, RecordStocktakeCountRequest, RecountStocktakeRequest, ReviewStocktakeRequest, Stocktake, StocktakeCount, StocktakeCountListQuery, StocktakeCountPage, StocktakeCountResult, StocktakeItem, StocktakeItemListQuery, StocktakeItemPage, StocktakeListQuery, StocktakePage, StocktakePdf, VoidStocktakeCountRequest, 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. */
@@ -65,5 +65,24 @@ export interface InventoryClient {
     getVariantGroup(variantGroupId: string): Promise<VariantGroup>;
     listVariantGroups(query?: VariantGroupListQuery): Promise<VariantGroupPage>;
     iterateVariantGroups(query?: VariantGroupListQuery): AsyncGenerator<VariantGroup, void, undefined>;
+    createStocktake(request: CreateStocktakeRequest): Promise<Stocktake>;
+    /** Ohne `updatedSince` zuletzt geaenderte zuerst, mit `updatedSince` aufsteigend und inklusive. */
+    listStocktakes(query?: StocktakeListQuery): Promise<StocktakePage>;
+    iterateStocktakes(query?: StocktakeListQuery): AsyncGenerator<Stocktake, void, undefined>;
+    getStocktake(stocktakeId: string): Promise<Stocktake>;
+    listStocktakeItems(query: StocktakeItemListQuery): Promise<StocktakeItemPage>;
+    iterateStocktakeItems(query: StocktakeItemListQuery): AsyncGenerator<StocktakeItem, void, undefined>;
+    recordStocktakeCount(request: RecordStocktakeCountRequest): Promise<StocktakeCountResult>;
+    voidStocktakeCount(request: VoidStocktakeCountRequest): Promise<StocktakeCountResult>;
+    listStocktakeCounts(query: StocktakeCountListQuery): Promise<StocktakeCountPage>;
+    iterateStocktakeCounts(query: StocktakeCountListQuery): AsyncGenerator<StocktakeCount, void, undefined>;
+    /** Pruefen; die Antwort kommt mit `review.complete: false`, gerechnet wird im Hintergrund. */
+    reviewStocktake(request: ReviewStocktakeRequest): Promise<Stocktake>;
+    recountStocktake(request: RecountStocktakeRequest): Promise<Stocktake>;
+    /** Abschliessen; der Server bucht in Teilen weiter (`status: 'closing'`). */
+    closeStocktake(request: CloseStocktakeRequest): Promise<CloseStocktakeResult>;
+    cancelStocktake(request: CancelStocktakeRequest): Promise<Stocktake>;
+    /** Das Inventurprotokoll: die Datei (`kind: 'pdf'`) oder, ueber 9 MiB, ein Lese-Link (`kind: 'download'`). */
+    getStocktakePdf(stocktakeId: string): Promise<StocktakePdf>;
 }
 export declare function createInventoryClient(options: InventoryClientOptions): InventoryClient;

package/dist/esm/inventory/api.js

@@ -1,20 +1,24 @@
 /**
  * Fassade ueber den Aufrufen der Lager-API (lesen, Webhooks, schreiben,
- * reservieren, Varianten): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
+ * reservieren, Varianten, Inventur): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
  * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
  */
-import { createTransport } from '../client/transport.js';
+import { createPdfOrDataTransport, createTransport } from '../client/transport.js';
 import { inventoryKeyAuth } from './auth.js';
 import { createWebhook, deleteWebhook, getArticle, getStock, iterateArticles, iterateStock, iterateStockMovements, listArticles, listLocations, listStock, listStockMovements, listWebhookDeliveries, listWebhooks, lookupArticleByCode, rotateWebhookSecret, sendWebhookTest, updateWebhook, } from './endpunkte.js';
 import { changeStockCondition, createArticle, createReservation, deactivateArticle, extendReservation, getReservation, iterateReservations, listReservations, previewGoodsReceipt, receiveGoods, recordStockLoss, releaseReservation, reverseStockMovement, transferStock, updateArticle, } from './schreiben.js';
+import { cancelStocktake, closeStocktake, createStocktake, getStocktake, getStocktakePdf, iterateStocktakeCounts, iterateStocktakeItems, iterateStocktakes, listStocktakeCounts, listStocktakeItems, listStocktakes, recordStocktakeCount, recountStocktake, reviewStocktake, voidStocktakeCount, } from './inventur.js';
 import { addVariant, createVariantGroup, getVariantGroup, iterateVariantGroups, listVariantGroups, updateVariantGroup, } from './varianten.js';
 export function createInventoryClient(options) {
-    const rufen = createTransport({
+    const transportOptionen = {
         auth: inventoryKeyAuth({ apiKey: options.apiKey }),
         baseUrl: options.baseUrl,
         timeoutMs: options.timeoutMs,
         fetch: options.fetch,
-    });
+    };
+    const rufen = createTransport(transportOptionen);
+    // Das Inventurprotokoll kommt als Datei oder als Lese-Link (ueber 9 MiB).
+    const rufenDatei = createPdfOrDataTransport(transportOptionen);
     return {
         getArticle: (id) => getArticle(rufen, id),
         listArticles: (q) => listArticles(rufen, q),
@@ -54,5 +58,20 @@ export function createInventoryClient(options) {
         getVariantGroup: (id) => getVariantGroup(rufen, id),
         listVariantGroups: (q) => listVariantGroups(rufen, q),
         iterateVariantGroups: (q) => iterateVariantGroups(rufen, q),
+        createStocktake: (r) => createStocktake(rufen, r),
+        listStocktakes: (q) => listStocktakes(rufen, q),
+        iterateStocktakes: (q) => iterateStocktakes(rufen, q),
+        getStocktake: (id) => getStocktake(rufen, id),
+        listStocktakeItems: (q) => listStocktakeItems(rufen, q),
+        iterateStocktakeItems: (q) => iterateStocktakeItems(rufen, q),
+        recordStocktakeCount: (r) => recordStocktakeCount(rufen, r),
+        voidStocktakeCount: (r) => voidStocktakeCount(rufen, r),
+        listStocktakeCounts: (q) => listStocktakeCounts(rufen, q),
+        iterateStocktakeCounts: (q) => iterateStocktakeCounts(rufen, q),
+        reviewStocktake: (r) => reviewStocktake(rufen, r),
+        recountStocktake: (r) => recountStocktake(rufen, r),
+        closeStocktake: (r) => closeStocktake(rufen, r),
+        cancelStocktake: (r) => cancelStocktake(rufen, r),
+        getStocktakePdf: (id) => getStocktakePdf(rufenDatei, id),
     };
 }

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

@@ -41,3 +41,9 @@ export declare function inventoryRetryAfterSec(error: unknown): number | undefin
 export declare function inventoryShortfalls(error: unknown): InventoryShortfall[];
 /** `true` fuer einen Hinweis-Code einer Buchung (`warnings[].code`); Hinweise sind nie Fehler. */
 export declare function isInventoryWarningCode(value: unknown): value is InventoryWarningCode;
+/**
+ * Die Inventur, die einen Standort belegt (`stocktake_location_busy`,
+ * `data.stocktakeId`): weiterzaehlen statt neu anlegen. `undefined`, wenn der
+ * Fehler ein anderer ist oder der Server keine Kennung nennt.
+ */
+export declare function inventoryBusyStocktakeId(error: unknown): string | undefined;

package/dist/esm/inventory/fehler.js

@@ -55,3 +55,14 @@ const HINWEISE = new Set(INVENTORY_WARNING_CODES);
 export function isInventoryWarningCode(value) {
     return typeof value === 'string' && HINWEISE.has(value);
 }
+/**
+ * Die Inventur, die einen Standort belegt (`stocktake_location_busy`,
+ * `data.stocktakeId`): weiterzaehlen statt neu anlegen. `undefined`, wenn der
+ * Fehler ein anderer ist oder der Server keine Kennung nennt.
+ */
+export function inventoryBusyStocktakeId(error) {
+    if (inventoryErrorCode(error) !== 'stocktake_location_busy')
+        return undefined;
+    const wert = error.details['stocktakeId'];
+    return typeof wert === 'string' && wert !== '' ? wert : undefined;
+}

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

@@ -3,7 +3,8 @@
  * 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);
- * Variantengruppen (Stufe 5c, seit 1.6.0).
+ * Variantengruppen (Stufe 5c, seit 1.6.0); Inventur (Lager-Kern Stufe 3,
+ * seit 1.8.0).
  *
  * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
  * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
@@ -14,10 +15,11 @@
  */
 export { createInventoryClient, type InventoryClient, type InventoryClientOptions } from './api.js';
 export { inventoryKeyAuth, type InventoryKeyAuthOptions } from './auth.js';
-export { isInventoryError, isInventoryErrorCode, inventoryErrorCode, inventoryFieldErrors, inventoryRetryAfterSec, inventoryShortfalls, isInventoryWarningCode, type InventoryApiErrorCode, type InventoryFieldError, } from './fehler.js';
+export { isInventoryError, isInventoryErrorCode, inventoryErrorCode, inventoryFieldErrors, inventoryRetryAfterSec, inventoryShortfalls, inventoryBusyStocktakeId, 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 { cancelStocktake, closeStocktake, createStocktake, getStocktake, getStocktakePdf, iterateStocktakeCounts, iterateStocktakeItems, iterateStocktakes, listStocktakeCounts, listStocktakeItems, listStocktakes, recordStocktakeCount, recountStocktake, reviewStocktake, voidStocktakeCount, } from './inventur.js';
 export { verifyInventoryWebhookSignature, parseInventoryWebhookEvent, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, type VerifyInventoryWebhookOptions, } from './webhook.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';
+export type { AddVariantRequest, Article, CancelStocktakeRequest, CloseStocktakeRequest, CloseStocktakeResult, CreateStocktakeRequest, RecordStocktakeCountRequest, RecountStocktakeRequest, ReviewStocktakeRequest, Stocktake, StocktakeActor, StocktakeCancellation, StocktakeClosing, StocktakeCount, StocktakeCountListQuery, StocktakeCountPage, StocktakeCountResult, StocktakeInventoryLine, StocktakeItem, StocktakeItemListQuery, StocktakeItemPage, StocktakeListQuery, StocktakeNotBooked, StocktakePage, StocktakePdf, StocktakePdfDownload, StocktakePdfInfo, StocktakeProgress, StocktakeRecount, StocktakeReview, StocktakeScope, StocktakeScopeInput, StocktakeSeal, StocktakeTotals, StocktakeWarning, VoidStocktakeCountRequest, 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, STOCKTAKE_STATUSES, STOCKTAKE_TYPES, STOCKTAKE_SCOPE_TYPES, STOCKTAKE_CHECK_REASONS, STOCKTAKE_NOT_BOOKED_REASONS, STOCKTAKE_SOURCES, STOCKTAKE_ACTOR_TYPES, STOCKTAKE_INVENTORY_AS_OF, STOCKTAKE_ITEMS_MAX, STOCKTAKE_RECOUNT_ITEMS_MAX, STOCKTAKE_COUNTS_PER_ITEM_MAX, type StocktakeStatus, type StocktakeType, type StocktakeScopeType, type StocktakeCheckReason, type StocktakeNotBookedReason, type StocktakeSource, type StocktakeActorType, type StocktakeInventoryAsOf, 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/esm/inventory/index.js

@@ -3,7 +3,8 @@
  * 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);
- * Variantengruppen (Stufe 5c, seit 1.6.0).
+ * Variantengruppen (Stufe 5c, seit 1.6.0); Inventur (Lager-Kern Stufe 3,
+ * seit 1.8.0).
  *
  * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
  * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
@@ -14,9 +15,10 @@
  */
 export { createInventoryClient } from './api.js';
 export { inventoryKeyAuth } from './auth.js';
-export { isInventoryError, isInventoryErrorCode, inventoryErrorCode, inventoryFieldErrors, inventoryRetryAfterSec, inventoryShortfalls, isInventoryWarningCode, } from './fehler.js';
+export { isInventoryError, isInventoryErrorCode, inventoryErrorCode, inventoryFieldErrors, inventoryRetryAfterSec, inventoryShortfalls, inventoryBusyStocktakeId, isInventoryWarningCode, } 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 { cancelStocktake, closeStocktake, createStocktake, getStocktake, getStocktakePdf, iterateStocktakeCounts, iterateStocktakeItems, iterateStocktakes, listStocktakeCounts, listStocktakeItems, listStocktakes, recordStocktakeCount, recountStocktake, reviewStocktake, voidStocktakeCount, } from './inventur.js';
 export { verifyInventoryWebhookSignature, parseInventoryWebhookEvent, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, } from './webhook.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, } from './vertrag.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, STOCKTAKE_STATUSES, STOCKTAKE_TYPES, STOCKTAKE_SCOPE_TYPES, STOCKTAKE_CHECK_REASONS, STOCKTAKE_NOT_BOOKED_REASONS, STOCKTAKE_SOURCES, STOCKTAKE_ACTOR_TYPES, STOCKTAKE_INVENTORY_AS_OF, STOCKTAKE_ITEMS_MAX, STOCKTAKE_RECOUNT_ITEMS_MAX, STOCKTAKE_COUNTS_PER_ITEM_MAX, } from './vertrag.js';

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

@@ -0,0 +1,104 @@
+/**
+ * Inventur der Lager-API (Lager-Kern Stufe 3): anlegen, zaehlen, Zaehlungen
+ * stornieren, pruefen, nachzaehlen, abschliessen, abbrechen, Inventurprotokoll
+ * holen; dazu die Listen der Inventuren, Positionen und Zaehlungen.
+ *
+ * Ablauf: `createStocktake` → `recordStocktakeCount` (beliebig oft, auch von
+ * mehreren Geraeten; je Position addiert) → `reviewStocktake` (erst jetzt Soll
+ * und Differenz) → bei Bedarf `recountStocktake` und erneut `reviewStocktake`
+ * → `closeStocktake` → `getStocktakePdf`. Pruefen und Abschliessen rechnet der
+ * Server im Hintergrund: die Antwort traegt den Zwischenstand
+ * (`review.complete: false` bzw. `status: 'closing'`), `getStocktake` den
+ * Fortgang.
+ *
+ * **Blind:** vor `review` traegt keine Antwort ein Soll; `blind: false` zeigt
+ * beim Zaehlen nur den heutigen Buchbestand (`bookStockNow`), nie das Soll
+ * zur Referenzzeit.
+ *
+ * Rechte wie in Stufe 5b: Lesen mit jedem Schluessel, alles Schreibende (auch
+ * Zaehlen) mit dem Konto-Schalter „Lager-API schreiben“ (Test-Schluessel
+ * immer), sonst `inventory_api_not_enabled`; Werte und das Protokoll mit
+ * Werten nur mit `lagerApi.kosten`.
+ *
+ * **Vor dem Senden geprueft wird nur, was ohne Netz sicher falsch ist:**
+ * `idempotencyKey` (Pflicht bei jedem Schreiben, 1–120 Zeichen), fehlende
+ * Kennungen (`stocktakeId`, `articleId`, `countId`, `locationId`), `scope`
+ * kein Objekt, eine Menge, die keine Ganzzahl ist (Tausendstel), ein leerer
+ * Grund, `items` beim Nachzaehlen leer oder ohne `articleId`,
+ * `serialNumbers` keine Liste, `uncountedAsZero` kein Wahrheitswert. Alles
+ * Fachliche (Umfang, Stichtag, Seriennummern, Zustand) prueft der Server.
+ *
+ * **Wiederholen** wie bei jedem Schreiben: nach `outcome: 'unknown'` denselben
+ * Aufruf mit **demselben** `idempotencyKey`. Eine Zaehlung wirkt dann genau
+ * einmal (das Zaehldokument ist selbst der Nachweis); ein neuer Schluessel
+ * zaehlte die Ware ein zweites Mal.
+ */
+import type { ApiCall, InternerPdfOderDatenTransport, InternerTransport } from '../client/aufrufe.js';
+import type { CancelStocktakeRequest, CloseStocktakeRequest, CloseStocktakeResult, CreateStocktakeRequest, RecordStocktakeCountRequest, RecountStocktakeRequest, ReviewStocktakeRequest, Stocktake, StocktakeCount, StocktakeCountListQuery, StocktakeCountPage, StocktakeCountResult, StocktakeItem, StocktakeItemListQuery, StocktakeItemPage, StocktakeListQuery, StocktakePage, StocktakePdf, VoidStocktakeCountRequest } from './typen.js';
+type Params = Record<string, unknown>;
+/**
+ * Legt eine Inventur an. Je Standort hoechstens eine offene
+ * (`stocktake_location_busy`, `data.stocktakeId` nennt sie); Umfang `groups`
+ * bzw. `articles` nur mit bestandsgefuehrten Artikeln (`article_not_tracked`).
+ * Jede Inventur beginnt in `counting`.
+ */
+export declare function createStocktake(transport: InternerTransport, request: CreateStocktakeRequest): Promise<Stocktake>;
+/**
+ * Inventuren des Kontos. Ohne `updatedSince` zuletzt geaenderte zuerst; mit
+ * `updatedSince` aufsteigend nach `updatedAt` und inklusive (Abgleich: das
+ * groesste gesehene `updatedAt` als naechstes `updatedSince`). Filter
+ * `status` und `locationId`.
+ */
+export declare function listStocktakes(transport: InternerTransport, query?: StocktakeListQuery): Promise<StocktakePage>;
+/** Alle Inventuren der Abfrage, Seite fuer Seite, in der Reihenfolge von [listStocktakes]. */
+export declare function iterateStocktakes(transport: InternerTransport, query?: StocktakeListQuery): AsyncGenerator<Stocktake, void, undefined>;
+/** Eine Inventur samt `progress.counted` (gezaehlte Positionen). */
+export declare function getStocktake(transport: InternerTransport, stocktakeId: string): Promise<Stocktake>;
+/** Positionen einer Inventur nach Kennung; `openOnly` = ungezaehlt bzw. in `review` zum Nachzaehlen offen. */
+export declare function listStocktakeItems(transport: InternerTransport, query: StocktakeItemListQuery): Promise<StocktakeItemPage>;
+export declare function iterateStocktakeItems(transport: InternerTransport, query: StocktakeItemListQuery): AsyncGenerator<StocktakeItem, void, undefined>;
+/** Zaehlungen einer Inventur, neueste zuerst, auch stornierte; mit `articleId` nur die des Artikels. */
+export declare function listStocktakeCounts(transport: InternerTransport, query: StocktakeCountListQuery): Promise<StocktakeCountPage>;
+export declare function iterateStocktakeCounts(transport: InternerTransport, query: StocktakeCountListQuery): AsyncGenerator<StocktakeCount, void, undefined>;
+/** Pruefung einer Zaehlung vor dem Senden, geteilt mit dem Kassenweg. Paketintern. */
+export declare function zaehlungPruefen(name: ApiCall, p: Params): void;
+/** Pruefung eines Stornos vor dem Senden, geteilt mit dem Kassenweg. Paketintern. */
+export declare function stornoPruefen(name: ApiCall, p: Params): void;
+/**
+ * Eine Zaehlung. Antwort: die Zaehlung und ihre Position danach (Summe der
+ * Runde in `item.quantity`). Gezaehlt wird in `counting`, in `review` nur an
+ * Positionen, die zum Nachzaehlen frei sind (sonst `stocktake_not_open`).
+ */
+export declare function recordStocktakeCount(transport: InternerTransport, request: RecordStocktakeCountRequest): Promise<StocktakeCountResult>;
+/** Storniert eine Zaehlung mit Grund; die Position wird aus den uebrigen Zaehlungen neu summiert. */
+export declare function voidStocktakeCount(transport: InternerTransport, request: VoidStocktakeCountRequest): Promise<StocktakeCountResult>;
+/**
+ * Pruefen: `counting` → `review`, in `review` neu rechnen (nach dem
+ * Nachzaehlen). Die Antwort kommt sofort mit `review.complete: false`; Soll
+ * und Differenz stehen an den Positionen, sobald `complete` `true` ist.
+ */
+export declare function reviewStocktake(transport: InternerTransport, request: ReviewStocktakeRequest): Promise<Stocktake>;
+/** Nachzaehlen: je genannter Position eine neue Runde; danach zaehlen und erneut [reviewStocktake]. */
+export declare function recountStocktake(transport: InternerTransport, request: RecountStocktakeRequest): Promise<Stocktake>;
+/**
+ * Abschliessen (nur aus `review`, sonst `stocktake_not_in_review`; offene
+ * Nachzaehlungen ergeben `stocktake_recount_open`). Der Server bucht in
+ * Teilen weiter; die Antwort traegt meist `status: 'closing'`. Ein erneuter
+ * Aufruf waehrend `closing` stoesst den Abschluss wieder an.
+ */
+export declare function closeStocktake(transport: InternerTransport, request: CloseStocktakeRequest): Promise<CloseStocktakeResult>;
+/** Abbrechen mit Grund (aus `counting` oder `review`); der Standort ist danach frei. */
+export declare function cancelStocktake(transport: InternerTransport, request: CancelStocktakeRequest): Promise<Stocktake>;
+/**
+ * Das Inventurprotokoll (PDF), erst nach dem Abschluss (`stocktake_not_closed`,
+ * auch fuer eine abgebrochene Inventur). Mit `lagerApi.kosten` die Fassung mit
+ * Werten, sonst die nur mit Mengen. Bis 9 MiB kommt die Datei selbst
+ * (`kind: 'pdf'`), darueber ein signierter Lese-Link fuer 15 Minuten
+ * (`kind: 'download'`); die geladene Datei an `download.sha256` pruefen.
+ *
+ * Als freie Funktion braucht sie den Transport aus `createPdfOrDataTransport`
+ * (Paketwurzel): ein JSON-Transport laese die Datei als Text, ein reiner
+ * Binaer-Transport kennt den Link nicht. [createInventoryClient] bindet ihn selbst.
+ */
+export declare function getStocktakePdf(transport: InternerPdfOderDatenTransport, stocktakeId: string): Promise<StocktakePdf>;
+export {};

package/dist/esm/inventory/inventur.js

@@ -0,0 +1,226 @@
+/**
+ * Inventur der Lager-API (Lager-Kern Stufe 3): anlegen, zaehlen, Zaehlungen
+ * stornieren, pruefen, nachzaehlen, abschliessen, abbrechen, Inventurprotokoll
+ * holen; dazu die Listen der Inventuren, Positionen und Zaehlungen.
+ *
+ * Ablauf: `createStocktake` → `recordStocktakeCount` (beliebig oft, auch von
+ * mehreren Geraeten; je Position addiert) → `reviewStocktake` (erst jetzt Soll
+ * und Differenz) → bei Bedarf `recountStocktake` und erneut `reviewStocktake`
+ * → `closeStocktake` → `getStocktakePdf`. Pruefen und Abschliessen rechnet der
+ * Server im Hintergrund: die Antwort traegt den Zwischenstand
+ * (`review.complete: false` bzw. `status: 'closing'`), `getStocktake` den
+ * Fortgang.
+ *
+ * **Blind:** vor `review` traegt keine Antwort ein Soll; `blind: false` zeigt
+ * beim Zaehlen nur den heutigen Buchbestand (`bookStockNow`), nie das Soll
+ * zur Referenzzeit.
+ *
+ * Rechte wie in Stufe 5b: Lesen mit jedem Schluessel, alles Schreibende (auch
+ * Zaehlen) mit dem Konto-Schalter „Lager-API schreiben“ (Test-Schluessel
+ * immer), sonst `inventory_api_not_enabled`; Werte und das Protokoll mit
+ * Werten nur mit `lagerApi.kosten`.
+ *
+ * **Vor dem Senden geprueft wird nur, was ohne Netz sicher falsch ist:**
+ * `idempotencyKey` (Pflicht bei jedem Schreiben, 1–120 Zeichen), fehlende
+ * Kennungen (`stocktakeId`, `articleId`, `countId`, `locationId`), `scope`
+ * kein Objekt, eine Menge, die keine Ganzzahl ist (Tausendstel), ein leerer
+ * Grund, `items` beim Nachzaehlen leer oder ohne `articleId`,
+ * `serialNumbers` keine Liste, `uncountedAsZero` kein Wahrheitswert. Alles
+ * Fachliche (Umfang, Stichtag, Seriennummern, Zustand) prueft der Server.
+ *
+ * **Wiederholen** wie bei jedem Schreiben: nach `outcome: 'unknown'` denselben
+ * Aufruf mit **demselben** `idempotencyKey`. Eine Zaehlung wirkt dann genau
+ * einmal (das Zaehldokument ist selbst der Nachweis); ein neuer Schluessel
+ * zaehlte die Ware ein zweites Mal.
+ */
+import { abfrage, anfragefehler, kennung, seitenweise } from './endpunkte.js';
+import { antwortfehler, inventur, inventurPosition, inventurWarnungen, inventurZaehlung, liste, naechsterCursor, objekt, protokollLink, zaehlungMitPosition, } from './lesen.js';
+import { anfrage, ganz, schluessel } from './schreiben.js';
+const istObjekt = (w) => w !== null && typeof w === 'object' && !Array.isArray(w);
+const kopfAus = (name, daten) => inventur({ name, pfad: 'stocktake' }, objekt(daten)?.stocktake);
+/** Ein Grund (Storno, Nachzaehlen, Abbruch): nicht leer. Die Laenge prueft der Server. */
+function grund(name, w) {
+    if (typeof w !== 'string' || w.trim() === '')
+        throw anfragefehler(name, 'reason fehlt (Grund mit 1 bis 500 Zeichen)');
+}
+/** Schreibende Anfrage mit `stocktakeId`: Schluessel und Kennung geprueft, flach wie gesendet. */
+function schreibend(name, request) {
+    const p = anfrage(name, request);
+    schluessel(name, p, { pflicht: true });
+    kennung(name, 'stocktakeId', p.stocktakeId);
+    return p;
+}
+/** Eine Liste unter einer Inventur: `stocktakeId` Pflicht, sonst wie jede Abfrage. */
+function abfrageMitInventur(name, query) {
+    if (!istObjekt(query))
+        throw anfragefehler(name, 'Abfrage mit stocktakeId erwartet');
+    const p = abfrage(name, query);
+    kennung(name, 'stocktakeId', p.stocktakeId);
+    return p;
+}
+// ---- Anlegen und Lesen -------------------------------------------------------------
+/**
+ * Legt eine Inventur an. Je Standort hoechstens eine offene
+ * (`stocktake_location_busy`, `data.stocktakeId` nennt sie); Umfang `groups`
+ * bzw. `articles` nur mit bestandsgefuehrten Artikeln (`article_not_tracked`).
+ * Jede Inventur beginnt in `counting`.
+ */
+export async function createStocktake(transport, request) {
+    const name = 'createStocktake';
+    const p = anfrage(name, request);
+    schluessel(name, p, { pflicht: true });
+    kennung(name, 'locationId', p.locationId);
+    if (!istObjekt(p.scope))
+        throw anfragefehler(name, 'scope fehlt oder ist kein Objekt { type, groupIds?, articleIds? }');
+    return kopfAus(name, await transport(name, p));
+}
+/**
+ * Inventuren des Kontos. Ohne `updatedSince` zuletzt geaenderte zuerst; mit
+ * `updatedSince` aufsteigend nach `updatedAt` und inklusive (Abgleich: das
+ * groesste gesehene `updatedAt` als naechstes `updatedSince`). Filter
+ * `status` und `locationId`.
+ */
+export async function listStocktakes(transport, query) {
+    const name = 'listStocktakes';
+    const daten = await transport(name, abfrage(name, query));
+    return { stocktakes: liste(name, daten, 'stocktakes', inventur), nextCursor: naechsterCursor(name, daten) };
+}
+/** Alle Inventuren der Abfrage, Seite fuer Seite, in der Reihenfolge von [listStocktakes]. */
+export function iterateStocktakes(transport, query) {
+    const { cursor, ...rest } = query ?? {};
+    return seitenweise('listStocktakes', cursor, async (c) => {
+        const s = await listStocktakes(transport, { ...rest, cursor: c });
+        return { eintraege: s.stocktakes, nextCursor: s.nextCursor };
+    });
+}
+/** Eine Inventur samt `progress.counted` (gezaehlte Positionen). */
+export async function getStocktake(transport, stocktakeId) {
+    const name = 'getStocktake';
+    return kopfAus(name, await transport(name, { stocktakeId: kennung(name, 'stocktakeId', stocktakeId) }));
+}
+/** Positionen einer Inventur nach Kennung; `openOnly` = ungezaehlt bzw. in `review` zum Nachzaehlen offen. */
+export async function listStocktakeItems(transport, query) {
+    const name = 'listStocktakeItems';
+    const daten = await transport(name, abfrageMitInventur(name, query));
+    return { items: liste(name, daten, 'items', inventurPosition), nextCursor: naechsterCursor(name, daten) };
+}
+export function iterateStocktakeItems(transport, query) {
+    const { cursor, ...rest } = query;
+    return seitenweise('listStocktakeItems', cursor, async (c) => {
+        const s = await listStocktakeItems(transport, { ...rest, cursor: c });
+        return { eintraege: s.items, nextCursor: s.nextCursor };
+    });
+}
+/** Zaehlungen einer Inventur, neueste zuerst, auch stornierte; mit `articleId` nur die des Artikels. */
+export async function listStocktakeCounts(transport, query) {
+    const name = 'listStocktakeCounts';
+    const daten = await transport(name, abfrageMitInventur(name, query));
+    return { counts: liste(name, daten, 'counts', inventurZaehlung), nextCursor: naechsterCursor(name, daten) };
+}
+export function iterateStocktakeCounts(transport, query) {
+    const { cursor, ...rest } = query;
+    return seitenweise('listStocktakeCounts', cursor, async (c) => {
+        const s = await listStocktakeCounts(transport, { ...rest, cursor: c });
+        return { eintraege: s.counts, nextCursor: s.nextCursor };
+    });
+}
+// ---- Zaehlen und Stornieren ------------------------------------------------------
+/** Pruefung einer Zaehlung vor dem Senden, geteilt mit dem Kassenweg. Paketintern. */
+export function zaehlungPruefen(name, p) {
+    kennung(name, 'articleId', p.articleId);
+    ganz(name, 'quantity', p.quantity, { pflicht: true });
+    if (p.serialNumbers !== undefined && p.serialNumbers !== null && !Array.isArray(p.serialNumbers)) {
+        throw anfragefehler(name, 'serialNumbers muss eine Liste sein');
+    }
+}
+/** Pruefung eines Stornos vor dem Senden, geteilt mit dem Kassenweg. Paketintern. */
+export function stornoPruefen(name, p) {
+    kennung(name, 'countId', p.countId);
+    grund(name, p.reason);
+}
+/**
+ * Eine Zaehlung. Antwort: die Zaehlung und ihre Position danach (Summe der
+ * Runde in `item.quantity`). Gezaehlt wird in `counting`, in `review` nur an
+ * Positionen, die zum Nachzaehlen frei sind (sonst `stocktake_not_open`).
+ */
+export async function recordStocktakeCount(transport, request) {
+    const name = 'recordStocktakeCount';
+    const p = schreibend(name, request);
+    zaehlungPruefen(name, p);
+    return zaehlungMitPosition(name, await transport(name, p));
+}
+/** Storniert eine Zaehlung mit Grund; die Position wird aus den uebrigen Zaehlungen neu summiert. */
+export async function voidStocktakeCount(transport, request) {
+    const name = 'voidStocktakeCount';
+    const p = schreibend(name, request);
+    stornoPruefen(name, p);
+    return zaehlungMitPosition(name, await transport(name, p));
+}
+// ---- Pruefen bis Abbruch ------------------------------------------------------------
+/**
+ * Pruefen: `counting` → `review`, in `review` neu rechnen (nach dem
+ * Nachzaehlen). Die Antwort kommt sofort mit `review.complete: false`; Soll
+ * und Differenz stehen an den Positionen, sobald `complete` `true` ist.
+ */
+export async function reviewStocktake(transport, request) {
+    const name = 'reviewStocktake';
+    return kopfAus(name, await transport(name, schreibend(name, request)));
+}
+/** Nachzaehlen: je genannter Position eine neue Runde; danach zaehlen und erneut [reviewStocktake]. */
+export async function recountStocktake(transport, request) {
+    const name = 'recountStocktake';
+    const p = schreibend(name, request);
+    if (!Array.isArray(p.items) || p.items.length === 0)
+        throw anfragefehler(name, 'items fehlt oder ist leer');
+    p.items.forEach((x, i) => {
+        if (!istObjekt(x))
+            throw anfragefehler(name, `items[${i}] muss ein Objekt sein`);
+        kennung(name, `items[${i}].articleId`, x.articleId);
+    });
+    grund(name, p.reason);
+    return kopfAus(name, await transport(name, p));
+}
+/**
+ * Abschliessen (nur aus `review`, sonst `stocktake_not_in_review`; offene
+ * Nachzaehlungen ergeben `stocktake_recount_open`). Der Server bucht in
+ * Teilen weiter; die Antwort traegt meist `status: 'closing'`. Ein erneuter
+ * Aufruf waehrend `closing` stoesst den Abschluss wieder an.
+ */
+export async function closeStocktake(transport, request) {
+    const name = 'closeStocktake';
+    const p = schreibend(name, request);
+    if (p.uncountedAsZero !== undefined && typeof p.uncountedAsZero !== 'boolean') {
+        throw anfragefehler(name, 'uncountedAsZero muss true oder false sein');
+    }
+    const daten = await transport(name, p);
+    return { stocktake: kopfAus(name, daten), warnings: inventurWarnungen({ name, pfad: 'warnings' }, objekt(daten)?.warnings) };
+}
+/** Abbrechen mit Grund (aus `counting` oder `review`); der Standort ist danach frei. */
+export async function cancelStocktake(transport, request) {
+    const name = 'cancelStocktake';
+    const p = schreibend(name, request);
+    grund(name, p.reason);
+    return kopfAus(name, await transport(name, p));
+}
+// ---- Protokoll ------------------------------------------------------------------
+/**
+ * Das Inventurprotokoll (PDF), erst nach dem Abschluss (`stocktake_not_closed`,
+ * auch fuer eine abgebrochene Inventur). Mit `lagerApi.kosten` die Fassung mit
+ * Werten, sonst die nur mit Mengen. Bis 9 MiB kommt die Datei selbst
+ * (`kind: 'pdf'`), darueber ein signierter Lese-Link fuer 15 Minuten
+ * (`kind: 'download'`); die geladene Datei an `download.sha256` pruefen.
+ *
+ * Als freie Funktion braucht sie den Transport aus `createPdfOrDataTransport`
+ * (Paketwurzel): ein JSON-Transport laese die Datei als Text, ein reiner
+ * Binaer-Transport kennt den Link nicht. [createInventoryClient] bindet ihn selbst.
+ */
+export async function getStocktakePdf(transport, stocktakeId) {
+    const name = 'getStocktakePdf';
+    const ergebnis = await transport(name, { stocktakeId: kennung(name, 'stocktakeId', stocktakeId) });
+    if ('pdf' in ergebnis)
+        return { kind: 'pdf', pdf: ergebnis.pdf };
+    const link = objekt(ergebnis.data)?.download;
+    if (link === undefined || link === null)
+        throw antwortfehler(name, 'Antwort ist weder ein PDF noch ein Lese-Link (data.download fehlt)');
+    return { kind: 'download', download: protokollLink(name, link) };
+}