@kreiseck/kasseneck-api 0.14.0 → 0.16.0

package/dist/cjs/rechnung/index.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * `@kreiseck/kasseneck-api/rechnung` — Rechnungen (§ 11 UStG, keine Belege)
+ * und Kunden ueber die Rechnungs-API.
+ *
+ * Ein eigener Unterpfad wie `partner`: der `api_key` eines Kontos, mit dem
+ * Rechnungen ausgestellt werden, gehoert auf einen **Server** und soll nicht
+ * versehentlich in ein Browser-Buendel der Kasse wandern.
+ *
+ * Die Beschreibung der Endpunkte steht in der Referenz des Backends
+ * (`docs/api/rechnungen.md`). Was hier steht, ist der Vertrag als Daten und die
+ * 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.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");
+Object.defineProperty(exports, "rechnungKeyAuth", { enumerable: true, get: function () { return auth_js_1.rechnungKeyAuth; } });
+var fehler_js_1 = require("./fehler.js");
+Object.defineProperty(exports, "istRechnungFehler", { enumerable: true, get: function () { return fehler_js_1.istRechnungFehler; } });
+Object.defineProperty(exports, "rechnungFehlerCode", { enumerable: true, get: function () { return fehler_js_1.rechnungFehlerCode; } });
+Object.defineProperty(exports, "rechnungFeldFehler", { enumerable: true, get: function () { return fehler_js_1.rechnungFeldFehler; } });
+var endpunkte_js_1 = require("./endpunkte.js");
+Object.defineProperty(exports, "cancelInvoice", { enumerable: true, get: function () { return endpunkte_js_1.cancelInvoice; } });
+Object.defineProperty(exports, "createCreditNote", { enumerable: true, get: function () { return endpunkte_js_1.createCreditNote; } });
+Object.defineProperty(exports, "createCustomer", { enumerable: true, get: function () { return endpunkte_js_1.createCustomer; } });
+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; } });
+Object.defineProperty(exports, "searchCustomers", { enumerable: true, get: function () { return endpunkte_js_1.searchCustomers; } });
+Object.defineProperty(exports, "updateCustomer", { enumerable: true, get: function () { return endpunkte_js_1.updateCustomer; } });
+var vertrag_js_1 = require("./vertrag.js");
+Object.defineProperty(exports, "RECHNUNG_VERTRAG_VERSION", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_VERTRAG_VERSION; } });
+Object.defineProperty(exports, "RECHNUNG_AUFRUFE", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_AUFRUFE; } });
+Object.defineProperty(exports, "INVOICE_ERROR_CODES", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_ERROR_CODES; } });
+Object.defineProperty(exports, "CREDIT_NOTE_REASONS", { enumerable: true, get: function () { return vertrag_js_1.CREDIT_NOTE_REASONS; } });
+Object.defineProperty(exports, "TAX_SCHEMES", { enumerable: true, get: function () { return vertrag_js_1.TAX_SCHEMES; } });
+Object.defineProperty(exports, "PRICE_MODES", { enumerable: true, get: function () { return vertrag_js_1.PRICE_MODES; } });
+Object.defineProperty(exports, "VAT_RATES", { enumerable: true, get: function () { return vertrag_js_1.VAT_RATES; } });
+Object.defineProperty(exports, "CUSTOMER_TYPES", { enumerable: true, get: function () { return vertrag_js_1.CUSTOMER_TYPES; } });
+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; } });
+Object.defineProperty(exports, "RECHNUNG_GENAU_EINS", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_GENAU_EINS; } });
+Object.defineProperty(exports, "RECHNUNG_MINDESTENS_EINS", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_MINDESTENS_EINS; } });

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

