@kreiseck/kasseneck-api 0.28.0 → 0.29.0

package/CHANGELOG.md

@@ -4,6 +4,42 @@ 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

package/README.md

@@ -539,11 +539,11 @@ 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.
+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';
@@ -621,6 +621,42 @@ 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/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", "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"];
+export declare const PARTNER_FEHLER_CODES: readonly ["validation", "rate_limited", "app_not_found", "app_not_accepted", "live_not_allowed", "customer_exists", "customer_conflict", "customer_limit", "access_not_allowed", "email_taken", "no_email", "tax_number_missing", "fon_missing", "signature_pending", "signature_missing", "signature_unknown", "signature_ambiguous", "signature_not_ready", "signature_limit", "signature_failed", "module_inactive", "cashregister_limit", "cashregister_not_found", "contracts_pending", "kind_not_allowed", "mode_not_allowed", "power_of_attorney_missing", "not_found", "no_version", "unknown_version", "text_changed", "already_accepted", "activation_failed", "webhook_limit", "webhook_inactive", "event_not_subscribed"];
 /**
  * Die Codes, die nur im **Partner-Portal** entstehen — beim Pflegen der App,
  * der Schluessel, der Mitglieder und der Signaturkarten.
@@ -58,7 +84,7 @@ export declare function istPartnerFehler(error: unknown, code: PartnerCode): boo
 export interface PartnerFeldFehler {
     /**
      * Der Feldpfad, so wie er im gesendeten Betrieb steht — verschachtelt und je
-     * Kontakt: `address.land`, `tax_details.ustid`, `contacts.1.abteilung`.
+     * Kontakt: `address.zip`, `taxDetails.taxNumber`, `contacts.0.email`.
      */
     field: string;
     message: string;

package/dist/cjs/partner/fehler.js

