@kreiseck/kasseneck-api 1.14.0 → 1.16.0

package/dist/esm/client/list-receipts.d.ts

@@ -0,0 +1,217 @@
+import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
+import { type CancellationReason, type CancellationStatus, type Receipt, type ReceiptPayment, type ZeroKind } from '../models/index.js';
+import type { ReportV2Metadata } from './reports.js';
+import type { InternerTransport } from './aufrufe.js';
+/**
+ * Belege einer Kasse auflisten (`listReceipts`, nur unter `/v3`): ein Tag oder
+ * ein Zeitraum von hoechstens 31 Kalendertagen, Seite fuer Seite ueber einen
+ * undurchsichtigen Cursor. Nachfolger von `getReportV2` fuer Listen;
+ * `getReportV2` bleibt fuer Berichte.
+ *
+ * **Anmeldung wie `getReportV2`:** API-Schluessel plus `cashregister-token`
+ * (`apiKeyAuth`); die Kasse kommt aus dem Token, nie aus einem Parameter.
+ * Kassen-Bediener (Geraet + PIN) weist der Server ab; die Kasse hat dafuer
+ * `listMyReceipts` am Kassenweg. Dieses Paket bildet das nicht nach, wer darf,
+ * entscheidet allein das Backend.
+ *
+ * Zeiten sind die **Wiener Wanduhr** als Text, wie `timeStamp` am Beleg; der
+ * Server vergleicht sie als Text. Ein Tag ist ein Kalendertag, auch an den
+ * Tagen der Zeitumstellung, und die Grenze von 31 Tagen zaehlt Kalendertage,
+ * nicht 31 x 24 Stunden. Die Pruefung hier rechnet darum ohne Zeitzone, genau
+ * wie der Server (`beleg-liste-core.js`).
+ */
+/** Ansicht einer Seite: `summary` eine schlanke Zeile je Beleg, `full` das gespeicherte Belegdokument. */
+export declare const LIST_RECEIPTS_VIEWS: readonly ["summary", "full"];
+export type ListReceiptsView = (typeof LIST_RECEIPTS_VIEWS)[number];
+/** Reihenfolge: `desc` neueste zuerst (Vorgabe des Servers), `asc` aelteste zuerst. */
+export declare const LIST_RECEIPTS_ORDERS: readonly ["desc", "asc"];
+export type ListReceiptsOrder = (typeof LIST_RECEIPTS_ORDERS)[number];
+/** Groesste Seite, die der Server liefert (`limit`); ohne Angabe nimmt er 100. */
+export declare const LIST_RECEIPTS_LIMIT_MAX = 500;
+/** Laengster Zeitraum in Kalendertagen (`to` hoechstens `from` + 31 Tage). */
+export declare const LIST_RECEIPTS_DAYS_MAX = 31;
+/**
+ * So viele Seiten holt [listAllReceipts] hoechstens, dann bricht er mit
+ * Fehler ab. Schutz gegen einen Cursor, der nie endet; mit der Seitengroesse
+ * des Helfers (500) sind das 50.000 Belege, mehr als jede Kasse in 31 Tagen
+ * ausstellt.
+ */
+export declare const LIST_ALL_RECEIPTS_MAX_PAGES = 100;
+/**
+ * Fehlercodes von `listReceipts` (`code` des [KasseneckApiError]), dazu die
+ * gemeinsamen Codes von Anmeldung und Rand (Kassen-Token, Live-Gate,
+ * API-Freigabe). Ein Code ausserhalb bleibt ueber `KasseneckApiError.code`
+ * lesbar. Die Regeln der ersten sieben prueft dieses Paket schon vor dem
+ * Senden (ausser `invalid_cursor`: ob ein Cursor zur Abfrage passt, weiss nur
+ * der Server).
+ */
+export declare const LIST_RECEIPTS_ERROR_CODES: readonly ["invalid_date", "invalid_range", "range_too_long", "invalid_limit", "invalid_order", "invalid_view", "invalid_cursor", "server_error"];
+export type ListReceiptsErrorCode = (typeof LIST_RECEIPTS_ERROR_CODES)[number];
+/**
+ * Eingabe von [listReceipts]. Genau eine Form des Zeitfensters: `date` ODER
+ * `from` + `to`.
+ *
+ * - `date`: ein Wiener Tag, `YYYY-MM-DD` (00:00:00 bis zum Beginn des
+ *   Folgetags). Nur mit `date` traegt die erste Seite `daySummary`.
+ * - `from` (einschliesslich) und `to` (ausschliesslich): `YYYY-MM-DD` oder
+ *   `YYYY-MM-DDTHH:mm:ss`, Wiener Wanduhr ohne Zone. Ein reines Datum heisst
+ *   Beginn dieses Tages; `to` liegt hoechstens 31 Kalendertage nach `from`.
+ *
+ * Mit `cursor` (dem `nextCursor` der Vorseite) muessen Zeitfenster, `order`
+ * und `view` gleich bleiben wie auf Seite 1, sonst antwortet der Server
+ * `invalid_cursor`; `limit` darf sich aendern.
+ */
+export type ListReceiptsOptions<V extends ListReceiptsView = ListReceiptsView> = ListReceiptsWindow & {
+    /** Seitengroesse, ganze Zahl 1-500; ohne Angabe 100. */
+    limit?: number;
+    /** Ohne Angabe `desc` (neueste zuerst). */
+    order?: ListReceiptsOrder;
+    /** Ohne Angabe `summary`. */
+    view?: V;
+    /** `nextCursor` der vorigen Seite. */
+    cursor?: string;
+};
+/** Zeitfenster von [ListReceiptsOptions]: ein Tag oder ein Zeitraum. */
+export type ListReceiptsWindow = {
+    date: string;
+    from?: undefined;
+    to?: undefined;
+} | {
+    from: string;
+    to: string;
+    date?: undefined;
+};
+/** Brutto je RKSV-Satzgruppe in Cent (`amountRateStandard` bis `amountRateSpecial` am Beleg). */
+export interface ListReceiptsGrossByRate {
+    standard: number;
+    reduced1: number;
+    reduced2: number;
+    zero: number;
+    special: number;
+}
+/**
+ * Zeile eines Belegs in [listReceipts] mit `view: 'summary'`. Betraege in
+ * ganzen Cent. Kein Layout, kein Kopf, keine Positionen und keine
+ * Pruefangaben: fuer die Detailansicht `getReceipt`, fuer die PDF
+ * `downloadReceipt` mit `fullReceiptId`.
+ *
+ * Nicht zu verwechseln mit [ReceiptSummary] von `listMyReceipts` (Kassenweg,
+ * andere Felder, Betrag dort aus Euro gerechnet).
+ *
+ * `receiptType` und `paymentMethod` sind wie ueberall beim Lesen der bekannte
+ * Enum-Eintrag oder der rohe Schluessel; ein Wert, den dieses Paket nicht
+ * kennt, laesst die Liste nicht scheitern.
+ */
+export interface ListReceiptsSummary {
+    receiptId: string | null;
+    /** Fortlaufender Belegzaehler der Kasse; `null` bei Alt-Belegen. */
+    counter: number | null;
+    receiptType: ReceiptType | string | null;
+    /** Nur am Nullbeleg: Anlass (`manual`, wenn der Beleg keinen nennt); sonst `null`. */
+    zeroKind: ZeroKind | string | null;
+    /** Roher Belegzeitstempel (Wiener Wanduhr); Deutung ueber `parseServerTimeStamp`. */
+    timeStamp: string | null;
+    /** Summe von `grossByRateCents`; negativ am Storno-Beleg. */
+    totalCents: number;
+    grossByRateCents: ListReceiptsGrossByRate;
+    /** `mixed` bei mehreren Zahlungen (die stehen dann in `payments`). */
+    paymentMethod: KeckPaymentMethod | string | null;
+    /** Nur wenn der Beleg eine Zahlungsliste traegt; ohne Anbieterdaten. */
+    payments?: ReceiptPayment[];
+    /** Nur wenn der Beleg Trinkgeld traegt. */
+    tipCents?: number;
+    /** Bediener (nur der Name), oder `null`. */
+    operator: {
+        name: string;
+    } | null;
+    /** Nur am Storno-Beleg: das Original. */
+    cancellationOf: {
+        receiptId: string | null;
+        timeStamp: string | null;
+    } | null;
+    cancellationReason: CancellationReason | string | null;
+    /**
+     * Storno-Stand: `none`, `partial` oder `full` (nur an Normalbelegen anders
+     * als `none`). Ein Wert, den dieses Paket nicht kennt, kommt als
+     * `'unknown'` an, nie still als `none`: dann keinen Storno anbieten, bis
+     * der Beleg einzeln gelesen ist.
+     */
+    cancellationStatus: CancellationStatus | 'unknown';
+    /** Mit funktionierender Signatureinheit ausgestellt (`signatureSuccess !== false`). */
+    signatureOk: boolean;
+    /** Eigene Referenz des Aufrufers am Beleg, oder `null`. */
+    customProjectId: string | null;
+    /** Schluessel fuer `downloadReceipt` und den Beleg-Link, oder `null`. */
+    fullReceiptId: string | null;
+}
+/** Ein Beleg der Liste je Ansicht: `full` das Belegdokument wie bei `getReportV2`, sonst die Zeile. */
+export type ListedReceipt<V extends ListReceiptsView = 'summary'> = V extends 'full' ? Receipt : ListReceiptsSummary;
+/**
+ * Tagessumme aus der Tagesstatistik der Kasse, nur bei `date` und nur auf
+ * der ersten Seite. **Nicht die Summe der Liste:** `receiptCount` zaehlt jeden
+ * Beleg des Tages (auch Null-, Start- und Trainingsbelege), `revenueCents`
+ * nur Normal- und Storno-Belege, ohne Mitarbeiter-Trinkgeld und nach
+ * Aktionsrabatt. Wer die Liste summieren will, summiert die Liste.
+ */
+export interface ListReceiptsDaySummary {
+    date: string;
+    receiptCount: number;
+    revenueCents: number;
+    /** Je Steuersatz (Basispunkte, 2000 = 20 %), hoechster zuerst; Saetze ohne Umsatz fehlen. */
+    revenueByRate: Array<{
+        rateBp: number;
+        grossCents: number;
+    }>;
+}
+/** Eine Seite von [listReceipts]. */
+export interface ListReceiptsPage<V extends ListReceiptsView = 'summary'> {
+    receipts: Array<ListedReceipt<V>>;
+    /** Es gibt weitere Belege: mit `cursor: nextCursor` weiterlesen. */
+    hasMore: boolean;
+    /** `null`, wenn `hasMore` false ist. */
+    nextCursor: string | null;
+    /**
+     * Nur bei `date` auf der ersten Seite (ohne `cursor`); `null`, wenn es fuer
+     * den Tag keine Statistik gibt. Auf allen anderen Seiten fehlt das Feld.
+     */
+    daySummary?: ListReceiptsDaySummary | null;
+    /**
+     * Nur bei `view: 'full'`: Firmendaten fuer den Belegkopf (Nachdruck), dieselben Felder wie
+     * `getReportV2().metadata`. Bei der Kurzansicht fehlt das Feld.
+     */
+    metadata?: V extends 'full' ? ReportV2Metadata : never;
+}
+/** Zeile `view: summary` vom Draht. */
+export declare function fromListReceiptsSummaryPayload(payload: Record<string, unknown>): ListReceiptsSummary;
+/**
+ * Eine Seite Belege der angemeldeten Kasse (`listReceipts`). Die Eingabe wird
+ * vor dem Senden nach den Regeln des Servers geprueft (genau eine Form des
+ * Zeitfensters, Datumsformat, hoechstens 31 Kalendertage, `limit` 1-500,
+ * `order`, `view`); ein Verstoss wirft [KasseneckValidationError] mit
+ * `scope: 'request'`, ohne dass etwas hinausgeht.
+ *
+ * Mit `view: 'full'` sind die Belege das gespeicherte Belegdokument
+ * ([Receipt], dieselbe Form wie `getReportV2`), sonst [ListReceiptsSummary].
+ * Alle Seiten auf einmal: [listAllReceipts].
+ */
+export declare function listReceipts<V extends ListReceiptsView = 'summary'>(transport: InternerTransport, options: ListReceiptsOptions<V>): Promise<ListReceiptsPage<V>>;
+/**
+ * Alle Belege eines Tages oder Zeitraums, Seite fuer Seite: holt mit
+ * [listReceipts] die erste Seite, dann mit `cursor: nextCursor` und
+ * demselben Zeitfenster, `order` und `view` jede weitere, und liefert jeden
+ * Beleg einzeln, in der Reihenfolge des Servers. Jeder Beleg des Fensters
+ * kommt genau einmal.
+ *
+ * Ohne `limit` holt der Helfer Seiten zu 500 (weniger Aufrufe als die
+ * Vorgabe 100 des Servers). Mit `cursor` setzt er an dieser Stelle fort.
+ *
+ * Ein Fehler auf irgendeiner Seite bricht ab (der Fehler kommt im
+ * `for await` an); die bis dahin gelieferten Belege bleiben gueltig. Nach
+ * [LIST_ALL_RECEIPTS_MAX_PAGES] Seiten, oder wenn der Server denselben
+ * Cursor zweimal nennt, bricht er mit [KasseneckValidationError]
+ * (`scope: 'response'`) ab, statt endlos zu laufen.
+ *
+ * `daySummary` liefert der Helfer nicht; wer sie braucht, ruft die erste
+ * Seite mit [listReceipts].
+ */
+export declare function listAllReceipts<V extends ListReceiptsView = 'summary'>(transport: InternerTransport, options: ListReceiptsOptions<V>): AsyncGenerator<ListedReceipt<V>, void, undefined>;

