@kreiseck/kasseneck-api 0.28.0 → 0.30.0

package/dist/cjs/models/payment-errors.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYMENT_ERROR_CODES = void 0;
+exports.isPaymentErrorCode = isPaymentErrorCode;
+/**
+ * Mehrere Zahlungen je Beleg — Fehlercode-Katalog, Zwilling von
+ * `functions/gemeinsam/zahlungen-core.js` ZAHLUNGS_FEHLERCODES (gleiche
+ * Codes, gleiche Reihenfolge).
+ *
+ * `createReceipt` und `cancelReceipt` legen sie bei jedem Fehler rund um
+ * `payments` (und bei den Aufrufer-Vorbedingungen wie `PAYMENTS_CONFLICT`)
+ * als `code` neben die Meldung; das Paket reicht sie als
+ * [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text** — die
+ * deutsche Meldung darf sich aendern, der Code nicht.
+ *
+ * Schreibweise: auf `/v1`, `/v2` und intern kommen die Codes gross
+ * (`PAYMENTS_SUM_MISMATCH`), unter `/v3` schreibt der Rand des Backends sie
+ * klein (`payments_sum_mismatch`, functions/gemeinsam/api-vokabular-v3.js:
+ * jeder dieser Codes 1:1 in Kleinschreibung, anders als die Storno-Codes).
+ * [isPaymentErrorCode] erkennt beide; wer selbst vergleicht, vergleicht
+ * `code.toUpperCase()`.
+ */
+exports.PAYMENT_ERROR_CODES = Object.freeze([
+    'PAYMENTS_INVALID', // payments ist keine Liste oder hat mehr als 20 Eintraege
+    'PAYMENT_METHOD_INVALID', // Zahlart unbekannt oder mixed
+    'PAYMENT_AMOUNT_INVALID', // amountCents keine Ganzzahl, 0 oder falsches Vorzeichen
+    'PAYMENT_TENDERED_INVALID', // tenderedCents an Nicht-Bar-Zahlung, zu klein oder doppelt
+    'PAYMENT_PROVIDER_INVALID', // Karte ohne/mit unbekanntem provider, providerPaymentId fehlt
+    'PAYMENT_PROVIDER_NOT_ALLOWED', // Anbieterfelder an einer Zahlung, die weder Karte noch online ist
+    'PAYMENTS_SUM_MISMATCH', // Summe != Zahlbetrag (Antwort nennt data.expectedCents)
+    'PAYMENTS_DUE_NEGATIVE', // Zahlbetrag < 0 (Wertgutschein groesser als der Beleg)
+    'PAYMENTS_NOT_ALLOWED', // Null-/Startbeleg mit Zahlungen, alter Storno-Weg
+    'PAYMENTS_CONFLICT', // payments zusammen mit paymentMethod oder Kartenfeldern
+    'PAYMENTS_REQUIRED', // /v3 ohne payments
+    'PAYMENT_METHOD_NOT_SUPPORTED', // paymentMethod/Kartenfelder unter /v3
+    'TIP_PAYMENT_METHOD_INVALID', // Trinkgeld-Zahlart kommt in payments nicht vor
+    'TIP_PAYMENT_METHOD_REQUIRED', // mehrere Zahlarten, tip.paymentMethod fehlt
+    'TIP_EXCEEDS_PAYMENT', // Trinkgeld uebersteigt die Zahlungen seiner Zahlart
+    'PAYMENT_REFUND_NOT_ALLOWED', // refundOf ausserhalb eines Stornos oder kein String
+    'PAYMENT_TIP_INVALID', // tipCents keine Ganzzahl, <= 0, > amountCents oder nicht am Verkauf
+    'TIP_CONFLICT', // tip und payments[].tipCents zugleich
+]);
+/** Erkennt einen Code aus [PAYMENT_ERROR_CODES] — gross (`/v1`) wie klein (`/v3`). */
+function isPaymentErrorCode(value) {
+    return typeof value === 'string' && exports.PAYMENT_ERROR_CODES.includes(value.toUpperCase());
+}

package/dist/cjs/models/receipt-payment.d.ts

