@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
@@ -1,5 +1,8 @@
1
1
  import type { InternerTransport } from '../client/aufrufe.js';
2
2
  import type { TipRecipient } from '../models/index.js';
3
+ import type { TipBalance } from './schicht-typen.js';
4
+ import type { TipPaymentKind } from './settings.js';
5
+ import type { LabelKey } from './texte.js';
3
6
  /**
4
7
  * Die Personen, denen dieser Aufrufer Trinkgeld zuweisen kann.
5
8
  *
@@ -8,3 +11,30 @@ import type { TipRecipient } from '../models/index.js';
8
11
  * Recht `tipAssign` angemeldet, steht nur er selbst darin.
9
12
  */
10
13
  export declare function listMyTipRecipients(transport: InternerTransport): Promise<TipRecipient[]>;
14
+ export interface GetMyTipBalanceOptions {
15
+ /** Ohne Angabe gilt die Hauptlade der Kasse (`cashregisterId`). */
16
+ drawerId?: string;
17
+ cashregisterId?: string;
18
+ }
19
+ /**
20
+ * „Mein Trinkgeld“ (Spec 2026-11-11-kartentrinkgeld, § 4.6, § 5): der Trinkgeld-Stand der angemeldeten Person an
21
+ * dieser Lade -- offen (auch negativ: zu viel ausgezahlt), heute genommen, andere Laden mit offenem Betrag.
22
+ * Nur ueber den Kassenweg `/api/v3` und nur fuer eine persoenliche Anmeldung (Kassen-Benutzer `kind: person`);
23
+ * eine gemeinsame Geraete-Anmeldung und der Inhaber bekommen `not_a_person_login`. Nie der Stand einer anderen
24
+ * Person. Lesen ohne Wirkung.
25
+ */
26
+ export declare function getMyTipBalance(transport: InternerTransport, options?: GetMyTipBalanceOptions): Promise<TipBalance>;
27
+ /** Was mit dem Trinkgeld dieses Verkaufs geschieht ([tipStatus]). */
28
+ export type TipStatusKind = 'kept' | 'open';
29
+ /** Ergebnis von [tipStatus]: `kept` = gleich behalten, `open` = offen; `key` die Zeile aus dem Katalog mit `{amount}`. */
30
+ export interface TipStatus {
31
+ status: TipStatusKind;
32
+ key: LabelKey;
33
+ }
34
+ /**
35
+ * Die eine Zeile beim Kassieren und auf der Fertig-Seite (Spec 2026-11-11-kartentrinkgeld, § 4.4): sie sagt, was
36
+ * mit dem Mitarbeiter-Trinkgeld wirklich geschieht -- nicht die Stufe, sondern das Ergebnis von `tipKeptFor` (und
37
+ * bei Karte der Deckung durch das Soll, F1). Bar: „{amount} gleich einstecken“ / „{amount} in der Lade lassen“,
38
+ * Karte: „{amount} aus der Lade nehmen“ / „{amount} später auszahlen“. Den Text liefert `labelText(key, { amount })`.
39
+ */
40
+ export declare function tipStatus(method: TipPaymentKind, kept: boolean): TipStatus;
@@ -1,7 +1,11 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.listMyTipRecipients = listMyTipRecipients;
4
+ exports.getMyTipBalance = getMyTipBalance;
5
+ exports.tipStatus = tipStatus;
4
6
  const errors_js_1 = require("../client/errors.js");
