@kreiseck/kasseneck-api 1.37.0 → 1.39.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 (185) hide show
  1. package/CHANGELOG.md +39 -1
  2. package/README.md +19 -1
  3. package/dist/cjs/client/aufrufe.d.ts +2 -2
  4. package/dist/cjs/client/aufrufe.js +12 -0
  5. package/dist/cjs/index.d.ts +1 -1
  6. package/dist/cjs/index.js +6 -5
  7. package/dist/cjs/invoice/texte.d.ts +18 -1
  8. package/dist/cjs/invoice/texte.js +43 -2
  9. package/dist/cjs/invoice/vertrag.d.ts +1 -1
  10. package/dist/cjs/invoice/vertrag.js +1 -0
  11. package/dist/cjs/models/cancellation.d.ts +1 -1
  12. package/dist/cjs/models/cancellation.js +2 -0
  13. package/dist/cjs/models/index.d.ts +2 -1
  14. package/dist/cjs/models/index.js +6 -3
  15. package/dist/cjs/models/invoice-payment-ref.d.ts +42 -0
  16. package/dist/cjs/models/invoice-payment-ref.js +38 -0
  17. package/dist/cjs/models/receipt-item.d.ts +10 -2
  18. package/dist/cjs/models/receipt-item.js +14 -1
  19. package/dist/cjs/models/receipt.d.ts +7 -0
  20. package/dist/cjs/models/receipt.js +6 -0
  21. package/dist/cjs/payments/hobex-hps/connect-client.d.ts +17 -0
  22. package/dist/cjs/payments/hobex-hps/connect-client.js +17 -0
  23. package/dist/cjs/payments/hobex-hps/index.d.ts +1 -1
  24. package/dist/cjs/payments/index.d.ts +1 -1
  25. package/dist/cjs/pos/client.js +2 -1
  26. package/dist/cjs/pos/index.d.ts +1 -1
  27. package/dist/cjs/pos/index.js +7 -5
  28. package/dist/cjs/pos/schicht-lesen.js +5 -0
  29. package/dist/cjs/pos/schicht-typen.d.ts +11 -0
  30. package/dist/cjs/pos/settings.d.ts +14 -1
  31. package/dist/cjs/pos/settings.js +16 -2
  32. package/dist/cjs/pos/texte.d.ts +400 -2
  33. package/dist/cjs/pos/texte.js +152 -3
  34. package/dist/cjs/receipt/index.d.ts +1 -0
  35. package/dist/cjs/receipt/index.js +4 -2
  36. package/dist/cjs/receipt/layout.d.ts +2 -2
  37. package/dist/cjs/receipt/layout.js +106 -117
  38. package/dist/cjs/receipt/shift-sheet.js +6 -1
  39. package/dist/cjs/receipt/vermerke.d.ts +80 -0
  40. package/dist/cjs/receipt/vermerke.js +167 -0
  41. package/dist/cjs/register/errors.d.ts +1 -1
  42. package/dist/cjs/register/errors.js +4 -0
  43. package/dist/cjs/register/index.d.ts +1 -1
  44. package/dist/cjs/register/index.js +3 -1
  45. package/dist/cjs/register/pairing.d.ts +51 -0
  46. package/dist/cjs/register/pairing.js +59 -0
  47. package/dist/cjs/stored/draht.js +25 -1
  48. package/dist/cjs/stored/einstellungen.js +5 -2
  49. package/dist/cjs/stored/vokabular.d.ts +1 -1
  50. package/dist/cjs/stored/vokabular.js +22 -2
  51. package/dist/cjs/version.d.ts +1 -1
  52. package/dist/cjs/version.js +1 -1
  53. package/dist/esm/client/aufrufe.d.ts +2 -2
  54. package/dist/esm/client/aufrufe.js +12 -0
  55. package/dist/esm/index.d.ts +1 -1
  56. package/dist/esm/index.js +1 -1
  57. package/dist/esm/invoice/texte.d.ts +18 -1
  58. package/dist/esm/invoice/texte.js +43 -2
  59. package/dist/esm/invoice/vertrag.d.ts +1 -1
  60. package/dist/esm/invoice/vertrag.js +1 -0
  61. package/dist/esm/models/cancellation.d.ts +1 -1
  62. package/dist/esm/models/cancellation.js +2 -0
  63. package/dist/esm/models/index.d.ts +2 -1
  64. package/dist/esm/models/index.js +2 -1
  65. package/dist/esm/models/invoice-payment-ref.d.ts +42 -0
  66. package/dist/esm/models/invoice-payment-ref.js +35 -0
  67. package/dist/esm/models/receipt-item.d.ts +10 -2
  68. package/dist/esm/models/receipt-item.js +13 -1
  69. package/dist/esm/models/receipt.d.ts +7 -0
  70. package/dist/esm/models/receipt.js +6 -0
  71. package/dist/esm/payments/hobex-hps/connect-client.d.ts +17 -0
  72. package/dist/esm/payments/hobex-hps/connect-client.js +17 -0
  73. package/dist/esm/payments/hobex-hps/index.d.ts +1 -1
  74. package/dist/esm/payments/index.d.ts +1 -1
  75. package/dist/esm/pos/client.js +3 -2
  76. package/dist/esm/pos/index.d.ts +1 -1
  77. package/dist/esm/pos/index.js +1 -1
  78. package/dist/esm/pos/schicht-lesen.js +5 -0
  79. package/dist/esm/pos/schicht-typen.d.ts +11 -0
  80. package/dist/esm/pos/settings.d.ts +14 -1
  81. package/dist/esm/pos/settings.js +14 -1
  82. package/dist/esm/pos/texte.d.ts +400 -2
  83. package/dist/esm/pos/texte.js +152 -3
  84. package/dist/esm/receipt/index.d.ts +1 -0
  85. package/dist/esm/receipt/index.js +1 -0
  86. package/dist/esm/receipt/layout.d.ts +2 -2
  87. package/dist/esm/receipt/layout.js +103 -113
  88. package/dist/esm/receipt/shift-sheet.js +6 -1
  89. package/dist/esm/receipt/vermerke.d.ts +80 -0
  90. package/dist/esm/receipt/vermerke.js +155 -0
  91. package/dist/esm/register/errors.d.ts +1 -1
  92. package/dist/esm/register/errors.js +4 -0
  93. package/dist/esm/register/index.d.ts +1 -1
  94. package/dist/esm/register/index.js +1 -1
  95. package/dist/esm/register/pairing.d.ts +51 -0
  96. package/dist/esm/register/pairing.js +57 -0
  97. package/dist/esm/stored/draht.js +25 -1
  98. package/dist/esm/stored/einstellungen.js +6 -3
  99. package/dist/esm/stored/vokabular.d.ts +1 -1
  100. package/dist/esm/stored/vokabular.js +22 -2
  101. package/dist/esm/version.d.ts +1 -1
  102. package/dist/esm/version.js +1 -1
  103. package/fixtures/expected/invoice-payment-cancellation.grid32.txt +28 -0
  104. package/fixtures/expected/invoice-payment-cancellation.grid48.txt +26 -0
  105. package/fixtures/expected/invoice-payment-cancellation.lines.json +189 -0
  106. package/fixtures/expected/invoice-payment-cancellation.sheet32.json +194 -0
  107. package/fixtures/expected/invoice-payment-cancellation.sheet48.json +182 -0
  108. package/fixtures/expected/invoice-payment-manual-receipt.grid32.txt +30 -0
  109. package/fixtures/expected/invoice-payment-manual-receipt.grid48.txt +29 -0
  110. package/fixtures/expected/invoice-payment-manual-receipt.lines.json +199 -0
  111. package/fixtures/expected/invoice-payment-manual-receipt.sheet32.json +206 -0
  112. package/fixtures/expected/invoice-payment-manual-receipt.sheet48.json +200 -0
  113. package/fixtures/expected/invoice-payment-normal.grid32.txt +22 -0
  114. package/fixtures/expected/invoice-payment-normal.grid48.txt +21 -0
  115. package/fixtures/expected/invoice-payment-normal.lines.json +192 -0
  116. package/fixtures/expected/invoice-payment-normal.sheet32.json +158 -0
  117. package/fixtures/expected/invoice-payment-normal.sheet48.json +152 -0
  118. package/fixtures/expected/invoice-payment-outage.grid32.txt +23 -0
  119. package/fixtures/expected/invoice-payment-outage.grid48.txt +21 -0
  120. package/fixtures/expected/invoice-payment-outage.lines.json +172 -0
  121. package/fixtures/expected/invoice-payment-outage.sheet32.json +164 -0
  122. package/fixtures/expected/invoice-payment-outage.sheet48.json +152 -0
  123. package/fixtures/expected/invoice-payment-partial.grid32.txt +20 -0
  124. package/fixtures/expected/invoice-payment-partial.grid48.txt +20 -0
  125. package/fixtures/expected/invoice-payment-partial.lines.json +162 -0
  126. package/fixtures/expected/invoice-payment-partial.sheet32.json +146 -0
  127. package/fixtures/expected/invoice-payment-partial.sheet48.json +146 -0
  128. package/fixtures/expected/invoice-payment-refund.grid32.txt +20 -0
  129. package/fixtures/expected/invoice-payment-refund.grid48.txt +20 -0
  130. package/fixtures/expected/invoice-payment-refund.lines.json +162 -0
  131. package/fixtures/expected/invoice-payment-refund.sheet32.json +146 -0
  132. package/fixtures/expected/invoice-payment-refund.sheet48.json +146 -0
  133. package/fixtures/expected/invoice-payment-see-invoice.grid32.txt +22 -0
  134. package/fixtures/expected/invoice-payment-see-invoice.grid48.txt +21 -0
  135. package/fixtures/expected/invoice-payment-see-invoice.lines.json +192 -0
  136. package/fixtures/expected/invoice-payment-see-invoice.sheet32.json +158 -0
  137. package/fixtures/expected/invoice-payment-see-invoice.sheet48.json +152 -0
  138. package/fixtures/expected/invoice-payment-training.grid32.txt +30 -0
  139. package/fixtures/expected/invoice-payment-training.grid48.txt +27 -0
  140. package/fixtures/expected/invoice-payment-training.lines.json +183 -0
  141. package/fixtures/expected/invoice-payment-training.sheet32.json +206 -0
  142. package/fixtures/expected/invoice-payment-training.sheet48.json +188 -0
  143. package/fixtures/expected/invoice-payment-without-vat.grid32.txt +20 -0
  144. package/fixtures/expected/invoice-payment-without-vat.grid48.txt +19 -0
  145. package/fixtures/expected/invoice-payment-without-vat.lines.json +162 -0
  146. package/fixtures/expected/invoice-payment-without-vat.sheet32.json +146 -0
  147. package/fixtures/expected/invoice-payment-without-vat.sheet48.json +140 -0
  148. package/fixtures/expected/invoice-payment-zero-percent.grid32.txt +22 -0
  149. package/fixtures/expected/invoice-payment-zero-percent.grid48.txt +21 -0
  150. package/fixtures/expected/invoice-payment-zero-percent.lines.json +192 -0
  151. package/fixtures/expected/invoice-payment-zero-percent.sheet32.json +158 -0
  152. package/fixtures/expected/invoice-payment-zero-percent.sheet48.json +152 -0
  153. package/fixtures/hobex-hps-codes.json +1 -1
  154. package/fixtures/invoice-api.schema.json +3 -2
  155. package/fixtures/invoice-texts.json +37 -3
  156. package/fixtures/manifest.json +80 -0
  157. package/fixtures/pos-message-cases.json +3 -0
  158. package/fixtures/pos-texts.json +458 -1
  159. package/fixtures/receipt-due-generated.json +3 -3
  160. package/fixtures/receipt-due-voucher-generated.json +5 -5
  161. package/fixtures/receipts/invoice-payment-cancellation.json +70 -0
  162. package/fixtures/receipts/invoice-payment-manual-receipt.json +69 -0
  163. package/fixtures/receipts/invoice-payment-normal.json +65 -0
  164. package/fixtures/receipts/invoice-payment-outage.json +63 -0
  165. package/fixtures/receipts/invoice-payment-partial.json +63 -0
  166. package/fixtures/receipts/invoice-payment-refund.json +63 -0
  167. package/fixtures/receipts/invoice-payment-see-invoice.json +65 -0
  168. package/fixtures/receipts/invoice-payment-training.json +63 -0
  169. package/fixtures/receipts/invoice-payment-without-vat.json +63 -0
  170. package/fixtures/receipts/invoice-payment-zero-percent.json +65 -0
  171. package/fixtures/surface.json +16 -4
  172. package/fixtures/v3/antworten/belege.json +2 -2
  173. package/fixtures/v3/antworten/belegmail.json +2 -2
  174. package/fixtures/v3/antworten/berichte.json +2 -2
  175. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  176. package/fixtures/v3/antworten/kasse.json +702 -127
  177. package/fixtures/v3/antworten/lager.json +1 -1
  178. package/fixtures/v3/antworten/rechnungen.json +2 -2
  179. package/fixtures/v3/antworten/storno.json +2 -2
  180. package/fixtures/v3/stored/belege.json +2 -2
  181. package/fixtures/v3/stored/kasse.json +210 -4
  182. package/fixtures/v3/stored/rechnungen.json +2 -2
  183. package/fixtures/v3/v3-vokabular.json +237 -20
  184. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  185. package/package.json +1 -1
