@kreiseck/kasseneck-api 1.37.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 (149) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +16 -0
  3. package/dist/cjs/index.d.ts +1 -1
  4. package/dist/cjs/index.js +6 -5
  5. package/dist/cjs/invoice/texte.d.ts +18 -1
  6. package/dist/cjs/invoice/texte.js +43 -2
  7. package/dist/cjs/invoice/vertrag.d.ts +1 -1
  8. package/dist/cjs/invoice/vertrag.js +1 -0
  9. package/dist/cjs/models/cancellation.d.ts +1 -1
  10. package/dist/cjs/models/cancellation.js +2 -0
  11. package/dist/cjs/models/index.d.ts +2 -1
  12. package/dist/cjs/models/index.js +6 -3
  13. package/dist/cjs/models/invoice-payment-ref.d.ts +42 -0
  14. package/dist/cjs/models/invoice-payment-ref.js +38 -0
  15. package/dist/cjs/models/receipt-item.d.ts +10 -2
  16. package/dist/cjs/models/receipt-item.js +14 -1
  17. package/dist/cjs/models/receipt.d.ts +7 -0
  18. package/dist/cjs/models/receipt.js +6 -0
  19. package/dist/cjs/pos/schicht-lesen.js +5 -0
  20. package/dist/cjs/pos/schicht-typen.d.ts +11 -0
  21. package/dist/cjs/pos/texte.d.ts +13 -2
  22. package/dist/cjs/pos/texte.js +18 -3
  23. package/dist/cjs/receipt/index.d.ts +1 -0
  24. package/dist/cjs/receipt/index.js +4 -2
  25. package/dist/cjs/receipt/layout.d.ts +2 -2
  26. package/dist/cjs/receipt/layout.js +106 -117
  27. package/dist/cjs/receipt/shift-sheet.js +6 -1
  28. package/dist/cjs/receipt/vermerke.d.ts +80 -0
  29. package/dist/cjs/receipt/vermerke.js +167 -0
  30. package/dist/cjs/stored/draht.js +25 -1
  31. package/dist/cjs/stored/vokabular.d.ts +1 -1
  32. package/dist/cjs/stored/vokabular.js +21 -2
  33. package/dist/cjs/version.d.ts +1 -1
  34. package/dist/cjs/version.js +1 -1
  35. package/dist/esm/index.d.ts +1 -1
  36. package/dist/esm/index.js +1 -1
  37. package/dist/esm/invoice/texte.d.ts +18 -1
  38. package/dist/esm/invoice/texte.js +43 -2
  39. package/dist/esm/invoice/vertrag.d.ts +1 -1
  40. package/dist/esm/invoice/vertrag.js +1 -0
  41. package/dist/esm/models/cancellation.d.ts +1 -1
  42. package/dist/esm/models/cancellation.js +2 -0
  43. package/dist/esm/models/index.d.ts +2 -1
  44. package/dist/esm/models/index.js +2 -1
  45. package/dist/esm/models/invoice-payment-ref.d.ts +42 -0
  46. package/dist/esm/models/invoice-payment-ref.js +35 -0
  47. package/dist/esm/models/receipt-item.d.ts +10 -2
  48. package/dist/esm/models/receipt-item.js +13 -1
  49. package/dist/esm/models/receipt.d.ts +7 -0
  50. package/dist/esm/models/receipt.js +6 -0
  51. package/dist/esm/pos/schicht-lesen.js +5 -0
  52. package/dist/esm/pos/schicht-typen.d.ts +11 -0
  53. package/dist/esm/pos/texte.d.ts +13 -2
  54. package/dist/esm/pos/texte.js +18 -3
  55. package/dist/esm/receipt/index.d.ts +1 -0
  56. package/dist/esm/receipt/index.js +1 -0
  57. package/dist/esm/receipt/layout.d.ts +2 -2
  58. package/dist/esm/receipt/layout.js +103 -113
  59. package/dist/esm/receipt/shift-sheet.js +6 -1
  60. package/dist/esm/receipt/vermerke.d.ts +80 -0
  61. package/dist/esm/receipt/vermerke.js +155 -0
  62. package/dist/esm/stored/draht.js +25 -1
  63. package/dist/esm/stored/vokabular.d.ts +1 -1
  64. package/dist/esm/stored/vokabular.js +21 -2
  65. package/dist/esm/version.d.ts +1 -1
  66. package/dist/esm/version.js +1 -1
  67. package/fixtures/expected/invoice-payment-cancellation.grid32.txt +28 -0
  68. package/fixtures/expected/invoice-payment-cancellation.grid48.txt +26 -0
  69. package/fixtures/expected/invoice-payment-cancellation.lines.json +189 -0
  70. package/fixtures/expected/invoice-payment-cancellation.sheet32.json +194 -0
  71. package/fixtures/expected/invoice-payment-cancellation.sheet48.json +182 -0
  72. package/fixtures/expected/invoice-payment-manual-receipt.grid32.txt +30 -0
  73. package/fixtures/expected/invoice-payment-manual-receipt.grid48.txt +29 -0
  74. package/fixtures/expected/invoice-payment-manual-receipt.lines.json +199 -0
  75. package/fixtures/expected/invoice-payment-manual-receipt.sheet32.json +206 -0
  76. package/fixtures/expected/invoice-payment-manual-receipt.sheet48.json +200 -0
  77. package/fixtures/expected/invoice-payment-normal.grid32.txt +22 -0
  78. package/fixtures/expected/invoice-payment-normal.grid48.txt +21 -0
  79. package/fixtures/expected/invoice-payment-normal.lines.json +192 -0
  80. package/fixtures/expected/invoice-payment-normal.sheet32.json +158 -0
  81. package/fixtures/expected/invoice-payment-normal.sheet48.json +152 -0
  82. package/fixtures/expected/invoice-payment-outage.grid32.txt +23 -0
  83. package/fixtures/expected/invoice-payment-outage.grid48.txt +21 -0
  84. package/fixtures/expected/invoice-payment-outage.lines.json +172 -0
  85. package/fixtures/expected/invoice-payment-outage.sheet32.json +164 -0
  86. package/fixtures/expected/invoice-payment-outage.sheet48.json +152 -0
  87. package/fixtures/expected/invoice-payment-partial.grid32.txt +20 -0
  88. package/fixtures/expected/invoice-payment-partial.grid48.txt +20 -0
  89. package/fixtures/expected/invoice-payment-partial.lines.json +162 -0
  90. package/fixtures/expected/invoice-payment-partial.sheet32.json +146 -0
  91. package/fixtures/expected/invoice-payment-partial.sheet48.json +146 -0
  92. package/fixtures/expected/invoice-payment-refund.grid32.txt +20 -0
  93. package/fixtures/expected/invoice-payment-refund.grid48.txt +20 -0
  94. package/fixtures/expected/invoice-payment-refund.lines.json +162 -0
  95. package/fixtures/expected/invoice-payment-refund.sheet32.json +146 -0
  96. package/fixtures/expected/invoice-payment-refund.sheet48.json +146 -0
  97. package/fixtures/expected/invoice-payment-see-invoice.grid32.txt +22 -0
  98. package/fixtures/expected/invoice-payment-see-invoice.grid48.txt +21 -0
  99. package/fixtures/expected/invoice-payment-see-invoice.lines.json +192 -0
  100. package/fixtures/expected/invoice-payment-see-invoice.sheet32.json +158 -0
  101. package/fixtures/expected/invoice-payment-see-invoice.sheet48.json +152 -0
  102. package/fixtures/expected/invoice-payment-training.grid32.txt +30 -0
  103. package/fixtures/expected/invoice-payment-training.grid48.txt +27 -0
  104. package/fixtures/expected/invoice-payment-training.lines.json +183 -0
  105. package/fixtures/expected/invoice-payment-training.sheet32.json +206 -0
  106. package/fixtures/expected/invoice-payment-training.sheet48.json +188 -0
  107. package/fixtures/expected/invoice-payment-without-vat.grid32.txt +20 -0
  108. package/fixtures/expected/invoice-payment-without-vat.grid48.txt +19 -0
  109. package/fixtures/expected/invoice-payment-without-vat.lines.json +162 -0
  110. package/fixtures/expected/invoice-payment-without-vat.sheet32.json +146 -0
  111. package/fixtures/expected/invoice-payment-without-vat.sheet48.json +140 -0
  112. package/fixtures/expected/invoice-payment-zero-percent.grid32.txt +22 -0
  113. package/fixtures/expected/invoice-payment-zero-percent.grid48.txt +21 -0
  114. package/fixtures/expected/invoice-payment-zero-percent.lines.json +192 -0
  115. package/fixtures/expected/invoice-payment-zero-percent.sheet32.json +158 -0
  116. package/fixtures/expected/invoice-payment-zero-percent.sheet48.json +152 -0
  117. package/fixtures/hobex-hps-codes.json +1 -1
  118. package/fixtures/invoice-api.schema.json +3 -2
  119. package/fixtures/invoice-texts.json +37 -3
  120. package/fixtures/manifest.json +80 -0
  121. package/fixtures/pos-message-cases.json +3 -0
  122. package/fixtures/pos-texts.json +14 -1
  123. package/fixtures/receipt-due-generated.json +3 -3
  124. package/fixtures/receipt-due-voucher-generated.json +5 -5
  125. package/fixtures/receipts/invoice-payment-cancellation.json +70 -0
  126. package/fixtures/receipts/invoice-payment-manual-receipt.json +69 -0
  127. package/fixtures/receipts/invoice-payment-normal.json +65 -0
  128. package/fixtures/receipts/invoice-payment-outage.json +63 -0
  129. package/fixtures/receipts/invoice-payment-partial.json +63 -0
  130. package/fixtures/receipts/invoice-payment-refund.json +63 -0
  131. package/fixtures/receipts/invoice-payment-see-invoice.json +65 -0
  132. package/fixtures/receipts/invoice-payment-training.json +63 -0
  133. package/fixtures/receipts/invoice-payment-without-vat.json +63 -0
  134. package/fixtures/receipts/invoice-payment-zero-percent.json +65 -0
  135. package/fixtures/surface.json +3 -2
  136. package/fixtures/v3/antworten/belege.json +2 -2
  137. package/fixtures/v3/antworten/belegmail.json +2 -2
  138. package/fixtures/v3/antworten/berichte.json +2 -2
  139. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  140. package/fixtures/v3/antworten/kasse.json +10 -127
  141. package/fixtures/v3/antworten/lager.json +1 -1
  142. package/fixtures/v3/antworten/rechnungen.json +2 -2
  143. package/fixtures/v3/antworten/storno.json +2 -2
  144. package/fixtures/v3/stored/belege.json +2 -2
  145. package/fixtures/v3/stored/kasse.json +3 -3
  146. package/fixtures/v3/stored/rechnungen.json +2 -2
  147. package/fixtures/v3/v3-vokabular.json +172 -18
  148. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  149. package/package.json +1 -1
