@kreiseck/kasseneck-api 1.37.0 → 1.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (185) hide show
  1. package/CHANGELOG.md +39 -1
  2. package/README.md +19 -1
  3. package/dist/cjs/client/aufrufe.d.ts +2 -2
  4. package/dist/cjs/client/aufrufe.js +12 -0
  5. package/dist/cjs/index.d.ts +1 -1
  6. package/dist/cjs/index.js +6 -5
  7. package/dist/cjs/invoice/texte.d.ts +18 -1
  8. package/dist/cjs/invoice/texte.js +43 -2
  9. package/dist/cjs/invoice/vertrag.d.ts +1 -1
  10. package/dist/cjs/invoice/vertrag.js +1 -0
  11. package/dist/cjs/models/cancellation.d.ts +1 -1
  12. package/dist/cjs/models/cancellation.js +2 -0
  13. package/dist/cjs/models/index.d.ts +2 -1
  14. package/dist/cjs/models/index.js +6 -3
  15. package/dist/cjs/models/invoice-payment-ref.d.ts +42 -0
  16. package/dist/cjs/models/invoice-payment-ref.js +38 -0
  17. package/dist/cjs/models/receipt-item.d.ts +10 -2
  18. package/dist/cjs/models/receipt-item.js +14 -1
  19. package/dist/cjs/models/receipt.d.ts +7 -0
  20. package/dist/cjs/models/receipt.js +6 -0
  21. package/dist/cjs/payments/hobex-hps/connect-client.d.ts +17 -0
  22. package/dist/cjs/payments/hobex-hps/connect-client.js +17 -0
  23. package/dist/cjs/payments/hobex-hps/index.d.ts +1 -1
  24. package/dist/cjs/payments/index.d.ts +1 -1
  25. package/dist/cjs/pos/client.js +2 -1
  26. package/dist/cjs/pos/index.d.ts +1 -1
  27. package/dist/cjs/pos/index.js +7 -5
  28. package/dist/cjs/pos/schicht-lesen.js +5 -0
  29. package/dist/cjs/pos/schicht-typen.d.ts +11 -0
  30. package/dist/cjs/pos/settings.d.ts +14 -1
  31. package/dist/cjs/pos/settings.js +16 -2
  32. package/dist/cjs/pos/texte.d.ts +400 -2
  33. package/dist/cjs/pos/texte.js +152 -3
  34. package/dist/cjs/receipt/index.d.ts +1 -0
  35. package/dist/cjs/receipt/index.js +4 -2
  36. package/dist/cjs/receipt/layout.d.ts +2 -2
  37. package/dist/cjs/receipt/layout.js +106 -117
  38. package/dist/cjs/receipt/shift-sheet.js +6 -1
  39. package/dist/cjs/receipt/vermerke.d.ts +80 -0
  40. package/dist/cjs/receipt/vermerke.js +167 -0
  41. package/dist/cjs/register/errors.d.ts +1 -1
  42. package/dist/cjs/register/errors.js +4 -0
  43. package/dist/cjs/register/index.d.ts +1 -1
  44. package/dist/cjs/register/index.js +3 -1
  45. package/dist/cjs/register/pairing.d.ts +51 -0
  46. package/dist/cjs/register/pairing.js +59 -0
  47. package/dist/cjs/stored/draht.js +25 -1
  48. package/dist/cjs/stored/einstellungen.js +5 -2
  49. package/dist/cjs/stored/vokabular.d.ts +1 -1
  50. package/dist/cjs/stored/vokabular.js +22 -2
  51. package/dist/cjs/version.d.ts +1 -1
  52. package/dist/cjs/version.js +1 -1
  53. package/dist/esm/client/aufrufe.d.ts +2 -2
  54. package/dist/esm/client/aufrufe.js +12 -0
  55. package/dist/esm/index.d.ts +1 -1
  56. package/dist/esm/index.js +1 -1
  57. package/dist/esm/invoice/texte.d.ts +18 -1
  58. package/dist/esm/invoice/texte.js +43 -2
  59. package/dist/esm/invoice/vertrag.d.ts +1 -1
  60. package/dist/esm/invoice/vertrag.js +1 -0
  61. package/dist/esm/models/cancellation.d.ts +1 -1
  62. package/dist/esm/models/cancellation.js +2 -0
  63. package/dist/esm/models/index.d.ts +2 -1
  64. package/dist/esm/models/index.js +2 -1
  65. package/dist/esm/models/invoice-payment-ref.d.ts +42 -0
  66. package/dist/esm/models/invoice-payment-ref.js +35 -0
  67. package/dist/esm/models/receipt-item.d.ts +10 -2
  68. package/dist/esm/models/receipt-item.js +13 -1
  69. package/dist/esm/models/receipt.d.ts +7 -0
  70. package/dist/esm/models/receipt.js +6 -0
  71. package/dist/esm/payments/hobex-hps/connect-client.d.ts +17 -0
  72. package/dist/esm/payments/hobex-hps/connect-client.js +17 -0
  73. package/dist/esm/payments/hobex-hps/index.d.ts +1 -1
  74. package/dist/esm/payments/index.d.ts +1 -1
  75. package/dist/esm/pos/client.js +3 -2
  76. package/dist/esm/pos/index.d.ts +1 -1
  77. package/dist/esm/pos/index.js +1 -1
  78. package/dist/esm/pos/schicht-lesen.js +5 -0
  79. package/dist/esm/pos/schicht-typen.d.ts +11 -0
  80. package/dist/esm/pos/settings.d.ts +14 -1
  81. package/dist/esm/pos/settings.js +14 -1
  82. package/dist/esm/pos/texte.d.ts +400 -2
  83. package/dist/esm/pos/texte.js +152 -3
  84. package/dist/esm/receipt/index.d.ts +1 -0
  85. package/dist/esm/receipt/index.js +1 -0
  86. package/dist/esm/receipt/layout.d.ts +2 -2
  87. package/dist/esm/receipt/layout.js +103 -113
  88. package/dist/esm/receipt/shift-sheet.js +6 -1
  89. package/dist/esm/receipt/vermerke.d.ts +80 -0
  90. package/dist/esm/receipt/vermerke.js +155 -0
  91. package/dist/esm/register/errors.d.ts +1 -1
  92. package/dist/esm/register/errors.js +4 -0
  93. package/dist/esm/register/index.d.ts +1 -1
  94. package/dist/esm/register/index.js +1 -1
  95. package/dist/esm/register/pairing.d.ts +51 -0
  96. package/dist/esm/register/pairing.js +57 -0
  97. package/dist/esm/stored/draht.js +25 -1
  98. package/dist/esm/stored/einstellungen.js +6 -3
  99. package/dist/esm/stored/vokabular.d.ts +1 -1
  100. package/dist/esm/stored/vokabular.js +22 -2
  101. package/dist/esm/version.d.ts +1 -1
  102. package/dist/esm/version.js +1 -1
  103. package/fixtures/expected/invoice-payment-cancellation.grid32.txt +28 -0
  104. package/fixtures/expected/invoice-payment-cancellation.grid48.txt +26 -0
  105. package/fixtures/expected/invoice-payment-cancellation.lines.json +189 -0
  106. package/fixtures/expected/invoice-payment-cancellation.sheet32.json +194 -0
  107. package/fixtures/expected/invoice-payment-cancellation.sheet48.json +182 -0
  108. package/fixtures/expected/invoice-payment-manual-receipt.grid32.txt +30 -0
  109. package/fixtures/expected/invoice-payment-manual-receipt.grid48.txt +29 -0
  110. package/fixtures/expected/invoice-payment-manual-receipt.lines.json +199 -0
  111. package/fixtures/expected/invoice-payment-manual-receipt.sheet32.json +206 -0
  112. package/fixtures/expected/invoice-payment-manual-receipt.sheet48.json +200 -0
  113. package/fixtures/expected/invoice-payment-normal.grid32.txt +22 -0
  114. package/fixtures/expected/invoice-payment-normal.grid48.txt +21 -0
  115. package/fixtures/expected/invoice-payment-normal.lines.json +192 -0
  116. package/fixtures/expected/invoice-payment-normal.sheet32.json +158 -0
  117. package/fixtures/expected/invoice-payment-normal.sheet48.json +152 -0
  118. package/fixtures/expected/invoice-payment-outage.grid32.txt +23 -0
  119. package/fixtures/expected/invoice-payment-outage.grid48.txt +21 -0
  120. package/fixtures/expected/invoice-payment-outage.lines.json +172 -0
  121. package/fixtures/expected/invoice-payment-outage.sheet32.json +164 -0
  122. package/fixtures/expected/invoice-payment-outage.sheet48.json +152 -0
  123. package/fixtures/expected/invoice-payment-partial.grid32.txt +20 -0
  124. package/fixtures/expected/invoice-payment-partial.grid48.txt +20 -0
  125. package/fixtures/expected/invoice-payment-partial.lines.json +162 -0
  126. package/fixtures/expected/invoice-payment-partial.sheet32.json +146 -0
  127. package/fixtures/expected/invoice-payment-partial.sheet48.json +146 -0
  128. package/fixtures/expected/invoice-payment-refund.grid32.txt +20 -0
  129. package/fixtures/expected/invoice-payment-refund.grid48.txt +20 -0
  130. package/fixtures/expected/invoice-payment-refund.lines.json +162 -0
  131. package/fixtures/expected/invoice-payment-refund.sheet32.json +146 -0
  132. package/fixtures/expected/invoice-payment-refund.sheet48.json +146 -0
  133. package/fixtures/expected/invoice-payment-see-invoice.grid32.txt +22 -0
  134. package/fixtures/expected/invoice-payment-see-invoice.grid48.txt +21 -0
  135. package/fixtures/expected/invoice-payment-see-invoice.lines.json +192 -0
  136. package/fixtures/expected/invoice-payment-see-invoice.sheet32.json +158 -0
  137. package/fixtures/expected/invoice-payment-see-invoice.sheet48.json +152 -0
  138. package/fixtures/expected/invoice-payment-training.grid32.txt +30 -0
  139. package/fixtures/expected/invoice-payment-training.grid48.txt +27 -0
  140. package/fixtures/expected/invoice-payment-training.lines.json +183 -0
  141. package/fixtures/expected/invoice-payment-training.sheet32.json +206 -0
  142. package/fixtures/expected/invoice-payment-training.sheet48.json +188 -0
  143. package/fixtures/expected/invoice-payment-without-vat.grid32.txt +20 -0
  144. package/fixtures/expected/invoice-payment-without-vat.grid48.txt +19 -0
  145. package/fixtures/expected/invoice-payment-without-vat.lines.json +162 -0
  146. package/fixtures/expected/invoice-payment-without-vat.sheet32.json +146 -0
  147. package/fixtures/expected/invoice-payment-without-vat.sheet48.json +140 -0
  148. package/fixtures/expected/invoice-payment-zero-percent.grid32.txt +22 -0
  149. package/fixtures/expected/invoice-payment-zero-percent.grid48.txt +21 -0
  150. package/fixtures/expected/invoice-payment-zero-percent.lines.json +192 -0
  151. package/fixtures/expected/invoice-payment-zero-percent.sheet32.json +158 -0
  152. package/fixtures/expected/invoice-payment-zero-percent.sheet48.json +152 -0
  153. package/fixtures/hobex-hps-codes.json +1 -1
  154. package/fixtures/invoice-api.schema.json +3 -2
  155. package/fixtures/invoice-texts.json +37 -3
  156. package/fixtures/manifest.json +80 -0
  157. package/fixtures/pos-message-cases.json +3 -0
  158. package/fixtures/pos-texts.json +458 -1
  159. package/fixtures/receipt-due-generated.json +3 -3
  160. package/fixtures/receipt-due-voucher-generated.json +5 -5
  161. package/fixtures/receipts/invoice-payment-cancellation.json +70 -0
  162. package/fixtures/receipts/invoice-payment-manual-receipt.json +69 -0
  163. package/fixtures/receipts/invoice-payment-normal.json +65 -0
  164. package/fixtures/receipts/invoice-payment-outage.json +63 -0
  165. package/fixtures/receipts/invoice-payment-partial.json +63 -0
  166. package/fixtures/receipts/invoice-payment-refund.json +63 -0
  167. package/fixtures/receipts/invoice-payment-see-invoice.json +65 -0
  168. package/fixtures/receipts/invoice-payment-training.json +63 -0
  169. package/fixtures/receipts/invoice-payment-without-vat.json +63 -0
  170. package/fixtures/receipts/invoice-payment-zero-percent.json +65 -0
  171. package/fixtures/surface.json +16 -4
  172. package/fixtures/v3/antworten/belege.json +2 -2
  173. package/fixtures/v3/antworten/belegmail.json +2 -2
  174. package/fixtures/v3/antworten/berichte.json +2 -2
  175. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  176. package/fixtures/v3/antworten/kasse.json +702 -127
  177. package/fixtures/v3/antworten/lager.json +1 -1
  178. package/fixtures/v3/antworten/rechnungen.json +2 -2
  179. package/fixtures/v3/antworten/storno.json +2 -2
  180. package/fixtures/v3/stored/belege.json +2 -2
  181. package/fixtures/v3/stored/kasse.json +210 -4
  182. package/fixtures/v3/stored/rechnungen.json +2 -2
  183. package/fixtures/v3/v3-vokabular.json +237 -20
  184. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  185. package/package.json +1 -1