@@ -0,0 +1,80 @@
1
+ import { type Receipt } from '../models/index.js';
2
+ /**
3
+ * Vermerke eines Belegs: was ihn als besonderen Beleg ausweist (Testkasse,
4
+ * Testsignatur, Training, Storno, Nacherfassung, Signaturausfall). Eine Quelle
5
+ * fuer die Regeln: der Bon ([buildReceiptLayout]) setzt seine Bloecke aus
6
+ * diesen Bausteinen, und [receiptNotes] gibt sie strukturiert hinaus, damit
7
+ * ein anderes Blatt (Kassenteil auf der A4-Rechnung, Zahlungsbestaetigung)
8
+ * dieselben Vermerke anordnet, ohne eigene Regeln zu erfinden.
9
+ *
10
+ * Die Woerter sind Pflichtwoerter und bleiben in jeder Sprache deutsch
11
+ * (RKSV § 11 Abs. 3: Trainings- und Stornobuchungen ausdruecklich als solche
12
+ * bezeichnen; § 17 Abs. 4 und 5: Signaturausfall, Nacherfassung).
13
+ *
14
+ * „Duplikat“ ist kein Vermerk des Belegs: das druckt nur der Nachdruck auf
15
+ * Papier ([markAsDuplicate]).
16
+ *
17
+ * Abhaengig nur vom Belegmodell und der Wiener Zeit, damit der Zwilling in der
18
+ * 0.x-Linie und in Dart dieselben Regeln ohne den Rest des Layouts hat.
19
+ */
20
+ /** Art eines Vermerks, in der festen Reihenfolge von [receiptNotes]. */
21
+ export type ReceiptNoteKind = 'test_cashregister' | 'test_signature' | 'training' | 'cancellation' | 'manual_receipt' | 'signature_outage';
22
+ /** Ein Vermerk: Titel (hervorgehoben) und Zeilen darunter, fertiger Text. */
23
+ export interface ReceiptNote {
24
+ kind: ReceiptNoteKind;
25
+ title: string;
26
+ lines: string[];
27
+ }
28
+ export interface ReceiptNotesOptions {
29
+ /** Beleg einer Testumgebung (wie [BuildReceiptLayoutOptions.testCashregister]). */
30
+ testCashregister?: boolean;
31
+ /** Produktionskonto mit Test-Signatureinheit (wie [BuildReceiptLayoutOptions.testSignature]). */
32
+ testSignature?: boolean;
33
+ }
34
+ export declare const TESTKASSE_TEXT = "TESTKASSE \u2014 kein g\u00FCltiger Beleg";
35
+ export declare const TESTSIGNATUR_TEXT = "TESTSIGNATUR \u2014 kein g\u00FCltiger Beleg";
36
+ /** Text, den das Backend statt einer Signatur ablegt, wenn die Karte ausfaellt. */
37
+ export declare const SIGNATUR_AUSGEFALLEN = "Sicherheitseinrichtung ausgefallen";
38
+ /** Wurde der Beleg ohne funktionierende Signatureinheit ausgestellt? */
39
+ export declare function receiptSignatureFailed(receipt: Pick<Receipt, 'sig'>): boolean;
40
+ /** Belegtyp als Zeichenkette (Enum-Objekt oder roher Serverwert). */
41
+ export declare function belegtyp(receipt: Pick<Receipt, 'receiptType'>): string;
42
+ export declare function testkasseVermerk(): ReceiptNote;
43
+ export declare function testsignaturVermerk(): ReceiptNote;
44
+ /** Trainingsbeleg: Titel und Erklaerung; sonst `null`. */
45
+ export declare function trainingVermerk(receipt: Receipt): ReceiptNote | null;
46
+ /** Stornobeleg: Bezug, Datum des Originals (wenn der Bezug es traegt, Backend seit 2026-09-04) und Grund; sonst `null`. */
47
+ export declare function stornoVermerk(receipt: Receipt): ReceiptNote | null;
48
+ /**
49
+ * Teile der Nacherfassung: Anlass (Art und Grund), Handbeleg (Nummer und Tag) und der USt-Hinweis.
50
+ * Der Vermerk (§ 17 Abs. 5 RKSV) besteht aus Titel, Anlass und Handbeleg; den USt-Hinweis setzt nur
51
+ * der Bon, denn ob er gilt, haengt an der Firma (Kleinunternehmer) und am Beleg (Zahlungsbeleg).
52
+ */
53
+ export interface NacherfassungTeile {
54
+ title: string;
55
+ anlass: string[];
56
+ handbeleg: string[];
57
+ /** „USt: Duplikat des Handbelegs“ bzw. „… der Handbelege“ (Registrierkassenerlass 3.3 Faelle 5 und 6, 2.4.11). */
58
+ ustHinweis: string;
59
+ }
60
+ /**
61
+ * Nacherfassung eines Handbelegs (manualReceipt): Art, Grund, Nummer und Tag
62
+ * des Handbelegs bzw. der Handbelege eines Tagessammelbelegs. Ohne Handbeleg `null`.
63
+ */
64
+ export declare function nacherfassungTeile(receipt: Receipt): NacherfassungTeile | null;
65
+ /** Signaturausfall (§ 17 Abs. 4 RKSV): der Vermerk ohne Zeilen; sonst `null`. */
66
+ export declare function signaturausfallVermerk(receipt: Receipt): ReceiptNote | null;
67
+ /**
68
+ * Die Vermerke eines Belegs in fester Reihenfolge: Testkasse, Testsignatur,
69
+ * Training, Storno, Nacherfassung, Signaturausfall. Ein gewoehnlicher Beleg
70
+ * hat keine (`[]`).
71
+ *
72
+ * Ob Testkasse oder Testsignatur, weiss nur der Aufrufer (er kennt das Konto),
73
+ * wie bei [buildReceiptLayout]. Eine unbekannte Option wirft
74
+ * (`KasseneckValidationError`, `scope: 'request'`): eine alte deutsche
75
+ * (`testKasse`) darf nie still wegfallen, sonst saehe ein Testbeleg gueltig aus.
76
+ *
77
+ * Firmendaten kennt diese Ausgabe nicht; der USt-Hinweis der Nacherfassung
78
+ * („USt: Duplikat …“) gehoert darum nicht zum Vermerk (siehe [NacherfassungTeile]).
79
+ */
80
+ export declare function receiptNotes(receipt: Receipt, options?: ReceiptNotesOptions): ReceiptNote[];
@@ -0,0 +1,155 @@
1
+ import { CANCELLATION_REASONS, isCancellationReason } from '../models/index.js';
2
+ import { parseServerTimeStamp, toViennaWallClock } from '../vienna-time.js';
3
+ import { KasseneckValidationError } from '../client/errors.js';
4
+ // ------------------------------------------------------------------- Texte
5
+ export const TESTKASSE_TEXT = 'TESTKASSE — kein gültiger Beleg';
6
+ export const TESTSIGNATUR_TEXT = 'TESTSIGNATUR — kein gültiger Beleg';
7
+ /** Text, den das Backend statt einer Signatur ablegt, wenn die Karte ausfaellt. */
8
+ export const SIGNATUR_AUSGEFALLEN = 'Sicherheitseinrichtung ausgefallen';
9
+ /**
10
+ * Derselbe Text base64url-kodiert -- so steht er als dritter JWS-Teil im Feld
11
+ * `sig` (Zwilling von `RKSVService.isSigSuccess`). Fest hinterlegt statt zur
12
+ * Laufzeit kodiert: `btoa`/`Buffer` sind in Browser und Node verschieden zu
13
+ * haben, und der Wert ist unveraenderlich.
14
+ */
15
+ const SIGNATUR_AUSGEFALLEN_BASE64URL = 'U2ljaGVyaGVpdHNlaW5yaWNodHVuZyBhdXNnZWZhbGxlbg';
16
+ /** Erklaerung am Trainingsbeleg (Wortlaut mit dem Betreiber abgestimmt). */
17
+ const TRAINING_ERKLAERUNG = [
18
+ 'Trainingsbuchung — kein Kauf, keine Zahlung, keine steuerliche Buchung.',
19
+ 'Sollten Sie diesen Beleg als Kunde erhalten haben, sagen Sie bitte dem Betrieb Bescheid.',
20
+ ];
21
+ /** Grund-Zeile nach einem Ausfall der Kasse; `other` druckt den eigenen Text. */
22
+ const NACHERFASSUNG_GRUND = {
23
+ network_outage: 'Internet', power_outage: 'Strom', device_failure: 'Gerät defekt', system_outage: 'Störung',
24
+ };
25
+ // ------------------------------------------------------------ Hilfsregeln
26
+ /** Wurde der Beleg ohne funktionierende Signatureinheit ausgestellt? */
27
+ export function receiptSignatureFailed(receipt) {
28
+ return receipt.sig.split('.')[2] === SIGNATUR_AUSGEFALLEN_BASE64URL;
29
+ }
30
+ /** Belegtyp als Zeichenkette (Enum-Objekt oder roher Serverwert). */
31
+ export function belegtyp(receipt) {
32
+ return typeof receipt.receiptType === 'object' ? receipt.receiptType.value : String(receipt.receiptType ?? '');
33
+ }
34
+ /**
35
+ * Datum des stornierten Originals: „11.08.2026, 09:02 Uhr". Ein unlesbarer
36
+ * Zeitstempel am BEZUG ist kein Grund, den Storno-Bon zu verweigern (der
37
+ * Beleg selbst ist gueltig) -- dann bleibt die Zeile weg.
38
+ */
39
+ function originalDatum(timeStamp) {
40
+ try {
41
+ const t = toViennaWallClock(parseServerTimeStamp(timeStamp));
42
+ const zwei = (n) => String(n).padStart(2, '0');
43
+ return `${zwei(t.day)}.${zwei(t.month)}.${t.year}, ${zwei(t.hour)}:${zwei(t.minute)} Uhr`;
44
+ }
45
+ catch {
46
+ return null;
47
+ }
48
+ }
49
+ /**
50
+ * Grund eines Stornos lesbar -- aus dem EINEN Katalog des Modells
51
+ * (`CANCELLATION_REASONS`, derselbe, den die Kasse anbietet und das Backend
52
+ * annimmt). Unbekannter Code (Fremdclient): sichtbar, aber ohne zu werfen.
53
+ */
54
+ function stornoGrundText(code) {
55
+ if (!code)
56
+ return null;
57
+ return isCancellationReason(code) ? CANCELLATION_REASONS[code] : code;
58
+ }
59
+ /** `YYYY-MM-DD` als `TT.MM.JJJJ`; anderes bleibt, wie es kam. */
60
+ function handbelegDatum(tag) {
61
+ const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(tag);
62
+ return m ? `${m[3]}.${m[2]}.${m[1]}` : tag;
63
+ }
64
+ // ---------------------------------------------------------------- Bausteine
65
+ export function testkasseVermerk() {
66
+ return { kind: 'test_cashregister', title: TESTKASSE_TEXT, lines: [] };
67
+ }
68
+ export function testsignaturVermerk() {
69
+ return { kind: 'test_signature', title: TESTSIGNATUR_TEXT, lines: [] };
70
+ }
71
+ /** Trainingsbeleg: Titel und Erklaerung; sonst `null`. */
72
+ export function trainingVermerk(receipt) {
73
+ return belegtyp(receipt) === 'training' ? { kind: 'training', title: 'TRAININGSBELEG', lines: [...TRAINING_ERKLAERUNG] } : null;
74
+ }
75
+ /** Stornobeleg: Bezug, Datum des Originals (wenn der Bezug es traegt, Backend seit 2026-09-04) und Grund; sonst `null`. */
76
+ export function stornoVermerk(receipt) {
77
+ if (belegtyp(receipt) !== 'cancellation')
78
+ return null;
79
+ const zeilen = [receipt.cancellationOf ? `Stornobuchung zu Beleg ${receipt.cancellationOf.receiptId}` : 'Stornobuchung'];
80
+ const datum = receipt.cancellationOf?.timeStamp ? originalDatum(receipt.cancellationOf.timeStamp) : null;
81
+ if (datum)
82
+ zeilen.push(`vom ${datum}`);
83
+ const grund = stornoGrundText(typeof receipt.cancellationReason === 'string' ? receipt.cancellationReason : undefined);
84
+ if (grund)
85
+ zeilen.push(`Grund: ${grund}`);
86
+ return { kind: 'cancellation', title: 'STORNOBELEG', lines: zeilen };
87
+ }
88
+ /**
89
+ * Nacherfassung eines Handbelegs (manualReceipt): Art, Grund, Nummer und Tag
90
+ * des Handbelegs bzw. der Handbelege eines Tagessammelbelegs. Ohne Handbeleg `null`.
91
+ */
92
+ export function nacherfassungTeile(receipt) {
93
+ const m = receipt.manualReceipt;
94
+ if (!m)
95
+ return null;
96
+ const anlass = [m.reason === 'outside_premises' ? 'Leistung außer Haus' : 'nach Ausfall der Kasse'];
97
+ const grund = m.reason === 'other' ? m.note : NACHERFASSUNG_GRUND[m.reason];
98
+ if (grund)
99
+ anlass.push(`Grund: ${grund}`);
100
+ const tag = handbelegDatum(m.date);
101
+ if (m.numberTo) {
102
+ return {
103
+ title: 'NACHERFASSUNG',
104
+ anlass,
105
+ handbeleg: ['Tagessammelbeleg', `Handbelege Nr. ${m.number} bis ${m.numberTo}`, `${m.count ? `${m.count} Belege ` : ''}vom ${tag}`],
106
+ ustHinweis: 'USt: Duplikat der Handbelege',
107
+ };
108
+ }
109
+ return {
110
+ title: 'NACHERFASSUNG',
111
+ anlass,
112
+ handbeleg: [`Handbeleg Nr. ${m.number}`, `vom ${tag}${m.time ? `, ${m.time} Uhr` : ''}`],
113
+ ustHinweis: 'USt: Duplikat des Handbelegs',
114
+ };
115
+ }
116
+ /** Signaturausfall (§ 17 Abs. 4 RKSV): der Vermerk ohne Zeilen; sonst `null`. */
117
+ export function signaturausfallVermerk(receipt) {
118
+ return receiptSignatureFailed(receipt) ? { kind: 'signature_outage', title: SIGNATUR_AUSGEFALLEN, lines: [] } : null;
119
+ }
120
+ // ------------------------------------------------------------------ Ausgabe
121
+ const OPTIONEN = new Set(['testCashregister', 'testSignature']);
122
+ const OPTIONEN_ALT = { testKasse: 'testCashregister', testSignatur: 'testSignature' };
123
+ /**
124
+ * Die Vermerke eines Belegs in fester Reihenfolge: Testkasse, Testsignatur,
125
+ * Training, Storno, Nacherfassung, Signaturausfall. Ein gewoehnlicher Beleg
126
+ * hat keine (`[]`).
127
+ *
128
+ * Ob Testkasse oder Testsignatur, weiss nur der Aufrufer (er kennt das Konto),
129
+ * wie bei [buildReceiptLayout]. Eine unbekannte Option wirft
130
+ * (`KasseneckValidationError`, `scope: 'request'`): eine alte deutsche
131
+ * (`testKasse`) darf nie still wegfallen, sonst saehe ein Testbeleg gueltig aus.
132
+ *
133
+ * Firmendaten kennt diese Ausgabe nicht; der USt-Hinweis der Nacherfassung
134
+ * („USt: Duplikat …“) gehoert darum nicht zum Vermerk (siehe [NacherfassungTeile]).
135
+ */
136
+ export function receiptNotes(receipt, options = {}) {
137
+ for (const name of Object.keys(options)) {
138
+ if (OPTIONEN.has(name))
139
+ continue;
140
+ const neu = OPTIONEN_ALT[name];
141
+ throw new KasseneckValidationError('receiptNotes', neu !== undefined ? `Option "${name}" heisst "${neu}"` : `Unbekannte Option "${name}"`, 'request');
142
+ }
143
+ const vermerke = [
144
+ options.testCashregister ? testkasseVermerk() : null,
145
+ options.testSignature ? testsignaturVermerk() : null,
146
+ trainingVermerk(receipt),
147
+ stornoVermerk(receipt),
148
+ (() => {
149
+ const teile = nacherfassungTeile(receipt);
150
+ return teile ? { kind: 'manual_receipt', title: teile.title, lines: [...teile.anlass, ...teile.handbeleg] } : null;
151
+ })(),
152
+ signaturausfallVermerk(receipt),
153
+ ];
154
+ return vermerke.filter((v) => v !== null);
155
+ }
@@ -22,7 +22,7 @@ import { KasseneckApiError } from '../client/errors.js';
22
22
  * ueber `KasseneckApiError.code` lesbar; die Kasse braucht dafuer einen