@@ -0,0 +1,85 @@
+import { KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider } from '../enums/index.js';
+/**
+ * Eine Zahlung am Beleg — Zwilling der Eintraege in `payments`, wie
+ * `functions/gemeinsam/zahlungen-core.js` (`pruefeZahlungen`) sie normalisiert
+ * und ablegt.
+ *
+ * Ein Beleg kann ueber mehrere Zahlungen bezahlt sein (zwei Karten, Rest bar).
+ * Dann steht die Liste unter `payments`, und das Einzelfeld `paymentMethod`
+ * ist `mixed`, sobald verschiedene Zahlarten vorkommen (zwei Karten ergeben
+ * `creditCard`). Altbelege haben keine Liste; dort gilt weiter
+ * `paymentMethod` samt Kartenfeldern.
+ *
+ * Betraege in ganzen Cent: am Verkauf positiv, am Storno negativ (Rueckzahlung).
+ * `method`/`provider` sind beim Lesen wie ueberall entweder der bekannte
+ * Enum-Eintrag oder der rohe Schluessel (siehe `enum-payload.ts`).
+ */
+export interface ReceiptPayment {
+    /** Vom Server vergeben (`p1`, `p2`, …); Bezugspunkt fuer `refundOf`. */
+    id?: string;
+    method: KeckPaymentMethod | string;
+    amountCents: number;
+    /** Nur bei Barzahlung: gegebener Betrag. */
+    tenderedCents?: number;
+    /** Nur neben `tenderedCents`: Rueckgeld (vom Server gerechnet). */
+    changeCents?: number;
+    /** Kartenanbieter bzw. Terminal. */
+    provider?: CreditCardProvider | string;
+    /** Kennung der Zahlung am Terminal/Anbieter. */
+    providerPaymentId?: string;
+    /** Terminaldaten fuer den Kartenblock (frueher `cardPaymentData`). */
+    providerData?: Record<string, unknown>;
+    /** Nur am Storno: `id` der Originalzahlung, die erstattet wird. */
+    refundOf?: string;
+    /**
+     * Trinkgeld, das mit dieser Zahlung gegeben wurde, in ganzen Cent — TEIL
+     * von `amountCents` (das Terminal bucht Betrag + Trinkgeld zusammen). Nur
+     * an Verkaufs-/Trainingsbelegen.
+     */
+    tipCents?: number;
+}
+/** Nutzlast-Form einer Zahlung (Backend-Dokument bzw. Antwort). */
+export interface ReceiptPaymentPayload {
+    id?: string;
+    method: string;
+    amountCents: number;
+    tenderedCents?: number;
+    changeCents?: number;
+    provider?: string;
+    providerPaymentId?: string;
+    providerData?: Record<string, unknown>;
+    refundOf?: string;
+    tipCents?: number;
+}
+/**
+ * Eine Zahlung, wie der Aufrufer sie an `createReceipt`/`sellReceipt`/
+ * `cancelReceipt` schickt. `id` und `changeCents` vergibt der Server.
+ *
+ * - `method`: jede Zahlungsart ausser `mixed`.
+ * - `amountCents`: ganze Cent, am Verkauf > 0, am Storno < 0.
+ * - `tenderedCents`: nur bei Barzahlung am Verkauf, hoechstens an einer Zahlung.
+ * - `provider`/`providerPaymentId`/`providerData`: bei Karten Pflicht
+ *   (`providerPaymentId` ausser bei `custom`), bei `online` optional, sonst
+ *   nicht erlaubt; am Storno beschreiben sie die Erstattung und sind optional.
+ * - `refundOf`: nur am Storno.
+ * - `tipCents`: Trinkgeld dieser Zahlung, ganze Cent > 0, Teil von
+ *   `amountCents`; nur am Verkauf, nie neben `tip` (den Rest prueft der Server).
+ */
+export interface ReceiptPaymentInput {
+    method: KeckPaymentMethod | KeckPaymentMethodKey;
+    amountCents: number;
+    tenderedCents?: number;
+    provider?: CreditCardProvider;
+    providerPaymentId?: string;
+    providerData?: Record<string, unknown>;
+    refundOf?: string;
+    tipCents?: number;
+}
+/** Lesepfad: nur vorhandene Felder uebernehmen, nichts ergaenzen. */
+export declare function fromReceiptPaymentPayload(payload: ReceiptPaymentPayload): ReceiptPayment;
+/**
+ * Schreibpfad: Zahlungen zurueck in die Nutzlast — streng wie
+ * `toReceiptPayload`: ein roher, unbekannter Schluessel bei `method` oder
+ * `provider` wirft.
+ */
+export declare function toReceiptPaymentPayload(payment: ReceiptPayment): ReceiptPaymentPayload;

