@kreiseck/kasseneck-api 0.16.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +35 -0
  3. package/dist/cjs/client/aufrufe.d.ts +1 -1
  4. package/dist/cjs/client/aufrufe.js +1 -0
  5. package/dist/cjs/rechnung/api.d.ts +8 -3
  6. package/dist/cjs/rechnung/api.js +2 -1
  7. package/dist/cjs/rechnung/endpunkte.d.ts +13 -4
  8. package/dist/cjs/rechnung/endpunkte.js +19 -3
  9. package/dist/cjs/rechnung/index.d.ts +4 -3
  10. package/dist/cjs/rechnung/index.js +8 -1
  11. package/dist/cjs/rechnung/texte.d.ts +202 -0
  12. package/dist/cjs/rechnung/texte.js +377 -0
  13. package/dist/cjs/rechnung/typen.d.ts +23 -2
  14. package/dist/cjs/rechnung/vertrag.d.ts +25 -2
  15. package/dist/cjs/rechnung/vertrag.js +139 -2
  16. package/dist/esm/client/aufrufe.d.ts +1 -1
  17. package/dist/esm/client/aufrufe.js +1 -0
  18. package/dist/esm/rechnung/api.d.ts +8 -3
  19. package/dist/esm/rechnung/api.js +3 -2
  20. package/dist/esm/rechnung/endpunkte.d.ts +13 -4
  21. package/dist/esm/rechnung/endpunkte.js +18 -3
  22. package/dist/esm/rechnung/index.d.ts +4 -3
  23. package/dist/esm/rechnung/index.js +3 -2
  24. package/dist/esm/rechnung/texte.d.ts +202 -0
  25. package/dist/esm/rechnung/texte.js +373 -0
  26. package/dist/esm/rechnung/typen.d.ts +23 -2
  27. package/dist/esm/rechnung/vertrag.d.ts +25 -2
  28. package/dist/esm/rechnung/vertrag.js +138 -1
  29. package/fixtures/hobex-hps-codes.json +1 -1
  30. package/fixtures/kasse-texte.json +1 -1
  31. package/fixtures/oberflaeche.json +62 -3
  32. package/fixtures/rechnung-api-beispiele/brands-ok.json +8 -0
  33. package/fixtures/rechnung-api-beispiele/issue-englisch.json +30 -0
  34. package/fixtures/rechnung-api-beispiele/issue-fehler-einheit.json +26 -0
  35. package/fixtures/rechnung-api-beispiele/issue-fehler-sprache.json +26 -0
  36. package/fixtures/rechnung-api-beispiele/issue-netto-20.json +1 -1
  37. package/fixtures/rechnung-api.schema.json +142 -6
  38. package/fixtures/rechnung-texte.json +424 -0
  39. package/package.json +2 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,33 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
4
4
  es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
5
5
  nur der Grund überlebt den nächsten Umbau.
6
6
 
7
+ ## 0.17.0
8
+
9
+ ### Rechnungs-API: Sprache (de/en) und Marke je Rechnung
10
+
11
+ **Anlass:** Rechnungen waren fest Deutsch und trugen immer die Standardmarke.
12
+ Internationale Kunden bekamen deutsche Rechnungen, und wer mehrere Marken
13
+ führt, konnte sie über die API nicht wählen. Eine übersetzte Zweitrechnung mit
14
+ eigener Nummer wäre umsatzsteuerlich falsch (UStR Rz 1527) — deshalb eine
15
+ Sprache je Rechnung und die andere nur als gekennzeichnete Kopie (Rz 1528).
16
+
17
+ - `INVOICE_LANGUAGES` (`de`, `en`); Feld `language` am Kunden und an
18
+ `issueInvoice`, `brandId` an `issueInvoice`; `Invoice.language` und
19
+ `Invoice.brand`.
20
+ - Neuer Aufruf `listBrands()` → `[{ id, name, isDefault }]`.
21
+ - `getInvoicePdf(id, { language })`: in der anderen Sprache eine
22
+ Übersetzungskopie (gleiche Nummer, Vermerk auf jeder Seite, ohne
23
+ eingebettete E-Rechnung).
24
+ - Neue Fehlercodes `language_not_allowed` (Behörden nur Deutsch) und
25
+ `brand_not_found` (angegebene Marke gibt es nicht — kein stiller Rückfall).
26
+ - **Einheiten als Katalog:** `INVOICE_UNITS` (49 Einheiten) mit UN/ECE-Code in
27
+ `RECHNUNG_EINHEITEN_CODES`; `items[].unit` nimmt nur noch diese Schlüssel.
28
+ Gedruckt wird das Kürzel in der Sprache der Rechnung; freier Text wie `"Std"`
29
+ ist `validation`. Grund: „Stk" stand sonst auch auf englischen Rechnungen.
30
+ - Textkatalog `RECHNUNG_TEXTE` / `rechnungText()` und
31
+ `fixtures/rechnung-texte.json`: alle Texte von Rechnung, Gutschrift und
32
+ E-Rechnung in Deutsch und Englisch, Steuerhinweise mit Gesetzesstelle.
33
+
7
34
  ## 0.16.0
