@kreiseck/kasseneck-api 1.36.0 → 1.38.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 (226) hide show
  1. package/CHANGELOG.md +45 -1
  2. package/README.md +16 -0
  3. package/dist/cjs/client/aufrufe.d.ts +2 -2
  4. package/dist/cjs/client/aufrufe.js +5 -0
  5. package/dist/cjs/client/receipts.d.ts +1 -1
  6. package/dist/cjs/index.d.ts +1 -1
  7. package/dist/cjs/index.js +6 -5
  8. package/dist/cjs/invoice/texte.d.ts +18 -1
  9. package/dist/cjs/invoice/texte.js +43 -2
  10. package/dist/cjs/invoice/vertrag.d.ts +1 -1
  11. package/dist/cjs/invoice/vertrag.js +1 -0
  12. package/dist/cjs/models/cancellation.d.ts +1 -1
  13. package/dist/cjs/models/cancellation.js +2 -0
  14. package/dist/cjs/models/index.d.ts +2 -1
  15. package/dist/cjs/models/index.js +6 -3
  16. package/dist/cjs/models/invoice-payment-ref.d.ts +42 -0
  17. package/dist/cjs/models/invoice-payment-ref.js +38 -0
  18. package/dist/cjs/models/receipt-item.d.ts +10 -2
  19. package/dist/cjs/models/receipt-item.js +14 -1
  20. package/dist/cjs/models/receipt.d.ts +7 -0
  21. package/dist/cjs/models/receipt.js +6 -0
  22. package/dist/cjs/payments/hobex-hps/index.d.ts +2 -1
  23. package/dist/cjs/payments/hobex-hps/index.js +3 -1
  24. package/dist/cjs/payments/hobex-hps/outcome.d.ts +10 -0
  25. package/dist/cjs/payments/hobex-hps/payments.d.ts +54 -0
  26. package/dist/cjs/payments/hobex-hps/payments.js +157 -1
  27. package/dist/cjs/payments/hobex-hps/support.d.ts +19 -0
  28. package/dist/cjs/payments/hobex-hps/support.js +22 -0
  29. package/dist/cjs/payments/hobex-hps/transaction-response.js +1 -1
  30. package/dist/cjs/payments/index.d.ts +1 -1
  31. package/dist/cjs/payments/index.js +2 -1
  32. package/dist/cjs/pos/errors.d.ts +1 -1
  33. package/dist/cjs/pos/errors.js +1 -0
  34. package/dist/cjs/pos/index.d.ts +4 -4
  35. package/dist/cjs/pos/index.js +13 -5
  36. package/dist/cjs/pos/schicht-lesen.d.ts +3 -1
  37. package/dist/cjs/pos/schicht-lesen.js +28 -1
  38. package/dist/cjs/pos/schicht-typen.d.ts +50 -4
  39. package/dist/cjs/pos/schicht-typen.js +7 -2
  40. package/dist/cjs/pos/schicht.d.ts +6 -4
  41. package/dist/cjs/pos/schicht.js +6 -3
  42. package/dist/cjs/pos/settings.d.ts +37 -8
  43. package/dist/cjs/pos/settings.js +34 -10
  44. package/dist/cjs/pos/texte.d.ts +262 -4
  45. package/dist/cjs/pos/texte.js +157 -7
  46. package/dist/cjs/pos/trinkgeld.d.ts +30 -0
  47. package/dist/cjs/pos/trinkgeld.js +30 -0
  48. package/dist/cjs/receipt/index.d.ts +1 -0
  49. package/dist/cjs/receipt/index.js +4 -2
  50. package/dist/cjs/receipt/layout.d.ts +2 -2
  51. package/dist/cjs/receipt/layout.js +106 -117
  52. package/dist/cjs/receipt/shift-sheet.js +12 -2
  53. package/dist/cjs/receipt/vermerke.d.ts +80 -0
  54. package/dist/cjs/receipt/vermerke.js +167 -0
  55. package/dist/cjs/register/pairing.d.ts +4 -0
  56. package/dist/cjs/register/pairing.js +2 -0
  57. package/dist/cjs/stored/draht.js +25 -1
  58. package/dist/cjs/stored/vokabular.d.ts +1 -1
  59. package/dist/cjs/stored/vokabular.js +32 -2
  60. package/dist/cjs/version.d.ts +1 -1
  61. package/dist/cjs/version.js +1 -1
  62. package/dist/esm/client/aufrufe.d.ts +2 -2
  63. package/dist/esm/client/aufrufe.js +5 -0
  64. package/dist/esm/client/receipts.d.ts +1 -1
  65. package/dist/esm/index.d.ts +1 -1
  66. package/dist/esm/index.js +1 -1
  67. package/dist/esm/invoice/texte.d.ts +18 -1
  68. package/dist/esm/invoice/texte.js +43 -2
  69. package/dist/esm/invoice/vertrag.d.ts +1 -1
  70. package/dist/esm/invoice/vertrag.js +1 -0
  71. package/dist/esm/models/cancellation.d.ts +1 -1
  72. package/dist/esm/models/cancellation.js +2 -0
  73. package/dist/esm/models/index.d.ts +2 -1
  74. package/dist/esm/models/index.js +2 -1
  75. package/dist/esm/models/invoice-payment-ref.d.ts +42 -0
  76. package/dist/esm/models/invoice-payment-ref.js +35 -0
  77. package/dist/esm/models/receipt-item.d.ts +10 -2
  78. package/dist/esm/models/receipt-item.js +13 -1
  79. package/dist/esm/models/receipt.d.ts +7 -0
  80. package/dist/esm/models/receipt.js +6 -0
  81. package/dist/esm/payments/hobex-hps/index.d.ts +2 -1
  82. package/dist/esm/payments/hobex-hps/index.js +1 -0
  83. package/dist/esm/payments/hobex-hps/outcome.d.ts +10 -0
  84. package/dist/esm/payments/hobex-hps/payments.d.ts +54 -0
  85. package/dist/esm/payments/hobex-hps/payments.js +158 -2
  86. package/dist/esm/payments/hobex-hps/support.d.ts +19 -0
  87. package/dist/esm/payments/hobex-hps/support.js +19 -0
  88. package/dist/esm/payments/hobex-hps/transaction-response.js +1 -1
  89. package/dist/esm/payments/index.d.ts +1 -1
  90. package/dist/esm/payments/index.js +1 -1
  91. package/dist/esm/pos/errors.d.ts +1 -1
  92. package/dist/esm/pos/errors.js +1 -0
  93. package/dist/esm/pos/index.d.ts +4 -4
  94. package/dist/esm/pos/index.js +5 -5
  95. package/dist/esm/pos/schicht-lesen.d.ts +3 -1
  96. package/dist/esm/pos/schicht-lesen.js +27 -1
  97. package/dist/esm/pos/schicht-typen.d.ts +50 -4
  98. package/dist/esm/pos/schicht-typen.js +6 -1
  99. package/dist/esm/pos/schicht.d.ts +6 -4
  100. package/dist/esm/pos/schicht.js +6 -3
  101. package/dist/esm/pos/settings.d.ts +37 -8
  102. package/dist/esm/pos/settings.js +30 -9
  103. package/dist/esm/pos/texte.d.ts +262 -4
  104. package/dist/esm/pos/texte.js +156 -6
  105. package/dist/esm/pos/trinkgeld.d.ts +30 -0
  106. package/dist/esm/pos/trinkgeld.js +28 -0
  107. package/dist/esm/receipt/index.d.ts +1 -0
  108. package/dist/esm/receipt/index.js +1 -0
  109. package/dist/esm/receipt/layout.d.ts +2 -2
  110. package/dist/esm/receipt/layout.js +103 -113
  111. package/dist/esm/receipt/shift-sheet.js +12 -2
  112. package/dist/esm/receipt/vermerke.d.ts +80 -0
  113. package/dist/esm/receipt/vermerke.js +155 -0
  114. package/dist/esm/register/pairing.d.ts +4 -0
  115. package/dist/esm/register/pairing.js +2 -0
  116. package/dist/esm/stored/draht.js +25 -1
  117. package/dist/esm/stored/vokabular.d.ts +1 -1
  118. package/dist/esm/stored/vokabular.js +32 -2
  119. package/dist/esm/version.d.ts +1 -1
  120. package/dist/esm/version.js +1 -1
  121. package/fixtures/duplicate-cases.json +1 -1
  122. package/fixtures/expected/duplicate.shift-close.hex +1 -1
  123. package/fixtures/expected/invoice-payment-cancellation.grid32.txt +28 -0
  124. package/fixtures/expected/invoice-payment-cancellation.grid48.txt +26 -0
  125. package/fixtures/expected/invoice-payment-cancellation.lines.json +189 -0
  126. package/fixtures/expected/invoice-payment-cancellation.sheet32.json +194 -0
  127. package/fixtures/expected/invoice-payment-cancellation.sheet48.json +182 -0
  128. package/fixtures/expected/invoice-payment-manual-receipt.grid32.txt +30 -0
  129. package/fixtures/expected/invoice-payment-manual-receipt.grid48.txt +29 -0
  130. package/fixtures/expected/invoice-payment-manual-receipt.lines.json +199 -0
  131. package/fixtures/expected/invoice-payment-manual-receipt.sheet32.json +206 -0
  132. package/fixtures/expected/invoice-payment-manual-receipt.sheet48.json +200 -0
  133. package/fixtures/expected/invoice-payment-normal.grid32.txt +22 -0
  134. package/fixtures/expected/invoice-payment-normal.grid48.txt +21 -0
  135. package/fixtures/expected/invoice-payment-normal.lines.json +192 -0
  136. package/fixtures/expected/invoice-payment-normal.sheet32.json +158 -0
  137. package/fixtures/expected/invoice-payment-normal.sheet48.json +152 -0
  138. package/fixtures/expected/invoice-payment-outage.grid32.txt +23 -0
  139. package/fixtures/expected/invoice-payment-outage.grid48.txt +21 -0
  140. package/fixtures/expected/invoice-payment-outage.lines.json +172 -0
  141. package/fixtures/expected/invoice-payment-outage.sheet32.json +164 -0
  142. package/fixtures/expected/invoice-payment-outage.sheet48.json +152 -0
  143. package/fixtures/expected/invoice-payment-partial.grid32.txt +20 -0
  144. package/fixtures/expected/invoice-payment-partial.grid48.txt +20 -0
  145. package/fixtures/expected/invoice-payment-partial.lines.json +162 -0
  146. package/fixtures/expected/invoice-payment-partial.sheet32.json +146 -0
  147. package/fixtures/expected/invoice-payment-partial.sheet48.json +146 -0
  148. package/fixtures/expected/invoice-payment-refund.grid32.txt +20 -0
  149. package/fixtures/expected/invoice-payment-refund.grid48.txt +20 -0
  150. package/fixtures/expected/invoice-payment-refund.lines.json +162 -0
  151. package/fixtures/expected/invoice-payment-refund.sheet32.json +146 -0
  152. package/fixtures/expected/invoice-payment-refund.sheet48.json +146 -0
  153. package/fixtures/expected/invoice-payment-see-invoice.grid32.txt +22 -0
  154. package/fixtures/expected/invoice-payment-see-invoice.grid48.txt +21 -0
  155. package/fixtures/expected/invoice-payment-see-invoice.lines.json +192 -0
  156. package/fixtures/expected/invoice-payment-see-invoice.sheet32.json +158 -0
  157. package/fixtures/expected/invoice-payment-see-invoice.sheet48.json +152 -0
  158. package/fixtures/expected/invoice-payment-training.grid32.txt +30 -0
  159. package/fixtures/expected/invoice-payment-training.grid48.txt +27 -0
  160. package/fixtures/expected/invoice-payment-training.lines.json +183 -0
  161. package/fixtures/expected/invoice-payment-training.sheet32.json +206 -0
  162. package/fixtures/expected/invoice-payment-training.sheet48.json +188 -0
  163. package/fixtures/expected/invoice-payment-without-vat.grid32.txt +20 -0
  164. package/fixtures/expected/invoice-payment-without-vat.grid48.txt +19 -0
  165. package/fixtures/expected/invoice-payment-without-vat.lines.json +162 -0
  166. package/fixtures/expected/invoice-payment-without-vat.sheet32.json +146 -0
  167. package/fixtures/expected/invoice-payment-without-vat.sheet48.json +140 -0
  168. package/fixtures/expected/invoice-payment-zero-percent.grid32.txt +22 -0
  169. package/fixtures/expected/invoice-payment-zero-percent.grid48.txt +21 -0
  170. package/fixtures/expected/invoice-payment-zero-percent.lines.json +192 -0
  171. package/fixtures/expected/invoice-payment-zero-percent.sheet32.json +158 -0
  172. package/fixtures/expected/invoice-payment-zero-percent.sheet48.json +152 -0
  173. package/fixtures/expected/shift-close-card-tips.grid32.txt +44 -0
  174. package/fixtures/expected/shift-close-card-tips.grid48.txt +40 -0
  175. package/fixtures/expected/shift-close-card-tips.lines.json +479 -0
  176. package/fixtures/expected/shift-close-put-in.grid32.txt +1 -1
  177. package/fixtures/expected/shift-close-put-in.grid48.txt +1 -1
  178. package/fixtures/expected/shift-close-put-in.lines.json +1 -1
  179. package/fixtures/expected/shift-close-take-out.grid32.txt +1 -1
  180. package/fixtures/expected/shift-close-take-out.grid48.txt +1 -1
  181. package/fixtures/expected/shift-close-take-out.lines.json +1 -1
  182. package/fixtures/expected/shift-close.grid32.txt +1 -1
  183. package/fixtures/expected/shift-close.grid48.txt +1 -1
  184. package/fixtures/expected/shift-close.lines.json +1 -1
  185. package/fixtures/expected/shift-interim-card-tips.grid32.txt +34 -0
  186. package/fixtures/expected/shift-interim-card-tips.grid48.txt +31 -0
  187. package/fixtures/expected/shift-interim-card-tips.lines.json +344 -0
  188. package/fixtures/hobex-hps-codes.json +2 -2
  189. package/fixtures/invoice-api.schema.json +3 -2
  190. package/fixtures/invoice-texts.json +37 -3
  191. package/fixtures/manifest.json +80 -0
  192. package/fixtures/pos-message-cases.json +3 -0
  193. package/fixtures/pos-texts.json +313 -3
  194. package/fixtures/receipt-due-generated.json +3 -3
  195. package/fixtures/receipt-due-voucher-generated.json +5 -5
  196. package/fixtures/receipts/invoice-payment-cancellation.json +70 -0
  197. package/fixtures/receipts/invoice-payment-manual-receipt.json +69 -0
  198. package/fixtures/receipts/invoice-payment-normal.json +65 -0
  199. package/fixtures/receipts/invoice-payment-outage.json +63 -0
  200. package/fixtures/receipts/invoice-payment-partial.json +63 -0
  201. package/fixtures/receipts/invoice-payment-refund.json +63 -0
  202. package/fixtures/receipts/invoice-payment-see-invoice.json +65 -0
  203. package/fixtures/receipts/invoice-payment-training.json +63 -0
  204. package/fixtures/receipts/invoice-payment-without-vat.json +63 -0
  205. package/fixtures/receipts/invoice-payment-zero-percent.json +65 -0
  206. package/fixtures/renames-1.0.json +10 -0
  207. package/fixtures/shift-ablauf-cases.json +4 -4
  208. package/fixtures/shift-cases.json +4 -2
  209. package/fixtures/shift-receipts-card-tips.json +73 -0
  210. package/fixtures/shift-receipts.json +9 -9
  211. package/fixtures/stored/card-tip-cases.json +132 -0
  212. package/fixtures/surface.json +23 -6
  213. package/fixtures/v3/antworten/belege.json +2 -2
  214. package/fixtures/v3/antworten/belegmail.json +2 -2
  215. package/fixtures/v3/antworten/berichte.json +2 -2
  216. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  217. package/fixtures/v3/antworten/kasse.json +247 -127
  218. package/fixtures/v3/antworten/lager.json +1 -1
  219. package/fixtures/v3/antworten/rechnungen.json +2 -2
  220. package/fixtures/v3/antworten/storno.json +2 -2
  221. package/fixtures/v3/stored/belege.json +2 -2
  222. package/fixtures/v3/stored/kasse.json +3 -3
  223. package/fixtures/v3/stored/rechnungen.json +2 -2
  224. package/fixtures/v3/v3-vokabular.json +264 -21
  225. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  226. package/package.json +1 -1