@@ -225,6 +225,9 @@ const MELDUNGEN_ROH = {
225
225
  'cancellation.voucher_no_type': { text: 'Keine Gutschein-Sorte für Rückgaben eingestellt – bitte wie bezahlt zurückgeben.' },
226
226
  'cancellation.voucher_amount': { text: 'Dieser Betrag geht nicht als Gutschein – bitte wie bezahlt zurückgeben.' },
227
227
  'cancellation.voucher_type_changed': { text: 'Die Gutschein-Sorte für Rückgaben hat sich geändert – bitte erneut versuchen.' },
228
+ // Zahlung auf Rechnung (1.38.0): ein Zahlungsbeleg steht in der Belegliste, storniert wird er nur bei
229
+ // der Rechnung (sonst passten Rechnung und Beleg nicht mehr zusammen). Code invoice_payment_not_cancellable.
230
+ 'cancellation.invoice_payment_not_cancellable': { text: 'Diese Zahlung gehört zu einer Rechnung. Storniere sie im Kundenbereich bei der Rechnung.' },
228
231
  // --- Gutscheine: Fehlersätze (Zuordnung in VOUCHER_ERROR_MESSAGES) ---------
229
232
  'voucher_error.not_found': { text: 'Diesen Gutschein gibt es in diesem Betrieb nicht.' },
230
233
  'voucher_error.invalid': { text: 'Dieser Gutschein ist nicht gültig.' },
@@ -442,6 +445,43 @@ const MELDUNGEN_ROH = {
442
445
  // Ist das gesperrt, findet die Kasse Connect nicht -- installieren hilft dann nicht (1.33.0).
443
446
  'connect.local_network_blocked': { text: 'Der Browser sperrt den Zugang zu Kasseneck Connect. Freigeben: Schloss neben der Adresse (installierte App: Menü ⋮ → App-Info) → Website-Einstellungen → „Lokales Netzwerk“ → „Zulassen“.', only: ['web'] },
444
447
  'connect.unpair_question': { text: 'Diesen Browser wirklich von Connect trennen? Der Bondruck geht dann nicht mehr.', only: ['web'] },
448
+ // --- Geraete im Betrieb (1.39.0, Connect-Betrieb Stufe 2) ----------------------
449
+ // Drucker-, Papier-, Terminal- und Sperrbild-Saetze gelten fuer beide Kassen; die Connect-Saetze nur im Browser.
450
+ // `printer.` und `terminal.` statt `device.`: dieser Namensraum meint das Kassengeraet.
451
+ 'printer.paper_out': { text: 'Drucker: Papier leer – neue Rolle einlegen.' },
452
+ 'printer.cover_open': { text: 'Drucker: Deckel offen – bitte schließen.' },
453
+ 'printer.not_ready': { text: 'Drucker nicht bereit – Deckel schließen und Papier prüfen.' },
454
+ 'printer.paper_near_end': { text: 'Drucker: Papier fast leer.' },
455
+ 'printer.unreachable': { text: 'Drucker nicht erreichbar – eingeschaltet und im Netz?' },
456
+ 'printer.none': { text: 'Kein Drucker eingerichtet.' },
457
+ // Der Drucker schweigt auf die Statusfrage (z. B. TM-T20III bei offenem Deckel): nur ein Hinweis, der Bon wird gedruckt.
458
+ 'printer.no_status_answer': { text: 'Drucker antwortet nicht – Deckel und Papier prüfen.' },
459
+ 'manager.ask': { text: 'Chef fragen.' },
460
+ 'terminal.unreachable': { text: 'Terminal nicht erreichbar – eingeschaltet?' },
461
+ 'terminal.tid_mismatch': { text: 'Die TID passt nicht zum Terminal.' },
462
+ 'terminal.tid_hint': { text: 'Die TID steht auf jedem Terminal-Beleg.' },
463
+ 'lock_screen.card_payment_unclear': { text: 'Eine Kartenzahlung ist unklar – bitte anmelden und prüfen.' },
464
+ 'lock_screen.receipt_unclear': { text: 'Ein Beleg ist unklar – bitte anmelden und prüfen.' },
465
+ 'lock_screen.payout_unclear': { text: 'Eine Auszahlung ist unklar – bitte anmelden und prüfen.' },
466
+ 'lock_screen.reversal_unclear': { text: 'Eine Rückbuchung ist unklar – bitte anmelden und prüfen.' },
467
+ 'lock_screen.split_open': { text: 'Eine getrennte Zahlung ist offen – bitte anmelden und prüfen.' },
468
+ // Auf dem Testdruck, unter der Linie fuer die Papierbreite.
469
+ 'print.test_ruler_hint': { text: 'Linie in einer Zeile? Sonst 58 mm wählen.' },
470
+ 'connect.browser_blocks': { text: 'Der Browser sperrt Kasseneck Connect.', only: ['web'] },
471
+ 'connect.updating': { text: 'Kasseneck Connect wird aktualisiert …', only: ['web'] },
472
+ 'connect.other_installation': { text: 'Ein anderes Kasseneck Connect antwortet.', only: ['web'] },
473
+ 'connect.other_installation_hint': { text: 'Anderer Benutzer am Rechner?', only: ['web'] },
474
+ // Sprueche der Browser-Kasse, die bisher im Code standen (lib/connect.ts, App.tsx, einstellungen-schema.ts).
475
+ 'connect.pair_invalid': { text: 'Der Kopplungs-Code stimmt nicht.', only: ['web'] },
476
+ 'connect.pair_request_throttled': { text: 'Die Kopplung wurde gerade eben schon angefordert – der Tab sollte offen sein. Sonst kurz warten oder den Code eintippen.', only: ['web'] },
477
+ 'connect.print_in_progress': { text: 'Der Auftrag wird gerade gedruckt.', only: ['web'] },
478
+ 'connect.printer_timeout': { text: 'Der Drucker hat nicht rechtzeitig geantwortet.', only: ['web'] },
479
+ 'connect.printer_refused': { text: 'Der Drucker hat den Druck abgelehnt – Papier und Deckel prüfen.', only: ['web'] },
480
+ 'connect.bad_request': { text: 'Kasseneck Connect konnte mit dieser Anfrage nichts anfangen.', only: ['web'] },
481
+ 'connect.unreadable_answer': { text: 'Kasseneck Connect antwortet unverständlich – bitte neu starten.', only: ['web'] },
482
+ 'connect.error_generic': { text: 'Kasseneck Connect meldet einen Fehler.', only: ['web'] },
483
+ 'connect.unpaired_done': { text: 'Entkoppelt – dieser Browser hat keinen Zugriff mehr. Neu koppeln geht jederzeit.', only: ['web'] },
484
+ 'connect.switched_over': { text: 'Umgestellt – jetzt unten koppeln und den Drucker wählen.', only: ['web'] },
445
485
  // --- Einstellungen -------------------------------------------------------
446
486
  'settings.load_failed': { text: 'Die Einstellungen konnten nicht geladen werden.' },
447
487
  'settings.save_failed': { text: 'Die Einstellung konnte nicht gespeichert werden.' },
@@ -534,6 +574,8 @@ const MELDUNGEN_ROH = {
534
574
  // Zeile steht nur, solange an der Kasse nichts laeuft, und laedt nie von
535
575
  // selbst neu (Knopf `version.reload`). Die App kommt ueber den Store.
536
576
  'version.new_available': { text: 'Neue Fassung verfügbar – bei Gelegenheit neu laden.', only: ['web'] },
577
+ // Einmal kurz nach dem Selbst-Neuladen (Spec 2026-11-13-fassung-aktuell).
578
+ 'version.updated': { text: 'Kasse aktualisiert auf {version}.', placeholders: ['version'], only: ['web'] },
537
579
  // --- Schicht-Ablauf der Kasse (1.28.0) -----------------------------------
538
580
  'shift.started_taken_over': { text: 'Schicht {number} hat begonnen – mit {amount} in der Lade, übernommen von Schicht {from} ({time}).', placeholders: ['number', 'amount', 'from', 'time'] },
539
581
  'tip.summary': { text: 'Trinkgeld {tip} · der Gast zahlt {total}', placeholders: ['tip', 'total'] },
@@ -627,6 +669,9 @@ export const ERROR_CODE_RULES = [
627
669
  { kind: 'api', codes: ['manager_only'], key: 'dep.manager_only' },
628
670
  { kind: 'api', codes: ['export_running'], key: 'dep.running' },
629
671
  { kind: 'api', codes: ['too_many_exports'], key: 'dep.too_many_exports' },
672
+ // Storno eines Zahlungsbelegs (Zahlung auf Rechnung, 1.38.0): der Satz sagt, wo es geht. Der Server
673
+ // hat nichts storniert. Gilt auch auf dem Storno-Weg ([cancellationErrorMessage]).
674
+ { kind: 'api', codes: ['invoice_payment_not_cancellable'], key: 'cancellation.invoice_payment_not_cancellable' },
630
675
  ];
631
676
  /**
632
677
  * Regeln je Ausgang, nach den Code-Regeln und vor der Regel der Art: eine
@@ -778,12 +823,18 @@ export const CANCELLATION_VOUCHER_ERROR_MESSAGES = {
778
823
  idempotency_conflict: 'cancellation.input_rejected',
779
824
  };
780
825
  /**
781
- * Der Satz zu einem `code` eines Stornos: zuerst die Rueckgabe als Gutschein, dann die Storno-Zahlungen,
782
- * sonst `cancellation.failed`. Fuer die Kassen der eine Weg beim Storno.
826
+ * Der Satz zu einem `code` eines Stornos: zuerst die Rueckgabe als Gutschein, dann eine Code-Regel mit
827
+ * Storno-Satz (Schluessel `cancellation.*` in [ERROR_CODE_RULES], seit 1.38.0 der Zahlungsbeleg), dann
828
+ * die Storno-Zahlungen, sonst `cancellation.failed`. Fuer die Kassen der eine Weg beim Storno.
783
829
  */
784
830
  export function cancellationErrorMessage(code) {
831
+ if (code === undefined || code === null)
832
+ return cancellationPaymentErrorMessage(code);
785
833
  const gutschein = CANCELLATION_VOUCHER_ERROR_MESSAGES;
786
- return (code !== undefined && code !== null && gutschein[code]) || cancellationPaymentErrorMessage(code);
834
+ if (gutschein[code])
835
+ return gutschein[code];
836
+ const regel = ERROR_CODE_RULES.find((r) => r.key.startsWith('cancellation.') && r.codes.includes(code));
837
+ return regel?.key ?? cancellationPaymentErrorMessage(code);
787
838
  }
788
839
  /**
789
840
  * Fremdgutscheine an der Kasse (1.31.0): Satz zur gesperrten Kachel ([externalVoucherTileBlock]).
@@ -1533,6 +1584,9 @@ const BESCHRIFTUNGEN_ROH = {
1533
1584
  'shift_receipt.counted_before_payout': { text: 'Gezählt' },
1534
1585
  'shift_receipt.difference_part_interim': { text: 'davon Zwischenzählung' },
1535
1586
  'shift_receipt.difference_part_closing': { text: 'davon Abschluss' },
1587
+ // Zahlungen auf Rechnungen (1.38.0): Summe der Zahlungsbelege der Schicht, nur Information (das Geld
1588
+ // steckt schon im Barumsatz bzw. unbar).
1589
+ 'shift_receipt.invoice_payments': { text: 'Zahlungen auf Rechnungen' },
1536
1590
  // Nachtrag Schicht-Ablauf (1.28.0): Band-Titel ohne Punkt wie `shift.state_closed`.
1537
1591
  'shift.state_closing': { text: 'Schicht wird geschlossen' },
1538
1592
  'shift.state_interim': { text: 'Zwischenzählung' },
@@ -1561,6 +1615,8 @@ const BESCHRIFTUNGEN_ROH = {
1561
1615
  // --- Nur Browser-Kasse: neue Fassung (1.37.0) ---
1562
1616
  // Der Knopf an `version.new_available`.
1563
1617
  'version.reload': { text: 'Neu laden', only: ['web'] },
1618
+ // --- Fassung der Kasse, leise Zeile in den Einstellungen und auf dem PIN-Schirm (beide Kassen) ---
1619
+ 'version.line': { text: 'Fassung {version} · {time}', placeholders: ['version', 'time'] },
1564
1620
  // --- Kartentrinkgeld an der Kasse (Spec 2026-11-11-kartentrinkgeld, 1.37.0) ---
1565
1621
  // Die eine Zeile beim Kassieren je Zahlart und Ergebnis (tipStatus), mit Betrag; einzeilig.
1566
1622
  'tip.line_cash_kept': { text: '{amount} gleich einstecken', placeholders: ['amount'] },
@@ -1598,6 +1654,99 @@ const BESCHRIFTUNGEN_ROH = {
1598
1654
  'tip_claim_scope.title': { text: 'Offenes Trinkgeld zählt' },
1599
1655
  'tip_claim_scope.per_drawer': { text: 'Je Kassenlade' },
1600
1656
  'tip_claim_scope.per_person': { text: 'Je Person (alle Kassenladen)' },
1657
+ // --- Geraete im Betrieb (1.39.0): Beschriftungen und Knoepfe ---------------------
1658
+ // Gelten fuer beide Kassen. Vorhandene Knoepfe werden wiederverwendet: `common.cancel` (Abbrechen), `nav.settings`
1659
+ // (Einstellungen), `printer.set_up` (Einrichten), `receipts.open` (Öffnen), `codetable.print_again` (Nochmal drucken),
1660
+ // `codetable.apply` (Übernehmen).
1661
+ 'devices.title': { text: 'Geräte' },
1662
+ 'devices.connect': { text: 'Connect' },
1663
+ 'devices.printer': { text: 'Drucker' },
1664
+ 'devices.terminal': { text: 'Terminal' },
1665
+ 'devices.computer': { text: 'Rechner' },
1666
+ 'devices.pairing': { text: 'Kopplung' },
1667
+ 'devices.environment': { text: 'Umgebung' },
1668
+ 'devices.live': { text: 'Live' },
1669
+ 'devices.test_environment': { text: 'Testumgebung' },
1670
+ 'devices.printer_ready': { text: 'Bondrucker bereit' },
1671
+ 'devices.printer_missing': { text: 'Noch kein Bondrucker' },
1672
+ 'devices.checking': { text: 'Wird geprüft …' },
1673
+ 'devices.test_print_sent': { text: 'Testdruck gesendet' },
1674
+ 'devices.terminal_ready': { text: 'Kartenterminal bereit' },
1675
+ 'devices.terminal_found': { text: 'Terminal gefunden' },
1676
+ 'devices.terminals_found': { text: '{n} Terminals gefunden', placeholders: ['n'] },
1677
+ 'devices.printer_found': { text: 'Drucker gefunden' },
1678
+ 'devices.printers_found': { text: '{n} Drucker gefunden', placeholders: ['n'] },
1679
+ 'devices.no_printer_found': { text: 'Kein Drucker gefunden' },
1680
+ 'devices.no_terminal_found': { text: 'Kein Terminal gefunden' },
1681
+ 'devices.no_terminal_assigned': { text: 'Kein Terminal zugewiesen' },
1682
+ 'devices.connected': { text: 'Verbunden' },
1683
+ 'devices.connecting': { text: 'Wird verbunden …' },
1684
+ 'devices.not_connected': { text: 'Nicht verbunden' },
1685
+ 'devices.connect_missing': { text: 'Kasseneck Connect fehlt' },
1686
+ 'devices.settings_applied': { text: '{width} – Einstellungen übernommen', placeholders: ['width'] },
1687
+ 'devices.model_unknown': { text: 'Modell unbekannt' },
1688
+ 'devices.paper_width_question': { text: 'Wie breit ist das Papier?' },
1689
+ 'devices.line_wrapped': { text: 'Linie umgebrochen' },
1690
+ 'devices.tid_of_this_register': { text: 'TID dieser Kasse' },
1691
+ 'devices.tid_example': { text: 'z. B. 12345678' },
1692
+ 'devices.hobex_terminal': { text: 'Hobex-Terminal' },
1693
+ 'devices.tid_value': { text: 'TID {tid}', placeholders: ['tid'] },
1694
+ 'devices.address_port': { text: '{ip} · Port {port}', placeholders: ['ip', 'port'] },
1695
+ 'devices.paper_width': { text: 'Papierbreite' },
1696
+ 'devices.cut': { text: 'Abschneiden' },
1697
+ 'devices.code_page': { text: 'Zeichensatz' },
1698
+ 'devices.qr_code': { text: 'QR-Code' },
1699
+ 'devices.from_printer': { text: 'vom Drucker' },
1700
+ 'devices.address': { text: 'Adresse' },
1701
+ 'devices.test_page': { text: 'Testseite' },
1702
+ 'devices.drawer': { text: 'Kassenlade' },
1703
+ 'devices.drawer_opens_on_cash': { text: 'öffnet bei Barzahlung' },
1704
+ 'devices.check_again': { text: 'Nochmal prüfen' },
1705
+ 'devices.not_now': { text: 'Nicht jetzt' },
1706
+ 'devices.change': { text: 'ändern' },
1707
+ 'devices.advanced': { text: 'Erweitert' },
1708
+ 'devices.search_again': { text: 'Neu suchen' },
1709
+ 'devices.view': { text: 'Ansehen' },
1710
+ 'devices.use_this': { text: 'Dieses verwenden' },
1711
+ 'devices.how_it_works': { text: 'So geht’s' },
1712
+ 'devices.update_after_payment': { text: 'Nach der Zahlung aktualisieren' },
1713
+ 'devices.print': { text: 'Drucken' },
1714
+ 'devices.save': { text: 'Speichern' },
1715
+ 'devices.check': { text: 'prüfen' },
1716
+ 'devices.none': { text: 'keiner' },
1717
+ 'devices.search': { text: 'Suchen' },
1718
+ 'devices.test_print_paper': { text: 'Testdruck auf Papier ({width}, {count} Zeichen)', placeholders: ['width', 'count'] },
1719
+ 'devices.searching': { text: 'Sucht …' },
1720
+ 'devices.yes': { text: 'ja' },
1721
+ 'devices.no': { text: 'nein' },
1722
+ 'terminal.change_in_panel': { text: 'Im Panel ändern' },
1723
+ 'connect.pair': { text: 'Koppeln', only: ['web'] },
1724
+ 'connect.unpair': { text: 'Entkoppeln', only: ['web'] },
1725
+ 'connect.unpair_yes': { text: 'Ja, entkoppeln', only: ['web'] },
1726
+ // Schalter in den Geraete-Einstellungen: der Hinweis „Drucker antwortet nicht“ (`printer.no_status_answer`) an den Druckknoepfen.
1727
+ 'printer.hint_setting': { text: 'Warnen, wenn der Drucker nicht antwortet' },
1728
+ 'connect.code_prompt': { text: 'Kopplungs-Code aus Kasseneck Connect (6 Ziffern):', only: ['web'] },
1729
+ // Titel der Geraete-Einstellungen (Drucker, Terminal, Connect). Keine Erklaersaetze dazu (Spec Connect-Betrieb 2.1).
1730
+ 'printer.section_title': { text: 'Drucker & Lade' },
1731
+ 'connect.status_title': { text: 'Verbindung' },
1732
+ 'connect.install_title': { text: 'Connect installieren' },
1733
+ 'connect.name': { text: 'Kasseneck Connect' },
1734
+ 'connect.switch_title': { text: 'Auf Kasseneck Connect umstellen' },
1735
+ 'printer.use': { text: 'Bondrucker verwenden' },
1736
+ 'printer.bluetooth_title': { text: 'Bluetooth-Drucker' },
1737
+ 'printer.print_qr': { text: 'QR-Code drucken' },
1738
+ 'printer.old_way_title': { text: 'Bisheriger Druckweg' },
1739
+ 'printer.cut_title': { text: 'Papier abschneiden' },
1740
+ 'printer.bon_texts_title': { text: 'Bon-Texte' },
1741
+ 'printer.test_page_print': { text: 'Testseite drucken' },
1742
+ 'printer.drawer_title': { text: 'Kassenlade am Drucker' },
1743
+ 'printer.drawer_auto_title': { text: 'Lade öffnet von selbst' },
1744
+ 'printer.drawer_open_now': { text: 'Lade jetzt öffnen' },
1745
+ 'terminal.card_terminal': { text: 'Kartenterminal' },
1746
+ 'terminal.tid_title': { text: 'Terminal-ID (TID)' },
1747
+ 'terminal.search_title': { text: 'Terminal suchen' },
1748
+ 'terminal.ip_title': { text: 'IP-Adresse' },
1749
+ 'terminal.port_title': { text: 'Port' },
1601
1750
  };
1602
1751
  export const LABELS = BESCHRIFTUNGEN_ROH;
1603
1752
  /**
@@ -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,5 +1,6 @@
1
1
  export { buildReceiptLayout, receiptSignatureFailed, receiptSignatureIsTest, receiptIsZero, receiptAmountsAreZero, receiptIsSmallBusinessConsistent, receiptZdaText, CURRENT_LAYOUT_RULESET, SMALL_BUSINESS_NOTICE, formatCents, } from './layout.js';
2
2
  export { markAsDuplicate } from './duplikat.js';
3
+ export { receiptNotes } from './vermerke.js';
3
4
  export { assertLogoRaster, escPosLayoutBytes, escPosLayoutResult, } from './layout-escpos.js';
4
5
  export { renderReceiptGrid, gridColumnWidths, gridToText, CHARS_PER_PAPER_SIZE, } from './grid.js';
5
6
  export { EposConnectionError, eposPrintXml, eposPrintXmlResult, eposXmlEscape, eposImageXml, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';
@@ -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,8 +1,10 @@
1
1
  import { VatRate, VoucherAction, VoucherType } from '../enums/index.js';
2
- import { CANCELLATION_REASONS, isCancellationReason, receiptCompanyTaxInfo, receiptItemTotalCents, isDepositItem, isDepositReturnItem, isDiscountItem, isTipItem, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, voucherIsValid, isExternalVoucher, } from '../models/index.js';
2
+ import { receiptCompanyTaxInfo, receiptItemTotalCents, isDepositItem, isDepositReturnItem, isDiscountItem, isInvoicePaymentItem, isTipItem, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, voucherIsValid, isExternalVoucher, } from '../models/index.js';
3
3
  import { parseServerTimeStamp, toViennaWallClock } from '../vienna-time.js';
4
4
  import { KasseneckValidationError } from '../client/errors.js';
5
5
  import { addOnDisplayOrder, istGueltigerZusatz } from '../pos/zusaetze.js';
6
+ import { belegtyp, nacherfassungTeile, receiptSignatureFailed, signaturausfallVermerk, stornoVermerk, testkasseVermerk, testsignaturVermerk, trainingVermerk, } from './vermerke.js';
7
+ export { receiptSignatureFailed };
6
8
  export const CURRENT_LAYOUT_RULESET = 2;
7
9
  /** Die Optionen von [buildReceiptLayout]; jede andere wird abgewiesen. */
8
10
  const LAYOUT_OPTIONEN = new Set(['paperSize', 'ruleset', 'testCashregister', 'testSignature', 'registrationInfo']);
@@ -61,21 +63,6 @@ function belegZeit(timeStamp) {
61
63
  const zwei = (n) => String(n).padStart(2, '0');
62
64
  return `${zwei(t.day)}.${zwei(t.month)}.${t.year} ${zwei(t.hour)}:${zwei(t.minute)}:${zwei(t.second)}`;
63
65
  }
64
- /**
65
- * Datum des stornierten Originals fuer den Kopfblock: „11.08.2026, 09:02 Uhr".
66
- * Ein unlesbarer Zeitstempel am BEZUG ist kein Grund, den Storno-Bon zu
67
- * verweigern (der Beleg selbst ist gueltig) — dann bleibt die Zeile weg.
68
- */
69
- function originalDatum(timeStamp) {
70
- try {
71
- const t = toViennaWallClock(parseServerTimeStamp(timeStamp));
72
- const zwei = (n) => String(n).padStart(2, '0');
73
- return `${zwei(t.day)}.${zwei(t.month)}.${t.year}, ${zwei(t.hour)}:${zwei(t.minute)} Uhr`;
74
- }
75
- catch {
76
- return null;
77
- }
78
- }
79
66
  /**
80
67
  * Zahlungsart als Anzeigetext. Drei Faelle, und alle drei kommen vor:
81
68
  * bekannter Eintrag (Beschriftung), unbekannter Schluessel (roh — besser als
@@ -524,19 +511,8 @@ function rueckgabeZahlungsZeilen(receipt, rueckgaben) {
524
511
  */
525
512
  export const SMALL_BUSINESS_NOTICE = 'Umsatzsteuerbefreit – Kleinunternehmer gemäß § 6 Abs. 1 Z 27 UStG.';
526
513
  // ------------------------------------------------------------------ Signatur
527
- /** Text, den das Backend statt einer Signatur ablegt, wenn die Karte ausfaellt. */
528
- const SIGNATUR_AUSGEFALLEN = 'Sicherheitseinrichtung ausgefallen';
529
- /**
530
- * Derselbe Text base64url-kodiert — so steht er als dritter JWS-Teil im Feld
531
- * `sig` (Zwilling von `RKSVService.isSigSuccess`). Fest hinterlegt statt zur
532
- * Laufzeit kodiert: `btoa`/`Buffer` sind in Browser und Node verschieden zu
533
- * haben, und der Wert ist unveraenderlich.
534
- */
535
- const SIGNATUR_AUSGEFALLEN_BASE64URL = 'U2ljaGVyaGVpdHNlaW5yaWNodHVuZyBhdXNnZWZhbGxlbg';
536
- /** Wurde der Beleg ohne funktionierende Signatureinheit ausgestellt? */
537
- export function receiptSignatureFailed(receipt) {
538
- return receipt.sig.split('.')[2] === SIGNATUR_AUSGEFALLEN_BASE64URL;
539
- }
514
+ // Ob der Beleg ohne Signatureinheit ausgestellt wurde (`receiptSignatureFailed`), steht bei den
515
+ // Vermerken (vermerke.ts): der Vermerk „Sicherheitseinrichtung ausgefallen“ haengt daran.
540
516
  /**
541
517
  * Traegt der Beleg eine **Test**-Signatur? Erkannt am ZDA-Kennzeichen `AT100`
542
518
  * im maschinenlesbaren Code (`_R1-AT100_...`) — der Testpfad der Testumgebungen.
@@ -954,20 +930,65 @@ function einwegPfandCents(receipt) {
954
930
  }
955
931
  return gefunden ? summe : null;
956
932
  }
933
+ // ---------------------------------------------------------- Zahlung auf Rechnung
934
+ /** Steuerhinweise unter einer Zahlung auf Rechnung, je Wert (eingerueckt wie „ USt bei Einlösung“); am Bon deutsch. */
935
+ const STEUERHINWEIS_TEXTE = {
936
+ incl_vat: ' inkl. USt',
937
+ zero_percent: ' 0 % USt',
938
+ see_invoice: ' Steuerangaben siehe Rechnung',
939
+ };
940
+ /**
941
+ * Zahlungsbeleg: jede Position ist eine Zahlung auf Rechnung (ein Beleg mit einer solchen Position
942
+ * besteht nur aus solchen, das prueft der Server).
943
+ */
944
+ function istNurRechnungszahlung(receipt) {
945
+ return receipt.items.length > 0 && receipt.items.every(isInvoicePaymentItem);
946
+ }
947
+ /**
948
+ * Bezug je Position „Zahlung auf Rechnung“: die n-te solche Position (Belegreihenfolge) gehoert zur
949
+ * n-ten Rechnung in `invoicePayments`; der Server legt beide in derselben Reihenfolge an, eine Zeile
950
+ * je Rechnung. Ohne Bezug bleibt die Position ohne Steuerhinweis.
951
+ */
952
+ function rechnungszahlungBezuege(receipt) {
953
+ const bezuege = receipt.invoicePayments ?? [];
954
+ const zu = new Map();
955
+ let n = 0;
956
+ receipt.items.forEach((it, i) => {
957
+ if (!isInvoicePaymentItem(it))
958
+ return;
959
+ const bezug = bezuege[n];
960
+ n += 1;
961
+ if (bezug !== undefined)
962
+ zu.set(i, bezug);
963
+ });
964
+ return zu;
965
+ }
966
+ /**
967
+ * Zeilen einer Zahlung auf Rechnung: Text der Position (er nennt die Rechnung) und Betrag, ohne Menge
968
+ * und ohne Satzkennzeichen -- der Betrag zaehlt im RKSV-Feld „Null“, ist aber kein steuerfreier Umsatz,
969
+ * kein Satz der Steuertabelle. Darunter der Steuerhinweis der Rechnung (Spec 2026-11-11, Abschnitt 16):
970
+ * „inkl. USt“, „0 % USt“ (steuerfrei, nicht steuerbar) oder „Steuerangaben siehe Rechnung“ (Reverse Charge). Breite 8:4 wie die Gutscheinzeilen.
971
+ */
972
+ function rechnungszahlungZeilen(item, bezug) {
973
+ const zeilen = [{
974
+ kind: 'columns',
975
+ columns: [
976
+ { text: item.name, width: 8, align: 'left' },
977
+ // Zwei Fuellzeichen, wo bei den Warenzeilen " B" steht: die Betraege fluchten in einer Spalte.
978
+ { text: `${formatCents(receiptItemTotalCents(item))} `, width: 4, align: 'right' },
979
+ ],
980
+ }];
981
+ if (bezug?.taxNote !== undefined)
982
+ zeilen.push(textZeile(STEUERHINWEIS_TEXTE[bezug.taxNote]));
983
+ return zeilen;
984
+ }
957
985
  // ---------------------------------------------------------------- Belegart
958
- const TESTKASSE_TEXT = 'TESTKASSE — kein gültiger Beleg';
959
- const TESTSIGNATUR_TEXT = 'TESTSIGNATUR — kein gültiger Beleg';
960
- /** Erklaerung am Trainingsbeleg (Wortlaut mit dem Betreiber abgestimmt). */
961
- const TRAINING_ERKLAERUNG = [
962
- 'Trainingsbuchung — kein Kauf, keine Zahlung, keine steuerliche Buchung.',
963
- 'Sollten Sie diesen Beleg als Kunde erhalten haben, sagen Sie bitte dem Betrieb Bescheid.',
964
- ];
965
986
  function bannerZeile(text, tone = 'receipt_type') {
966
987
  return { kind: 'banner', text, tone };
967
988
  }
968
- /** Belegtyp als Zeichenkette (Enum-Objekt oder roher Serverwert). */
969
- function belegtyp(receipt) {
970
- return typeof receipt.receiptType === 'object' ? receipt.receiptType.value : String(receipt.receiptType ?? '');
989
+ /** Ein Vermerk am Bon: Titel als Banner, jede Zeile zentriert darunter. */
990
+ function vermerkZeilen(vermerk) {
991
+ return [bannerZeile(vermerk.title), ...vermerk.lines.map((z) => textZeile(z, 'center'))];
971
992
  }
972
993
  /** Ist das ein Nullbeleg (Start-, Monats-, Jahres-, Schluss-, Pruefbeleg)? */
973
994
  export function receiptIsZero(receipt) {
@@ -1047,16 +1068,6 @@ function belegMonatJahr(timeStamp) {
1047
1068
  return { monat: '??', jahr: '????' };
1048
1069
  }
1049
1070
  }
1050
- /**
1051
- * Grund eines Stornos lesbar -- aus dem EINEN Katalog des Modells
1052
- * (`CANCELLATION_REASONS`, derselbe, den die Kasse anbietet und das Backend
1053
- * annimmt). Unbekannter Code (Fremdclient): sichtbar, aber ohne zu werfen.
1054
- */
1055
- function stornoGrundText(code) {
1056
- if (!code)
1057
- return null;
1058
- return isCancellationReason(code) ? CANCELLATION_REASONS[code] : code;
1059
- }
1060
1071
  /**
1061
1072
  * Kleinunternehmer (§ 6 Abs. 1 Z 27 UStG, unechte Befreiung): auf dem Beleg
1062
1073
  * darf keine USt stehen -- jede Position 0 %. Sagt, ob der Beleg dazu passt;
@@ -1065,48 +1076,26 @@ function stornoGrundText(code) {
1065
1076
  export function receiptIsSmallBusinessConsistent(receipt) {
1066
1077
  return receipt.items.every((it) => Number(steuersatz(it.vat).rate) === 0);
1067
1078
  }
1068
- /** Grund-Zeile nach einem Ausfall der Kasse; `other` druckt den eigenen Text. */
1069
- const NACHERFASSUNG_GRUND = {
1070
- network_outage: 'Internet', power_outage: 'Strom', device_failure: 'Gerät defekt', system_outage: 'Störung',
1071
- };
1072
- /** `YYYY-MM-DD` als `TT.MM.JJJJ`; anderes bleibt, wie es kam. */
1073
- function handbelegDatum(tag) {
1074
- const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(tag);
1075
- return m ? `${m[3]}.${m[2]}.${m[1]}` : tag;
1076
- }
1077
1079
  /**
1078
- * Block „NACHERFASSUNG“ (manualReceipt) unter dem Kopf: Art, Grund, Nummer
1079
- * und Tag des Handbelegs bzw. der Handbelege eines Tagessammelbelegs, dazu
1080
- * der Hinweis, dass der Beleg fuer die USt ein Duplikat ist
1081
- * (Registrierkassenerlass 3.3 Faelle 5 und 6, 2.4.11). Der Zeitstempel des Belegs bleibt der der
1082
- * Nacherfassung und steht wie immer unter „Datum:“. Kleinunternehmer
1083
- * (keine USt am Beleg) bekommen den USt-Hinweis nicht.
1080
+ * Block „NACHERFASSUNG“ (manualReceipt) unter dem Kopf, aus dem Baustein
1081
+ * [nacherfassungTeile]: Titel, Anlass, Leerzeile, Handbeleg, dann der Hinweis,
1082
+ * dass der Beleg fuer die USt ein Duplikat ist. Der Zeitstempel des Belegs
1083
+ * bleibt der der Nacherfassung und steht wie immer unter „Datum:“.
1084
+ * Kleinunternehmer (keine USt am Beleg) bekommen den USt-Hinweis nicht, ebenso
1085
+ * ein Zahlungsbeleg (seine Umsatzsteuer steht auf der Rechnung).
1084
1086
  */
1085
1087
  function nacherfassungBlock(receipt, company) {
1086
- const m = receipt.manualReceipt;
1087
- if (!m)
1088
+ const teile = nacherfassungTeile(receipt);
1089
+ if (!teile)
1088
1090
  return [];
1089
- const aus = [bannerZeile('NACHERFASSUNG')];
1090
- aus.push(textZeile(m.reason === 'outside_premises' ? 'Leistung außer Haus' : 'nach Ausfall der Kasse', 'center'));
1091
- const grund = m.reason === 'other' ? m.note : NACHERFASSUNG_GRUND[m.reason];
1092
- if (grund)
1093
- aus.push(textZeile(`Grund: ${grund}`, 'center'));
1094
- aus.push({ kind: 'space', lines: 1 });
1095
- const tag = handbelegDatum(m.date);
1096
- if (m.numberTo) {
1097
- aus.push(textZeile('Tagessammelbeleg', 'center'));
1098
- aus.push(textZeile(`Handbelege Nr. ${m.number} bis ${m.numberTo}`, 'center'));
1099
- aus.push(textZeile(`${m.count ? `${m.count} Belege ` : ''}vom ${tag}`, 'center'));
1100
- if (!company.isSmallBusiness)
1101
- aus.push(textZeile('USt: Duplikat der Handbelege', 'center'));
1102
- }
1103
- else {
1104
- aus.push(textZeile(`Handbeleg Nr. ${m.number}`, 'center'));
1105
- aus.push(textZeile(`vom ${tag}${m.time ? `, ${m.time} Uhr` : ''}`, 'center'));
1106
- if (!company.isSmallBusiness)
1107
- aus.push(textZeile('USt: Duplikat des Handbelegs', 'center'));
1108
- }
1109
- return aus;
1091
+ const ust = !company.isSmallBusiness && !istNurRechnungszahlung(receipt);
1092
+ return [
1093
+ bannerZeile(teile.title),
1094
+ ...teile.anlass.map((z) => textZeile(z, 'center')),
1095
+ { kind: 'space', lines: 1 },
1096
+ ...teile.handbeleg.map((z) => textZeile(z, 'center')),
1097
+ ...(ust ? [textZeile(teile.ustHinweis, 'center')] : []),
1098
+ ];
1110
1099
  }
1111
1100
  /**
1112
1101
  * Belegart-Block unter dem Betriebskopf: Titel als Banner, Untertitel als
@@ -1115,21 +1104,9 @@ function nacherfassungBlock(receipt, company) {
1115
1104
  function belegartBlock(receipt) {
1116
1105
  const t = belegtyp(receipt);
1117
1106
  const aus = [];
1118
- if (t === 'cancellation') {
1119
- aus.push(bannerZeile('STORNOBELEG'));
1120
- aus.push(textZeile(receipt.cancellationOf ? `Stornobuchung zu Beleg ${receipt.cancellationOf.receiptId}` : 'Stornobuchung', 'center'));
1121
- // Datum des Originals, wenn der Bezug es traegt (Backend seit 2026-09-04).
1122
- const datum = receipt.cancellationOf?.timeStamp ? originalDatum(receipt.cancellationOf.timeStamp) : null;
1123
- if (datum)
1124
- aus.push(textZeile(`vom ${datum}`, 'center'));
1125
- const grund = stornoGrundText(typeof receipt.cancellationReason === 'string' ? receipt.cancellationReason : undefined);
1126
- if (grund)
1127
- aus.push(textZeile(`Grund: ${grund}`, 'center'));
1128
- }
1129
- else if (t === 'training') {
1130
- aus.push(bannerZeile('TRAININGSBELEG'));
1131
- for (const z of TRAINING_ERKLAERUNG)
1132
- aus.push(textZeile(z, 'center'));
1107
+ const vermerk = stornoVermerk(receipt) ?? trainingVermerk(receipt);
1108
+ if (vermerk) {
1109
+ aus.push(...vermerkZeilen(vermerk));
1133
1110
  }
1134
1111
  else if (istReinerLeergutBeleg(receipt)) {
1135
1112
  aus.push(textZeile(LEERGUT_UEBERSCHRIFT, 'center', true));
@@ -1181,9 +1158,9 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1181
1158
  const nullbeleg = receiptIsZero(receipt) && (ruleset === 1 || receiptAmountsAreZero(receipt));
1182
1159
  const warnungen = [];
1183
1160
  if (options.testCashregister)
1184
- warnungen.push(bannerZeile(TESTKASSE_TEXT, 'warning'));
1161
+ warnungen.push(bannerZeile(testkasseVermerk().title, 'warning'));
1185
1162
  if (options.testSignature)
1186
- warnungen.push(bannerZeile(TESTSIGNATUR_TEXT, 'warning'));
1163
+ warnungen.push(bannerZeile(testsignaturVermerk().title, 'warning'));
1187
1164
  // --- Warnrahmen oben (Testkasse/Testsignatur): ueber dem Kopf, damit ihn niemand uebersieht.
1188
1165
  lines.push(...warnungen);
1189
1166
  // --- Belegkopf: Firma, Anschrift, Steuerangabe, Telefon
@@ -1227,8 +1204,9 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1227
1204
  lines.push(textZeile(zeile, 'center'));
1228
1205
  lines.push({ kind: 'space', lines: 1 });
1229
1206
  }
1230
- if (receiptSignatureFailed(receipt)) {
1231
- lines.push(textZeile(SIGNATUR_AUSGEFALLEN, 'center'));
1207
+ const ausfall = signaturausfallVermerk(receipt);
1208
+ if (ausfall) {
1209
+ lines.push(textZeile(ausfall.title, 'center'));
1232
1210
  lines.push({ kind: 'space', lines: 1 });
1233
1211
  }
1234
1212
  lines.push({ kind: 'qr', data: receipt.qr });
@@ -1285,9 +1263,16 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1285
1263
  gebundenesPfand.add(k);
1286
1264
  const reihe = mitPfandReihenfolge(receipt.items, addOnDisplayOrder(receipt.items), pfandZu);
1287
1265
  const an = (k) => receipt.items[reihe[k]];
1266
+ const rzBezuege = rechnungszahlungBezuege(receipt);
1288
1267
  let i = 0;
1289
1268
  while (i < reihe.length) {
1290
1269
  const item = an(i);
1270
+ // Zahlung auf Rechnung: eigene Zeilen, nicht in der Steuertabelle (die Umsatzsteuer steht auf der Rechnung).
1271
+ if (isInvoicePaymentItem(item)) {
1272
+ lines.push(...rechnungszahlungZeilen(item, rzBezuege.get(reihe[i])));
1273
+ i += 1;
1274
+ continue;
1275
+ }
1291
1276
  if (!isTipItem(item) && !isDiscountItem(item)) {
1292
1277
  const satz = steuersatz(item.vat);
1293
1278
  gruppeVon(satz).bruttoCents += receiptItemTotalCents(item);
@@ -1371,9 +1356,12 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1371
1356
  }
1372
1357
  }
1373
1358
  verteilePromoGutschein(gruppen, promoCents);
1374
- // --- USt-Aufteilung
1375
- lines.push({ kind: 'space', lines: 1 });
1376
- lines.push(tabellenZeile(['MwSt%', 'MwSt', 'Netto', 'Brutto'], paperSize));
1359
+ // --- USt-Aufteilung; ein Zahlungsbeleg hat keine (seine Umsatzsteuer steht auf der Rechnung).
1360
+ const nurRechnungszahlung = istNurRechnungszahlung(receipt);
1361
+ if (!(nurRechnungszahlung && gruppen.size === 0)) {
1362
+ lines.push({ kind: 'space', lines: 1 });
1363
+ lines.push(tabellenZeile(['MwSt%', 'MwSt', 'Netto', 'Brutto'], paperSize));
1364
+ }
1377
1365
  for (const gruppe of gruppen.values()) {
1378
1366
  // Netto aus dem Brutto in ganzen Cent, MwSt als Rest: so ergeben Netto und
1379
1367
  // MwSt zusammen immer wieder exakt den Brutto-Betrag der Zeile. (Das
@@ -1447,8 +1435,9 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1447
1435
  lines.push(paarZeile('Gesamt:', `${formatCents(summeCents)} €`));
1448
1436
  lines.push(...(rueckgaben.length > 0 ? rueckgabeZahlungsZeilen(receipt, rueckgaben) : zahlungsZeilen(receipt)));
1449
1437
  lines.push({ kind: 'space', lines: 1 });
1450
- // --- Rechtshinweise und Ausfallhinweis
1451
- const hinweise = company.isSmallBusiness
1438
+ // --- Rechtshinweise und Ausfallhinweis. Der Kleinunternehmer-Hinweis erklaert die 0-%-Zeilen der
1439
+ // Steuertabelle; ein Zahlungsbeleg hat keine, den Hinweis traegt seine Rechnung.
1440
+ const hinweise = company.isSmallBusiness && !nurRechnungszahlung
1452
1441
  ? [SMALL_BUSINESS_NOTICE, ...receipt.legalMessage]
1453
1442
  : receipt.legalMessage;
1454
1443
  if (hinweise.length > 0) {
@@ -1457,8 +1446,9 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1457
1446
  }
1458
1447
  lines.push({ kind: 'space', lines: 1 });
1459
1448
  }
1460
- if (receiptSignatureFailed(receipt)) {
1461
- lines.push(textZeile(SIGNATUR_AUSGEFALLEN, 'center'));
1449
+ const ausfall = signaturausfallVermerk(receipt);
1450
+ if (ausfall) {
1451
+ lines.push(textZeile(ausfall.title, 'center'));
1462
1452
  lines.push({ kind: 'space', lines: 1 });
1463
1453
  }
1464
1454
  // --- RKSV-QR-Code
@@ -186,8 +186,13 @@ export function shiftReceiptLayout(receipt, options = {}) {
186
186
  if (bon.comment)
187
187
  zeilen.push(text(`${labelText('shift_receipt.comment')}: ${bon.comment}`));
188
188
  zeilen.push(...nachZaehlungZeilen(bon));
189
- // Zur Information: unbar, Zaehler.
189
+ // Zur Information: Zahlungen auf Rechnungen, unbar, Zaehler.
190
190
  zeilen.push(regel());
191
+ // Zahlungen auf Rechnungen (1.38.0): nur Information, das Geld steckt schon im Barumsatz bzw. unbar.
192
+ // Ohne Betrag (fehlt oder 0) keine Zeile, der Bon bleibt wie bisher.
193
+ if (bon.invoicePaymentCents !== undefined && bon.invoicePaymentCents !== 0) {
194
+ zeilen.push(betrag(labelText('shift_receipt.invoice_payments'), bon.invoicePaymentCents));
195
+ }
191
196
  if (bon.nonCashByMethod.length > 0) {
192
197
  zeilen.push(text(labelText('shift_receipt.non_cash'), 'left', true));
193
198
  for (const u of bon.nonCashByMethod)