@kreiseck/kasseneck-api 0.27.2 → 0.28.0

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

@@ -12,17 +12,21 @@
  * Was hier steht, ist die Benutzung dieses Clients.
  *
  * Reihenfolge der Kette: [PARTNER_ABLAUF].
+ *
+ * **Seit 0.28.0 spricht dieser Teil die englische `/v3`** ([PARTNER_BASE_URL]).
+ * Alles andere im Paket (Belege, Rechnungen, Kasse, Druck, Zahlungen) bleibt
+ * auf `/v1`, bis es dort eine `/v3` gibt.
  */
-export { createPartnerApi, type PartnerApi, type PartnerApiOptions } from './api.js';
+export { createPartnerApi, PARTNER_BASE_URL, type PartnerApi, type PartnerApiOptions } from './api.js';
 export { partnerKeyAuth, partnerKeyEnv, type PartnerKeyAuthOptions } from './auth.js';
 export { PARTNER_ABLAUF, naechsterSchritt, type AblaufSchritt, } from './ablauf.js';
 export { PARTNER_FEHLER_CODES, PARTNER_PORTAL_FEHLER_CODES, istPartnerFehlerCode, istPartnerPortalFehlerCode, istPartnerFehler, partnerFehlerCode, partnerFehlerRat, partnerFeldFehler, partnerWartezeitSek, type PartnerCode, type PartnerFehlerCode, type PartnerPortalFehlerCode, type PartnerFeldFehler, } from './fehler.js';
 export { BETRIEB_FELDER, unbekannteBetriebsfelder, type BetriebFeld, } from './betrieb.js';
 export { KasseneckSecret, SECRET_MASKE } from './secret.js';
 export { getPartnerInfo, createPartnerCustomer, listPartnerCustomers, checkPartnerCustomerEmail, getPartnerCustomer, sendPartnerCustomerFonLink, requestCustomerSignature, getCustomerSignatureStatus, createCustomerCashregister, activateCashregister, listCustomerCashregisters, getCustomerCredentials, } from './endpunkte.js';
-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 WebhookPatch, type WebhookListe, type WebhookZustellung, type WebhookTestResult, type WebhookEventResult, } from './webhooks.js';
+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, Rechtsform, Bundesland, KontaktRolle, BetriebAdresse, BetriebSteuer, BetriebKontakt, BetriebSteuerberater, Betrieb, CreateCustomerOptions, CreateCustomerResult, KundenStatus, KundenZeile, AvvStand, 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, 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/index.js

@@ -13,12 +13,17 @@
  * Was hier steht, ist die Benutzung dieses Clients.
  *
  * Reihenfolge der Kette: [PARTNER_ABLAUF].
+ *
+ * **Seit 0.28.0 spricht dieser Teil die englische `/v3`** ([PARTNER_BASE_URL]).
+ * Alles andere im Paket (Belege, Rechnungen, Kasse, Druck, Zahlungen) bleibt
+ * auf `/v1`, bis es dort eine `/v3` gibt.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WEBHOOK_TIMEOUT_MS = exports.WEBHOOK_MAX_ATTEMPTS = exports.WEBHOOK_RETRY_PLAN_SEC = exports.WEBHOOK_TOLERANCE_SEC = exports.WEBHOOK_DELIVERY_HEADER = exports.WEBHOOK_EVENT_HEADER = exports.WEBHOOK_SIGNATURE_HEADER = exports.parseSignatureHeader = exports.verifyWebhookSignature = exports.WEBHOOK_UMSCHLAG_FELDER = exports.PARTNER_WEBHOOK_EVENTS = exports.istPartnerWebhookEvent = exports.parseWebhookEvent = exports.listPartnerWebhookDeliveries = exports.sendPartnerWebhookTest = exports.deletePartnerWebhook = exports.updatePartnerWebhook = exports.rotatePartnerWebhookSecret = exports.listPartnerWebhooks = exports.createPartnerWebhook = exports.getCustomerCredentials = exports.listCustomerCashregisters = exports.activateCashregister = exports.createCustomerCashregister = exports.getCustomerSignatureStatus = exports.requestCustomerSignature = exports.sendPartnerCustomerFonLink = exports.getPartnerCustomer = exports.checkPartnerCustomerEmail = exports.listPartnerCustomers = exports.createPartnerCustomer = exports.getPartnerInfo = exports.SECRET_MASKE = exports.KasseneckSecret = exports.unbekannteBetriebsfelder = exports.BETRIEB_FELDER = exports.partnerWartezeitSek = exports.partnerFeldFehler = exports.partnerFehlerRat = exports.partnerFehlerCode = exports.istPartnerFehler = exports.istPartnerPortalFehlerCode = exports.istPartnerFehlerCode = exports.PARTNER_PORTAL_FEHLER_CODES = exports.PARTNER_FEHLER_CODES = exports.naechsterSchritt = exports.PARTNER_ABLAUF = exports.partnerKeyEnv = exports.partnerKeyAuth = exports.createPartnerApi = void 0;
-exports.SCOPE_CREDENTIALS = exports.PARTNER_ENVS = exports.WEBHOOK_LIMIT = void 0;
+exports.WEBHOOK_MAX_ATTEMPTS = exports.WEBHOOK_RETRY_PLAN_SEC = exports.WEBHOOK_TOLERANCE_SEC = exports.WEBHOOK_DELIVERY_HEADER = exports.WEBHOOK_EVENT_HEADER = exports.WEBHOOK_SIGNATURE_HEADER = exports.parseSignatureHeader = exports.verifyWebhookSignature = exports.WEBHOOK_UMSCHLAG_FELDER = exports.PARTNER_WEBHOOK_EVENTS = exports.istPartnerWebhookEvent = exports.parseWebhookEvent = exports.listPartnerWebhookDeliveries = exports.sendPartnerWebhookTest = exports.deletePartnerWebhook = exports.updatePartnerWebhook = exports.rotatePartnerWebhookSecret = exports.listPartnerWebhooks = exports.createPartnerWebhook = exports.getCustomerCredentials = exports.listCustomerCashregisters = exports.activateCashregister = exports.createCustomerCashregister = exports.getCustomerSignatureStatus = exports.requestCustomerSignature = exports.sendPartnerCustomerFonLink = exports.getPartnerCustomer = exports.checkPartnerCustomerEmail = exports.listPartnerCustomers = exports.createPartnerCustomer = exports.getPartnerInfo = exports.SECRET_MASKE = exports.KasseneckSecret = exports.unbekannteBetriebsfelder = exports.BETRIEB_FELDER = exports.partnerWartezeitSek = exports.partnerFeldFehler = exports.partnerFehlerRat = exports.partnerFehlerCode = exports.istPartnerFehler = exports.istPartnerPortalFehlerCode = exports.istPartnerFehlerCode = exports.PARTNER_PORTAL_FEHLER_CODES = exports.PARTNER_FEHLER_CODES = exports.naechsterSchritt = exports.PARTNER_ABLAUF = exports.partnerKeyEnv = exports.partnerKeyAuth = exports.PARTNER_BASE_URL = exports.createPartnerApi = void 0;
+exports.SCOPE_CREDENTIALS = exports.PARTNER_ENVS = exports.WEBHOOK_LIMIT = exports.WEBHOOK_TIMEOUT_MS = void 0;
 var api_js_1 = require("./api.js");
 Object.defineProperty(exports, "createPartnerApi", { enumerable: true, get: function () { return api_js_1.createPartnerApi; } });
