@kreiseck/kasseneck-api 0.27.3 → 0.29.0

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/esm/partner/ablauf.d.ts

@@ -10,9 +10,10 @@
  * Fehler. Hier steht sie vorher — abfragbar, ausgebbar, und in
  * [naechsterSchritt] auch beantwortbar.
  *
- * **Ohne Vertragsschritt.** Auftragsverarbeitungsvertraege wirken in diesem
- * Weg nicht mehr (Stand 2026-08-31): kein Aufruf meldet einen, keine Kasse
- * bleibt deswegen stehen.
+ * **Kein eigener Vertragsschritt.** AVV und Nutzungsvertrag bestaetigt der
+ * Betrieb ueber denselben Einrichtungs-Link wie seinen FinanzOnline-Zugang
+ * (Schritt `fon`). Live geht ohne beide keine Kasse live
+ * (`vertrag_offen`); den Stand zeigen `avv` und `terms` am Betrieb.
  *
  * Zwei Dinge laufen bewusst **parallel**: der Signaturantrag und das Anlegen
  * der Kasse. Eine mit `automatic:true` angelegte Kasse wartet, bis die

package/dist/esm/partner/ablauf.js

@@ -10,9 +10,10 @@
  * Fehler. Hier steht sie vorher — abfragbar, ausgebbar, und in
  * [naechsterSchritt] auch beantwortbar.
  *
- * **Ohne Vertragsschritt.** Auftragsverarbeitungsvertraege wirken in diesem
- * Weg nicht mehr (Stand 2026-08-31): kein Aufruf meldet einen, keine Kasse
- * bleibt deswegen stehen.
+ * **Kein eigener Vertragsschritt.** AVV und Nutzungsvertrag bestaetigt der
+ * Betrieb ueber denselben Einrichtungs-Link wie seinen FinanzOnline-Zugang
+ * (Schritt `fon`). Live geht ohne beide keine Kasse live
+ * (`vertrag_offen`); den Stand zeigen `avv` und `terms` am Betrieb.
  *
  * Zwei Dinge laufen bewusst **parallel**: der Signaturantrag und das Anlegen
  * der Kasse. Eine mit `automatic:true` angelegte Kasse wartet, bis die

package/dist/esm/partner/api.d.ts

@@ -5,12 +5,27 @@
  * Funktionen und bleiben einzeln importierbar.
  */
 import { type FetchLike } from '../client/transport.js';