@@ -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
+ }
@@ -144,12 +144,16 @@ export interface RegisterDeviceUsers {
144
144
  * statt an createReceipt zu scheitern. Fehlt das Feld, gilt bereit.
145
145
  * `stockLocationId`: Lager-Standort der Kasse, fehlt = Standard-Standort.
146
146
  * `deposit`: Pfand & Leergut der Kasse (Ruecknahme, Vorgaben); fehlt, solange der Betrieb kein Pfand eingeschaltet hat.
147
+ * `cardTips`: Kartentrinkgeld laeuft an diesem Konto ueber die Kasse (Spec 2026-11-11-kartentrinkgeld, § 7): die
148
+ * Kasse zeigt die Karten-Stufe, die Trinkgeld-Zeile nach dem Kassieren und „Mein Trinkgeld“. Nur `true`, sonst fehlt
149
+ * es -- ohne bleibt die Kasse genau wie bisher.
147
150
  */
148
151
  cashregister?: {
149
152
  ready: boolean;
150
153
  reason?: string | null;
151
154
  stockLocationId?: string;
152
155
  deposit?: CashRegisterDeposit;
156
+ cardTips?: true;
153
157
  };
154
158
  /** Das Geraet haengt an der Test-Umgebung des Betriebs. */
155
159
  testEnvironment: boolean;
@@ -243,6 +243,8 @@ function kasseBereit(wert) {
243
243
  reason: typeof roh['reason'] === 'string' ? roh['reason'] : null,
244
244
  ...(typeof standort === 'string' && standort !== '' ? { stockLocationId: standort } : {}),
245
245
  ...(cashRegisterDepositFromWire(roh['deposit']) ? { deposit: cashRegisterDepositFromWire(roh['deposit']) } : {}),
246
+ // Nur ein echtes `true` schaltet die Oberflaeche um; alles andere (fehlt, false, Muell) laesst sie wie bisher.
247
+ ...(roh['cardTips'] === true ? { cardTips: true } : {}),
246
248
  };
247
249
  }
