@kreiseck/kasseneck-api 1.7.1 → 1.10.0

package/dist/esm/client/aufrufe.js

@@ -17,6 +17,7 @@ export const ALL_CALLS = [
     'endRegisterSession',
     'financeWebService',
     'generateFullReceiptId',
+    'getCashregisterReport',
     'getCustomer',
     'getCustomerCredentials',
     'getCustomerSignatureStatus',
@@ -105,6 +106,25 @@ export const ALL_CALLS = [
     'getVariantGroup',
     'listVariantGroups',
     'addVariant',
+    // Lager-API Inventur (Lager-Kern Stufe 3, ./inventory)
+    'createStocktake',
+    'listStocktakes',
+    'getStocktake',
+    'listStocktakeItems',
+    'recordStocktakeCount',
+    'voidStocktakeCount',
+    'listStocktakeCounts',
+    'reviewStocktake',
+    'recountStocktake',
+    'closeStocktake',
+    'cancelStocktake',
+    'getStocktakePdf',
+    // Inventur zaehlen an der Kasse (Lager-Kern Stufe 3, ./pos)
+    'listMyStocktakes',
+    'listMyStocktakeItems',
+    'listMyStocktakeCounts',
+    'recordMyStocktakeCount',
+    'voidMyStocktakeCount',
 ];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -123,6 +143,7 @@ export const PUBLIC_CALLS = [
     'getReportV2',
     'downloadReport',
     'downloadDailyReport',
+    'getCashregisterReport',
     'createPaymentLinkStripe',
     'stripeCaptureIntent',
     'hobexPayApi',
@@ -211,6 +232,19 @@ export const PUBLIC_CALLS = [
     'getVariantGroup',
     'listVariantGroups',
     'addVariant',
+    // Lager-API Inventur (Lager-Kern Stufe 3), umhuellt in `./inventory`.
+    'createStocktake',
+    'listStocktakes',
+    'getStocktake',
+    'listStocktakeItems',
+    'recordStocktakeCount',
+    'voidStocktakeCount',
+    'listStocktakeCounts',
+    'reviewStocktake',
+    'recountStocktake',
+    'closeStocktake',
+    'cancelStocktake',
+    'getStocktakePdf',
 ];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
@@ -248,6 +282,12 @@ export const POS_CALLS = [
     'listMyStockLocations',
     'listMyStock',
     'setMyCashregisterStockLocation',
+    // Inventur zaehlen (Lager-Kern Stufe 3): nur ueber den Kassenweg.
+    'listMyStocktakes',
+    'listMyStocktakeItems',
+    'listMyStocktakeCounts',
+    'recordMyStocktakeCount',
+    'voidMyStocktakeCount',
 ];
 /**
  * Die Aufrufe **mit Wirkung**, alphabetisch: sie legen etwas an, aendern oder
@@ -272,7 +312,9 @@ export const UNKNOWN_OUTCOME_CALLS = [
     'addVariant',
     'cancelInvoice',
     'cancelReceipt',
+    'cancelStocktake',
     'changeStockCondition',
+    'closeStocktake',
     'createArticle',
     'createCreditNote',
     'createCustomer',
@@ -283,6 +325,7 @@ export const UNKNOWN_OUTCOME_CALLS = [
     'createPrintJob',
     'createReceipt',
     'createReservation',
+    'createStocktake',
     'createVariantGroup',
     'createWebhook',
     'deactivateArticle',
@@ -296,11 +339,15 @@ export const UNKNOWN_OUTCOME_CALLS = [
     'pairRegisterDevice',
     'receiveGoods',
     'recordInvoicePayment',
+    'recordMyStocktakeCount',
     'recordStockLoss',
+    'recordStocktakeCount',
+    'recountStocktake',
     'releaseReservation',
     'reportCustomerContract',
     'requestCustomerSignature',
     'reverseStockMovement',
+    'reviewStocktake',
     'revokeCustomerMandate',
     'rotatePartnerWebhookSecret',
     'rotateWebhookSecret',
@@ -322,6 +369,8 @@ export const UNKNOWN_OUTCOME_CALLS = [
     'updatePartnerWebhook',
     'updateVariantGroup',
     'updateWebhook',
+    'voidMyStocktakeCount',
+    'voidStocktakeCount',
     'withdrawInvoiceItem',
 ];
 /**
@@ -356,6 +405,7 @@ export const CALLS_WITHOUT_EFFECT = Object.freeze({
     createPaymentLinkStripe: 'repeatable',
     endRegisterSession: 'repeatable',
     generateFullReceiptId: 'read',
+    getCashregisterReport: 'read',
     getArticle: 'read',
     getCustomer: 'read',
     getCustomerCredentials: 'read',
@@ -376,6 +426,8 @@ export const CALLS_WITHOUT_EFFECT = Object.freeze({
     getReportV2: 'read',
     getReservation: 'read',
     getStock: 'read',
+    getStocktake: 'read',
+    getStocktakePdf: 'read',
     getVariantGroup: 'read',
     hobexGetStatus: 'read',
     listArticles: 'read',
@@ -391,6 +443,9 @@ export const CALLS_WITHOUT_EFFECT = Object.freeze({
     listMyReceipts: 'read',
     listMyStock: 'read',
     listMyStockLocations: 'read',
+    listMyStocktakeCounts: 'read',
+    listMyStocktakeItems: 'read',
+    listMyStocktakes: 'read',
     listMyTipRecipients: 'read',
     listPartnerCustomers: 'read',
     listPartnerWebhookDeliveries: 'read',
@@ -400,6 +455,9 @@ export const CALLS_WITHOUT_EFFECT = Object.freeze({
     listReservations: 'read',
     listStock: 'read',
     listStockMovements: 'read',
+    listStocktakeCounts: 'read',
+    listStocktakeItems: 'read',
+    listStocktakes: 'read',
     listVariantGroups: 'read',
     listWebhookDeliveries: 'read',
     listWebhooks: 'read',
@@ -423,12 +481,12 @@ export function isUnknownOutcomeCall(name) {
 const OEFFENTLICH = new Set(PUBLIC_CALLS);
 const KASSENWEG = new Set(POS_CALLS);
 const NUR_KASSE = new Set(POS_CALLS.filter((name) => !OEFFENTLICH.has(name)));
-/** Einer der 28 Aufrufe des Kassenwegs. */
+/** Einer der 33 Aufrufe des Kassenwegs. */
 export function isPosCall(name) {
     return KASSENWEG.has(name);
 }
 /**
- * Nur ueber den Kassenweg erreichbar (22 Namen): unter `api.kasseneck.at/v3`
+ * Nur ueber den Kassenweg erreichbar (27 Namen): unter `api.kasseneck.at/v3`
  * gibt es sie nicht. Der Transport schickt sie darum ohne eigene Basis an
  * [POS_BASE_URL] statt an die oeffentliche Basis.
  */

package/dist/esm/client/errors.js

@@ -268,7 +268,10 @@ export const PAYMENT_CALL_REJECTED_CODES = Object.freeze([
     'account_not_found',
     'live_not_enabled',
     'api_not_approved', // Live-API ohne Freigabe (Entwicklerbereich): vor dem Handler abgewiesen
+    'app_check_missing', // Admin-App ohne bzw. mit ungueltigem App Check: vor dem Handler abgewiesen
+    'app_check_invalid',
     'unauthorized',
+    'password_change_required', // Pflichtwechsel des Passworts offen: vor dem Handler abgewiesen
     'mfa_required',
     'user_verification_failed',
     'admin_required',

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

@@ -1,9 +1,9 @@
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, } from './auth.js';
-export { 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, createTransport, createBinaryTransport, } from './transport.js';
+export { 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, createTransport, createBinaryTransport, createPdfOrDataTransport, } from './transport.js';
 export { ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, } from './aufrufe.js';
 export { 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, } from './errors.js';
 export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, type CancelReceiptResult, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
-export { downloadDailyReport, downloadMonthlyReport, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options } from './reports.js';
+export { downloadDailyReport, downloadMonthlyReport, getCashregisterReport, getReportV2, type CashregisterReportPeriod, type ReportV2, type ReportV2Metadata, type ReportV2Options } from './reports.js';
 export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';
 export { type KasseneckApi, createKasseneckApi } from './api.js';

package/dist/esm/client/index.js

@@ -1,9 +1,9 @@
 export { apiKeyAuth, registerUserAuth, } from './auth.js';
-export { DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, createTransport, createBinaryTransport, } from './transport.js';
+export { DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, createTransport, createBinaryTransport, createPdfOrDataTransport, } from './transport.js';
 export { ALL_CALLS, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, } from './aufrufe.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, CLIENT_ERROR_CODES, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, } from './errors.js';
 export { sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, checkVoucherCombinationError, sendReceiptEmail, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
-export { downloadDailyReport, downloadMonthlyReport, getReportV2 } from './reports.js';
+export { downloadDailyReport, downloadMonthlyReport, getCashregisterReport, getReportV2 } from './reports.js';
 export { getCashboxStatus, getSignatureStatus, } from './status.js';
 export { createKasseneckApi } from './api.js';

package/dist/esm/client/reports.d.ts

@@ -28,6 +28,9 @@ import type { InternerBinaerTransport, InternerTransport } from './aufrufe.js';
  * `getDate()`/`getMonth()` wuerden auf einer UTC-Maschine den Bericht des
  * Vortags holen (das Dart-Vorbild nimmt hier die Geraetezeit, was auf einer
  * oesterreichischen Kasse zufaellig stimmt).
+ *
+ * @deprecated Since 1.10.0: use getCashregisterReport(...). The old endpoint keeps working
+ * (closed periods as v2, current month / today as before) until it is switched off.
  */
 export declare function downloadDailyReport(transport: InternerBinaerTransport, date: Date): Promise<Uint8Array>;
 /**
@@ -39,8 +42,31 @@ export declare function downloadDailyReport(transport: InternerBinaerTransport,
  *
  * `month` geht als **Zahl 1-12** raus (im Flutter-Paket `reportMonth.month.id`,
  * wo `KeckMonth.january.id === 1` ist) — kein Name, kein nullbasierter Index.
+ *
+ * @deprecated Since 1.10.0: use getCashregisterReport(...). The old endpoint keeps working
+ * (closed periods as v2, current month / today as before) until it is switched off.
  */
 export declare function downloadMonthlyReport(transport: InternerBinaerTransport, reportMonth: ReportMonth): Promise<Uint8Array>;
+/** Zeitraum fuer [getCashregisterReport]: genau eine der drei Formen. */
+export type CashregisterReportPeriod = {
+    year: number;
+    month: number;
+} | {
+    year: number;
+    month: number;
+    day: number;
+} | {
+    start: string;
+    end: string;
+};
+/**
+ * Kassenbericht als PDF (v2) fuer einen abgeschlossenen Monat, einen Tag bis
+ * heute oder einen Zeitraum (`end` ausschliesslich, hoechstens 366 Tage).
+ * Laufender Monat und Zukunft liefern die Fehler `period_not_closed` bzw.
+ * `period_in_future`. Nachfolger von [downloadMonthlyReport] und
+ * [downloadDailyReport].
+ */
+export declare function getCashregisterReport(transport: InternerBinaerTransport, options: CashregisterReportPeriod): Promise<Uint8Array>;
 /** Zeitfenster von [getReportV2]: Wiener Wanduhr, `YYYY-MM-DD` oder voller Zeitstempel, `end` ausschliesslich. */
 export interface ReportV2Options {
     start: string;

package/dist/esm/client/reports.js

@@ -29,6 +29,9 @@ import { KasseneckValidationError } from './errors.js';
  * `getDate()`/`getMonth()` wuerden auf einer UTC-Maschine den Bericht des
  * Vortags holen (das Dart-Vorbild nimmt hier die Geraetezeit, was auf einer
  * oesterreichischen Kasse zufaellig stimmt).
+ *
+ * @deprecated Since 1.10.0: use getCashregisterReport(...). The old endpoint keeps working
+ * (closed periods as v2, current month / today as before) until it is switched off.
  */
 // `async`, damit auch die Eingabepruefung als abgelehntes Versprechen ankommt
 // und nicht als synchroner Wurf am `await` des Aufrufers vorbei.
@@ -53,6 +56,9 @@ export async function downloadDailyReport(transport, date) {
  *
  * `month` geht als **Zahl 1-12** raus (im Flutter-Paket `reportMonth.month.id`,
  * wo `KeckMonth.january.id === 1` ist) — kein Name, kein nullbasierter Index.
+ *
+ * @deprecated Since 1.10.0: use getCashregisterReport(...). The old endpoint keeps working
+ * (closed periods as v2, current month / today as before) until it is switched off.
  */
 export async function downloadMonthlyReport(transport, reportMonth) {
     const { month, year } = reportMonth;
@@ -64,6 +70,46 @@ export async function downloadMonthlyReport(transport, reportMonth) {
     }
     return transport('downloadReport', { month, year });
 }
+/**
+ * Kassenbericht als PDF (v2) fuer einen abgeschlossenen Monat, einen Tag bis
+ * heute oder einen Zeitraum (`end` ausschliesslich, hoechstens 366 Tage).
+ * Laufender Monat und Zukunft liefern die Fehler `period_not_closed` bzw.
+ * `period_in_future`. Nachfolger von [downloadMonthlyReport] und
+ * [downloadDailyReport].
+ */
+export async function getCashregisterReport(transport, options) {
+    // Genau eine Form; Misch- und Teilformen werfen vor dem Transport (wie im Dart-Paket).
+    const o = options;
+    const da = (k) => o[k] !== undefined && o[k] !== null;
+    const felder = ['year', 'month', 'day', 'start', 'end'].filter(da).sort().join(',');
+    if (felder !== 'month,year' && felder !== 'day,month,year' && felder !== 'end,start') {
+        throw eingabefehler('getCashregisterReport', 'genau eine Form angeben: year+month, year+month+day oder start+end');
+    }
+    if (felder === 'end,start') {
+        const { start, end } = options;
+        for (const [feld, wert] of [['start', start], ['end', end]]) {
+            if (typeof wert !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(wert)) {
+                throw eingabefehler('getCashregisterReport', `${feld} muss YYYY-MM-DD sein, war "${String(wert)}"`);
+            }
+        }
+        return transport('getCashregisterReport', { start, end });
+    }
+    const { year, month } = options;
+    if (!Number.isInteger(month) || month < 1 || month > 12) {
+        throw eingabefehler('getCashregisterReport', `month muss 1-12 sein, war "${month}"`);
+    }
+    if (!Number.isInteger(year)) {
+        throw eingabefehler('getCashregisterReport', `year muss eine ganze Zahl sein, war "${year}"`);
+    }
+    if ('day' in options) {
+        const day = options.day;
+        if (!Number.isInteger(day) || day < 1 || day > 31) {
+            throw eingabefehler('getCashregisterReport', `day muss 1-31 sein, war "${day}"`);
+        }
+        return transport('getCashregisterReport', { year, month, day });
+    }
+    return transport('getCashregisterReport', { year, month });
+}
 /**
  * Rohdaten eines Zeitraums (`getReportV2`): alle Belege der Kasse und die
  * Firmendaten fuer Kopf und Fuss. Der Server vergleicht die Zeitstempel als

package/dist/esm/client/transport.d.ts

@@ -91,16 +91,16 @@ export interface TransportOptions {
     auth: KasseneckAuth;
     /**
      * Abweichende Basis der **oeffentlichen** Aufrufe (Vorgabe
-     * [DEFAULT_BASE_URL]): alles ausser den 28 Aufrufen des Kassenwegs, und die
+     * [DEFAULT_BASE_URL]): alles ausser den 33 Aufrufen des Kassenwegs, und die
      * sechs oeffentlichen davon nur, wenn nicht mit `registerUserAuth`
      * angemeldet. Muss auf `/v3` enden (eigene Proxys erlaubt), sonst wirft das
      * Anlegen; `/v1` oder `/api` gibt es in der 1.x-Linie nicht.
      */
     baseUrl?: string;
     /**
-     * Abweichende Basis des **Kassenwegs** (Vorgabe [POS_BASE_URL]): die 22
+     * Abweichende Basis des **Kassenwegs** (Vorgabe [POS_BASE_URL]): die 27
      * reinen Kassenaufrufe (Kopplung, Anmeldung, Einstellungen, Artikel,
-     * Drucker, ...) und mit `registerUserAuth` alle 28 Aufrufe des Kassenwegs.
+     * Drucker, ...) und mit `registerUserAuth` alle 33 Aufrufe des Kassenwegs.
      * Die Web-Kasse gibt `'/api/v3'` (gleicher Ursprung). Muss auf `/v3` enden
      * (in der Regel `/api/v3`), sonst wirft das Anlegen.
      */
@@ -193,3 +193,27 @@ export declare function createTransport(options: TransportOptions): KasseneckTra
  * reports.ts.)
  */
 export declare function createBinaryTransport(options: TransportOptions): KasseneckBinaryTransport;
+/**
+ * Ergebnis eines Aufrufs, der eine Datei **oder** eine Nutzlast liefert: das
+ * PDF als Bytes oder die `data` einer Erfolgshuelle (etwa ein Lese-Link, wenn
+ * die Datei zu gross fuer die Antwort ist).
+ */
+export type PdfOrData = {
+    pdf: Uint8Array;
+} | {
+    data: unknown;
+};
+/**
+ * Ruft eine Backend-Funktion auf, die ein PDF **oder** eine JSON-Nutzlast
+ * liefert (Inventurprotokoll: die Datei bis 9 MiB, darueber ein Lese-Link).
+ */
+export type KasseneckPdfOrDataTransport = (functionName: string, params?: Record<string, unknown>) => Promise<PdfOrData>;
+/**
+ * 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 declare function createPdfOrDataTransport(options: TransportOptions): KasseneckPdfOrDataTransport;

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, getCashregisterReport, type CashregisterReportPeriod, 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, getCashregisterReport, 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';