-import { type CreateWebhookOptions, type CreateWebhookResult, type PartnerWebhook, type WebhookListe, type PartnerWebhookEventType, type WebhookPatch, type WebhookTestResult, type WebhookZustellung } from './webhooks.js';
-import type { ActivateCashregisterResult, CreateCashregisterOptions, CreateCashregisterResult, CreateCustomerOptions, CreateCustomerResult, CustomerCredentials, FonLinkResult, KassenListe, Kunde, KundenListe, ListCustomersOptions, PartnerInfo, RequestSignatureResult, SignaturStand } from './typen.js';
+import { type CreateWebhookOptions, type CreateWebhookResult, type DeleteWebhookResult, type PartnerWebhook, type WebhookListe, type PartnerWebhookEventType, type WebhookPatch, type WebhookTestResult, type WebhookZustellung } from './webhooks.js';
+import type { ActivateCashregisterResult, CreateCashregisterOptions, CreateCashregisterResult, CreateCustomerOptions, CreateCustomerResult, CustomerCredentials, FonLinkResult, KassenListe, Kunde, KundenListe, ListCustomersOptions, PartnerInfo, RequestSignatureOptions, RequestSignatureResult, SignaturStand } from './typen.js';
+/**
+ * Die Basis-URL der Partner-API: `/v3`, die englische Fassung.
+ *
+ * Nur der Partner-Teil spricht `/v3`. Belege, Rechnungen, Kasse und Zahlungen
+ * laufen weiter ueber [DEFAULT_BASE_URL] (`/v1`), bis es fuer sie eine `/v3`
+ * gibt. Die Partner-Endpunkte unter `/v1` antworten weiter, deutsch und
+ * abgekuendigt (Kopfzeilen `Deprecation`/`Sunset`); dieser Client spricht sie
+ * nicht mehr.
+ */
+export declare const PARTNER_BASE_URL = "https://api.kasseneck.at/v3";
 export interface PartnerApiOptions {
     /** Partner-Schluessel `pk_test_…` / `pk_live_…`. Gehoert auf einen Server. */
     partnerKey: string;
-    /** Abweichende Basis-URL; Vorgabe `https://api.kasseneck.at/v1`. */
+    /**
+     * Abweichende Basis-URL; Vorgabe [PARTNER_BASE_URL]
+     * (`https://api.kasseneck.at/v3`). Die Antworten werden in der Form der
+     * `/v3` gelesen: eine `/v1`-Adresse hier liefert deutsche Werte, die diese
+     * Typen nicht beschreiben.
+     */
     baseUrl?: string;
     /** Zeitlimit je Aufruf in Millisekunden. */
     timeoutMs?: number;
@@ -23,10 +38,7 @@ export interface PartnerApi {
     listPartnerCustomers(optionen?: ListCustomersOptions): Promise<KundenListe>;
     getPartnerCustomer(customerId: string): Promise<Kunde>;
     sendPartnerCustomerFonLink(customerId: string): Promise<FonLinkResult>;
-    requestCustomerSignature(customerId: string, optionen?: {
-        art?: string;
-        additional?: boolean;
-    }): Promise<RequestSignatureResult>;
+    requestCustomerSignature(customerId: string, optionen?: RequestSignatureOptions): Promise<RequestSignatureResult>;
     getCustomerSignatureStatus(customerId: string): Promise<SignaturStand>;
     createCustomerCashregister(optionen: CreateCashregisterOptions): Promise<CreateCashregisterResult>;
     activateCashregister(customerId: string, cashregisterId: string): Promise<ActivateCashregisterResult>;
@@ -42,7 +54,7 @@ export interface PartnerApi {
     createPartnerWebhook(optionen: CreateWebhookOptions): Promise<CreateWebhookResult>;
     listPartnerWebhooks(): Promise<WebhookListe>;
     updatePartnerWebhook(webhookId: string, patch: WebhookPatch): Promise<PartnerWebhook>;
-    deletePartnerWebhook(webhookId: string): Promise<string>;
+    deletePartnerWebhook(webhookId: string): Promise<DeleteWebhookResult>;
     /**
      * Neues Secret fuer denselben Endpunkt — dieselbe `webhookId`, dieselben
      * Ereignisse. Das alte gilt ab der Antwort nicht mehr.

package/dist/esm/partner/api.js

@@ -9,10 +9,20 @@ import { partnerKeyAuth } from './auth.js';
 import { partnerFehlerRat } from './fehler.js';
 import { activateCashregister, createCustomerCashregister, createPartnerCustomer, getCustomerCredentials, getCustomerSignatureStatus, getPartnerCustomer, getPartnerInfo, checkPartnerCustomerEmail, listCustomerCashregisters, listPartnerCustomers, requestCustomerSignature, sendPartnerCustomerFonLink, } from './endpunkte.js';
 import { createPartnerWebhook, deletePartnerWebhook, listPartnerWebhookDeliveries, listPartnerWebhooks, rotatePartnerWebhookSecret, sendPartnerWebhookTest, updatePartnerWebhook, } from './webhooks.js';
+/**
+ * Die Basis-URL der Partner-API: `/v3`, die englische Fassung.
+ *
+ * Nur der Partner-Teil spricht `/v3`. Belege, Rechnungen, Kasse und Zahlungen
+ * laufen weiter ueber [DEFAULT_BASE_URL] (`/v1`), bis es fuer sie eine `/v3`
+ * gibt. Die Partner-Endpunkte unter `/v1` antworten weiter, deutsch und
+ * abgekuendigt (Kopfzeilen `Deprecation`/`Sunset`); dieser Client spricht sie
+ * nicht mehr.
+ */
+export const PARTNER_BASE_URL = 'https://api.kasseneck.at/v3';
 export function createPartnerApi(optionen) {
     const rufen = createTransport({
         auth: partnerKeyAuth({ partnerKey: optionen.partnerKey }),
-        baseUrl: optionen.baseUrl,
+        baseUrl: optionen.baseUrl ?? PARTNER_BASE_URL,
         timeoutMs: optionen.timeoutMs,
         fetch: optionen.fetch,
     });

package/dist/esm/partner/endpunkte.d.ts

@@ -19,7 +19,7 @@
  * einen `TypeError` an unpassender Stelle.
  */
 import type { InternerTransport } from '../client/aufrufe.js';
-import type { ActivateCashregisterResult, CreateCashregisterOptions, CreateCashregisterResult, CreateCustomerOptions, CreateCustomerResult, CustomerCredentials, FonLinkResult, KassenListe, Kunde, KundenListe, ListCustomersOptions, PartnerInfo, RequestSignatureResult, SignaturStand } from './typen.js';
+import type { ActivateCashregisterResult, CreateCashregisterOptions, CreateCashregisterResult, CreateCustomerOptions, CreateCustomerResult, CustomerCredentials, FonLinkResult, KassenListe, Kunde, KundenListe, ListCustomersOptions, PartnerInfo, RequestSignatureOptions, RequestSignatureResult, SignaturStand } from './typen.js';
 /**
  * Wer bin ich, in welcher Umgebung, mit welchen Rechten — und welche Apps
  * gehoeren mir. `apps[].id` ist die `appId` fuer [createPartnerCustomer].
@@ -76,8 +76,8 @@ export declare function sendPartnerCustomerFonLink(rufen: InternerTransport, cus
  * Vertrauensdiensteanbieter **auf diesen Betrieb** ausstellen und meldet sie
  * bei FinanzOnline an; einen Vorrat fertiger Karten gibt es nicht.
  *
- * Der Antrag erzeugt sofort ein Signatur-OBJEKT: `antrag.requestId` ist
- * zugleich die `signaturId`, auf die sich eine Kasse beruft — auch solange
+ * Der Antrag erzeugt sofort ein Signatur-OBJEKT: `request.requestId` ist
+ * zugleich die `signatureRequestId`, auf die sich eine Kasse beruft — auch solange
  * noch keine Karte zugewiesen ist.
  *
  * **Je Betrieb laeuft nur ein Antrag.** Ein zweiter Aufruf liefert den
@@ -87,23 +87,20 @@ export declare function sendPartnerCustomerFonLink(rufen: InternerTransport, cus
  * Abschluss kommt als Ereignis `signature.ready`, nicht als Antwort auf diesen
  * Aufruf.
  */
-export declare function requestCustomerSignature(rufen: InternerTransport, customerId: string, optionen?: {
-    art?: string;
-    additional?: boolean;
-}): Promise<RequestSignatureResult>;
-/** Stand der Signatur eines Betriebs samt aller Antraege und des FON-Zugangs. */
+export declare function requestCustomerSignature(rufen: InternerTransport, customerId: string, optionen?: RequestSignatureOptions): Promise<RequestSignatureResult>;
+/** Stand der Signatur eines Betriebs samt aller Signaturen, Antraege und des FON-Zugangs. */
 export declare function getCustomerSignatureStatus(rufen: InternerTransport, customerId: string): Promise<SignaturStand>;
 /**
  * Legt eine Kasse an.
  *
  * **Jede Kasse bezieht sich auf eine Signatur.** Ohne eine einzige — auch eine
  * noch laufende zaehlt — entsteht keine (`signature_missing`); bei mehreren
- * muss `signaturId` dastehen (`signature_ambiguous`).
+ * muss `signatureRequestId` dastehen (`signature_ambiguous`).
  *
  * **Darf vor der fertigen Signatur aufgerufen werden:** die Kasse bleibt dann
- * auf `entwurf` und geht von selbst live, sobald IHRE Signatur bereit ist
- * (`automatic:true`, Vorgabe). `inbetriebnahme.reason` sagt, warum gerade
- * nichts lief: `signature_not_ready` oder `automatik_aus`.
+ * auf `draft` und geht von selbst live, sobald IHRE Signatur bereit ist
+ * (`automatic:true`, Vorgabe). `activation.reason` sagt, warum gerade
+ * nichts lief: `signature_not_ready` oder `automation_off`.
  *
  * Hoechstens 20 Kassen je Betrieb (`cashregister_limit`); ohne gebuchtes Modul
  * `module_inactive`.

package/dist/esm/partner/endpunkte.js

@@ -45,6 +45,19 @@ function zahlOderNull(wert) {
 function jaNein(wert, rueckfall = false) {
     return typeof wert === 'boolean' ? wert : rueckfall;
 }
+/**
+ * Das gebuchte Entgelt (`fee`), falls die Antwort eines fuehrt. Ohne Betrag
+ * ist es keines: ein erfundenes `0` saehe aus wie ein kostenloser Posten.
+ */
+function entgelt(wert) {
+    if (wert === null || typeof wert !== 'object' || Array.isArray(wert))
+        return null;
+    const f = wert;
+    const cents = zahlOderNull(f['cents']);
+    if (cents === null)
+        return null;
+    return { cents, interval: text(f['interval']), test: jaNein(f['test']) };
+}
 /**
  * Verlangt ein Feld der Antwort. Der Fehler nennt das Feld und den Vorgang,
  * damit ein Aufrufer nicht raten muss, welcher der Aufrufe etwas anderes
@@ -158,6 +171,7 @@ export async function createPartnerCustomer(rufen, optionen) {
         appId: text(daten['appId'], appId),
         access: { invited: jaNein(zugang['invited']), sentTo: textOderNull(zugang['sentTo']) },
         nextSteps: liste(daten['nextSteps']).filter((s) => typeof s === 'string'),
+        fee: entgelt(daten['fee']),
         replayed: jaNein(daten['replayed']),
     };
 }
@@ -186,26 +200,38 @@ function kundenZeile(eintrag) {
         appId: textOderNull(k['appId']),
         env: text(k['env']) === 'test' ? 'test' : 'live',
         createdAt: zahlOderNull(k['createdAt']),
+        fon: fonStand(k['fon']),
         avv: avvStand(k['avv']),
+        terms: vertragStand(k['terms']),
     };
 }
-/**
- * Der Vertragsstand, **falls** die Antwort ihn ueberhaupt fuehrt — heute tut
- * sie das nicht, dann bleibt es bei `null`. Kein erfundenes `offen`: „nicht
- * mitgeliefert" und „nicht bestaetigt" duerfen fuer einen Aufrufer nicht
- * dasselbe sein.
- */
-function avvStand(wert) {
+function fonStand(wert) {
     if (wert === null || typeof wert !== 'object' || Array.isArray(wert))
         return null;
-    const a = wert;
+    const f = wert;
     return {
-        status: text(a['status']),
-        version: textOderNull(a['version']),
-        confirmedAt: zahlOderNull(a['confirmedAt']),
-        mode: textOderNull(a['mode']),
+        configured: jaNein(f['configured']),
+        linkSentAt: zahlOderNull(f['linkSentAt']),
+        linkOpenedAt: zahlOderNull(f['linkOpenedAt']),
     };
 }
+function vertragStand(wert) {
+    if (wert === null || typeof wert !== 'object' || Array.isArray(wert))
+        return null;
+    const v = wert;
+    return { status: text(v['status']), version: textOderNull(v['version']), confirmedAt: zahlOderNull(v['confirmedAt']) };
+}
+/**
+ * Der AVV-Stand, **falls** die Antwort ihn fuehrt; sonst `null`. Kein
+ * erfundenes `pending`: „nicht mitgeliefert" und „nicht bestaetigt" duerfen
+ * fuer einen Aufrufer nicht dasselbe sein.
+ */
+function avvStand(wert) {
+    const v = vertragStand(wert);
+    if (!v)
+        return null;
+    return { ...v, mode: textOderNull(wert['mode']) };
+}
 /** Ein Betrieb mit allem, was der Partner ueber ihn sehen darf — nie Geheimnisse. */
 export async function getPartnerCustomer(rufen, customerId) {
     const id = pflicht(customerId, 'getPartnerCustomer', 'customerId');
@@ -220,7 +246,13 @@ export async function getPartnerCustomer(rufen, customerId) {
         createdAt: zahlOderNull(k['createdAt']),
         createdVia: textOderNull(k['createdVia']),
         business: objekt(k['business']),
-        fon: { configured: jaNein(fon['configured']), verifiedAt: zahlOderNull(fon['verifiedAt']) },
+        fon: {
+            configured: jaNein(fon['configured']),
+            verifiedAt: zahlOderNull(fon['verifiedAt']),
+            linkSentAt: zahlOderNull(fon['linkSentAt']),
+            linkSentTo: textOderNull(fon['linkSentTo']),
+            linkOpenedAt: zahlOderNull(fon['linkOpenedAt']),
+        },
         access: zugang === null || typeof zugang !== 'object'
             ? null
             : {
@@ -274,7 +306,7 @@ function antrag(eintrag) {
         requestId: text(a['requestId']),
         status: text(a['status']),
         statusText: text(a['statusText']),
-        art: text(a['art'], 'signature_card'),
+        kind: text(a['kind'], 'signature_card'),
         vdaId: textOderNull(a['vdaId']),
         signatureId: textOderNull(a['signatureId']),
         error: fehler === null || typeof fehler !== 'object'
@@ -290,8 +322,8 @@ function antrag(eintrag) {
         history: liste(a['history']).map((h) => {
             const e = objekt(h);
             return {
-                von: textOderNull(e['von']),
-                nach: text(e['nach']),
+                from: textOderNull(e['from']),
+                to: text(e['to']),
                 at: zahlOderNull(e['at']) ?? 0,
                 reason: textOderNull(e['reason']),
             };
@@ -303,8 +335,8 @@ function antrag(eintrag) {
  * Vertrauensdiensteanbieter **auf diesen Betrieb** ausstellen und meldet sie
  * bei FinanzOnline an; einen Vorrat fertiger Karten gibt es nicht.
  *
- * Der Antrag erzeugt sofort ein Signatur-OBJEKT: `antrag.requestId` ist
- * zugleich die `signaturId`, auf die sich eine Kasse beruft — auch solange
+ * Der Antrag erzeugt sofort ein Signatur-OBJEKT: `request.requestId` ist
+ * zugleich die `signatureRequestId`, auf die sich eine Kasse beruft — auch solange
  * noch keine Karte zugewiesen ist.
  *
  * **Je Betrieb laeuft nur ein Antrag.** Ein zweiter Aufruf liefert den
@@ -318,27 +350,54 @@ export async function requestCustomerSignature(rufen, customerId, optionen = {})
     const id = pflicht(customerId, 'requestCustomerSignature', 'customerId');
     const daten = objekt(await rufen('requestCustomerSignature', {
         customerId: id,
-        art: optionen.art,
+        kind: optionen.kind,
         additional: optionen.additional,
     }));
     return {
         request: antrag(verlangt(daten['request'], 'requestCustomerSignature', 'request')),
         replayed: jaNein(daten['replayed']),
         note: textOderNull(daten['note']),
+        fee: entgelt(daten['fee']),
     };
 }
-/** Stand der Signatur eines Betriebs samt aller Antraege und des FON-Zugangs. */
+function signaturEinzeln(eintrag) {
+    const s = objekt(eintrag);
+    const fehler = s['error'];
+    return {
+        signatureRequestId: text(s['signatureRequestId']),
+        status: text(s['status']),
+        statusText: text(s['statusText']),
+        inProgress: jaNein(s['inProgress']),
+        ready: jaNein(s['ready']),
+        kind: text(s['kind'], 'signature_card'),
+        vdaId: textOderNull(s['vdaId']),
+        requestId: textOderNull(s['requestId']),
+        signatureId: textOderNull(s['signatureId']),
+        error: fehler === null || typeof fehler !== 'object'
+            ? null
+            : {
+                code: textOderNull(objekt(fehler)['code']),
+                message: textOderNull(objekt(fehler)['message']),
+                rc: textOderNull(objekt(fehler)['rc']),
+            },
+        createdAt: zahlOderNull(s['createdAt']),
+        updatedAt: zahlOderNull(s['updatedAt']),
+    };
+}
+/** Stand der Signatur eines Betriebs samt aller Signaturen, Antraege und des FON-Zugangs. */
 export async function getCustomerSignatureStatus(rufen, customerId) {
     const id = pflicht(customerId, 'getCustomerSignatureStatus', 'customerId');
     const daten = objekt(await rufen('getCustomerSignatureStatus', { customerId: id }));
-    const signatur = objekt(daten['signatur']);
+    const signatur = objekt(daten['signature']);
     const fon = objekt(daten['fon']);
     return {
-        signatur: {
+        customerId: text(daten['customerId'], id),
+        signature: {
             ready: jaNein(signatur['ready']),
             signatureId: textOderNull(signatur['signatureId']),
             vdaId: textOderNull(signatur['vdaId']),
         },
+        signatures: liste(daten['signatures']).map(signaturEinzeln),
         requests: liste(daten['requests']).map(antrag),
         fon: { present: jaNein(fon['present']), verifiedAt: zahlOderNull(fon['verifiedAt']) },
     };
@@ -378,12 +437,12 @@ function kasse(eintrag) {
  *
  * **Jede Kasse bezieht sich auf eine Signatur.** Ohne eine einzige — auch eine
  * noch laufende zaehlt — entsteht keine (`signature_missing`); bei mehreren
- * muss `signaturId` dastehen (`signature_ambiguous`).
+ * muss `signatureRequestId` dastehen (`signature_ambiguous`).
  *
  * **Darf vor der fertigen Signatur aufgerufen werden:** die Kasse bleibt dann
- * auf `entwurf` und geht von selbst live, sobald IHRE Signatur bereit ist
- * (`automatic:true`, Vorgabe). `inbetriebnahme.reason` sagt, warum gerade
- * nichts lief: `signature_not_ready` oder `automatik_aus`.
+ * auf `draft` und geht von selbst live, sobald IHRE Signatur bereit ist
+ * (`automatic:true`, Vorgabe). `activation.reason` sagt, warum gerade
+ * nichts lief: `signature_not_ready` oder `automation_off`.
  *
  * Hoechstens 20 Kassen je Betrieb (`cashregister_limit`); ohne gebuchtes Modul
  * `module_inactive`.

package/dist/esm/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", "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", "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/esm/partner/fehler.js

@@ -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).
  */
 import { KasseneckApiError } from '../client/errors.js';
 /**
@@ -34,19 +60,19 @@ export const 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',
@@ -57,6 +83,17 @@ export const 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',
@@ -106,26 +143,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.',