@@ -156,6 +156,9 @@ function laufstand(ort, w) {
156
156
  raus.unassignedTipCents = ganzzahl(ort, o, 'unassignedTipCents');
157
157
  if (o.discounts !== undefined && o.discounts !== null)
158
158
  raus.discounts = liste(ort, o, 'discounts', rabatt);
159
+ // Zahlungen auf Rechnungen (1.38.0, nur Information): gelesen wie gesendet.
160
+ if (o.invoicePaymentCents !== undefined && o.invoicePaymentCents !== null)
161
+ raus.invoicePaymentCents = ganzzahl(ort, o, 'invoicePaymentCents');
159
162
  return raus;
160
163
  }
161
164
  function rabatt(ort, w) {
@@ -403,6 +406,8 @@ function schichtBon(ort, w) {
403
406
  wennWert(r, o, 'discounts', () => liste(ort, o, 'discounts', rabatt));
404
407
  // Kartentrinkgeld bar aus der Lade genommen (Summe); nur mit Karten-direkt.
405
408
  wennWert(r, o, 'cardTipsTakenCents', () => ganzzahl(ort, o, 'cardTipsTakenCents'));
409
+ // Nur Information: Zahlungen auf Rechnungen (1.38.0); der Server sendet sie erst mit dem ersten Zahlungsbeleg.
410
+ wennWert(r, o, 'invoicePaymentCents', () => ganzzahl(ort, o, 'invoicePaymentCents'));
406
411
  wennWert(r, o, 'differenceParts', () => liste(ort, o, 'differenceParts', differenzTeil));
407
412
  wennDa(r, o, 'countedBeforePayoutCents', () => ganzzahlOderNull(ort, o, 'countedBeforePayoutCents'));
408
413
  wennDa(r, o, 'countedBeforePayoutDenominations', () => stueckelung(ort, o, 'countedBeforePayoutDenominations'));
@@ -170,6 +170,12 @@ export interface ShiftRunningTotals {
170
170
  * auf dem Z-Bon steht es als Block ([discountBlockLines]).
171
171
  */
172
172
  discounts?: ShiftDiscount[];
173
+ /**
174
+ * Zahlungen auf Rechnungen in Cent (1.38.0): Summe der Positionen „Zahlung auf Rechnung“ der Schicht,
175
+ * bar und unbar, ein Storno negativ. Nur Information, nie zusaetzlich im Soll: das Geld steckt schon im
176
+ * Barumsatz bzw. in `nonCashByMethod`. Der Server sendet es nur, wenn es etwas gibt (fehlt = keine).
177
+ */
178
+ invoicePaymentCents?: number;
173
179
  }
174
180
  /** Ein Eintrag von [ShiftRunningTotals.discounts] bzw. [ShiftSummaryReceipt.discounts]. */
175
181
  export interface ShiftDiscount {
@@ -440,6 +446,11 @@ export interface ShiftSummaryReceipt extends ShiftReceiptHeader {
440
446
  discounts?: ShiftDiscount[];
441
447
  /** Kartentrinkgeld bar aus der Lade genommen, Summe (Soll − Betrag); fehlt ohne Karten-direkt. */
442
448
  cardTipsTakenCents?: number;
449
+ /**
450
+ * Zahlungen auf Rechnungen in Cent, wie [ShiftRunningTotals.invoicePaymentCents]; fehlt ohne solche
451
+ * (der Bon bleibt dann wie bisher).
452
+ */
453
+ invoicePaymentCents?: number;
443
454
  /** Entnommen bzw. eingelegt nach dem Zaehlen; fehlt, wenn kein Geld bewegt wurde. */
444
455
  afterCount?: AfterCount;
445
456
  /**
@@ -419,6 +419,9 @@ declare const MELDUNGEN_ROH: {
419
419
  readonly 'cancellation.voucher_type_changed': {
420
420
  readonly text: "Die Gutschein-Sorte für Rückgaben hat sich geändert – bitte erneut versuchen.";
421
421
  };
422
+ readonly 'cancellation.invoice_payment_not_cancellable': {
423
+ readonly text: "Diese Zahlung gehört zu einer Rechnung. Storniere sie im Kundenbereich bei der Rechnung.";
424
+ };
422
425
  readonly 'voucher_error.not_found': {
423
426
  readonly text: "Diesen Gutschein gibt es in diesem Betrieb nicht.";
424
427
  };
@@ -1271,6 +1274,10 @@ export declare const ERROR_CODE_RULES: readonly [{
1271
1274
  readonly kind: "api";
1272
1275
  readonly codes: readonly ["too_many_exports"];
1273
1276
  readonly key: "dep.too_many_exports";
1277
+ }, {
1278
+ readonly kind: "api";
1279
+ readonly codes: readonly ["invoice_payment_not_cancellable"];
1280
+ readonly key: "cancellation.invoice_payment_not_cancellable";
1274
1281
  }];
1275
1282
  /**
1276
1283
  * Regeln je Ausgang, nach den Code-Regeln und vor der Regel der Art: eine
@@ -1399,8 +1406,9 @@ export declare const CANCELLATION_VOUCHER_ERROR_MESSAGES: {
1399
1406
  readonly idempotency_conflict: "cancellation.input_rejected";
1400
1407
  };
1401
1408
  /**
1402
- * Der Satz zu einem `code` eines Stornos: zuerst die Rueckgabe als Gutschein, dann die Storno-Zahlungen,
1403
- * sonst `cancellation.failed`. Fuer die Kassen der eine Weg beim Storno.
1409
+ * Der Satz zu einem `code` eines Stornos: zuerst die Rueckgabe als Gutschein, dann eine Code-Regel mit
1410
+ * Storno-Satz (Schluessel `cancellation.*` in [ERROR_CODE_RULES], seit 1.38.0 der Zahlungsbeleg), dann
1411
+ * die Storno-Zahlungen, sonst `cancellation.failed`. Fuer die Kassen der eine Weg beim Storno.
1404
1412
  */
1405
1413
  export declare function cancellationErrorMessage(code: string | undefined | null): MessageKey;
1406
1414
  /**
@@ -3171,6 +3179,9 @@ declare const BESCHRIFTUNGEN_ROH: {
3171
3179
  readonly 'shift_receipt.difference_part_closing': {
3172
3180
  readonly text: "davon Abschluss";
3173
3181
  };
3182
+ readonly 'shift_receipt.invoice_payments': {
3183
+ readonly text: "Zahlungen auf Rechnungen";
3184
+ };
3174
3185
  readonly 'shift.state_closing': {
3175
3186
  readonly text: "Schicht wird geschlossen";
3176
3187
  };
@@ -240,6 +240,9 @@ const MELDUNGEN_ROH = {
240
240
  'cancellation.voucher_no_type': { text: 'Keine Gutschein-Sorte für Rückgaben eingestellt – bitte wie bezahlt zurückgeben.' },
241
241
  'cancellation.voucher_amount': { text: 'Dieser Betrag geht nicht als Gutschein – bitte wie bezahlt zurückgeben.' },
242
242
  'cancellation.voucher_type_changed': { text: 'Die Gutschein-Sorte für Rückgaben hat sich geändert – bitte erneut versuchen.' },
243
+ // Zahlung auf Rechnung (1.38.0): ein Zahlungsbeleg steht in der Belegliste, storniert wird er nur bei
244
+ // der Rechnung (sonst passten Rechnung und Beleg nicht mehr zusammen). Code invoice_payment_not_cancellable.
245
+ 'cancellation.invoice_payment_not_cancellable': { text: 'Diese Zahlung gehört zu einer Rechnung. Storniere sie im Kundenbereich bei der Rechnung.' },
243
246
  // --- Gutscheine: Fehlersätze (Zuordnung in VOUCHER_ERROR_MESSAGES) ---------
244
247
  'voucher_error.not_found': { text: 'Diesen Gutschein gibt es in diesem Betrieb nicht.' },
245
248
  'voucher_error.invalid': { text: 'Dieser Gutschein ist nicht gültig.' },
@@ -642,6 +645,9 @@ exports.ERROR_CODE_RULES = [
642
645
  { kind: 'api', codes: ['manager_only'], key: 'dep.manager_only' },
643
646
  { kind: 'api', codes: ['export_running'], key: 'dep.running' },
644
647
  { kind: 'api', codes: ['too_many_exports'], key: 'dep.too_many_exports' },
648
+ // Storno eines Zahlungsbelegs (Zahlung auf Rechnung, 1.38.0): der Satz sagt, wo es geht. Der Server
649
+ // hat nichts storniert. Gilt auch auf dem Storno-Weg ([cancellationErrorMessage]).
650
+ { kind: 'api', codes: ['invoice_payment_not_cancellable'], key: 'cancellation.invoice_payment_not_cancellable' },
645
651
  ];
646
652
  /**
647
653
  * Regeln je Ausgang, nach den Code-Regeln und vor der Regel der Art: eine
@@ -793,12 +799,18 @@ exports.CANCELLATION_VOUCHER_ERROR_MESSAGES = {
793
799
  idempotency_conflict: 'cancellation.input_rejected',
794
800
  };
795
801
  /**
796
- * Der Satz zu einem `code` eines Stornos: zuerst die Rueckgabe als Gutschein, dann die Storno-Zahlungen,
797
- * sonst `cancellation.failed`. Fuer die Kassen der eine Weg beim Storno.
802
+ * Der Satz zu einem `code` eines Stornos: zuerst die Rueckgabe als Gutschein, dann eine Code-Regel mit
803
+ * Storno-Satz (Schluessel `cancellation.*` in [ERROR_CODE_RULES], seit 1.38.0 der Zahlungsbeleg), dann
804
+ * die Storno-Zahlungen, sonst `cancellation.failed`. Fuer die Kassen der eine Weg beim Storno.
798
805
  */
799
806
  function cancellationErrorMessage(code) {
807
+ if (code === undefined || code === null)
808
+ return cancellationPaymentErrorMessage(code);
800
809
  const gutschein = exports.CANCELLATION_VOUCHER_ERROR_MESSAGES;
801
- return (code !== undefined && code !== null && gutschein[code]) || cancellationPaymentErrorMessage(code);
810
+ if (gutschein[code])
811
+ return gutschein[code];
812
+ const regel = exports.ERROR_CODE_RULES.find((r) => r.key.startsWith('cancellation.') && r.codes.includes(code));
813
+ return regel?.key ?? cancellationPaymentErrorMessage(code);
802
814
  }
803
815
  /**
804
816
  * Fremdgutscheine an der Kasse (1.31.0): Satz zur gesperrten Kachel ([externalVoucherTileBlock]).
@@ -1548,6 +1560,9 @@ const BESCHRIFTUNGEN_ROH = {
1548
1560
  'shift_receipt.counted_before_payout': { text: 'Gezählt' },
1549
1561
  'shift_receipt.difference_part_interim': { text: 'davon Zwischenzählung' },
1550
1562
  'shift_receipt.difference_part_closing': { text: 'davon Abschluss' },
1563
+ // Zahlungen auf Rechnungen (1.38.0): Summe der Zahlungsbelege der Schicht, nur Information (das Geld
1564
+ // steckt schon im Barumsatz bzw. unbar).
1565
+ 'shift_receipt.invoice_payments': { text: 'Zahlungen auf Rechnungen' },
1551
1566
  // Nachtrag Schicht-Ablauf (1.28.0): Band-Titel ohne Punkt wie `shift.state_closed`.
1552
1567
  'shift.state_closing': { text: 'Schicht wird geschlossen' },
1553
1568
  'shift.state_interim': { text: 'Zwischenzählung' },
@@ -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
@@ -190,8 +190,13 @@ function shiftReceiptLayout(receipt, options = {}) {
190
190
  if (bon.comment)
191
191
  zeilen.push(text(`${(0, texte_js_1.labelText)('shift_receipt.comment')}: ${bon.comment}`));
192
192
  zeilen.push(...nachZaehlungZeilen(bon));
193
- // Zur Information: unbar, Zaehler.
193
+ // Zur Information: Zahlungen auf Rechnungen, unbar, Zaehler.
194
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
+ }
195
200
  if (bon.nonCashByMethod.length > 0) {
196
201
  zeilen.push(text((0, texte_js_1.labelText)('shift_receipt.non_cash'), 'left', true));
197
202
  for (const u of bon.nonCashByMethod)
@@ -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[];