@kreiseck/kasseneck-api 0.27.2 → 0.28.0

package/dist/cjs/payments/index.js

@@ -23,9 +23,10 @@
  * Terminal spricht. Das ist kein Widerspruch zur Umgebungsgrenze, sondern ein
  * zweiter, seit `hobex-hps.js` genutzter Weg um sie herum.
  *
- * Wer Gutschrift oder Storno am HPS-Terminal braucht, braucht weiterhin die
- * Flutter-App: Connect exponiert dafuer (noch) keinen Endpunkt, siehe
- * `hobex-hps/connect-client.ts`.
+ * Gutschrift und Storno am HPS-Terminal laufen ebenfalls ueber Connect
+ * (`POST /v1/terminal/refund` bzw. `/cancel`): `HpsPayments.refund`/`cancel`
+ * mit `HpsRefundOptions`/`HpsCancelOptions`, darunter
+ * `HpsConnectClient.refund`/`cancel`, siehe `hobex-hps/connect-client.ts`.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** **Keiner** der
  * vier Cloud-Zahlungs-Endpunkte (Stripe, Hobex-Cloud) setzt `allowRegisterUser`;

package/dist/cjs/rechnung/summen.d.ts

@@ -1,7 +1,16 @@
 /**
- * Summen einer Rechnung vorab rechnen — genau so, wie der Server sie beim
- * Ausstellen rechnet. Fuer Shops, die kassieren, bevor die Rechnung entsteht,
- * und denselben Betrag brauchen, den die Rechnung spaeter ausweist.
+ * Summen einer Rechnung vorab rechnen, nach der frueheren Formel (Weg 2,
+ * Gleitkomma). Gedacht fuer Shops, die kassieren, bevor die Rechnung entsteht.
+ *
+ * **Veraltet.** Seit dem 23.09.2026, 17:05 Uhr stellt der Server jede neue
+ * Rechnung ueber den exakten Ganzzahl-Kern aus (`rechnungRechnen` in
+ * `…/rechnung/rechnen`). An Halbcent-Grenzen weicht diese Funktion davon um
+ * einen Cent je Satz ab (21,35 EUR netto zu 10 %: hier 23,48 EUR, auf der
+ * Rechnung 23,49 EUR). Die Formel bleibt trotzdem, wie sie ist: der Server
+ * schaltet den Kern je Konto ueber einen Schalter und rechnet Entwuerfe
+ * ausserhalb des Ausstellens teils weiter nach Weg 2, und Backend und
+ * Dart-Zwilling pruefen gegen `fixtures/rechnung-summen.json`. Neuer Code
+ * nimmt `rechnungRechnen` oder `previewInvoice`.
  *
  * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
  *
@@ -38,5 +47,11 @@ export interface SummenPosition {
  * Server einen steuerfreien Fall ab (etwa eine ig. Lieferung), gehoert dieser
  * Fall hierher — sonst rechnet die Funktion Steuer, die die Rechnung nicht
  * ausweist.
+ *
+ * @deprecated Seit 0.27.3: rechnet nach der frueheren Formel (Weg 2) und kann
+ * an Halbcent-Grenzen um einen Cent je Satz von einer heute ausgestellten
+ * Rechnung abweichen. Stattdessen `rechnungRechnen` aus
+ * `@kreiseck/kasseneck-api/rechnung/rechnen` (Euro-Positionen ueber
+ * `positionAusEuro`) oder `previewInvoice` verwenden.
  */
 export declare function rechnungSummen(items: readonly SummenPosition[], priceMode: PriceMode, taxScheme?: TaxScheme): InvoiceTotals;

package/dist/cjs/rechnung/summen.js

