@kreiseck/kasseneck-api 1.12.0 → 1.14.0

package/dist/esm/client/receipts.js

@@ -1,8 +1,10 @@
 import { ReceiptType, KeckPaymentMethod, CreditCardProvider, VoucherAction, VoucherType, } from '../enums/index.js';
 import { fromReceiptCompanyPayload, fromReceiptPayload, toReceiptItemPayload, toVoucherPayload, receiptItemIsValid, voucherIsValid, isNewFormVoucher, voucherServerFields, fromReceiptSummaryPayload, isCancellationReason, isReturnDisposition, RETURN_DISPOSITIONS, isTipRefundSource, TIP_REFUND_SOURCES, RECEIPT_EMAIL_VIAS, readRegistrationInfo, } from '../models/index.js';
+import { RECEIPT_OUTPUT_ENTRIES_MAX, RECEIPT_OUTPUT_KINDS, RECEIPT_OUTPUT_RESULTS, receiptOutputsFromWire, } from '../models/receipt-output.js';
+import { VoucherCode } from '@kreiseck/validator';
 import { parseServerTimeStamp, toViennaWallClock } from '../vienna-time.js';
 import { euroToCents } from '../money.js';
-import { KasseneckValidationError, isKasseneckApiError, signiertGelesen } from './errors.js';
+import { KasseneckApiError, KasseneckValidationError, isKasseneckApiError, signiertGelesen } from './errors.js';
 import { buildReceiptLayout } from '../receipt/layout.js';
 /**
  * Das Zeilenmodell zum Drucken und Anzeigen eines Belegs aus einer Antwort.
@@ -38,14 +40,44 @@ export function receiptLayoutFromResult(result, options = {}) {
  * die Hand des Aufrufers, sondern zu einem der benannten Aufrufe darunter.
  */
 export async function createReceipt(rufen, options) {
-    const daten = await rufen('createReceipt', createReceiptParams(options));
+    const daten = await createReceiptRufen(rufen, options);
     return signiertGelesen('createReceipt', () => belegAusHuelle(daten, 'createReceipt'));
 }
 /** Wie [createReceipt], liest aus derselben Antwort zusaetzlich die Firmendaten. */
 async function createReceiptWithCompany(rufen, options) {
-    const daten = await rufen('createReceipt', createReceiptParams(options));
+    const daten = await createReceiptRufen(rufen, options);
     return signiertGelesen('createReceipt', () => belegMitFirmaAusHuelle(daten, 'createReceipt'));
 }