@@ -20,6 +20,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).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PARTNER_PORTAL_FEHLER_CODES = exports.PARTNER_FEHLER_CODES = void 0;
@@ -44,21 +70,19 @@ exports.PARTNER_FEHLER_CODES = [
     'rate_limited',
     'app_not_found',
     'app_not_accepted',
-    'kein_partnerbetrieb',
     'live_not_allowed',
     // Betrieb anlegen
     'customer_exists',
     'customer_conflict',
     'customer_limit',
-    'zugang_nicht_erlaubt',
+    'access_not_allowed',
     'email_taken',
     'no_email',
     // FinanzOnline-Link
-    'kennung_fehlt',
+    'tax_number_missing',
     // Signatur
     'fon_missing',
     'signature_pending',
-    'request_not_found',
     'signature_missing',
     'signature_unknown',
     'signature_ambiguous',
@@ -69,7 +93,17 @@ exports.PARTNER_FEHLER_CODES = [
     'module_inactive',
     'cashregister_limit',
     'cashregister_not_found',
-    'vertrag_offen',
+    'contracts_pending',
+    // Vertraege (reportCustomerContract: dieses Paket bietet den Endpunkt nicht
+    // an, der Katalog fuehrt die Codes trotzdem vollstaendig, siehe oben)
+    'kind_not_allowed',
+    'mode_not_allowed',
+    'power_of_attorney_missing',
+    'not_found',
+    'no_version',
+    'unknown_version',
+    'text_changed',
+    'already_accepted',
     'activation_failed',
     // Webhooks
     'webhook_limit',
@@ -119,28 +153,38 @@ const RAT = {
     rate_limited: 'Zu viele Aufrufe. data.retryAfterSec Sekunden warten und denselben Aufruf wiederholen.',
     app_not_found: 'Die appId gibt es nicht. getPartnerInfo liefert die eigenen Apps samt id.',
     app_not_accepted: 'Diese App hat noch keine abgenommene Version. Mit einem pk_test_-Schluessel oder mit env:"test" geht es sofort weiter; live erst nach der Abnahme.',
-    kein_partnerbetrieb: 'Dieser Betrieb gehoert nicht zu diesem Partner-Konto. Die eigenen stehen in listPartnerCustomers.',
     live_not_allowed: 'Ein Test-Schluessel erzeugt nichts Echtes. Fuer einen Live-Betrieb den Live-Schluessel nehmen — umgekehrt darf ein Live-Schluessel mit env:"test" sehr wohl einen Testbetrieb anlegen.',
     customer_exists: 'Diesen Betrieb gibt es schon (data.customerId). Mit derselben customerId weiterarbeiten.',
     customer_conflict: 'Die Steuernummer ist bei Kasseneck bereits registriert. Die Zuordnung zum Partner macht Kasseneck — hello@kasseneck.at.',
     customer_limit: 'Das Tageslimit fuer neue Betriebe ist erreicht (data.max, data.resetAt). Morgen weiter.',
-    zugang_nicht_erlaubt: 'Fuer dieses Partner-Konto sind Zugaenge zum Kundenpanel nicht freigeschaltet — es entstand NICHTS, auch kein Betrieb. Ohne access{invite:true} erneut anlegen oder die Freischaltung erfragen (Stand: getPartnerInfo.partner.canCreateAccess).',
+    access_not_allowed: 'Fuer dieses Partner-Konto sind Zugaenge zum Kundenpanel nicht freigeschaltet — es entstand NICHTS, auch kein Betrieb. Ohne access{invite:true} erneut anlegen oder die Freischaltung erfragen (Stand: getPartnerInfo.partner.canCreateAccess).',
     email_taken: 'Fuer diese E-Mail gibt es schon einen Kasseneck-Zugang. Eine andere Adresse waehlen, auf die Einladung verzichten oder den Betrieb zuordnen lassen.',
     no_email: 'Im Konto des Betriebs steht keine E-Mail-Adresse. Ohne sie geht weder eine Einladung noch der FinanzOnline-Link hinaus.',
-    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.',
+    tax_number_missing: 'Am Betrieb ist keine Steuernummer hinterlegt, ohne sie gibt es keinen Einrichtungs-Link. Die Steuernummer bei Kasseneck nachtragen lassen (hello@kasseneck.at), dann sendPartnerCustomerFonLink erneut.',
     fon_missing: 'Der Betrieb hat noch keinen FinanzOnline-Zugang. sendPartnerCustomerFonLink senden und customer.fon_verified abwarten. Betrifft das ANMELDEN der Signatureinheit, nicht das Beantragen.',
     signature_pending: 'Fuer diesen Betrieb laeuft bereits ein Antrag. Auf signature.ready warten.',
-    request_not_found: 'Diese signaturId gibt es nicht. getCustomerSignatureStatus nennt die des Betriebs.',
     signature_missing: 'Der Betrieb hat ueberhaupt keine Signatur, und jede Kasse bezieht sich auf eine. Zuerst requestCustomerSignature.',
     signature_unknown: 'Die genannte signatureRequestId gehoert nicht zu diesem Betrieb. getCustomerSignatureStatus nennt die seinen.',
     signature_ambiguous: 'Der Betrieb hat mehrere Signaturen; welche die Kasse benutzt, muss dastehen. Eine aus data.choices als signatureRequestId mitgeben.',
     signature_not_ready: 'Die Signatur DIESER Kasse ist noch nicht bereit. Auf signature.ready warten; eine mit automatic:true angelegte Kasse geht danach von selbst live.',
     signature_limit: 'Hoechstens zehn Signaturen je Betrieb. Eine bestehende benutzen, statt mit additional:true eine weitere zu beantragen.',
     signature_failed: 'FinanzOnline hat die Anmeldung abgelehnt (data.rc). Kasseneck klaert das — hello@kasseneck.at.',
-    module_inactive: 'Das Modul (data.modul) ist fuer diesen Betrieb nicht gebucht. Kasseneck schaltet es frei.',
+    module_inactive: 'Das Modul (data.module, z. B. "cash_register", Text in data.detail) ist fuer diesen Betrieb nicht gebucht. Kasseneck schaltet es frei.',
     cashregister_limit: 'Hoechstens 20 Registrierkassen je Betrieb. Eine bestehende nutzen.',
     cashregister_not_found: 'Diese cashregisterId gibt es bei diesem Betrieb nicht.',
-    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.',
+    contracts_pending: 'Nur live: der Betrieb hat Auftragsverarbeitungs- und Nutzungsvertrag noch nicht bestaetigt. An der Kasse aendert sich nichts. Den Betrieb ueber den Einrichtungs-Link bestaetigen lassen (sendPartnerCustomerFonLink, Stand in avv/terms von getPartnerCustomer), danach activateCashregister erneut.',
+    // -- Vertraege (reportCustomerContract) ------------------------------------
+    // Dieser Client bietet den Endpunkt (noch) nicht an; die Codes stehen hier
+    // nur fuer die Katalogseite und fuer einen Aufrufer, der die rohe Antwort
+    // selbst auswertet (siehe Kopfkommentar der Datei).
+    kind_not_allowed: 'reportCustomerContract mit einer anderen Art als "avv". Der Vollmachtsweg nimmt nur den Auftragsverarbeitungsvertrag entgegen. Dieser Client bietet den Endpunkt nicht an.',
+    mode_not_allowed: 'Der Vollmachtsweg ist fuer dieses Partner-Konto nicht freigeschaltet. Kasseneck fragen (hello@kasseneck.at).',
+    power_of_attorney_missing: 'Der Partnervertrag mit dem Vollmachts-Kapitel ist noch nicht bestaetigt. Erst danach nimmt der Vollmachtsweg Meldungen entgegen.',
+    not_found: 'Die genannte customerId gehoert nicht zu diesem Partner-Konto oder existiert nicht. listPartnerCustomers nennt die eigenen.',
+    no_version: 'Fuer die gemeldete Vertragsart gibt es derzeit keine gueltige Fassung. Bei Kasseneck nachfragen.',
+    unknown_version: 'Die gemeldete Vertragsversion gibt es nicht. Die aktuell geltende Fassung neu abrufen.',
+    text_changed: 'Der gezeigte Vertragstext hat sich seit dem Laden geaendert (data.textHash traegt die aktuell geltende Pruefsumme). Neu laden und danach erneut bestaetigen lassen.',
+    already_accepted: 'Diese Fassung ist bereits bestaetigt (data.contractId). Nichts weiter zu tun.',
     activation_failed: 'Die Inbetriebnahme blieb an data.step haengen (ggf. data.rc). activateCashregister erneut aufrufen — jeder Schritt ist idempotent, der Lauf setzt an der Bruchstelle an.',
     webhook_limit: 'Hoechstens 10 Webhook-Endpunkte je Partner. Einen ungenutzten loeschen.',
     webhook_inactive: 'Der Webhook steht auf active:false. Zuerst aktivieren, dann erneut proben.',

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

@@ -27,6 +27,6 @@ export { getPartnerInfo, createPartnerCustomer, listPartnerCustomers, checkPartn
 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, 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';
+export type { PartnerEnv, PartnerScope, PartnerApp, PartnerInfo, LegalForm, AustrianState, ContactRole, AvvMode, FeeInterval, PartnerFee, SignatureHistoryReason, SignatureErrorCode, 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/cjs/partner/typen.d.ts

@@ -329,6 +329,13 @@ export type SignaturAntragStatus = 'requested' | 'assigned' | 'registered' | 're
  * `finanzonline` hiessen unter `/v1` `karte_eingetragen` und `fon`.
  */
 export type SignatureHistoryReason = 'api' | 'portal' | 'card_entered' | 'finanzonline' | 'automation_off' | 'test_environment' | 'no_stock' | (string & {});
+/**
+ * `error.code` eines Signaturantrags oder einer Signatur (`SignaturAntrag`,
+ * `CustomerSignature`). Hiess unter `/v1` `kunde_nicht_gefunden` /
+ * `unvollstaendig` / `fon_fehler`; dieser Client spricht seit 0.28.0 nur noch
+ * `/v3` und sieht darum nur die englische Form.
+ */
+export type SignatureErrorCode = 'customer_not_found' | 'incomplete' | 'finanzonline_error' | (string & {});
 export interface SignaturHistorieEintrag {
     from: SignaturAntragStatus | null;
     to: SignaturAntragStatus;
@@ -344,7 +351,7 @@ export interface SignaturAntrag {
     vdaId: string | null;
     signatureId: string | null;
     error: {
-        code: string | null;
+        code: SignatureErrorCode | null;
         message: string | null;
         rc: string | null;
     } | null;
@@ -383,7 +390,7 @@ export interface CustomerSignature {
     requestId: string | null;
     signatureId: string | null;
     error: {
-        code: string | null;
+        code: SignatureErrorCode | null;
         message: string | null;
         rc: string | null;
     } | null;

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

@@ -19,6 +19,32 @@
  * unterscheiden. Deshalb stehen hier BEIDE Flaechen: die der Schnittstelle
  * ([PARTNER_FEHLER_CODES]) und die des Partner-Portals
  * ([PARTNER_PORTAL_FEHLER_CODES]).
+ *
+ * **Seit 0.29.0 englisch, wie der Rest von `/v3`.** Dieser Client spricht seit
+ * 0.28.0 ausschliesslich `/v3` (`PARTNER_BASE_URL`): die paar deutschen Codes,
+ * die der Server bis dahin noch roh durchreichte, kommen jetzt genauso englisch
+ * an wie alle anderen. [PARTNER_FEHLER_CODES] fuehrt deshalb ausnahmslos die
+ * `/v3`-Schreibweise aus `fehlercodes.json`s `v3`-Zuordnung (deutsch -> englisch);
+ * ein Aufrufer bekommt vom Server nie mehr die deutsche Form.
+ *
+ * **`kein_partnerbetrieb` und `request_not_found` fehlen absichtlich.** Beide
+ * sind admin-only (`partner-endpoints.js`, ausserhalb von `FEHLER_KATALOG`) und
+ * erreichen `/v3` nie: ein Partner-Aufruf kann sie unter keinem Pfad bekommen.
+ * Sie standen frueher versehentlich in dieser Liste; `dart-partner.json` (ein
+ * eingefrorener Abzug aus Dart 5.3.0, bevor das korrigiert wurde) fuehrt sie
+ * weiterhin, siehe die Ausnahme in `test/partner-enums.test.ts`.
+ *
+ * **Die Vertrags-Codes (`kind_not_allowed`, `mode_not_allowed`,
+ * `power_of_attorney_missing`, `not_found`, `no_version`,
+ * `unknown_version`, `text_changed`, `already_accepted`) stehen hier, obwohl
+ * dieses Paket `reportCustomerContract` nicht anbietet.** Der Katalog des
+ * Backends fuehrt sie mit `flaeche: 'api'`/`'beide'`, dieselbe Regel wie bei
+ * den Portal-Codes oben: vollstaendig heisst vollstaendig, auch fuer einen
+ * Endpunkt, den (noch) kein Aufruf dieses Clients ausloest. Ein Server-Update,
+ * das den Endpunkt ergaenzt, bräuchte dann keinen zweiten Fehlerkatalog-Umbau.
+ * `not_required` fehlt bewusst: derselbe gemeinsame Server-Zweig wie die
+ * anderen sechs, aber ueber die Partner-API nicht erreichbar (der Server hat
+ * ihn aus `FEHLER_KATALOG` entfernt, siehe `partner-core.js` im Backend).
  */
 /**
  * Alle Codes, die die **Schnittstelle** kennt. Als Liste und nicht nur als
@@ -27,7 +53,7 @@
  *
  * Reihenfolge und Bestand wie im Abzug des Backends.
  */
-export declare const PARTNER_FEHLER_CODES: readonly ["validation", "rate_limited", "app_not_found", "app_not_accepted", "kein_partnerbetrieb", "live_not_allowed", "customer_exists", "customer_conflict", "customer_limit", "zugang_nicht_erlaubt", "email_taken", "no_email", "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"];
+export declare const PARTNER_FEHLER_CODES: readonly ["validation", "rate_limited", "app_not_found", "app_not_accepted", "live_not_allowed", "customer_exists", "customer_conflict", "customer_limit", "access_not_allowed", "email_taken", "no_email", "tax_number_missing", "fon_missing", "signature_pending", "signature_missing", "signature_unknown", "signature_ambiguous", "signature_not_ready", "signature_limit", "signature_failed", "module_inactive", "cashregister_limit", "cashregister_not_found", "contracts_pending", "kind_not_allowed", "mode_not_allowed", "power_of_attorney_missing", "not_found", "no_version", "unknown_version", "text_changed", "already_accepted", "activation_failed", "webhook_limit", "webhook_inactive", "event_not_subscribed"];
 /**
  * Die Codes, die nur im **Partner-Portal** entstehen — beim Pflegen der App,
  * der Schluessel, der Mitglieder und der Signaturkarten.
@@ -58,7 +84,7 @@ export declare function istPartnerFehler(error: unknown, code: PartnerCode): boo
 export interface PartnerFeldFehler {
     /**
      * Der Feldpfad, so wie er im gesendeten Betrieb steht — verschachtelt und je
-     * Kontakt: `address.land`, `tax_details.ustid`, `contacts.1.abteilung`.
+     * Kontakt: `address.zip`, `taxDetails.taxNumber`, `contacts.0.email`.
      */
     field: string;
     message: string;

package/dist/esm/partner/fehler.js

@@ -19,6 +19,32 @@
  * unterscheiden. Deshalb stehen hier BEIDE Flaechen: die der Schnittstelle
  * ([PARTNER_FEHLER_CODES]) und die des Partner-Portals
  * ([PARTNER_PORTAL_FEHLER_CODES]).
+ *
+ * **Seit 0.29.0 englisch, wie der Rest von `/v3`.** Dieser Client spricht seit
+ * 0.28.0 ausschliesslich `/v3` (`PARTNER_BASE_URL`): die paar deutschen Codes,
+ * die der Server bis dahin noch roh durchreichte, kommen jetzt genauso englisch
+ * an wie alle anderen. [PARTNER_FEHLER_CODES] fuehrt deshalb ausnahmslos die
+ * `/v3`-Schreibweise aus `fehlercodes.json`s `v3`-Zuordnung (deutsch -> englisch);
+ * ein Aufrufer bekommt vom Server nie mehr die deutsche Form.
+ *
+ * **`kein_partnerbetrieb` und `request_not_found` fehlen absichtlich.** Beide
+ * sind admin-only (`partner-endpoints.js`, ausserhalb von `FEHLER_KATALOG`) und
+ * erreichen `/v3` nie: ein Partner-Aufruf kann sie unter keinem Pfad bekommen.
+ * Sie standen frueher versehentlich in dieser Liste; `dart-partner.json` (ein
+ * eingefrorener Abzug aus Dart 5.3.0, bevor das korrigiert wurde) fuehrt sie
+ * weiterhin, siehe die Ausnahme in `test/partner-enums.test.ts`.
+ *
+ * **Die Vertrags-Codes (`kind_not_allowed`, `mode_not_allowed`,
+ * `power_of_attorney_missing`, `not_found`, `no_version`,
+ * `unknown_version`, `text_changed`, `already_accepted`) stehen hier, obwohl
+ * dieses Paket `reportCustomerContract` nicht anbietet.** Der Katalog des
+ * Backends fuehrt sie mit `flaeche: 'api'`/`'beide'`, dieselbe Regel wie bei
+ * den Portal-Codes oben: vollstaendig heisst vollstaendig, auch fuer einen
+ * Endpunkt, den (noch) kein Aufruf dieses Clients ausloest. Ein Server-Update,
+ * das den Endpunkt ergaenzt, bräuchte dann keinen zweiten Fehlerkatalog-Umbau.
+ * `not_required` fehlt bewusst: derselbe gemeinsame Server-Zweig wie die
+ * anderen sechs, aber ueber die Partner-API nicht erreichbar (der Server hat
+ * ihn aus `FEHLER_KATALOG` entfernt, siehe `partner-core.js` im Backend).
  */
 import { KasseneckApiError } from '../client/errors.js';
 /**
@@ -34,21 +60,19 @@ export const PARTNER_FEHLER_CODES = [
     'rate_limited',
     'app_not_found',
     'app_not_accepted',
-    'kein_partnerbetrieb',
     'live_not_allowed',
     // Betrieb anlegen
     'customer_exists',
     'customer_conflict',
     'customer_limit',
-    'zugang_nicht_erlaubt',
+    'access_not_allowed',
     'email_taken',
     'no_email',
     // FinanzOnline-Link
-    'kennung_fehlt',
+    'tax_number_missing',
     // Signatur
     'fon_missing',
     'signature_pending',
-    'request_not_found',
     'signature_missing',
     'signature_unknown',
     'signature_ambiguous',
@@ -59,7 +83,17 @@ export const PARTNER_FEHLER_CODES = [
     'module_inactive',
     'cashregister_limit',
     'cashregister_not_found',
-    'vertrag_offen',
+    'contracts_pending',
+    // Vertraege (reportCustomerContract: dieses Paket bietet den Endpunkt nicht
+    // an, der Katalog fuehrt die Codes trotzdem vollstaendig, siehe oben)
+    'kind_not_allowed',
+    'mode_not_allowed',
+    'power_of_attorney_missing',
+    'not_found',
+    'no_version',
+    'unknown_version',
+    'text_changed',
+    'already_accepted',
     'activation_failed',
     // Webhooks
     'webhook_limit',
@@ -109,28 +143,38 @@ const RAT = {
     rate_limited: 'Zu viele Aufrufe. data.retryAfterSec Sekunden warten und denselben Aufruf wiederholen.',
     app_not_found: 'Die appId gibt es nicht. getPartnerInfo liefert die eigenen Apps samt id.',
     app_not_accepted: 'Diese App hat noch keine abgenommene Version. Mit einem pk_test_-Schluessel oder mit env:"test" geht es sofort weiter; live erst nach der Abnahme.',
-    kein_partnerbetrieb: 'Dieser Betrieb gehoert nicht zu diesem Partner-Konto. Die eigenen stehen in listPartnerCustomers.',
     live_not_allowed: 'Ein Test-Schluessel erzeugt nichts Echtes. Fuer einen Live-Betrieb den Live-Schluessel nehmen — umgekehrt darf ein Live-Schluessel mit env:"test" sehr wohl einen Testbetrieb anlegen.',
     customer_exists: 'Diesen Betrieb gibt es schon (data.customerId). Mit derselben customerId weiterarbeiten.',
     customer_conflict: 'Die Steuernummer ist bei Kasseneck bereits registriert. Die Zuordnung zum Partner macht Kasseneck — hello@kasseneck.at.',
     customer_limit: 'Das Tageslimit fuer neue Betriebe ist erreicht (data.max, data.resetAt). Morgen weiter.',
-    zugang_nicht_erlaubt: 'Fuer dieses Partner-Konto sind Zugaenge zum Kundenpanel nicht freigeschaltet — es entstand NICHTS, auch kein Betrieb. Ohne access{invite:true} erneut anlegen oder die Freischaltung erfragen (Stand: getPartnerInfo.partner.canCreateAccess).',
+    access_not_allowed: 'Fuer dieses Partner-Konto sind Zugaenge zum Kundenpanel nicht freigeschaltet — es entstand NICHTS, auch kein Betrieb. Ohne access{invite:true} erneut anlegen oder die Freischaltung erfragen (Stand: getPartnerInfo.partner.canCreateAccess).',
     email_taken: 'Fuer diese E-Mail gibt es schon einen Kasseneck-Zugang. Eine andere Adresse waehlen, auf die Einladung verzichten oder den Betrieb zuordnen lassen.',
     no_email: 'Im Konto des Betriebs steht keine E-Mail-Adresse. Ohne sie geht weder eine Einladung noch der FinanzOnline-Link hinaus.',
-    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.',
+    tax_number_missing: 'Am Betrieb ist keine Steuernummer hinterlegt, ohne sie gibt es keinen Einrichtungs-Link. Die Steuernummer bei Kasseneck nachtragen lassen (hello@kasseneck.at), dann sendPartnerCustomerFonLink erneut.',
     fon_missing: 'Der Betrieb hat noch keinen FinanzOnline-Zugang. sendPartnerCustomerFonLink senden und customer.fon_verified abwarten. Betrifft das ANMELDEN der Signatureinheit, nicht das Beantragen.',
     signature_pending: 'Fuer diesen Betrieb laeuft bereits ein Antrag. Auf signature.ready warten.',
-    request_not_found: 'Diese signaturId gibt es nicht. getCustomerSignatureStatus nennt die des Betriebs.',
     signature_missing: 'Der Betrieb hat ueberhaupt keine Signatur, und jede Kasse bezieht sich auf eine. Zuerst requestCustomerSignature.',
     signature_unknown: 'Die genannte signatureRequestId gehoert nicht zu diesem Betrieb. getCustomerSignatureStatus nennt die seinen.',
     signature_ambiguous: 'Der Betrieb hat mehrere Signaturen; welche die Kasse benutzt, muss dastehen. Eine aus data.choices als signatureRequestId mitgeben.',
     signature_not_ready: 'Die Signatur DIESER Kasse ist noch nicht bereit. Auf signature.ready warten; eine mit automatic:true angelegte Kasse geht danach von selbst live.',
     signature_limit: 'Hoechstens zehn Signaturen je Betrieb. Eine bestehende benutzen, statt mit additional:true eine weitere zu beantragen.',
     signature_failed: 'FinanzOnline hat die Anmeldung abgelehnt (data.rc). Kasseneck klaert das — hello@kasseneck.at.',
-    module_inactive: 'Das Modul (data.modul) ist fuer diesen Betrieb nicht gebucht. Kasseneck schaltet es frei.',
+    module_inactive: 'Das Modul (data.module, z. B. "cash_register", Text in data.detail) ist fuer diesen Betrieb nicht gebucht. Kasseneck schaltet es frei.',
     cashregister_limit: 'Hoechstens 20 Registrierkassen je Betrieb. Eine bestehende nutzen.',
     cashregister_not_found: 'Diese cashregisterId gibt es bei diesem Betrieb nicht.',
-    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.',
+    contracts_pending: 'Nur live: der Betrieb hat Auftragsverarbeitungs- und Nutzungsvertrag noch nicht bestaetigt. An der Kasse aendert sich nichts. Den Betrieb ueber den Einrichtungs-Link bestaetigen lassen (sendPartnerCustomerFonLink, Stand in avv/terms von getPartnerCustomer), danach activateCashregister erneut.',
+    // -- Vertraege (reportCustomerContract) ------------------------------------
+    // Dieser Client bietet den Endpunkt (noch) nicht an; die Codes stehen hier
+    // nur fuer die Katalogseite und fuer einen Aufrufer, der die rohe Antwort
+    // selbst auswertet (siehe Kopfkommentar der Datei).
+    kind_not_allowed: 'reportCustomerContract mit einer anderen Art als "avv". Der Vollmachtsweg nimmt nur den Auftragsverarbeitungsvertrag entgegen. Dieser Client bietet den Endpunkt nicht an.',
+    mode_not_allowed: 'Der Vollmachtsweg ist fuer dieses Partner-Konto nicht freigeschaltet. Kasseneck fragen (hello@kasseneck.at).',
+    power_of_attorney_missing: 'Der Partnervertrag mit dem Vollmachts-Kapitel ist noch nicht bestaetigt. Erst danach nimmt der Vollmachtsweg Meldungen entgegen.',
+    not_found: 'Die genannte customerId gehoert nicht zu diesem Partner-Konto oder existiert nicht. listPartnerCustomers nennt die eigenen.',
+    no_version: 'Fuer die gemeldete Vertragsart gibt es derzeit keine gueltige Fassung. Bei Kasseneck nachfragen.',
+    unknown_version: 'Die gemeldete Vertragsversion gibt es nicht. Die aktuell geltende Fassung neu abrufen.',
+    text_changed: 'Der gezeigte Vertragstext hat sich seit dem Laden geaendert (data.textHash traegt die aktuell geltende Pruefsumme). Neu laden und danach erneut bestaetigen lassen.',
+    already_accepted: 'Diese Fassung ist bereits bestaetigt (data.contractId). Nichts weiter zu tun.',
     activation_failed: 'Die Inbetriebnahme blieb an data.step haengen (ggf. data.rc). activateCashregister erneut aufrufen — jeder Schritt ist idempotent, der Lauf setzt an der Bruchstelle an.',
     webhook_limit: 'Hoechstens 10 Webhook-Endpunkte je Partner. Einen ungenutzten loeschen.',
     webhook_inactive: 'Der Webhook steht auf active:false. Zuerst aktivieren, dann erneut proben.',

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

@@ -27,6 +27,6 @@ export { getPartnerInfo, createPartnerCustomer, listPartnerCustomers, checkPartn
 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, 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';
+export type { PartnerEnv, PartnerScope, PartnerApp, PartnerInfo, LegalForm, AustrianState, ContactRole, AvvMode, FeeInterval, PartnerFee, SignatureHistoryReason, SignatureErrorCode, 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/typen.d.ts

@@ -329,6 +329,13 @@ export type SignaturAntragStatus = 'requested' | 'assigned' | 'registered' | 're
  * `finanzonline` hiessen unter `/v1` `karte_eingetragen` und `fon`.
  */
 export type SignatureHistoryReason = 'api' | 'portal' | 'card_entered' | 'finanzonline' | 'automation_off' | 'test_environment' | 'no_stock' | (string & {});
+/**
+ * `error.code` eines Signaturantrags oder einer Signatur (`SignaturAntrag`,
+ * `CustomerSignature`). Hiess unter `/v1` `kunde_nicht_gefunden` /
+ * `unvollstaendig` / `fon_fehler`; dieser Client spricht seit 0.28.0 nur noch
+ * `/v3` und sieht darum nur die englische Form.
+ */
+export type SignatureErrorCode = 'customer_not_found' | 'incomplete' | 'finanzonline_error' | (string & {});
 export interface SignaturHistorieEintrag {
     from: SignaturAntragStatus | null;
     to: SignaturAntragStatus;
@@ -344,7 +351,7 @@ export interface SignaturAntrag {
     vdaId: string | null;
     signatureId: string | null;
     error: {
-        code: string | null;
+        code: SignatureErrorCode | null;
         message: string | null;
         rc: string | null;
     } | null;
@@ -383,7 +390,7 @@ export interface CustomerSignature {
     requestId: string | null;
     signatureId: string | null;
     error: {
-        code: string | null;
+        code: SignatureErrorCode | null;
         message: string | null;
         rc: string | null;
     } | null;

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.28.0",
+  "version": "0.29.0",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.28.0",
+  "version": "0.29.0",
   "meldungen": {
     "netz.keine_verbindung": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.28.0",
+  "version": "0.29.0",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",
@@ -292,18 +292,16 @@
       "rate_limited",
       "app_not_found",
       "app_not_accepted",
-      "kein_partnerbetrieb",
       "live_not_allowed",
       "customer_exists",
       "customer_conflict",
       "customer_limit",
-      "zugang_nicht_erlaubt",
+      "access_not_allowed",
       "email_taken",
       "no_email",
-      "kennung_fehlt",
+      "tax_number_missing",
       "fon_missing",
       "signature_pending",
-      "request_not_found",
       "signature_missing",
       "signature_unknown",
       "signature_ambiguous",
@@ -313,7 +311,15 @@
       "module_inactive",
       "cashregister_limit",
       "cashregister_not_found",
-      "vertrag_offen",
+      "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",

package/fixtures/rechnung-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 1,
-  "paket": "0.28.0",
+  "paket": "0.29.0",
   "aufrufe": {
     "createCustomer": {
       "anfrage": {

package/fixtures/rechnung-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.28.0",
+  "version": "0.29.0",
   "sprachen": [
     "de",
     "en"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Austrian fiscal cash register (RKSV) client for JavaScript and TypeScript: signed receipts, cancellations, card payments, receipt printing (ESC/POS), invoices. RKSV-Registrierkasse für JavaScript und TypeScript.",
   "license": "Apache-2.0",
   "author": "Kreiseck",