@kreiseck/kasseneck-api 0.27.3 → 0.29.0

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,19 +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
+    'tax_number_missing',
     // Signatur
     'fon_missing',
     'signature_pending',
-    'request_not_found',
     'signature_missing',
     'signature_unknown',
     'signature_ambiguous',
@@ -67,6 +93,17 @@ exports.PARTNER_FEHLER_CODES = [
     'module_inactive',
     'cashregister_limit',
     'cashregister_not_found',
+    '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',
@@ -116,26 +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 zugang{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.',
+    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 signaturId 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 signaturId mitgeben.',
+    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.',
+    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

@@ -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, 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/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,26 +319,39 @@ 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 & {});
+/**
+ * `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 {
-    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: {
-        code: string | null;
+        code: SignatureErrorCode | null;
         message: string | null;
         rc: string | null;
     } | null;
@@ -278,18 +360,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: SignatureErrorCode | 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 +414,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 +468,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.