@kreiseck/kasseneck-api 0.31.0 → 1.0.0-rc.2

package/dist/cjs/partner/ablauf.js

@@ -9,12 +9,12 @@
  * `signature_not_ready`).
  * Wer die Reihenfolge nur aus einer Fehlermeldung lernt, lernt sie einmal je
  * Fehler. Hier steht sie vorher — abfragbar, ausgebbar, und in
- * [naechsterSchritt] auch beantwortbar.
+ * [nextFlowStep] auch beantwortbar.
  *
  * **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.
+ * (`contracts_pending`); 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
@@ -23,57 +23,57 @@
  * laufende Arbeit.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PARTNER_ABLAUF = void 0;
-exports.naechsterSchritt = naechsterSchritt;
+exports.PARTNER_FLOW = void 0;
+exports.nextFlowStep = nextFlowStep;
 /**
  * Die Kette in ihrer Reihenfolge. Sie beschreibt den **Live-Weg**; mit einem
  * `pk_test_`-Schluessel entfallen die FinanzOnline-Schritte, und die Signatur
  * ist sofort bereit (AT100-Testkarte — die damit erzeugten Belege sind keine
  * gueltigen RKSV-Belege).
  */
-exports.PARTNER_ABLAUF = [
+exports.PARTNER_FLOW = [
     {
         key: 'business',
         text: 'Betrieb anlegen (idempotencyKey = eigene Kundennummer).',
-        aufruf: 'createPartnerCustomer',
-        wartetAuf: 'customer.created',
-        fehltCode: null,
+        call: 'createPartnerCustomer',
+        waitsFor: 'customer.created',
+        missingCode: null,
     },
     {
         key: 'fon',
         text: 'FinanzOnline einrichten: Link an den Betrieb, der Betrieb traegt seinen Zugang ein.',
-        aufruf: 'sendPartnerCustomerFonLink',
-        wartetAuf: 'customer.fon_verified',
-        fehltCode: 'fon_missing',
+        call: 'sendPartnerCustomerFonLink',
+        waitsFor: 'customer.fon_verified',
+        missingCode: 'fon_missing',
     },
     {
         key: 'signature',
         text: 'Signatureinheit beantragen. Kasseneck weist eine Karte zu und meldet sie bei FinanzOnline an.',
-        aufruf: 'requestCustomerSignature',
-        wartetAuf: 'signature.ready',
-        fehltCode: 'signature_missing',
+        call: 'requestCustomerSignature',
+        waitsFor: 'signature.ready',
+        missingCode: 'signature_missing',
     },
     {
         key: 'cashregister',
         text: 'Kasse anlegen. Mit automatic:true (Vorgabe) geht sie von selbst live, sobald die Signatur bereit ist — ' +
             'sie darf deshalb schon vorher angelegt werden.',
-        aufruf: 'createCustomerCashregister',
-        wartetAuf: 'cashregister.live',
-        fehltCode: 'cashregister_not_found',
+        call: 'createCustomerCashregister',
+        waitsFor: 'cashregister.live',
+        missingCode: 'cashregister_not_found',
     },
     {
-        key: 'zugangsdaten',
+        key: 'credentials',
         text: 'Zugangsdaten des Betriebs holen (Scope credentials:read). Geheimnisse — nur verschluesselt speichern.',
-        aufruf: 'getCustomerCredentials',
-        wartetAuf: null,
-        fehltCode: null,
+        call: 'getCustomerCredentials',
+        waitsFor: null,
+        missingCode: null,
     },
     {
-        key: 'belege',
+        key: 'receipts',
         text: 'Belege signieren: Bearer = apiKey des Betriebs, Kopfzeile cashregister-token = Token der Kasse.',
-        aufruf: 'createReceipt',
-        wartetAuf: null,
-        fehltCode: null,
+        call: 'createReceipt',
+        waitsFor: null,
+        missingCode: null,
     },
 ];
 /**
@@ -88,13 +88,13 @@ const STATUS_SCHRITT = {
     signature_requested: 'signature',
     signature_ready: 'cashregister',
     cashregister_created: 'cashregister',
-    live: 'zugangsdaten',
+    live: 'credentials',
 };
 /**
  * Der Schritt, an dem ein Betrieb mit diesem Status steht — `null` fuer
- * `gesperrt` und fuer jeden Status, den dieses Paket nicht kennt.
+ * `blocked` und fuer jeden Status, den dieses Paket nicht kennt.
  */
-function naechsterSchritt(status) {
+function nextFlowStep(status) {
     const key = STATUS_SCHRITT[status];
-    return key ? exports.PARTNER_ABLAUF.find((s) => s.key === key) ?? null : null;
+    return key ? exports.PARTNER_FLOW.find((s) => s.key === key) ?? null : null;
 }

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

@@ -5,16 +5,13 @@
  * Funktionen und bleiben einzeln importierbar.
  */
 import { type FetchLike } from '../client/transport.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';
+import { type CreateWebhookOptions, type CreateWebhookResult, type DeleteWebhookResult, type PartnerWebhook, type WebhookList, type PartnerWebhookEventType, type WebhookPatch, type WebhookTestResult, type WebhookDelivery } from './webhooks.js';
+import type { ActivateCashregisterResult, CreateCashregisterOptions, CreateCashregisterResult, CreateCustomerOptions, CreateCustomerResult, CustomerCredentials, FonLinkResult, CustomerCashregisterList, PartnerCustomer, PartnerCustomerList, ListCustomersOptions, PartnerInfo, ReportCustomerContractOptions, ReportCustomerContractResult, RequestSignatureOptions, RequestSignatureResult, CustomerSignatureStatus } 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.
+ * Die Basis-URL der Partner-API: `/v3`, die englische Fassung, dieselbe wie
+ * [DEFAULT_BASE_URL]. Die 1.x-Linie spricht nur noch `/v3`; die
+ * Partner-Endpunkte unter `/v1` antworten weiter, deutsch und abgekuendigt
+ * (Kopfzeilen `Deprecation`/`Sunset`), dieser Client spricht sie nicht.
  */
 export declare const PARTNER_BASE_URL = "https://api.kasseneck.at/v3";
 export interface PartnerApiOptions {
@@ -34,15 +31,15 @@ export interface PartnerApiOptions {
 }
 export interface PartnerApi {
     getPartnerInfo(): Promise<PartnerInfo>;
-    createPartnerCustomer(optionen: CreateCustomerOptions): Promise<CreateCustomerResult>;
-    listPartnerCustomers(optionen?: ListCustomersOptions): Promise<KundenListe>;
-    getPartnerCustomer(customerId: string): Promise<Kunde>;
+    createPartnerCustomer(options: CreateCustomerOptions): Promise<CreateCustomerResult>;
+    listPartnerCustomers(options?: ListCustomersOptions): Promise<PartnerCustomerList>;
+    getPartnerCustomer(customerId: string): Promise<PartnerCustomer>;
     sendPartnerCustomerFonLink(customerId: string): Promise<FonLinkResult>;
-    requestCustomerSignature(customerId: string, optionen?: RequestSignatureOptions): Promise<RequestSignatureResult>;
-    getCustomerSignatureStatus(customerId: string): Promise<SignaturStand>;
-    createCustomerCashregister(optionen: CreateCashregisterOptions): Promise<CreateCashregisterResult>;
+    requestCustomerSignature(customerId: string, options?: RequestSignatureOptions): Promise<RequestSignatureResult>;
+    getCustomerSignatureStatus(customerId: string): Promise<CustomerSignatureStatus>;
+    createCustomerCashregister(options: CreateCashregisterOptions): Promise<CreateCashregisterResult>;
     activateCashregister(customerId: string, cashregisterId: string): Promise<ActivateCashregisterResult>;
-    listCustomerCashregisters(customerId: string): Promise<KassenListe>;
+    listCustomerCashregisters(customerId: string): Promise<CustomerCashregisterList>;
     /** Geheimnisse des Betriebs — siehe `getCustomerCredentials` in endpunkte.ts. */
     getCustomerCredentials(customerId: string): Promise<CustomerCredentials>;
     /**
@@ -51,8 +48,13 @@ export interface PartnerApi {
      * erst nach dem ganzen Formular auf.
      */
     checkPartnerCustomerEmail(email: string): Promise<boolean>;
-    createPartnerWebhook(optionen: CreateWebhookOptions): Promise<CreateWebhookResult>;
-    listPartnerWebhooks(): Promise<WebhookListe>;
+    /**
+     * Meldet eine in Vollmacht eingeholte Zustimmung des Betriebs (nur AVV);
+     * siehe `reportCustomerContract` in endpunkte.ts.
+     */
+    reportCustomerContract(options: ReportCustomerContractOptions): Promise<ReportCustomerContractResult>;
+    createPartnerWebhook(options: CreateWebhookOptions): Promise<CreateWebhookResult>;
+    listPartnerWebhooks(): Promise<WebhookList>;
     updatePartnerWebhook(webhookId: string, patch: WebhookPatch): Promise<PartnerWebhook>;
     deletePartnerWebhook(webhookId: string): Promise<DeleteWebhookResult>;
     /**
@@ -66,15 +68,16 @@ export interface PartnerApi {
      * soll. Jede Probe traegt `test: true` im Umschlag.
      */
     sendPartnerWebhookTest(webhookId: string, event?: PartnerWebhookEventType | (string & {})): Promise<WebhookTestResult>;
-    listPartnerWebhookDeliveries(optionen?: {
+    listPartnerWebhookDeliveries(options?: {
         webhookId?: string;
         limit?: number;
-    }): Promise<WebhookZustellung[]>;
+    }): Promise<WebhookDelivery[]>;
     /**
      * Der Handlungssatz zu einem beliebigen Fehlercode der Partner-API. Gehoert
      * in die eigene Fehlermeldung, damit ein Anwender nicht in der Doku
-     * nachschlagen muss.
+     * nachschlagen muss. Fuer einen unbekannten Code kommt ein Rueckfallsatz,
+     * nie `undefined` und nie ein Wurf.
      */
-    fehlerRat(code: string): string | undefined;
+    errorAdvice(code: string): string;
 }
-export declare function createPartnerApi(optionen: PartnerApiOptions): PartnerApi;
+export declare function createPartnerApi(options: PartnerApiOptions): PartnerApi;

package/dist/cjs/partner/api.js

@@ -14,21 +14,18 @@ const fehler_js_1 = require("./fehler.js");
 const endpunkte_js_1 = require("./endpunkte.js");
 const webhooks_js_1 = require("./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.
+ * Die Basis-URL der Partner-API: `/v3`, die englische Fassung, dieselbe wie
+ * [DEFAULT_BASE_URL]. Die 1.x-Linie spricht nur noch `/v3`; die
+ * Partner-Endpunkte unter `/v1` antworten weiter, deutsch und abgekuendigt
+ * (Kopfzeilen `Deprecation`/`Sunset`), dieser Client spricht sie nicht.
  */
 exports.PARTNER_BASE_URL = 'https://api.kasseneck.at/v3';
-function createPartnerApi(optionen) {
+function createPartnerApi(options) {
     const rufen = (0, transport_js_1.createTransport)({
-        auth: (0, auth_js_1.partnerKeyAuth)({ partnerKey: optionen.partnerKey }),
-        baseUrl: optionen.baseUrl ?? exports.PARTNER_BASE_URL,
-        timeoutMs: optionen.timeoutMs,
-        fetch: optionen.fetch,
+        auth: (0, auth_js_1.partnerKeyAuth)({ partnerKey: options.partnerKey }),
+        baseUrl: options.baseUrl ?? exports.PARTNER_BASE_URL,
+        timeoutMs: options.timeoutMs,
+        fetch: options.fetch,
     });
     return {
         getPartnerInfo: () => (0, endpunkte_js_1.getPartnerInfo)(rufen),
@@ -43,6 +40,7 @@ function createPartnerApi(optionen) {
         listCustomerCashregisters: (id) => (0, endpunkte_js_1.listCustomerCashregisters)(rufen, id),
         getCustomerCredentials: (id) => (0, endpunkte_js_1.getCustomerCredentials)(rufen, id),
         checkPartnerCustomerEmail: (email) => (0, endpunkte_js_1.checkPartnerCustomerEmail)(rufen, email),
+        reportCustomerContract: (o) => (0, endpunkte_js_1.reportCustomerContract)(rufen, o),
         createPartnerWebhook: (o) => (0, webhooks_js_1.createPartnerWebhook)(rufen, o),
         listPartnerWebhooks: () => (0, webhooks_js_1.listPartnerWebhooks)(rufen),
         updatePartnerWebhook: (id, patch) => (0, webhooks_js_1.updatePartnerWebhook)(rufen, id, patch),
@@ -50,6 +48,6 @@ function createPartnerApi(optionen) {
         rotatePartnerWebhookSecret: (id) => (0, webhooks_js_1.rotatePartnerWebhookSecret)(rufen, id),
         sendPartnerWebhookTest: (id, event) => (0, webhooks_js_1.sendPartnerWebhookTest)(rufen, id, event),
         listPartnerWebhookDeliveries: (o) => (0, webhooks_js_1.listPartnerWebhookDeliveries)(rufen, o),
-        fehlerRat: (code) => (0, fehler_js_1.partnerFehlerRat)(code),
+        errorAdvice: (code) => (0, fehler_js_1.partnerErrorAdvice)(code),
     };
 }

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

@@ -17,7 +17,7 @@ import type { PartnerEnv } from './typen.js';
  * keiner ist. Nuetzlich fuer die Zusicherung „auf diesem Server laeuft nur
  * `pk_live_`" beim Hochfahren.
  */
-export declare function partnerKeyEnv(schluessel: string): PartnerEnv | null;
+export declare function partnerKeyEnv(key: string): PartnerEnv | null;
 export interface PartnerKeyAuthOptions {
     /** Partner-Schluessel `pk_test_…` / `pk_live_…`. */
     partnerKey: string;

package/dist/cjs/partner/auth.js

@@ -26,8 +26,8 @@ const SCHLUESSEL_FORM = /^pk_(test|live)_[A-Za-z0-9_-]{16,}$/;
  * keiner ist. Nuetzlich fuer die Zusicherung „auf diesem Server laeuft nur
  * `pk_live_`" beim Hochfahren.
  */
-function partnerKeyEnv(schluessel) {
-    const treffer = SCHLUESSEL_FORM.exec(typeof schluessel === 'string' ? schluessel.trim() : '');
+function partnerKeyEnv(key) {
+    const treffer = SCHLUESSEL_FORM.exec(typeof key === 'string' ? key.trim() : '');
     return treffer ? treffer[1] : null;
 }
 /**

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

@@ -13,15 +13,15 @@
  *
  * Zwei Dinge halten diese Seite dagegen:
  *
- * - der Typ [Betrieb] (typen.ts) hat genau diese Felder, und TypeScript meldet
+ * - der Typ [Business] (typen.ts) hat genau diese Felder, und TypeScript meldet
  *   ein ueberzaehliges schon beim Tippen;
- * - [unbekannteBetriebsfelder] beantwortet dieselbe Frage zur Laufzeit — fuer
+ * - [unknownBusinessFields] beantwortet dieselbe Frage zur Laufzeit, fuer
  *   Daten, die aus einer Datenbank oder einem Formular kommen und deshalb nie
  *   durch die Typpruefung gelaufen sind.
  *
  * **Die Wahrheit bleibt der Server.** Dieser Client weist nichts von sich aus
  * ab: eine spaetere Backend-Fassung darf ein Feld ergaenzen, ohne dass ein
- * aelterer Client es blockiert. [unbekannteBetriebsfelder] ist die Vorschau,
+ * aelterer Client es blockiert. [unknownBusinessFields] ist die Vorschau,
  * nicht das Tor.
  *
  * Quelle der Liste: `partner-core.BETRIEB_FELDER` im Backend.
@@ -34,10 +34,10 @@
  * Zwilling Zeile fuer Zeile nachhalten kann. Das Schema fuer die Pruefung
  * entsteht daraus (siehe unten) und nicht daneben.
  */
-export declare const BETRIEB_FELDER: readonly ["companyName", "legalForm", "state", "industry", "companyRegister", "court", "web", "phone", "email", "billingEmail", "address.street", "address.number", "address.zip", "address.city", "taxDetails.taxNumber", "taxDetails.vatId", "taxDetails.gln", "taxDetails.smallBusiness", "contacts[].name", "contacts[].email", "contacts[].phone", "contacts[].roles", "taxAdvisor.name", "taxAdvisor.email", "taxAdvisor.phone", "taxAdvisor.mayContact"];
-export type BetriebFeld = typeof BETRIEB_FELDER[number];
+export declare const BUSINESS_FIELDS: readonly ["companyName", "legalForm", "state", "industry", "companyRegister", "court", "web", "phone", "email", "billingEmail", "address.street", "address.number", "address.zip", "address.city", "taxDetails.taxNumber", "taxDetails.vatId", "taxDetails.gln", "taxDetails.smallBusiness", "contacts[].name", "contacts[].email", "contacts[].phone", "contacts[].roles", "taxAdvisor.name", "taxAdvisor.email", "taxAdvisor.phone", "taxAdvisor.mayContact"];
+export type BusinessField = typeof BUSINESS_FIELDS[number];
 /**
- * Die Feldpfade eines Betriebs, die [BETRIEB_FELDER] nicht kennt — dieselbe
+ * Die Feldpfade eines Betriebs, die [BUSINESS_FIELDS] nicht kennt, dieselbe
  * Ableitung wie im Backend, also dieselben Pfade wie in `data.errors[].field`.
  * Leer heisst: aus dieser Sicht ist nichts ueberzaehlig.
  *
@@ -45,4 +45,4 @@ export type BetriebFeld = typeof BETRIEB_FELDER[number];
  * das Backend mit `@kreiseck/validator`. Diese Funktion beantwortet nur die
  * Frage „schicke ich etwas, das dort niemand erwartet?".
  */
-export declare function unbekannteBetriebsfelder(business: unknown): string[];
+export declare function unknownBusinessFields(business: unknown): string[];

package/dist/cjs/partner/betrieb.js

@@ -14,22 +14,22 @@
  *
  * Zwei Dinge halten diese Seite dagegen:
  *
- * - der Typ [Betrieb] (typen.ts) hat genau diese Felder, und TypeScript meldet
+ * - der Typ [Business] (typen.ts) hat genau diese Felder, und TypeScript meldet
  *   ein ueberzaehliges schon beim Tippen;
- * - [unbekannteBetriebsfelder] beantwortet dieselbe Frage zur Laufzeit — fuer
+ * - [unknownBusinessFields] beantwortet dieselbe Frage zur Laufzeit, fuer
  *   Daten, die aus einer Datenbank oder einem Formular kommen und deshalb nie
  *   durch die Typpruefung gelaufen sind.
  *
  * **Die Wahrheit bleibt der Server.** Dieser Client weist nichts von sich aus
  * ab: eine spaetere Backend-Fassung darf ein Feld ergaenzen, ohne dass ein
- * aelterer Client es blockiert. [unbekannteBetriebsfelder] ist die Vorschau,
+ * aelterer Client es blockiert. [unknownBusinessFields] ist die Vorschau,
  * nicht das Tor.
  *
  * Quelle der Liste: `partner-core.BETRIEB_FELDER` im Backend.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BETRIEB_FELDER = void 0;
-exports.unbekannteBetriebsfelder = unbekannteBetriebsfelder;
+exports.BUSINESS_FIELDS = void 0;
+exports.unknownBusinessFields = unknownBusinessFields;
 /**
  * Jedes erlaubte Feld als Pfad. `[]` markiert eine Liste — im Fehlerpfad des
  * Servers steht dort der Index (`contacts.0.name`).
@@ -38,7 +38,7 @@ exports.unbekannteBetriebsfelder = unbekannteBetriebsfelder;
  * Zwilling Zeile fuer Zeile nachhalten kann. Das Schema fuer die Pruefung
  * entsteht daraus (siehe unten) und nicht daneben.
  */
-exports.BETRIEB_FELDER = [
+exports.BUSINESS_FIELDS = [
     'companyName',
     'legalForm',
     'state',
@@ -66,10 +66,10 @@ exports.BETRIEB_FELDER = [
     'taxAdvisor.phone',
     'taxAdvisor.mayContact',
 ];
-/** Das Schema entsteht aus [BETRIEB_FELDER] — eine Quelle, keine zweite Liste. */
+/** Das Schema entsteht aus [BUSINESS_FIELDS]: eine Quelle, keine zweite Liste. */
 const SCHEMA = (() => {
     const wurzel = {};
-    for (const pfad of exports.BETRIEB_FELDER) {
+    for (const pfad of exports.BUSINESS_FIELDS) {
         const teile = pfad.split('.');
         let stand = wurzel;
         teile.forEach((rohes, i) => {
@@ -123,7 +123,7 @@ function sammle(eingabe, schema, pfad) {
     return raus;
 }
 /**
- * Die Feldpfade eines Betriebs, die [BETRIEB_FELDER] nicht kennt — dieselbe
+ * Die Feldpfade eines Betriebs, die [BUSINESS_FIELDS] nicht kennt, dieselbe
  * Ableitung wie im Backend, also dieselben Pfade wie in `data.errors[].field`.
  * Leer heisst: aus dieser Sicht ist nichts ueberzaehlig.
  *
@@ -131,6 +131,6 @@ function sammle(eingabe, schema, pfad) {
  * das Backend mit `@kreiseck/validator`. Diese Funktion beantwortet nur die
  * Frage „schicke ich etwas, das dort niemand erwartet?".
  */
-function unbekannteBetriebsfelder(business) {
+function unknownBusinessFields(business) {
     return sammle(business, SCHEMA, '');
 }

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

@@ -11,7 +11,7 @@
  * PLZ, Gericht) macht das Backend mit `@kreiseck/validator` — sie hier zu
  * wiederholen hiesse, zwei Wahrheiten zu haben, von denen eine veraltet.
  * Ein Formfehler kommt als `KasseneckApiError` mit `code:"validation"` zurueck;
- * `partnerFeldFehler(fehler)` macht `data.errors[]` daraus. **Es entsteht dabei
+ * `partnerFieldErrors(fehler)` macht `data.errors[]` daraus. **Es entsteht dabei
  * nichts** — der Aufruf ist folgenlos wiederholbar.
  *
  * Nach dem Senden wird nichts hart gecastet: fehlt ein zugesagtes Feld, wirft
@@ -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, RequestSignatureOptions, RequestSignatureResult, SignaturStand } from './typen.js';
+import type { ActivateCashregisterResult, CreateCashregisterOptions, CreateCashregisterResult, CreateCustomerOptions, CreateCustomerResult, CustomerCredentials, FonLinkResult, CustomerCashregisterList, PartnerCustomer, PartnerCustomerList, ListCustomersOptions, PartnerInfo, ReportCustomerContractOptions, ReportCustomerContractResult, RequestSignatureOptions, RequestSignatureResult, CustomerSignatureStatus } from './typen.js';
 /**
  * Wer bin ich, in welcher Umgebung, mit welchen Rechten — und welche Apps
  * gehoeren mir. `apps[].id` ist die `appId` fuer [createPartnerCustomer].
@@ -27,7 +27,7 @@ import type { ActivateCashregisterResult, CreateCashregisterOptions, CreateCashr
  * Der guenstigste Selbsttest beim Hochfahren: er beweist Schluessel, Umgebung
  * und Rechte in einem Aufruf.
  */
-export declare function getPartnerInfo(rufen: InternerTransport): Promise<PartnerInfo>;
+export declare function getPartnerInfo(transport: InternerTransport): Promise<PartnerInfo>;
 /**
  * Legt einen Betrieb an.
  *
@@ -46,11 +46,11 @@ export declare function getPartnerInfo(rufen: InternerTransport): Promise<Partne
  * — auch dann, wenn der Rumpf inzwischen abweicht. Die eigene Kundennummer ist
  * der natuerliche Wert dafuer.
  */
-export declare function createPartnerCustomer(rufen: InternerTransport, optionen: CreateCustomerOptions): Promise<CreateCustomerResult>;
+export declare function createPartnerCustomer(transport: InternerTransport, options: CreateCustomerOptions): Promise<CreateCustomerResult>;
 /** Betriebe dieses Partners, seitenweise. `cursor` aus der Antwort setzt fort. */
-export declare function listPartnerCustomers(rufen: InternerTransport, optionen?: ListCustomersOptions): Promise<KundenListe>;
+export declare function listPartnerCustomers(transport: InternerTransport, options?: ListCustomersOptions): Promise<PartnerCustomerList>;
 /** Ein Betrieb mit allem, was der Partner ueber ihn sehen darf — nie Geheimnisse. */
-export declare function getPartnerCustomer(rufen: InternerTransport, customerId: string): Promise<Kunde>;
+export declare function getPartnerCustomer(transport: InternerTransport, customerId: string): Promise<PartnerCustomer>;
 /**
  * Schickt dem Betrieb den Einrichtungs-Link fuer seinen FinanzOnline-Zugang.
  * Ohne diesen Zugang gibt es live keine Signatureinheit (`fon_missing`).
@@ -69,8 +69,8 @@ export declare function getPartnerCustomer(rufen: InternerTransport, customerId:
  * einem ganzen ausgefuellten Formular auf. Die Antwort sagt NUR ja oder nein —
  * nie, wem die Adresse gehoert.
  */
-export declare function checkPartnerCustomerEmail(rufen: InternerTransport, email: string): Promise<boolean>;
-export declare function sendPartnerCustomerFonLink(rufen: InternerTransport, customerId: string): Promise<FonLinkResult>;
+export declare function checkPartnerCustomerEmail(transport: InternerTransport, email: string): Promise<boolean>;
+export declare function sendPartnerCustomerFonLink(transport: InternerTransport, customerId: string): Promise<FonLinkResult>;
 /**
  * Beantragt die Signatureinheit. Kasseneck laesst die Karte beim
  * Vertrauensdiensteanbieter **auf diesen Betrieb** ausstellen und meldet sie
@@ -87,9 +87,9 @@ 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?: RequestSignatureOptions): Promise<RequestSignatureResult>;
+export declare function requestCustomerSignature(transport: InternerTransport, customerId: string, options?: 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>;
+export declare function getCustomerSignatureStatus(transport: InternerTransport, customerId: string): Promise<CustomerSignatureStatus>;
 /**
  * Legt eine Kasse an.
  *
@@ -105,7 +105,7 @@ export declare function getCustomerSignatureStatus(rufen: InternerTransport, cus
  * Hoechstens 20 Kassen je Betrieb (`cashregister_limit`); ohne gebuchtes Modul
  * `module_inactive`.
  */
-export declare function createCustomerCashregister(rufen: InternerTransport, optionen: CreateCashregisterOptions): Promise<CreateCashregisterResult>;
+export declare function createCustomerCashregister(transport: InternerTransport, options: CreateCashregisterOptions): Promise<CreateCashregisterResult>;
 /**
  * Nimmt eine Kasse in Betrieb — von Hand, wenn `automatic:false` gilt oder
  * ein Lauf abgebrochen ist.
@@ -117,9 +117,9 @@ export declare function createCustomerCashregister(rufen: InternerTransport, opt
  * veraendernde Aufruf dieses Clients, der ohne Idempotenzschluessel gefahrlos
  * wiederholbar ist — weil der Server ihn so gebaut hat.
  */
-export declare function activateCashregister(rufen: InternerTransport, customerId: string, cashregisterId: string): Promise<ActivateCashregisterResult>;
+export declare function activateCashregister(transport: InternerTransport, customerId: string, cashregisterId: string): Promise<ActivateCashregisterResult>;
 /** Die Kassen eines Betriebs samt Stand der Inbetriebnahme — **nie** Token. */
-export declare function listCustomerCashregisters(rufen: InternerTransport, customerId: string): Promise<KassenListe>;
+export declare function listCustomerCashregisters(transport: InternerTransport, customerId: string): Promise<CustomerCashregisterList>;
 /**
  * Holt die **Geheimnisse des Betriebs**: seinen `api_key` und die Token seiner
  * Kassen. Damit signiert eine App in seinem Namen Belege — und ein Beleg ist
@@ -136,4 +136,17 @@ export declare function listCustomerCashregisters(rufen: InternerTransport, cust
  * Zeichenketten-Umwandlung zeigen eine Maske, heraus kommt man nur ueber
  * `.reveal()`.
  */
-export declare function getCustomerCredentials(rufen: InternerTransport, customerId: string): Promise<CustomerCredentials>;
+export declare function getCustomerCredentials(transport: InternerTransport, customerId: string): Promise<CustomerCredentials>;
+/**
+ * Meldet eine Zustimmung des Betriebs, die der Partner **in Vollmacht**
+ * eingeholt hat (Endpunkt `reportCustomerContract`, unter `/v1`
+ * `reportCustomerVertrag`). Braucht die Berechtigung `customers:write`.
+ *
+ * Vor dem Senden prueft dieser Client nur, dass jede Pflichtangabe da ist und
+ * `acceptedAt` eine Zahl ist. Ob die Art erlaubt ist (`kind_not_allowed`), die
+ * Fassung gilt (`unknown_version`, `no_version`) und der Text derselbe ist
+ * (`text_changed`), entscheidet der Server. Eine schon bestaetigte Fassung
+ * kommt als `already_accepted` mit `data.contractId`; das ist kein Schaden,
+ * sondern die Bestaetigung, dass es sie gibt.
+ */
+export declare function reportCustomerContract(transport: InternerTransport, options: ReportCustomerContractOptions): Promise<ReportCustomerContractResult>;