package/dist/esm/client/list-receipts.js

@@ -0,0 +1,292 @@
+import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
+import { CANCELLATION_STATUSES, fromReceiptCompanyPayload, fromReceiptPayload, fromReceiptPaymentPayload, } from '../models/index.js';
+import { readEnumKey } from '../models/enum-payload.js';
+import { KasseneckValidationError } from './errors.js';
+/**
+ * Belege einer Kasse auflisten (`listReceipts`, nur unter `/v3`): ein Tag oder
+ * ein Zeitraum von hoechstens 31 Kalendertagen, Seite fuer Seite ueber einen
+ * undurchsichtigen Cursor. Nachfolger von `getReportV2` fuer Listen;
+ * `getReportV2` bleibt fuer Berichte.
+ *
+ * **Anmeldung wie `getReportV2`:** API-Schluessel plus `cashregister-token`
+ * (`apiKeyAuth`); die Kasse kommt aus dem Token, nie aus einem Parameter.
+ * Kassen-Bediener (Geraet + PIN) weist der Server ab; die Kasse hat dafuer
+ * `listMyReceipts` am Kassenweg. Dieses Paket bildet das nicht nach, wer darf,
+ * entscheidet allein das Backend.
+ *
+ * Zeiten sind die **Wiener Wanduhr** als Text, wie `timeStamp` am Beleg; der
+ * Server vergleicht sie als Text. Ein Tag ist ein Kalendertag, auch an den
+ * Tagen der Zeitumstellung, und die Grenze von 31 Tagen zaehlt Kalendertage,
+ * nicht 31 x 24 Stunden. Die Pruefung hier rechnet darum ohne Zeitzone, genau
+ * wie der Server (`beleg-liste-core.js`).
+ */
+/** Ansicht einer Seite: `summary` eine schlanke Zeile je Beleg, `full` das gespeicherte Belegdokument. */
+export const LIST_RECEIPTS_VIEWS = Object.freeze(['summary', 'full']);
+/** Reihenfolge: `desc` neueste zuerst (Vorgabe des Servers), `asc` aelteste zuerst. */
+export const LIST_RECEIPTS_ORDERS = Object.freeze(['desc', 'asc']);
+/** Groesste Seite, die der Server liefert (`limit`); ohne Angabe nimmt er 100. */
+export const LIST_RECEIPTS_LIMIT_MAX = 500;
+/** Laengster Zeitraum in Kalendertagen (`to` hoechstens `from` + 31 Tage). */
+export const LIST_RECEIPTS_DAYS_MAX = 31;
+/**
+ * So viele Seiten holt [listAllReceipts] hoechstens, dann bricht er mit
+ * Fehler ab. Schutz gegen einen Cursor, der nie endet; mit der Seitengroesse
+ * des Helfers (500) sind das 50.000 Belege, mehr als jede Kasse in 31 Tagen
+ * ausstellt.
+ */
+export const LIST_ALL_RECEIPTS_MAX_PAGES = 100;
+/**
+ * Fehlercodes von `listReceipts` (`code` des [KasseneckApiError]), dazu die
+ * gemeinsamen Codes von Anmeldung und Rand (Kassen-Token, Live-Gate,
+ * API-Freigabe). Ein Code ausserhalb bleibt ueber `KasseneckApiError.code`
+ * lesbar. Die Regeln der ersten sieben prueft dieses Paket schon vor dem
+ * Senden (ausser `invalid_cursor`: ob ein Cursor zur Abfrage passt, weiss nur
+ * der Server).
+ */
+export const LIST_RECEIPTS_ERROR_CODES = Object.freeze([
+    'invalid_date', // kein Datum JJJJ-MM-TT bzw. Zeitpunkt JJJJ-MM-TTThh:mm:ss, oder unmoeglich (2026-02-30)
+    'invalid_range', // nicht genau eine Form (date ODER from + to), oder to nicht nach from
+    'range_too_long', // mehr als 31 Kalendertage
+    'invalid_limit', // keine ganze Zahl von 1 bis 500 (der Server kappt nie still)
+    'invalid_order', // weder desc noch asc
+    'invalid_view', // weder summary noch full
+    'invalid_cursor', // veraendert, fremde Kasse, oder Zeitfenster/order/view anders als auf Seite 1
+    'server_error',
+]);
+const TAG = /^(\d{4})-(\d{2})-(\d{2})$/;
+const ZEIT = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/;
+/** Kalendertag als UTC-Mitternacht (nur zum Rechnen mit Tagen; auch fuer Jahre unter 100). */
+function utcTag(jahr, monat, tag) {
+    const d = new Date(Date.UTC(2000, 0, 1));
+    d.setUTCFullYear(jahr, monat - 1, tag);
+    return d;
+}
+/** Ein echtes Kalenderdatum (2026-02-30 nicht)? */
+function kalendertag(jahr, monat, tag) {
+    const d = utcTag(jahr, monat, tag);
+    return d.getUTCFullYear() === jahr && d.getUTCMonth() === monat - 1 && d.getUTCDate() === tag;
+}
+const zwei = (n) => String(n).padStart(2, '0');
+/** Wanduhr-Text `YYYY-MM-DDTHH:mm:ss` aus einem Tag oder Zeitpunkt; sonst `null`. */
+function wanduhr(wert) {
+    if (typeof wert !== 'string')
+        return null;
+    const t = TAG.exec(wert);
+    if (t)
+        return kalendertag(+t[1], +t[2], +t[3]) ? `${wert}T00:00:00` : null;
+    const z = ZEIT.exec(wert);
+    if (z && kalendertag(+z[1], +z[2], +z[3]) && +z[4] <= 23 && +z[5] <= 59 && +z[6] <= 59)
+        return wert;
+    return null;
+}
+/** Wanduhr-Text plus ganze Kalendertage, Uhrzeit bleibt (ohne Zeitzone gerechnet). */
+function plusTage(zeit, tage) {
+    const [datum, uhr] = zeit.split('T');
+    const [j, m, t] = datum.split('-').map(Number);
+    const d = utcTag(j, m, t + tage);
+    return `${String(d.getUTCFullYear()).padStart(4, '0')}-${zwei(d.getUTCMonth() + 1)}-${zwei(d.getUTCDate())}T${uhr}`;
+}
+const gesetzt = (v) => v !== undefined && v !== null;
+/** Fehler in der Eingabe des Aufrufers: es geht keine Anfrage raus. */
+function eingabefehler(grund) {
+    return new KasseneckValidationError('listReceipts', grund, 'request');
+}
+/** Antwort meldet Erfolg, traegt aber nicht, was der Aufruf zusagt. */
+function antwortfehler(grund) {
+    return new KasseneckValidationError('listReceipts', grund, 'response');
+}
+/**
+ * Prueft die Eingabe nach den Regeln des Servers und gibt die Parameter
+ * zurueck, die hinausgehen (nur gesetzte Felder, Werte unveraendert, damit
+ * Folgeseiten dasselbe Fenster senden).
+ */
+function parameter(options) {
+    if (options == null || typeof options !== 'object')
+        throw eingabefehler('Optionen fehlen (date oder from und to)');
+    const o = options;
+    const raus = {};
+    if (gesetzt(o.date)) {
+        if (gesetzt(o.from) || gesetzt(o.to))
+            throw eingabefehler('entweder date oder from und to angeben, nicht beides');
+        if (typeof o.date !== 'string' || !TAG.test(o.date) || wanduhr(o.date) === null) {
+            throw eingabefehler(`date muss ein Datum YYYY-MM-DD sein, war "${String(o.date)}"`);
+        }
+        raus['date'] = o.date;
+    }
+    else {
+        if (!gesetzt(o.from) || !gesetzt(o.to))
+            throw eingabefehler('Zeitraum fehlt: date oder from und to angeben');
+        const von = wanduhr(o.from);
+        if (von === null)
+            throw eingabefehler(`from muss YYYY-MM-DD oder YYYY-MM-DDTHH:mm:ss sein, war "${String(o.from)}"`);
+        const bis = wanduhr(o.to);
+        if (bis === null)
+            throw eingabefehler(`to muss YYYY-MM-DD oder YYYY-MM-DDTHH:mm:ss sein, war "${String(o.to)}"`);
+        if (bis <= von)
+            throw eingabefehler('to muss nach from liegen (to ist ausschliesslich)');
+        if (bis > plusTage(von, LIST_RECEIPTS_DAYS_MAX)) {
+            throw eingabefehler(`Zeitraum hoechstens ${LIST_RECEIPTS_DAYS_MAX} Kalendertage (to hoechstens from + ${LIST_RECEIPTS_DAYS_MAX} Tage)`);
+        }
+        raus['from'] = o.from;
+        raus['to'] = o.to;
+    }
+    if (gesetzt(o.limit)) {
+        if (!Number.isInteger(o.limit) || o.limit < 1 || o.limit > LIST_RECEIPTS_LIMIT_MAX) {
+            throw eingabefehler(`limit muss eine ganze Zahl von 1 bis ${LIST_RECEIPTS_LIMIT_MAX} sein, war "${String(o.limit)}"`);
+        }
+        raus['limit'] = o.limit;
+    }
+    if (gesetzt(o.order)) {
+        if (!LIST_RECEIPTS_ORDERS.includes(o.order))
+            throw eingabefehler(`order muss desc oder asc sein, war "${String(o.order)}"`);
+        raus['order'] = o.order;
+    }
+    if (gesetzt(o.view)) {
+        if (!LIST_RECEIPTS_VIEWS.includes(o.view))
+            throw eingabefehler(`view muss summary oder full sein, war "${String(o.view)}"`);
+        raus['view'] = o.view;
+    }
+    if (gesetzt(o.cursor)) {
+        if (typeof o.cursor !== 'string' || o.cursor === '')
+            throw eingabefehler('cursor muss der nextCursor der vorigen Seite sein (nicht leerer Text)');
+        raus['cursor'] = o.cursor;
+    }
+    return raus;
+}
+const istObjekt = (w) => w != null && typeof w === 'object' && !Array.isArray(w);
+const text = (w) => (typeof w === 'string' ? w : null);
+// Ganze Cent; ein einzelner unbrauchbarer Betrag laesst die Liste nicht scheitern.
+const cent = (w) => (typeof w === 'number' && Number.isInteger(w) ? w : 0);
+function istStornoStand(w) {
+    return typeof w === 'string' && CANCELLATION_STATUSES.includes(w);
+}
+/** Zeile `view: summary` vom Draht. */
+export function fromListReceiptsSummaryPayload(payload) {
+    const brutto = istObjekt(payload['grossByRateCents']) ? payload['grossByRateCents'] : {};
+    const bediener = payload['operator'];
+    const bezug = payload['cancellationOf'];
+    return {
+        receiptId: text(payload['receiptId']),
+        counter: typeof payload['counter'] === 'number' ? payload['counter'] : null,
+        receiptType: typeof payload['receiptType'] === 'string' ? readEnumKey(ReceiptType, payload['receiptType']) : null,
+        zeroKind: text(payload['zeroKind']),
+        timeStamp: text(payload['timeStamp']),
+        totalCents: cent(payload['totalCents']),
+        grossByRateCents: {
+            standard: cent(brutto['standard']),
+            reduced1: cent(brutto['reduced1']),
+            reduced2: cent(brutto['reduced2']),
+            zero: cent(brutto['zero']),
+            special: cent(brutto['special']),
+        },
+        paymentMethod: typeof payload['paymentMethod'] === 'string' ? readEnumKey(KeckPaymentMethod, payload['paymentMethod']) : null,
+        ...(Array.isArray(payload['payments'])
+            ? { payments: payload['payments'].filter(istObjekt).map((z) => fromReceiptPaymentPayload(z)) }
+            : {}),
+        ...(typeof payload['tipCents'] === 'number' ? { tipCents: payload['tipCents'] } : {}),
+        operator: istObjekt(bediener) ? { name: typeof bediener['name'] === 'string' ? bediener['name'] : '' } : null,
+        cancellationOf: istObjekt(bezug) ? { receiptId: text(bezug['receiptId']), timeStamp: text(bezug['timeStamp']) } : null,
+        cancellationReason: text(payload['cancellationReason']),
+        cancellationStatus: istStornoStand(payload['cancellationStatus']) ? payload['cancellationStatus'] : 'unknown',
+        signatureOk: payload['signatureOk'] !== false,
+        customProjectId: text(payload['customProjectId']),
+        fullReceiptId: text(payload['fullReceiptId']),
+    };
+}
+function tagessumme(roh) {
+    if (roh === null)
+        return null;
+    if (!istObjekt(roh))
+        throw antwortfehler('daySummary ist weder ein Objekt noch null');
+    const saetze = Array.isArray(roh['revenueByRate']) ? roh['revenueByRate'] : [];
+    return {
+        date: typeof roh['date'] === 'string' ? roh['date'] : '',
+        receiptCount: cent(roh['receiptCount']),
+        revenueCents: cent(roh['revenueCents']),
+        revenueByRate: saetze.filter(istObjekt).map((z) => ({ rateBp: cent(z['rateBp']), grossCents: cent(z['grossCents']) })),
+    };
+}
+/** `metadata` der vollen Ansicht wie bei getReportV2: Firmendaten plus Bezeichnung der Kasse. */
+function kopfdaten(roh) {
+    if (!istObjekt(roh))
+        throw antwortfehler('metadata ist kein Objekt');
+    const label = roh.label;
+    return { ...fromReceiptCompanyPayload(roh), label: typeof label === 'string' ? label : '' };
+}
+/**
+ * Eine Seite Belege der angemeldeten Kasse (`listReceipts`). Die Eingabe wird
+ * vor dem Senden nach den Regeln des Servers geprueft (genau eine Form des
+ * Zeitfensters, Datumsformat, hoechstens 31 Kalendertage, `limit` 1-500,
+ * `order`, `view`); ein Verstoss wirft [KasseneckValidationError] mit
+ * `scope: 'request'`, ohne dass etwas hinausgeht.
+ *
+ * Mit `view: 'full'` sind die Belege das gespeicherte Belegdokument
+ * ([Receipt], dieselbe Form wie `getReportV2`), sonst [ListReceiptsSummary].
+ * Alle Seiten auf einmal: [listAllReceipts].
+ */
+export async function listReceipts(transport, options) {
+    const params = parameter(options);
+    const voll = params['view'] === 'full';
+    const daten = await transport('listReceipts', params);
+    if (!istObjekt(daten))
+        throw antwortfehler('Antwort enthaelt keine Daten (data fehlt)');
+    const liste = daten['receipts'];
+    if (!Array.isArray(liste) || liste.some((b) => !istObjekt(b))) {
+        throw antwortfehler('Antwort enthaelt keine Belegliste (data.receipts fehlt)');
+    }
+    if (typeof daten['hasMore'] !== 'boolean')
+        throw antwortfehler('Antwort ohne hasMore');
+    const weiter = daten['nextCursor'];
+    // Ein `hasMore` ohne Cursor liesse den Aufrufer ratlos (oder einen Blaetterer im Kreis laufen).
+    if (daten['hasMore'] ? typeof weiter !== 'string' || weiter === '' : weiter !== null) {
+        throw antwortfehler('nextCursor passt nicht zu hasMore (Text bei hasMore, sonst null)');
+    }
+    const receipts = (voll
+        ? liste.map((b) => fromReceiptPayload(b))
+        : liste.map((b) => fromListReceiptsSummaryPayload(b)));
+    return {
+        receipts,
+        hasMore: daten['hasMore'],
+        nextCursor: daten['hasMore'] ? weiter : null,
+        ...('daySummary' in daten ? { daySummary: tagessumme(daten['daySummary']) } : {}),
+        ...(voll && 'metadata' in daten ? { metadata: kopfdaten(daten['metadata']) } : {}),
+    };
+}
+/**
+ * Alle Belege eines Tages oder Zeitraums, Seite fuer Seite: holt mit
+ * [listReceipts] die erste Seite, dann mit `cursor: nextCursor` und
+ * demselben Zeitfenster, `order` und `view` jede weitere, und liefert jeden
+ * Beleg einzeln, in der Reihenfolge des Servers. Jeder Beleg des Fensters
+ * kommt genau einmal.
+ *
+ * Ohne `limit` holt der Helfer Seiten zu 500 (weniger Aufrufe als die
+ * Vorgabe 100 des Servers). Mit `cursor` setzt er an dieser Stelle fort.
+ *
+ * Ein Fehler auf irgendeiner Seite bricht ab (der Fehler kommt im
+ * `for await` an); die bis dahin gelieferten Belege bleiben gueltig. Nach
+ * [LIST_ALL_RECEIPTS_MAX_PAGES] Seiten, oder wenn der Server denselben
+ * Cursor zweimal nennt, bricht er mit [KasseneckValidationError]
+ * (`scope: 'response'`) ab, statt endlos zu laufen.
+ *
+ * `daySummary` liefert der Helfer nicht; wer sie braucht, ruft die erste
+ * Seite mit [listReceipts].
+ */
+export async function* listAllReceipts(transport, options) {
+    // Frueh pruefen: ein Eingabefehler kommt beim ersten Schritt an, vor jedem Aufruf.
+    parameter(options);
+    const grund = { ...options, limit: options.limit ?? LIST_RECEIPTS_LIMIT_MAX };
+    let cursor = options.cursor;
+    const gesehen = new Set();
+    for (let seite = 1; seite <= LIST_ALL_RECEIPTS_MAX_PAGES; seite++) {
+        const page = await listReceipts(transport, { ...grund, cursor });
+        yield* page.receipts;
+        if (!page.hasMore)
+            return;
+        const weiter = page.nextCursor;
+        if (gesehen.has(weiter) || weiter === cursor)
+            throw antwortfehler('Server nennt denselben Cursor erneut; Abbruch statt Endlosschleife');
+        gesehen.add(weiter);
+        cursor = weiter;
+    }
+    throw antwortfehler(`mehr als ${LIST_ALL_RECEIPTS_MAX_PAGES} Seiten; Zeitfenster kleiner waehlen`);
+}

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, isVoucherItem, isVoucherFloatItem, type Voucher, type VoucherArticle, type IssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, 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, RECEIPT_OUTPUT_KINDS, type ReceiptOutputKind, RECEIPT_OUTPUT_LOG_KINDS, type ReceiptOutputLogKind, RECEIPT_OUTPUT_RESULTS, type ReceiptOutputResult, RECEIPT_OUTPUT_ENTRIES_MAX, type ReceiptOutput, type ReceiptOutputActor, RECEIPT_OUTPUT_ENTRY_ERROR_CODES, type ReceiptOutputEntryErrorCode, RECEIPT_OUTPUT_ERROR_CODES, type ReceiptOutputErrorCode, isReceiptOutputErrorCode, receiptOutputErrorCode, isReceiptOutputError, receiptOutputFieldErrors, type ReceiptOutputFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, 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, 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, type ReceiptOutputEntry, type LogReceiptOutputsOptions, type LogReceiptOutputsResult, type RejectedReceiptOutput, logReceiptOutputs, 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 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, type ReceiptOutputEntry, type LogReceiptOutputsOptions, type LogReceiptOutputsResult, type RejectedReceiptOutput, logReceiptOutputs, downloadDailyReport, downloadMonthlyReport, getCashregisterReport, type CashregisterReportPeriod, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, listReceipts, listAllReceipts, fromListReceiptsSummaryPayload, LIST_RECEIPTS_VIEWS, LIST_RECEIPTS_ORDERS, LIST_RECEIPTS_LIMIT_MAX, LIST_RECEIPTS_DAYS_MAX, LIST_ALL_RECEIPTS_MAX_PAGES, LIST_RECEIPTS_ERROR_CODES, type ListReceiptsErrorCode, type ListReceiptsView, type ListReceiptsOrder, type ListReceiptsOptions, type ListReceiptsWindow, type ListReceiptsGrossByRate, type ListReceiptsSummary, type ListReceiptsDaySummary, type ListReceiptsPage, type ListedReceipt, 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, type VoucherDueInfo, type VoucherDueArticle, type VoucherRedeemContext, voucherRedeemMaxCents, VOUCHER_ZERO_RATE_BUCKET_FROM, } 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, voucherPermsOf, } 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, isVoucherItem, isVoucherFloatItem, toVoucherPayload, fromVoucherPayload, voucherIsValid, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, 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_OUTPUT_KINDS, RECEIPT_OUTPUT_LOG_KINDS, RECEIPT_OUTPUT_RESULTS, RECEIPT_OUTPUT_ENTRIES_MAX, RECEIPT_OUTPUT_ENTRY_ERROR_CODES, RECEIPT_OUTPUT_ERROR_CODES, isReceiptOutputErrorCode, receiptOutputErrorCode, isReceiptOutputError, receiptOutputFieldErrors, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, TIP_REFUND_SOURCES, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, 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, 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, logReceiptOutputs, downloadDailyReport, downloadMonthlyReport, getCashregisterReport, 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, logReceiptOutputs, downloadDailyReport, downloadMonthlyReport, getCashregisterReport, getReportV2, listReceipts, listAllReceipts, fromListReceiptsSummaryPayload, LIST_RECEIPTS_VIEWS, LIST_RECEIPTS_ORDERS, LIST_RECEIPTS_LIMIT_MAX, LIST_RECEIPTS_DAYS_MAX, LIST_ALL_RECEIPTS_MAX_PAGES, LIST_RECEIPTS_ERROR_CODES, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/index.js';
 export { receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, voucherRedeemMaxCents, VOUCHER_ZERO_RATE_BUCKET_FROM, } 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, voucherPermsOf, } from './pos/index.js';