package/dist/cjs/models/receipt-payment.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromReceiptPaymentPayload = fromReceiptPaymentPayload;
+exports.toReceiptPaymentPayload = toReceiptPaymentPayload;
+const index_js_1 = require("../enums/index.js");
+const enum_payload_js_1 = require("./enum-payload.js");
+/** Lesepfad: nur vorhandene Felder uebernehmen, nichts ergaenzen. */
+function fromReceiptPaymentPayload(payload) {
+    return {
+        ...(typeof payload.id === 'string' ? { id: payload.id } : {}),
+        method: (0, enum_payload_js_1.readEnumKey)(index_js_1.KeckPaymentMethod, payload.method),
+        amountCents: payload.amountCents,
+        ...(typeof payload.tenderedCents === 'number' ? { tenderedCents: payload.tenderedCents } : {}),
+        ...(typeof payload.changeCents === 'number' ? { changeCents: payload.changeCents } : {}),
+        ...(typeof payload.provider === 'string' ? { provider: (0, enum_payload_js_1.readEnumKey)(index_js_1.CreditCardProvider, payload.provider) } : {}),
+        ...(typeof payload.providerPaymentId === 'string' ? { providerPaymentId: payload.providerPaymentId } : {}),
+        ...(payload.providerData != null && typeof payload.providerData === 'object' ? { providerData: payload.providerData } : {}),
+        ...(typeof payload.refundOf === 'string' ? { refundOf: payload.refundOf } : {}),
+        ...(typeof payload.tipCents === 'number' ? { tipCents: payload.tipCents } : {}),
+    };
+}
+/**
+ * Schreibpfad: Zahlungen zurueck in die Nutzlast — streng wie
+ * `toReceiptPayload`: ein roher, unbekannter Schluessel bei `method` oder
+ * `provider` wirft.
+ */
+function toReceiptPaymentPayload(payment) {
+    return {
+        ...(payment.id !== undefined ? { id: payment.id } : {}),
+        method: typeof payment.method === 'object' ? payment.method.value : (0, enum_payload_js_1.requireEnumKey)(index_js_1.KeckPaymentMethod, payment.method, 'Zahlungsart').value,
+        amountCents: payment.amountCents,
+        ...(payment.tenderedCents !== undefined ? { tenderedCents: payment.tenderedCents } : {}),
+        ...(payment.changeCents !== undefined ? { changeCents: payment.changeCents } : {}),
+        ...(payment.provider !== undefined ? { provider: (0, enum_payload_js_1.requireEnumKey)(index_js_1.CreditCardProvider, payment.provider, 'Kartenanbieter') } : {}),
+        ...(payment.providerPaymentId !== undefined ? { providerPaymentId: payment.providerPaymentId } : {}),
+        ...(payment.providerData !== undefined ? { providerData: payment.providerData } : {}),
+        ...(payment.refundOf !== undefined ? { refundOf: payment.refundOf } : {}),
+        ...(payment.tipCents !== undefined ? { tipCents: payment.tipCents } : {}),
+    };
+}

package/dist/cjs/models/receipt-summary.d.ts

@@ -1,4 +1,5 @@
 import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
+import { type ReceiptPayment, type ReceiptPaymentPayload } from './receipt-payment.js';
 /**
  * Belegzeile einer Liste — die Form, die `listMyReceipts` liefert
  * (`projectReceiptForCustomer` in functions/index.js).
@@ -63,6 +64,13 @@ export interface ReceiptSummary {
     stornoStand: 'offen' | 'teil' | 'voll';
     /** Nur am Nullbeleg, nur fuer Kassen-Benutzer: Anlass (monthly, annual, annual_replacement, outage_end, final, manual). */
     zeroKind?: ZeroKind;
