@kreiseck/kasseneck-api 0.16.0 → 0.18.0

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.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',
@@ -34,6 +34,8 @@ exports.RECHNUNG_AUFRUFE = [
     'getInvoicePdf',
     'getInvoiceXml',
     'getInvoiceSetupStatus',
+    'listBrands',
+    'recordInvoicePayment',
 ];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
@@ -57,6 +59,10 @@ exports.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. */
 exports.CREDIT_NOTE_REASONS = [
@@ -73,6 +79,142 @@ exports.CUSTOMER_TYPES = ['private', 'company'];
 exports.INVOICE_LIST_STATUS = ['final', 'paid', 'cancelled', 'open', 'overdue'];
 exports.DOC_TYPES = ['RE', 'GU'];
 exports.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.
+ */
+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`,
+ * `einheit.<schluessel>`), die E-Rechnung fuehrt den UN/ECE-Code
+ * (`RECHNUNG_EINHEITEN_CODES`). Ohne Angabe gilt `piece`.
+ */
+exports.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`).
+ */
+exports.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
@@ -120,6 +262,8 @@ exports.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: exports.INVOICE_LANGUAGES },
 });
 /** 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 }])));
@@ -128,12 +272,26 @@ 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),
+    /** Einheit aus `INVOICE_UNITS`; ohne Angabe `piece`. */
+    unit: { typ: 'enum', pflicht: false, werte: exports.INVOICE_UNITS },
     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 } };
+/**
+ * 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 },
@@ -171,6 +329,16 @@ exports.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: 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),
@@ -200,12 +368,23 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
     },
     getInvoicePdf: {
         invoiceId: idPflicht,
+        /** Andere Sprache als die der Rechnung: gekennzeichnete Uebersetzungskopie, keine eigene Rechnung. */
+        language: { typ: 'enum', pflicht: false, werte: exports.INVOICE_LANGUAGES },
     },
     getInvoiceXml: {
         invoiceId: idPflicht,
         format: { typ: 'enum', pflicht: false, werte: exports.EINVOICE_FORMATS },
     },
     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", "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

@@ -35,6 +35,7 @@ export const AUFRUFE = [
     'issueInvoice',
     'listCustomerCashregisters',
     'listInvoices',
+    'listBrands',
     'listMyArticleGroups',
     'listMyArticles',
     'listMyCashregisters',
@@ -47,6 +48,7 @@ export const AUFRUFE = [
     'listRegisterUsersForDevice',
     'listRegisterSessionsForDevice',
     'pairRegisterDevice',
+    'recordInvoicePayment',
     'registerPinLogin',
     'registerUserLogin',
     'renewRegisterSession',

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

@@ -5,8 +5,8 @@
  * 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, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.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, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
 export interface RechnungApiOptions {
     /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
     apiKey: string;
@@ -37,9 +37,16 @@ export interface RechnungApi {
         number: string;
     }): Promise<InvoiceDetail>;
     listInvoices(abfrage?: InvoiceListQuery): Promise<InvoicePage>;
-    getInvoicePdf(invoiceId: string): Promise<Uint8Array>;
+    /** 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;
+    }): Promise<Uint8Array>;
     getInvoiceXml(invoiceId: string, format?: EInvoiceFormat): Promise<string>;
     /** Darf dieses Konto ausstellen, und was fehlt noch? Laeuft auch ohne Freigabe. */
     getInvoiceSetupStatus(): Promise<InvoiceSetupStatus>;
+    /** Die Marken des Kontos; `id` geht als `brandId` in `issueInvoice`. */
+    listBrands(): Promise<Brand[]>;
 }
 export declare function createRechnungApi(optionen: RechnungApiOptions): RechnungApi;

package/dist/esm/rechnung/api.js

@@ -6,7 +6,7 @@
  */
 import { createBinaryTransport, createTransport } from '../client/transport.js';
 import { rechnungKeyAuth } from './auth.js';
-import { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, 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 }),
@@ -26,8 +26,10 @@ export function createRechnungApi(optionen) {
         createCreditNote: (anfrage) => createCreditNote(rufen, anfrage),
         getInvoice: (kennung) => getInvoice(rufen, kennung),
         listInvoices: (abfrage) => listInvoices(rufen, abfrage),
-        getInvoicePdf: (id) => getInvoicePdf(rufenBinaer, id),
+        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

@@ -17,8 +17,8 @@
  * der Aufruf `KasseneckValidationError` mit `scope:'response'`.
  */
 import type { InternerBinaerTransport, InternerTransport } from '../client/aufrufe.js';
-import type { EInvoiceFormat } from './vertrag.js';
-import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.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, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
 export declare function createCustomer(rufen: InternerTransport, customer: CustomerInput, optionen?: {
     idempotencyKey?: string;
 }): Promise<Customer>;
@@ -44,8 +44,27 @@ export declare function listInvoices(rufen: InternerTransport, abfrage?: Invoice
  * Antwort. Vor dem ersten `issueInvoice` aufrufen und `missing` anzeigen.
  */
 export declare function getInvoiceSetupStatus(rufen: InternerTransport): Promise<InvoiceSetupStatus>;
-/** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
-export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string): Promise<Uint8Array>;
+/**
+ * Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter
+ * Factur-X-Datei. Mit `language` in der anderen Sprache als der Rechnung kommt
+ * eine **Uebersetzungskopie**: dieselbe Nummer, auf jeder Seite als Uebersetzung
+ * gekennzeichnet, ohne eingebettete E-Rechnung — keine eigene Rechnung.
+ */
+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[]>;
 /**
  * Die E-Rechnung als XML-Text. Sie kommt im gewohnten Umschlag (`data.xml`)
  * und nicht als rohe Datei: so bleibt ein fachlicher Fehler

package/dist/esm/rechnung/endpunkte.js

@@ -114,9 +114,45 @@ export async function getInvoiceSetupStatus(rufen) {
     };
 }
 // ---- Dateien ----------------------------------------------------------------
-/** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
-export function getInvoicePdf(rufenBinaer, invoiceId) {
-    return rufenBinaer('getInvoicePdf', { invoiceId });
+/**
+ * Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter
+ * Factur-X-Datei. Mit `language` in der anderen Sprache als der Rechnung kommt
+ * eine **Uebersetzungskopie**: dieselbe Nummer, auf jeder Seite als Uebersetzung
+ * gekennzeichnet, ohne eingebettete E-Rechnung — keine eigene Rechnung.
+ */
+export function getInvoicePdf(rufenBinaer, invoiceId, optionen = {}) {
+    const params = { invoiceId };
+    if (optionen.language)
+        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'];
+    if (!Array.isArray(brands))
+        throw new KasseneckValidationError('listBrands', 'Antwort ohne brands', 'response');
+    return brands;
 }
 /**
  * Die E-Rechnung als XML-Text. Sie kommt im gewohnten Umschlag (`data.xml`)

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

@@ -13,6 +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, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
-export type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, IssueInvoiceRequest, IssueResult, } from './typen.js';
-export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';
+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_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,5 +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, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
-export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';
+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_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';