+/**
+ * Sendet `createReceipt`; die Gutschein-Codes der Nutzlast gelten als Geheimnis
+ * (normiert und formatiert): der Transport siebt Ursachen und Details, ein
+ * Servertext, der den Code wiederholt, wird hier geschwaerzt.
+ */
+async function createReceiptRufen(rufen, options) {
+    // Der Code geht so hinaus, wie er getippt wurde: die getippte Schreibweise (auch ungueltig,
+    // etwa mit falscher Pruefziffer) zaehlt ebenso als Geheimnis wie normiert und formatiert.
+    // Kurze Reste (Endung mit vier Zeichen) werden nie eingetragen.
+    const geheim = [...new Set((options.vouchers ?? []).flatMap((v) => {
+            if (typeof v.code !== 'string')
+                return [];
+            const roh = v.code.trim();
+            const geprueft = VoucherCode.validate(v.code);
+            const liste = geprueft.ok ? [geprueft.normalized, VoucherCode.format(geprueft.normalized)] : [];
+            if (roh.length >= 8)
+                liste.push(roh);
+            return liste;
+        }))].sort((a, b) => b.length - a.length);
+    try {
+        return await rufen('createReceipt', createReceiptParams(options), undefined, geheim);
+    }
+    catch (fehler) {
+        if (fehler instanceof KasseneckApiError && geheim.some((g) => fehler.serverMessage.includes(g))) {
+            const text = geheim.reduce((t, g) => t.split(g).join('****'), fehler.serverMessage);
+            throw new KasseneckApiError('createReceipt', text, fehler.details, fehler.code);
+        }
+        throw fehler;
+    }
+}
 /**
  * Baut die Nutzlast von `createReceipt` und prueft die Eingabe. Wirft, bevor
  * irgendetwas rausgeht — ein Beleg ist nicht folgenlos wiederholbar.
@@ -171,6 +203,24 @@ function pruefeRueckgabeWahl(wert, pfad) {
         throw new KasseneckValidationError('cancelReceipt', `${pfad}: erlaubt sind ${RETURN_DISPOSITIONS.join(', ')}`, 'request');
     }
 }
+/**
+ * Storno einer Gutschein-Auszahlung: genau eine positive Barzahlung ohne `refundOf`
+ * (das Geld kommt in die Lade zurueck). Alles andere bleibt Rueckzahlung mit negativem Betrag;
+ * ob der Beleg eine Auszahlung war, entscheidet der Server.
+ */
+function istStornoAuszahlung(payments, original) {
+    if (!Array.isArray(payments) || payments.length !== 1)
+        return false;
+    // Kennt der Aufrufer das Original und es hat keine Auszahlung, bleibt es bei negativen Rueckzahlungen.
+    if (original != null && !(original.vouchers ?? []).some((v) => v.action === VoucherAction.payout))
+        return false;
+    const z = payments[0];
+    if (z == null || typeof z !== 'object')
+        return false;
+    const m = z['method'];
+    const art = typeof m === 'object' && m !== null ? m.value : m;
+    return art === 'cash' && typeof z['amountCents'] === 'number' && z['amountCents'] > 0 && z['refundOf'] === undefined;
+}
 /**
  * Storno-Beleg zu einem bestehenden Beleg — voll oder in Teilen. Prueft die
  * Eingabe, bevor etwas hinausgeht; der Server haelt die Restmengen und die
@@ -218,7 +268,7 @@ export async function cancelReceipt(transport, options) {
         throw new KasseneckValidationError('cancelReceipt', `${altfeld} gibt es unter /v3 nicht mehr: Rueckzahlungen gehen als payments hinaus.`, 'request');
     }
     // `payments: null` gilt wie im Backend als nicht angegeben.
-    const zahlungen = options.payments != null ? gepruefteZahlungen(options.payments, true, 'cancelReceipt') : undefined;
+    const zahlungen = options.payments != null ? gepruefteZahlungen(options.payments, true, 'cancelReceipt', false, istStornoAuszahlung(options.payments, options.receipt)) : undefined;
     if (zahlungen !== undefined)
         pruefeKartenRueckbuchung(zahlungen, options.receipt);
     const params = { cashregisterId, originalReceiptId, reason: options.reason };
@@ -450,6 +500,111 @@ export async function sendReceiptEmail(transport, options) {
         via,
     };
 }
+const AUSGABEN_FELDER = ['entries'];
+const AUSGABE_FELDER = ['key', 'receiptId', 'kind', 'at', 'result'];
+/** Idempotenzschluessel eines Eintrags, wie der Server ihn annimmt. */
+const AUSGABE_SCHLUESSEL = /^[A-Za-z0-9_-]{8,64}$/;
+/** Zeitpunkt als Text: RFC 3339 mit Zone, bis zu sechs Nachkommastellen (wie der Server). */
+const AUSGABE_ZEIT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?(Z|[+-]\d{2}:\d{2})$/;
+/**
+ * Meldet Drucke und das Teilen eines Belegs an das Protokoll „Ausgaben“
+ * (Endpunkt `logReceiptOutputs`, nur ueber den Kassenweg `/api/v3`; mit
+ * `registerUserAuth` und mit `apiKeyAuth`). Registrierkassen-Erlass
+ * BMF-AV Nr. 2/2026, Abschnitt 4.2: die Belegerteilung ist zu dokumentieren.
+ * Der Beleg selbst bleibt unberuehrt; das Protokoll steht nie im DEP.
+ *
+ * **Ein Eintrag scheitert nie die anderen.** Der Server nimmt jeden Eintrag
+ * einzeln an oder lehnt ihn mit Code ab (`rejected`, Codes
+ * [RECEIPT_OUTPUT_ENTRY_ERROR_CODES]); nach einer Erfolgsantwort ist jeder
+ * gesendete Eintrag erledigt. Die Kasse puffert die Eintraege (offline,
+ * Neustart) und sendet sie spaeter; der Puffer blockiert nie Druck oder Teilen.
+ *
+ * **Wiederholen ist gefahrlos:** jeder Eintrag traegt seinen Schluessel. Bei
+ * unklarem Ausgang (`outcome: 'unknown'`) dieselben Eintraege mit denselben
+ * Schluesseln noch einmal senden.
+ *
+ * **Vor dem Senden abgewiesen** wird nur, was die ganze Anfrage scheitern
+ * liesse oder ohne Netz sicher falsch ist: keine oder mehr als 50 Eintraege,
+ * ein unbekanntes Feld (oben oder im Eintrag), ein fehlender Beleg, ein
+ * Schluessel ausserhalb der Regel des Servers, eine Art oder ein Ergebnis
+ * ausserhalb des Katalogs, eine Zeit, die weder ganze Millisekunden noch
+ * ISO 8601 mit Zone ist. `email` und `opened` gehen hinaus und kommen als
+ * `invalid_output_kind` zurueck: so verwirft der Puffer genau diesen Eintrag.
+ * Fehler der ganzen Anfrage: [RECEIPT_OUTPUT_ERROR_CODES].
+ */
+export async function logReceiptOutputs(transport, options) {
+    const name = 'logReceiptOutputs';
+    const anfrage = (grund) => new KasseneckValidationError(name, grund, 'request');
+    if (options === null || typeof options !== 'object' || Array.isArray(options))
+        throw anfrage('Anfrage muss ein Objekt sein');
+    // Ein unbekanntes Feld (etwa eine zweite cashregisterId) ginge sonst still verloren.
+    const fremd = Object.keys(options).find((k) => !AUSGABEN_FELDER.includes(k));
+    if (fremd != null)
+        throw anfrage(`unbekanntes Feld "${fremd}"`);
+    const roh = options.entries;
+    if (!Array.isArray(roh) || roh.length === 0 || roh.length > RECEIPT_OUTPUT_ENTRIES_MAX) {
+        throw anfrage(`entries muss 1–${RECEIPT_OUTPUT_ENTRIES_MAX} Eintraege haben`);
+    }
+    const entries = roh.map((e, i) => {
+        const wo = `entries[${i}]`;
+        if (e === null || typeof e !== 'object' || Array.isArray(e))
+            throw anfrage(`${wo} muss ein Objekt sein`);
+        const eintrag = {};
+        for (const [feld, w] of Object.entries(e)) {
+            if (!AUSGABE_FELDER.includes(feld))
+                throw anfrage(`${wo}: unbekanntes Feld "${feld}"`);
+            if (w !== undefined)
+                eintrag[feld] = w;
+        }
+        // Schluessel und Beleg nie getrimmt: ein veraenderter Schluessel waere ein anderer.
+        for (const feld of ['key', 'receiptId']) {
+            const w = eintrag[feld];
+            if (typeof w !== 'string' || w.trim() === '')
+                throw anfrage(`${wo}.${feld} fehlt`);
+        }
+        // Dieselbe Regel wie der Server: so traegt jede Antwort (`rejected[].key`)
+        // genau den Schluessel, unter dem die Kasse den Eintrag puffert.
+        if (!AUSGABE_SCHLUESSEL.test(eintrag.key))
+            throw anfrage(`${wo}.key muss 8–64 Zeichen [A-Za-z0-9_-] haben`);
+        // Ein Wert ausserhalb des Katalogs liesse den Rand die ganze Anfrage abweisen.
+        if (!RECEIPT_OUTPUT_KINDS.includes(eintrag.kind)) {
+            throw anfrage(`${wo}.kind muss ${RECEIPT_OUTPUT_KINDS.join(', ')} sein`);
+        }
+        if (eintrag.result !== undefined && !RECEIPT_OUTPUT_RESULTS.includes(eintrag.result)) {
+            throw anfrage(`${wo}.result muss ${RECEIPT_OUTPUT_RESULTS.join(', ')} sein`);
+        }
+        const at = eintrag.at;
+        // Text nur als ISO 8601 mit Zone (Regel des Servers): ohne Zone waere die
+        // Zeit je nach Geraet eine andere; das ist ein Fehler der Kasse, kein Fall
+        // fuer den Puffer.
+        const zeitOk = (typeof at === 'number' && Number.isSafeInteger(at) && at >= 0) || (typeof at === 'string' && AUSGABE_ZEIT.test(at));
+        if (!zeitOk)
+            throw anfrage(`${wo}.at muss Millisekunden seit 1970 oder ISO 8601 mit Zone sein`);
+        return eintrag;
+    });
+    return ausgabenGemeldet(name, await transport(name, { entries }));
+}
+/** Antwort von `logReceiptOutputs`, streng: `accepted` ganze Zahl ab 0, `rejected` Liste aus Schluessel und Code. */
+function ausgabenGemeldet(name, daten) {
+    if (daten === null || typeof daten !== 'object' || Array.isArray(daten))
+        throw antwortfehler(name, 'Antwort ist kein Objekt');
+    const { accepted, rejected } = daten;
+    if (typeof accepted !== 'number' || !Number.isSafeInteger(accepted) || accepted < 0) {
+        throw antwortfehler(name, 'Antwort enthaelt keine Zahl accepted');
+    }
+    if (!Array.isArray(rejected))
+        throw antwortfehler(name, 'Antwort enthaelt keine Liste rejected');
+    return {
+        accepted,
+        rejected: rejected.map((r, i) => {
+            const { key, code } = (r ?? {});
+            if (typeof key !== 'string' || typeof code !== 'string' || code === '') {
+                throw antwortfehler(name, `rejected[${i}] ohne Schluessel oder Code`);
+            }
+            return { key, code };
+        }),
+    };
+}
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten
  * Regelverstoss als Text (oder `null`) — Zwilling von