@@ -1,8 +1,17 @@
 "use strict";
 /**
- * Summen einer Rechnung vorab rechnen — genau so, wie der Server sie beim
- * Ausstellen rechnet. Fuer Shops, die kassieren, bevor die Rechnung entsteht,
- * und denselben Betrag brauchen, den die Rechnung spaeter ausweist.
+ * Summen einer Rechnung vorab rechnen, nach der frueheren Formel (Weg 2,
+ * Gleitkomma). Gedacht fuer Shops, die kassieren, bevor die Rechnung entsteht.
+ *
+ * **Veraltet.** Seit dem 23.09.2026, 17:05 Uhr stellt der Server jede neue
+ * Rechnung ueber den exakten Ganzzahl-Kern aus (`rechnungRechnen` in
+ * `…/rechnung/rechnen`). An Halbcent-Grenzen weicht diese Funktion davon um
+ * einen Cent je Satz ab (21,35 EUR netto zu 10 %: hier 23,48 EUR, auf der
+ * Rechnung 23,49 EUR). Die Formel bleibt trotzdem, wie sie ist: der Server
+ * schaltet den Kern je Konto ueber einen Schalter und rechnet Entwuerfe
+ * ausserhalb des Ausstellens teils weiter nach Weg 2, und Backend und
+ * Dart-Zwilling pruefen gegen `fixtures/rechnung-summen.json`. Neuer Code
+ * nimmt `rechnungRechnen` oder `previewInvoice`.
  *
  * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
  *
@@ -42,6 +51,12 @@ function centRund(x) {
  * Server einen steuerfreien Fall ab (etwa eine ig. Lieferung), gehoert dieser
  * Fall hierher — sonst rechnet die Funktion Steuer, die die Rechnung nicht
  * ausweist.
+ *
+ * @deprecated Seit 0.27.3: rechnet nach der frueheren Formel (Weg 2) und kann
+ * an Halbcent-Grenzen um einen Cent je Satz von einer heute ausgestellten
+ * Rechnung abweichen. Stattdessen `rechnungRechnen` aus
+ * `@kreiseck/kasseneck-api/rechnung/rechnen` (Euro-Positionen ueber
+ * `positionAusEuro`) oder `previewInvoice` verwenden.
  */
 function rechnungSummen(items, priceMode, taxScheme = 'normal') {
     const steuerfrei = rechnen_js_1.STEUERFREIE_FAELLE.includes(taxScheme);

package/dist/cjs/rechnung/typen.d.ts

@@ -133,7 +133,7 @@ export interface PaymentInput {
     reference?: string;
     /**
      * Die Zahlung erfolgte vor Ort beim Unternehmer (Terminal an der Kasse).
-     * Dann ist sie ein Barumsatz — auch mit Karte (§ 131b Abs. 1 Z 3 UStG) — und
+     * Dann ist sie ein Barumsatz — auch mit Karte (§ 131b Abs. 1 Z 3 BAO) — und
      * die Antwort traegt den Hinweis `cash_receipt_required`. Zu `transfer`
      * passt das Kennzeichen nicht und wird abgewiesen.
      */

package/dist/cjs/rechnung/vertrag.d.ts

@@ -130,7 +130,7 @@ export type InvoiceLanguage = (typeof INVOICE_LANGUAGES)[number];
  * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg.
  *
  * Ein **Barumsatz** ist nicht nur Bargeld: als Barzahlung gilt auch die Zahlung
- * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+ * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 BAO), nicht
  * aber dieselbe Karte im Internet. Weil `card` und `online` beides sein
  * koennen, sagt das Feld `onSite` es dem Server — und nur dann traegt die
  * Antwort den Hinweis `cash_receipt_required` (bei `cash` immer).

package/dist/cjs/rechnung/vertrag.js

@@ -147,7 +147,7 @@ exports.INVOICE_LANGUAGES = ['de', 'en'];
  * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg.
  *
  * Ein **Barumsatz** ist nicht nur Bargeld: als Barzahlung gilt auch die Zahlung
- * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+ * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 BAO), nicht
  * aber dieselbe Karte im Internet. Weil `card` und `online` beides sein
  * koennen, sagt das Feld `onSite` es dem Server — und nur dann traegt die
  * Antwort den Hinweis `cash_receipt_required` (bei `cash` immer).

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

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