248
250
  /** Die Regel aus der Antwort — oder `null`, wenn keine brauchbare kommt. */
@@ -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,5 +1,5 @@
1
1
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
2
- export declare const VOKABULAR_QUELLE = "3c10f47f66f048d8b25adb8996414674261ec8eb4c55f82a1d2a239be13d289f";
2
+ export declare const VOKABULAR_QUELLE = "7e41f406752cf109d3809bd187db0dfccceafbc3c9d88305edf32c98d57bced3";
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 = "3c10f47f66f048d8b25adb8996414674261ec8eb4c55f82a1d2a239be13d289f";
4
+ export const VOKABULAR_QUELLE = "7e41f406752cf109d3809bd187db0dfccceafbc3c9d88305edf32c98d57bced3";
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
  },
@@ -170,6 +184,9 @@ export const SCHEMAS = {
170
184
  "tipKeptMode": "tgDirektModus",
171
185
  "tipKinds": "tgArten",
172
186
  "tipStart": "tgStart",
187
+ "tipCardKeptByDefault": "tgKarteDirekt",
188
+ "tipCardKeptMode": "tgKarteModus",
189
+ "tipSelfPayout": "tgSelbstAuszahlen",
173
190
  "checkoutMode": "kassierenModus",
174
191
  "receiptOutput": "belegAusgabe",
175
192
  "doneScreenSeconds": "fertigSekunden",
@@ -386,6 +403,9 @@ export const SCHEMAS = {
386
403
  "business.tipKeptMode": {
387
404
  "$catalog": "KASSE_BETRIEB_WERTE.tipKeptMode"
388
405
  },
406
+ "business.tipCardKeptMode": {
407
+ "$catalog": "KASSE_BETRIEB_WERTE.tipCardKeptMode"
408
+ },
389
409
  "business.discountPresets[].kind": {
390
410
  "$catalog": "KASSE_BETRIEB_WERTE.discountPresets[].kind"
391
411
  },
@@ -754,6 +774,11 @@ export const KATALOGE = {
754
774
  "streifen": "stripe",
755
775
  "voll": "full"
756
776
  },
777
+ "KASSE_BETRIEB_WERTE.tipCardKeptMode": {
778
+ "fragen": "ask",
779
+ "immer": "always",
780
+ "nie": "never"
781
+ },
757
782
  "KASSE_BETRIEB_WERTE.tipKeptMode": {
758
783
  "fragen": "ask",
759
784
  "immer": "always",
@@ -842,6 +867,11 @@ export const KATALOGE = {
842
867
  "glas": "glass",
843
868
  "sonstiges": "other"
844
869
  },
870
+ "RECHNUNGSZAHLUNG_STEUERHINWEIS": {
871
+ "inkl_ust": "incl_vat",
872
+ "null_prozent": "zero_percent",
873
+ "siehe_rechnung": "see_invoice"
874
+ },
845
875
  "REFERENZ_STUFE": {
846
876
  "fragen": "optional",
847
877
  "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.36.0";
7
+ export declare const PACKAGE_VERSION = "1.38.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.36.0';
7
+ export const PACKAGE_VERSION = '1.38.0';
@@ -3718,7 +3718,7 @@
3718
3718
  "kind": "columns",
3719
3719
  "columns": [
3720
3720
  {
3721
- "text": " schon genommen",
3721
+ "text": " genommen",
3722
3722
  "width": 8,
3723
3723
  "align": "left"
3724
3724
  },
@@ -40,5 +40,5 @@
40
40
  2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d0a1b45011c2e1b74
41
41
  105472696e6b67656c640a1b45001c2e1b741042656e204b656c6c6e65720a1c
42
42
  2e1b741020207665726469656e74202020202020202020202020202020202020
43
- 342c30300a1c2e1b741020207363686f6e2067656e6f6d6d656e202020202020
43
+ 342c30300a1c2e1b7410202067656e6f6d6d656e202020202020202020202020
44
44
  202020202020342c30300a0a0a0a0a0a1d5630
@@ -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
@@ -0,0 +1,189 @@
1
+ {
2
+ "lines": [
3
+ {
4
+ "kind": "text",
5
+ "text": "Bäckerei Kornblum",
6
+ "align": "center",
7
+ "bold": true
8
+ },
9
+ {
10
+ "kind": "text",
11
+ "text": "Hauptplatz 1",
12
+ "align": "center",
13
+ "bold": false
14
+ },
15
+ {
16
+ "kind": "text",
17
+ "text": "4830 Hallstatt",
18
+ "align": "center",
19
+ "bold": false
20
+ },
21
+ {
22
+ "kind": "text",
23
+ "text": "ATU12345675",
24
+ "align": "center",
25
+ "bold": false
26
+ },
27
+ {
28
+ "kind": "text",
29
+ "text": "+43 6134 12345",
30
+ "align": "center",
31
+ "bold": false
32
+ },
33
+ {
34
+ "kind": "space",
35
+ "lines": 1
36
+ },
37
+ {
38
+ "kind": "banner",
39
+ "text": "STORNOBELEG",
40
+ "tone": "receipt_type"
41
+ },
42
+ {
43
+ "kind": "text",
44
+ "text": "Stornobuchung zu Beleg AT0-KASSE1-117",
45
+ "align": "center",
46
+ "bold": false
47
+ },
48
+ {
49
+ "kind": "text",
50
+ "text": "vom 11.11.2026, 09:14 Uhr",
51
+ "align": "center",
52
+ "bold": false
53
+ },
54
+ {
55
+ "kind": "text",
56
+ "text": "Grund: Fehleingabe",
57
+ "align": "center",
58
+ "bold": false
59
+ },
60
+ {
61
+ "kind": "space",
62
+ "lines": 1
63
+ },
64
+ {
65
+ "kind": "columns",
66
+ "columns": [
67
+ {
68
+ "text": "Datum:",
69
+ "width": 4,
70
+ "align": "left"
71
+ },
72
+ {
73
+ "text": "11.11.2026 11:02:05",
74
+ "width": 8,
75
+ "align": "right"
76
+ }
77
+ ]
78
+ },
79
+ {
80
+ "kind": "columns",
81
+ "columns": [
82
+ {
83
+ "text": "Kassen-ID:",
84
+ "width": 6,
85
+ "align": "left"
86
+ },
87
+ {
88
+ "text": "KASSE1",
89
+ "width": 6,
90
+ "align": "right"
91
+ }
92
+ ]
93
+ },
94
+ {
95
+ "kind": "columns",
96
+ "columns": [
97
+ {
98
+ "text": "Beleg-ID:",
99
+ "width": 6,
100
+ "align": "left"
101
+ },
102
+ {
103
+ "text": "AT0-KASSE1-119",
104
+ "width": 6,
105
+ "align": "right"
106
+ }
107
+ ]
108
+ },
109
+ {
110
+ "kind": "space",
111
+ "lines": 1
112
+ },
113
+ {
114
+ "kind": "columns",
115
+ "columns": [
116
+ {
117
+ "text": "Zahlung auf Rechnung 2026-0042",
118
+ "width": 8,
119
+ "align": "left"
120
+ },
121
+ {
122
+ "text": "-1569,60 ",
123
+ "width": 4,
124
+ "align": "right"
125
+ }
126
+ ]
127
+ },
128
+ {
129
+ "kind": "text",
130
+ "text": " inkl. USt",
131
+ "align": "left",
132
+ "bold": false
133
+ },
134
+ {
135
+ "kind": "rule",
136
+ "char": "-"
137
+ },
138
+ {
139
+ "kind": "columns",
140
+ "columns": [
141
+ {
142
+ "text": "Gesamt:",
143
+ "width": 6,
144
+ "align": "left"
145
+ },
146
+ {
147
+ "text": "-1569,60 €",
148
+ "width": 6,
149
+ "align": "right"
150
+ }
151
+ ]
152
+ },
153
+ {
154
+ "kind": "columns",
155
+ "columns": [
156
+ {
157
+ "text": "Zahlungsart:",
158
+ "width": 6,
159
+ "align": "left"
160
+ },
161
+ {
162
+ "text": "Barzahlung",
163
+ "width": 6,
164
+ "align": "right"
165
+ }
166
+ ]
167
+ },
168
+ {
169
+ "kind": "space",
170
+ "lines": 1
171
+ },
172
+ {
173
+ "kind": "qr",
174
+ "data": "_R1-AT1_KASSE1_AT0-KASSE1-119_2026-11-11T11:02:05_0,00_0,00_0,00_-1569,60_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR"
175
+ },
176
+ {
177
+ "kind": "space",
178
+ "lines": 1
179
+ },
180
+ {
181
+ "kind": "text",
182
+ "text": "Vielen Dank für Ihren Einkauf",
183
+ "align": "center",
184
+ "bold": false
185
+ }
186
+ ],
187
+ "paperSize": "mm80",
188
+ "ruleset": 2
189
+ }