@kreiseck/kasseneck-api 0.27.2 → 0.28.0

package/CHANGELOG.md

@@ -4,6 +4,83 @@ 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.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
+  unverändert. Grund: seit dem 23.09.2026, 17:05 Uhr stellt der Server jede neue Rechnung über den
+  exakten Kern (`rechnungRechnen`) aus; `rechnungSummen` rechnet nach Weg 2 und liegt an
+  Halbcent-Grenzen einen Cent je Satz daneben (21,35 € netto zu 10 %: 23,48 € statt 23,49 €). Auf
+  den Kern umgestellt wird bewusst nicht: der Server schaltet ihn je Konto über `ganzzahlPflicht`,
+  Entwürfe außerhalb des Ausstellens rechnet er teils weiter nach Weg 2, und
+  `fixtures/rechnung-summen.json` prüfen Backend und Dart-Zwilling. Der Kopfkommentar behauptete
+  noch, die Funktion rechne „genau so wie der Server“; das ist berichtigt, README ebenso.
+- **`HpsRefundOptions`, `HpsCancelOptions`, `HpsConnectRefundOptions` und
+  `HpsConnectCancelOptions` werden unter `…/payments` exportiert** (nur hinzugefügt). Die Aufrufe
+  `refund`/`cancel` gab es dort schon, ihre Optionstypen nicht. Der Kopfkommentar von
+  `src/payments/index.ts` sagte noch, Gutschrift und Storno gingen nur über die Flutter-App; das
+  gilt seit Connect `/v1/terminal/refund` bzw. `/cancel` nicht mehr.
+- § 131b Abs. 1 Z 3 steht in der **BAO**, nicht im UStG: an `INVOICE_PAYMENT_METHODS` und
+  `PaymentInput.onSite` berichtigt (Wortlaut gegen das RIS geprüft). Ein Test hält künftig jede
+  Zuordnung von § 131 ff. zum UStG in `src/` fest.
+
 ## 0.27.2
 
 - **README auf Englisch** und jede Angabe gegen den Code geprüft. Anfragen kommen inzwischen auch

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. Texts for humans (`message`,
+`note`, `statusText`, `nextSteps`) stay German, and so do the error codes for
+now. 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,47 @@ 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.
+
 ### A test event is not a cash register
 
 `sendPartnerWebhookTest(webhookId, 'cashregister.live')` fires exactly the
@@ -839,13 +888,14 @@ positive for credit notes too; the sign is in the document type
 (`docType: 'GU'`). Test cases: `fixtures/rechnung-rechnen.json`,
 `fixtures/rechnung-rechnen-zufall.json`, `fixtures/position-aus-euro.json`.
 
-**`rechnungSummen` still uses the previous formula.** The older helper in
-`…/rechnung` works on `unitPriceCents` lines and does not yet run through the
-core. At half-cent boundaries it can differ from an invoice issued today by
-one cent per VAT rate, and by a few cents across several rates. Example:
-€ 21.35 net at 10 % gives € 23.48 gross with `rechnungSummen`, but € 23.49
-with the core and on the invoice. Use `rechnungRechnen` or `previewInvoice` in
-new code. Test cases for the old formula: `fixtures/rechnung-summen.json`.
+**`rechnungSummen` is deprecated.** The older helper in `…/rechnung` works on
+`unitPriceCents` lines with the previous floating-point formula and does not
+run through the core. At half-cent boundaries it can differ from an invoice
+issued today by one cent per VAT rate, and by a few cents across several
+rates. Example: € 21.35 net at 10 % gives € 23.48 gross with `rechnungSummen`,
+but € 23.49 with the core and on the invoice. It stays unchanged for existing
+callers; use `rechnungRechnen` or `previewInvoice` in new code. Test cases for
+the old formula: `fixtures/rechnung-summen.json`.
 
 ## Development
 

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

@@ -27,7 +27,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", "kein_partnerbetrieb", "live_not_allowed", "customer_exists", "customer_conflict", "customer_limit", "zugang_nicht_erlaubt", "email_taken", "no_email", "kennung_fehlt", "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", "vertrag_offen", "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.

package/dist/cjs/partner/fehler.js

@@ -53,6 +53,8 @@ exports.PARTNER_FEHLER_CODES = [
     'zugang_nicht_erlaubt',
     'email_taken',
     'no_email',
+    // FinanzOnline-Link
+    'kennung_fehlt',
     // Signatur
     'fon_missing',
     'signature_pending',
@@ -67,6 +69,7 @@ exports.PARTNER_FEHLER_CODES = [
     'module_inactive',
     'cashregister_limit',
     'cashregister_not_found',
+    'vertrag_offen',
     'activation_failed',
     // Webhooks
     'webhook_limit',
@@ -121,21 +124,23 @@ const RAT = {
     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).',
+    zugang_nicht_erlaubt: '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.',
+    kennung_fehlt: '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.',
     cashregister_limit: 'Hoechstens 20 Registrierkassen je Betrieb. Eine bestehende nutzen.',
     cashregister_not_found: 'Diese cashregisterId gibt es bei diesem Betrieb nicht.',
+    vertrag_offen: '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.',
     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.',