+    /**
+     * Zahlungsliste, nur bei Belegen, die eine tragen. Die Liste liefert nur
+     * die oeffentlichen Felder (id, method, amountCents, provider,
+     * tenderedCents, changeCents, refundOf, tipCents) — Anbieter-Interna
+     * (`providerPaymentId`, `providerData`) bleiben im Backend.
+     */
+    payments?: ReceiptPayment[];
 }
 export interface ReceiptSummaryPayload {
     receiptId?: string | null;
@@ -90,5 +98,6 @@ export interface ReceiptSummaryPayload {
     cancellationReason?: string | null;
     stornoStand?: string | null;
     zeroKind?: string | null;
+    payments?: ReceiptPaymentPayload[] | null;
 }
 export declare function fromReceiptSummaryPayload(payload: ReceiptSummaryPayload): ReceiptSummary;

package/dist/cjs/models/receipt-summary.js

@@ -6,6 +6,7 @@ exports.fromReceiptSummaryPayload = fromReceiptSummaryPayload;
 const index_js_1 = require("../enums/index.js");
 const money_js_1 = require("../money.js");
 const enum_payload_js_1 = require("./enum-payload.js");
+const receipt_payment_js_1 = require("./receipt-payment.js");
 /**
  * Belegzeile einer Liste — die Form, die `listMyReceipts` liefert
  * (`projectReceiptForCustomer` in functions/index.js).
@@ -53,5 +54,6 @@ function fromReceiptSummaryPayload(payload) {
         ...(payload.cancellationReason ? { cancellationReason: payload.cancellationReason } : {}),
         stornoStand: payload.stornoStand === 'teil' || payload.stornoStand === 'voll' ? payload.stornoStand : 'offen',
         ...(istZeroKind(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),
+        ...(Array.isArray(payload.payments) ? { payments: payload.payments.map(receipt_payment_js_1.fromReceiptPaymentPayload) } : {}),
     };
 }

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

@@ -3,6 +3,7 @@ import { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead
 import { type Voucher, type VoucherPayload } from './voucher.js';
 import type { Cancellation, CancellationOf, CancellationReason } from './cancellation.js';
 import { type ZeroKind } from './receipt-summary.js';
+import { type ReceiptPayment, type ReceiptPaymentPayload } from './receipt-payment.js';
 /**
  * Beleg — Zwilling der Beleg-Nutzlast von `KasseneckReceipt` in
  * kasseneck_api/lib/models/kasseneck_receipt.dart (nur der signatur-/
@@ -54,6 +55,12 @@ export interface Receipt {
     cancellations?: Cancellation[];
     /** Nur an Nullbelegen: Anlass (monthly, annual, annual_replacement, outage_end, final, manual). */
     zeroKind?: ZeroKind;
+    /**
+     * Zahlungsliste (mehrere Zahlungen je Beleg), nur vorhanden, wenn der Beleg
+     * sie traegt. Altbelege haben keine; dort gelten `paymentMethod` und die
+     * Kartenfelder. Siehe [ReceiptPayment].
+     */
+    payments?: ReceiptPayment[];
 }
 export interface ReceiptPayload {
     qr: string;
@@ -78,6 +85,8 @@ export interface ReceiptPayload {
     customProjectId: string | null;
     /** Nur bei Belegen mit Trinkgeld (siehe [Receipt.tipCents]). */
     tipCents?: number | null;
+    /** Nur bei Belegen mit Zahlungsliste (siehe [Receipt.payments]). */
+    payments?: ReceiptPaymentPayload[] | null;
 }
 /**
  * Nutzlast-Form, die dieses Paket **liest**. Unterscheidet sich von

package/dist/cjs/models/receipt.js

@@ -9,6 +9,7 @@ const enum_payload_js_1 = require("./enum-payload.js");
 const receipt_item_js_1 = require("./receipt-item.js");
 const voucher_js_1 = require("./voucher.js");
 const receipt_summary_js_1 = require("./receipt-summary.js");
+const receipt_payment_js_1 = require("./receipt-payment.js");
 /**
  * Schreibt die Nutzlast in der **neuen** Form — sie **normalisiert, statt zu
  * spiegeln**: ein Beleg, der in der v1-Positionsform gelesen wurde, geht hier
@@ -49,6 +50,7 @@ function toReceiptPayload(receipt) {
         signatureSuccess: receipt.signatureSuccess ?? null,
         customProjectId: receipt.customProjectId ?? null,
         ...(receipt.tipCents != null ? { tipCents: receipt.tipCents } : {}),
+        ...(receipt.payments != null ? { payments: receipt.payments.map(receipt_payment_js_1.toReceiptPaymentPayload) } : {}),
     };
 }
 // Nullbelege haben keine Positionen -> items kann fehlen/null sein (siehe Dart-Vorbild).
@@ -84,6 +86,7 @@ function fromReceiptPayload(payload) {
         ...(payload.cancellationReason ? { cancellationReason: payload.cancellationReason } : {}),
         ...((0, receipt_summary_js_1.istZeroKind)(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),
         ...(payload.cancellations ? { cancellations: payload.cancellations.map(leseStorno) } : {}),
+        ...(Array.isArray(payload.payments) ? { payments: payload.payments.map(receipt_payment_js_1.fromReceiptPaymentPayload) } : {}),
     };
 }
 function leseStorno(eintrag) {

package/dist/cjs/partner/fehler.d.ts

@@ -19,6 +19,32 @@
  * unterscheiden. Deshalb stehen hier BEIDE Flaechen: die der Schnittstelle
  * ([PARTNER_FEHLER_CODES]) und die des Partner-Portals
  * ([PARTNER_PORTAL_FEHLER_CODES]).
+ *
+ * **Seit 0.29.0 englisch, wie der Rest von `/v3`.** Dieser Client spricht seit
+ * 0.28.0 ausschliesslich `/v3` (`PARTNER_BASE_URL`): die paar deutschen Codes,
+ * die der Server bis dahin noch roh durchreichte, kommen jetzt genauso englisch
+ * an wie alle anderen. [PARTNER_FEHLER_CODES] fuehrt deshalb ausnahmslos die
+ * `/v3`-Schreibweise aus `fehlercodes.json`s `v3`-Zuordnung (deutsch -> englisch);
+ * ein Aufrufer bekommt vom Server nie mehr die deutsche Form.
+ *
+ * **`kein_partnerbetrieb` und `request_not_found` fehlen absichtlich.** Beide
+ * sind admin-only (`partner-endpoints.js`, ausserhalb von `FEHLER_KATALOG`) und
+ * erreichen `/v3` nie: ein Partner-Aufruf kann sie unter keinem Pfad bekommen.
+ * Sie standen frueher versehentlich in dieser Liste; `dart-partner.json` (ein
+ * eingefrorener Abzug aus Dart 5.3.0, bevor das korrigiert wurde) fuehrt sie
+ * weiterhin, siehe die Ausnahme in `test/partner-enums.test.ts`.
+ *
+ * **Die Vertrags-Codes (`kind_not_allowed`, `mode_not_allowed`,
+ * `power_of_attorney_missing`, `not_found`, `no_version`,
+ * `unknown_version`, `text_changed`, `already_accepted`) stehen hier, obwohl
+ * dieses Paket `reportCustomerContract` nicht anbietet.** Der Katalog des
+ * Backends fuehrt sie mit `flaeche: 'api'`/`'beide'`, dieselbe Regel wie bei
+ * den Portal-Codes oben: vollstaendig heisst vollstaendig, auch fuer einen
+ * Endpunkt, den (noch) kein Aufruf dieses Clients ausloest. Ein Server-Update,
+ * das den Endpunkt ergaenzt, bräuchte dann keinen zweiten Fehlerkatalog-Umbau.
+ * `not_required` fehlt bewusst: derselbe gemeinsame Server-Zweig wie die
+ * anderen sechs, aber ueber die Partner-API nicht erreichbar (der Server hat
+ * ihn aus `FEHLER_KATALOG` entfernt, siehe `partner-core.js` im Backend).
  */
 /**
  * Alle Codes, die die **Schnittstelle** kennt. Als Liste und nicht nur als
@@ -27,7 +53,7 @@
  *
  * Reihenfolge und Bestand wie im Abzug des Backends.
  */
-export declare const PARTNER_FEHLER_CODES: readonly ["validation", "rate_limited", "app_not_found", "app_not_accepted", "kein_partnerbetrieb", "live_not_allowed", "customer_exists", "customer_conflict", "customer_limit", "zugang_nicht_erlaubt", "email_taken", "no_email", "kennung_fehlt", "fon_missing", "signature_pending", "request_not_found", "signature_missing", "signature_unknown", "signature_ambiguous", "signature_not_ready", "signature_limit", "signature_failed", "module_inactive", "cashregister_limit", "cashregister_not_found", "vertrag_offen", "activation_failed", "webhook_limit", "webhook_inactive", "event_not_subscribed"];
+export declare const PARTNER_FEHLER_CODES: readonly ["validation", "rate_limited", "app_not_found", "app_not_accepted", "live_not_allowed", "customer_exists", "customer_conflict", "customer_limit", "access_not_allowed", "email_taken", "no_email", "tax_number_missing", "fon_missing", "signature_pending", "signature_missing", "signature_unknown", "signature_ambiguous", "signature_not_ready", "signature_limit", "signature_failed", "module_inactive", "cashregister_limit", "cashregister_not_found", "contracts_pending", "kind_not_allowed", "mode_not_allowed", "power_of_attorney_missing", "not_found", "no_version", "unknown_version", "text_changed", "already_accepted", "activation_failed", "webhook_limit", "webhook_inactive", "event_not_subscribed"];
 /**
  * Die Codes, die nur im **Partner-Portal** entstehen — beim Pflegen der App,
  * der Schluessel, der Mitglieder und der Signaturkarten.
@@ -58,7 +84,7 @@ export declare function istPartnerFehler(error: unknown, code: PartnerCode): boo
 export interface PartnerFeldFehler {
     /**
      * Der Feldpfad, so wie er im gesendeten Betrieb steht — verschachtelt und je
-     * Kontakt: `address.land`, `tax_details.ustid`, `contacts.1.abteilung`.
+     * Kontakt: `address.zip`, `taxDetails.taxNumber`, `contacts.0.email`.
      */
     field: string;
     message: string;

package/dist/cjs/partner/fehler.js

@@ -20,6 +20,32 @@
  * unterscheiden. Deshalb stehen hier BEIDE Flaechen: die der Schnittstelle
  * ([PARTNER_FEHLER_CODES]) und die des Partner-Portals
  * ([PARTNER_PORTAL_FEHLER_CODES]).
+ *
+ * **Seit 0.29.0 englisch, wie der Rest von `/v3`.** Dieser Client spricht seit
+ * 0.28.0 ausschliesslich `/v3` (`PARTNER_BASE_URL`): die paar deutschen Codes,
+ * die der Server bis dahin noch roh durchreichte, kommen jetzt genauso englisch
+ * an wie alle anderen. [PARTNER_FEHLER_CODES] fuehrt deshalb ausnahmslos die
+ * `/v3`-Schreibweise aus `fehlercodes.json`s `v3`-Zuordnung (deutsch -> englisch);
+ * ein Aufrufer bekommt vom Server nie mehr die deutsche Form.
+ *
+ * **`kein_partnerbetrieb` und `request_not_found` fehlen absichtlich.** Beide
+ * sind admin-only (`partner-endpoints.js`, ausserhalb von `FEHLER_KATALOG`) und
+ * erreichen `/v3` nie: ein Partner-Aufruf kann sie unter keinem Pfad bekommen.
+ * Sie standen frueher versehentlich in dieser Liste; `dart-partner.json` (ein
+ * eingefrorener Abzug aus Dart 5.3.0, bevor das korrigiert wurde) fuehrt sie
+ * weiterhin, siehe die Ausnahme in `test/partner-enums.test.ts`.
+ *
+ * **Die Vertrags-Codes (`kind_not_allowed`, `mode_not_allowed`,
+ * `power_of_attorney_missing`, `not_found`, `no_version`,
+ * `unknown_version`, `text_changed`, `already_accepted`) stehen hier, obwohl
+ * dieses Paket `reportCustomerContract` nicht anbietet.** Der Katalog des
+ * Backends fuehrt sie mit `flaeche: 'api'`/`'beide'`, dieselbe Regel wie bei
+ * den Portal-Codes oben: vollstaendig heisst vollstaendig, auch fuer einen
+ * Endpunkt, den (noch) kein Aufruf dieses Clients ausloest. Ein Server-Update,
+ * das den Endpunkt ergaenzt, bräuchte dann keinen zweiten Fehlerkatalog-Umbau.
+ * `not_required` fehlt bewusst: derselbe gemeinsame Server-Zweig wie die
+ * anderen sechs, aber ueber die Partner-API nicht erreichbar (der Server hat
+ * ihn aus `FEHLER_KATALOG` entfernt, siehe `partner-core.js` im Backend).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PARTNER_PORTAL_FEHLER_CODES = exports.PARTNER_FEHLER_CODES = void 0;
@@ -44,21 +70,19 @@ exports.PARTNER_FEHLER_CODES = [
     'rate_limited',
     'app_not_found',
     'app_not_accepted',
-    'kein_partnerbetrieb',
     'live_not_allowed',
     // Betrieb anlegen
     'customer_exists',
     'customer_conflict',
     'customer_limit',
-    'zugang_nicht_erlaubt',
+    'access_not_allowed',
     'email_taken',
     'no_email',
     // FinanzOnline-Link
-    'kennung_fehlt',
+    'tax_number_missing',
     // Signatur
     'fon_missing',
     'signature_pending',
-    'request_not_found',
     'signature_missing',
     'signature_unknown',
     'signature_ambiguous',
@@ -69,7 +93,17 @@ exports.PARTNER_FEHLER_CODES = [
     'module_inactive',
     'cashregister_limit',
     'cashregister_not_found',
-    'vertrag_offen',
+    'contracts_pending',
+    // Vertraege (reportCustomerContract: dieses Paket bietet den Endpunkt nicht
+    // an, der Katalog fuehrt die Codes trotzdem vollstaendig, siehe oben)
+    'kind_not_allowed',
+    'mode_not_allowed',
+    'power_of_attorney_missing',
+    'not_found',
+    'no_version',
+    'unknown_version',
+    'text_changed',
+    'already_accepted',
     'activation_failed',
     // Webhooks
     'webhook_limit',
@@ -119,28 +153,38 @@ const RAT = {
     rate_limited: 'Zu viele Aufrufe. data.retryAfterSec Sekunden warten und denselben Aufruf wiederholen.',
     app_not_found: 'Die appId gibt es nicht. getPartnerInfo liefert die eigenen Apps samt id.',
     app_not_accepted: 'Diese App hat noch keine abgenommene Version. Mit einem pk_test_-Schluessel oder mit env:"test" geht es sofort weiter; live erst nach der Abnahme.',
-    kein_partnerbetrieb: 'Dieser Betrieb gehoert nicht zu diesem Partner-Konto. Die eigenen stehen in listPartnerCustomers.',
     live_not_allowed: 'Ein Test-Schluessel erzeugt nichts Echtes. Fuer einen Live-Betrieb den Live-Schluessel nehmen — umgekehrt darf ein Live-Schluessel mit env:"test" sehr wohl einen Testbetrieb anlegen.',
     customer_exists: 'Diesen Betrieb gibt es schon (data.customerId). Mit derselben customerId weiterarbeiten.',
     customer_conflict: 'Die Steuernummer ist bei Kasseneck bereits registriert. Die Zuordnung zum Partner macht Kasseneck — hello@kasseneck.at.',
     customer_limit: 'Das Tageslimit fuer neue Betriebe ist erreicht (data.max, data.resetAt). Morgen weiter.',
-    zugang_nicht_erlaubt: 'Fuer dieses Partner-Konto sind Zugaenge zum Kundenpanel nicht freigeschaltet — es entstand NICHTS, auch kein Betrieb. Ohne access{invite:true} erneut anlegen oder die Freischaltung erfragen (Stand: getPartnerInfo.partner.canCreateAccess).',
+    access_not_allowed: 'Fuer dieses Partner-Konto sind Zugaenge zum Kundenpanel nicht freigeschaltet — es entstand NICHTS, auch kein Betrieb. Ohne access{invite:true} erneut anlegen oder die Freischaltung erfragen (Stand: getPartnerInfo.partner.canCreateAccess).',
     email_taken: 'Fuer diese E-Mail gibt es schon einen Kasseneck-Zugang. Eine andere Adresse waehlen, auf die Einladung verzichten oder den Betrieb zuordnen lassen.',
     no_email: 'Im Konto des Betriebs steht keine E-Mail-Adresse. Ohne sie geht weder eine Einladung noch der FinanzOnline-Link hinaus.',
-    kennung_fehlt: 'Am Betrieb ist keine Steuernummer hinterlegt, ohne sie gibt es keinen Einrichtungs-Link. Die Steuernummer bei Kasseneck nachtragen lassen (hello@kasseneck.at), dann sendPartnerCustomerFonLink erneut.',
+    tax_number_missing: 'Am Betrieb ist keine Steuernummer hinterlegt, ohne sie gibt es keinen Einrichtungs-Link. Die Steuernummer bei Kasseneck nachtragen lassen (hello@kasseneck.at), dann sendPartnerCustomerFonLink erneut.',
     fon_missing: 'Der Betrieb hat noch keinen FinanzOnline-Zugang. sendPartnerCustomerFonLink senden und customer.fon_verified abwarten. Betrifft das ANMELDEN der Signatureinheit, nicht das Beantragen.',
     signature_pending: 'Fuer diesen Betrieb laeuft bereits ein Antrag. Auf signature.ready warten.',
-    request_not_found: 'Diese signaturId gibt es nicht. getCustomerSignatureStatus nennt die des Betriebs.',
     signature_missing: 'Der Betrieb hat ueberhaupt keine Signatur, und jede Kasse bezieht sich auf eine. Zuerst requestCustomerSignature.',
     signature_unknown: 'Die genannte signatureRequestId gehoert nicht zu diesem Betrieb. getCustomerSignatureStatus nennt die seinen.',
     signature_ambiguous: 'Der Betrieb hat mehrere Signaturen; welche die Kasse benutzt, muss dastehen. Eine aus data.choices als signatureRequestId mitgeben.',
     signature_not_ready: 'Die Signatur DIESER Kasse ist noch nicht bereit. Auf signature.ready warten; eine mit automatic:true angelegte Kasse geht danach von selbst live.',
     signature_limit: 'Hoechstens zehn Signaturen je Betrieb. Eine bestehende benutzen, statt mit additional:true eine weitere zu beantragen.',
     signature_failed: 'FinanzOnline hat die Anmeldung abgelehnt (data.rc). Kasseneck klaert das — hello@kasseneck.at.',
-    module_inactive: 'Das Modul (data.modul) ist fuer diesen Betrieb nicht gebucht. Kasseneck schaltet es frei.',
+    module_inactive: 'Das Modul (data.module, z. B. "cash_register", Text in data.detail) ist fuer diesen Betrieb nicht gebucht. Kasseneck schaltet es frei.',
     cashregister_limit: 'Hoechstens 20 Registrierkassen je Betrieb. Eine bestehende nutzen.',
     cashregister_not_found: 'Diese cashregisterId gibt es bei diesem Betrieb nicht.',
-    vertrag_offen: 'Nur live: der Betrieb hat Auftragsverarbeitungs- und Nutzungsvertrag noch nicht bestaetigt. An der Kasse aendert sich nichts. Den Betrieb ueber den Einrichtungs-Link bestaetigen lassen (sendPartnerCustomerFonLink, Stand in avv/terms von getPartnerCustomer), danach activateCashregister erneut.',
+    contracts_pending: 'Nur live: der Betrieb hat Auftragsverarbeitungs- und Nutzungsvertrag noch nicht bestaetigt. An der Kasse aendert sich nichts. Den Betrieb ueber den Einrichtungs-Link bestaetigen lassen (sendPartnerCustomerFonLink, Stand in avv/terms von getPartnerCustomer), danach activateCashregister erneut.',
+    // -- Vertraege (reportCustomerContract) ------------------------------------
+    // Dieser Client bietet den Endpunkt (noch) nicht an; die Codes stehen hier
+    // nur fuer die Katalogseite und fuer einen Aufrufer, der die rohe Antwort
+    // selbst auswertet (siehe Kopfkommentar der Datei).
+    kind_not_allowed: 'reportCustomerContract mit einer anderen Art als "avv". Der Vollmachtsweg nimmt nur den Auftragsverarbeitungsvertrag entgegen. Dieser Client bietet den Endpunkt nicht an.',
+    mode_not_allowed: 'Der Vollmachtsweg ist fuer dieses Partner-Konto nicht freigeschaltet. Kasseneck fragen (hello@kasseneck.at).',
+    power_of_attorney_missing: 'Der Partnervertrag mit dem Vollmachts-Kapitel ist noch nicht bestaetigt. Erst danach nimmt der Vollmachtsweg Meldungen entgegen.',
+    not_found: 'Die genannte customerId gehoert nicht zu diesem Partner-Konto oder existiert nicht. listPartnerCustomers nennt die eigenen.',
+    no_version: 'Fuer die gemeldete Vertragsart gibt es derzeit keine gueltige Fassung. Bei Kasseneck nachfragen.',
+    unknown_version: 'Die gemeldete Vertragsversion gibt es nicht. Die aktuell geltende Fassung neu abrufen.',
+    text_changed: 'Der gezeigte Vertragstext hat sich seit dem Laden geaendert (data.textHash traegt die aktuell geltende Pruefsumme). Neu laden und danach erneut bestaetigen lassen.',
+    already_accepted: 'Diese Fassung ist bereits bestaetigt (data.contractId). Nichts weiter zu tun.',
     activation_failed: 'Die Inbetriebnahme blieb an data.step haengen (ggf. data.rc). activateCashregister erneut aufrufen — jeder Schritt ist idempotent, der Lauf setzt an der Bruchstelle an.',
     webhook_limit: 'Hoechstens 10 Webhook-Endpunkte je Partner. Einen ungenutzten loeschen.',
     webhook_inactive: 'Der Webhook steht auf active:false. Zuerst aktivieren, dann erneut proben.',

package/dist/cjs/partner/index.d.ts

@@ -27,6 +27,6 @@ export { getPartnerInfo, createPartnerCustomer, listPartnerCustomers, checkPartn
 export { createPartnerWebhook, listPartnerWebhooks, rotatePartnerWebhookSecret, updatePartnerWebhook, deletePartnerWebhook, sendPartnerWebhookTest, listPartnerWebhookDeliveries, parseWebhookEvent, istPartnerWebhookEvent, PARTNER_WEBHOOK_EVENTS, WEBHOOK_UMSCHLAG_FELDER, type PartnerWebhookEvent, type PartnerWebhookEventType, type PartnerWebhook, type CreateWebhookOptions, type CreateWebhookResult, type DeleteWebhookResult, type WebhookApiVersion, type WebhookDeliveryStatus, type WebhookTestZustellung, type ContractKind, type ContractSource, type ContractAcceptedEventData, type WebhookPatch, type WebhookListe, type WebhookZustellung, type WebhookTestResult, type WebhookEventResult, } from './webhooks.js';
 export { verifyWebhookSignature, parseSignatureHeader, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, WEBHOOK_RETRY_PLAN_SEC, WEBHOOK_MAX_ATTEMPTS, WEBHOOK_TIMEOUT_MS, WEBHOOK_LIMIT, type VerifyWebhookOptions, type WebhookVerifyResult, type WebhookVerifyReason, } from './webhook-signatur.js';
 export { PARTNER_ENVS } from './typen.js';
-export type { PartnerEnv, PartnerScope, PartnerApp, PartnerInfo, LegalForm, AustrianState, ContactRole, AvvMode, FeeInterval, PartnerFee, SignatureHistoryReason, RequestSignatureOptions, CustomerSignature, Rechtsform, Bundesland, KontaktRolle, BetriebAdresse, BetriebSteuer, BetriebKontakt, BetriebSteuerberater, Betrieb, CreateCustomerOptions, CreateCustomerResult, KundenStatus, KundenZeile, AvvStand, VertragStand, KundenFonStand, ListCustomersOptions, KundenListe, Kunde, FonLinkResult, SignaturAntragStatus, SignaturHistorieEintrag, SignaturAntrag, RequestSignatureResult, SignaturStand, KassenSchritt, KassenStatus, Kasse, CreateCashregisterOptions, CreateCashregisterResult, ActivateCashregisterResult, KassenListe, CustomerCashregisterCredential, CustomerCredentials, } from './typen.js';
+export type { PartnerEnv, PartnerScope, PartnerApp, PartnerInfo, LegalForm, AustrianState, ContactRole, AvvMode, FeeInterval, PartnerFee, SignatureHistoryReason, SignatureErrorCode, RequestSignatureOptions, CustomerSignature, Rechtsform, Bundesland, KontaktRolle, BetriebAdresse, BetriebSteuer, BetriebKontakt, BetriebSteuerberater, Betrieb, CreateCustomerOptions, CreateCustomerResult, KundenStatus, KundenZeile, AvvStand, VertragStand, KundenFonStand, ListCustomersOptions, KundenListe, Kunde, FonLinkResult, SignaturAntragStatus, SignaturHistorieEintrag, SignaturAntrag, RequestSignatureResult, SignaturStand, KassenSchritt, KassenStatus, Kasse, CreateCashregisterOptions, CreateCashregisterResult, ActivateCashregisterResult, KassenListe, CustomerCashregisterCredential, CustomerCredentials, } from './typen.js';
 /** `credentials:read` — nicht im Standardsatz, siehe typen.ts. */
 export { SCOPE_CREDENTIALS } from './typen.js';

package/dist/cjs/partner/typen.d.ts

@@ -329,6 +329,13 @@ export type SignaturAntragStatus = 'requested' | 'assigned' | 'registered' | 're
  * `finanzonline` hiessen unter `/v1` `karte_eingetragen` und `fon`.
  */
 export type SignatureHistoryReason = 'api' | 'portal' | 'card_entered' | 'finanzonline' | 'automation_off' | 'test_environment' | 'no_stock' | (string & {});
+/**
+ * `error.code` eines Signaturantrags oder einer Signatur (`SignaturAntrag`,
+ * `CustomerSignature`). Hiess unter `/v1` `kunde_nicht_gefunden` /
+ * `unvollstaendig` / `fon_fehler`; dieser Client spricht seit 0.28.0 nur noch
+ * `/v3` und sieht darum nur die englische Form.
+ */
+export type SignatureErrorCode = 'customer_not_found' | 'incomplete' | 'finanzonline_error' | (string & {});
 export interface SignaturHistorieEintrag {
     from: SignaturAntragStatus | null;
     to: SignaturAntragStatus;
@@ -344,7 +351,7 @@ export interface SignaturAntrag {
     vdaId: string | null;
     signatureId: string | null;
     error: {
-        code: string | null;
+        code: SignatureErrorCode | null;
         message: string | null;
         rc: string | null;
     } | null;
@@ -383,7 +390,7 @@ export interface CustomerSignature {
     requestId: string | null;
     signatureId: string | null;
     error: {
-        code: string | null;
+        code: SignatureErrorCode | null;
         message: string | null;
         rc: string | null;
     } | null;