package/dist/esm/invoice/vertrag.d.ts

@@ -27,7 +27,7 @@ export type InvoiceEndpoint = (typeof INVOICE_ENDPOINTS)[number];
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
  * aendern. `validation` traegt zusaetzlich `errors: [{ field, message }]`.
  */
-export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete", "language_not_allowed", "brand_not_found", "not_payable", "payment_exceeds_invoice", "tax_scheme_mismatch", "vat_rate_not_in_country", "reverse_charge_reason_required", "reverse_charge_threshold", "mixed_supply_not_allowed", "oss_not_enabled", "einvoice_unavailable", "amount_too_large", "vat_id_invalid", "vat_id_check_pending", "reservation_not_found", "reservation_mismatch", "reservation_not_active"];
+export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete", "language_not_allowed", "brand_not_found", "not_payable", "payment_exceeds_invoice", "tax_scheme_mismatch", "vat_rate_not_in_country", "reverse_charge_reason_required", "reverse_charge_threshold", "mixed_supply_not_allowed", "oss_not_enabled", "einvoice_unavailable", "amount_too_large", "vat_id_invalid", "vat_id_check_pending", "reservation_not_found", "reservation_mismatch", "reservation_not_active", "invoice_number_taken"];
 export type InvoiceErrorCode = (typeof INVOICE_ERROR_CODES)[number];
 /**
  * Codes, die Anmeldung und Rand auf jedem Rechnungsaufruf erzeugen koennen,

package/dist/esm/invoice/vertrag.js

@@ -77,6 +77,8 @@ export const INVOICE_ERROR_CODES = [
     'reservation_not_found', // unbekannt oder einem anderen Konto
     'reservation_mismatch', // keine offene Position mit gleichem Artikel am Lagerstandort der Rechnung
     'reservation_not_active', // schon eingeloest oder freigegeben
+    // Seit 1.15.0 (Vertrag): die Rechnungsnummer ist schon vergeben (§ 11 Abs. 1 Z 3 lit. h UStG), nichts ausgestellt.
+    'invoice_number_taken',
 ];
 /**
  * Codes, die Anmeldung und Rand auf jedem Rechnungsaufruf erzeugen koennen,

package/dist/esm/models/receipt-errors.d.ts

@@ -16,7 +16,7 @@ import { KasseneckApiError } from '../client/errors.js';
  * ...) stehen in [PAYMENT_ERROR_CODES]. Ein Code ausserhalb bleibt ueber
  * `KasseneckApiError.code` lesbar.
  */