@@ -0,0 +1,238 @@
+/**
+ * Typen der Rechnungs-API. Die Anfragen folgen `vertrag.ts` Feld fuer Feld;
+ * `test/rechnung-client.test.ts` schickt die Beispiele des Vertrags durch.
+ *
+ * Betraege sind ueberall ganze Cent. Datumsangaben sind `YYYY-MM-DD` nach
+ * Wiener Kalender.
+ */
+import type { CreditNoteReason, CustomerType, DocType, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
+export interface CustomerInput {
+    type: CustomerType;
+    name: string;
+    legalForm?: string;
+    email?: string;
+    phone?: string;
+    street?: string;
+    houseNumber?: string;
+    zip?: string;
+    city?: string;
+    /** ISO-3166-Alpha-2, z. B. `AT`. */
+    country: string;
+    /** UID-Nummer, z. B. `ATU12345678`. */
+    vatId?: string;
+    /** Kuerzel fuer die Rechnungsnummer; einmal gesetzt unveraenderlich. */
+    shortCode?: string;
+    /** Behoerde (B2G) — die E-Rechnung verlangt dann Adresse und `orderReference`. */
+    isAuthority?: boolean;
+    note?: string;
+    /** Kennung im eigenen System; je Konto eindeutig. */
+    externalId?: string;
+}
+export interface Customer {
+    id: string;
+    type: CustomerType;
+    name: string;
+    legalForm: string | null;
+    email: string | null;
+    phone: string | null;
+    street: string | null;
+    houseNumber: string | null;
+    zip: string | null;
+    city: string | null;
+    country: string;
+    vatId: string | null;
+    shortCode: string | null;
+    isAuthority: boolean;
+    note: string | null;
+    externalId: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export interface CustomerSearch {
+    externalId?: string;
+    vatId?: string;
+    email?: string;
+    /** Namensanfang, Gross-/Kleinschreibung und Akzente egal. */
+    name?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface CustomerPage {
+    customers: Customer[];
+    nextCursor: string | null;
+}
+export interface InvoiceItemInput {
+    description: string;
+    subtitle?: string;
+    /** Hoechstens drei Nachkommastellen. */
+    quantity: number;
+    unit?: string;
+    /** Einzelpreis in ganzen Cent, im `priceMode` der Rechnung (netto oder brutto). */
+    unitPriceCents: number;
+    vatRate: VatRatePercent;
+    /** Zeilenrabatt in Prozent, hoechstens zwei Nachkommastellen. */
+    discountPct?: number;
+}
+export interface IssueInvoiceRequest {
+    /** Pflicht: dieselbe Anfrage mit demselben Schluessel erzeugt nie eine zweite Rechnung. */
+    idempotencyKey: string;
+    /** Pflicht ueber 400 € brutto sowie bei Reverse Charge und ig. Lieferung. */
+    customerId?: string;
+    taxScheme: TaxScheme;
+    priceMode: PriceMode;
+    /** Leistungsdatum bzw. Beginn des Leistungszeitraums. */
+    serviceStart: string;
+    serviceEnd?: string;
+    paymentTermDays?: number;
+    orderReference?: string;
+    intro?: string;
+    note?: string;
+    /** Verwendungszweck fuer die Ueberweisung; leer = Rechnungsnummer. */
+    paymentReference?: string;
+    girocode?: boolean;
+    tracking?: boolean;
+    items: InvoiceItemInput[];
+    /** Eigene Merkmale (hoechstens 20), nie gedruckt. */
+    metadata?: Record<string, string>;
+}
+export interface CancelInvoiceRequest {
+    idempotencyKey: string;
+    invoiceId: string;
+    reason: CreditNoteReason;
+    note?: string;
+}
+export interface CreditNoteRequest extends CancelInvoiceRequest {
+    items: InvoiceItemInput[];
+}
+export interface InvoiceTotals {
+    netCents: number;
+    vatCents: number;
+    grossCents: number;
+    byRate: {
+        rate: number;
+        netCents: number;
+        vatCents: number;
+    }[];
+}
+export interface EInvoiceStatus {
+    level: string;
+    formats: string[];
+    missing: string[];
+}
+export interface Invoice {
+    id: string;
+    number: string;
+    docType: DocType;
+    status: string;
+    invoiceDate: string;
+    dueDate: string | null;
+    customerId: string | null;
+    totals: InvoiceTotals;
+    einvoice: EInvoiceStatus | null;
+    statusUrl: string | null;
+    statusPassword: string | null;
+    metadata: Record<string, string>;
+}
+export interface InvoiceRecipient {
+    name: string;
+    type: CustomerType;
+    street: string | null;
+    houseNumber: string | null;
+    zip: string | null;
+    city: string | null;
+    country: string;
+    vatId: string | null;
+    shortCode: string | null;
+    email: string | null;
+    isAuthority: boolean;
+}
+/** Eine gespeicherte Position — wie gesendet, fehlende Angaben mit ihrem Standardwert. */
+export interface InvoiceItem {
+    description: string;
+    subtitle: string;
+    quantity: number;
+    unit: string;
+    unitPriceCents: number;
+    vatRate: number;
+    discountPct: number;
+}
+export interface InvoiceDetail extends Invoice {
+    items: InvoiceItem[];
+    customer: InvoiceRecipient | null;
+    taxScheme: TaxScheme;
+    priceMode: PriceMode;
+    serviceStart: string | null;
+    serviceEnd: string | null;
+    paymentTermDays: number | null;
+    orderReference: string | null;
+    payments: {
+        amountCents: number;
+        date: string;
+        method: string;
+    }[];
+    paidCents: number;
+    openCents: number;
+    overdue: boolean;
+    writtenOff: boolean;
+    writeOffReasonCode: string | null;
+    related: {
+        invoiceId: string;
+        number: string | null;
+    } | null;
+    creditNotes: {
+        id: string;
+        number: string;
+        grossCents: number;
+    }[];
+    source: string | null;
+    createdAt: string | null;
+    finalizedAt: string | null;
+}
+export interface InvoiceListQuery {
+    from?: string;
+    to?: string;
+    status?: InvoiceListStatus;
+    docType?: DocType;
+    customerId?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface InvoicePage {
+    invoices: Invoice[];
+    nextCursor: string | null;
+}
+export interface IssueResult {
+    invoice: Invoice;
+    /** `true`, wenn die Anfrage schon einmal ausgefuehrt wurde und die bestehende Rechnung zurueckkommt. */
+    replayed: boolean;
+}
+export interface CancelResult {
+    creditNote: Invoice;
+    original: {
+        id: string;
+        status: string;
+    };
+    /** Bereits auf das Original bezahlt — die Rueckerstattung ist Sache des Betriebs. */
+    originalPaidCents: number;
+    replayed: boolean;
+}
+export interface CreditNoteResult {
+    creditNote: Invoice;
+    /** Brutto, das nach dieser Gutschrift noch gutgeschrieben werden kann. */
+    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/typen.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Typen der Rechnungs-API. Die Anfragen folgen `vertrag.ts` Feld fuer Feld;
+ * `test/rechnung-client.test.ts` schickt die Beispiele des Vertrags durch.
+ *
+ * Betraege sind ueberall ganze Cent. Datumsangaben sind `YYYY-MM-DD` nach
+ * Wiener Kalender.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,113 @@
+/**
+ * Der Vertrag der Rechnungs-API — als Daten, nicht als Prosa.
+ *
+ * Aus dieser Datei entstehen drei Dinge, damit sie nicht auseinanderlaufen
+ * koennen:
+ *
+ * 1. `fixtures/rechnung-api.schema.json` (`npm run fixtures:rechnung`) — das
+ *    Backend liest es aus dem vendorierten Paket und vergleicht es in beide
+ *    Richtungen mit seiner eigenen Pruefung; der Dart-Zwilling zieht es byteweise.
+ * 2. Die Listen unter `rechnung` in `fixtures/oberflaeche.json` (Codes, Gruende,
+ *    Enums) — ueber denselben Namensraum-Scan wie der Partner-Teil.
+ * 3. Die TypeScript-Typen in `typen.ts`.
+ *
+ * Nach aussen spricht die Schnittstelle Englisch: Feldnamen, Codes, Gruende.
+ * Deutsch bleibt, was ein Mensch liest (`message`, der Aufdruck eines Grundes).
+ *
+ * Beschrieben wird die Anfrage. Was der Server daraus macht — Rechnungsdatum,
+ * 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", "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", "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"];
+export type CreditNoteReason = (typeof CREDIT_NOTE_REASONS)[number];
+export declare const TAX_SCHEMES: readonly ["normal", "smallBusiness", "reverseCharge", "igLieferung", "exportThirdCountry"];
+export type TaxScheme = (typeof TAX_SCHEMES)[number];
+export declare const PRICE_MODES: readonly ["net", "gross"];
+export type PriceMode = (typeof PRICE_MODES)[number];
+export declare const VAT_RATES: readonly [0, 10, 13, 20];
+export type VatRatePercent = (typeof VAT_RATES)[number];
+export declare const CUSTOMER_TYPES: readonly ["private", "company"];
+export type CustomerType = (typeof CUSTOMER_TYPES)[number];
+export declare const INVOICE_LIST_STATUS: readonly ["final", "paid", "cancelled", "open", "overdue"];
+export type InvoiceListStatus = (typeof INVOICE_LIST_STATUS)[number];
+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 = {
+    typ: 'string';
+    pflicht: boolean;
+    min?: number;
+    max: number;
+    format?: Format;
+} | {
+    typ: 'integer';
+    pflicht: boolean;
+    min: number;
+    max: number;
+} | {
+    typ: 'number';
+    pflicht: boolean;
+    min: number;
+    max: number;
+    nachkomma: number;
+    exklusivMin?: boolean;
+} | {
+    typ: 'boolean';
+    pflicht: boolean;
+} | {
+    typ: 'enum';
+    pflicht: boolean;
+    werte: readonly (string | number)[];
+} | {
+    typ: 'object';
+    pflicht: boolean;
+    felder: Readonly<Record<string, Feld>>;
+} | {
+    typ: 'list';
+    pflicht: boolean;
+    min: number;
+    max: number;
+    eintrag: Feld;
+} | {
+    typ: 'map';
+    pflicht: boolean;
+    maxSchluessel: number;
+    schluesselMuster: string;
+    wertMax: number;
+};
+/** Kunde, wie das Fremdsystem ihn schickt. `vatId` ist die UID-Nummer. */
+export declare const KUNDE_FELDER: Readonly<Record<string, Feld>>;
+/** Eine Rechnungs- oder Gutschriftsposition. Preise in ganzen Cent. */
+export declare const POSITION_FELDER: Readonly<Record<string, Feld>>;
+export declare const RECHNUNG_ANFRAGEN: Readonly<Record<RechnungAufruf, Readonly<Record<string, Feld>>>>;
+/** Genau eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */
+export declare const RECHNUNG_GENAU_EINS: Readonly<Partial<Record<RechnungAufruf, readonly (readonly string[])[]>>>;
+/** Mindestens eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */
+export declare const RECHNUNG_MINDESTENS_EINS: Readonly<Partial<Record<RechnungAufruf, readonly (readonly string[])[]>>>;

package/dist/cjs/rechnung/vertrag.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * Der Vertrag der Rechnungs-API — als Daten, nicht als Prosa.
+ *
+ * Aus dieser Datei entstehen drei Dinge, damit sie nicht auseinanderlaufen
+ * koennen:
+ *
+ * 1. `fixtures/rechnung-api.schema.json` (`npm run fixtures:rechnung`) — das
+ *    Backend liest es aus dem vendorierten Paket und vergleicht es in beide
+ *    Richtungen mit seiner eigenen Pruefung; der Dart-Zwilling zieht es byteweise.
+ * 2. Die Listen unter `rechnung` in `fixtures/oberflaeche.json` (Codes, Gruende,
+ *    Enums) — ueber denselben Namensraum-Scan wie der Partner-Teil.
+ * 3. Die TypeScript-Typen in `typen.ts`.
+ *
+ * Nach aussen spricht die Schnittstelle Englisch: Feldnamen, Codes, Gruende.
+ * Deutsch bleibt, was ein Mensch liest (`message`, der Aufdruck eines Grundes).
+ *
+ * Beschrieben wird die Anfrage. Was der Server daraus macht — Rechnungsdatum,
+ * 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.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',
+    'getCustomer',
+    'updateCustomer',
+    'searchCustomers',
+    'issueInvoice',
+    'cancelInvoice',
+    'createCreditNote',
+    'getInvoice',
+    'listInvoices',
+    'getInvoicePdf',
+    'getInvoiceXml',
+    'getInvoiceSetupStatus',
+];
+/**
+ * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
+ * aendern. `validation` traegt zusaetzlich `errors: [{ field, message }]`.
+ */
+exports.INVOICE_ERROR_CODES = [
+    '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',
+];
+/** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
+exports.CREDIT_NOTE_REASONS = [
+    'cancellation',
+    'price_reduction',
+    'return',
+    'incorrect_invoice',
+    'other',
+];
+exports.TAX_SCHEMES = ['normal', 'smallBusiness', 'reverseCharge', 'igLieferung', 'exportThirdCountry'];
+exports.PRICE_MODES = ['net', 'gross'];
+exports.VAT_RATES = [0, 10, 13, 20];
+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 };
+const idPflicht = { typ: 'string', pflicht: true, min: 1, max: 128 };
+const datum = (pflicht = false) => ({ typ: 'string', pflicht, min: 10, max: 10, format: 'date' });
+const limit = { typ: 'integer', pflicht: false, min: 1, max: 100 };
+const cursor = { typ: 'string', pflicht: false, min: 1, max: 500 };
+/** Kunde, wie das Fremdsystem ihn schickt. `vatId` ist die UID-Nummer. */
+exports.KUNDE_FELDER = Object.freeze({
+    type: { typ: 'enum', pflicht: true, werte: exports.CUSTOMER_TYPES },
+    name: text(200, true),
+    legalForm: text(40),
+    email: text(254, false, { format: 'email' }),
+    phone: text(40, false, { format: 'phone' }),
+    street: text(200),
+    houseNumber: text(20),
+    zip: text(10),
+    city: text(100),
+    country: text(2, true, { min: 2, format: 'country' }),
+    vatId: text(20, false, { format: 'vatId' }),
+    shortCode: text(8, false, { format: 'shortCode' }),
+    isAuthority: { typ: 'boolean', pflicht: false },
+    note: text(1000),
+    externalId: { typ: 'string', pflicht: false, min: 1, max: 120 },
+});
+/** Beim Aendern ist jedes Kundenfeld optional. */
+const KUNDE_PATCH = Object.freeze(Object.fromEntries(Object.entries(exports.KUNDE_FELDER).map(([name, feld]) => [name, { ...feld, pflicht: false }])));
+/** Eine Rechnungs- oder Gutschriftsposition. Preise in ganzen Cent. */
+exports.POSITION_FELDER = Object.freeze({
+    description: text(300, true),
+    subtitle: text(1000),
+    quantity: { typ: 'number', pflicht: true, min: 0, exklusivMin: true, max: 1_000_000, nachkomma: 3 },
+    unit: text(20),
+    unitPriceCents: { typ: 'integer', pflicht: true, min: 0, max: 100_000_000 },
+    vatRate: { typ: 'enum', pflicht: true, werte: exports.VAT_RATES },
+    discountPct: { typ: 'number', pflicht: false, min: 0, max: 100, nachkomma: 2 },
+});
+const positionen = { typ: 'list', pflicht: true, min: 1, max: 500, eintrag: { typ: 'object', pflicht: true, felder: exports.POSITION_FELDER } };
+exports.RECHNUNG_ANFRAGEN = Object.freeze({
+    createCustomer: {
+        customer: { typ: 'object', pflicht: true, felder: exports.KUNDE_FELDER },
+        idempotencyKey: idempotencyKey(false),
+    },
+    getCustomer: {
+        customerId: id,
+        externalId: { typ: 'string', pflicht: false, min: 1, max: 120 },
+    },
+    updateCustomer: {
+        customerId: idPflicht,
+        customer: { typ: 'object', pflicht: true, felder: KUNDE_PATCH },
+    },
+    searchCustomers: {
+        externalId: { typ: 'string', pflicht: false, min: 1, max: 120 },
+        vatId: text(20),
+        email: text(254),
+        name: text(200),
+        limit,
+        cursor,
+    },
+    issueInvoice: {
+        idempotencyKey: idempotencyKey(true),
+        customerId: id,
+        taxScheme: { typ: 'enum', pflicht: true, werte: exports.TAX_SCHEMES },
+        priceMode: { typ: 'enum', pflicht: true, werte: exports.PRICE_MODES },
+        serviceStart: datum(true),
+        serviceEnd: datum(),
+        paymentTermDays: { typ: 'integer', pflicht: false, min: 0, max: 365 },
+        orderReference: text(200),
+        intro: text(2000),
+        note: text(2000),
+        paymentReference: text(140),
+        girocode: { typ: 'boolean', pflicht: false },
+        tracking: { typ: 'boolean', pflicht: false },
+        items: positionen,
+        metadata: { typ: 'map', pflicht: false, maxSchluessel: 20, schluesselMuster: '^[a-zA-Z0-9_]{1,40}$', wertMax: 500 },
+    },
+    cancelInvoice: {
+        idempotencyKey: idempotencyKey(true),
+        invoiceId: idPflicht,
+        reason: { typ: 'enum', pflicht: true, werte: exports.CREDIT_NOTE_REASONS },
+        note: text(2000),
+    },
+    createCreditNote: {
+        idempotencyKey: idempotencyKey(true),
+        invoiceId: idPflicht,
+        reason: { typ: 'enum', pflicht: true, werte: exports.CREDIT_NOTE_REASONS },
+        note: text(2000),
+        items: positionen,
+    },
+    getInvoice: {
+        invoiceId: id,
+        number: { typ: 'string', pflicht: false, min: 1, max: 100 },
+    },
+    listInvoices: {
+        from: datum(),
+        to: datum(),
+        status: { typ: 'enum', pflicht: false, werte: exports.INVOICE_LIST_STATUS },
+        docType: { typ: 'enum', pflicht: false, werte: exports.DOC_TYPES },
+        customerId: id,
+        limit,
+        cursor,
+    },
+    getInvoicePdf: {
+        invoiceId: idPflicht,
+    },
+    getInvoiceXml: {
+        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({
+    getCustomer: [['customerId', 'externalId']],
+    getInvoice: [['invoiceId', 'number']],
+});
+/** Mindestens eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */
+exports.RECHNUNG_MINDESTENS_EINS = Object.freeze({
+    searchCustomers: [['externalId', 'vatId', 'email', 'name']],
+});

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", "cancelReceipt", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "listCustomerCashregisters", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "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>;