7
+ const schreiben_js_1 = require("../inventory/schreiben.js");
8
+ const schicht_lesen_js_1 = require("./schicht-lesen.js");
5
9
  /**
6
10
  * Die Personen, denen dieser Aufrufer Trinkgeld zuweisen kann.
7
11
  *
@@ -25,3 +29,29 @@ async function listMyTipRecipients(transport) {
25
29
  return { registerUserId: String(d.registerUserId ?? ''), name: String(d.name ?? ''), owner: d.owner === true };
26
30
  });
27
31
  }
32
+ /**
33
+ * „Mein Trinkgeld“ (Spec 2026-11-11-kartentrinkgeld, § 4.6, § 5): der Trinkgeld-Stand der angemeldeten Person an
34
+ * dieser Lade -- offen (auch negativ: zu viel ausgezahlt), heute genommen, andere Laden mit offenem Betrag.
35
+ * Nur ueber den Kassenweg `/api/v3` und nur fuer eine persoenliche Anmeldung (Kassen-Benutzer `kind: person`);
36
+ * eine gemeinsame Geraete-Anmeldung und der Inhaber bekommen `not_a_person_login`. Nie der Stand einer anderen
37
+ * Person. Lesen ohne Wirkung.
38
+ */
39
+ async function getMyTipBalance(transport, options = {}) {
40
+ const name = 'getMyTipBalance';
41
+ const p = (0, schreiben_js_1.anfrage)(name, options);
42
+ if (p.drawerId === '')
43
+ delete p.drawerId;
44
+ const ort = { name, pfad: '', scope: 'response' };
45
+ return (0, schicht_lesen_js_1.tipStand)(ort, await transport(name, p));
46
+ }
47
+ /**
48
+ * Die eine Zeile beim Kassieren und auf der Fertig-Seite (Spec 2026-11-11-kartentrinkgeld, § 4.4): sie sagt, was
49
+ * mit dem Mitarbeiter-Trinkgeld wirklich geschieht -- nicht die Stufe, sondern das Ergebnis von `tipKeptFor` (und
50
+ * bei Karte der Deckung durch das Soll, F1). Bar: „{amount} gleich einstecken“ / „{amount} in der Lade lassen“,
51
+ * Karte: „{amount} aus der Lade nehmen“ / „{amount} später auszahlen“. Den Text liefert `labelText(key, { amount })`.
52
+ */
53
+ function tipStatus(method, kept) {
54
+ if (method === 'card')
55
+ return kept ? { status: 'kept', key: 'tip.line_card_kept' } : { status: 'open', key: 'tip.line_card_open' };
56
+ return kept ? { status: 'kept', key: 'tip.line_cash_kept' } : { status: 'open', key: 'tip.line_cash_open' };
57
+ }
@@ -1,5 +1,6 @@
1
1
  export { type LayoutAlign, type LayoutColumn, type LayoutTextLine, type LayoutColumnsLine, type LayoutRuleLine, type LayoutSpaceLine, type LayoutQrLine, type LayoutLine, type ReceiptLayout, type BuildReceiptLayoutOptions, buildReceiptLayout, receiptSignatureFailed, receiptSignatureIsTest, receiptIsZero, receiptAmountsAreZero, receiptIsSmallBusinessConsistent, receiptZdaText, CURRENT_LAYOUT_RULESET, type LayoutBannerLine, type LayoutBannerTone, type LayoutRuleset, SMALL_BUSINESS_NOTICE, formatCents, } from './layout.js';
2
2
  export { markAsDuplicate } from './duplikat.js';
3
+ export { type ReceiptNote, type ReceiptNoteKind, type ReceiptNotesOptions, receiptNotes } from './vermerke.js';
3
4
  export { type EscPosLayoutOptions, type EscPosLayoutResult, type QrPrintMode, type PrintLogo, assertLogoRaster, escPosLayoutBytes, escPosLayoutResult, } from './layout-escpos.js';
4
5
  export { type GridLine, type GridLineKind, type ReceiptGrid, type RenderReceiptGridOptions, renderReceiptGrid, gridColumnWidths, gridToText, CHARS_PER_PAPER_SIZE, } from './grid.js';