-export declare const RECEIPT_ERROR_CODES: readonly ["cancellation_reference_unavailable", "cashregister_closed", "cashregister_decommissioned", "final_receipt_expired", "final_receipt_not_allowed", "module_inactive", "not_permitted", "receipt_limit_exceeded", "receipt_not_found", "receipt_outcome_unknown", "receipt_type_invalid", "server_error", "signature_incomplete", "signature_missing", "signing_failed", "small_business_vat_not_allowed", "tip_invalid", "tip_not_allowed", "tip_recipient_unknown", "validation", "voucher_balance_changed", "account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing", "response_unreadable"];
+export declare const RECEIPT_ERROR_CODES: readonly ["cancellation_reference_unavailable", "cashregister_closed", "cashregister_decommissioned", "final_receipt_expired", "final_receipt_not_allowed", "idempotency_conflict", "module_inactive", "not_permitted", "receipt_limit_exceeded", "receipt_not_found", "receipt_outcome_unknown", "receipt_type_invalid", "server_error", "signature_incomplete", "signature_missing", "signing_failed", "small_business_vat_not_allowed", "tip_invalid", "tip_not_allowed", "tip_recipient_unknown", "validation", "voucher_balance_changed", "account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing", "response_unreadable"];
 export type ReceiptErrorCode = (typeof RECEIPT_ERROR_CODES)[number];
 export declare function isReceiptErrorCode(value: unknown): value is ReceiptErrorCode;
 /** Der Code eines geworfenen Fehlers, wenn er in [RECEIPT_ERROR_CODES] steht; sonst `undefined`. */

