@kreiseck/kasseneck-api 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -4,6 +4,25 @@ 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.16.0
+
+### Rechnungs-API: Freigabe und Einrichtung vor dem ersten Ausstellen
+
+**Anlass:** Mit 0.15.0 konnte jedes Konto mit aktivem Modul Rechnung sofort
+automatisiert Rechnungen mit fortlaufender Nummer ausstellen — auch mit einem
+Probezeitraum, ohne Bankverbindung und mit dem ungewollten Standard-Nummernformat,
+das sich mit der ersten Rechnung sperrt. Ein Fremdsystem erfuhr erst beim
+Festschreiben, dass etwas fehlt.
+
+- Neuer Aufruf `getInvoiceSetupStatus()` → `{ ready, environment, missing }`.
+  Er läuft auch ohne Freigabe und vor der Live-Freischaltung, also genau dann,
+  wenn man die Antwort braucht.
+- `INVOICE_SETUP_REQUIREMENTS`: `module_active`, `api_enabled`, `live_enabled`,
+  `business_name`, `address`, `vat_id`, `bank_account`, `number_format`.
+- Neue Fehlercodes: `invoice_api_not_enabled` (Kasseneck hat die Rechnungs-API
+  für das Konto nicht freigegeben; nur live) und `invoice_setup_incomplete`
+  (`details.missing` wie im Status).
+
 ## 0.15.0
 
 ### Rechnungs-API: Rechnungen statt Belege, per `api_key`

package/README.md