23
23
  * Rueckfallzweig.
24
24
  */
25
- export declare const REGISTER_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_in_use", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "device_bound_elsewhere", "device_not_found", "device_not_paired", "device_takeover_required", "dialect_mismatch", "internal_translation_error", "licenses_exhausted", "live_not_enabled", "location_outside", "location_required", "login_failed", "login_mode_select_user", "login_unavailable", "method_not_allowed", "mfa_required", "not_found", "pairing_code_expired", "pairing_code_unknown", "pairing_code_used", "pairing_failed", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "second_factor_required", "session_ended", "session_expired", "session_not_running", "session_other_cashregister", "too_many_attempts", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
25
+ export declare const REGISTER_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_in_use", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "device_bound_elsewhere", "device_not_found", "device_not_paired", "device_takeover_required", "dialect_mismatch", "internal_translation_error", "invalid_terminal_address", "licenses_exhausted", "live_not_enabled", "location_outside", "location_required", "login_failed", "login_mode_select_user", "login_unavailable", "method_not_allowed", "mfa_required", "not_found", "pairing_code_expired", "pairing_code_unknown", "pairing_code_used", "pairing_failed", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "second_factor_required", "server_error", "session_ended", "session_expired", "session_not_running", "session_other_cashregister", "terminal_id_mismatch", "too_many_attempts", "too_many_changes", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
26
26
  export type RegisterErrorCode = typeof REGISTER_ERROR_CODES[number];
