@kreiseck/kasseneck-api 0.17.0 → 0.18.0

package/CHANGELOG.md

@@ -4,6 +4,36 @@ 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.18.0
+
+### Rechnungs-API: bezahlte Rechnung und Zahlungen nachtragen
+
+**Anlass:** Die API wird vor allem von Online-Shops benutzt, die **vor** der
+Rechnung kassieren. Bisher entstand immer eine offene Rechnung — mit Giro-QR
+und Fälligkeit auf dem Blatt, obwohl das Geld längst da war.
+
+- `issueInvoice` nimmt `payment` (`method`, optional `amountCents`, `paidAt`,
+  `reference`). Die Zahlung entsteht in **derselben** Transaktion wie das
+  Festschreiben; ohne `amountCents` gilt der volle Bruttobetrag.
+- Neuer Aufruf `recordInvoicePayment` für später eintreffende Zahlungen, mit
+  **pflichtigem** `idempotencyKey` — ohne ihn bucht ein Wiederholungslauf nach
+  einem Zeitlimit eine zweite Zahlung.
+- `INVOICE_PAYMENT_METHODS` (`transfer`, `card`, `online`, `cash`);
+  `Invoice.paidCents` und `Invoice.openCents`.
+- Neue Fehlercodes `not_payable` (storniert oder Gutschrift) und
+  `payment_exceeds_invoice` (mit `remainingCents`).
+- Neu: **Hinweise** an einer erfolgreichen Antwort (`INVOICE_NOTICE_CODES`,
+  `data.notice`). Bisheriger Fall: `cash_receipt_required`. Grund: eine
+  Barzahlung ist ein Barumsatz und braucht einen Beleg (§ 132a BAO), bei
+  Registrierkassenpflicht über die Registrierkasse — der Bezahlt-Vermerk ist
+  Buchhaltung und ersetzt ihn nicht. Die Rechnung selbst ist bei jeder
+  Zahlungsart erlaubt (§ 11 UStG), deshalb wird `cash` gebucht und nicht
+  abgewiesen.
+
+`reference` wird gespeichert, aber nicht gedruckt: die Rechnung wird sieben
+Jahre aufbewahrt und vervielfältigt, und dem Empfänger nützt die Zahlungs-ID
+des Shops nichts.
+
 ## 0.17.0
 
 ### Rechnungs-API: Sprache (de/en) und Marke je Rechnung

package/README.md

@@ -524,6 +524,32 @@ bzw. `pcs` —, und die E-Rechnung trägt den UN/ECE-Code aus
 `RECHNUNG_EINHEITEN_CODES` (`C62`, `HUR`, …). Freier Text wie `"Std"` ist
 `validation` mit Feld `items[0].unit`.
 
+**Schon bezahlt?** Wer online kassiert und danach die Rechnung stellt, gibt die
+Zahlung gleich mit: sie entsteht in derselben Transaktion wie das Festschreiben,
+und das PDF trägt dann keinen Zahlungskasten und keinen Giro-QR.
+
+```ts
+const { invoice } = await rechnungen.issueInvoice({
+  idempotencyKey: `bestellung-${bestellnummer}`,
+  customerId: kunde.id,
+  taxScheme: 'normal', priceMode: 'net', serviceStart: '2026-09-16',
+  items: [{ description: 'Beratung', quantity: 2, unitPriceCents: 5000, vatRate: 20, unit: 'hour' }],
+  payment: { method: 'card', reference: zahlung.id },      // ohne amountCents: voll bezahlt
+});                                                        // invoice.openCents === 0
+
+// Trifft das Geld erst später ein (Überweisung, Teilzahlung):
+await rechnungen.recordInvoicePayment({
+  idempotencyKey: `zahlung-${zahlung.id}`,                 // Pflicht: sonst bucht eine Wiederholung zweimal
+  invoiceId: invoice.id, method: 'transfer', amountCents: 12000, paidAt: '2026-09-20',
+});
+```
+
+`reference` wird gespeichert, aber **nicht gedruckt**; Kartendaten gehören
+ohnehin nicht auf eine Rechnung. Bei `method: 'cash'` wird die Zahlung gebucht
+und die Antwort trägt zusätzlich `notice.code = 'cash_receipt_required'`: eine
+Barzahlung ist ein Barumsatz und braucht einen Beleg (§ 132a BAO), bei
+Registrierkassenpflicht über die Kasse — der Vermerk hier ersetzt ihn nicht.
+
 **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", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "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", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "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