+Object.defineProperty(exports, "PARTNER_BASE_URL", { enumerable: true, get: function () { return api_js_1.PARTNER_BASE_URL; } });
 var auth_js_1 = require("./auth.js");
 Object.defineProperty(exports, "partnerKeyAuth", { enumerable: true, get: function () { return auth_js_1.partnerKeyAuth; } });
 Object.defineProperty(exports, "partnerKeyEnv", { enumerable: true, get: function () { return auth_js_1.partnerKeyEnv; } });

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

@@ -12,6 +12,10 @@
  * einfuehrt, soll diesen Client nicht zum Absturz bringen, sondern ihn
  * durchreichen. Eingabetypen sind dagegen eng — ein Tippfehler soll ein
  * Compilerfehler sein und keine `validation`-Antwort vom Server.
+ *
+ * **Die Formen sind die der `/v3`** (seit 0.28.0): Feldnamen und Werte, auf
+ * die ein Programm verzweigt, sind englisch; Texte fuer Menschen (`message`,
+ * `note`, `statusText`, `nextSteps`) bleiben deutsch, die Fehlercodes ebenso.
  */
 import type { KasseneckSecret } from './secret.js';
 /**
@@ -67,9 +71,29 @@ export interface PartnerInfo {
     };
     apps: PartnerApp[];
 }
-export type Rechtsform = 'einzel' | 'eu' | 'og' | 'kg' | 'gmbh' | 'gmbhcokg' | 'ag' | 'verein' | 'sonstige';
-export type Bundesland = 'burgenland' | 'kaernten' | 'niederoesterreich' | 'oberoesterreich' | 'salzburg' | 'steiermark' | 'tirol' | 'vorarlberg' | 'wien';
-export type KontaktRolle = 'geschaeftsfuehrung' | 'buchhaltung' | 'technik' | 'kasse';
+/**
+ * Rechtsform des Betriebs, so wie `/v3` sie schreibt und liest.
+ *
+ * Die oesterreichischen Kurzformen (`eu`, `og`, `kg`, `gmbh`, `gmbhcokg`, `ag`)
+ * bleiben wie sie sind; nur die drei Woerter, die es auf Englisch gibt, sind
+ * englisch. `/v3` weist die deutschen Werte aus `/v1` (`einzel`, `verein`,
+ * `sonstige`) mit `validation` ab, statt sie still zu uebersetzen.
+ */
+export type LegalForm = 'sole_proprietor' | 'eu' | 'og' | 'kg' | 'gmbh' | 'gmbhcokg' | 'ag' | 'association' | 'other';
+/** @deprecated Seit 0.28.0 dasselbe wie [LegalForm] (englische Werte der `/v3`). */
+export type Rechtsform = LegalForm;
+/**
+ * Bundesland als ISO-3166-2-Code: `AT-1` Burgenland, `AT-2` Kaernten,
+ * `AT-3` Niederoesterreich, `AT-4` Oberoesterreich, `AT-5` Salzburg,
+ * `AT-6` Steiermark, `AT-7` Tirol, `AT-8` Vorarlberg, `AT-9` Wien.
+ */
+export type AustrianState = 'AT-1' | 'AT-2' | 'AT-3' | 'AT-4' | 'AT-5' | 'AT-6' | 'AT-7' | 'AT-8' | 'AT-9';
+/** @deprecated Seit 0.28.0 dasselbe wie [AustrianState] (ISO-Codes der `/v3`). */
+export type Bundesland = AustrianState;
+/** Rolle einer Kontaktperson; `/v1` sagte `geschaeftsfuehrung`, `buchhaltung`, `technik`, `kasse`. */
+export type ContactRole = 'management' | 'accounting' | 'technical' | 'pos';
+/** @deprecated Seit 0.28.0 dasselbe wie [ContactRole] (englische Werte der `/v3`). */
+export type KontaktRolle = ContactRole;
 export interface BetriebAdresse {
     street: string;
     /** Hausnummer, kurz und alphanumerisch: `49`, `12a`, `49/5`. */
@@ -82,8 +106,11 @@ export interface BetriebSteuer {
     /** Steuernummer im Format `12-345/6789`; die Pruefziffer wird geprueft. */
     taxNumber: string;
     smallBusiness: boolean;
-    /** UID, z. B. `ATU12345675`. */
-    uid?: string;
+    /**
+     * UID, z. B. `ATU12345675`. Heisst auf der Leitung `vatId` (auch schon unter
+     * `/v1`); ein `uid` wies der Server als unbekanntes Feld ab.
+     */
+    vatId?: string;
     /** GLN, 13 Ziffern. */
     gln?: string;
 }
@@ -91,7 +118,7 @@ export interface BetriebKontakt {
     name: string;
     email: string;
     phone?: string;
-    roles?: KontaktRolle[];
+    roles?: ContactRole[];
 }
 export interface BetriebSteuerberater {
     name: string;
@@ -115,11 +142,11 @@ export interface BetriebSteuerberater {
  */
 export interface Betrieb {
     companyName: string;
-    legalForm: Rechtsform;
+    legalForm: LegalForm;
     /** Anmeldung des Betriebs im Kasseneck-Panel; darf dort noch keinen Zugang haben. */
     email: string;
     address: BetriebAdresse;
-    state: Bundesland;
+    state: AustrianState;
     taxDetails: BetriebSteuer;
     /** Mindestens einer, hoechstens zehn. */
     contacts: BetriebKontakt[];
@@ -171,6 +198,20 @@ export interface CreateCustomerOptions {
     env?: PartnerEnv;
 }
 export type KundenStatus = 'created' | 'fon_configured' | 'signature_requested' | 'signature_ready' | 'cashregister_created' | 'live' | 'blocked' | (string & {});
+/** Abrechnungsrhythmus eines Entgelts; `/v1` sagte `monat`, `jahr`, `einmal`. */
+export type FeeInterval = 'monthly' | 'yearly' | 'once';
+/**
+ * Das Entgelt, das mit einem Aufruf gebucht wurde: nur dann in der Antwort,
+ * wenn die Konditionen des Partners dafuer einen Preis vorsehen. Unter `/v1`
+ * hiess es `entgelt` mit `rhythmus`.
+ */
+export interface PartnerFee {
+    /** Betrag in ganzen Cent. */
+    cents: number;
+    interval: FeeInterval | (string & {});
+    /** `true` fuer einen Testbetrieb: gebucht, aber nicht verrechnet. */
+    test: boolean;
+}
 export interface CreateCustomerResult {
     customerId: string;
     status: KundenStatus;
@@ -182,24 +223,48 @@ export interface CreateCustomerResult {
         sentTo: string | null;
     };
     nextSteps: string[];
+    /** Das gebuchte Entgelt; `null`, wenn die Konditionen keinen Preis dafuer vorsehen. */
+    fee: PartnerFee | null;
     /** `true`, wenn derselbe `idempotencyKey` schon einmal ankam. */
     replayed: boolean;
 }
 /**
- * Stand des Auftragsverarbeitungsvertrags eines Betriebs.
+ * Wie das Partnerkonto den AVV handhabt; `/v1` sagte `direkt`, `vollmacht`,
+ * `unterauftrag`.
+ */
+export type AvvMode = 'direct' | 'power_of_attorney' | 'subprocessor';
+/**
+ * Stand eines Vertrags des Betriebs mit Kasseneck: `pending` (noch nicht
+ * bestaetigt), `confirmed`, `outdated` (eine neuere Pflichtfassung ist zu
+ * bestaetigen) oder `not_required` (Testumgebung).
  *
- * **Vertraege wirken im Partner-Weg nicht mehr** (Stand 2026-08-31): keine
- * Antwort fuehrt dieses Feld, kein Schritt in `naechsteSchritte` verlangt
- * einen Vertrag, und eine Kasse geht deswegen nicht weniger live. Der Typ
- * bleibt, damit eine Antwort, die ihn doch noch traegt, lesbar durchkommt —
- * **vorausgesetzt wird er nirgends**. Fuer selbst registrierte Kunden gibt es
- * die Maschinerie weiterhin, aber nicht ueber diese Schnittstelle.
+ * **Die Vertraege wirken:** live geht ohne beide (AVV und Nutzungsvertrag)
+ * keine Kasse live, `activateCashregister` antwortet dann `vertrag_offen`. Der
+ * Betrieb bestaetigt sie selbst ueber den Einrichtungs-Link
+ * (`sendPartnerCustomerFonLink`); die Ereignisse `customer.avv_accepted` und
+ * `customer.terms_accepted` melden die Bestaetigung. In der Testumgebung sind
+ * sie nicht noetig.
  */
-export interface AvvStand {
-    status: string;
+export interface VertragStand {
+    status: 'pending' | 'confirmed' | 'outdated' | 'not_required' | (string & {});
     version: string | null;
     confirmedAt: number | null;
-    mode: string | null;
+}
+/**
+ * Stand des Auftragsverarbeitungsvertrags (AVV, Art. 28 DSGVO). Zusaetzlich zu
+ * [VertragStand] der Status `via_partner` (der Partnervertrag deckt den AVV,
+ * Weg `subprocessor`) und `mode`, der Weg des Partnerkontos.
+ */
+export interface AvvStand extends VertragStand {
+    status: VertragStand['status'] | 'via_partner';
+    mode: AvvMode | (string & {}) | null;
+}
+/** FinanzOnline-Stand in der Liste: ist der Link draussen, geoeffnet, der Zugang geprueft? */
+export interface KundenFonStand {
+    configured: boolean;
+    linkSentAt: number | null;
+    /** Erste Oeffnung; wird mit einem Ersatz-Link zurueckgesetzt. */
+    linkOpenedAt: number | null;
 }
 export interface KundenZeile {
     customerId: string;
@@ -208,12 +273,15 @@ export interface KundenZeile {
     appId: string | null;
     env: PartnerEnv;
     createdAt: number | null;
+    /** FinanzOnline-Stand; `null`, wenn die Antwort ihn nicht fuehrt. */
+    fon: KundenFonStand | null;
     /**
-     * Vertragsstand, falls die Antwort ihn ueberhaupt fuehrt — heute tut sie das
-     * nicht, der Wert ist dann `null`. Siehe [AvvStand]: nichts in diesem Client
-     * setzt ihn voraus.
+     * AVV-Stand; `null`, wenn die Antwort ihn nicht fuehrt. Kein erfundenes
+     * `pending`: "nicht mitgeliefert" und "nicht bestaetigt" sind zweierlei.
      */
     avv: AvvStand | null;
+    /** Stand des Nutzungsvertrags; `null`, wenn die Antwort ihn nicht fuehrt. */
+    terms: VertragStand | null;
 }
 export interface ListCustomersOptions {
     status?: KundenStatus;
@@ -233,9 +301,10 @@ export interface Kunde extends KundenZeile {
     createdAt: number | null;
     createdVia: string | null;
     business: Record<string, unknown>;
-    fon: {
-        configured: boolean;
+    /** In der Einzelsicht zusaetzlich: wann geprueft, an welche (maskierte) Adresse der Link ging. */
+    fon: KundenFonStand & {
         verifiedAt: number | null;
+        linkSentTo: string | null;
     };
     access: {
         email: string | null;
@@ -250,22 +319,28 @@ export interface FonLinkResult {
     expiresAt: number;
 }
 /**
- * `beantragt → zugeteilt → registriert → bereit`. `registriert` heisst: die
- * Einheit ist FinanzOnline bekannt; `bereit` heisst: sie darf signieren. In der
- * Testumgebung wird ohne `registriert` direkt `bereit` erreicht.
+ * `requested → assigned → registered → ready`. `registered` heisst: die
+ * Einheit ist FinanzOnline bekannt; `ready` heisst: sie darf signieren. In der
+ * Testumgebung wird ohne `registered` direkt `ready` erreicht.
  */
 export type SignaturAntragStatus = 'requested' | 'assigned' | 'registered' | 'ready' | 'failed' | 'cancelled' | (string & {});
+/**
+ * Gruende in der Historie eines Signaturantrags. `card_entered` und
+ * `finanzonline` hiessen unter `/v1` `karte_eingetragen` und `fon`.
+ */
+export type SignatureHistoryReason = 'api' | 'portal' | 'card_entered' | 'finanzonline' | 'automation_off' | 'test_environment' | 'no_stock' | (string & {});
 export interface SignaturHistorieEintrag {
-    von: string | null;
-    nach: string;
+    from: SignaturAntragStatus | null;
+    to: SignaturAntragStatus;
     at: number;
-    reason: string | null;
+    reason: SignatureHistoryReason | null;
 }
 export interface SignaturAntrag {
     requestId: string;
     status: SignaturAntragStatus;
     statusText: string;
-    art: string;
+    /** Art der Signatureinheit; heute nur `signature_card`. */
+    kind: string;
     vdaId: string | null;
     signatureId: string | null;
     error: {
@@ -278,18 +353,53 @@ export interface SignaturAntrag {
     updatedAt: number | null;
     history: SignaturHistorieEintrag[];
 }
+export interface RequestSignatureOptions {
+    /** Art der Signatureinheit; heute nur `signature_card` (Vorgabe). */
+    kind?: string;
+    /** `true` beantragt eine WEITERE Signatur, obwohl schon eine besteht. */
+    additional?: boolean;
+}
 export interface RequestSignatureResult {
     request: SignaturAntrag;
     /** `true`, wenn schon ein Antrag lief — dann ist es der laufende. */
     replayed: boolean;
     note: string | null;
+    /** Das gebuchte Entgelt; `null`, wenn die Konditionen keinen Preis dafuer vorsehen. */
+    fee: PartnerFee | null;
+}
+/**
+ * Eine Signatur des Betriebs, einzeln. Ein Betrieb kann mehrere haben
+ * (Ersatzkarte, zweiter Standort); `signatureRequestId` ist die Kennung, auf die
+ * sich eine Kasse beruft.
+ */
+export interface CustomerSignature {
+    signatureRequestId: string;
+    status: SignaturAntragStatus | 'decommissioned';
+    statusText: string;
+    inProgress: boolean;
+    ready: boolean;
+    kind: string;
+    vdaId: string | null;
+    requestId: string | null;
+    signatureId: string | null;
+    error: {
+        code: string | null;
+        message: string | null;
+        rc: string | null;
+    } | null;
+    createdAt: number | null;
+    updatedAt: number | null;
 }
 export interface SignaturStand {
-    signatur: {
+    customerId: string;
+    /** Die Kurzform: hat der Betrieb ueberhaupt eine brauchbare Signatur? */
+    signature: {
         ready: boolean;
         signatureId: string | null;
         vdaId: string | null;
     };
+    /** Jede Signatur einzeln. */
+    signatures: CustomerSignature[];
     requests: SignaturAntrag[];
     fon: {
         present: boolean;
@@ -297,8 +407,8 @@ export interface SignaturStand {
     };
 }
 /** Die Schritte der Inbetriebnahme, in dieser Reihenfolge. */
-export type KassenSchritt = 'signatur' | 'register_cashregister' | 'start_receipt' | 'transmit_start_receipt' | (string & {});
-export type KassenStatus = 'draft' | 'laeuft' | 'live' | 'failed' | (string & {});
+export type KassenSchritt = 'signature' | 'register_cashregister' | 'start_receipt' | 'transmit_start_receipt' | (string & {});
+export type KassenStatus = 'draft' | 'in_progress' | 'live' | 'failed' | (string & {});
 export interface Kasse {
     cashregisterId: string;
     name: string | null;
@@ -351,7 +461,7 @@ export interface CreateCashregisterResult {
         started: boolean;
         ok: boolean | null;
         step: KassenSchritt | null;
-        /** `signature_not_ready` oder `automatik_aus`, wenn nicht gestartet wurde. */
+        /** `signature_not_ready` oder `automation_off`, wenn nicht gestartet wurde. */
         reason: string | null;
     };
 }

package/dist/cjs/partner/typen.js

@@ -13,6 +13,10 @@
  * einfuehrt, soll diesen Client nicht zum Absturz bringen, sondern ihn
  * durchreichen. Eingabetypen sind dagegen eng — ein Tippfehler soll ein
  * Compilerfehler sein und keine `validation`-Antwort vom Server.
+ *
+ * **Die Formen sind die der `/v3`** (seit 0.28.0): Feldnamen und Werte, auf
+ * die ein Programm verzweigt, sind englisch; Texte fuer Menschen (`message`,
+ * `note`, `statusText`, `nextSteps`) bleiben deutsch, die Fehlercodes ebenso.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SCOPE_CREDENTIALS = exports.PARTNER_ENVS = void 0;

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

@@ -11,11 +11,11 @@ import { type VerifyWebhookOptions, type WebhookVerifyReason } from './webhook-s
  * Alle Ereignisse, die ein Webhook abonnieren **und proben** kann. Ein
  * Endpunkt bekommt ausschliesslich die, die in seiner `events`-Liste stehen.
  *
- * Kasseneck fuehrt daneben interne Ereignisse (etwa den Abschluss eines
- * Auftragsverarbeitungsvertrags). Sie stehen hier bewusst nicht: sie lassen
- * sich weder abonnieren noch mit [sendPartnerWebhookTest] ausloesen, und ein
- * Name in dieser Liste, den niemand bestellen kann, waere ein Versprechen ohne
- * Deckung.
+ * **Noch nicht in der Liste:** `customer.avv_accepted` und
+ * `customer.terms_accepted`. Das Backend bietet sie inzwischen zum Abonnieren
+ * an; die Liste wird mit dem Dart-Zwilling gemeinsam erweitert, weil beide
+ * gegeneinander geprueft werden. Abonnieren geht trotzdem schon (`events`
+ * nimmt jeden Namen), die Nutzlast beschreibt [ContractAcceptedEventData].
  */
 export declare const PARTNER_WEBHOOK_EVENTS: readonly ["customer.created", "customer.updated", "customer.status_changed", "customer.fon_verified", "customer.live_enabled", "signature.requested", "signature.ready", "signature.failed", "cashregister.created", "cashregister.live", "cashregister.failed", "app.version.accepted", "app.version.rejected", "webhook.test"];
 export type PartnerWebhookEventType = typeof PARTNER_WEBHOOK_EVENTS[number];
@@ -58,6 +58,38 @@ export interface PartnerWebhookEvent<T = Record<string, unknown>> {
     test: boolean;
     data: T;
 }
+/**
+ * Die Sprache der Nutzlast eines Webhooks. Ein unter `/v1` angelegter Webhook
+ * spricht `v1` (deutsche Werte), ein unter `/v3` angelegter `v3`. Umstellen
+ * geht nur vorwaerts, mit `updatePartnerWebhook(id, { apiVersion: 'v3' })`;
+ * zurueck auf `v1` gibt es absichtlich nicht.
+ *
+ * Die Sprache der **Antworten** folgt dagegen dem Pfad: dieser Client ruft
+ * `/v3` und bekommt englische Antworten, gleich welche `apiVersion` ein
+ * Webhook hat.
+ */
+export type WebhookApiVersion = 'v1' | 'v3';
+/** Art des Vertrags in `customer.avv_accepted` / `customer.terms_accepted`. */
+export type ContractKind = 'avv' | 'terms';
+/**
+ * Wo der Betrieb bestaetigt hat. Unter `v1` hiessen die ersten fuenf
+ * `einrichten`, `prozess`, `partner_vollmacht`, `admin_papier`,
+ * `papier_upload`; `app` und `portal` sind in beiden Sprachen gleich.
+ */
+export type ContractSource = 'setup_link' | 'process_link' | 'partner_power_of_attorney' | 'admin_paper' | 'paper_upload' | 'app' | 'portal' | (string & {});
+/**
+ * Nutzlast von `customer.avv_accepted` und `customer.terms_accepted` in der
+ * Sprache `v3`. Ein Webhook mit `apiVersion: 'v1'` schickt hier weiter
+ * `kind: 'nutzung'` und die deutschen Quellen.
+ */
+export interface ContractAcceptedEventData {
+    customerId: string;
+    companyName: string;
+    kind: ContractKind;
+    version: string;
+    confirmedAt: number;
+    source: ContractSource;
+}
 export type WebhookEventResult = {
     ok: true;
     event: PartnerWebhookEvent;
@@ -82,14 +114,23 @@ export type WebhookEventResult = {
  * 30 min, 2 h, 12 h) und gilt dann als fehlgeschlagen.
  */
 export declare function parseWebhookEvent(optionen: VerifyWebhookOptions): Promise<WebhookEventResult>;
+/** Stand einer Zustellung; `/v1` sagte `offen`, `zugestellt`, `fehlgeschlagen`, `verworfen`. */
+export type WebhookDeliveryStatus = 'pending' | 'delivered' | 'failed' | 'dropped';
 export interface PartnerWebhook {
     webhookId: string;
+    /** Sprache der Nutzlast; fehlt sie in der Antwort, ist es ein Bestands-Webhook und damit `v1`. */
+    apiVersion: WebhookApiVersion | (string & {});
     url: string;
     events: string[];
     active: boolean;
     description: string | null;
     createdAt: number | null;
-    lastDelivery: number | null;
+    /** Die letzte Zustellung; `null`, solange keine versucht wurde. */
+    lastDelivery: {
+        at: number | null;
+        status: WebhookDeliveryStatus | (string & {});
+        statusCode: number | null;
+    } | null;
     /** Fehlversuche in Folge — steigt der Wert, stimmt beim Empfaenger etwas nicht. */
     consecutiveFailures: number;
 }
@@ -120,6 +161,17 @@ export interface WebhookPatch {
     events?: (PartnerWebhookEventType | (string & {}))[];
     description?: string;
     active?: boolean;
+    /**
+     * Stellt die Nutzlast auf Englisch um. Nur `'v3'` ist moeglich: zurueck auf
+     * `v1` geht nicht, damit ein Partner nicht versehentlich wieder deutsche
+     * Nutzlasten bekommt.
+     */
+    apiVersion?: 'v3';
+}
+export interface DeleteWebhookResult {
+    webhookId: string;
+    /** Unter `/v1` hiess das Feld `geloescht`. */
+    deleted: boolean;
 }
 export interface WebhookListe {
     webhooks: PartnerWebhook[];
@@ -134,11 +186,11 @@ export interface WebhookZustellung {
     webhookId: string;
     event: string;
     eventId: string;
-    /** `offen`, `zugestellt` oder `fehlgeschlagen`. */
-    status: string;
+    /** `dropped`: der Webhook wurde vor der Faelligkeit deaktiviert oder geloescht. */
+    status: WebhookDeliveryStatus | (string & {});
     attempts: number;
-    letzterVersuchAt: number | null;
-    naechsterVersuchAt: number | null;
+    lastAttemptAt: number | null;
+    nextAttemptAt: number | null;
     statusCode: number | null;
     /** Auszug der Antwort des Empfaengers, hoechstens 500 Zeichen. */
     response: string | null;
@@ -171,13 +223,23 @@ export declare function listPartnerWebhooks(rufen: InternerTransport): Promise<W
  * tun.
  */
 export declare function updatePartnerWebhook(rufen: InternerTransport, webhookId: string, patch: WebhookPatch): Promise<PartnerWebhook>;
-/** Loescht einen Endpunkt. Danach kommt dort nichts mehr an. */
-export declare function deletePartnerWebhook(rufen: InternerTransport, webhookId: string): Promise<string>;
+/**
+ * Loescht einen Endpunkt. Danach kommt dort nichts mehr an; offene
+ * Zustellungen werden verworfen (`dropped`).
+ */
+export declare function deletePartnerWebhook(rufen: InternerTransport, webhookId: string): Promise<DeleteWebhookResult>;
+/** Eine Zustellung der Probe, so wie `sendPartnerWebhookTest` sie meldet. */
+export interface WebhookTestZustellung {
+    deliveryId: string;
+    webhookId: string;
+    status: WebhookDeliveryStatus | (string & {});
+    statusCode: number | null;
+}
 export interface WebhookTestResult {
     eventId: string;
     /** Welches Ereignis geprobt wurde — ohne Angabe `webhook.test`. */
-    ereignis: string;
-    deliveries: unknown[];
+    event: string;
+    deliveries: WebhookTestZustellung[];
 }
 /**
  * Schickt eine Probe an genau diesen Endpunkt.

package/dist/cjs/partner/webhooks.js

@@ -26,11 +26,11 @@ const webhook_signatur_js_1 = require("./webhook-signatur.js");
  * Alle Ereignisse, die ein Webhook abonnieren **und proben** kann. Ein
  * Endpunkt bekommt ausschliesslich die, die in seiner `events`-Liste stehen.
  *
- * Kasseneck fuehrt daneben interne Ereignisse (etwa den Abschluss eines
- * Auftragsverarbeitungsvertrags). Sie stehen hier bewusst nicht: sie lassen
- * sich weder abonnieren noch mit [sendPartnerWebhookTest] ausloesen, und ein
- * Name in dieser Liste, den niemand bestellen kann, waere ein Versprechen ohne
- * Deckung.
+ * **Noch nicht in der Liste:** `customer.avv_accepted` und
+ * `customer.terms_accepted`. Das Backend bietet sie inzwischen zum Abonnieren
+ * an; die Liste wird mit dem Dart-Zwilling gemeinsam erweitert, weil beide
+ * gegeneinander geprueft werden. Abonnieren geht trotzdem schon (`events`
+ * nimmt jeden Namen), die Nutzlast beschreibt [ContractAcceptedEventData].
  */
 exports.PARTNER_WEBHOOK_EVENTS = [
     'customer.created',
@@ -112,16 +112,30 @@ async function parseWebhookEvent(optionen) {
 function objekt(wert) {
     return wert !== null && typeof wert === 'object' && !Array.isArray(wert) ? wert : {};
 }
+function letzteZustellung(wert) {
+    if (wert === null || typeof wert !== 'object' || Array.isArray(wert))
+        return null;
+    const z = wert;
+    return {
+        at: typeof z['at'] === 'number' ? z['at'] : null,
+        status: typeof z['status'] === 'string' ? z['status'] : '',
+        statusCode: typeof z['statusCode'] === 'number' ? z['statusCode'] : null,
+    };
+}
 function webhook(eintrag) {
     const w = objekt(eintrag);
     return {
         webhookId: typeof w['webhookId'] === 'string' ? w['webhookId'] : '',
+        // Fehlt das Feld, ist es ein Bestands-Webhook: der spricht v1. Kein
+        // `v3` aus Kulanz, sonst verzweigt ein Empfaenger auf englische Werte,
+        // die nie kommen.
+        apiVersion: typeof w['apiVersion'] === 'string' && w['apiVersion'] ? w['apiVersion'] : 'v1',
         url: typeof w['url'] === 'string' ? w['url'] : '',
         events: Array.isArray(w['events']) ? w['events'].filter((e) => typeof e === 'string') : [],
         active: w['active'] !== false,
         description: typeof w['description'] === 'string' ? w['description'] : null,
         createdAt: typeof w['createdAt'] === 'number' ? w['createdAt'] : null,
-        lastDelivery: typeof w['lastDelivery'] === 'number' ? w['lastDelivery'] : null,
+        lastDelivery: letzteZustellung(w['lastDelivery']),
         consecutiveFailures: typeof w['consecutiveFailures'] === 'number' ? w['consecutiveFailures'] : 0,
     };
 }
@@ -198,13 +212,19 @@ async function updatePartnerWebhook(rufen, webhookId, patch) {
     const daten = objekt(await rufen('updatePartnerWebhook', { webhookId: id, patch }));
     return webhook(daten['webhook']);
 }
-/** Loescht einen Endpunkt. Danach kommt dort nichts mehr an. */
+/**
+ * Loescht einen Endpunkt. Danach kommt dort nichts mehr an; offene
+ * Zustellungen werden verworfen (`dropped`).
+ */
 async function deletePartnerWebhook(rufen, webhookId) {
     const id = typeof webhookId === 'string' ? webhookId.trim() : '';
     if (!id)
         throw new errors_js_1.KasseneckValidationError('deletePartnerWebhook', 'webhookId fehlt', 'request');
     const daten = objekt(await rufen('deletePartnerWebhook', { webhookId: id }));
-    return typeof daten['webhookId'] === 'string' ? daten['webhookId'] : id;
+    return {
+        webhookId: typeof daten['webhookId'] === 'string' ? daten['webhookId'] : id,
+        deleted: daten['deleted'] === true,
+    };
 }
 /**
  * Schickt eine Probe an genau diesen Endpunkt.
@@ -234,8 +254,16 @@ async function sendPartnerWebhookTest(rufen, webhookId, event) {
     const daten = objekt(await rufen('sendPartnerWebhookTest', { webhookId: id, event: ereignis || undefined }));
     return {
         eventId: typeof daten['eventId'] === 'string' ? daten['eventId'] : '',
-        ereignis: typeof daten['ereignis'] === 'string' ? daten['ereignis'] : ereignis || 'webhook.test',
-        deliveries: Array.isArray(daten['deliveries']) ? daten['deliveries'] : [],
+        event: typeof daten['event'] === 'string' ? daten['event'] : ereignis || 'webhook.test',
+        deliveries: (Array.isArray(daten['deliveries']) ? daten['deliveries'] : []).map((eintrag) => {
+            const z = objekt(eintrag);
+            return {
+                deliveryId: typeof z['deliveryId'] === 'string' ? z['deliveryId'] : '',
+                webhookId: typeof z['webhookId'] === 'string' ? z['webhookId'] : id,
+                status: typeof z['status'] === 'string' ? z['status'] : '',
+                statusCode: typeof z['statusCode'] === 'number' ? z['statusCode'] : null,
+            };
+        }),
     };
 }
 /**
@@ -259,8 +287,8 @@ async function listPartnerWebhookDeliveries(rufen, optionen = {}) {
             eventId: txt(z['eventId']) ?? '',
             status: txt(z['status']) ?? '',
             attempts: zahl(z['attempts']) ?? 0,
-            letzterVersuchAt: zahl(z['letzterVersuchAt']),
-            naechsterVersuchAt: zahl(z['naechsterVersuchAt']),
+            lastAttemptAt: zahl(z['lastAttemptAt']),
+            nextAttemptAt: zahl(z['nextAttemptAt']),
             statusCode: zahl(z['statusCode']),
             response: txt(z['response']),
             createdAt: zahl(z['createdAt']),

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

@@ -22,9 +22,10 @@
  * Terminal spricht. Das ist kein Widerspruch zur Umgebungsgrenze, sondern ein
  * zweiter, seit `hobex-hps.js` genutzter Weg um sie herum.
  *
- * Wer Gutschrift oder Storno am HPS-Terminal braucht, braucht weiterhin die
- * Flutter-App: Connect exponiert dafuer (noch) keinen Endpunkt, siehe
- * `hobex-hps/connect-client.ts`.
+ * Gutschrift und Storno am HPS-Terminal laufen ebenfalls ueber Connect
+ * (`POST /v1/terminal/refund` bzw. `/cancel`): `HpsPayments.refund`/`cancel`
+ * mit `HpsRefundOptions`/`HpsCancelOptions`, darunter
+ * `HpsConnectClient.refund`/`cancel`, siehe `hobex-hps/connect-client.ts`.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** **Keiner** der
  * vier Cloud-Zahlungs-Endpunkte (Stripe, Hobex-Cloud) setzt `allowRegisterUser`;
@@ -42,4 +43,4 @@
 export { StripeLinkMode, type StripeLinkModeKey } from '../enums/index.js';
 export { type CreateStripeLinkOptions, type StripeCaptureResult, createStripeLink, stripeCaptureIntent, } from './stripe.js';
 export { type HobexPayOptions, type HobexRefundOptions, type HobexTransactionIdOptions, hobexPay, hobexRefund, newHobexTransactionId, } from './hobex.js';
-export { type CardPaymentOutcome, type HpsConnectClient, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, type HpsPaymentOptions, type HpsPayments, type HpsPaymentResult, type HpsPaymentsOptions, type HpsTransactionIdGeneratorOptions, type HpsTransactionResponse, ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';
+export { type CardPaymentOutcome, type HpsConnectClient, type HpsConnectCancelOptions, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectRefundOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, type HpsCancelOptions, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, type HpsPaymentOptions, type HpsPayments, type HpsPaymentResult, type HpsPaymentsOptions, type HpsRefundOptions, type HpsTransactionIdGeneratorOptions, type HpsTransactionResponse, ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';