@@ -479,6 +479,16 @@ await rechnungen.createCreditNote({
 });
 ```
 
+**Vor dem ersten Ausstellen die Einrichtung abfragen.** Die Rechnungs-API muss
+für das Konto von Kasseneck freigegeben sein (live), und Firmenname, Anschrift,
+UID, Bankverbindung und Nummernformat müssen stehen — sonst antwortet
+`issueInvoice` mit `invoice_api_not_enabled` bzw. `invoice_setup_incomplete`:
+
+```ts
+const status = await rechnungen.getInvoiceSetupStatus();
+if (!status.ready) console.warn(status.missing.map((m) => m.message).join('\n'));
+```
+
 **Nach einem Zeitlimit mit demselben `idempotencyKey` wiederholen**, nie mit
 einem neuen: dann kommt die schon ausgestellte Rechnung zurück
 (`replayed: true`). Derselbe Schlüssel mit anderen Daten ergibt

package/dist/cjs/client/aufrufe.d.ts

@@ -13,7 +13,7 @@
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
 import type { TransportBodyFields } from './transport.js';
-export declare const AUFRUFE: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook"];
+export declare const AUFRUFE: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook"];
 export type Aufruf = typeof AUFRUFE[number];
 /** Wie [KasseneckTransport], nur mit bekanntem Aufrufnamen. Nicht exportiert nach aussen. */
 export type InternerTransport = <T = unknown>(functionName: Aufruf, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;

package/dist/cjs/client/aufrufe.js

@@ -26,6 +26,7 @@ exports.AUFRUFE = [
     'getFirstReceiptDate',
     'getInvoice',
     'getInvoicePdf',
+    'getInvoiceSetupStatus',
     'getInvoiceXml',
     'getKasseSettings',
     'getPartnerCustomer',

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

@@ -6,7 +6,7 @@
  */
 import { type FetchLike } from '../client/transport.js';
 import type { EInvoiceFormat } from './vertrag.js';
-import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
 export interface RechnungApiOptions {
     /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
     apiKey: string;
@@ -39,5 +39,7 @@ export interface RechnungApi {
     listInvoices(abfrage?: InvoiceListQuery): Promise<InvoicePage>;
     getInvoicePdf(invoiceId: string): Promise<Uint8Array>;
     getInvoiceXml(invoiceId: string, format?: EInvoiceFormat): Promise<string>;
+    /** Darf dieses Konto ausstellen, und was fehlt noch? Laeuft auch ohne Freigabe. */
+    getInvoiceSetupStatus(): Promise<InvoiceSetupStatus>;
 }
 export declare function createRechnungApi(optionen: RechnungApiOptions): RechnungApi;

package/dist/cjs/rechnung/api.js

@@ -31,5 +31,6 @@ function createRechnungApi(optionen) {
         listInvoices: (abfrage) => (0, endpunkte_js_1.listInvoices)(rufen, abfrage),
         getInvoicePdf: (id) => (0, endpunkte_js_1.getInvoicePdf)(rufenBinaer, id),
         getInvoiceXml: (id, format) => (0, endpunkte_js_1.getInvoiceXml)(rufen, id, format),
+        getInvoiceSetupStatus: () => (0, endpunkte_js_1.getInvoiceSetupStatus)(rufen),
     };
 }

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

@@ -18,7 +18,7 @@
  */
 import type { InternerBinaerTransport, InternerTransport } from '../client/aufrufe.js';
 import type { EInvoiceFormat } from './vertrag.js';
-import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
 export declare function createCustomer(rufen: InternerTransport, customer: CustomerInput, optionen?: {
     idempotencyKey?: string;
 }): Promise<Customer>;
@@ -38,6 +38,12 @@ export declare function getInvoice(rufen: InternerTransport, kennung: {
     number: string;
 }): Promise<InvoiceDetail>;
 export declare function listInvoices(rufen: InternerTransport, abfrage?: InvoiceListQuery): Promise<InvoicePage>;
+/**
+ * Darf dieses Konto ueber die API ausstellen, und was fehlt noch? Laeuft auch
+ * ohne Freigabe und vor der Live-Freischaltung — genau dann braucht man die
+ * Antwort. Vor dem ersten `issueInvoice` aufrufen und `missing` anzeigen.
+ */
+export declare function getInvoiceSetupStatus(rufen: InternerTransport): Promise<InvoiceSetupStatus>;
 /** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
 export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string): Promise<Uint8Array>;
 /**

package/dist/cjs/rechnung/endpunkte.js

@@ -27,6 +27,7 @@ exports.cancelInvoice = cancelInvoice;
 exports.createCreditNote = createCreditNote;
 exports.getInvoice = getInvoice;
 exports.listInvoices = listInvoices;
+exports.getInvoiceSetupStatus = getInvoiceSetupStatus;
 exports.getInvoicePdf = getInvoicePdf;
 exports.getInvoiceXml = getInvoiceXml;
 const errors_js_1 = require("../client/errors.js");
@@ -109,6 +110,23 @@ async function listInvoices(rufen, abfrage = {}) {
     const { eintraege, nextCursor } = seite('listInvoices', daten, 'invoices');
     return { invoices: eintraege, nextCursor };
 }
+// ---- Freigabe und Einrichtung ---------------------------------------------------
+/**
+ * Darf dieses Konto ueber die API ausstellen, und was fehlt noch? Laeuft auch
+ * ohne Freigabe und vor der Live-Freischaltung — genau dann braucht man die
+ * Antwort. Vor dem ersten `issueInvoice` aufrufen und `missing` anzeigen.
+ */
+async function getInvoiceSetupStatus(rufen) {
+    const daten = objekt(await rufen('getInvoiceSetupStatus', {}));
+    if (typeof daten['ready'] !== 'boolean' || !Array.isArray(daten['missing'])) {
+        throw new errors_js_1.KasseneckValidationError('getInvoiceSetupStatus', 'Antwort ohne ready/missing', 'response');
+    }
+    return {
+        ready: daten['ready'],
+        environment: daten['environment'] === 'test' ? 'test' : 'live',
+        missing: daten['missing'],
+    };
+}
 // ---- Dateien ----------------------------------------------------------------
 /** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
 function getInvoicePdf(rufenBinaer, invoiceId) {

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

@@ -13,6 +13,6 @@
 export { createRechnungApi, type RechnungApi, type RechnungApiOptions } from './api.js';
 export { rechnungKeyAuth, type RechnungKeyAuthOptions } from './auth.js';
 export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, type RechnungFeldFehler, } from './fehler.js';
-export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
-export type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceTotals, IssueInvoiceRequest, IssueResult, } from './typen.js';
-export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type Format, type Feld, } from './vertrag.js';
+export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
+export type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, IssueInvoiceRequest, IssueResult, } from './typen.js';
+export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/cjs/rechnung/index.js

@@ -12,7 +12,7 @@
  * Benutzung des Clients.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = exports.updateCustomer = exports.searchCustomers = exports.listInvoices = exports.issueInvoice = exports.getInvoiceXml = exports.getInvoicePdf = exports.getInvoice = exports.getCustomer = exports.createCustomer = exports.createCreditNote = exports.cancelInvoice = exports.rechnungFeldFehler = exports.rechnungFehlerCode = exports.istRechnungFehler = exports.rechnungKeyAuth = exports.createRechnungApi = void 0;
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = exports.updateCustomer = exports.searchCustomers = exports.listInvoices = exports.issueInvoice = exports.getInvoiceXml = exports.getInvoiceSetupStatus = exports.getInvoicePdf = exports.getInvoice = exports.getCustomer = exports.createCustomer = exports.createCreditNote = exports.cancelInvoice = exports.rechnungFeldFehler = exports.rechnungFehlerCode = exports.istRechnungFehler = exports.rechnungKeyAuth = exports.createRechnungApi = void 0;
 var api_js_1 = require("./api.js");
 Object.defineProperty(exports, "createRechnungApi", { enumerable: true, get: function () { return api_js_1.createRechnungApi; } });
 var auth_js_1 = require("./auth.js");
@@ -28,6 +28,7 @@ Object.defineProperty(exports, "createCustomer", { enumerable: true, get: functi
 Object.defineProperty(exports, "getCustomer", { enumerable: true, get: function () { return endpunkte_js_1.getCustomer; } });
 Object.defineProperty(exports, "getInvoice", { enumerable: true, get: function () { return endpunkte_js_1.getInvoice; } });
 Object.defineProperty(exports, "getInvoicePdf", { enumerable: true, get: function () { return endpunkte_js_1.getInvoicePdf; } });
+Object.defineProperty(exports, "getInvoiceSetupStatus", { enumerable: true, get: function () { return endpunkte_js_1.getInvoiceSetupStatus; } });
 Object.defineProperty(exports, "getInvoiceXml", { enumerable: true, get: function () { return endpunkte_js_1.getInvoiceXml; } });
 Object.defineProperty(exports, "issueInvoice", { enumerable: true, get: function () { return endpunkte_js_1.issueInvoice; } });
 Object.defineProperty(exports, "listInvoices", { enumerable: true, get: function () { return endpunkte_js_1.listInvoices; } });
@@ -45,6 +46,7 @@ Object.defineProperty(exports, "CUSTOMER_TYPES", { enumerable: true, get: functi
 Object.defineProperty(exports, "INVOICE_LIST_STATUS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_LIST_STATUS; } });
 Object.defineProperty(exports, "DOC_TYPES", { enumerable: true, get: function () { return vertrag_js_1.DOC_TYPES; } });
 Object.defineProperty(exports, "EINVOICE_FORMATS", { enumerable: true, get: function () { return vertrag_js_1.EINVOICE_FORMATS; } });
+Object.defineProperty(exports, "INVOICE_SETUP_REQUIREMENTS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_SETUP_REQUIREMENTS; } });
 Object.defineProperty(exports, "KUNDE_FELDER", { enumerable: true, get: function () { return vertrag_js_1.KUNDE_FELDER; } });
 Object.defineProperty(exports, "POSITION_FELDER", { enumerable: true, get: function () { return vertrag_js_1.POSITION_FELDER; } });
 Object.defineProperty(exports, "RECHNUNG_ANFRAGEN", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_ANFRAGEN; } });

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

@@ -5,7 +5,7 @@
  * Betraege sind ueberall ganze Cent. Datumsangaben sind `YYYY-MM-DD` nach
  * Wiener Kalender.
  */
-import type { CreditNoteReason, CustomerType, DocType, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
+import type { CreditNoteReason, CustomerType, DocType, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
 export interface CustomerInput {
     type: CustomerType;
     name: string;
@@ -222,3 +222,17 @@ export interface CreditNoteResult {
     remainingCents: number;
     replayed: boolean;
 }
+/** Ein Punkt, der vor dem Ausstellen noch fehlt. */
+export interface InvoiceSetupGap {
+    requirement: InvoiceSetupRequirement;
+    /** Was fehlt und wo es nachzutragen ist — fuer einen Menschen formuliert. */
+    message: string;
+}
+export interface InvoiceSetupStatus {
+    /** `true`: Rechnungen koennen ueber die API ausgestellt werden. */
+    ready: boolean;
+    /** Umgebung des Schluessels (`kr_live_…` bzw. `kr_test_…`). */
+    environment: 'live' | 'test';
+    /** Was fehlt, in der Reihenfolge von `INVOICE_SETUP_REQUIREMENTS` — leer, wenn `ready`. */
+    missing: InvoiceSetupGap[];
+}

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

@@ -18,13 +18,13 @@
  * Nummer, Summen — ist bewusst **nicht** setzbar.
  */
 export declare const RECHNUNG_VERTRAG_VERSION = 1;
-export declare const RECHNUNG_AUFRUFE: readonly ["createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml"];
+export declare const RECHNUNG_AUFRUFE: readonly ["createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus"];
 export type RechnungAufruf = (typeof RECHNUNG_AUFRUFE)[number];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
  * aendern. `validation` traegt zusaetzlich `errors: [{ field, message }]`.
  */
-export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete"];
+export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete"];
 export type InvoiceErrorCode = (typeof INVOICE_ERROR_CODES)[number];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 export declare const CREDIT_NOTE_REASONS: readonly ["cancellation", "price_reduction", "return", "incorrect_invoice", "other"];
@@ -43,6 +43,21 @@ export declare const DOC_TYPES: readonly ["RE", "GU"];
 export type DocType = (typeof DOC_TYPES)[number];
 export declare const EINVOICE_FORMATS: readonly ["ubl", "cii"];
 export type EInvoiceFormat = (typeof EINVOICE_FORMATS)[number];
+/**
+ * Was erfuellt sein muss, bevor ueber die API ausgestellt werden darf — in
+ * dieser Reihenfolge meldet `getInvoiceSetupStatus`, was fehlt, und dieselben
+ * Schluessel stehen in `invoice_setup_incomplete`.
+ *
+ * - `module_active`  Modul Rechnung aktiv
+ * - `api_enabled`    Rechnungs-API fuer das Konto von Kasseneck freigegeben (nur live)
+ * - `live_enabled`   Konto live freigeschaltet (nur live)
+ * - `business_name`, `address`, `vat_id`  Pflichtangaben des Ausstellers (§ 11 UStG;
+ *   `vat_id` entfaellt bei Kleinunternehmern)
+ * - `bank_account`   IBAN und Kontoinhaber
+ * - `number_format`  Rechnungsnummern-Format bewusst gespeichert
+ */
+export declare const INVOICE_SETUP_REQUIREMENTS: readonly ["module_active", "api_enabled", "live_enabled", "business_name", "address", "vat_id", "bank_account", "number_format"];
+export type InvoiceSetupRequirement = (typeof INVOICE_SETUP_REQUIREMENTS)[number];
 /** Formate, die der Server mit `@kreiseck/validator` bzw. einem Muster prueft. */
 export type Format = 'email' | 'phone' | 'vatId' | 'country' | 'date' | 'shortCode';
 export type Feld = {

package/dist/cjs/rechnung/vertrag.js

@@ -19,7 +19,7 @@
  * Nummer, Summen — ist bewusst **nicht** setzbar.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = void 0;
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = void 0;
 exports.RECHNUNG_VERTRAG_VERSION = 1;
 exports.RECHNUNG_AUFRUFE = [
     'createCustomer',
@@ -33,6 +33,7 @@ exports.RECHNUNG_AUFRUFE = [
     'listInvoices',
     'getInvoicePdf',
     'getInvoiceXml',
+    'getInvoiceSetupStatus',
 ];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
@@ -54,6 +55,8 @@ exports.INVOICE_ERROR_CODES = [
     'partial_credit_exists',
     'credit_exceeds_invoice',
     'einvoice_incomplete',
+    'invoice_api_not_enabled',
+    'invoice_setup_incomplete',
 ];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 exports.CREDIT_NOTE_REASONS = [
@@ -70,6 +73,29 @@ exports.CUSTOMER_TYPES = ['private', 'company'];
 exports.INVOICE_LIST_STATUS = ['final', 'paid', 'cancelled', 'open', 'overdue'];
 exports.DOC_TYPES = ['RE', 'GU'];
 exports.EINVOICE_FORMATS = ['ubl', 'cii'];
+/**
+ * Was erfuellt sein muss, bevor ueber die API ausgestellt werden darf — in
+ * dieser Reihenfolge meldet `getInvoiceSetupStatus`, was fehlt, und dieselben
+ * Schluessel stehen in `invoice_setup_incomplete`.
+ *
+ * - `module_active`  Modul Rechnung aktiv
+ * - `api_enabled`    Rechnungs-API fuer das Konto von Kasseneck freigegeben (nur live)
+ * - `live_enabled`   Konto live freigeschaltet (nur live)
+ * - `business_name`, `address`, `vat_id`  Pflichtangaben des Ausstellers (§ 11 UStG;
+ *   `vat_id` entfaellt bei Kleinunternehmern)
+ * - `bank_account`   IBAN und Kontoinhaber
+ * - `number_format`  Rechnungsnummern-Format bewusst gespeichert
+ */
+exports.INVOICE_SETUP_REQUIREMENTS = [
+    'module_active',
+    'api_enabled',
+    'live_enabled',
+    'business_name',
+    'address',
+    'vat_id',
+    'bank_account',
+    'number_format',
+];
 const text = (max, pflicht = false, extra = {}) => ({ typ: 'string', pflicht, max, ...(pflicht && extra.min === undefined ? { min: 1 } : {}), ...extra });
 const idempotencyKey = (pflicht) => ({ typ: 'string', pflicht, min: 1, max: 120 });
 const id = { typ: 'string', pflicht: false, min: 1, max: 128 };
@@ -179,6 +205,7 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
         invoiceId: idPflicht,
         format: { typ: 'enum', pflicht: false, werte: exports.EINVOICE_FORMATS },
     },
+    getInvoiceSetupStatus: {},
 });
 /** Genau eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */
 exports.RECHNUNG_GENAU_EINS = Object.freeze({

package/dist/esm/client/aufrufe.d.ts

@@ -13,7 +13,7 @@
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
 import type { TransportBodyFields } from './transport.js';
-export declare const AUFRUFE: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook"];
+export declare const AUFRUFE: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook"];
 export type Aufruf = typeof AUFRUFE[number];
 /** Wie [KasseneckTransport], nur mit bekanntem Aufrufnamen. Nicht exportiert nach aussen. */
 export type InternerTransport = <T = unknown>(functionName: Aufruf, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;

package/dist/esm/client/aufrufe.js

@@ -23,6 +23,7 @@ export const AUFRUFE = [
     'getFirstReceiptDate',
     'getInvoice',
     'getInvoicePdf',
+    'getInvoiceSetupStatus',
     'getInvoiceXml',
     'getKasseSettings',
     'getPartnerCustomer',

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

@@ -6,7 +6,7 @@
  */
 import { type FetchLike } from '../client/transport.js';
 import type { EInvoiceFormat } from './vertrag.js';
-import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
 export interface RechnungApiOptions {
     /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
     apiKey: string;
@@ -39,5 +39,7 @@ export interface RechnungApi {
     listInvoices(abfrage?: InvoiceListQuery): Promise<InvoicePage>;
     getInvoicePdf(invoiceId: string): Promise<Uint8Array>;
     getInvoiceXml(invoiceId: string, format?: EInvoiceFormat): Promise<string>;
+    /** Darf dieses Konto ausstellen, und was fehlt noch? Laeuft auch ohne Freigabe. */
+    getInvoiceSetupStatus(): Promise<InvoiceSetupStatus>;
 }
 export declare function createRechnungApi(optionen: RechnungApiOptions): RechnungApi;

package/dist/esm/rechnung/api.js

@@ -6,7 +6,7 @@
  */
 import { createBinaryTransport, createTransport } from '../client/transport.js';
 import { rechnungKeyAuth } from './auth.js';
-import { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
+import { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
 export function createRechnungApi(optionen) {
     const transportOptionen = {
         auth: rechnungKeyAuth({ apiKey: optionen.apiKey }),
@@ -28,5 +28,6 @@ export function createRechnungApi(optionen) {
         listInvoices: (abfrage) => listInvoices(rufen, abfrage),
         getInvoicePdf: (id) => getInvoicePdf(rufenBinaer, id),
         getInvoiceXml: (id, format) => getInvoiceXml(rufen, id, format),
+        getInvoiceSetupStatus: () => getInvoiceSetupStatus(rufen),
     };
 }

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

@@ -18,7 +18,7 @@
  */
 import type { InternerBinaerTransport, InternerTransport } from '../client/aufrufe.js';
 import type { EInvoiceFormat } from './vertrag.js';
-import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
 export declare function createCustomer(rufen: InternerTransport, customer: CustomerInput, optionen?: {
     idempotencyKey?: string;
 }): Promise<Customer>;
@@ -38,6 +38,12 @@ export declare function getInvoice(rufen: InternerTransport, kennung: {
     number: string;
 }): Promise<InvoiceDetail>;
 export declare function listInvoices(rufen: InternerTransport, abfrage?: InvoiceListQuery): Promise<InvoicePage>;
+/**
+ * Darf dieses Konto ueber die API ausstellen, und was fehlt noch? Laeuft auch
+ * ohne Freigabe und vor der Live-Freischaltung — genau dann braucht man die
+ * Antwort. Vor dem ersten `issueInvoice` aufrufen und `missing` anzeigen.
+ */
+export declare function getInvoiceSetupStatus(rufen: InternerTransport): Promise<InvoiceSetupStatus>;
 /** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
 export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string): Promise<Uint8Array>;
 /**

package/dist/esm/rechnung/endpunkte.js

@@ -96,6 +96,23 @@ export async function listInvoices(rufen, abfrage = {}) {
     const { eintraege, nextCursor } = seite('listInvoices', daten, 'invoices');
     return { invoices: eintraege, nextCursor };
 }
+// ---- Freigabe und Einrichtung ---------------------------------------------------
+/**
+ * Darf dieses Konto ueber die API ausstellen, und was fehlt noch? Laeuft auch
+ * ohne Freigabe und vor der Live-Freischaltung — genau dann braucht man die
+ * Antwort. Vor dem ersten `issueInvoice` aufrufen und `missing` anzeigen.
+ */
+export async function getInvoiceSetupStatus(rufen) {
+    const daten = objekt(await rufen('getInvoiceSetupStatus', {}));
+    if (typeof daten['ready'] !== 'boolean' || !Array.isArray(daten['missing'])) {
+        throw new KasseneckValidationError('getInvoiceSetupStatus', 'Antwort ohne ready/missing', 'response');
+    }
+    return {
+        ready: daten['ready'],
+        environment: daten['environment'] === 'test' ? 'test' : 'live',
+        missing: daten['missing'],
+    };
+}
 // ---- Dateien ----------------------------------------------------------------
 /** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
 export function getInvoicePdf(rufenBinaer, invoiceId) {

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

@@ -13,6 +13,6 @@
 export { createRechnungApi, type RechnungApi, type RechnungApiOptions } from './api.js';
 export { rechnungKeyAuth, type RechnungKeyAuthOptions } from './auth.js';
 export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, type RechnungFeldFehler, } from './fehler.js';
-export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
-export type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceTotals, IssueInvoiceRequest, IssueResult, } from './typen.js';
-export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type Format, type Feld, } from './vertrag.js';
+export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
+export type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, IssueInvoiceRequest, IssueResult, } from './typen.js';
+export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/esm/rechnung/index.js

@@ -13,5 +13,5 @@
 export { createRechnungApi } from './api.js';
 export { rechnungKeyAuth } from './auth.js';
 export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, } from './fehler.js';
-export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
-export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';
+export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
+export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';

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

@@ -5,7 +5,7 @@
  * Betraege sind ueberall ganze Cent. Datumsangaben sind `YYYY-MM-DD` nach
  * Wiener Kalender.
  */
-import type { CreditNoteReason, CustomerType, DocType, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
+import type { CreditNoteReason, CustomerType, DocType, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
 export interface CustomerInput {
     type: CustomerType;
     name: string;
@@ -222,3 +222,17 @@ export interface CreditNoteResult {
     remainingCents: number;
     replayed: boolean;
 }
+/** Ein Punkt, der vor dem Ausstellen noch fehlt. */
+export interface InvoiceSetupGap {
+    requirement: InvoiceSetupRequirement;
+    /** Was fehlt und wo es nachzutragen ist — fuer einen Menschen formuliert. */
+    message: string;
+}
+export interface InvoiceSetupStatus {
+    /** `true`: Rechnungen koennen ueber die API ausgestellt werden. */
+    ready: boolean;
+    /** Umgebung des Schluessels (`kr_live_…` bzw. `kr_test_…`). */
+    environment: 'live' | 'test';
+    /** Was fehlt, in der Reihenfolge von `INVOICE_SETUP_REQUIREMENTS` — leer, wenn `ready`. */
+    missing: InvoiceSetupGap[];
+}

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

@@ -18,13 +18,13 @@
  * Nummer, Summen — ist bewusst **nicht** setzbar.
  */
 export declare const RECHNUNG_VERTRAG_VERSION = 1;
-export declare const RECHNUNG_AUFRUFE: readonly ["createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml"];
+export declare const RECHNUNG_AUFRUFE: readonly ["createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus"];
 export type RechnungAufruf = (typeof RECHNUNG_AUFRUFE)[number];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
  * aendern. `validation` traegt zusaetzlich `errors: [{ field, message }]`.
  */
-export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete"];
+export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete"];
 export type InvoiceErrorCode = (typeof INVOICE_ERROR_CODES)[number];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 export declare const CREDIT_NOTE_REASONS: readonly ["cancellation", "price_reduction", "return", "incorrect_invoice", "other"];
@@ -43,6 +43,21 @@ export declare const DOC_TYPES: readonly ["RE", "GU"];
 export type DocType = (typeof DOC_TYPES)[number];
 export declare const EINVOICE_FORMATS: readonly ["ubl", "cii"];
 export type EInvoiceFormat = (typeof EINVOICE_FORMATS)[number];
+/**
+ * Was erfuellt sein muss, bevor ueber die API ausgestellt werden darf — in
+ * dieser Reihenfolge meldet `getInvoiceSetupStatus`, was fehlt, und dieselben
+ * Schluessel stehen in `invoice_setup_incomplete`.
+ *
+ * - `module_active`  Modul Rechnung aktiv
+ * - `api_enabled`    Rechnungs-API fuer das Konto von Kasseneck freigegeben (nur live)
+ * - `live_enabled`   Konto live freigeschaltet (nur live)
+ * - `business_name`, `address`, `vat_id`  Pflichtangaben des Ausstellers (§ 11 UStG;
+ *   `vat_id` entfaellt bei Kleinunternehmern)
+ * - `bank_account`   IBAN und Kontoinhaber
+ * - `number_format`  Rechnungsnummern-Format bewusst gespeichert
+ */
+export declare const INVOICE_SETUP_REQUIREMENTS: readonly ["module_active", "api_enabled", "live_enabled", "business_name", "address", "vat_id", "bank_account", "number_format"];
+export type InvoiceSetupRequirement = (typeof INVOICE_SETUP_REQUIREMENTS)[number];
 /** Formate, die der Server mit `@kreiseck/validator` bzw. einem Muster prueft. */
 export type Format = 'email' | 'phone' | 'vatId' | 'country' | 'date' | 'shortCode';
 export type Feld = {

package/dist/esm/rechnung/vertrag.js

@@ -30,6 +30,7 @@ export const RECHNUNG_AUFRUFE = [
     'listInvoices',
     'getInvoicePdf',
     'getInvoiceXml',
+    'getInvoiceSetupStatus',
 ];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
@@ -51,6 +52,8 @@ export const INVOICE_ERROR_CODES = [
     'partial_credit_exists',
     'credit_exceeds_invoice',
     'einvoice_incomplete',
+    'invoice_api_not_enabled',
+    'invoice_setup_incomplete',
 ];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 export const CREDIT_NOTE_REASONS = [
@@ -67,6 +70,29 @@ export const CUSTOMER_TYPES = ['private', 'company'];
 export const INVOICE_LIST_STATUS = ['final', 'paid', 'cancelled', 'open', 'overdue'];
 export const DOC_TYPES = ['RE', 'GU'];
 export const EINVOICE_FORMATS = ['ubl', 'cii'];
+/**
+ * Was erfuellt sein muss, bevor ueber die API ausgestellt werden darf — in
+ * dieser Reihenfolge meldet `getInvoiceSetupStatus`, was fehlt, und dieselben
+ * Schluessel stehen in `invoice_setup_incomplete`.
+ *
+ * - `module_active`  Modul Rechnung aktiv
+ * - `api_enabled`    Rechnungs-API fuer das Konto von Kasseneck freigegeben (nur live)
+ * - `live_enabled`   Konto live freigeschaltet (nur live)
+ * - `business_name`, `address`, `vat_id`  Pflichtangaben des Ausstellers (§ 11 UStG;
+ *   `vat_id` entfaellt bei Kleinunternehmern)
+ * - `bank_account`   IBAN und Kontoinhaber
+ * - `number_format`  Rechnungsnummern-Format bewusst gespeichert
+ */
+export const INVOICE_SETUP_REQUIREMENTS = [
+    'module_active',
+    'api_enabled',
+    'live_enabled',
+    'business_name',
+    'address',
+    'vat_id',
+    'bank_account',
+    'number_format',
+];
 const text = (max, pflicht = false, extra = {}) => ({ typ: 'string', pflicht, max, ...(pflicht && extra.min === undefined ? { min: 1 } : {}), ...extra });
 const idempotencyKey = (pflicht) => ({ typ: 'string', pflicht, min: 1, max: 120 });
 const id = { typ: 'string', pflicht: false, min: 1, max: 128 };
@@ -176,6 +202,7 @@ export const RECHNUNG_ANFRAGEN = Object.freeze({
         invoiceId: idPflicht,
         format: { typ: 'enum', pflicht: false, werte: EINVOICE_FORMATS },
     },
+    getInvoiceSetupStatus: {},
 });
 /** Genau eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */
 export const RECHNUNG_GENAU_EINS = Object.freeze({

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.15.0",
+  "version": "0.16.0",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.15.0",
+  "version": "0.16.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.15.0",
+  "version": "0.16.0",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",
@@ -25,6 +25,7 @@
     "getFirstReceiptDate",
     "getInvoice",
     "getInvoicePdf",
+    "getInvoiceSetupStatus",
     "getInvoiceXml",
     "getKasseSettings",
     "getPartnerCustomer",
@@ -395,7 +396,9 @@
       "not_cancellable",
       "partial_credit_exists",
       "credit_exceeds_invoice",
-      "einvoice_incomplete"
+      "einvoice_incomplete",
+      "invoice_api_not_enabled",
+      "invoice_setup_incomplete"
     ],
     "invoiceListStatus": [
       "final",
@@ -404,6 +407,16 @@
       "open",
       "overdue"
     ],
+    "invoiceSetupRequirements": [
+      "module_active",
+      "api_enabled",
+      "live_enabled",
+      "business_name",
+      "address",
+      "vat_id",
+      "bank_account",
+      "number_format"
+    ],
     "priceModes": [
       "net",
       "gross"
@@ -419,7 +432,8 @@
       "getInvoice",
       "listInvoices",
       "getInvoicePdf",
-      "getInvoiceXml"
+      "getInvoiceXml",
+      "getInvoiceSetupStatus"
     ],
     "taxSchemes": [
       "normal",

package/fixtures/rechnung-api-beispiele/setup-status-fehler-feld.json

@@ -0,0 +1,14 @@
+{
+  "aufruf": "getInvoiceSetupStatus",
+  "beschreibung": "Der Status kennt keine Parameter",
+  "anfrage": {
+    "environment": "live"
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "environment"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/setup-status-ok.json

@@ -0,0 +1,8 @@
+{
+  "aufruf": "getInvoiceSetupStatus",
+  "beschreibung": "Einrichtung abfragen, ohne Parameter",
+  "anfrage": {},
+  "erwartet": {
+    "ok": true
+  }
+}

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.15.0",
+  "paket": "0.16.0",
   "aufrufe": {
     "createCustomer": {
       "anfrage": {
@@ -643,6 +643,13 @@
         ],
         "additionalProperties": false
       }
+    },
+    "getInvoiceSetupStatus": {
+      "anfrage": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      }
     }
   },
   "codes": [
@@ -660,7 +667,9 @@
     "not_cancellable",
     "partial_credit_exists",
     "credit_exceeds_invoice",
-    "einvoice_incomplete"
+    "einvoice_incomplete",
+    "invoice_api_not_enabled",
+    "invoice_setup_incomplete"
   ],
   "gruende": [
     "cancellation",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "RKSV-Registrierkasse fuer JavaScript und TypeScript: signierte Belege, Storno, Kartenzahlung, Bondruck. Austrian fiscal cash register (RKSV) API client.",
   "license": "Apache-2.0",
   "author": "Kreiseck",