@@ -51,6 +51,7 @@ exports.AUFRUFE = [
     'listRegisterUsersForDevice',
     'listRegisterSessionsForDevice',
     'pairRegisterDevice',
+    'recordInvoicePayment',
     'registerPinLogin',
     'registerUserLogin',
     'renewRegisterSession',

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

@@ -6,7 +6,7 @@
  */
 import { type FetchLike } from '../client/transport.js';
 import type { EInvoiceFormat, InvoiceLanguage } from './vertrag.js';
-import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
 export interface RechnungApiOptions {
     /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
     apiKey: string;
@@ -37,6 +37,8 @@ export interface RechnungApi {
         number: string;
     }): Promise<InvoiceDetail>;
     listInvoices(abfrage?: InvoiceListQuery): Promise<InvoicePage>;
+    /** Eine spaeter eingetroffene Zahlung nachtragen; `idempotencyKey` ist Pflicht. */
+    recordInvoicePayment(anfrage: RecordPaymentRequest): Promise<RecordPaymentResult>;
     /** Mit `language` ungleich der Rechnungssprache: gekennzeichnete Uebersetzungskopie. */
     getInvoicePdf(invoiceId: string, optionen?: {
         language?: InvoiceLanguage;

package/dist/cjs/rechnung/api.js

@@ -32,6 +32,7 @@ function createRechnungApi(optionen) {
         getInvoicePdf: (id, o) => (0, endpunkte_js_1.getInvoicePdf)(rufenBinaer, id, o),
         getInvoiceXml: (id, format) => (0, endpunkte_js_1.getInvoiceXml)(rufen, id, format),
         getInvoiceSetupStatus: () => (0, endpunkte_js_1.getInvoiceSetupStatus)(rufen),
+        recordInvoicePayment: (anfrage) => (0, endpunkte_js_1.recordInvoicePayment)(rufen, anfrage),
         listBrands: () => (0, endpunkte_js_1.listBrands)(rufen),
     };
 }

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

@@ -18,7 +18,7 @@
  */
 import type { InternerBinaerTransport, InternerTransport } from '../client/aufrufe.js';
 import type { EInvoiceFormat, InvoiceLanguage } from './vertrag.js';
-import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
 export declare function createCustomer(rufen: InternerTransport, customer: CustomerInput, optionen?: {
     idempotencyKey?: string;
 }): Promise<Customer>;
@@ -53,6 +53,16 @@ export declare function getInvoiceSetupStatus(rufen: InternerTransport): Promise
 export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string, optionen?: {
     language?: InvoiceLanguage;
 }): Promise<Uint8Array>;
+/**
+ * Eine Zahlung nachtragen, die nach dem Ausstellen eingetroffen ist
+ * (Ueberweisung, Teilzahlung). Der `idempotencyKey` ist Pflicht: ohne ihn
+ * bucht ein Wiederholungslauf nach einem Zeitlimit eine zweite Zahlung.
+ *
+ * Bei `method: 'cash'` wird die Zahlung gebucht und die Antwort traegt
+ * zusaetzlich `notice` — eine Barzahlung ist ein Barumsatz und braucht einen
+ * Beleg (§ 132a BAO), den dieser Vermerk nicht ersetzt.
+ */
+export declare function recordInvoicePayment(rufen: InternerTransport, anfrage: RecordPaymentRequest): Promise<RecordPaymentResult>;
 /** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */
 export declare function listBrands(rufen: InternerTransport): Promise<Brand[]>;
 /**

package/dist/cjs/rechnung/endpunkte.js

@@ -29,6 +29,7 @@ exports.getInvoice = getInvoice;
 exports.listInvoices = listInvoices;
 exports.getInvoiceSetupStatus = getInvoiceSetupStatus;
 exports.getInvoicePdf = getInvoicePdf;
+exports.recordInvoicePayment = recordInvoicePayment;
 exports.listBrands = listBrands;
 exports.getInvoiceXml = getInvoiceXml;
 const errors_js_1 = require("../client/errors.js");
@@ -141,6 +142,27 @@ function getInvoicePdf(rufenBinaer, invoiceId, optionen = {}) {
         params['language'] = optionen.language;
     return rufenBinaer('getInvoicePdf', params);
 }
+/**
+ * Eine Zahlung nachtragen, die nach dem Ausstellen eingetroffen ist
+ * (Ueberweisung, Teilzahlung). Der `idempotencyKey` ist Pflicht: ohne ihn
+ * bucht ein Wiederholungslauf nach einem Zeitlimit eine zweite Zahlung.
+ *
+ * Bei `method: 'cash'` wird die Zahlung gebucht und die Antwort traegt
+ * zusaetzlich `notice` — eine Barzahlung ist ein Barumsatz und braucht einen
+ * Beleg (§ 132a BAO), den dieser Vermerk nicht ersetzt.
+ */
+async function recordInvoicePayment(rufen, anfrage) {
+    const daten = await rufen('recordInvoicePayment', nutzlast(anfrage));
+    const roh = objekt(daten);
+    const ergebnis = {
+        invoice: pflichtObjekt('recordInvoicePayment', daten, 'invoice'),
+        payment: pflichtObjekt('recordInvoicePayment', daten, 'payment'),
+        replayed: roh['replayed'] === true,
+    };
+    if (roh['notice'])
+        ergebnis.notice = roh['notice'];
+    return ergebnis;
+}
 /** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */
 async function listBrands(rufen) {
     const brands = objekt(await rufen('listBrands', {}))['brands'];

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

@@ -13,7 +13,7 @@
 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, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
-export type { Brand, 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 { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
+export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceNotice, InvoicePayment, IssueInvoiceRequest, IssueResult, PaymentInput, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
 export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.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_LANGUAGES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, 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 InvoiceLanguage, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.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_LANGUAGES, INVOICE_PAYMENT_METHODS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, 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 InvoiceLanguage, type InvoicePaymentMethod, type InvoiceNoticeCode, type InvoiceUnit, 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.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_LANGUAGES = 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.rechnungText = exports.RECHNUNG_TEXTE = exports.updateCustomer = exports.searchCustomers = exports.listInvoices = exports.listBrands = 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;
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = 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.rechnungText = exports.RECHNUNG_TEXTE = exports.updateCustomer = exports.searchCustomers = exports.recordInvoicePayment = exports.listInvoices = exports.listBrands = 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");
@@ -33,6 +33,7 @@ Object.defineProperty(exports, "getInvoiceXml", { enumerable: true, get: functio
 Object.defineProperty(exports, "issueInvoice", { enumerable: true, get: function () { return endpunkte_js_1.issueInvoice; } });
 Object.defineProperty(exports, "listBrands", { enumerable: true, get: function () { return endpunkte_js_1.listBrands; } });
 Object.defineProperty(exports, "listInvoices", { enumerable: true, get: function () { return endpunkte_js_1.listInvoices; } });
+Object.defineProperty(exports, "recordInvoicePayment", { enumerable: true, get: function () { return endpunkte_js_1.recordInvoicePayment; } });
 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 texte_js_1 = require("./texte.js");
@@ -51,6 +52,8 @@ Object.defineProperty(exports, "INVOICE_LIST_STATUS", { enumerable: true, get: f
 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_LANGUAGES", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_LANGUAGES; } });
+Object.defineProperty(exports, "INVOICE_PAYMENT_METHODS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_PAYMENT_METHODS; } });
+Object.defineProperty(exports, "INVOICE_NOTICE_CODES", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_NOTICE_CODES; } });
 Object.defineProperty(exports, "INVOICE_UNITS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_UNITS; } });
 Object.defineProperty(exports, "RECHNUNG_EINHEITEN_CODES", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_EINHEITEN_CODES; } });
 Object.defineProperty(exports, "INVOICE_SETUP_REQUIREMENTS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_SETUP_REQUIREMENTS; } });

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, InvoiceLanguage, InvoiceUnit, 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;
@@ -102,6 +102,49 @@ export interface IssueInvoiceRequest {
     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;
@@ -147,6 +190,10 @@ export interface Invoice {
         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 {

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", "getInvoiceSetupStatus", "listBrands"];
+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", "language_not_allowed", "brand_not_found"];
+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"];
@@ -51,6 +51,20 @@ export type EInvoiceFormat = (typeof EINVOICE_FORMATS)[number];
  */
 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`,
@@ -129,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/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.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_LANGUAGES = 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.PAYMENT_FELDER = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = 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',
@@ -35,6 +35,7 @@ exports.RECHNUNG_AUFRUFE = [
     'getInvoiceXml',
     'getInvoiceSetupStatus',
     'listBrands',
+    'recordInvoicePayment',
 ];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
@@ -60,6 +61,8 @@ exports.INVOICE_ERROR_CODES = [
     'invoice_setup_incomplete',
     'language_not_allowed',
     'brand_not_found',
+    'not_payable',
+    'payment_exceeds_invoice',
 ];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 exports.CREDIT_NOTE_REASONS = [
@@ -83,6 +86,18 @@ exports.EINVOICE_FORMATS = ['ubl', 'cii'];
  * oesterreichisch formatiert.
  */
 exports.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.
+ */
+exports.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.
+ */
+exports.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`,
@@ -264,6 +279,19 @@ exports.POSITION_FELDER = Object.freeze({
     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 } };
+/**
+ * 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.
+ */
+exports.PAYMENT_FELDER = Object.freeze({
+    method: { typ: 'enum', pflicht: true, werte: exports.INVOICE_PAYMENT_METHODS },
+    amountCents: { typ: 'integer', pflicht: false, min: 1, max: 100_000_000 },
+    paidAt: datum(),
+    reference: text(100),
+});
 exports.RECHNUNG_ANFRAGEN = Object.freeze({
     createCustomer: {
         customer: { typ: 'object', pflicht: true, felder: exports.KUNDE_FELDER },
@@ -305,6 +333,12 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
         language: { typ: 'enum', pflicht: false, werte: exports.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: exports.PAYMENT_FELDER },
     },
     cancelInvoice: {
         idempotencyKey: idempotencyKey(true),
@@ -343,6 +377,14 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
     },
     getInvoiceSetupStatus: {},
     listBrands: {},
+    recordInvoicePayment: {
+        idempotencyKey: idempotencyKey(true),
+        invoiceId: idPflicht,
+        method: { typ: 'enum', pflicht: true, werte: exports.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). */
 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", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "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", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "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

@@ -48,6 +48,7 @@ export const AUFRUFE = [
     'listRegisterUsersForDevice',
     'listRegisterSessionsForDevice',
     'pairRegisterDevice',
+    'recordInvoicePayment',
     'registerPinLogin',
     'registerUserLogin',
     'renewRegisterSession',

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

@@ -6,7 +6,7 @@
  */
 import { type FetchLike } from '../client/transport.js';
 import type { EInvoiceFormat, InvoiceLanguage } from './vertrag.js';
-import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
 export interface RechnungApiOptions {
     /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
     apiKey: string;
@@ -37,6 +37,8 @@ export interface RechnungApi {
         number: string;
     }): Promise<InvoiceDetail>;
     listInvoices(abfrage?: InvoiceListQuery): Promise<InvoicePage>;
+    /** Eine spaeter eingetroffene Zahlung nachtragen; `idempotencyKey` ist Pflicht. */
+    recordInvoicePayment(anfrage: RecordPaymentRequest): Promise<RecordPaymentResult>;
     /** Mit `language` ungleich der Rechnungssprache: gekennzeichnete Uebersetzungskopie. */
     getInvoicePdf(invoiceId: string, optionen?: {
         language?: InvoiceLanguage;

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, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
+import { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
 export function createRechnungApi(optionen) {
     const transportOptionen = {
         auth: rechnungKeyAuth({ apiKey: optionen.apiKey }),
@@ -29,6 +29,7 @@ export function createRechnungApi(optionen) {
         getInvoicePdf: (id, o) => getInvoicePdf(rufenBinaer, id, o),
         getInvoiceXml: (id, format) => getInvoiceXml(rufen, id, format),
         getInvoiceSetupStatus: () => getInvoiceSetupStatus(rufen),
+        recordInvoicePayment: (anfrage) => recordInvoicePayment(rufen, anfrage),
         listBrands: () => listBrands(rufen),
     };
 }

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

@@ -18,7 +18,7 @@
  */
 import type { InternerBinaerTransport, InternerTransport } from '../client/aufrufe.js';
 import type { EInvoiceFormat, InvoiceLanguage } from './vertrag.js';
-import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
 export declare function createCustomer(rufen: InternerTransport, customer: CustomerInput, optionen?: {
     idempotencyKey?: string;
 }): Promise<Customer>;
@@ -53,6 +53,16 @@ export declare function getInvoiceSetupStatus(rufen: InternerTransport): Promise
 export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string, optionen?: {
     language?: InvoiceLanguage;
 }): Promise<Uint8Array>;
+/**
+ * Eine Zahlung nachtragen, die nach dem Ausstellen eingetroffen ist
+ * (Ueberweisung, Teilzahlung). Der `idempotencyKey` ist Pflicht: ohne ihn
+ * bucht ein Wiederholungslauf nach einem Zeitlimit eine zweite Zahlung.
+ *
+ * Bei `method: 'cash'` wird die Zahlung gebucht und die Antwort traegt
+ * zusaetzlich `notice` — eine Barzahlung ist ein Barumsatz und braucht einen
+ * Beleg (§ 132a BAO), den dieser Vermerk nicht ersetzt.
+ */
+export declare function recordInvoicePayment(rufen: InternerTransport, anfrage: RecordPaymentRequest): Promise<RecordPaymentResult>;
 /** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */
 export declare function listBrands(rufen: InternerTransport): Promise<Brand[]>;
 /**

package/dist/esm/rechnung/endpunkte.js

@@ -126,6 +126,27 @@ export function getInvoicePdf(rufenBinaer, invoiceId, optionen = {}) {
         params['language'] = optionen.language;
     return rufenBinaer('getInvoicePdf', params);
 }
+/**
+ * Eine Zahlung nachtragen, die nach dem Ausstellen eingetroffen ist
+ * (Ueberweisung, Teilzahlung). Der `idempotencyKey` ist Pflicht: ohne ihn
+ * bucht ein Wiederholungslauf nach einem Zeitlimit eine zweite Zahlung.
+ *
+ * Bei `method: 'cash'` wird die Zahlung gebucht und die Antwort traegt
+ * zusaetzlich `notice` — eine Barzahlung ist ein Barumsatz und braucht einen
+ * Beleg (§ 132a BAO), den dieser Vermerk nicht ersetzt.
+ */
+export async function recordInvoicePayment(rufen, anfrage) {
+    const daten = await rufen('recordInvoicePayment', nutzlast(anfrage));
+    const roh = objekt(daten);
+    const ergebnis = {
+        invoice: pflichtObjekt('recordInvoicePayment', daten, 'invoice'),
+        payment: pflichtObjekt('recordInvoicePayment', daten, 'payment'),
+        replayed: roh['replayed'] === true,
+    };
+    if (roh['notice'])
+        ergebnis.notice = roh['notice'];
+    return ergebnis;
+}
 /** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */
 export async function listBrands(rufen) {
     const brands = objekt(await rufen('listBrands', {}))['brands'];

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

@@ -13,7 +13,7 @@
 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, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
-export type { Brand, 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 { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
+export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceNotice, InvoicePayment, IssueInvoiceRequest, IssueResult, PaymentInput, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
 export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.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_LANGUAGES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, 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 InvoiceLanguage, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.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_LANGUAGES, INVOICE_PAYMENT_METHODS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, 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 InvoiceLanguage, type InvoicePaymentMethod, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/esm/rechnung/index.js

@@ -13,6 +13,6 @@
 export { createRechnungApi } from './api.js';
 export { rechnungKeyAuth } from './auth.js';
 export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, } from './fehler.js';
-export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
+export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
 export { RECHNUNG_TEXTE, rechnungText } from './texte.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_LANGUAGES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.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_LANGUAGES, INVOICE_PAYMENT_METHODS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, 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, InvoiceLanguage, InvoiceUnit, 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;
@@ -102,6 +102,49 @@ export interface IssueInvoiceRequest {
     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;
@@ -147,6 +190,10 @@ export interface Invoice {
         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 {

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", "listBrands"];
+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", "language_not_allowed", "brand_not_found"];
+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"];
@@ -51,6 +51,20 @@ export type EInvoiceFormat = (typeof EINVOICE_FORMATS)[number];
  */
 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`,
@@ -129,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

@@ -32,6 +32,7 @@ export const RECHNUNG_AUFRUFE = [
     'getInvoiceXml',
     'getInvoiceSetupStatus',
     'listBrands',
+    'recordInvoicePayment',
 ];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
@@ -57,6 +58,8 @@ export const INVOICE_ERROR_CODES = [
     '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 = [
@@ -80,6 +83,18 @@ export const EINVOICE_FORMATS = ['ubl', 'cii'];
  * 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`,
@@ -261,6 +276,19 @@ export const POSITION_FELDER = Object.freeze({
     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 },
@@ -302,6 +330,12 @@ export const RECHNUNG_ANFRAGEN = Object.freeze({
         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),
@@ -340,6 +374,14 @@ export const RECHNUNG_ANFRAGEN = Object.freeze({
     },
     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.17.0",
+  "version": "0.18.0",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.17.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.17.0",
+  "version": "0.18.0",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",
@@ -50,6 +50,7 @@
     "listRegisterUsersForDevice",
     "listRegisterSessionsForDevice",
     "pairRegisterDevice",
+    "recordInvoicePayment",
     "registerPinLogin",
     "registerUserLogin",
     "renewRegisterSession",
@@ -401,7 +402,9 @@
       "invoice_api_not_enabled",
       "invoice_setup_incomplete",
       "language_not_allowed",
-      "brand_not_found"
+      "brand_not_found",
+      "not_payable",
+      "payment_exceeds_invoice"
     ],
     "invoiceLanguages": [
       "de",
@@ -414,6 +417,15 @@
       "open",
       "overdue"
     ],
+    "invoiceNoticeCodes": [
+      "cash_receipt_required"
+    ],
+    "invoicePaymentMethods": [
+      "transfer",
+      "card",
+      "online",
+      "cash"
+    ],
     "invoiceSetupRequirements": [
       "module_active",
       "api_enabled",
@@ -492,7 +504,8 @@
       "getInvoicePdf",
       "getInvoiceXml",
       "getInvoiceSetupStatus",
-      "listBrands"
+      "listBrands",
+      "recordInvoicePayment"
     ],
     "taxSchemes": [
       "normal",

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-fehler-zahlungsart.json

@@ -0,0 +1,26 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Unbekannte Zahlungsart",
+  "anfrage": {
+    "idempotencyKey": "bsp-zahlungsart",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-16",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 1,
+        "unitPriceCents": 5000,
+        "vatRate": 20
+      }
+    ],
+    "payment": {
+      "method": "bitcoin"
+    }
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": ["payment.method"]
+  }
+}

package/fixtures/rechnung-api-beispiele/zahlung-fehler-ohne-schluessel.json

@@ -0,0 +1,14 @@
+{
+  "aufruf": "recordInvoicePayment",
+  "beschreibung": "Ohne Idempotenz-Schluessel — eine Wiederholung wuerde zweimal buchen",
+  "anfrage": {
+    "invoiceId": "rechnung_beispiel",
+    "method": "transfer",
+    "amountCents": 12000
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": ["idempotencyKey"]
+  }
+}

package/fixtures/rechnung-api-beispiele/zahlung-nachtrag.json

@@ -0,0 +1,14 @@
+{
+  "aufruf": "recordInvoicePayment",
+  "beschreibung": "Ueberweisung trifft spaeter ein",
+  "anfrage": {
+    "idempotencyKey": "bsp-zahlung-1",
+    "invoiceId": "rechnung_beispiel",
+    "method": "transfer",
+    "amountCents": 12000,
+    "paidAt": "2026-09-20"
+  },
+  "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.17.0",
+  "paket": "0.18.0",
   "aufrufe": {
     "createCustomer": {
       "anfrage": {
@@ -464,6 +464,38 @@
             "type": "string",
             "minLength": 1,
             "maxLength": 128
+          },
+          "payment": {
+            "type": "object",
+            "properties": {
+              "method": {
+                "enum": [
+                  "transfer",
+                  "card",
+                  "online",
+                  "cash"
+                ]
+              },
+              "amountCents": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 100000000
+              },
+              "paidAt": {
+                "type": "string",
+                "minLength": 10,
+                "maxLength": 10,
+                "format": "date"
+              },
+              "reference": {
+                "type": "string",
+                "maxLength": 100
+              }
+            },
+            "required": [
+              "method"
+            ],
+            "additionalProperties": false
           }
         },
         "required": [
@@ -784,6 +816,52 @@
         "properties": {},
         "additionalProperties": false
       }
+    },
+    "recordInvoicePayment": {
+      "anfrage": {
+        "type": "object",
+        "properties": {
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120
+          },
+          "invoiceId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "method": {
+            "enum": [
+              "transfer",
+              "card",
+              "online",
+              "cash"
+            ]
+          },
+          "amountCents": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100000000
+          },
+          "paidAt": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 10,
+            "format": "date"
+          },
+          "reference": {
+            "type": "string",
+            "maxLength": 100
+          }
+        },
+        "required": [
+          "idempotencyKey",
+          "invoiceId",
+          "method"
+        ],
+        "additionalProperties": false
+      }
     }
   },
   "codes": [
@@ -805,7 +883,9 @@
     "invoice_api_not_enabled",
     "invoice_setup_incomplete",
     "language_not_allowed",
-    "brand_not_found"
+    "brand_not_found",
+    "not_payable",
+    "payment_exceeds_invoice"
   ],
   "gruende": [
     "cancellation",

package/fixtures/rechnung-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.17.0",
+  "version": "0.18.0",
   "sprachen": [
     "de",
     "en"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.17.0",
+  "version": "0.18.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",