8
35
 
9
36
  ### Rechnungs-API: Freigabe und Einrichtung vor dem ersten Ausstellen
package/README.md CHANGED
@@ -489,6 +489,41 @@ const status = await rechnungen.getInvoiceSetupStatus();
489
489
  if (!status.ready) console.warn(status.missing.map((m) => m.message).join('\n'));
490
490
  ```
491
491
 
492
+ **Sprache und Marke.** Eine Rechnung hat eine Nummer und **eine** Sprache (`de`
493
+ oder `en`, `INVOICE_LANGUAGES`): die der Anfrage, sonst die des Kunden
494
+ (`customer.language`), sonst Deutsch. Sie wird beim Ausstellen eingefroren;
495
+ Gutschriften übernehmen Sprache und Marke ihrer Rechnung. Behörden bekommen
496
+ immer Deutsch (`language_not_allowed`). Datum und Beträge bleiben in jeder
497
+ Sprache österreichisch formatiert.
498
+
499
+ ```ts
500
+ const [marke] = await rechnungen.listBrands(); // [{ id, name, isDefault }]
501
+ const { invoice } = await rechnungen.issueInvoice({
502
+ idempotencyKey: `bestellung-${bestellnummer}`,
503
+ customerId: kunde.id,
504
+ taxScheme: 'normal', priceMode: 'net', serviceStart: '2026-09-15',
505
+ language: 'en', // sonst die Sprache des Kunden
506
+ brandId: marke.id, // sonst die Standardmarke
507
+ items: [{ description: 'Consulting', quantity: 2, unitPriceCents: 5000, vatRate: 20 }],
508
+ });
509
+ // Dieselbe Rechnung als deutsche Übersetzung — KEINE zweite Rechnung:
510
+ const kopie = await rechnungen.getInvoicePdf(invoice.id, { language: 'de' });
511
+ ```
512
+
513
+ Die Übersetzungskopie trägt dieselbe Nummer, ist auf jeder Seite als
514
+ „Übersetzung – keine eigene Rechnung" gekennzeichnet und hat keine eingebettete
515
+ E-Rechnung. Eine zweite Rechnung mit eigener Nummer für dieselbe Leistung
516
+ wäre umsatzsteuerlich ein Problem (UStR Rz 1527); die Kopie ist das nicht (Rz 1528).
517
+ Die Texte beider Sprachen liegen als `RECHNUNG_TEXTE` bzw.
518
+ `fixtures/rechnung-texte.json` im Paket.
519
+
520
+ **Einheiten sind Schlüssel, kein freier Text.** `items[].unit` nimmt einen Wert aus
521
+ `INVOICE_UNITS` (`piece`, `hour`, `day`, `flat_rate`, `kilogram`, `square_metre`, …;
522
+ ohne Angabe `piece`). Gedruckt wird das Kürzel in der Sprache der Rechnung — `Stk`
523
+ bzw. `pcs` —, und die E-Rechnung trägt den UN/ECE-Code aus
524
+ `RECHNUNG_EINHEITEN_CODES` (`C62`, `HUR`, …). Freier Text wie `"Std"` ist
525
+ `validation` mit Feld `items[0].unit`.
526
+
492
527
  **Nach einem Zeitlimit mit demselben `idempotencyKey` wiederholen**, nie mit
493
528
  einem neuen: dann kommt die schon ausgestellte Rechnung zurück
494
529
  (`replayed: true`). Derselbe Schlüssel mit anderen Daten ergibt
@@ -13,7 +13,7 @@
13
13
  * umhuellt, muss ihn weiterhin absetzen koennen.
14
14
  */
15
15
  import type { TransportBodyFields } from './transport.js';
16
- 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"];
16
+ 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"];
17
17
  export type Aufruf = typeof AUFRUFE[number];
18
18
  /** Wie [KasseneckTransport], nur mit bekanntem Aufrufnamen. Nicht exportiert nach aussen. */
19
19
  export type InternerTransport = <T = unknown>(functionName: Aufruf, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;
@@ -38,6 +38,7 @@ exports.AUFRUFE = [
38
38
  'issueInvoice',
39
39
  'listCustomerCashregisters',
40
40
  'listInvoices',
41
+ 'listBrands',
41
42
  'listMyArticleGroups',
42
43
  'listMyArticles',
43
44
  'listMyCashregisters',
@@ -5,8 +5,8 @@
5
5
  * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
6
6
  */
7
7
  import { type FetchLike } from '../client/transport.js';
8
- import type { EInvoiceFormat } from './vertrag.js';
9
- import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
8
+ import type { EInvoiceFormat, InvoiceLanguage } from './vertrag.js';
9
+ import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
10
10
  export interface RechnungApiOptions {
11
11
  /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
12
12
  apiKey: string;
@@ -37,9 +37,14 @@ export interface RechnungApi {
37
37
  number: string;
38
38
  }): Promise<InvoiceDetail>;
39
39
  listInvoices(abfrage?: InvoiceListQuery): Promise<InvoicePage>;
40
- getInvoicePdf(invoiceId: string): Promise<Uint8Array>;
40
+ /** Mit `language` ungleich der Rechnungssprache: gekennzeichnete Uebersetzungskopie. */
41
+ getInvoicePdf(invoiceId: string, optionen?: {
42
+ language?: InvoiceLanguage;
43
+ }): Promise<Uint8Array>;
41
44
  getInvoiceXml(invoiceId: string, format?: EInvoiceFormat): Promise<string>;
42
45
  /** Darf dieses Konto ausstellen, und was fehlt noch? Laeuft auch ohne Freigabe. */
43
46
  getInvoiceSetupStatus(): Promise<InvoiceSetupStatus>;
47
+ /** Die Marken des Kontos; `id` geht als `brandId` in `issueInvoice`. */
48
+ listBrands(): Promise<Brand[]>;
44
49
  }
45
50
  export declare function createRechnungApi(optionen: RechnungApiOptions): RechnungApi;
@@ -29,8 +29,9 @@ function createRechnungApi(optionen) {
29
29
  createCreditNote: (anfrage) => (0, endpunkte_js_1.createCreditNote)(rufen, anfrage),
30
30
  getInvoice: (kennung) => (0, endpunkte_js_1.getInvoice)(rufen, kennung),
31
31
  listInvoices: (abfrage) => (0, endpunkte_js_1.listInvoices)(rufen, abfrage),
32
- getInvoicePdf: (id) => (0, endpunkte_js_1.getInvoicePdf)(rufenBinaer, id),
32
+ getInvoicePdf: (id, o) => (0, endpunkte_js_1.getInvoicePdf)(rufenBinaer, id, o),
33
33
  getInvoiceXml: (id, format) => (0, endpunkte_js_1.getInvoiceXml)(rufen, id, format),
34
34
  getInvoiceSetupStatus: () => (0, endpunkte_js_1.getInvoiceSetupStatus)(rufen),
35
+ listBrands: () => (0, endpunkte_js_1.listBrands)(rufen),
35
36
  };
36
37
  }
@@ -17,8 +17,8 @@
17
17
  * der Aufruf `KasseneckValidationError` mit `scope:'response'`.
18
18
  */
19
19
  import type { InternerBinaerTransport, InternerTransport } from '../client/aufrufe.js';
20
- import type { EInvoiceFormat } from './vertrag.js';
21
- import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
20
+ import type { EInvoiceFormat, InvoiceLanguage } from './vertrag.js';
21
+ import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
22
22
  export declare function createCustomer(rufen: InternerTransport, customer: CustomerInput, optionen?: {
23
23
  idempotencyKey?: string;
24
24
  }): Promise<Customer>;
@@ -44,8 +44,17 @@ export declare function listInvoices(rufen: InternerTransport, abfrage?: Invoice
44
44
  * Antwort. Vor dem ersten `issueInvoice` aufrufen und `missing` anzeigen.
45
45
  */
46
46
  export declare function getInvoiceSetupStatus(rufen: InternerTransport): Promise<InvoiceSetupStatus>;
47
- /** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
48
- export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string): Promise<Uint8Array>;
47
+ /**
48
+ * Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter
49
+ * Factur-X-Datei. Mit `language` in der anderen Sprache als der Rechnung kommt
50
+ * eine **Uebersetzungskopie**: dieselbe Nummer, auf jeder Seite als Uebersetzung
51
+ * gekennzeichnet, ohne eingebettete E-Rechnung — keine eigene Rechnung.
52
+ */
53
+ export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string, optionen?: {
54
+ language?: InvoiceLanguage;
55
+ }): Promise<Uint8Array>;
56
+ /** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */
57
+ export declare function listBrands(rufen: InternerTransport): Promise<Brand[]>;
49
58
  /**
50
59
  * Die E-Rechnung als XML-Text. Sie kommt im gewohnten Umschlag (`data.xml`)
51
60
  * und nicht als rohe Datei: so bleibt ein fachlicher Fehler
@@ -29,6 +29,7 @@ exports.getInvoice = getInvoice;
29
29
  exports.listInvoices = listInvoices;
30
30
  exports.getInvoiceSetupStatus = getInvoiceSetupStatus;
31
31
  exports.getInvoicePdf = getInvoicePdf;
32
+ exports.listBrands = listBrands;
32
33
  exports.getInvoiceXml = getInvoiceXml;
33
34
  const errors_js_1 = require("../client/errors.js");
34
35
  function objekt(wert) {
@@ -128,9 +129,24 @@ async function getInvoiceSetupStatus(rufen) {
128
129
  };
129
130
  }
130
131
  // ---- Dateien ----------------------------------------------------------------
131
- /** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
132
- function getInvoicePdf(rufenBinaer, invoiceId) {
133
- return rufenBinaer('getInvoicePdf', { invoiceId });
132
+ /**
133
+ * Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter
134
+ * Factur-X-Datei. Mit `language` in der anderen Sprache als der Rechnung kommt
135
+ * eine **Uebersetzungskopie**: dieselbe Nummer, auf jeder Seite als Uebersetzung
136
+ * gekennzeichnet, ohne eingebettete E-Rechnung — keine eigene Rechnung.
137
+ */
138
+ function getInvoicePdf(rufenBinaer, invoiceId, optionen = {}) {
139
+ const params = { invoiceId };
140
+ if (optionen.language)
141
+ params['language'] = optionen.language;
142
+ return rufenBinaer('getInvoicePdf', params);
143
+ }
144
+ /** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */
145
+ async function listBrands(rufen) {
146
+ const brands = objekt(await rufen('listBrands', {}))['brands'];
147
+ if (!Array.isArray(brands))
148
+ throw new errors_js_1.KasseneckValidationError('listBrands', 'Antwort ohne brands', 'response');
149
+ return brands;
134
150
  }
135
151
  /**
136
152
  * Die E-Rechnung als XML-Text. Sie kommt im gewohnten Umschlag (`data.xml`)
@@ -13,6 +13,7 @@
13
13
  export { createRechnungApi, type RechnungApi, type RechnungApiOptions } from './api.js';
14
14
  export { rechnungKeyAuth, type RechnungKeyAuthOptions } from './auth.js';
15
15
  export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, type RechnungFeldFehler, } from './fehler.js';
16
- export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
17
- 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';
18
- 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';
16
+ export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
17
+ 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';
18
+ export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.js';
19
+ 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';
@@ -12,7 +12,7 @@
12
12
  * Benutzung des Clients.
13
13
  */
14
14
  Object.defineProperty(exports, "__esModule", { value: true });
15
- exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = exports.updateCustomer = exports.searchCustomers = exports.listInvoices = exports.issueInvoice = exports.getInvoiceXml = exports.getInvoiceSetupStatus = exports.getInvoicePdf = exports.getInvoice = exports.getCustomer = exports.createCustomer = exports.createCreditNote = exports.cancelInvoice = exports.rechnungFeldFehler = exports.rechnungFehlerCode = exports.istRechnungFehler = exports.rechnungKeyAuth = exports.createRechnungApi = void 0;
15
+ 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;
16
16
  var api_js_1 = require("./api.js");
17
17
  Object.defineProperty(exports, "createRechnungApi", { enumerable: true, get: function () { return api_js_1.createRechnungApi; } });
18
18
  var auth_js_1 = require("./auth.js");
@@ -31,9 +31,13 @@ Object.defineProperty(exports, "getInvoicePdf", { enumerable: true, get: functio
31
31
  Object.defineProperty(exports, "getInvoiceSetupStatus", { enumerable: true, get: function () { return endpunkte_js_1.getInvoiceSetupStatus; } });
32
32
  Object.defineProperty(exports, "getInvoiceXml", { enumerable: true, get: function () { return endpunkte_js_1.getInvoiceXml; } });
33
33
  Object.defineProperty(exports, "issueInvoice", { enumerable: true, get: function () { return endpunkte_js_1.issueInvoice; } });
34
+ Object.defineProperty(exports, "listBrands", { enumerable: true, get: function () { return endpunkte_js_1.listBrands; } });
34
35
  Object.defineProperty(exports, "listInvoices", { enumerable: true, get: function () { return endpunkte_js_1.listInvoices; } });
35
36
  Object.defineProperty(exports, "searchCustomers", { enumerable: true, get: function () { return endpunkte_js_1.searchCustomers; } });
36
37
  Object.defineProperty(exports, "updateCustomer", { enumerable: true, get: function () { return endpunkte_js_1.updateCustomer; } });
38
+ var texte_js_1 = require("./texte.js");
39
+ Object.defineProperty(exports, "RECHNUNG_TEXTE", { enumerable: true, get: function () { return texte_js_1.RECHNUNG_TEXTE; } });
40
+ Object.defineProperty(exports, "rechnungText", { enumerable: true, get: function () { return texte_js_1.rechnungText; } });
37
41
  var vertrag_js_1 = require("./vertrag.js");
38
42
  Object.defineProperty(exports, "RECHNUNG_VERTRAG_VERSION", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_VERTRAG_VERSION; } });
39
43
  Object.defineProperty(exports, "RECHNUNG_AUFRUFE", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_AUFRUFE; } });
@@ -46,6 +50,9 @@ Object.defineProperty(exports, "CUSTOMER_TYPES", { enumerable: true, get: functi
46
50
  Object.defineProperty(exports, "INVOICE_LIST_STATUS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_LIST_STATUS; } });
47
51
  Object.defineProperty(exports, "DOC_TYPES", { enumerable: true, get: function () { return vertrag_js_1.DOC_TYPES; } });
48
52
  Object.defineProperty(exports, "EINVOICE_FORMATS", { enumerable: true, get: function () { return vertrag_js_1.EINVOICE_FORMATS; } });
53
+ Object.defineProperty(exports, "INVOICE_LANGUAGES", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_LANGUAGES; } });
54
+ Object.defineProperty(exports, "INVOICE_UNITS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_UNITS; } });
55
+ Object.defineProperty(exports, "RECHNUNG_EINHEITEN_CODES", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_EINHEITEN_CODES; } });
49
56
  Object.defineProperty(exports, "INVOICE_SETUP_REQUIREMENTS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_SETUP_REQUIREMENTS; } });
50
57
  Object.defineProperty(exports, "KUNDE_FELDER", { enumerable: true, get: function () { return vertrag_js_1.KUNDE_FELDER; } });
51
58
  Object.defineProperty(exports, "POSITION_FELDER", { enumerable: true, get: function () { return vertrag_js_1.POSITION_FELDER; } });
@@ -0,0 +1,202 @@
1
+ /**
2
+ * Texte von Rechnung und Gutschrift in jeder Sprache der Rechnungs-API — eine
3
+ * Quelle fuer das Backend (PDF, E-Rechnung, Mail) und das Web (Statusseite).
4
+ * Das Backend liest sie aus `fixtures/rechnung-texte.json` (`npm run
5
+ * fixtures:rechnungstexte`).
6
+ *
7
+ * Datum und Betraege stehen NICHT hier: sie bleiben in jeder Sprache
8
+ * oesterreichisch formatiert (15.09.2026, € 1.234,56) und werden vom Aufrufer
9
+ * eingesetzt. Platzhalter in {geschweiften} Klammern; jede Sprache hat dieselben
10
+ * Schluessel und je Schluessel dieselben Platzhalter (test/rechnung-texte.test.ts).
11
+ *
12
+ * Steuerhinweise nennen in jeder Sprache die Gesetzesstelle — § 11 UStG verlangt
13
+ * einen Hinweis, keinen Wortlaut; die Fundstelle macht ihn eindeutig.
14
+ */
15
+ import type { InvoiceLanguage } from './vertrag.js';
16
+ declare const DE: {
17
+ readonly 'pdf.titel.rechnung': "RECHNUNG";
18
+ readonly 'pdf.titel.gutschrift': "GUTSCHRIFT";
19
+ readonly 'pdf.pille.bezahlt': "BEZAHLT";
20
+ readonly 'pdf.pille.lastschrift': "SEPA-LASTSCHRIFT";
21
+ readonly 'pdf.meta.nummer.rechnung': "Rechnungsnr.";
22
+ readonly 'pdf.meta.nummer.gutschrift': "Gutschriftsnr.";
23
+ readonly 'pdf.meta.datum.rechnung': "Rechnungsdatum";
24
+ readonly 'pdf.meta.datum.gutschrift': "Gutschriftsdatum";
25
+ readonly 'pdf.meta.leistungszeitraum': "Leistungszeitraum";
26
+ readonly 'pdf.meta.faelligkeit': "Fälligkeit";
27
+ readonly 'pdf.bezug.gutschrift': "Gutschrift zu Rechnung {nummer}";
28
+ readonly 'pdf.bezug.vom': " vom {datum}";
29
+ readonly 'pdf.bezeichnung.rechnung': "Rechnung {nummer}";
30
+ readonly 'pdf.bezeichnung.gutschrift': "Gutschrift {nummer}";
31
+ readonly 'pdf.uid': "UID: {uid}";
32
+ readonly 'pdf.tabelle.pos': "POS";
33
+ readonly 'pdf.tabelle.beschreibung': "BESCHREIBUNG";
34
+ readonly 'pdf.tabelle.menge': "MENGE";
35
+ readonly 'pdf.tabelle.ust': "UST";
36
+ readonly 'pdf.tabelle.einzelNetto': "EINZEL NETTO";
37
+ readonly 'pdf.tabelle.betragNetto': "BETRAG NETTO";
38
+ readonly 'pdf.summe.zwischensumme': "Zwischensumme netto";
39
+ readonly 'pdf.summe.umsatzsteuer': "Umsatzsteuer {satz}%";
40
+ readonly 'pdf.summe.gesamt.rechnung': "Gesamtbetrag";
41
+ readonly 'pdf.summe.gesamt.gutschrift': "Gutschriftsbetrag";
42
+ readonly 'steuer.kleinunternehmer': "Gemäß § 6 Abs. 1 Z 27 UStG wird keine Umsatzsteuer verrechnet (Kleinunternehmer).";
43
+ readonly 'steuer.igLieferung': "Steuerfreie innergemeinschaftliche Lieferung (Art. 6 Abs. 1 UStG).";
44
+ readonly 'steuer.ausfuhr': "Steuerfreie Ausfuhrlieferung (§ 6 Abs. 1 Z 1 UStG).";
45
+ readonly 'steuer.reverseCharge.titel': "Steuerfreie Leistung – Reverse Charge. ";
46
+ readonly 'steuer.reverseCharge.text': "Übergang der Steuerschuldnerschaft auf den Leistungsempfänger gem. Art. 196 MwSt-RL 2006/112/EG (innergemeinschaftliche Leistung). Die Umsatzsteuer ist vom Leistungsempfänger im Bestimmungsland abzuführen.";
47
+ readonly 'steuer.reverseCharge.uid': "UID Leistungserbringer: {verkaeufer} · UID Leistungsempfänger: {kaeufer}";
48
+ readonly 'pdf.zahlung.titel': "ZAHLUNGSINFORMATIONEN";
49
+ readonly 'pdf.zahlung.empfaenger': "Empfänger";
50
+ readonly 'pdf.zahlung.iban': "IBAN";
51
+ readonly 'pdf.zahlung.bic': "BIC";
52
+ readonly 'pdf.zahlung.verwendungszweck': "Verwendungszweck";
53
+ readonly 'pdf.zahlung.hinweisBis': "Zahlbar ohne Abzug bis {datum}. Vielen Dank für Ihren Auftrag.";
54
+ readonly 'pdf.zahlung.hinweis': "Zahlbar ohne Abzug. Vielen Dank für Ihren Auftrag.";
55
+ readonly 'pdf.zahlung.qr': "Mit Banking-App scannen & zahlen";
56
+ readonly 'pdf.bezahlt.text': "Diese Rechnung ist beglichen. Es ist nichts weiter zu tun.";
57
+ readonly 'pdf.bezahlt.am': "Bezahlt am";
58
+ readonly 'pdf.bezahlt.zahlungsart': "Zahlungsart";
59
+ readonly 'zahlungsart.cash': "Bar";
60
+ readonly 'zahlungsart.transfer': "Überweisung";
61
+ readonly 'zahlungsart.card': "Karte";
62
+ readonly 'zahlungsart.online': "Online";
63
+ readonly 'pdf.lastschrift.text': "Der Betrag wird per SEPA-Lastschrift eingezogen. Sie müssen nichts veranlassen.";
64
+ readonly 'pdf.lastschrift.einzugAm': "Einzug am";
65
+ readonly 'pdf.lastschrift.konto': "Konto";
66
+ readonly 'pdf.lastschrift.mandatsreferenz': "Mandatsreferenz";
67
+ readonly 'pdf.lastschrift.mandatVom': "Mandat vom";
68
+ readonly 'pdf.lastschrift.warnung': "Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.";
69
+ readonly 'pdf.erstattung.text': "Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.";
70
+ readonly 'pdf.erstattung.bezug': "Bezug";
71
+ readonly 'pdf.erstattung.betrag': "Erstattungsbetrag";
72
+ readonly 'pdf.status.titel': "Zahlungsstatus online verfolgen";
73
+ readonly 'pdf.status.text': "Zahlung bzw. Einzug prüfen und Benachrichtigungen aktivieren.";
74
+ readonly 'pdf.status.link': "Link";
75
+ readonly 'pdf.status.passwort': "Passwort";
76
+ readonly 'pdf.fuss.kontakt': "Kontakt";
77
+ readonly 'pdf.fuss.register': "Register & Steuer";
78
+ readonly 'pdf.fuss.sitz': "Sitz: {ort}";
79
+ readonly 'pdf.fuss.hinweis': "Erstellt mit Kasseneck — ein Produkt der Kreiseck";
80
+ readonly 'pdf.seite': "Seite {nummer} / {gesamt}";
81
+ readonly 'land.AT': "Österreich";
82
+ readonly 'land.DE': "Deutschland";
83
+ readonly 'land.CH': "Schweiz";
84
+ readonly 'land.IT': "Italien";
85
+ readonly 'land.LI': "Liechtenstein";
86
+ readonly 'kopie.rechnung': "Übersetzung – keine eigene Rechnung · Original: Rechnung Nr. {nummer} vom {datum}";
87
+ readonly 'kopie.gutschrift': "Übersetzung – keine eigene Gutschrift · Original: Gutschrift Nr. {nummer} vom {datum}";
88
+ readonly 'gutschrift.einleitung': "Grund: {grund}";
89
+ readonly 'gutschrift.grund.cancellation': "Stornierung";
90
+ readonly 'gutschrift.grund.price_reduction': "Preisnachlass";
91
+ readonly 'gutschrift.grund.return': "Rücksendung";
92
+ readonly 'gutschrift.grund.incorrect_invoice': "Fehlerhafte Rechnung";
93
+ readonly 'gutschrift.grund.other': "Sonstiges";
94
+ readonly 'einvoice.befreiung.reverseCharge': "Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge)";
95
+ readonly 'einvoice.befreiung.kleinunternehmer': "Steuerbefreit — Kleinunternehmer gemäß §6 Abs. 1 Z 27 UStG";
96
+ readonly 'einvoice.befreiung.igLieferung': "Steuerfreie innergemeinschaftliche Lieferung gemäß Art. 6 Abs. 1 UStG";
97
+ readonly 'einvoice.befreiung.ausfuhr': "Steuerfreie Ausfuhrlieferung gemäß §6 Abs. 1 Z 1 UStG";
98
+ readonly 'einvoice.zahlbarBis': "Zahlbar bis {datum}";
99
+ readonly 'einheit.piece': "Stk";
100
+ readonly 'einheit.pair': "Paar";
101
+ readonly 'einheit.set': "Set";
102
+ readonly 'einheit.dozen': "Dtzd.";
103
+ readonly 'einheit.second': "Sek.";
104
+ readonly 'einheit.minute': "Min.";
105
+ readonly 'einheit.hour': "Std";
106
+ readonly 'einheit.day': "Tag";
107
+ readonly 'einheit.night': "Nacht";
108
+ readonly 'einheit.week': "Woche";
109
+ readonly 'einheit.month': "Monat";
110
+ readonly 'einheit.quarter': "Quartal";
111
+ readonly 'einheit.half_year': "Halbjahr";
112
+ readonly 'einheit.year': "Jahr";
113
+ readonly 'einheit.milligram': "mg";
114
+ readonly 'einheit.gram': "g";
115
+ readonly 'einheit.kilogram': "kg";
116
+ readonly 'einheit.tonne': "t";
117
+ readonly 'einheit.millimetre': "mm";
118
+ readonly 'einheit.centimetre': "cm";
119
+ readonly 'einheit.metre': "m";
120
+ readonly 'einheit.running_metre': "lfm";
121
+ readonly 'einheit.kilometre': "km";
122
+ readonly 'einheit.square_metre': "m²";
123
+ readonly 'einheit.hectare': "ha";
124
+ readonly 'einheit.millilitre': "ml";
125
+ readonly 'einheit.litre': "l";
126
+ readonly 'einheit.cubic_metre': "m³";
127
+ readonly 'einheit.kilowatt_hour': "kWh";
128
+ readonly 'einheit.megawatt_hour': "MWh";
129
+ readonly 'einheit.gigabyte': "GB";
130
+ readonly 'einheit.terabyte': "TB";
131
+ readonly 'einheit.flat_rate': "Pauschal";
132
+ readonly 'einheit.person': "Pers.";
133
+ readonly 'einheit.licence': "Lizenz";
134
+ readonly 'einheit.user': "Benutzer";
135
+ readonly 'einheit.device': "Gerät";
136
+ readonly 'einheit.session': "Sitzung";
137
+ readonly 'einheit.trip': "Fahrt";
138
+ readonly 'einheit.page': "Seite";
139
+ readonly 'einheit.sheet': "Blatt";
140
+ readonly 'einheit.package': "Pkg.";
141
+ readonly 'einheit.box': "Box";
142
+ readonly 'einheit.carton': "Karton";
143
+ readonly 'einheit.bottle': "Fl.";
144
+ readonly 'einheit.can': "Dose";
145
+ readonly 'einheit.roll': "Rolle";
146
+ readonly 'einheit.bag': "Sack";
147
+ readonly 'einheit.pallet': "Palette";
148
+ readonly 'einheitName.piece': "Stück";
149
+ readonly 'einheitName.pair': "Paar";
150
+ readonly 'einheitName.set': "Set";
151
+ readonly 'einheitName.dozen': "Dutzend";
152
+ readonly 'einheitName.second': "Sekunde";
153
+ readonly 'einheitName.minute': "Minute";
154
+ readonly 'einheitName.hour': "Stunde";
155
+ readonly 'einheitName.day': "Tag";
156
+ readonly 'einheitName.night': "Nacht";
157
+ readonly 'einheitName.week': "Woche";
158
+ readonly 'einheitName.month': "Monat";
159
+ readonly 'einheitName.quarter': "Quartal";
160
+ readonly 'einheitName.half_year': "Halbjahr";
161
+ readonly 'einheitName.year': "Jahr";
162
+ readonly 'einheitName.milligram': "Milligramm";
163
+ readonly 'einheitName.gram': "Gramm";
164
+ readonly 'einheitName.kilogram': "Kilogramm";
165
+ readonly 'einheitName.tonne': "Tonne";
166
+ readonly 'einheitName.millimetre': "Millimeter";
167
+ readonly 'einheitName.centimetre': "Zentimeter";
168
+ readonly 'einheitName.metre': "Meter";
169
+ readonly 'einheitName.running_metre': "Laufmeter";
170
+ readonly 'einheitName.kilometre': "Kilometer";
171
+ readonly 'einheitName.square_metre': "Quadratmeter";
172
+ readonly 'einheitName.hectare': "Hektar";
173
+ readonly 'einheitName.millilitre': "Milliliter";
174
+ readonly 'einheitName.litre': "Liter";
175
+ readonly 'einheitName.cubic_metre': "Kubikmeter";
176
+ readonly 'einheitName.kilowatt_hour': "Kilowattstunde";
177
+ readonly 'einheitName.megawatt_hour': "Megawattstunde";
178
+ readonly 'einheitName.gigabyte': "Gigabyte";
179
+ readonly 'einheitName.terabyte': "Terabyte";
180
+ readonly 'einheitName.flat_rate': "Pauschale";
181
+ readonly 'einheitName.person': "Person";
182
+ readonly 'einheitName.licence': "Lizenz";
183
+ readonly 'einheitName.user': "Benutzer";
184
+ readonly 'einheitName.device': "Gerät";
185
+ readonly 'einheitName.session': "Sitzung";
186
+ readonly 'einheitName.trip': "Fahrt";
187
+ readonly 'einheitName.page': "Seite";
188
+ readonly 'einheitName.sheet': "Blatt";
189
+ readonly 'einheitName.package': "Packung";
190
+ readonly 'einheitName.box': "Box";
191
+ readonly 'einheitName.carton': "Karton";
192
+ readonly 'einheitName.bottle': "Flasche";
193
+ readonly 'einheitName.can': "Dose";
194
+ readonly 'einheitName.roll': "Rolle";
195
+ readonly 'einheitName.bag': "Sack";
196
+ readonly 'einheitName.pallet': "Palette";
197
+ };
198
+ export type RechnungTextSchluessel = keyof typeof DE;
199
+ export declare const RECHNUNG_TEXTE: Readonly<Record<InvoiceLanguage, Readonly<Record<RechnungTextSchluessel, string>>>>;
200
+ /** Ein Text der gewaehlten Sprache mit eingesetzten Werten; ein fehlender Wert ist ein Programmierfehler. */
201
+ export declare function rechnungText(sprache: InvoiceLanguage, schluessel: RechnungTextSchluessel, werte?: Readonly<Record<string, string | number>>): string;
202
+ export {};