@kreiseck/kasseneck-api 0.16.0 → 0.18.0

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, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
+import type { CreditNoteReason, CustomerType, DocType, InvoiceLanguage, InvoiceNoticeCode, InvoicePaymentMethod, InvoiceUnit, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
 export interface CustomerInput {
     type: CustomerType;
     name: string;
@@ -27,6 +27,8 @@ export interface CustomerInput {
     note?: string;
     /** Kennung im eigenen System; je Konto eindeutig. */
     externalId?: string;
+    /** Sprache der Rechnungen an diesen Kunden; fehlt = `de`. Behoerden immer `de`. */
+    language?: InvoiceLanguage;
 }
 export interface Customer {
     id: string;
@@ -45,6 +47,7 @@ export interface Customer {
     isAuthority: boolean;
     note: string | null;
     externalId: string | null;
+    language: InvoiceLanguage;
     createdAt: string | null;
     updatedAt: string | null;
 }
@@ -66,7 +69,8 @@ export interface InvoiceItemInput {
     subtitle?: string;
     /** Hoechstens drei Nachkommastellen. */
     quantity: number;
-    unit?: string;
+    /** Einheit aus `INVOICE_UNITS`; ohne Angabe `piece`. */
+    unit?: InvoiceUnit;
     /** Einzelpreis in ganzen Cent, im `priceMode` der Rechnung (netto oder brutto). */
     unitPriceCents: number;
     vatRate: VatRatePercent;
@@ -94,6 +98,53 @@ export interface IssueInvoiceRequest {
     items: InvoiceItemInput[];
     /** Eigene Merkmale (hoechstens 20), nie gedruckt. */
     metadata?: Record<string, string>;
+    /** Sprache dieser Rechnung; sonst die des Kunden, sonst `de`. Eine Rechnung, eine Nummer, eine Sprache. */
+    language?: InvoiceLanguage;
+    /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. Unbekannt = `brand_not_found`. */
+    brandId?: string;
+    /**
+     * Schon bezahlt (Shop kassiert online, Rechnung folgt). Die Zahlung entsteht
+     * in derselben Transaktion wie das Festschreiben: das PDF traegt dann keine
+     * Zahlungsinformationen und keinen Giro-QR.
+     */
+    payment?: PaymentInput;
+}
+/** Eine Zahlung, wie das Fremdsystem sie meldet. */
+export interface PaymentInput {
+    method: InvoicePaymentMethod;
+    /** Ohne Angabe der volle Bruttobetrag. */
+    amountCents?: number;
+    /** Ohne Angabe der heutige Wiener Tag; nie in der Zukunft. */
+    paidAt?: string;
+    /** Zahlungskennung des Fremdsystems — gespeichert, aber nicht gedruckt. */
+    reference?: string;
+}
+export interface RecordPaymentRequest extends PaymentInput {
+    /** Pflicht: ohne ihn bucht eine Wiederholung eine zweite Zahlung. */
+    idempotencyKey: string;
+    invoiceId: string;
+}
+/** Eine gebuchte Zahlung, wie die API sie zurueckgibt. */
+export interface InvoicePayment {
+    id: string;
+    amountCents: number;
+    paidAt: string;
+    method: InvoicePaymentMethod;
+    reference: string | null;
+}
+/**
+ * Ein Hinweis zu einer erfolgreichen Antwort — kein Fehler, sondern etwas,
+ * das der Aufrufer wissen sollte (heute nur `cash_receipt_required`).
+ */
+export interface InvoiceNotice {
+    code: InvoiceNoticeCode;
+    message: string;
+}
+export interface RecordPaymentResult {
+    invoice: Invoice;
+    payment: InvoicePayment;
+    replayed: boolean;
+    notice?: InvoiceNotice;
 }
 export interface CancelInvoiceRequest {
     idempotencyKey: string;
@@ -132,6 +183,23 @@ export interface Invoice {
     statusUrl: string | null;
     statusPassword: string | null;
     metadata: Record<string, string>;
+    /** Beim Festschreiben eingefroren; aeltere Rechnungen `de`. */
+    language: InvoiceLanguage;
+    /** Die eingefrorene Marke; `id` ist `null` bei der Ersatzmarke ohne eigene Einrichtung. */
+    brand: {
+        id: string | null;
+        name: string | null;
+    } | null;
+    /** Summe der gebuchten Zahlungen. */
+    paidCents: number;
+    /** Was noch offen ist; `0` heisst bezahlt. */
+    openCents: number;
+}
+/** Eine Marke des Kontos (Logo, Farbe, Absender) — `id` geht als `brandId` in `issueInvoice`. */
+export interface Brand {
+    id: string;
+    name: string;
+    isDefault: boolean;
 }
 export interface InvoiceRecipient {
     name: string;

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", "getInvoiceSetupStatus"];
+export declare const RECHNUNG_AUFRUFE: readonly ["createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment"];
 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 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", "language_not_allowed", "brand_not_found", "not_payable", "payment_exceeds_invoice"];
 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,43 @@ 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];
+/**
+ * Sprachen einer Rechnung. Die Sprache wird beim Festschreiben eingefroren;
+ * fehlt sie an Kunde oder Rechnung, gilt `de`. Behoerden bekommen immer `de`
+ * (`language_not_allowed`). Datum und Betraege bleiben in jeder Sprache
+ * oesterreichisch formatiert.
+ */
+export declare const INVOICE_LANGUAGES: readonly ["de", "en"];
+export type InvoiceLanguage = (typeof INVOICE_LANGUAGES)[number];
+/**
+ * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg:
+ * `cash` wird gebucht, die Antwort traegt dann zusaetzlich den Hinweis
+ * `cash_receipt_required` — eine Barzahlung ist ein Barumsatz und braucht
+ * einen Beleg (§ 132a BAO), bei Registrierkassenpflicht ueber die Kasse.
+ */
+export declare const INVOICE_PAYMENT_METHODS: readonly ["transfer", "card", "online", "cash"];
+export type InvoicePaymentMethod = (typeof INVOICE_PAYMENT_METHODS)[number];
+/**
+ * Hinweise, die eine erfolgreiche Antwort zusaetzlich tragen kann (`data.notice`).
+ * Sie sind keine Fehler: der Aufruf hat gewirkt, es gibt nur etwas zu wissen.
+ */
+export declare const INVOICE_NOTICE_CODES: readonly ["cash_receipt_required"];
+export type InvoiceNoticeCode = (typeof INVOICE_NOTICE_CODES)[number];
+/**
+ * Einheiten einer Position. Die API nimmt nur diese Schluessel an; gedruckt
+ * wird das Kuerzel in der Sprache der Rechnung (`RECHNUNG_TEXTE`,
+ * `einheit.<schluessel>`), die E-Rechnung fuehrt den UN/ECE-Code
+ * (`RECHNUNG_EINHEITEN_CODES`). Ohne Angabe gilt `piece`.
+ */
+export declare const INVOICE_UNITS: readonly ["piece", "pair", "set", "dozen", "second", "minute", "hour", "day", "night", "week", "month", "quarter", "half_year", "year", "milligram", "gram", "kilogram", "tonne", "millimetre", "centimetre", "metre", "running_metre", "kilometre", "square_metre", "hectare", "millilitre", "litre", "cubic_metre", "kilowatt_hour", "megawatt_hour", "gigabyte", "terabyte", "flat_rate", "person", "licence", "user", "device", "session", "trip", "page", "sheet", "package", "box", "carton", "bottle", "can", "roll", "bag", "pallet"];
+export type InvoiceUnit = (typeof INVOICE_UNITS)[number];
+/**
+ * UN/ECE-Code je Einheit (Recommendation 20, Verpackungen aus Recommendation 21
+ * mit `X`). Mehrere Einheiten duerfen denselben Code tragen (Meter und
+ * Laufmeter; Lizenz, Benutzer, Geraet als Stueck). Die Validatoren der
+ * E-Rechnung pruefen jeden Code im Backend (Beispiel `api-einheiten`).
+ */
+export declare const RECHNUNG_EINHEITEN_CODES: Readonly<Record<InvoiceUnit, string>>;
 /**
  * Was erfuellt sein muss, bevor ueber die API ausgestellt werden darf — in
  * dieser Reihenfolge meldet `getInvoiceSetupStatus`, was fehlt, und dieselben
@@ -106,6 +143,14 @@ export type Feld = {
 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>>;
+/**
+ * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
+ * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die
+ * Zahlungskennung des Fremdsystems (z. B. `pi_3Q...`) — sie wird gespeichert,
+ * aber **nicht gedruckt**: die Rechnung wird aufbewahrt und vervielfaeltigt,
+ * und dem Empfaenger nuetzt sie nichts.
+ */
+export declare const PAYMENT_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[])[]>>>;

package/dist/esm/rechnung/vertrag.js

@@ -31,6 +31,8 @@ export const RECHNUNG_AUFRUFE = [
     'getInvoicePdf',
     'getInvoiceXml',
     'getInvoiceSetupStatus',
+    'listBrands',
+    'recordInvoicePayment',
 ];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
@@ -54,6 +56,10 @@ export const INVOICE_ERROR_CODES = [
     'einvoice_incomplete',
     'invoice_api_not_enabled',
     'invoice_setup_incomplete',
+    'language_not_allowed',
+    'brand_not_found',
+    'not_payable',
+    'payment_exceeds_invoice',
 ];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 export const CREDIT_NOTE_REASONS = [
@@ -70,6 +76,142 @@ 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'];
+/**
+ * Sprachen einer Rechnung. Die Sprache wird beim Festschreiben eingefroren;
+ * fehlt sie an Kunde oder Rechnung, gilt `de`. Behoerden bekommen immer `de`
+ * (`language_not_allowed`). Datum und Betraege bleiben in jeder Sprache
+ * oesterreichisch formatiert.
+ */
+export const INVOICE_LANGUAGES = ['de', 'en'];
+/**
+ * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg:
+ * `cash` wird gebucht, die Antwort traegt dann zusaetzlich den Hinweis
+ * `cash_receipt_required` — eine Barzahlung ist ein Barumsatz und braucht
+ * einen Beleg (§ 132a BAO), bei Registrierkassenpflicht ueber die Kasse.
+ */
+export const INVOICE_PAYMENT_METHODS = ['transfer', 'card', 'online', 'cash'];
+/**
+ * Hinweise, die eine erfolgreiche Antwort zusaetzlich tragen kann (`data.notice`).
+ * Sie sind keine Fehler: der Aufruf hat gewirkt, es gibt nur etwas zu wissen.
+ */
+export const INVOICE_NOTICE_CODES = ['cash_receipt_required'];
+/**
+ * Einheiten einer Position. Die API nimmt nur diese Schluessel an; gedruckt
+ * wird das Kuerzel in der Sprache der Rechnung (`RECHNUNG_TEXTE`,
+ * `einheit.<schluessel>`), die E-Rechnung fuehrt den UN/ECE-Code
+ * (`RECHNUNG_EINHEITEN_CODES`). Ohne Angabe gilt `piece`.
+ */
+export const INVOICE_UNITS = [
+    'piece',
+    'pair',
+    'set',
+    'dozen',
+    'second',
+    'minute',
+    'hour',
+    'day',
+    'night',
+    'week',
+    'month',
+    'quarter',
+    'half_year',
+    'year',
+    'milligram',
+    'gram',
+    'kilogram',
+    'tonne',
+    'millimetre',
+    'centimetre',
+    'metre',
+    'running_metre',
+    'kilometre',
+    'square_metre',
+    'hectare',
+    'millilitre',
+    'litre',
+    'cubic_metre',
+    'kilowatt_hour',
+    'megawatt_hour',
+    'gigabyte',
+    'terabyte',
+    'flat_rate',
+    'person',
+    'licence',
+    'user',
+    'device',
+    'session',
+    'trip',
+    'page',
+    'sheet',
+    'package',
+    'box',
+    'carton',
+    'bottle',
+    'can',
+    'roll',
+    'bag',
+    'pallet',
+];
+/**
+ * UN/ECE-Code je Einheit (Recommendation 20, Verpackungen aus Recommendation 21
+ * mit `X`). Mehrere Einheiten duerfen denselben Code tragen (Meter und
+ * Laufmeter; Lizenz, Benutzer, Geraet als Stueck). Die Validatoren der
+ * E-Rechnung pruefen jeden Code im Backend (Beispiel `api-einheiten`).
+ */
+export const RECHNUNG_EINHEITEN_CODES = Object.freeze({
+    piece: 'C62',
+    pair: 'PR',
+    set: 'SET',
+    dozen: 'DZN',
+    second: 'SEC',
+    minute: 'MIN',
+    hour: 'HUR',
+    day: 'DAY',
+    night: 'C62',
+    week: 'WEE',
+    month: 'MON',
+    quarter: 'QAN',
+    half_year: 'SAN',
+    year: 'ANN',
+    milligram: 'MGM',
+    gram: 'GRM',
+    kilogram: 'KGM',
+    tonne: 'TNE',
+    millimetre: 'MMT',
+    centimetre: 'CMT',
+    metre: 'MTR',
+    running_metre: 'MTR',
+    kilometre: 'KMT',
+    square_metre: 'MTK',
+    // Rec 20 fuehrt fuer Hektar HAR, EN 16931 laesst davon nur H18
+    // („square hectometre", Synonym hectare) zu.
+    hectare: 'H18',
+    millilitre: 'MLT',
+    litre: 'LTR',
+    cubic_metre: 'MTQ',
+    kilowatt_hour: 'KWH',
+    megawatt_hour: 'MWH',
+    gigabyte: 'E34',
+    terabyte: 'E35',
+    flat_rate: 'LS',
+    person: 'IE',
+    licence: 'C62',
+    user: 'C62',
+    device: 'C62',
+    session: 'C62',
+    trip: 'C62',
+    page: 'ZP',
+    // Ebenso: ST („sheet") steht nicht in der Liste von EN 16931, LEF („leaf") schon.
+    sheet: 'LEF',
+    package: 'XPK',
+    box: 'XBX',
+    carton: 'XCT',
+    bottle: 'XBO',
+    can: 'XCA',
+    roll: 'XRO',
+    bag: 'XSA',
+    pallet: 'XPX',
+});
 /**
  * Was erfuellt sein muss, bevor ueber die API ausgestellt werden darf — in
  * dieser Reihenfolge meldet `getInvoiceSetupStatus`, was fehlt, und dieselben
@@ -117,6 +259,8 @@ export const KUNDE_FELDER = Object.freeze({
     isAuthority: { typ: 'boolean', pflicht: false },
     note: text(1000),
     externalId: { typ: 'string', pflicht: false, min: 1, max: 120 },
+    /** Sprache der Rechnungen an diesen Kunden; fehlt = `de`. */
+    language: { typ: 'enum', pflicht: false, werte: INVOICE_LANGUAGES },
 });
 /** Beim Aendern ist jedes Kundenfeld optional. */
 const KUNDE_PATCH = Object.freeze(Object.fromEntries(Object.entries(KUNDE_FELDER).map(([name, feld]) => [name, { ...feld, pflicht: false }])));
@@ -125,12 +269,26 @@ export const 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),
+    /** Einheit aus `INVOICE_UNITS`; ohne Angabe `piece`. */
+    unit: { typ: 'enum', pflicht: false, werte: INVOICE_UNITS },
     unitPriceCents: { typ: 'integer', pflicht: true, min: 0, max: 100_000_000 },
     vatRate: { typ: 'enum', pflicht: true, werte: 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: POSITION_FELDER } };
+/**
+ * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
+ * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die
+ * Zahlungskennung des Fremdsystems (z. B. `pi_3Q...`) — sie wird gespeichert,
+ * aber **nicht gedruckt**: die Rechnung wird aufbewahrt und vervielfaeltigt,
+ * und dem Empfaenger nuetzt sie nichts.
+ */
+export const PAYMENT_FELDER = Object.freeze({
+    method: { typ: 'enum', pflicht: true, werte: INVOICE_PAYMENT_METHODS },
+    amountCents: { typ: 'integer', pflicht: false, min: 1, max: 100_000_000 },
+    paidAt: datum(),
+    reference: text(100),
+});
 export const RECHNUNG_ANFRAGEN = Object.freeze({
     createCustomer: {
         customer: { typ: 'object', pflicht: true, felder: KUNDE_FELDER },
@@ -168,6 +326,16 @@ export const RECHNUNG_ANFRAGEN = Object.freeze({
         tracking: { typ: 'boolean', pflicht: false },
         items: positionen,
         metadata: { typ: 'map', pflicht: false, maxSchluessel: 20, schluesselMuster: '^[a-zA-Z0-9_]{1,40}$', wertMax: 500 },
+        /** Sprache dieser Rechnung; sonst die des Kunden, sonst `de`. */
+        language: { typ: 'enum', pflicht: false, werte: INVOICE_LANGUAGES },
+        /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. */
+        brandId: id,
+        /**
+         * Schon bezahlt: die Zahlung entsteht in **derselben** Transaktion wie das
+         * Festschreiben. Sonst gaebe es einen Moment, in dem die Rechnung offen ist
+         * und ein sofort geholtes PDF Zahlungsinformationen traegt.
+         */
+        payment: { typ: 'object', pflicht: false, felder: PAYMENT_FELDER },
     },
     cancelInvoice: {
         idempotencyKey: idempotencyKey(true),
@@ -197,12 +365,23 @@ export const RECHNUNG_ANFRAGEN = Object.freeze({
     },
     getInvoicePdf: {
         invoiceId: idPflicht,
+        /** Andere Sprache als die der Rechnung: gekennzeichnete Uebersetzungskopie, keine eigene Rechnung. */
+        language: { typ: 'enum', pflicht: false, werte: INVOICE_LANGUAGES },
     },
     getInvoiceXml: {
         invoiceId: idPflicht,
         format: { typ: 'enum', pflicht: false, werte: EINVOICE_FORMATS },
     },
     getInvoiceSetupStatus: {},
+    listBrands: {},
+    recordInvoicePayment: {
+        idempotencyKey: idempotencyKey(true),
+        invoiceId: idPflicht,
+        method: { typ: 'enum', pflicht: true, werte: INVOICE_PAYMENT_METHODS },
+        amountCents: { typ: 'integer', pflicht: false, min: 1, max: 100_000_000 },
+        paidAt: datum(),
+        reference: text(100),
+    },
 });
 /** 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.16.0",
+  "version": "0.18.0",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.16.0",
+  "version": "0.18.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.16.0",
+  "version": "0.18.0",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",
@@ -37,6 +37,7 @@
     "issueInvoice",
     "listCustomerCashregisters",
     "listInvoices",
+    "listBrands",
     "listMyArticleGroups",
     "listMyArticles",
     "listMyCashregisters",
@@ -49,6 +50,7 @@
     "listRegisterUsersForDevice",
     "listRegisterSessionsForDevice",
     "pairRegisterDevice",
+    "recordInvoicePayment",
     "registerPinLogin",
     "registerUserLogin",
     "renewRegisterSession",
@@ -398,7 +400,15 @@
       "credit_exceeds_invoice",
       "einvoice_incomplete",
       "invoice_api_not_enabled",
-      "invoice_setup_incomplete"
+      "invoice_setup_incomplete",
+      "language_not_allowed",
+      "brand_not_found",
+      "not_payable",
+      "payment_exceeds_invoice"
+    ],
+    "invoiceLanguages": [
+      "de",
+      "en"
     ],
     "invoiceListStatus": [
       "final",
@@ -407,6 +417,15 @@
       "open",
       "overdue"
     ],
+    "invoiceNoticeCodes": [
+      "cash_receipt_required"
+    ],
+    "invoicePaymentMethods": [
+      "transfer",
+      "card",
+      "online",
+      "cash"
+    ],
     "invoiceSetupRequirements": [
       "module_active",
       "api_enabled",
@@ -417,6 +436,57 @@
       "bank_account",
       "number_format"
     ],
+    "invoiceUnits": [
+      "piece",
+      "pair",
+      "set",
+      "dozen",
+      "second",
+      "minute",
+      "hour",
+      "day",
+      "night",
+      "week",
+      "month",
+      "quarter",
+      "half_year",
+      "year",
+      "milligram",
+      "gram",
+      "kilogram",
+      "tonne",
+      "millimetre",
+      "centimetre",
+      "metre",
+      "running_metre",
+      "kilometre",
+      "square_metre",
+      "hectare",
+      "millilitre",
+      "litre",
+      "cubic_metre",
+      "kilowatt_hour",
+      "megawatt_hour",
+      "gigabyte",
+      "terabyte",
+      "flat_rate",
+      "person",
+      "licence",
+      "user",
+      "device",
+      "session",
+      "trip",
+      "page",
+      "sheet",
+      "package",
+      "box",
+      "carton",
+      "bottle",
+      "can",
+      "roll",
+      "bag",
+      "pallet"
+    ],
     "priceModes": [
       "net",
       "gross"
@@ -433,7 +503,9 @@
       "listInvoices",
       "getInvoicePdf",
       "getInvoiceXml",
-      "getInvoiceSetupStatus"
+      "getInvoiceSetupStatus",
+      "listBrands",
+      "recordInvoicePayment"
     ],
     "taxSchemes": [
       "normal",

package/fixtures/rechnung-api-beispiele/brands-ok.json

@@ -0,0 +1,8 @@
+{
+  "aufruf": "listBrands",
+  "beschreibung": "Marken ohne Parameter",
+  "anfrage": {},
+  "erwartet": {
+    "ok": true
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-bezahlt.json

@@ -0,0 +1,32 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Shop kassiert per Karte, Rechnung entsteht bezahlt",
+  "anfrage": {
+    "idempotencyKey": "bsp-bezahlt",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-16",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 2,
+        "unitPriceCents": 5000,
+        "vatRate": 20,
+        "unit": "hour"
+      }
+    ],
+    "payment": {
+      "method": "card",
+      "reference": "pi_3QbeispielXYZ"
+    }
+  },
+  "erwartet": {
+    "ok": true,
+    "totals": {
+      "netCents": 10000,
+      "vatCents": 2000,
+      "grossCents": 12000
+    }
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-englisch.json

@@ -0,0 +1,30 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Englische Rechnung mit gewählter Marke",
+  "anfrage": {
+    "idempotencyKey": "bsp-en-1",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-15",
+    "language": "en",
+    "brandId": "marke_beispiel",
+    "items": [
+      {
+        "description": "Consulting",
+        "quantity": 2,
+        "unitPriceCents": 5000,
+        "vatRate": 20,
+        "unit": "hour"
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true,
+    "totals": {
+      "netCents": 10000,
+      "vatCents": 2000,
+      "grossCents": 12000
+    }
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-fehler-einheit.json

@@ -0,0 +1,26 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Einheit als freier Text statt Schlüssel",
+  "anfrage": {
+    "idempotencyKey": "bsp-einheit",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-15",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 2,
+        "unit": "Std",
+        "unitPriceCents": 5000,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].unit"
+    ]
+  }
+}