package/dist/esm/models/receipt-errors.js

@@ -22,6 +22,9 @@ export const RECEIPT_ERROR_CODES = Object.freeze([
     'cashregister_decommissioned',
     'final_receipt_expired',
     'final_receipt_not_allowed',
+    // Seit 1.15.0 (Vertrag): derselbe idempotencyKey mit anderem Inhalt, nichts geschrieben. Der Server nimmt den
+    // Schluessel optional an; dieses Paket sendet (noch) keinen, der Code bleibt damit nur lesbar.
+    'idempotency_conflict',
     'module_inactive',
     'not_permitted',
     'receipt_limit_exceeded',

package/dist/esm/stored/vokabular.d.ts

@@ -1,5 +1,5 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "328c8d0ff0f496f8f6b7d9ed78673e7666980e38586ec7efacb442e6906d898a";
+export declare const VOKABULAR_QUELLE = "d11de425770bc431be9766199e4c9b3e712eb8e0eea84658f771a0f79d98e90e";
 /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
 export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
 export interface SchemaObjekt {

package/dist/esm/stored/vokabular.js

@@ -1,7 +1,7 @@
 // Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
 // Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export const VOKABULAR_QUELLE = "328c8d0ff0f496f8f6b7d9ed78673e7666980e38586ec7efacb442e6906d898a";
+export const VOKABULAR_QUELLE = "d11de425770bc431be9766199e4c9b3e712eb8e0eea84658f771a0f79d98e90e";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 export const SCHEMAS = {
     "getReceipt": {
@@ -202,7 +202,19 @@ export const SCHEMAS = {
                 "__": "gutscheine",
                 "sale": "verkauf",
                 "valueVoucherType": "wertArt",
-                "vatRateBp": "satzBp"
+                "vatRateBp": "satzBp",
+                "label": {
+                    "__": "etikett",
+                    "size": "groesse",
+                    "fields": {
+                        "__": "felder",
+                        "business": "betrieb",
+                        "value": "wert",
+                        "validity": "gueltigkeit",
+                        "checkPage": "pruefseite"
+                    },
+                    "freeText": "freitext"
+                }
             }
         },
         "werte": {

package/dist/esm/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.14.0";
+export declare const PACKAGE_VERSION = "1.16.0";