27
27
  export declare function isRegisterErrorCode(value: unknown): value is RegisterErrorCode;
28
28
  /** Der Code eines geworfenen Fehlers, wenn es einer der Kassen-Anmeldung ist; sonst `undefined`. */
@@ -41,6 +41,7 @@ export const REGISTER_ERROR_CODES = Object.freeze([
41
41
  'device_takeover_required',
42
42
  'dialect_mismatch',
43
43
  'internal_translation_error',
44
+ 'invalid_terminal_address',
44
45
  'licenses_exhausted',
45
46
  'live_not_enabled',
46
47
  'location_outside',
@@ -62,11 +63,14 @@ export const REGISTER_ERROR_CODES = Object.freeze([
62
63
  'register_user_only',
63
64
  'response_translation_failed',
64
65
  'second_factor_required',
66
+ 'server_error',
65
67
  'session_ended',
66
68
  'session_expired',
67
69
  'session_not_running',
68
70
  'session_other_cashregister',
71
+ 'terminal_id_mismatch',
69
72
  'too_many_attempts',
73
+ 'too_many_changes',
70
74
  'unauthorized',
71
75
  'user_disabled',
72
76
  'user_verification_failed',
@@ -59,6 +59,6 @@
59
59
  * daraus entstehende ID-Token und `sitzung.sessionId` ergeben zusammen
60
60
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
61
61
  */
62
- export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, REGISTER_PERMS, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterDeviceInfo, type RegisterSession, type RegisterSessionOverview, type ListRegisterSessionsForDeviceOptions, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
62
+ export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, REGISTER_PERMS, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterDeviceInfo, type RegisterSession, type RegisterSessionOverview, type ListRegisterSessionsForDeviceOptions, type ReportMyTerminalAddressOptions, type ReportedTerminalAddress, type ReportMyRegisterClientOptions, type ReportedRegisterClient, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, reportMyTerminalAddress, reportMyRegisterClient, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
63
63
  export { renewRegisterSession, endRegisterSession } from './session.js';
64
64
  export { REGISTER_ERROR_CODES, type RegisterErrorCode, isRegisterErrorCode, registerErrorCode, registerFieldErrors, type RegisterFieldError, isRegisterError, type RegisterErrorDetails, registerErrorDetails, } from './errors.js';
@@ -59,6 +59,6 @@
59
59
  * daraus entstehende ID-Token und `sitzung.sessionId` ergeben zusammen
60
60
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
61
61
  */
62
- export { REGISTER_PERMS, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
62
+ export { REGISTER_PERMS, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, reportMyTerminalAddress, reportMyRegisterClient, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
63
63
  export { renewRegisterSession, endRegisterSession } from './session.js';
64
64
  export { REGISTER_ERROR_CODES, isRegisterErrorCode, registerErrorCode, registerFieldErrors, isRegisterError, registerErrorDetails, } from './errors.js';
@@ -354,6 +354,57 @@ export declare function pairRegisterDevice(options: PairRegisterDeviceOptions):
354
354
  * Geraet meldet Erfolg. Danach das Geraet lokal vergessen.
355
355
  */
356
356
  export declare function unpairRegisterDevice(options: ListRegisterUsersForDeviceOptions): Promise<void>;
357
+ /** Eingabe von [reportMyTerminalAddress]: Ausweis des Geraets plus die Adresse, unter der das Terminal geantwortet hat. */
358
+ export interface ReportMyTerminalAddressOptions extends RegisterDeviceConnection, RegisterDeviceCredentials {
359
+ /** Terminal-ID (TID) der Kasse; der Server schreibt nur, wenn sie zur Einrichtung dieses Geraets passt. */
360
+ tid: string;
361
+ /** IPv4-Adresse, unter der das Terminal antwortet. */
362
+ host: string;
363
+ /** Port, 1 bis 65535. */
364
+ port: number;
365
+ }
366
+ /** Antwort von [reportMyTerminalAddress]: ob der Server die Adresse geaendert hat (`false` = war schon so). */
367
+ export interface ReportedTerminalAddress {
368
+ changed: boolean;
369
+ }
370
+ /**
371
+ * Meldet still, dass das Kartenterminal der Kasse unter einer neuen Adresse
372
+ * antwortet (nur Kassenweg `/api/v3`, Ausweis des Geraets wie bei
373
+ * [listRegisterUsersForDevice]; keine Sitzung einer Person noetig).
374
+ *
375
+ * Der Server schreibt genau zwei Felder (IP und Port des Terminals) und nur,
376
+ * wenn die TID zur Einrichtung dieses Geraets passt; jede Aenderung steht im
377
+ * Kassen-Protokoll. Antwort `{ changed }`. Wiederholen ist gefahrlos: dieselbe
378
+ * Adresse noch einmal meldet `changed: false`. Die Kasse zeigt dazu nichts an.
379
+ *
380
+ * Fehlercodes: `terminal_id_mismatch`, `invalid_terminal_address`,
381
+ * `too_many_changes` (heute zu oft geaendert), dazu `device_not_paired`.
382
+ * Geprueft wird hier nur die Form; die Adresse beurteilt der Server.
383
+ */
384
+ export declare function reportMyTerminalAddress(options: ReportMyTerminalAddressOptions): Promise<ReportedTerminalAddress>;
385
+ /** Eingabe von [reportMyRegisterClient]: Ausweis des Geraets plus die Bau-Kennung der laufenden Kasse. */
386
+ export interface ReportMyRegisterClientOptions extends RegisterDeviceConnection, RegisterDeviceCredentials {
387
+ /** Bau-Kennung der Kasse, z. B. `1.39.0/2026-11-13T18:20Z` (Browser) oder `kasse-app/1.0.3+34` (App). */
388
+ app: string;
389
+ }
390
+ /** Antwort von [reportMyRegisterClient]: ob der Server die Kennung geschrieben hat (`false` = unveraendert und jung genug). */
391
+ export interface ReportedRegisterClient {
392
+ written: boolean;
393
+ }
394
+ /**
395
+ * Meldet still, welche Fassung der Kasse auf diesem Geraet laeuft (nur
396
+ * Kassenweg `/api/v3`, Ausweis des Geraets wie bei [listRegisterUsersForDevice];
397
+ * keine Sitzung einer Person noetig). Gedacht fuer den Start, nach der
398
+ * Anmeldung und einen Takt von etwa 15 Minuten.
399
+ *
400
+ * Der Server schreibt die kuerzbare Kennung nur, wenn sie sich geaendert hat
401
+ * oder die letzte Meldung mindestens 10 Minuten alt ist; sonst `written: false`.
402
+ * Wiederholen ist gefahrlos. Die Kasse zeigt dazu nichts an.
403
+ *
404
+ * Fehlercodes: `device_not_paired` (falsches Geheimnis, unbekanntes oder
405
+ * gesperrtes Geraet), `server_error`. Geprueft wird hier nur die Form.
406
+ */
407
+ export declare function reportMyRegisterClient(options: ReportMyRegisterClientOptions): Promise<ReportedRegisterClient>;
357
408
  /** Eine laufende Sitzung an einer Kasse -- Zeile in der Auswahl. */
358
409
  export interface RegisterSession {
359
410
  id: string;
@@ -148,6 +148,63 @@ export async function unpairRegisterDevice(options) {
148
148
  pflicht(name, 'deviceSecret', deviceSecret);
149
149
  await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret }, undefined, [deviceSecret]);
150
150
  }
151
+ /**
152
+ * Meldet still, dass das Kartenterminal der Kasse unter einer neuen Adresse
153
+ * antwortet (nur Kassenweg `/api/v3`, Ausweis des Geraets wie bei
154
+ * [listRegisterUsersForDevice]; keine Sitzung einer Person noetig).
155
+ *
156
+ * Der Server schreibt genau zwei Felder (IP und Port des Terminals) und nur,
157
+ * wenn die TID zur Einrichtung dieses Geraets passt; jede Aenderung steht im
158
+ * Kassen-Protokoll. Antwort `{ changed }`. Wiederholen ist gefahrlos: dieselbe
159
+ * Adresse noch einmal meldet `changed: false`. Die Kasse zeigt dazu nichts an.
160
+ *
161
+ * Fehlercodes: `terminal_id_mismatch`, `invalid_terminal_address`,
162
+ * `too_many_changes` (heute zu oft geaendert), dazu `device_not_paired`.
163
+ * Geprueft wird hier nur die Form; die Adresse beurteilt der Server.
164
+ */
165
+ export async function reportMyTerminalAddress(options) {
166
+ const { ownerUid, deviceId, deviceSecret, tid, host, port, ...verbindung } = options;
167
+ const name = 'reportMyTerminalAddress';
168
+ pflicht(name, 'ownerUid', ownerUid);
169
+ pflicht(name, 'deviceId', deviceId);
170
+ pflicht(name, 'deviceSecret', deviceSecret);
171
+ pflicht(name, 'tid', tid);
172
+ pflicht(name, 'host', host);
173
+ if (typeof port !== 'number' || !Number.isInteger(port) || port < 1 || port > 65535) {
174
+ throw new KasseneckValidationError(name, 'port muss eine ganze Zahl von 1 bis 65535 sein', 'request');
175
+ }
176
+ const daten = await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret, tid, host, port }, undefined, [deviceSecret]);
177
+ if (typeof daten?.changed !== 'boolean') {
178
+ throw antwortfehler(name, 'Antwort enthaelt kein changed');
179
+ }
180
+ return { changed: daten.changed };
181
+ }
182
+ /**
183
+ * Meldet still, welche Fassung der Kasse auf diesem Geraet laeuft (nur
184
+ * Kassenweg `/api/v3`, Ausweis des Geraets wie bei [listRegisterUsersForDevice];
185
+ * keine Sitzung einer Person noetig). Gedacht fuer den Start, nach der
186
+ * Anmeldung und einen Takt von etwa 15 Minuten.
187
+ *
188
+ * Der Server schreibt die kuerzbare Kennung nur, wenn sie sich geaendert hat
189
+ * oder die letzte Meldung mindestens 10 Minuten alt ist; sonst `written: false`.
190
+ * Wiederholen ist gefahrlos. Die Kasse zeigt dazu nichts an.
191
+ *
192
+ * Fehlercodes: `device_not_paired` (falsches Geheimnis, unbekanntes oder
193
+ * gesperrtes Geraet), `server_error`. Geprueft wird hier nur die Form.
194
+ */
195
+ export async function reportMyRegisterClient(options) {
196
+ const { ownerUid, deviceId, deviceSecret, app, ...verbindung } = options;
197
+ const name = 'reportMyRegisterClient';
198
+ pflicht(name, 'ownerUid', ownerUid);
199
+ pflicht(name, 'deviceId', deviceId);
200
+ pflicht(name, 'deviceSecret', deviceSecret);
201
+ pflicht(name, 'app', app);
202
+ const daten = await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret, app }, undefined, [deviceSecret]);
203
+ if (typeof daten?.written !== 'boolean') {
204
+ throw antwortfehler(name, 'Antwort enthaelt kein written');
205
+ }
206
+ return { written: daten.written };
207
+ }
151
208
  /**
152
209
  * Welche Sitzungen haelt diese Kasse gerade?
153
210
  *
@@ -233,6 +233,30 @@ export function _storedReceiptInner(doc, functionName) {
233
233
  export function pruefangabenDerHuelle(p) {
234
234
  return { karteRegistriertAm: alsIso(p.karteRegistriertAm), kasseRegistriertAm: alsIso(p.kasseRegistriertAm) };
235
235
  }
236
+ /**
237
+ * Steuerhinweis der Zahlung auf Rechnung: innen `steuerhinweis` (`inkl_ust` | `null_prozent` | `siehe_rechnung`),
238
+ * aussen `taxNote` (`incl_vat` | `zero_percent` | `see_invoice`). Der Vertrags-Export kennt die Umbenennung und den
239
+ * Wertekatalog inzwischen; diese Zeile bleibt trotzdem, weil sie bewusst deutsche UND englische Werte annimmt
240
+ * (Huellen kommen innen wie aussen vor). Ein anderer oder fehlender Wert ergibt keinen Hinweis; das alte Feld
241
+ * `includesVat` faellt weg.
242
+ */
243
+ const STEUERHINWEIS_AUSSEN = {
244
+ inkl_ust: 'incl_vat', null_prozent: 'zero_percent', siehe_rechnung: 'see_invoice',
245
+ incl_vat: 'incl_vat', zero_percent: 'zero_percent', see_invoice: 'see_invoice',
246
+ };
247
+ function rechnungszahlungNachAussen(beleg) {
248
+ if (!Array.isArray(beleg.invoicePayments))
249
+ return beleg;
250
+ const invoicePayments = beleg.invoicePayments.map((e) => {
251
+ if (!istObjekt(e))
252
+ return e;
253
+ const { steuerhinweis, taxNote, includesVat: _alt, ...rest } = e;
254
+ const roh = steuerhinweis ?? taxNote;
255
+ const aussen = typeof roh === 'string' && hat(STEUERHINWEIS_AUSSEN, roh) ? STEUERHINWEIS_AUSSEN[roh] : undefined;
256
+ return aussen === undefined ? rest : { ...rest, taxNote: aussen };
257
+ });
258
+ return { ...beleg, invoicePayments };
259
+ }
236
260
  /**
237
261
  * Eine Beleg-Huelle der inneren Form (`receipt`, Betriebsfelder, `kopfId`,
238
262
  * `pruefangaben`, `testKasse` ...) in die Drahtform von `getReceipt` unter
@@ -241,7 +265,7 @@ export function pruefangabenDerHuelle(p) {
241
265
  export function _receiptEnvelopeToWire(huelle) {
242
266
  const schema = SCHEMAS.getReceipt;
243
267
  const draht = werteNachAussen(schluesselNachAussen(huelle, schema.data), schema.werte);
244
- return istObjekt(draht.receipt) ? { ...draht, receipt: belegGutscheineNachAussen(belegRueckgabeNachAussen(draht.receipt)) } : draht;
268
+ return istObjekt(draht.receipt) ? { ...draht, receipt: rechnungszahlungNachAussen(belegGutscheineNachAussen(belegRueckgabeNachAussen(draht.receipt))) } : draht;
245
269
  }
246
270
  /**
247
271
  * Ein Belegdokument (`users/{uid}/cashregisters/{id}/receipts/{id}`) in der
@@ -1,4 +1,4 @@
1
- import { POS_BUSINESS_DEFAULTS, POS_BUSINESS_VALUES, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_DEVICE_VALUES, POS_SHORTCUT_DEFAULTS, POS_SHORTCUT_SHARED_PAIRS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_BUSINESS_OPTIONAL_LISTS, POS_DEVICE_OPTIONAL_CHOICES, _optionalerWert, } from '../pos/settings.js';
1
+ import { POS_BUSINESS_DEFAULTS, POS_BUSINESS_VALUES, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_DEVICE_OPTIONAL_SWITCHES, POS_DEVICE_VALUES, POS_SHORTCUT_DEFAULTS, POS_SHORTCUT_SHARED_PAIRS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_BUSINESS_OPTIONAL_LISTS, POS_DEVICE_OPTIONAL_CHOICES, _optionalerWert, } from '../pos/settings.js';
2
2
  import { hat, innereNamen, istObjekt, regel } from './draht.js';
3
3
  import { katalogVon } from './draht.js';
4
4
  import { checkDiscountPresets, discountChipsFromPresets } from '../pos/rabatt-vorlagen.js';
@@ -49,7 +49,10 @@ const PRUEFER = {
49
49
  * gueltiger Text gespeichert sind; sonst fehlen sie still, ohne Eintrag in
50
50
  * `weggelassen` (der Server meldet sie dann auch nicht).
51
51
  */
52
- const GERAET_OPTIONAL = Object.fromEntries(POS_DEVICE_OPTIONAL_FIELDS.map((feld) => [feld, (v) => _optionalerWert(v, false)]));
52
+ const GERAET_OPTIONAL = Object.fromEntries([
53
+ ...POS_DEVICE_OPTIONAL_FIELDS.map((feld) => [feld, (v) => _optionalerWert(v, false)]),
54
+ ...POS_DEVICE_OPTIONAL_SWITCHES.map((feld) => [feld, (v) => typeof v === 'boolean']),
55
+ ]);
53
56
  /**
54
57
  * Optionale Betriebs-Schalter (Zwilling von `BETRIEB_OPTIONAL` und
55
58
  * `mischeBetrieb`): sie gehen nur hinaus, wenn sie als Wahrheitswert
@@ -290,6 +293,6 @@ export const _PRUEFER_FELDER = Object.freeze({
290
293
  device: [...new Set([...Object.keys(PRUEFER.device), ...Object.keys(POS_DEVICE_VALUES), ...Object.keys(GERAET_OPTIONAL), 'shortcuts'])],
291
294
  standard: {
292
295
  business: [...Object.keys(POS_BUSINESS_DEFAULTS), ...POS_BUSINESS_OPTIONAL_FIELDS, ...POS_BUSINESS_OPTIONAL_CHOICES, ...POS_BUSINESS_OPTIONAL_LISTS],
293
- device: [...Object.keys(POS_DEVICE_DEFAULTS), ...POS_DEVICE_OPTIONAL_FIELDS, ...POS_DEVICE_OPTIONAL_CHOICES],
296
+ device: [...Object.keys(POS_DEVICE_DEFAULTS), ...POS_DEVICE_OPTIONAL_FIELDS, ...POS_DEVICE_OPTIONAL_SWITCHES, ...POS_DEVICE_OPTIONAL_CHOICES],
294
297
  },
295
298
  });
@@ -1,5 +1,5 @@
1
1
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
2
- export declare const VOKABULAR_QUELLE = "78eb90dbffbd44f2b16d78963d35c6e977245f5f53bb171a19b73b15d5cb0a3c";
2
+ export declare const VOKABULAR_QUELLE = "ab188a33a1f0d07b187347e0293b935e41435fa61dc1078cd164b10cc2be5f46";
3
3
  /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
4
4
  export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
5
5
  export interface SchemaObjekt {
@@ -1,7 +1,7 @@
1
1
  // Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
2
2
  // Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
3
3
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
4
- export const VOKABULAR_QUELLE = "78eb90dbffbd44f2b16d78963d35c6e977245f5f53bb171a19b73b15d5cb0a3c";
4
+ export const VOKABULAR_QUELLE = "ab188a33a1f0d07b187347e0293b935e41435fa61dc1078cd164b10cc2be5f46";
5
5
  /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
6
6
  export const SCHEMAS = {
7
7
  "getReceipt": {
@@ -42,7 +42,18 @@ export const SCHEMAS = {
42
42
  "sharedReturnPoint": {
43
43
  "__": "pfandStelle",
44
44
  "address": "adresse"
45
- }
45
+ },
46
+ "invoicePayments": [
47
+ {
48
+ "__": "rechnungszahlung",
49
+ "invoiceNumber": "nummer",
50
+ "customerId": "kundeId",
51
+ "amountCents": "betragCents",
52
+ "partial": "teil",
53
+ "paidOn": "zahlungVom",
54
+ "taxNote": "steuerhinweis"
55
+ }
56
+ ]
46
57
  },
47
58
  "taxNumber": "taxnr",
48
59
  "vatId": "uid",
@@ -112,6 +123,9 @@ export const SCHEMAS = {
112
123
  "receipt.items[].depositKind": {
113
124
  "$catalog": "PFAND_ART"
114
125
  },
126
+ "receipt.invoicePayments[].taxNote": {
127
+ "$catalog": "RECHNUNGSZAHLUNG_STEUERHINWEIS"
128
+ },
115
129
  "issuedVouchers[].type": {
116
130
  "$catalog": "GUTSCHEIN_ART"
117
131
  },
@@ -247,6 +261,7 @@ export const SCHEMAS = {
247
261
  "terminalVia": "terminalVia",
248
262
  "terminalType": "terminalArt",
249
263
  "shortcutHints": "tastenMarken",
264
+ "printerHint": "druckerHinweis",
250
265
  "cartWidth": "korbBreite"
251
266
  },
252
267
  "vouchers": {
@@ -853,6 +868,11 @@ export const KATALOGE = {
853
868
  "glas": "glass",
854
869
  "sonstiges": "other"
855
870
  },
871
+ "RECHNUNGSZAHLUNG_STEUERHINWEIS": {
872
+ "inkl_ust": "incl_vat",
873
+ "null_prozent": "zero_percent",
874
+ "siehe_rechnung": "see_invoice"
875
+ },
856
876
  "REFERENZ_STUFE": {
857
877
  "fragen": "optional",
858
878
  "pflicht": "required"
@@ -4,4 +4,4 @@
4
4
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
5
5
  * beim Anheben der Version beide Stellen aendern.
6
6
  */
7
- export declare const PACKAGE_VERSION = "1.37.0";
7
+ export declare const PACKAGE_VERSION = "1.39.0";
@@ -4,4 +4,4 @@
4
4
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
5
5
  * beim Anheben der Version beide Stellen aendern.
6
6
  */
7
- export const PACKAGE_VERSION = '1.37.0';
7
+ export const PACKAGE_VERSION = '1.39.0';
@@ -0,0 +1,28 @@
1
+ Bäckerei Kornblum
2
+ Hauptplatz 1
3
+ 4830 Hallstatt
4
+ ATU12345675
5
+ +43 6134 12345
6
+
7
+ ================================
8
+ STORNOBELEG
9
+ ================================
10
+ Stornobuchung zu Beleg
11
+ AT0-KASSE1-117
12
+ vom 11.11.2026, 09:14 Uhr
13
+ Grund: Fehleingabe
14
+
15
+ Datum: 11.11.2026 11:02:05
16
+ Kassen-ID: KASSE1
17
+ Beleg-ID: AT0-KASSE1-119
18
+
19
+ Zahlung auf Rechnung -1569,60
20
+ 2026-0042
21
+ inkl. USt
22
+ --------------------------------
23
+ Gesamt: -1569,60 €
24
+ Zahlungsart: Barzahlung
25
+
26
+ [QR-Code]
27
+
28
+ Vielen Dank für Ihren Einkauf
@@ -0,0 +1,26 @@
1
+ Bäckerei Kornblum
2
+ Hauptplatz 1
3
+ 4830 Hallstatt
4
+ ATU12345675
5
+ +43 6134 12345
6
+
7
+ ================================================
8
+ STORNOBELEG
9
+ ================================================
10
+ Stornobuchung zu Beleg AT0-KASSE1-117
11
+ vom 11.11.2026, 09:14 Uhr
12
+ Grund: Fehleingabe
13
+
14
+ Datum: 11.11.2026 11:02:05
15
+ Kassen-ID: KASSE1
16
+ Beleg-ID: AT0-KASSE1-119
17
+
18
+ Zahlung auf Rechnung 2026-0042 -1569,60
19
+ inkl. USt
20
+ ------------------------------------------------
21
+ Gesamt: -1569,60 €
22
+ Zahlungsart: Barzahlung
23
+
24
+ [QR-Code]
25
+
26
+ Vielen Dank für Ihren Einkauf