@kreiseck/kasseneck-api 0.14.0 → 0.15.0

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

@@ -0,0 +1,224 @@
+/**
+ * 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, 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;
+}

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,98 @@
+/**
+ * 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"];
+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 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];
+/** 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,191 @@
+"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.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',
+];
+/**
+ * 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',
+];
+/** 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'];
+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 },
+    },
+});
+/** 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", "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

@@ -1,6 +1,9 @@
 export const AUFRUFE = [
     'activateCashregister',
+    'cancelInvoice',
     'cancelReceipt',
+    'createCreditNote',
+    'createCustomer',
     'createCustomerCashregister',
     'createPartnerCustomer',
     'checkPartnerCustomerEmail',
@@ -14,9 +17,13 @@ export const AUFRUFE = [
     'endRegisterSession',
     'financeWebService',
     'generateFullReceiptId',
+    'getCustomer',
     'getCustomerCredentials',
     'getCustomerSignatureStatus',
     'getFirstReceiptDate',
+    'getInvoice',
+    'getInvoicePdf',
+    'getInvoiceXml',
     'getKasseSettings',
     'getPartnerCustomer',
     'getPartnerInfo',
@@ -24,7 +31,9 @@ export const AUFRUFE = [
     'getReceipt',
     'hobexPayApi',
     'hobexRefundApi',
+    'issueInvoice',
     'listCustomerCashregisters',
+    'listInvoices',
     'listMyArticleGroups',
     'listMyArticles',
     'listMyCashregisters',
@@ -41,6 +50,7 @@ export const AUFRUFE = [
     'registerUserLogin',
     'renewRegisterSession',
     'requestCustomerSignature',
+    'searchCustomers',
     'sendPartnerCustomerFonLink',
     'sendPartnerWebhookTest',
     'sendReceiptEmail',
@@ -49,5 +59,6 @@ export const AUFRUFE = [
     'stripeCaptureIntent',
     'unpairRegisterDevice',
     'rotatePartnerWebhookSecret',
+    'updateCustomer',
     'updatePartnerWebhook',
 ];

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

@@ -0,0 +1,43 @@
+/**
+ * Fassade ueber den Aufrufen der Rechnungs-API: Schluessel einmal binden, dann rufen.
+ *
+ * Wie [createPartnerApi] bewusst **keine** Klasse — die Aufrufe sind freie
+ * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
+ */
+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';
+export interface RechnungApiOptions {
+    /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
+    apiKey: string;
+    /** Abweichende Basis-URL; Vorgabe `https://api.kasseneck.at/v1`. */
+    baseUrl?: string;
+    /** Zeitlimit je Aufruf in Millisekunden. */
+    timeoutMs?: number;
+    /** Eigene `fetch`-Umsetzung (Tests, Proxys). */
+    fetch?: FetchLike;
+}
+export interface RechnungApi {
+    createCustomer(customer: CustomerInput, optionen?: {
+        idempotencyKey?: string;
+    }): Promise<Customer>;
+    getCustomer(kennung: {
+        customerId: string;
+    } | {
+        externalId: string;
+    }): Promise<Customer>;
+    updateCustomer(customerId: string, patch: Partial<CustomerInput>): Promise<Customer>;
+    searchCustomers(suche: CustomerSearch): Promise<CustomerPage>;
+    issueInvoice(anfrage: IssueInvoiceRequest): Promise<IssueResult>;
+    cancelInvoice(anfrage: CancelInvoiceRequest): Promise<CancelResult>;
+    createCreditNote(anfrage: CreditNoteRequest): Promise<CreditNoteResult>;
+    getInvoice(kennung: {
+        invoiceId: string;
+    } | {
+        number: string;
+    }): Promise<InvoiceDetail>;
+    listInvoices(abfrage?: InvoiceListQuery): Promise<InvoicePage>;
+    getInvoicePdf(invoiceId: string): Promise<Uint8Array>;
+    getInvoiceXml(invoiceId: string, format?: EInvoiceFormat): Promise<string>;
+}
+export declare function createRechnungApi(optionen: RechnungApiOptions): RechnungApi;

package/dist/esm/rechnung/api.js

@@ -0,0 +1,32 @@
+/**
+ * Fassade ueber den Aufrufen der Rechnungs-API: Schluessel einmal binden, dann rufen.
+ *
+ * Wie [createPartnerApi] bewusst **keine** Klasse — die Aufrufe sind freie
+ * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
+ */
+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';
+export function createRechnungApi(optionen) {
+    const transportOptionen = {
+        auth: rechnungKeyAuth({ apiKey: optionen.apiKey }),
+        baseUrl: optionen.baseUrl,
+        timeoutMs: optionen.timeoutMs,
+        fetch: optionen.fetch,
+    };
+    const rufen = createTransport(transportOptionen);
+    const rufenBinaer = createBinaryTransport(transportOptionen);
+    return {
+        createCustomer: (customer, o) => createCustomer(rufen, customer, o),
+        getCustomer: (kennung) => getCustomer(rufen, kennung),
+        updateCustomer: (id, patch) => updateCustomer(rufen, id, patch),
+        searchCustomers: (suche) => searchCustomers(rufen, suche),
+        issueInvoice: (anfrage) => issueInvoice(rufen, anfrage),
+        cancelInvoice: (anfrage) => cancelInvoice(rufen, anfrage),
+        createCreditNote: (anfrage) => createCreditNote(rufen, anfrage),
+        getInvoice: (kennung) => getInvoice(rufen, kennung),
+        listInvoices: (abfrage) => listInvoices(rufen, abfrage),
+        getInvoicePdf: (id) => getInvoicePdf(rufenBinaer, id),
+        getInvoiceXml: (id, format) => getInvoiceXml(rufen, id, format),
+    };
+}