package/dist/esm/partner/ablauf.js

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

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

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

package/dist/esm/partner/api.js

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

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

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

package/dist/esm/partner/endpunkte.js

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

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

@@ -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/esm/partner/fehler.js

@@ -43,6 +43,8 @@ export const PARTNER_FEHLER_CODES = [
     'zugang_nicht_erlaubt',
     'email_taken',
     'no_email',
+    // FinanzOnline-Link
+    'kennung_fehlt',
     // Signatur
     'fon_missing',
     'signature_pending',
@@ -57,6 +59,7 @@ export const PARTNER_FEHLER_CODES = [
     'module_inactive',
     'cashregister_limit',
     'cashregister_not_found',
+    'vertrag_offen',
     'activation_failed',
     // Webhooks
     'webhook_limit',
@@ -111,21 +114,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.',

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

@@ -12,17 +12,21 @@
  * Was hier steht, ist die Benutzung dieses Clients.
  *
  * Reihenfolge der Kette: [PARTNER_ABLAUF].
+ *
+ * **Seit 0.28.0 spricht dieser Teil die englische `/v3`** ([PARTNER_BASE_URL]).
+ * Alles andere im Paket (Belege, Rechnungen, Kasse, Druck, Zahlungen) bleibt
+ * auf `/v1`, bis es dort eine `/v3` gibt.
  */
-export { createPartnerApi, type PartnerApi, type PartnerApiOptions } from './api.js';
+export { createPartnerApi, PARTNER_BASE_URL, type PartnerApi, type PartnerApiOptions } from './api.js';
 export { partnerKeyAuth, partnerKeyEnv, type PartnerKeyAuthOptions } from './auth.js';
 export { PARTNER_ABLAUF, naechsterSchritt, type AblaufSchritt, } from './ablauf.js';
 export { PARTNER_FEHLER_CODES, PARTNER_PORTAL_FEHLER_CODES, istPartnerFehlerCode, istPartnerPortalFehlerCode, istPartnerFehler, partnerFehlerCode, partnerFehlerRat, partnerFeldFehler, partnerWartezeitSek, type PartnerCode, type PartnerFehlerCode, type PartnerPortalFehlerCode, type PartnerFeldFehler, } from './fehler.js';
 export { BETRIEB_FELDER, unbekannteBetriebsfelder, type BetriebFeld, } from './betrieb.js';
 export { KasseneckSecret, SECRET_MASKE } from './secret.js';
 export { getPartnerInfo, createPartnerCustomer, listPartnerCustomers, checkPartnerCustomerEmail, getPartnerCustomer, sendPartnerCustomerFonLink, requestCustomerSignature, getCustomerSignatureStatus, createCustomerCashregister, activateCashregister, listCustomerCashregisters, getCustomerCredentials, } from './endpunkte.js';
-export { createPartnerWebhook, listPartnerWebhooks, rotatePartnerWebhookSecret, updatePartnerWebhook, deletePartnerWebhook, sendPartnerWebhookTest, listPartnerWebhookDeliveries, parseWebhookEvent, istPartnerWebhookEvent, PARTNER_WEBHOOK_EVENTS, WEBHOOK_UMSCHLAG_FELDER, type PartnerWebhookEvent, type PartnerWebhookEventType, type PartnerWebhook, type CreateWebhookOptions, type CreateWebhookResult, type WebhookPatch, type WebhookListe, type WebhookZustellung, type WebhookTestResult, type WebhookEventResult, } from './webhooks.js';
+export { createPartnerWebhook, listPartnerWebhooks, rotatePartnerWebhookSecret, updatePartnerWebhook, deletePartnerWebhook, sendPartnerWebhookTest, listPartnerWebhookDeliveries, parseWebhookEvent, istPartnerWebhookEvent, PARTNER_WEBHOOK_EVENTS, WEBHOOK_UMSCHLAG_FELDER, type PartnerWebhookEvent, type PartnerWebhookEventType, type PartnerWebhook, type CreateWebhookOptions, type CreateWebhookResult, type DeleteWebhookResult, type WebhookApiVersion, type WebhookDeliveryStatus, type WebhookTestZustellung, type ContractKind, type ContractSource, type ContractAcceptedEventData, type WebhookPatch, type WebhookListe, type WebhookZustellung, type WebhookTestResult, type WebhookEventResult, } from './webhooks.js';
 export { verifyWebhookSignature, parseSignatureHeader, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, WEBHOOK_RETRY_PLAN_SEC, WEBHOOK_MAX_ATTEMPTS, WEBHOOK_TIMEOUT_MS, WEBHOOK_LIMIT, type VerifyWebhookOptions, type WebhookVerifyResult, type WebhookVerifyReason, } from './webhook-signatur.js';
 export { PARTNER_ENVS } from './typen.js';
-export type { PartnerEnv, PartnerScope, PartnerApp, PartnerInfo, Rechtsform, Bundesland, KontaktRolle, BetriebAdresse, BetriebSteuer, BetriebKontakt, BetriebSteuerberater, Betrieb, CreateCustomerOptions, CreateCustomerResult, KundenStatus, KundenZeile, AvvStand, ListCustomersOptions, KundenListe, Kunde, FonLinkResult, SignaturAntragStatus, SignaturHistorieEintrag, SignaturAntrag, RequestSignatureResult, SignaturStand, KassenSchritt, KassenStatus, Kasse, CreateCashregisterOptions, CreateCashregisterResult, ActivateCashregisterResult, KassenListe, CustomerCashregisterCredential, CustomerCredentials, } from './typen.js';
+export type { PartnerEnv, PartnerScope, PartnerApp, PartnerInfo, LegalForm, AustrianState, ContactRole, AvvMode, FeeInterval, PartnerFee, SignatureHistoryReason, RequestSignatureOptions, CustomerSignature, Rechtsform, Bundesland, KontaktRolle, BetriebAdresse, BetriebSteuer, BetriebKontakt, BetriebSteuerberater, Betrieb, CreateCustomerOptions, CreateCustomerResult, KundenStatus, KundenZeile, AvvStand, VertragStand, KundenFonStand, ListCustomersOptions, KundenListe, Kunde, FonLinkResult, SignaturAntragStatus, SignaturHistorieEintrag, SignaturAntrag, RequestSignatureResult, SignaturStand, KassenSchritt, KassenStatus, Kasse, CreateCashregisterOptions, CreateCashregisterResult, ActivateCashregisterResult, KassenListe, CustomerCashregisterCredential, CustomerCredentials, } from './typen.js';
 /** `credentials:read` — nicht im Standardsatz, siehe typen.ts. */
 export { SCOPE_CREDENTIALS } from './typen.js';

package/dist/esm/partner/index.js

@@ -12,8 +12,12 @@
  * Was hier steht, ist die Benutzung dieses Clients.
  *
  * Reihenfolge der Kette: [PARTNER_ABLAUF].
+ *
+ * **Seit 0.28.0 spricht dieser Teil die englische `/v3`** ([PARTNER_BASE_URL]).
+ * Alles andere im Paket (Belege, Rechnungen, Kasse, Druck, Zahlungen) bleibt
+ * auf `/v1`, bis es dort eine `/v3` gibt.
  */
-export { createPartnerApi } from './api.js';
+export { createPartnerApi, PARTNER_BASE_URL } from './api.js';
 export { partnerKeyAuth, partnerKeyEnv } from './auth.js';
 export { PARTNER_ABLAUF, naechsterSchritt, } from './ablauf.js';
 export { PARTNER_FEHLER_CODES, PARTNER_PORTAL_FEHLER_CODES, istPartnerFehlerCode, istPartnerPortalFehlerCode, istPartnerFehler, partnerFehlerCode, partnerFehlerRat, partnerFeldFehler, partnerWartezeitSek, } from './fehler.js';