5
6
  export { type EposPrintXmlOptions, type EposPrintResult, type EposDirectOptions, type EposResponse, EposConnectionError, eposPrintXml, eposPrintXmlResult, eposXmlEscape, eposImageXml, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.codeTableReferenceImage = exports.codeTableTestSheetBytes = exports.codeTableTestSheet = exports.CODE_TABLE_TEST_SHEET_CHARS = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.markAsDuplicate = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
4
- exports.VOUCHER_ZERO_RATE_BUCKET_FROM = exports.voucherRedeemMaxCents = exports.isReceiptDueError = void 0;
3
+ exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.codeTableReferenceImage = exports.codeTableTestSheetBytes = exports.codeTableTestSheet = exports.CODE_TABLE_TEST_SHEET_CHARS = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.receiptNotes = exports.markAsDuplicate = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
4
+ exports.VOUCHER_ZERO_RATE_BUCKET_FROM = exports.voucherRedeemMaxCents = exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = void 0;
5
5
  var layout_js_1 = require("./layout.js");
6
6
  Object.defineProperty(exports, "buildReceiptLayout", { enumerable: true, get: function () { return layout_js_1.buildReceiptLayout; } });
7
7
  Object.defineProperty(exports, "receiptSignatureFailed", { enumerable: true, get: function () { return layout_js_1.receiptSignatureFailed; } });
@@ -15,6 +15,8 @@ Object.defineProperty(exports, "SMALL_BUSINESS_NOTICE", { enumerable: true, get:
15
15
  Object.defineProperty(exports, "formatCents", { enumerable: true, get: function () { return layout_js_1.formatCents; } });
16
16
  var duplikat_js_1 = require("./duplikat.js");
17
17
  Object.defineProperty(exports, "markAsDuplicate", { enumerable: true, get: function () { return duplikat_js_1.markAsDuplicate; } });
18
+ var vermerke_js_1 = require("./vermerke.js");
19
+ Object.defineProperty(exports, "receiptNotes", { enumerable: true, get: function () { return vermerke_js_1.receiptNotes; } });
18
20
  var layout_escpos_js_1 = require("./layout-escpos.js");
19
21
  Object.defineProperty(exports, "assertLogoRaster", { enumerable: true, get: function () { return layout_escpos_js_1.assertLogoRaster; } });
20
22
  Object.defineProperty(exports, "escPosLayoutBytes", { enumerable: true, get: function () { return layout_escpos_js_1.escPosLayoutBytes; } });
@@ -1,5 +1,7 @@
1
1
  import { type Receipt, type ReceiptCompany, type RegistrationInfo } from '../models/index.js';
2
2
  import type { PosPaperSize } from '../printing/escpos.js';
3
+ import { receiptSignatureFailed } from './vermerke.js';
4
+ export { receiptSignatureFailed };
3
5
  /**
4
6
  * Beleg-Layout — der Bauplan eines Kasseneck-Belegs als reines Datenmodell.
5
7
  *
@@ -163,8 +165,6 @@ export declare function stripeReceiptLines(daten: Record<string, unknown>, cardP
163
165
  * deutsch — er steht so auf oesterreichischen Belegen.
164
166
  */
165
167
  export declare const SMALL_BUSINESS_NOTICE = "Umsatzsteuerbefreit \u2013 Kleinunternehmer gem\u00E4\u00DF \u00A7 6 Abs. 1 Z 27 UStG.";
166
- /** Wurde der Beleg ohne funktionierende Signatureinheit ausgestellt? */
167
- export declare function receiptSignatureFailed(receipt: Receipt): boolean;
168
168
  /**
169
169
  * Traegt der Beleg eine **Test**-Signatur? Erkannt am ZDA-Kennzeichen `AT100`
170
170
  * im maschinenlesbaren Code (`_R1-AT100_...`) — der Testpfad der Testumgebungen.
@@ -1,9 +1,8 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = void 0;
3
+ exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptSignatureFailed = void 0;
4
4
  exports.formatCents = formatCents;
5
5
  exports.stripeReceiptLines = stripeReceiptLines;
6
- exports.receiptSignatureFailed = receiptSignatureFailed;
7
6
  exports.receiptSignatureIsTest = receiptSignatureIsTest;
8
7
  exports.receiptIsZero = receiptIsZero;
9
8
  exports.receiptAmountsAreZero = receiptAmountsAreZero;
@@ -15,6 +14,8 @@ const index_js_2 = require("../models/index.js");
15
14
  const vienna_time_js_1 = require("../vienna-time.js");
16
15
  const errors_js_1 = require("../client/errors.js");
17
16
  const zusaetze_js_1 = require("../pos/zusaetze.js");
17
+ const vermerke_js_1 = require("./vermerke.js");
18
+ Object.defineProperty(exports, "receiptSignatureFailed", { enumerable: true, get: function () { return vermerke_js_1.receiptSignatureFailed; } });
18
19
  exports.CURRENT_LAYOUT_RULESET = 2;
19
20
  /** Die Optionen von [buildReceiptLayout]; jede andere wird abgewiesen. */
20
21
  const LAYOUT_OPTIONEN = new Set(['paperSize', 'ruleset', 'testCashregister', 'testSignature', 'registrationInfo']);
@@ -73,21 +74,6 @@ function belegZeit(timeStamp) {
73
74
  const zwei = (n) => String(n).padStart(2, '0');
74
75
  return `${zwei(t.day)}.${zwei(t.month)}.${t.year} ${zwei(t.hour)}:${zwei(t.minute)}:${zwei(t.second)}`;
75
76
  }
76
- /**
77
- * Datum des stornierten Originals fuer den Kopfblock: „11.08.2026, 09:02 Uhr".
78
- * Ein unlesbarer Zeitstempel am BEZUG ist kein Grund, den Storno-Bon zu
79
- * verweigern (der Beleg selbst ist gueltig) — dann bleibt die Zeile weg.
80
- */
81
- function originalDatum(timeStamp) {
82
- try {
83
- const t = (0, vienna_time_js_1.toViennaWallClock)((0, vienna_time_js_1.parseServerTimeStamp)(timeStamp));
84
- const zwei = (n) => String(n).padStart(2, '0');
85
- return `${zwei(t.day)}.${zwei(t.month)}.${t.year}, ${zwei(t.hour)}:${zwei(t.minute)} Uhr`;
86
- }
87
- catch {
88
- return null;
89
- }
90
- }
91
77
  /**
92
78
  * Zahlungsart als Anzeigetext. Drei Faelle, und alle drei kommen vor:
93
79
  * bekannter Eintrag (Beschriftung), unbekannter Schluessel (roh — besser als
@@ -536,19 +522,8 @@ function rueckgabeZahlungsZeilen(receipt, rueckgaben) {
536
522
  */
537
523
  exports.SMALL_BUSINESS_NOTICE = 'Umsatzsteuerbefreit – Kleinunternehmer gemäß § 6 Abs. 1 Z 27 UStG.';
538
524
  // ------------------------------------------------------------------ Signatur
539
- /** Text, den das Backend statt einer Signatur ablegt, wenn die Karte ausfaellt. */
540
- const SIGNATUR_AUSGEFALLEN = 'Sicherheitseinrichtung ausgefallen';
541
- /**
542
- * Derselbe Text base64url-kodiert — so steht er als dritter JWS-Teil im Feld
543
- * `sig` (Zwilling von `RKSVService.isSigSuccess`). Fest hinterlegt statt zur
544
- * Laufzeit kodiert: `btoa`/`Buffer` sind in Browser und Node verschieden zu
545
- * haben, und der Wert ist unveraenderlich.
546
- */
547
- const SIGNATUR_AUSGEFALLEN_BASE64URL = 'U2ljaGVyaGVpdHNlaW5yaWNodHVuZyBhdXNnZWZhbGxlbg';
548
- /** Wurde der Beleg ohne funktionierende Signatureinheit ausgestellt? */
549
- function receiptSignatureFailed(receipt) {
550
- return receipt.sig.split('.')[2] === SIGNATUR_AUSGEFALLEN_BASE64URL;
551
- }
525
+ // Ob der Beleg ohne Signatureinheit ausgestellt wurde (`receiptSignatureFailed`), steht bei den
526
+ // Vermerken (vermerke.ts): der Vermerk „Sicherheitseinrichtung ausgefallen“ haengt daran.
552
527
  /**
553
528
  * Traegt der Beleg eine **Test**-Signatur? Erkannt am ZDA-Kennzeichen `AT100`
554
529
  * im maschinenlesbaren Code (`_R1-AT100_...`) — der Testpfad der Testumgebungen.
@@ -966,24 +941,69 @@ function einwegPfandCents(receipt) {
966
941
  }
967
942
  return gefunden ? summe : null;
968
943
  }
944
+ // ---------------------------------------------------------- Zahlung auf Rechnung
945
+ /** Steuerhinweise unter einer Zahlung auf Rechnung, je Wert (eingerueckt wie „ USt bei Einlösung“); am Bon deutsch. */
946
+ const STEUERHINWEIS_TEXTE = {
947
+ incl_vat: ' inkl. USt',
948
+ zero_percent: ' 0 % USt',
949
+ see_invoice: ' Steuerangaben siehe Rechnung',
950
+ };
951
+ /**
952
+ * Zahlungsbeleg: jede Position ist eine Zahlung auf Rechnung (ein Beleg mit einer solchen Position
953
+ * besteht nur aus solchen, das prueft der Server).
954
+ */
955
+ function istNurRechnungszahlung(receipt) {
956
+ return receipt.items.length > 0 && receipt.items.every(index_js_2.isInvoicePaymentItem);
957
+ }
958
+ /**
959
+ * Bezug je Position „Zahlung auf Rechnung“: die n-te solche Position (Belegreihenfolge) gehoert zur
960
+ * n-ten Rechnung in `invoicePayments`; der Server legt beide in derselben Reihenfolge an, eine Zeile
961
+ * je Rechnung. Ohne Bezug bleibt die Position ohne Steuerhinweis.
962
+ */
963
+ function rechnungszahlungBezuege(receipt) {
964
+ const bezuege = receipt.invoicePayments ?? [];
965
+ const zu = new Map();
966
+ let n = 0;
967
+ receipt.items.forEach((it, i) => {
968
+ if (!(0, index_js_2.isInvoicePaymentItem)(it))
969
+ return;
970
+ const bezug = bezuege[n];
971
+ n += 1;
972
+ if (bezug !== undefined)
973
+ zu.set(i, bezug);
974
+ });
975
+ return zu;
976
+ }
977
+ /**
978
+ * Zeilen einer Zahlung auf Rechnung: Text der Position (er nennt die Rechnung) und Betrag, ohne Menge
979
+ * und ohne Satzkennzeichen -- der Betrag zaehlt im RKSV-Feld „Null“, ist aber kein steuerfreier Umsatz,
980
+ * kein Satz der Steuertabelle. Darunter der Steuerhinweis der Rechnung (Spec 2026-11-11, Abschnitt 16):
981
+ * „inkl. USt“, „0 % USt“ (steuerfrei, nicht steuerbar) oder „Steuerangaben siehe Rechnung“ (Reverse Charge). Breite 8:4 wie die Gutscheinzeilen.
982
+ */
983
+ function rechnungszahlungZeilen(item, bezug) {
984
+ const zeilen = [{
985
+ kind: 'columns',
986
+ columns: [
987
+ { text: item.name, width: 8, align: 'left' },
988
+ // Zwei Fuellzeichen, wo bei den Warenzeilen " B" steht: die Betraege fluchten in einer Spalte.
989
+ { text: `${formatCents((0, index_js_2.receiptItemTotalCents)(item))} `, width: 4, align: 'right' },
990
+ ],
991
+ }];
992
+ if (bezug?.taxNote !== undefined)
993
+ zeilen.push(textZeile(STEUERHINWEIS_TEXTE[bezug.taxNote]));
994
+ return zeilen;
995
+ }
969
996
  // ---------------------------------------------------------------- Belegart
970
- const TESTKASSE_TEXT = 'TESTKASSE — kein gültiger Beleg';
971
- const TESTSIGNATUR_TEXT = 'TESTSIGNATUR — kein gültiger Beleg';
972
- /** Erklaerung am Trainingsbeleg (Wortlaut mit dem Betreiber abgestimmt). */
973
- const TRAINING_ERKLAERUNG = [
974
- 'Trainingsbuchung — kein Kauf, keine Zahlung, keine steuerliche Buchung.',
975
- 'Sollten Sie diesen Beleg als Kunde erhalten haben, sagen Sie bitte dem Betrieb Bescheid.',
976
- ];
977
997
  function bannerZeile(text, tone = 'receipt_type') {
978
998
  return { kind: 'banner', text, tone };
979
999
  }
980
- /** Belegtyp als Zeichenkette (Enum-Objekt oder roher Serverwert). */
981
- function belegtyp(receipt) {
982
- return typeof receipt.receiptType === 'object' ? receipt.receiptType.value : String(receipt.receiptType ?? '');
1000
+ /** Ein Vermerk am Bon: Titel als Banner, jede Zeile zentriert darunter. */
1001
+ function vermerkZeilen(vermerk) {
1002
+ return [bannerZeile(vermerk.title), ...vermerk.lines.map((z) => textZeile(z, 'center'))];
983
1003
  }
984
1004
  /** Ist das ein Nullbeleg (Start-, Monats-, Jahres-, Schluss-, Pruefbeleg)? */
985
1005
  function receiptIsZero(receipt) {
986
- const t = belegtyp(receipt);
1006
+ const t = (0, vermerke_js_1.belegtyp)(receipt);
987
1007
  return t === 'zero' || t === 'start';
988
1008
  }
989
1009
  /**
@@ -1032,7 +1052,7 @@ function pruefangabenBlock(receipt, angaben) {
1032
1052
  out.push({ kind: 'rule', char: '-' });
1033
1053
  out.push(textZeile('Prüfangaben', 'center', true));
1034
1054
  out.push(paarZeile('Barumsatz:', '0,00 €'));
1035
- out.push(paarZeile('Signatur:', receiptSignatureFailed(receipt) ? 'ausgefallen' : 'signiert'));
1055
+ out.push(paarZeile('Signatur:', (0, vermerke_js_1.receiptSignatureFailed)(receipt) ? 'ausgefallen' : 'signiert'));
1036
1056
  // Die Zertifikat-Seriennummer ist hexadezimal (RKSV-Detailspezifikation) --
1037
1057
  // mit 0x gekennzeichnet, damit niemand sie fuer eine Dezimalzahl haelt.
1038
1058
  if (receipt.certificateSerialNumber)
@@ -1059,16 +1079,6 @@ function belegMonatJahr(timeStamp) {
1059
1079
  return { monat: '??', jahr: '????' };
1060
1080
  }
1061
1081
  }
1062
- /**
1063
- * Grund eines Stornos lesbar -- aus dem EINEN Katalog des Modells
1064
- * (`CANCELLATION_REASONS`, derselbe, den die Kasse anbietet und das Backend
1065
- * annimmt). Unbekannter Code (Fremdclient): sichtbar, aber ohne zu werfen.
1066
- */
1067
- function stornoGrundText(code) {
1068
- if (!code)
1069
- return null;
1070
- return (0, index_js_2.isCancellationReason)(code) ? index_js_2.CANCELLATION_REASONS[code] : code;
1071
- }
1072
1082
  /**
1073
1083
  * Kleinunternehmer (§ 6 Abs. 1 Z 27 UStG, unechte Befreiung): auf dem Beleg
1074
1084
  * darf keine USt stehen -- jede Position 0 %. Sagt, ob der Beleg dazu passt;
@@ -1077,71 +1087,37 @@ function stornoGrundText(code) {
1077
1087
  function receiptIsSmallBusinessConsistent(receipt) {
1078
1088
  return receipt.items.every((it) => Number(steuersatz(it.vat).rate) === 0);
1079
1089
  }
1080
- /** Grund-Zeile nach einem Ausfall der Kasse; `other` druckt den eigenen Text. */
1081
- const NACHERFASSUNG_GRUND = {
1082
- network_outage: 'Internet', power_outage: 'Strom', device_failure: 'Gerät defekt', system_outage: 'Störung',
1083
- };
1084
- /** `YYYY-MM-DD` als `TT.MM.JJJJ`; anderes bleibt, wie es kam. */
1085
- function handbelegDatum(tag) {
1086
- const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(tag);
1087
- return m ? `${m[3]}.${m[2]}.${m[1]}` : tag;
1088
- }
1089
1090
  /**
1090
- * Block „NACHERFASSUNG“ (manualReceipt) unter dem Kopf: Art, Grund, Nummer
1091
- * und Tag des Handbelegs bzw. der Handbelege eines Tagessammelbelegs, dazu
1092
- * der Hinweis, dass der Beleg fuer die USt ein Duplikat ist
1093
- * (Registrierkassenerlass 3.3 Faelle 5 und 6, 2.4.11). Der Zeitstempel des Belegs bleibt der der
1094
- * Nacherfassung und steht wie immer unter „Datum:“. Kleinunternehmer
1095
- * (keine USt am Beleg) bekommen den USt-Hinweis nicht.
1091
+ * Block „NACHERFASSUNG“ (manualReceipt) unter dem Kopf, aus dem Baustein
1092
+ * [nacherfassungTeile]: Titel, Anlass, Leerzeile, Handbeleg, dann der Hinweis,
1093
+ * dass der Beleg fuer die USt ein Duplikat ist. Der Zeitstempel des Belegs
1094
+ * bleibt der der Nacherfassung und steht wie immer unter „Datum:“.
1095
+ * Kleinunternehmer (keine USt am Beleg) bekommen den USt-Hinweis nicht, ebenso
1096
+ * ein Zahlungsbeleg (seine Umsatzsteuer steht auf der Rechnung).
1096
1097
  */
1097
1098
  function nacherfassungBlock(receipt, company) {
1098
- const m = receipt.manualReceipt;
1099
- if (!m)
1099
+ const teile = (0, vermerke_js_1.nacherfassungTeile)(receipt);
1100
+ if (!teile)
1100
1101
  return [];
1101
- const aus = [bannerZeile('NACHERFASSUNG')];
1102
- aus.push(textZeile(m.reason === 'outside_premises' ? 'Leistung außer Haus' : 'nach Ausfall der Kasse', 'center'));
1103
- const grund = m.reason === 'other' ? m.note : NACHERFASSUNG_GRUND[m.reason];
1104
- if (grund)
1105
- aus.push(textZeile(`Grund: ${grund}`, 'center'));
1106
- aus.push({ kind: 'space', lines: 1 });
1107
- const tag = handbelegDatum(m.date);
1108
- if (m.numberTo) {
1109
- aus.push(textZeile('Tagessammelbeleg', 'center'));
1110
- aus.push(textZeile(`Handbelege Nr. ${m.number} bis ${m.numberTo}`, 'center'));
1111
- aus.push(textZeile(`${m.count ? `${m.count} Belege ` : ''}vom ${tag}`, 'center'));
1112
- if (!company.isSmallBusiness)
1113
- aus.push(textZeile('USt: Duplikat der Handbelege', 'center'));
1114
- }
1115
- else {
1116
- aus.push(textZeile(`Handbeleg Nr. ${m.number}`, 'center'));
1117
- aus.push(textZeile(`vom ${tag}${m.time ? `, ${m.time} Uhr` : ''}`, 'center'));
1118
- if (!company.isSmallBusiness)
1119
- aus.push(textZeile('USt: Duplikat des Handbelegs', 'center'));
1120
- }
1121
- return aus;
1102
+ const ust = !company.isSmallBusiness && !istNurRechnungszahlung(receipt);
1103
+ return [
1104
+ bannerZeile(teile.title),
1105
+ ...teile.anlass.map((z) => textZeile(z, 'center')),
1106
+ { kind: 'space', lines: 1 },
1107
+ ...teile.handbeleg.map((z) => textZeile(z, 'center')),
1108
+ ...(ust ? [textZeile(teile.ustHinweis, 'center')] : []),
1109
+ ];
1122
1110
  }
1123
1111
  /**
1124
1112
  * Belegart-Block unter dem Betriebskopf: Titel als Banner, Untertitel als
1125
1113
  * zentrierte Textzeilen. Verkaufsbelege bekommen keinen Block.
1126
1114
  */
1127
1115
  function belegartBlock(receipt) {
1128
- const t = belegtyp(receipt);
1116
+ const t = (0, vermerke_js_1.belegtyp)(receipt);
1129
1117
  const aus = [];
1130
- if (t === 'cancellation') {
1131
- aus.push(bannerZeile('STORNOBELEG'));
1132
- aus.push(textZeile(receipt.cancellationOf ? `Stornobuchung zu Beleg ${receipt.cancellationOf.receiptId}` : 'Stornobuchung', 'center'));
1133
- // Datum des Originals, wenn der Bezug es traegt (Backend seit 2026-09-04).
1134
- const datum = receipt.cancellationOf?.timeStamp ? originalDatum(receipt.cancellationOf.timeStamp) : null;
1135
- if (datum)
1136
- aus.push(textZeile(`vom ${datum}`, 'center'));
1137
- const grund = stornoGrundText(typeof receipt.cancellationReason === 'string' ? receipt.cancellationReason : undefined);
1138
- if (grund)
1139
- aus.push(textZeile(`Grund: ${grund}`, 'center'));
1140
- }
1141
- else if (t === 'training') {
1142
- aus.push(bannerZeile('TRAININGSBELEG'));
1143
- for (const z of TRAINING_ERKLAERUNG)
1144
- aus.push(textZeile(z, 'center'));
1118
+ const vermerk = (0, vermerke_js_1.stornoVermerk)(receipt) ?? (0, vermerke_js_1.trainingVermerk)(receipt);
1119
+ if (vermerk) {
1120
+ aus.push(...vermerkZeilen(vermerk));
1145
1121
  }
1146
1122
  else if (istReinerLeergutBeleg(receipt)) {
1147
1123
  aus.push(textZeile(LEERGUT_UEBERSCHRIFT, 'center', true));
@@ -1193,9 +1169,9 @@ function buildReceiptLayout(receipt, company, options = {}) {
1193
1169
  const nullbeleg = receiptIsZero(receipt) && (ruleset === 1 || receiptAmountsAreZero(receipt));
1194
1170
  const warnungen = [];
1195
1171
  if (options.testCashregister)
1196
- warnungen.push(bannerZeile(TESTKASSE_TEXT, 'warning'));
1172
+ warnungen.push(bannerZeile((0, vermerke_js_1.testkasseVermerk)().title, 'warning'));
1197
1173
  if (options.testSignature)
1198
- warnungen.push(bannerZeile(TESTSIGNATUR_TEXT, 'warning'));
1174
+ warnungen.push(bannerZeile((0, vermerke_js_1.testsignaturVermerk)().title, 'warning'));
1199
1175
  // --- Warnrahmen oben (Testkasse/Testsignatur): ueber dem Kopf, damit ihn niemand uebersieht.
1200
1176
  lines.push(...warnungen);
1201
1177
  // --- Belegkopf: Firma, Anschrift, Steuerangabe, Telefon
@@ -1239,8 +1215,9 @@ function buildReceiptLayout(receipt, company, options = {}) {
1239
1215
  lines.push(textZeile(zeile, 'center'));
1240
1216
  lines.push({ kind: 'space', lines: 1 });
1241
1217
  }
1242
- if (receiptSignatureFailed(receipt)) {
1243
- lines.push(textZeile(SIGNATUR_AUSGEFALLEN, 'center'));
1218
+ const ausfall = (0, vermerke_js_1.signaturausfallVermerk)(receipt);
1219
+ if (ausfall) {
1220
+ lines.push(textZeile(ausfall.title, 'center'));
1244
1221
  lines.push({ kind: 'space', lines: 1 });
1245
1222
  }
1246
1223
  lines.push({ kind: 'qr', data: receipt.qr });
@@ -1297,9 +1274,16 @@ function buildReceiptLayout(receipt, company, options = {}) {
1297
1274
  gebundenesPfand.add(k);
1298
1275
  const reihe = mitPfandReihenfolge(receipt.items, (0, zusaetze_js_1.addOnDisplayOrder)(receipt.items), pfandZu);
1299
1276
  const an = (k) => receipt.items[reihe[k]];
1277
+ const rzBezuege = rechnungszahlungBezuege(receipt);
1300
1278
  let i = 0;
1301
1279
  while (i < reihe.length) {
1302
1280
  const item = an(i);
1281
+ // Zahlung auf Rechnung: eigene Zeilen, nicht in der Steuertabelle (die Umsatzsteuer steht auf der Rechnung).
1282
+ if ((0, index_js_2.isInvoicePaymentItem)(item)) {
1283
+ lines.push(...rechnungszahlungZeilen(item, rzBezuege.get(reihe[i])));
1284
+ i += 1;
1285
+ continue;
1286
+ }
1303
1287
  if (!(0, index_js_2.isTipItem)(item) && !(0, index_js_2.isDiscountItem)(item)) {
1304
1288
  const satz = steuersatz(item.vat);
1305
1289
  gruppeVon(satz).bruttoCents += (0, index_js_2.receiptItemTotalCents)(item);
@@ -1383,9 +1367,12 @@ function buildReceiptLayout(receipt, company, options = {}) {
1383
1367
  }
1384
1368
  }
1385
1369
  verteilePromoGutschein(gruppen, promoCents);
1386
- // --- USt-Aufteilung
1387
- lines.push({ kind: 'space', lines: 1 });
1388
- lines.push(tabellenZeile(['MwSt%', 'MwSt', 'Netto', 'Brutto'], paperSize));
1370
+ // --- USt-Aufteilung; ein Zahlungsbeleg hat keine (seine Umsatzsteuer steht auf der Rechnung).
1371
+ const nurRechnungszahlung = istNurRechnungszahlung(receipt);
1372
+ if (!(nurRechnungszahlung && gruppen.size === 0)) {
1373
+ lines.push({ kind: 'space', lines: 1 });
1374
+ lines.push(tabellenZeile(['MwSt%', 'MwSt', 'Netto', 'Brutto'], paperSize));
1375
+ }
1389
1376
  for (const gruppe of gruppen.values()) {
1390
1377
  // Netto aus dem Brutto in ganzen Cent, MwSt als Rest: so ergeben Netto und
1391
1378
  // MwSt zusammen immer wieder exakt den Brutto-Betrag der Zeile. (Das
@@ -1459,8 +1446,9 @@ function buildReceiptLayout(receipt, company, options = {}) {
1459
1446
  lines.push(paarZeile('Gesamt:', `${formatCents(summeCents)} €`));
1460
1447
  lines.push(...(rueckgaben.length > 0 ? rueckgabeZahlungsZeilen(receipt, rueckgaben) : zahlungsZeilen(receipt)));
1461
1448
  lines.push({ kind: 'space', lines: 1 });
1462
- // --- Rechtshinweise und Ausfallhinweis
1463
- const hinweise = company.isSmallBusiness
1449
+ // --- Rechtshinweise und Ausfallhinweis. Der Kleinunternehmer-Hinweis erklaert die 0-%-Zeilen der
1450
+ // Steuertabelle; ein Zahlungsbeleg hat keine, den Hinweis traegt seine Rechnung.
1451
+ const hinweise = company.isSmallBusiness && !nurRechnungszahlung
1464
1452
  ? [exports.SMALL_BUSINESS_NOTICE, ...receipt.legalMessage]
1465
1453
  : receipt.legalMessage;
1466
1454
  if (hinweise.length > 0) {
@@ -1469,8 +1457,9 @@ function buildReceiptLayout(receipt, company, options = {}) {
1469
1457
  }
1470
1458
  lines.push({ kind: 'space', lines: 1 });
1471
1459
  }
1472
- if (receiptSignatureFailed(receipt)) {
1473
- lines.push(textZeile(SIGNATUR_AUSGEFALLEN, 'center'));
1460
+ const ausfall = (0, vermerke_js_1.signaturausfallVermerk)(receipt);
1461
+ if (ausfall) {
1462
+ lines.push(textZeile(ausfall.title, 'center'));
1474
1463
  lines.push({ kind: 'space', lines: 1 });
1475
1464
  }
1476
1465
  // --- RKSV-QR-Code
@@ -143,6 +143,11 @@ function shiftReceiptLayout(receipt, options = {}) {
143
143
  zeilen.push(text((0, texte_js_1.labelText)('shift_receipt.opening_not_counted')));
144
144
  if (bon.cashSalesCents !== null)
145
145
  zeilen.push(betrag((0, texte_js_1.labelText)('shift_receipt.cash_sales'), bon.cashSalesCents));
146
+ // Kartentrinkgeld bar aus der Lade genommen (Spec keck 2026-11-11-kartentrinkgeld, § 4.3): verlaesst die Lade ohne
147
+ // Bewegung; ohne diese Zeile ginge Start + Bar + Bewegungen nicht im Soll auf. Steht wie die Bewegungen auch blind.
148
+ // Fehlt ohne Karten-direkt (Feld fehlt oder 0) -- der Bon bleibt dann Byte fuer Byte wie bisher.
149
+ if (bon.cardTipsTakenCents !== undefined && bon.cardTipsTakenCents !== 0)
150
+ zeilen.push(betrag((0, texte_js_1.labelText)('shift.part_card_tips_taken'), -bon.cardTipsTakenCents));
146
151
  if (bon.cashCancellationsCents !== null)
147
152
  zeilen.push(betrag((0, texte_js_1.labelText)('shift_receipt.cash_cancellations'), bon.cashCancellationsCents));
148
153
  // Summe der Zwischenzaehlungs-Differenzen: damit Start + Bar + Bewegungen + diese = Soll aufgeht.
@@ -185,8 +190,13 @@ function shiftReceiptLayout(receipt, options = {}) {
185
190
  if (bon.comment)
186
191
  zeilen.push(text(`${(0, texte_js_1.labelText)('shift_receipt.comment')}: ${bon.comment}`));
187
192
  zeilen.push(...nachZaehlungZeilen(bon));
188
- // Zur Information: unbar, Zaehler.
193
+ // Zur Information: Zahlungen auf Rechnungen, unbar, Zaehler.
189
194
  zeilen.push(regel());
195
+ // Zahlungen auf Rechnungen (1.38.0): nur Information, das Geld steckt schon im Barumsatz bzw. unbar.
196
+ // Ohne Betrag (fehlt oder 0) keine Zeile, der Bon bleibt wie bisher.
197
+ if (bon.invoicePaymentCents !== undefined && bon.invoicePaymentCents !== 0) {
198
+ zeilen.push(betrag((0, texte_js_1.labelText)('shift_receipt.invoice_payments'), bon.invoicePaymentCents));
199
+ }
190
200
  if (bon.nonCashByMethod.length > 0) {
191
201
  zeilen.push(text((0, texte_js_1.labelText)('shift_receipt.non_cash'), 'left', true));
192
202
  for (const u of bon.nonCashByMethod)
@@ -202,7 +212,7 @@ function shiftReceiptLayout(receipt, options = {}) {
202
212
  zeilen.push(anzahl((0, texte_js_1.labelText)('shift_receipt.receipts'), bon.receiptCount));
203
213
  zeilen.push(anzahl((0, texte_js_1.labelText)('shift_receipt.cancellations'), bon.cancellationCount));
204
214
  zeilen.push(anzahl((0, texte_js_1.labelText)('shift_receipt.openings_without_sale'), bon.openingsWithoutSale));
205
- // Trinkgeld je Mitarbeiter (shiftTipLines): verdient immer, ueber Lohn, schon genommen und offen
215
+ // Trinkgeld je Mitarbeiter (shiftTipLines): verdient immer, ueber Lohn, genommen und offen
206
216
  // nur ungleich 0; wer ueberall 0 hat, entfaellt, ohne Mitarbeiter auch die Ueberschrift.
207
217
  const trinkgeld = bon.tips.map((t) => ({ t, z: (0, schicht_js_1.shiftTipLines)(t) })).filter(({ z }) => z.length > 0);
208
218
  if (trinkgeld.length > 0) {
@@ -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[];