@@ -643,14 +798,15 @@ const MAX_ZAHLUNGEN = 20;
  * (Summe, Anbieter-Pflicht und Trinkgeld prueft der Server). Wirft, bevor
  * etwas hinausgeht.
  */
-function gepruefteZahlungen(roh, storno, functionName, auszahlung = false) {
+function gepruefteZahlungen(roh, storno, functionName, auszahlung = false, stornoAuszahlung = false) {
     const fehler = (grund) => new KasseneckValidationError(functionName, grund, 'request');
     if (!Array.isArray(roh))
         throw fehler('payments muss eine Liste sein.');
     if (roh.length > MAX_ZAHLUNGEN)
         throw fehler(`payments: es sind hoechstens ${MAX_ZAHLUNGEN} Eintraege erlaubt.`);
     // Auszahlung eines Gutscheins: der Betrag geht bar hinaus, ohne gegeben und ohne Trinkgeld (Server pruefeZahlungen).
-    const negativ = storno || auszahlung;
+    // Storno einer Auszahlung: der Kunde gibt das Geld zurueck, die eine Barzahlung ist positiv (zahlungen-core stornoAuszahlung).
+    const negativ = (storno && !stornoAuszahlung) || auszahlung;
     if (auszahlung) {
         const e = roh[0];
         if (roh.length !== 1)
@@ -823,6 +979,7 @@ export function belegAusHuelle(daten, functionName) {
 export function belegMitFirmaAusHuelle(daten, functionName) {
     const receipt = belegAusHuelle(daten, functionName);
     const d = (daten ?? {});
+    const outputs = receiptOutputsFromWire(d.outputs);
     const layout = d.layout && typeof d.layout === 'object' && Array.isArray(d.layout.lines) ? d.layout : null;
     const angaben = d.registrationInfo && typeof d.registrationInfo === 'object' ? readRegistrationInfo(d.registrationInfo) : null;
     return {
@@ -834,6 +991,7 @@ export function belegMitFirmaAusHuelle(daten, functionName) {
         layout,
         registrationInfo: angaben,
         logoScale: d.logo_scale === 'S' || d.logo_scale === 'M' || d.logo_scale === 'L' || d.logo_scale === 'XL' ? d.logo_scale : 'M',
+        ...(outputs !== undefined ? { outputs } : {}),
     };
 }
 /**

package/dist/esm/enums/voucher-type.d.ts

@@ -4,7 +4,7 @@
 export declare const VoucherType: {
     /** Altform: Wertgutschein (Wert im Cent, Code frei). */
     readonly value: "value";
-    /** Altform: Rabatt-/Promotionsgutschein. */
+    /** Altform: Rabatt-/Aktionsgutschein. */
     readonly promo: "promo";
     /** Neue Form: Mehrzweckgutschein (Zahlungsmittel, Steuer erst bei der Einloesung). */
     readonly multi_purpose: "multi_purpose";

package/dist/esm/enums/voucher-type.js

@@ -4,7 +4,7 @@
 export const VoucherType = {
     /** Altform: Wertgutschein (Wert im Cent, Code frei). */
     value: 'value',
-    /** Altform: Rabatt-/Promotionsgutschein. */
+    /** Altform: Rabatt-/Aktionsgutschein. */
     promo: 'promo',
     /** Neue Form: Mehrzweckgutschein (Zahlungsmittel, Steuer erst bei der Einloesung). */
     multi_purpose: 'multi_purpose',

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 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, 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, 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 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 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_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, downloadDailyReport, downloadMonthlyReport, getCashregisterReport, getReportV2, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/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 { 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/typen.d.ts

@@ -18,7 +18,7 @@ export interface CustomerInput {
     city?: string;
     /** ISO-3166-Alpha-2, z. B. `AT`. */
     country: string;
-    /** UID-Nummer, z. B. `ATU12345678`. */
+    /** UID-Nummer, z. B. `ATU12345675`. */
     vatId?: string;
     /** Kuerzel fuer die Rechnungsnummer; einmal gesetzt unveraenderlich. */
     shortCode?: string;

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

@@ -1,11 +1,12 @@
 export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, isVoucherItem, isVoucherFloatItem, } from './receipt-item.js';
-export { type Voucher, type VoucherArticle, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields } from './voucher.js';
+export { type Voucher, type VoucherArticle, type IssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields } from './voucher.js';
 export { type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, } from './receipt.js';
 export { 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, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, } from './cancellation.js';
 export { type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-payment.js';
 export { type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError } from './payment-errors.js';
 export { type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, } from './receipt-email.js';
 export { type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, } from './receipt-errors.js';
+export { 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, } from './receipt-output.js';
 export { type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, type CashregisterAutoLogout, type CashregisterAutoLogoutPayload, fromCashregisterPayload, } from './cashregister.js';
 export { type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind } from './receipt-summary.js';

package/dist/esm/models/index.js

@@ -6,6 +6,7 @@ export { fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-p
 export { PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors } from './payment-errors.js';
 export { RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, } from './receipt-email.js';
 export { RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, } from './receipt-errors.js';
+export { 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, } from './receipt-output.js';
 export { fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { fromCashregisterPayload, } from './cashregister.js';
 export { fromReceiptSummaryPayload, ZERO_KINDS, isZeroKind } from './receipt-summary.js';

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

@@ -0,0 +1,79 @@
+import { KasseneckApiError } from '../client/errors.js';
+/**
+ * Die Arten einer Ausgabe (Katalog `AUSGABE_ART`): `print` Erstdruck,
+ * `reprint` Duplikat, `email` Belegmail, `link_shared` Link geteilt,
+ * `pdf_shared` PDF geteilt, `opened` vom Kunden geoeffnet (Abrufe je Stunde).
+ */
+export declare const RECEIPT_OUTPUT_KINDS: readonly ["print", "reprint", "email", "link_shared", "pdf_shared", "opened"];
+export type ReceiptOutputKind = (typeof RECEIPT_OUTPUT_KINDS)[number];
+/**
+ * Die Arten, die eine Kasse selbst meldet. `email` und `opened` schreibt das
+ * Backend selbst (beim Versand bzw. beim Abruf des Links); meldet eine Kasse
+ * sie, lehnt der Server genau diesen Eintrag ab (`invalid_output_kind`).
+ */
+export declare const RECEIPT_OUTPUT_LOG_KINDS: readonly ["print", "reprint", "link_shared", "pdf_shared"];
+export type ReceiptOutputLogKind = (typeof RECEIPT_OUTPUT_LOG_KINDS)[number];
+/** Ergebnis einer Ausgabe (Katalog `AUSGABE_ERGEBNIS`); Mail und Abruf sind immer `ok`. */
+export declare const RECEIPT_OUTPUT_RESULTS: readonly ["ok", "failed", "unclear"];
+export type ReceiptOutputResult = (typeof RECEIPT_OUTPUT_RESULTS)[number];
+/** Hoechstens so viele Eintraege je Aufruf von `logReceiptOutputs`. */
+export declare const RECEIPT_OUTPUT_ENTRIES_MAX = 50;
+/** Wer die Ausgabe ausloeste: Kassen-Benutzer, bzw. beim Geraet mit api_key das Konto (`name: null`). */
+export interface ReceiptOutputActor {
+    id: string;
+    name: string | null;
+}
+/**
+ * Ein Eintrag aus `outputs` einer `getReceipt`-Antwort (`/v3`). Eine Art oder
+ * ein Ergebnis, das dieses Paket noch nicht kennt (neuerer Server), bleibt
+ * lesbar stehen; die Kasse zeigt es ohne Beschriftung.
+ */
+export interface ReceiptOutput {
+    kind: ReceiptOutputKind | (string & {});
+    /** Zeitpunkt, ISO 8601 mit Wiener Zonenoffset; bei Kassenmeldungen der Zeitpunkt am Geraet, beim Abruf der erste der Stunde. */
+    at: string;
+    result: ReceiptOutputResult | (string & {});
+    /** `null` beim Abruf durch den Kunden. */
+    by: ReceiptOutputActor | null;
+    /** Nur bei `opened`: Zahl der Abrufe in dieser Stunde. */
+    count?: number;
+}
+/**
+ * Liest `data.outputs` nachsichtig: das Protokoll ist eine Auskunft neben dem
+ * Beleg und darf das Lesen, Anzeigen und Nachdrucken des Belegs nie scheitern
+ * lassen. Keine Liste: `undefined` (Antwort ohne Protokoll, etwa `/api` oder
+ * `createReceipt`). Ein Eintrag ohne lesbare Art, Zeit oder Ergebnis faellt
+ * weg; ein Handelnder ohne Kennung gilt als `null`, eine Anzahl, die keine
+ * ganze Zahl ab 0 ist, fehlt. Paketintern.
+ */
+export declare function receiptOutputsFromWire(roh: unknown): ReceiptOutput[] | undefined;
+/**
+ * Codes je Eintrag in `rejected[].code` einer Antwort von
+ * `logReceiptOutputs`: der Eintrag ist dauerhaft abgelehnt (aus dem Puffer
+ * nehmen, nicht noch einmal senden). `validation` heisst hier: ein Druck ohne
+ * oder mit unbekanntem Ergebnis.
+ */
+export declare const RECEIPT_OUTPUT_ENTRY_ERROR_CODES: readonly ["receipt_not_found", "invalid_output_kind", "output_time_out_of_range", "idempotency_key_required", "validation"];
+export type ReceiptOutputEntryErrorCode = (typeof RECEIPT_OUTPUT_ENTRY_ERROR_CODES)[number];
+/**
+ * Fehlercodes von `logReceiptOutputs`, wenn die ganze Anfrage scheitert
+ * (Vokabular `errorCodes.registerHandlersByEndpoint.logReceiptOutputs`),
+ * dahinter die Codes, die Anmeldung und Rand auf diesem Endpunkt erzeugen
+ * koennen (`errorCodes.auth` ohne die sieben des Partner-Zugangs,
+ * `errorCodes.edge`), zuletzt `route_missing` (Code des Pakets). Ein Code
+ * ausserhalb bleibt ueber `KasseneckApiError.code` lesbar.
+ */
+export declare const RECEIPT_OUTPUT_ERROR_CODES: readonly ["idempotency_key_required", "invalid_output_kind", "output_time_out_of_range", "receipt_not_found", "server_error", "validation", "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"];
+export type ReceiptOutputErrorCode = (typeof RECEIPT_OUTPUT_ERROR_CODES)[number];
+export declare function isReceiptOutputErrorCode(value: unknown): value is ReceiptOutputErrorCode;
+/** Der Code eines geworfenen Fehlers, wenn er in [RECEIPT_OUTPUT_ERROR_CODES] steht; sonst `undefined`. */
+export declare function receiptOutputErrorCode(error: unknown): ReceiptOutputErrorCode | undefined;
+/** Ohne `code`: traegt der Fehler ueberhaupt einen Code aus [RECEIPT_OUTPUT_ERROR_CODES]? */
+export declare function isReceiptOutputError(error: unknown, code?: ReceiptOutputErrorCode): error is KasseneckApiError;
+/** Ein Feldfehler aus `data.errors[]` einer `validation`-Antwort von `logReceiptOutputs`. */
+export interface ReceiptOutputFieldError {
+    field: string;
+    message: string;
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+export declare function receiptOutputFieldErrors(error: unknown): ReceiptOutputFieldError[];

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

@@ -0,0 +1,135 @@
+import { bekannterCode, feldfehlerVon } from '../client/fehlercodes.js';
+/*
+ * Ausgaben eines Belegs: auf welchem Weg ein Beleg den Betrieb verlassen hat
+ * (Erstdruck, Duplikat, E-Mail, Link oder PDF geteilt, vom Kunden geoeffnet).
+ * Registrierkassen-Erlass BMF-AV Nr. 2/2026, Abschnitt 4.2: die Art der
+ * Belegerteilung ist zu dokumentieren. Das Protokoll fuehrt das Backend neben
+ * dem Beleg (nie am Beleg, nie im DEP); die Kasse meldet ihre Drucke und das
+ * Teilen mit `logReceiptOutputs`, `getReceipt` liefert unter `/v3` die
+ * neuesten 20 Eintraege als `outputs`.
+ */
+/**
+ * Die Arten einer Ausgabe (Katalog `AUSGABE_ART`): `print` Erstdruck,
+ * `reprint` Duplikat, `email` Belegmail, `link_shared` Link geteilt,
+ * `pdf_shared` PDF geteilt, `opened` vom Kunden geoeffnet (Abrufe je Stunde).
+ */
+export const RECEIPT_OUTPUT_KINDS = Object.freeze(['print', 'reprint', 'email', 'link_shared', 'pdf_shared', 'opened']);
+/**
+ * Die Arten, die eine Kasse selbst meldet. `email` und `opened` schreibt das
+ * Backend selbst (beim Versand bzw. beim Abruf des Links); meldet eine Kasse
+ * sie, lehnt der Server genau diesen Eintrag ab (`invalid_output_kind`).
+ */
+export const RECEIPT_OUTPUT_LOG_KINDS = Object.freeze(['print', 'reprint', 'link_shared', 'pdf_shared']);
+/** Ergebnis einer Ausgabe (Katalog `AUSGABE_ERGEBNIS`); Mail und Abruf sind immer `ok`. */
+export const RECEIPT_OUTPUT_RESULTS = Object.freeze(['ok', 'failed', 'unclear']);
+/** Hoechstens so viele Eintraege je Aufruf von `logReceiptOutputs`. */
+export const RECEIPT_OUTPUT_ENTRIES_MAX = 50;
+/**
+ * Liest `data.outputs` nachsichtig: das Protokoll ist eine Auskunft neben dem
+ * Beleg und darf das Lesen, Anzeigen und Nachdrucken des Belegs nie scheitern
+ * lassen. Keine Liste: `undefined` (Antwort ohne Protokoll, etwa `/api` oder
+ * `createReceipt`). Ein Eintrag ohne lesbare Art, Zeit oder Ergebnis faellt
+ * weg; ein Handelnder ohne Kennung gilt als `null`, eine Anzahl, die keine
+ * ganze Zahl ab 0 ist, fehlt. Paketintern.
+ */
+export function receiptOutputsFromWire(roh) {
+    if (!Array.isArray(roh))
+        return undefined;
+    const raus = [];
+    for (const e of roh) {
+        if (e === null || typeof e !== 'object' || Array.isArray(e))
+            continue;
+        const { kind, at, result, by, count } = e;
+        if (typeof kind !== 'string' || kind === '' || typeof at !== 'string' || at === '' || typeof result !== 'string' || result === '')
+            continue;
+        const eintrag = { kind, at, result, by: handelnder(by) };
+        if (typeof count === 'number' && Number.isSafeInteger(count) && count >= 0)
+            eintrag.count = count;
+        raus.push(eintrag);
+    }
+    return raus;
+}
+function handelnder(w) {
+    if (w === null || typeof w !== 'object' || Array.isArray(w))
+        return null;
+    const { id, name } = w;
+    if (typeof id !== 'string' || id === '')
+        return null;
+    return { id, name: typeof name === 'string' ? name : null };
+}
+/**
+ * Codes je Eintrag in `rejected[].code` einer Antwort von
+ * `logReceiptOutputs`: der Eintrag ist dauerhaft abgelehnt (aus dem Puffer
+ * nehmen, nicht noch einmal senden). `validation` heisst hier: ein Druck ohne
+ * oder mit unbekanntem Ergebnis.
+ */
+export const RECEIPT_OUTPUT_ENTRY_ERROR_CODES = Object.freeze([
+    'receipt_not_found', // Beleg gibt es nicht ODER er liegt in einer anderen Kasse
+    'invalid_output_kind', // Art, die die Kasse nicht meldet (email, opened)
+    'output_time_out_of_range', // unlesbare Zeit oder ohne Zone (eine falsch gehende Uhr klemmt der Server)
+    'idempotency_key_required', // Schluessel fehlt oder hat nicht 8-64 Zeichen [A-Za-z0-9_-]
+    'validation', // Druck ohne bzw. mit unbekanntem Ergebnis
+]);
+/**
+ * Fehlercodes von `logReceiptOutputs`, wenn die ganze Anfrage scheitert
+ * (Vokabular `errorCodes.registerHandlersByEndpoint.logReceiptOutputs`),
+ * dahinter die Codes, die Anmeldung und Rand auf diesem Endpunkt erzeugen
+ * koennen (`errorCodes.auth` ohne die sieben des Partner-Zugangs,
+ * `errorCodes.edge`), zuletzt `route_missing` (Code des Pakets). Ein Code
+ * ausserhalb bleibt ueber `KasseneckApiError.code` lesbar.
+ */
+export const RECEIPT_OUTPUT_ERROR_CODES = Object.freeze([
+    'idempotency_key_required',
+    'invalid_output_kind',
+    'output_time_out_of_range',
+    'receipt_not_found',
+    'server_error',
+    'validation',
+    // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
+    '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',
+    // Code des Pakets (CLIENT_ERROR_CODES)
+    'route_missing',
+]);
+export function isReceiptOutputErrorCode(value) {
+    return typeof value === 'string' && RECEIPT_OUTPUT_ERROR_CODES.includes(value);
+}
+const BEKANNT = new Set(RECEIPT_OUTPUT_ERROR_CODES);
+/** Der Code eines geworfenen Fehlers, wenn er in [RECEIPT_OUTPUT_ERROR_CODES] steht; sonst `undefined`. */
+export function receiptOutputErrorCode(error) {
+    return bekannterCode(error, BEKANNT);
+}
+/** Ohne `code`: traegt der Fehler ueberhaupt einen Code aus [RECEIPT_OUTPUT_ERROR_CODES]? */
+export function isReceiptOutputError(error, code) {
+    const gefunden = receiptOutputErrorCode(error);
+    return gefunden !== undefined && (code === undefined || gefunden === code);
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+export function receiptOutputFieldErrors(error) {
+    return feldfehlerVon(error);
+}

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

@@ -155,10 +155,10 @@ export declare function readRegistrationInfo(roh: {
 export declare function receiptValueVoucherSign(receipt: Receipt): 1 | -1;
 /**
  * Zwischensumme in **Cent** — Positionen plus verkaufte Wertgutscheine minus
- * eingeloeste Promotionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
+ * eingeloeste Aktionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
  * [receiptSumCents], nicht hier (siehe Dart-Vorbild `subSumCents`/`sumCents`).
  * Am Storno-Beleg zaehlen Wertgutscheine mit umgekehrtem Vorzeichen
- * ([receiptValueVoucherSign]), und ein gespiegelter Promotionsgutschein
+ * ([receiptValueVoucherSign]), und ein gespiegelter Aktionsgutschein
  * mindert nichts: den Rabatt nimmt der Server dort ueber Ausgleichspositionen
  * (`kind: 'discount'`) zurueck, und belegToepfe verteilt einen Promo-Eintrag
  * nur auf eine positive Topfsumme, die ein Storno nie hat.

package/dist/esm/models/receipt.js

@@ -142,10 +142,10 @@ export function receiptValueVoucherSign(receipt) {
 }
 /**
  * Zwischensumme in **Cent** — Positionen plus verkaufte Wertgutscheine minus
- * eingeloeste Promotionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
+ * eingeloeste Aktionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
  * [receiptSumCents], nicht hier (siehe Dart-Vorbild `subSumCents`/`sumCents`).
  * Am Storno-Beleg zaehlen Wertgutscheine mit umgekehrtem Vorzeichen
- * ([receiptValueVoucherSign]), und ein gespiegelter Promotionsgutschein
+ * ([receiptValueVoucherSign]), und ein gespiegelter Aktionsgutschein
  * mindert nichts: den Rabatt nimmt der Server dort ueber Ausgleichspositionen
  * (`kind: 'discount'`) zurueck, und belegToepfe verteilt einen Promo-Eintrag
  * nur auf eine positive Topfsumme, die ein Storno nie hat.

package/dist/esm/models/voucher.d.ts

@@ -38,6 +38,28 @@ export interface Voucher {
     exempt?: boolean;
     zeroRateBucket?: boolean;
 }
+/**
+ * Ein ausgestellter Gutschein in der Antwort von `createReceipt` unter `/v3`
+ * (`data.issuedVouchers[]`): der Klartext-Code erscheint hier einmalig fuer das Etikett.
+ */
+export interface IssuedVoucher {
+    id: string;
+    /** Klartext-Code; nie in Logs oder Fehlertexte schreiben. */
+    code: string;
+    type: string;
+    index: number;
+    codeSuffix: string;
+    faceValueCents?: number;
+    quantity?: number;
+    /** Nur bei Leistungsgutscheinen: Name des verkauften Artikels; sonst fehlt das Feld. */
+    articleName?: string;
+    validity?: {
+        pattern: string;
+        redeemableUntil: string | null;
+        refundableUntil: string | null;
+        validUntil: string | null;
+    };
+}
 /** Artikel eines Leistungsgutscheins, wie der Server ihn am Beleg festhaelt. */
 export interface VoucherArticle {
     id: string;
@@ -87,8 +109,8 @@ export declare function voucherServerFields(voucher: Voucher): string[];
 export declare function toVoucherPayload(voucher: Voucher): VoucherPayload;
 /**
  * Ist der Gutschein an das Backend sendbar? Zwilling von `KeckVoucher.isValid`
- * im Flutter-Vorbild: Wert- und Promotionsgutscheine brauchen einen Wert,
- * Promotionsgutscheine duerfen nur eingeloest (nicht verkauft) werden, und ein
+ * im Flutter-Vorbild: Wert- und Aktionsgutscheine brauchen einen Wert,
+ * Aktionsgutscheine duerfen nur eingeloest (nicht verkauft) werden, und ein
  * gesetzter Wert muss positiv sein.
  */
 export declare function voucherIsValid(voucher: Voucher): boolean;