@kreiseck/kasseneck-api 0.27.3 → 0.29.0

package/CHANGELOG.md

@@ -4,6 +4,100 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.29.0
+
+- **Bricht `./partner` (und nur das): `PARTNER_FEHLER_CODES` ist jetzt durchgehend englisch,
+  wie der Rest von `/v3`.** `zugang_nicht_erlaubt` → `access_not_allowed`, `kennung_fehlt` →
+  `tax_number_missing`, `vertrag_offen` → `contracts_pending` (Sätze unverändert, nur der
+  Schlüssel neu); die `RAT`-Tabelle und `partnerFehlerRat` folgen. Grund: 0.28.0 stellte den
+  Partner-Teil auf `/v3` um, liess aber ein paar Codes, die der Server bis dahin noch roh
+  durchreichte, unuebersetzt in ihrer `/v1`-Schreibweise stehen (siehe dessen Eintrag "Die
+  Fehlercodes bleiben in dieser Stufe wie in `/v1`"): der Server schickt seit dieser Version
+  wirklich nur noch englische Codes, und dieses Paket folgt.
+- **`PARTNER_FEHLER_CODES` um neun Codes von `reportCustomerContract` ergänzt**: `kind_not_allowed`,
+  `mode_not_allowed`, `power_of_attorney_missing`, `not_found`, `no_version`, `not_required`,
+  `unknown_version`, `text_changed`, `already_accepted`, mit Handlungssatz. Der Katalog des
+  Backends (`partner-core.FEHLER_KATALOG`, Fläche `api`/`beide`) führt sie für die Schnittstelle,
+  obwohl dieses Paket `reportCustomerContract` selbst nicht anbietet: derselbe Grund wie bei den
+  Portal-Codes: eine halbe Liste ist schlimmer als keine, und ein Code, den nur eine Seite kennt,
+  ist für einen Aufrufer nicht von "gibt es nicht" zu unterscheiden.
+- **`kein_partnerbetrieb` und `request_not_found` aus `PARTNER_FEHLER_CODES` entfernt.** Beide sind
+  admin-only (`partner-endpoints.js`) und stehen gar nicht in `partner-core.FEHLER_KATALOG`; ein
+  Partner-Aufruf konnte sie unter keinem Pfad je bekommen. Sie standen seit jeher versehentlich in
+  der Liste; ein Aufrufer, der auf sie prüfte, prüfte auf einen Fall, der nie eintritt.
+- `module_inactive`s Handlungssatz nennt jetzt `data.module`/`data.detail` statt `data.modul` (die
+  Werte selbst, z. B. `cash_register`, waren mit 0.28.0 schon englisch, nur der Text hier hinkte
+  nach).
+- Neuer Typ `SignatureErrorCode` (`customer_not_found` | `incomplete` | `finanzonline_error`) für
+  `SignaturAntrag.error.code` und `CustomerSignature.error.code` (bisher `string | null` ohne
+  jeden Hinweis auf die möglichen Werte), nach demselben Muster wie `SignatureHistoryReason`.
+- `PartnerFeldFehler.field`s Beispiele sind nicht mehr `address.land`/`tax_details.ustid` (Namen,
+  die `/v3` als unbekanntes Feld abweist), sondern echte `/v3`-Pfade: `address.zip`,
+  `taxDetails.taxNumber`, `contacts.0.email`.
+- Die Tests lesen wieder echte `/v3`-Fehlerantworten: `scripts/partner-v3-antworten.cjs` schickt
+  jeden Code aus `fehlerKatalogFuer('api')` jetzt durch denselben Fehlerzweig wie eine echte
+  Antwort (`antwortNachAussen` statt der rohen Katalogwerte), und `getCustomerSignatureStatus`
+  trägt in der Fixture einen zweiten, fehlgeschlagenen Antrag (`fon_fehler` → `finanzonline_error`)
+  als Beleg dafür, dass `request.error.code` denselben Rand durchläuft wie jede Fehlerhülle.
+
+## 0.28.0
+
+- **Bricht `./partner` (und nur das): der Partner-Teil spricht jetzt die englische Partner-API
+  `/v3`.** Vorgabe-Adresse ist `PARTNER_BASE_URL` (`https://api.kasseneck.at/v3`), `baseUrl` bleibt
+  einstellbar. Grund: das Backend führt die Partner-API ab `/v3` durchgehend englisch (Feldnamen
+  und jeder Wert, auf den ein Programm verzweigt), `/v1` ist abgekündigt (Kopfzeilen `Deprecation`
+  und `Sunset`). `/v3` weist die deutschen Werte der `/v1` mit `validation` ab statt sie still zu
+  übersetzen; ein Client, der weiter `einzel` oder `wien` schickt, bekäme nur noch Fehler.
+  Minor-Sprung, weil 0.x: wer `./partner` benutzt, muss umstellen, alles andere nicht.
+- Umbenannte Werte (alt → neu): `legalForm` `einzel`/`verein`/`sonstige` →
+  `sole_proprietor`/`association`/`other`; `state` `burgenland` … `wien` → `AT-1` … `AT-9`;
+  Kontaktrollen `geschaeftsfuehrung`/`buchhaltung`/`technik`/`kasse` →
+  `management`/`accounting`/`technical`/`pos`; `avv.mode` `direkt`/`vollmacht`/`unterauftrag` →
+  `direct`/`power_of_attorney`/`subprocessor`; Entgelt `entgelt {cents, rhythmus, test}` →
+  `fee {cents, interval, test}` mit `monthly`/`yearly`/`once` (neu gelesen an
+  `createPartnerCustomer` und `requestCustomerSignature`); Historiengründe
+  `karte_eingetragen`/`fon` → `card_entered`/`finanzonline`; Zustellstatus
+  `zugestellt`/`offen`/`fehlgeschlagen`/`verworfen` → `delivered`/`pending`/`failed`/`dropped`;
+  `deletePartnerWebhook` liefert `{ webhookId, deleted }` statt nur der Kennung; Ereignisse
+  `customer.terms_accepted`/`customer.avv_accepted` mit `kind` `terms`/`avv` und den englischen
+  Quellen (`setup_link`, `process_link`, `partner_power_of_attorney`, `admin_paper`,
+  `paper_upload`), beschrieben durch den neuen Typ `ContractAcceptedEventData`.
+- Neue englische Typen `LegalForm`, `AustrianState`, `ContactRole`, `AvvMode`, `FeeInterval`,
+  `PartnerFee`, `SignatureHistoryReason`, `WebhookApiVersion`, `WebhookDeliveryStatus`;
+  `Rechtsform`, `Bundesland` und `KontaktRolle` bleiben als veraltete Aliase.
+- **Webhooks tragen `apiVersion`** (`v1` oder `v3`; fehlt es, ist es ein Bestands-Webhook und damit
+  `v1`). Die Sprache der Nutzlast folgt dem Webhook, nicht dem Pfad: ein unter `/v1` angelegter
+  schickt weiter deutsch, bis er mit `updatePartnerWebhook(id, { apiVersion: 'v3' })` umgestellt
+  wird; zurück gibt es nicht. `lastDelivery` ist jetzt das Objekt `{ at, status, statusCode }`,
+  das der Server schon immer schickte (der Typ sagte `number`).
+- Dabei berichtigt, was schon unter `/v1` englisch war und hier noch deutsch gelesen wurde (und
+  darum leer blieb): `getCustomerSignatureStatus` liest `signature` statt `signatur` und neu
+  `signatures[]` und `customerId`; ein Antrag trägt `kind` statt `art`, die Historie `from`/`to`
+  statt `von`/`nach`; `requestCustomerSignature` sendet `kind` statt `art`;
+  `sendPartnerWebhookTest` liest `event` statt `ereignis`; Zustellungen tragen
+  `lastAttemptAt`/`nextAttemptAt`; `BetriebSteuer.uid` heißt `vatId` (ein `uid` wies der Server
+  als unbekanntes Feld ab); Kassenschritt `signature` statt `signatur`, Kassenstatus
+  `in_progress` statt `laeuft`.
+- **`PARTNER_FEHLER_CODES` um `kennung_fehlt` und `vertrag_offen` ergänzt**, beide mit
+  Handlungssatz. Grund: der Katalog des Backends (`partner-core.FEHLER_KATALOG`, Fläche `beide`)
+  führt sie für die Schnittstelle; `kennung_fehlt` kommt aus `sendPartnerCustomerFonLink`,
+  `vertrag_offen` live aus `activateCashregister`. Ein Code, den das Paket nicht kennt, sah für
+  einen Aufrufer aus wie „gibt es nicht“.
+- **Liste und Einzelsicht eines Betriebs führen `fon`, `avv` und `terms`** in der Form, die der
+  Server schickt (`VertragStand`, `KundenFonStand`; die Einzelsicht zusätzlich `verifiedAt` und
+  `linkSentTo`). Fehlen sie in der Antwort, bleibt es bei `null`. Der Kommentar an `AvvStand`
+  behauptete, Verträge wirkten im Partner-Weg nicht mehr; tatsächlich geht live ohne AVV und
+  Nutzungsvertrag keine Kasse live (`vertrag_offen`). Berichtigt, ebenso in `ablauf.ts`.
+- `check:erreichbar` prüft die Partner-Aufrufe unter `/v3` (abgelesen aus der Partner-Fassade des
+  Baus), alles andere weiter unter `/v1`. Ein `not_found` aus JSON gilt nicht mehr als erreichbar:
+  unter `/v3` antwortet der Rand auf einen nicht gerouteten Namen selbst mit JSON.
+- **Unverändert:** Belege, Rechnungen, Kasse, Druck, Zahlungen und React sprechen weiter `/v1`
+  (`DEFAULT_BASE_URL`), bis es dort eine `/v3` gibt. Die Fehlercodes bleiben in dieser Stufe wie
+  in `/v1`, ebenso die Prüfung der Webhook-Signatur. `reportCustomerVertrag` (unter `/v3`
+  `reportCustomerContract`) führt dieses Paket nicht und bekommt es auch jetzt nicht.
+- Die Tests lesen echte `/v3`-Antworten: `test/fixtures/partner-v3-antworten.json` entsteht aus
+  den Sichten des Backends, durch dessen `/v3`-Rand gereicht (`scripts/partner-v3-antworten.cjs`).
+
 ## 0.27.3
 
 - **`rechnungSummen` ist als veraltet markiert** (`@deprecated`), das Rechenergebnis bleibt

package/README.md

@@ -167,7 +167,7 @@ adapter:
 | `…/payments` | Stripe payment links, Hobex cloud (both HTTP endpoints of the backend), and Hobex **HPS** via **Kasseneck Connect** (local device agent that talks to the terminal). |
 | `…/register` | Sign-in for the browser register: pair and unpair a device, list its users and sessions, sign in by PIN, renew and end the session. |
 | `…/kasse` | Tile register: register settings (business-wide and per device), article groups and articles for tiles, discount distribution per VAT rate, scopes of register permissions, network printers and print jobs, tip recipients, the register's message catalogue. |
-| `…/partner` | Partner API: create businesses, FinanzOnline link, signature, cash registers, credentials, webhooks with signature verification. **Belongs on a server.** |
+| `…/partner` | Partner API (`/v3`, English): create businesses, FinanzOnline link, signature, cash registers, credentials, webhooks with signature verification. **Belongs on a server.** |
 | `…/rechnung` | Invoice API: create and search customers, issue finalised invoices, credit notes and cancellation, PDF and e-invoice XML, the contract as data. **Belongs on a server.** |
 | `…/rechnung/rechnen` | Pure calculation core for invoice totals (integers, no transport, no dependency beyond types). Safe to run in the browser. |
 | `…/react` | Thin React adapter that renders a receipt layout or a receipt sheet. Needs React. |
@@ -537,6 +537,14 @@ receipts on their behalf.
 The partner key (`pk_live_…`) belongs on a **server**. It can create
 businesses and, with the extra scope `credentials:read`, fetch their secrets.
 
+This subpath talks to the English Partner API **`/v3`**
+(`PARTNER_BASE_URL`, `https://api.kasseneck.at/v3`): every field name and
+every value your code branches on is English, including every error code
+(`PARTNER_FEHLER_CODES`). Texts for humans (`message`, `note`, `statusText`,
+`nextSteps`) stay German. Everything else in this package (receipts,
+invoices, the register, printing, payments) still uses `/v1`
+(`DEFAULT_BASE_URL`) until those endpoints have a `/v3` of their own.
+
 ```ts
 import { createPartnerApi, istPartnerFehler } from '@kreiseck/kasseneck-api/partner';
 
@@ -545,7 +553,7 @@ const partner = createPartnerApi({ partnerKey: process.env.KASSENECK_PARTNER_KEY
 const { customerId } = await partner.createPartnerCustomer({
   appId: 'app_…',
   idempotencyKey: customerNumber, // your own number; protects against duplicates
-  business,                       // master data (type Betrieb): name, legal form, address, tax details, contacts
+  business,                       // master data (type Betrieb): legalForm 'sole_proprietor', state 'AT-5', …
   // env: 'test' is allowed even with a LIVE key: that is how you rehearse the
   // whole chain without a second key. Never the other way round.
 });
@@ -572,6 +580,83 @@ try {
 }
 ```
 
+### Migrating from 0.27.x
+
+0.28.0 is a breaking change for `./partner` only. The client now calls `/v3`
+instead of `/v1`, and `/v3` rejects the German values of `/v1` with
+`validation` instead of translating them. Stored data that goes into
+`createPartnerCustomer` must use the new values:
+
+| Where | 0.27.x (`/v1`) | 0.28.0 (`/v3`) |
+|---|---|---|
+| `business.legalForm` | `einzel`, `verein`, `sonstige` | `sole_proprietor`, `association`, `other` (`eu`, `og`, `kg`, `gmbh`, `gmbhcokg`, `ag` unchanged) |
+| `business.state` | `burgenland` … `wien` | `AT-1` … `AT-9` (ISO 3166-2) |
+| `business.contacts[].roles` | `geschaeftsfuehrung`, `buchhaltung`, `technik`, `kasse` | `management`, `accounting`, `technical`, `pos` |
+| `business.taxDetails` | `uid` (type only; the server always wanted `vatId`) | `vatId` |
+| `avv.mode` | `direkt`, `vollmacht`, `unterauftrag` | `direct`, `power_of_attorney`, `subprocessor` |
+| fee on `createPartnerCustomer` / `requestCustomerSignature` | not read (`entgelt {cents, rhythmus, test}`) | `fee {cents, interval, test}`, `interval`: `monthly`, `yearly`, `once` |
+| signature `history[].reason` | `karte_eingetragen`, `fon` | `card_entered`, `finanzonline` |
+| delivery `status`, `lastDelivery.status` | `zugestellt`, `offen`, `fehlgeschlagen`, `verworfen` | `delivered`, `pending`, `failed`, `dropped` |
+| `deletePartnerWebhook` | returned the `webhookId` | returns `{ webhookId, deleted }` |
+| event `customer.terms_accepted` | `kind: 'nutzung'` | `kind: 'terms'` |
+| event `source` | `einrichten`, `prozess`, `partner_vollmacht`, `admin_papier`, `papier_upload` | `setup_link`, `process_link`, `partner_power_of_attorney`, `admin_paper`, `paper_upload` |
+
+Field names in this client that were German are English now as well:
+`SignaturStand.signatur` is `signature` (plus `signatures[]`), a request's
+`art` is `kind`, history `von`/`nach` are `from`/`to`,
+`WebhookTestResult.ereignis` is `event`, a delivery's
+`letzterVersuchAt`/`naechsterVersuchAt` are `lastAttemptAt`/`nextAttemptAt`,
+and `requestCustomerSignature(id, { kind })` replaces `{ art }`. A webhook
+now shows `apiVersion` and `lastDelivery { at, status, statusCode }`. The
+types `Rechtsform`, `Bundesland` and `KontaktRolle` remain as deprecated
+aliases of `LegalForm`, `AustrianState` and `ContactRole`.
+
+**Webhook payloads have a language of their own.** A webhook created through
+`/v1` keeps sending German payloads (`apiVersion: 'v1'`), whatever path you
+call. Switch it once, there is no way back:
+
+```ts
+await partner.updatePartnerWebhook(webhookId, { apiVersion: 'v3' });
+```
+
+Webhook signature verification is unchanged.
+
+### Migrating from 0.28.x
+
+0.29.0 is a breaking change for `./partner` only, and only for
+`PARTNER_FEHLER_CODES`: three codes that the server still sent in their
+German `/v1` spelling under 0.28.0 now come through English, matching every
+other value on `/v3`.
+
+| 0.28.x | 0.29.0 |
+|---|---|
+| `zugang_nicht_erlaubt` | `access_not_allowed` |
+| `kennung_fehlt` | `tax_number_missing` |
+| `vertrag_offen` | `contracts_pending` |
+
+`partnerFehlerRat()` and `istPartnerFehler()` follow: look up the new,
+English key. A build that still checks the old German string will no longer
+match, silently, so this is worth a search across your codebase.
+
+Two codes that never reached this package's own error handling
+(`kein_partnerbetrieb`, `request_not_found`, both admin-only and outside the
+backend's public catalog) are gone from `PARTNER_FEHLER_CODES`. If you were
+checking for them, that check was already dead code: the server never sent
+them to a partner call.
+
+`PARTNER_FEHLER_CODES` also gained nine codes for `reportCustomerContract`
+(`kind_not_allowed`, `mode_not_allowed`, `power_of_attorney_missing`,
+`not_found`, `no_version`, `not_required`, `unknown_version`, `text_changed`,
+`already_accepted`), each with a `partnerFehlerRat()` sentence. This package
+still does not expose that endpoint; the codes are here for completeness (a
+catalog page, or code that reads the raw error yourself), not because a call
+of this client can produce them.
+
+The signature error type `SignaturAntrag.error.code` /
+`CustomerSignature.error.code` is now `SignatureErrorCode`
+(`customer_not_found` | `incomplete` | `finanzonline_error` | any other
+string), a documented union instead of a bare `string | null`.
+
 ### A test event is not a cash register
 
 `sendPartnerWebhookTest(webhookId, 'cashregister.live')` fires exactly the

package/dist/cjs/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/cjs/partner/ablauf.js

@@ -11,9 +11,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/cjs/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/cjs/partner/api.js

@@ -6,16 +6,27 @@
  * Funktionen und bleiben einzeln importierbar.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PARTNER_BASE_URL = void 0;
 exports.createPartnerApi = createPartnerApi;
 const transport_js_1 = require("../client/transport.js");
 const auth_js_1 = require("./auth.js");
 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.
+ */
+exports.PARTNER_BASE_URL = 'https://api.kasseneck.at/v3';
 function createPartnerApi(optionen) {
     const rufen = (0, transport_js_1.createTransport)({
         auth: (0, auth_js_1.partnerKeyAuth)({ partnerKey: optionen.partnerKey }),
-        baseUrl: optionen.baseUrl,
+        baseUrl: optionen.baseUrl ?? exports.PARTNER_BASE_URL,
         timeoutMs: optionen.timeoutMs,
         fetch: optionen.fetch,
     });

package/dist/cjs/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/cjs/partner/endpunkte.js

@@ -59,6 +59,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
@@ -172,6 +185,7 @@ 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']),
     };
 }
@@ -200,26 +214,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. */
 async function getPartnerCustomer(rufen, customerId) {
     const id = pflicht(customerId, 'getPartnerCustomer', 'customerId');
@@ -234,7 +260,13 @@ 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
             : {
@@ -288,7 +320,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'
@@ -304,8 +336,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']),
             };
@@ -317,8 +349,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
@@ -332,27 +364,54 @@ 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. */
 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']) },
     };
@@ -392,12 +451,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/cjs/partner/fehler.d.ts

@@ -19,6 +19,32 @@
  * unterscheiden. Deshalb stehen hier BEIDE Flaechen: die der Schnittstelle
  * ([PARTNER_FEHLER_CODES]) und die des Partner-Portals
  * ([PARTNER_PORTAL_FEHLER_CODES]).
+ *
+ * **Seit 0.29.0 englisch, wie der Rest von `/v3`.** Dieser Client spricht seit
+ * 0.28.0 ausschliesslich `/v3` (`PARTNER_BASE_URL`): die paar deutschen Codes,
+ * die der Server bis dahin noch roh durchreichte, kommen jetzt genauso englisch
+ * an wie alle anderen. [PARTNER_FEHLER_CODES] fuehrt deshalb ausnahmslos die
+ * `/v3`-Schreibweise aus `fehlercodes.json`s `v3`-Zuordnung (deutsch -> englisch);
+ * ein Aufrufer bekommt vom Server nie mehr die deutsche Form.
+ *
+ * **`kein_partnerbetrieb` und `request_not_found` fehlen absichtlich.** Beide
+ * sind admin-only (`partner-endpoints.js`, ausserhalb von `FEHLER_KATALOG`) und
+ * erreichen `/v3` nie: ein Partner-Aufruf kann sie unter keinem Pfad bekommen.
+ * Sie standen frueher versehentlich in dieser Liste; `dart-partner.json` (ein
+ * eingefrorener Abzug aus Dart 5.3.0, bevor das korrigiert wurde) fuehrt sie
+ * weiterhin, siehe die Ausnahme in `test/partner-enums.test.ts`.
+ *
+ * **Die Vertrags-Codes (`kind_not_allowed`, `mode_not_allowed`,
+ * `power_of_attorney_missing`, `not_found`, `no_version`,
+ * `unknown_version`, `text_changed`, `already_accepted`) stehen hier, obwohl
+ * dieses Paket `reportCustomerContract` nicht anbietet.** Der Katalog des
+ * Backends fuehrt sie mit `flaeche: 'api'`/`'beide'`, dieselbe Regel wie bei
+ * den Portal-Codes oben: vollstaendig heisst vollstaendig, auch fuer einen
+ * Endpunkt, den (noch) kein Aufruf dieses Clients ausloest. Ein Server-Update,
+ * das den Endpunkt ergaenzt, bräuchte dann keinen zweiten Fehlerkatalog-Umbau.
+ * `not_required` fehlt bewusst: derselbe gemeinsame Server-Zweig wie die
+ * anderen sechs, aber ueber die Partner-API nicht erreichbar (der Server hat
+ * ihn aus `FEHLER_KATALOG` entfernt, siehe `partner-core.js` im Backend).
  */
 /**
  * Alle Codes, die die **Schnittstelle** kennt. Als Liste und nicht nur als
@@ -27,7 +53,7 @@
  *
  * Reihenfolge und Bestand wie im Abzug des Backends.
  */
-export declare const PARTNER_FEHLER_CODES: readonly ["validation", "rate_limited", "app_not_found", "app_not_accepted", "kein_partnerbetrieb", "live_not_allowed", "customer_exists", "customer_conflict", "customer_limit", "zugang_nicht_erlaubt", "email_taken", "no_email", "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;