@kreiseck/kasseneck-api 1.36.0 → 1.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (226) hide show
  1. package/CHANGELOG.md +45 -1
  2. package/README.md +16 -0
  3. package/dist/cjs/client/aufrufe.d.ts +2 -2
  4. package/dist/cjs/client/aufrufe.js +5 -0
  5. package/dist/cjs/client/receipts.d.ts +1 -1
  6. package/dist/cjs/index.d.ts +1 -1
  7. package/dist/cjs/index.js +6 -5
  8. package/dist/cjs/invoice/texte.d.ts +18 -1
  9. package/dist/cjs/invoice/texte.js +43 -2
  10. package/dist/cjs/invoice/vertrag.d.ts +1 -1
  11. package/dist/cjs/invoice/vertrag.js +1 -0
  12. package/dist/cjs/models/cancellation.d.ts +1 -1
  13. package/dist/cjs/models/cancellation.js +2 -0
  14. package/dist/cjs/models/index.d.ts +2 -1
  15. package/dist/cjs/models/index.js +6 -3
  16. package/dist/cjs/models/invoice-payment-ref.d.ts +42 -0
  17. package/dist/cjs/models/invoice-payment-ref.js +38 -0
  18. package/dist/cjs/models/receipt-item.d.ts +10 -2
  19. package/dist/cjs/models/receipt-item.js +14 -1
  20. package/dist/cjs/models/receipt.d.ts +7 -0
  21. package/dist/cjs/models/receipt.js +6 -0
  22. package/dist/cjs/payments/hobex-hps/index.d.ts +2 -1
  23. package/dist/cjs/payments/hobex-hps/index.js +3 -1
  24. package/dist/cjs/payments/hobex-hps/outcome.d.ts +10 -0
  25. package/dist/cjs/payments/hobex-hps/payments.d.ts +54 -0
  26. package/dist/cjs/payments/hobex-hps/payments.js +157 -1
  27. package/dist/cjs/payments/hobex-hps/support.d.ts +19 -0
  28. package/dist/cjs/payments/hobex-hps/support.js +22 -0
  29. package/dist/cjs/payments/hobex-hps/transaction-response.js +1 -1
  30. package/dist/cjs/payments/index.d.ts +1 -1
  31. package/dist/cjs/payments/index.js +2 -1
  32. package/dist/cjs/pos/errors.d.ts +1 -1
  33. package/dist/cjs/pos/errors.js +1 -0
  34. package/dist/cjs/pos/index.d.ts +4 -4
  35. package/dist/cjs/pos/index.js +13 -5
  36. package/dist/cjs/pos/schicht-lesen.d.ts +3 -1
  37. package/dist/cjs/pos/schicht-lesen.js +28 -1
  38. package/dist/cjs/pos/schicht-typen.d.ts +50 -4
  39. package/dist/cjs/pos/schicht-typen.js +7 -2
  40. package/dist/cjs/pos/schicht.d.ts +6 -4
  41. package/dist/cjs/pos/schicht.js +6 -3
  42. package/dist/cjs/pos/settings.d.ts +37 -8
  43. package/dist/cjs/pos/settings.js +34 -10
  44. package/dist/cjs/pos/texte.d.ts +262 -4
  45. package/dist/cjs/pos/texte.js +157 -7
  46. package/dist/cjs/pos/trinkgeld.d.ts +30 -0
  47. package/dist/cjs/pos/trinkgeld.js +30 -0
  48. package/dist/cjs/receipt/index.d.ts +1 -0
  49. package/dist/cjs/receipt/index.js +4 -2
  50. package/dist/cjs/receipt/layout.d.ts +2 -2
  51. package/dist/cjs/receipt/layout.js +106 -117
  52. package/dist/cjs/receipt/shift-sheet.js +12 -2
  53. package/dist/cjs/receipt/vermerke.d.ts +80 -0
  54. package/dist/cjs/receipt/vermerke.js +167 -0
  55. package/dist/cjs/register/pairing.d.ts +4 -0
  56. package/dist/cjs/register/pairing.js +2 -0
  57. package/dist/cjs/stored/draht.js +25 -1
  58. package/dist/cjs/stored/vokabular.d.ts +1 -1
  59. package/dist/cjs/stored/vokabular.js +32 -2
  60. package/dist/cjs/version.d.ts +1 -1
  61. package/dist/cjs/version.js +1 -1
  62. package/dist/esm/client/aufrufe.d.ts +2 -2
  63. package/dist/esm/client/aufrufe.js +5 -0
  64. package/dist/esm/client/receipts.d.ts +1 -1
  65. package/dist/esm/index.d.ts +1 -1
  66. package/dist/esm/index.js +1 -1
  67. package/dist/esm/invoice/texte.d.ts +18 -1
  68. package/dist/esm/invoice/texte.js +43 -2
  69. package/dist/esm/invoice/vertrag.d.ts +1 -1
  70. package/dist/esm/invoice/vertrag.js +1 -0
  71. package/dist/esm/models/cancellation.d.ts +1 -1
  72. package/dist/esm/models/cancellation.js +2 -0
  73. package/dist/esm/models/index.d.ts +2 -1
  74. package/dist/esm/models/index.js +2 -1
  75. package/dist/esm/models/invoice-payment-ref.d.ts +42 -0
  76. package/dist/esm/models/invoice-payment-ref.js +35 -0
  77. package/dist/esm/models/receipt-item.d.ts +10 -2
  78. package/dist/esm/models/receipt-item.js +13 -1
  79. package/dist/esm/models/receipt.d.ts +7 -0
  80. package/dist/esm/models/receipt.js +6 -0
  81. package/dist/esm/payments/hobex-hps/index.d.ts +2 -1
  82. package/dist/esm/payments/hobex-hps/index.js +1 -0
  83. package/dist/esm/payments/hobex-hps/outcome.d.ts +10 -0
  84. package/dist/esm/payments/hobex-hps/payments.d.ts +54 -0
  85. package/dist/esm/payments/hobex-hps/payments.js +158 -2
  86. package/dist/esm/payments/hobex-hps/support.d.ts +19 -0
  87. package/dist/esm/payments/hobex-hps/support.js +19 -0
  88. package/dist/esm/payments/hobex-hps/transaction-response.js +1 -1
  89. package/dist/esm/payments/index.d.ts +1 -1
  90. package/dist/esm/payments/index.js +1 -1
  91. package/dist/esm/pos/errors.d.ts +1 -1
  92. package/dist/esm/pos/errors.js +1 -0
  93. package/dist/esm/pos/index.d.ts +4 -4
  94. package/dist/esm/pos/index.js +5 -5
  95. package/dist/esm/pos/schicht-lesen.d.ts +3 -1
  96. package/dist/esm/pos/schicht-lesen.js +27 -1
  97. package/dist/esm/pos/schicht-typen.d.ts +50 -4
  98. package/dist/esm/pos/schicht-typen.js +6 -1
  99. package/dist/esm/pos/schicht.d.ts +6 -4
  100. package/dist/esm/pos/schicht.js +6 -3
  101. package/dist/esm/pos/settings.d.ts +37 -8
  102. package/dist/esm/pos/settings.js +30 -9
  103. package/dist/esm/pos/texte.d.ts +262 -4
  104. package/dist/esm/pos/texte.js +156 -6
  105. package/dist/esm/pos/trinkgeld.d.ts +30 -0
  106. package/dist/esm/pos/trinkgeld.js +28 -0
  107. package/dist/esm/receipt/index.d.ts +1 -0
  108. package/dist/esm/receipt/index.js +1 -0
  109. package/dist/esm/receipt/layout.d.ts +2 -2
  110. package/dist/esm/receipt/layout.js +103 -113
  111. package/dist/esm/receipt/shift-sheet.js +12 -2
  112. package/dist/esm/receipt/vermerke.d.ts +80 -0
  113. package/dist/esm/receipt/vermerke.js +155 -0
  114. package/dist/esm/register/pairing.d.ts +4 -0
  115. package/dist/esm/register/pairing.js +2 -0
  116. package/dist/esm/stored/draht.js +25 -1
  117. package/dist/esm/stored/vokabular.d.ts +1 -1
  118. package/dist/esm/stored/vokabular.js +32 -2
  119. package/dist/esm/version.d.ts +1 -1
  120. package/dist/esm/version.js +1 -1
  121. package/fixtures/duplicate-cases.json +1 -1
  122. package/fixtures/expected/duplicate.shift-close.hex +1 -1
  123. package/fixtures/expected/invoice-payment-cancellation.grid32.txt +28 -0
  124. package/fixtures/expected/invoice-payment-cancellation.grid48.txt +26 -0
  125. package/fixtures/expected/invoice-payment-cancellation.lines.json +189 -0
  126. package/fixtures/expected/invoice-payment-cancellation.sheet32.json +194 -0
  127. package/fixtures/expected/invoice-payment-cancellation.sheet48.json +182 -0
  128. package/fixtures/expected/invoice-payment-manual-receipt.grid32.txt +30 -0
  129. package/fixtures/expected/invoice-payment-manual-receipt.grid48.txt +29 -0
  130. package/fixtures/expected/invoice-payment-manual-receipt.lines.json +199 -0
  131. package/fixtures/expected/invoice-payment-manual-receipt.sheet32.json +206 -0
  132. package/fixtures/expected/invoice-payment-manual-receipt.sheet48.json +200 -0
  133. package/fixtures/expected/invoice-payment-normal.grid32.txt +22 -0
  134. package/fixtures/expected/invoice-payment-normal.grid48.txt +21 -0
  135. package/fixtures/expected/invoice-payment-normal.lines.json +192 -0
  136. package/fixtures/expected/invoice-payment-normal.sheet32.json +158 -0
  137. package/fixtures/expected/invoice-payment-normal.sheet48.json +152 -0
  138. package/fixtures/expected/invoice-payment-outage.grid32.txt +23 -0
  139. package/fixtures/expected/invoice-payment-outage.grid48.txt +21 -0
  140. package/fixtures/expected/invoice-payment-outage.lines.json +172 -0
  141. package/fixtures/expected/invoice-payment-outage.sheet32.json +164 -0
  142. package/fixtures/expected/invoice-payment-outage.sheet48.json +152 -0
  143. package/fixtures/expected/invoice-payment-partial.grid32.txt +20 -0
  144. package/fixtures/expected/invoice-payment-partial.grid48.txt +20 -0
  145. package/fixtures/expected/invoice-payment-partial.lines.json +162 -0
  146. package/fixtures/expected/invoice-payment-partial.sheet32.json +146 -0
  147. package/fixtures/expected/invoice-payment-partial.sheet48.json +146 -0
  148. package/fixtures/expected/invoice-payment-refund.grid32.txt +20 -0
  149. package/fixtures/expected/invoice-payment-refund.grid48.txt +20 -0
  150. package/fixtures/expected/invoice-payment-refund.lines.json +162 -0
  151. package/fixtures/expected/invoice-payment-refund.sheet32.json +146 -0
  152. package/fixtures/expected/invoice-payment-refund.sheet48.json +146 -0
  153. package/fixtures/expected/invoice-payment-see-invoice.grid32.txt +22 -0
  154. package/fixtures/expected/invoice-payment-see-invoice.grid48.txt +21 -0
  155. package/fixtures/expected/invoice-payment-see-invoice.lines.json +192 -0
  156. package/fixtures/expected/invoice-payment-see-invoice.sheet32.json +158 -0
  157. package/fixtures/expected/invoice-payment-see-invoice.sheet48.json +152 -0
  158. package/fixtures/expected/invoice-payment-training.grid32.txt +30 -0
  159. package/fixtures/expected/invoice-payment-training.grid48.txt +27 -0
  160. package/fixtures/expected/invoice-payment-training.lines.json +183 -0
  161. package/fixtures/expected/invoice-payment-training.sheet32.json +206 -0
  162. package/fixtures/expected/invoice-payment-training.sheet48.json +188 -0
  163. package/fixtures/expected/invoice-payment-without-vat.grid32.txt +20 -0
  164. package/fixtures/expected/invoice-payment-without-vat.grid48.txt +19 -0
  165. package/fixtures/expected/invoice-payment-without-vat.lines.json +162 -0
  166. package/fixtures/expected/invoice-payment-without-vat.sheet32.json +146 -0
  167. package/fixtures/expected/invoice-payment-without-vat.sheet48.json +140 -0
  168. package/fixtures/expected/invoice-payment-zero-percent.grid32.txt +22 -0
  169. package/fixtures/expected/invoice-payment-zero-percent.grid48.txt +21 -0
  170. package/fixtures/expected/invoice-payment-zero-percent.lines.json +192 -0
  171. package/fixtures/expected/invoice-payment-zero-percent.sheet32.json +158 -0
  172. package/fixtures/expected/invoice-payment-zero-percent.sheet48.json +152 -0
  173. package/fixtures/expected/shift-close-card-tips.grid32.txt +44 -0
  174. package/fixtures/expected/shift-close-card-tips.grid48.txt +40 -0
  175. package/fixtures/expected/shift-close-card-tips.lines.json +479 -0
  176. package/fixtures/expected/shift-close-put-in.grid32.txt +1 -1
  177. package/fixtures/expected/shift-close-put-in.grid48.txt +1 -1
  178. package/fixtures/expected/shift-close-put-in.lines.json +1 -1
  179. package/fixtures/expected/shift-close-take-out.grid32.txt +1 -1
  180. package/fixtures/expected/shift-close-take-out.grid48.txt +1 -1
  181. package/fixtures/expected/shift-close-take-out.lines.json +1 -1
  182. package/fixtures/expected/shift-close.grid32.txt +1 -1
  183. package/fixtures/expected/shift-close.grid48.txt +1 -1
  184. package/fixtures/expected/shift-close.lines.json +1 -1
  185. package/fixtures/expected/shift-interim-card-tips.grid32.txt +34 -0
  186. package/fixtures/expected/shift-interim-card-tips.grid48.txt +31 -0
  187. package/fixtures/expected/shift-interim-card-tips.lines.json +344 -0
  188. package/fixtures/hobex-hps-codes.json +2 -2
  189. package/fixtures/invoice-api.schema.json +3 -2
  190. package/fixtures/invoice-texts.json +37 -3
  191. package/fixtures/manifest.json +80 -0
  192. package/fixtures/pos-message-cases.json +3 -0
  193. package/fixtures/pos-texts.json +313 -3
  194. package/fixtures/receipt-due-generated.json +3 -3
  195. package/fixtures/receipt-due-voucher-generated.json +5 -5
  196. package/fixtures/receipts/invoice-payment-cancellation.json +70 -0
  197. package/fixtures/receipts/invoice-payment-manual-receipt.json +69 -0
  198. package/fixtures/receipts/invoice-payment-normal.json +65 -0
  199. package/fixtures/receipts/invoice-payment-outage.json +63 -0
  200. package/fixtures/receipts/invoice-payment-partial.json +63 -0
  201. package/fixtures/receipts/invoice-payment-refund.json +63 -0
  202. package/fixtures/receipts/invoice-payment-see-invoice.json +65 -0
  203. package/fixtures/receipts/invoice-payment-training.json +63 -0
  204. package/fixtures/receipts/invoice-payment-without-vat.json +63 -0
  205. package/fixtures/receipts/invoice-payment-zero-percent.json +65 -0
  206. package/fixtures/renames-1.0.json +10 -0
  207. package/fixtures/shift-ablauf-cases.json +4 -4
  208. package/fixtures/shift-cases.json +4 -2
  209. package/fixtures/shift-receipts-card-tips.json +73 -0
  210. package/fixtures/shift-receipts.json +9 -9
  211. package/fixtures/stored/card-tip-cases.json +132 -0
  212. package/fixtures/surface.json +23 -6
  213. package/fixtures/v3/antworten/belege.json +2 -2
  214. package/fixtures/v3/antworten/belegmail.json +2 -2
  215. package/fixtures/v3/antworten/berichte.json +2 -2
  216. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  217. package/fixtures/v3/antworten/kasse.json +247 -127
  218. package/fixtures/v3/antworten/lager.json +1 -1
  219. package/fixtures/v3/antworten/rechnungen.json +2 -2
  220. package/fixtures/v3/antworten/storno.json +2 -2
  221. package/fixtures/v3/stored/belege.json +2 -2
  222. package/fixtures/v3/stored/kasse.json +3 -3
  223. package/fixtures/v3/stored/rechnungen.json +2 -2
  224. package/fixtures/v3/v3-vokabular.json +264 -21
  225. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  226. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -4,7 +4,51 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
4
4
  es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
5
5
  nur der Grund überlebt den nächsten Umbau.
6
6
 
7
- ## 1.36.0 - unveröffentlicht
7
+ ## 1.38.0 - unveröffentlicht
8
+
9
+ Payment on invoices: when an invoice is paid in cash or by card on site, the server writes a payment receipt ("Zahlung auf Rechnung") into the cash register the money goes into. This version reads, prints and explains such receipts. Additive; every existing call, receipt and golden behaves as before (all existing goldens are byte-identical, eight new ones are added).
10
+
11
+ - **Position kind `invoice_payment`** (`ReceiptItem.kind`, `isInvoicePaymentItem`): a position of a payment receipt. It counts in the RKSV field "Null", but it is not tax-free revenue, the VAT is on the invoice. The receipt layout prints it without quantity and without tax category ("Zahlung auf Rechnung 2026-0042 | 1569,60"), leaves it out of the VAT table (a receipt with only such positions has no table) and never shows "0 %" for it. Below the position it prints the tax note of the invoice (`taxNote`, see below): `inkl. USt`, `0 % USt` or `Steuerangaben siehe Rechnung`, none without a note; "0 %" never stands at the position itself, only as that note, and a small business gets the note `0 % USt` but not the small-business notice; and a recorded handwritten payment receipt gets no "USt: Duplikat …" line. The kind travels with `toReceiptItemPayload`; a request from a till never carries it (only the server creates payment receipts). Reason: one number on the invoice, the other in the cash register, and the VAT counted once, on the invoice.
12
+ - **`Receipt.invoicePayments`** (type `InvoicePaymentRef`: `invoiceId`, `invoiceNumber`, `paymentId`, `customerId`, `amountCents`, `partial`, `paidOn`, `taxNote`; reader `readInvoicePaymentRefs`): one reference per invoice, in the order of the positions (the n-th `invoice_payment` position belongs to the n-th reference). Not signed, like `cancellationOf`. An entry without invoice id, number, payment id or integer amount is dropped; `taxNote` (`InvoicePaymentTaxNote`) is optional and has three values: `incl_vat` (the invoice shows VAT), `zero_percent` (no VAT because exempt or not taxable, also small business) and `see_invoice` (reverse charge); an unknown or missing value means no note.
13
+ - **`receiptNotes(receipt, { testCashregister?, testSignature? })`** (`./receipt`, types `ReceiptNote`, `ReceiptNoteKind`, `ReceiptNotesOptions`): the notes of a receipt as `{ kind, title, lines }` in a fixed order: `test_cashregister`, `test_signature`, `training`, `cancellation`, `manual_receipt`, `signature_outage`. Same building blocks and words as the receipt layout (module `vermerke.ts`), so the cash-register section on an A4 invoice or payment confirmation arranges the same notes without rules of its own. The note of a recorded handwritten receipt has no "USt: Duplikat …" line (that depends on the business and stays in the layout). An unknown or old German option (`testKasse`) throws `KasseneckValidationError` (scope `request`), so a test receipt never looks valid.
14
+ - **Cancellation code `invoice_payment_not_cancellable`** in `CANCELLATION_ERROR_CODES` (after `idempotency_key_required`): a payment receipt is cancelled only at its invoice in the customer area, never from a till. The code is part of the taken-over contract export now (`fixtures/v3/`, backend package 0.40.0); the temporary allowance `VOR_DEM_VERTRAG` in `test/receipts-v3.test.ts` is gone.
15
+ - **Till texts** (`fixtures/pos-texts.json`, `fixtures/pos-message-cases.json`): message `cancellation.invoice_payment_not_cancellable` "Diese Zahlung gehört zu einer Rechnung. Storniere sie im Kundenbereich bei der Rechnung." with a code rule in `ERROR_CODE_RULES` and its case; `cancellationErrorMessage` also applies a code rule whose key is a `cancellation.*` message (only this one so far). Label `shift_receipt.invoice_payments` "Zahlungen auf Rechnungen".
16
+ - **Shift:** `ShiftRunningTotals.invoicePaymentCents` and `ShiftSummaryReceipt.invoicePaymentCents` (optional, read as sent, integer): payments on invoices of the shift, cash and non-cash, information only (the money is already in cash sales or non-cash). The Z and X receipt print "Zahlungen auf Rechnungen" with the amount at the start of the information block; without the field or with 0 the receipt stays as before.
17
+ - **Invoice texts** (`fixtures/invoice-texts.json`, de and en): `pdf.paid.text` is short now, "Diese Rechnung ist beglichen." / "This invoice has been paid." (the sentence "Es ist nichts weiter zu tun." is dropped for every paid invoice). New: `pdf.title.payment_confirmation`, `pdf.title.refund_confirmation`, `pdf.cash_register.header` ("REGISTRIERKASSE"), `pdf.cash_register.receipt_number`, `pdf.cash_register.date`, `pdf.confirmation.intro`, `pdf.confirmation.not_invoice` and the columns `pdf.confirmation.table.invoice`, `.amount`, `.paid_so_far`, `.received_today`, `.still_open` for the cash-register section and the payment confirmation.
18
+ - **Contract taken over** (`node scripts/v3-vertrag-holen.mjs`, then `npm run fixtures:stored`): besides the cancellation code the contract carries the receipt field `invoicePayments` and the error codes `invoice_payment_server_only`, `invoice_payment_mixed`, `invalid_invoice_payment`. `./stored` reads a stored `rechnungszahlung` into `invoicePayments` (all eight keys; `nummer` becomes `invoiceNumber`, `kundeId` `customerId`, `teil` `partial`, `zahlungVom` `paidOn`, `steuerhinweis` `taxNote` with `inkl_ust`/`null_prozent`/`siehe_rechnung` becoming `incl_vat`/`zero_percent`/`see_invoice`; since the contract was taken over again the vocabulary export knows the rename and the value catalogue, the hand mapping in `./stored` stays on purpose and accepts German and English values).
19
+ - **Tax note texts** (`pdf.cash_register.tax.incl_vat`, `.zero_percent`, `.see_invoice`, de and en): "inkl. USt" / "incl. VAT", "0 % USt" / "0 % VAT", "Steuerangaben siehe Rechnung" / "Tax details see invoice" for the cash register part on the A4 page, in the language of the invoice. On the receipt the notes stay German. New golden receipts `invoice-payment-zero-percent` and `invoice-payment-see-invoice`; `invoice-payment-without-vat` (small business) now prints `0 % USt`, all other goldens are unchanged.
20
+ - **Short paid texts** (`pdf.paid.cash`, `pdf.paid.card`, de and en): "Bar bezahlt am {date}." / "Paid in cash on {date}." and "Mit Karte bezahlt am {date}." / "Paid by card on {date}." for an invoice paid on site.
21
+ - **Invoice code `cash_receipt_pending`** (appended to `INVOICE_ERROR_CODES`, after `invalid_deposit`; `fixtures/invoice-api.schema.json` and `fixtures/surface.json` regenerated): the invoice was paid in cash, the cash receipt of the payment is not finished yet, so the invoice PDF cannot be issued; call again shortly. The contract was taken over again from the backend (`node scripts/v3-vertrag-holen.mjs`, `npm run fixtures:stored`); besides the new code only the fingerprints changed.
22
+ - **Contract taken over again** (rename `inklUst`/`includesVat` to `steuerhinweis`/`taxNote`): the export carries the field `taxNote` and the catalogue `RECHNUNGSZAHLUNG_STEUERHINWEIS` (`inkl_ust` becomes `incl_vat`, `null_prozent` `zero_percent`, `siehe_rechnung` `see_invoice`); `src/stored/vokabular.ts`, the stored twins and the generated amount-due fixtures were regenerated against the backend (source hashes only), otherwise only fingerprints changed.
23
+ - **Contract taken over again (only one's own tips):** without `cashView` and `cashMove` the backend returns only the caller's own entry in `getMyDrawerState` `tips` and `tipClaims`; in the case `success_cashier_tip_taken` the entry of `ru_chef` is gone. The package reads both lists as before, only the fixture and its test changed.
24
+ - **Goldens:** `invoice-payment-normal`, `-partial`, `-without-vat`, `-refund`, `-cancellation`, `-outage`, `-training`, `-manual-receipt` (lines, grids, sheets, print digests).
25
+ - `fixtures/surface.json`, `pos-texts.json`, `invoice-texts.json`, `hobex-hps-codes.json` and `invoice-api.schema.json` regenerated for the version.
26
+
27
+
28
+ ## 1.37.0 - unveröffentlicht
29
+
30
+ Late terminal query for a card payment with an open outcome (`HpsPayments.clarifyPayment` in `./payments`). Additive; `pay`, `refund` and `cancel` behave as before. Card tips at the register (backend spec 2026-11-11-kartentrinkgeld, stages 1 and 2). Additive; every existing call, golden and text behaves as before, except the wording changes named below.
31
+
32
+ - **`clarifyPayment({ transactionId, previous })`:** asks the terminal LATER whether a payment went through – when the cashier clarifies an unclear card, possibly minutes after the payment or after a page reload. Read-only: only status queries, never an abort, never a reversal, never a new transaction. Budget a sixth of `resolveBudgetMs` (15 s by default); two answers without a statement in a row end it as `unresolved` at once (the payment is long finished, the terminal will not know later either). What an answer may decide depends on `previous` – the `unresolved` result of `pay` (only `reason` counts), `'beforeResolve'` when the clarification of `pay` never started (the page died during the card flow, so no reversal was sent), or `null` when the history is unknown: after a host fault (`hostFault`, `hostTimeout`, `internalError`, `approvedWithCondition`) a reversal may have been sent, so `'0'` never means "charged" there; `9011` means "nothing charged" only without a host fault or when a reversal was surely attempted (every code with that reason carries `sendReversal`, computed from the table); any other conclusive decline decides only without a host fault; with unknown history nothing decides and the cashier decides by the terminal receipt as before. Reason: until now the register could only offer two blind buttons ("was charged" / "not charged") – the terminal knows better, and a wrong click costs a double charge or a receipt without money.
33
+ - `HpsClarifyOptions` exported from `./payments`.
34
+ - **Texts for a new version of the browser register** (`only: ['web']`): the message `version.new_available` („Neue Fassung verfügbar – bei Gelegenheit neu laden.“) and the label `version.reload` („Neu laden“). The browser register shows the line when the deploy delivers a different build than the open tab runs, and only while nothing is running at the register; it never reloads by itself. Reason: a register tab stays open all day and otherwise keeps running the old bundle until someone reloads.
35
+ - **Short texts for clarifying an unclear card payment** (both sides): the clarify window shows the label `split.clarify_title` („Karte klären · {amount}“), one line on the state – `split.clarify_asking` („Das Terminal wird gefragt …“), `split.clarify_open` („Das Terminal weiß es nicht. hobex kann die Zahlung nachsehen.“), `split.clarify_not_asked` („Das Terminal konnte nicht gefragt werden ({reason}). Bitte später erneut klären.“), the new `split.clarify_busy` („Das Terminal ist gerade belegt. Bitte gleich erneut klären.“) and `split.clarify_no_answer` („Das Terminal hat nicht geantwortet. Bitte später erneut klären.“) or the new `split.clarify_manual` („Das Terminal kann es nicht sicher sagen. hobex kann die Zahlung nachsehen.“) when the terminal was not asked at all – and the full reference as the label `split.clarify_reference` („Kennung {reference}“); `split.clarify_charged` and `split.clarify_not_charged` report the terminal's answer. New message `card_payment.unclear_short` („Kartenzahlung {amount} unklar – bitte klären. Kennung {reference}.“) for a card that already stands in the list to be clarified (warning corner, a new payment blocked by it); the reference may be shortened there, the window and the list carry it in full. `card_payment.unknown` and `card_payment.unknown_with_id` are unchanged and remain the sentence for a card that is not in such a list. Reason: the long sentence stood in the window, in the warning corner and in the blocking message at once; the owner chose „short with reference“ (11.11.2026).
36
+ - **Reason line in the clarify window** (both sides): one short message per reason with a fault at or after the hobex host (`isHostUncertainReason`; key = reason in snake_case) – `split.clarify_reason_host_fault` („Grund: Störung zwischen Terminal und hobex.“), `split.clarify_reason_host_timeout`, `split.clarify_reason_internal_error`, `split.clarify_reason_approved_with_condition` – and `split.clarify_reason_terminal` („Grund: Das Terminal meldete „{text}“ (Code {code}).“) for a code without a fixed meaning. The register shows it as a grey line under the state line; the warning corner keeps only `card_payment.unclear_short`. Reason: the owner chose one sentence for the corner, but the cashier must not lose why the outcome stayed open.
37
+ - **hobex support** (`./payments`): `HOBEX_SUPPORT` (`phone` `+43 662 2255-88`, `display` `0662 2255-88`, `availability` `24/7`; the owner's statement of 11.11.2026, extension 88 of the hobex head office +43 662 2255-0) and the labels `hobex_help.*` (both sides) for a window of its own: the number to tap with its availability („24/7“ from `HOBEX_SUPPORT.availability`), and under „Das fragt hobex“ what hobex asks on the phone – TID, reference, amount, time, message, protocol, address, serial number (only what the register knows; a row without a value is left out) – plus „Angaben kopieren“. Meant only where hobex can help (fault at the hobex host, terminal not in operation, wrong TID, the terminal answered and does not know the outcome), never for errors in the own network or at Kasseneck Connect. Reason: the owner wanted the number in a clean window with the data support asks for, not as a bare line (12.11.2026).
38
+ - **HPS texts without the terminal receipt** (both sides): the hobex HPS terminal prints no receipt the cashier could check (owner, 12.11.2026). New messages `card_payment.unknown_hps`, `card_payment.unknown_with_id_hps` („… Die Karte kann belastet sein: erst klären, dann neu kassieren.“), `split.card_reverse_failed_hps`, `split.card_reverse_unknown_hps`, `split.card_already_reversed_hps` say what to do instead of where to look; the clarify lines above name hobex or a later retry. `HPS_REASON_HINTS.approvedWithCondition` now says „weiß hobex“ instead of the terminal receipt. The texts without `_hps` stay for other terminals and keep their 1.0 wording (rename guard).
39
+ - **Card tips in three stages:** `PosBusinessSettings.tipCardKeptMode` (`ask` | `always` | `never`, optional like `tipKeptMode`), `tipCardKeptByDefault` (the switch's default at stage `ask`) and `tipSelfPayout` (emergency off switch, missing = on). Readers `posTipCardKeptMode`, `posTipCardKeptByDefault`, `posTipSelfPayout`; `tipKeptFor(business, wanted, method)` takes a third argument `'cash' | 'card'` (default `'cash'`, unchanged behaviour) and decides the card stage from the card fields. "Kept" means for a card tip: the employee takes the amount in cash out of the drawer. The settings only take effect at accounts the backend has switched to card tips via the register (`cashregister.cardTips` at login). Reason: the owner chose the same three stages for card tips as for cash tips; the register says in one line what happens to the money.
40
+ - **`tipStatus(method, kept)`** (`./pos`): the one line at checkout and on the done page, keyed by payment kind and outcome (`tip.line_cash_kept` "{amount} gleich einstecken", `tip.line_cash_open` "{amount} in der Lade lassen", `tip.line_card_kept` "{amount} aus der Lade nehmen", `tip.line_card_open` "{amount} später auszahlen"); the text comes from `labelText(key, { amount })`. Reason: both registers must say the same words, and the line says what really happens, not the stage.
41
+ - **`getMyTipBalance({ drawerId? | cashregisterId? })`** (register path `/api/v3`, read without effect): "Mein Trinkgeld" of the logged-in person — `openCents` (negative when paid out too much), `keptTodayCents`, `claimScope` (`per_drawer` | `per_person`, `TIP_CLAIM_SCOPES`), `currency` and `otherDrawers[]`; type `TipBalance`. Only a personal login; a shared device login or the owner gets `not_a_person_login` (appended to `POS_ERROR_CODES`). Reason: every employee sees her own stand and pays herself out.
42
+ - **`ShiftTipTotals.cardTipsTakenCents`** (optional, sent only when not 0, part of `paidOutCents`), `shiftTipLines` prints the line `shift_receipt.tip_card_taken` "davon Kartentrinkgeld" after "schon genommen", `EXPECTED_PART_KEYS` gains `card_tips_taken` (`shift.part_card_tips_taken` "Kartentrinkgeld bar genommen", expected = … − card tips taken) and the Z-/X-receipt data carry `cardTipsTakenCents` (sum) when there is any. Shared cases in `fixtures/shift-cases.json` (two new) and the new contract file `fixtures/stored/card-tip-cases.json` (drawer arithmetic per receipt, replayed by the backend; here `tipLines` and `tipStatus`). Reason: the drawer's expected cash drops by the card tips taken in cash, and the receipt must show why.
43
+ - **Texts** for the done page (`done.tip_*`), "Mein Trinkgeld" (`my_tips.*`), the cancellation line `cancellation.tip_deducted` "{amount} Trinkgeld werden vom Guthaben von {name} abgezogen", the settings (`tip_card_kept_mode.title`, `tip.card_kept_setting`, `tip_self_payout.title`) and the hints `tip.card_kept_setting_hint`, `tip.self_payout_hint`, `tip.overpaid_hint`, `tip.terminal_hint`. Same wording as the backend spec.
44
+ - **Z-/X-receipt line for card tips taken:** `shiftReceiptLayout` prints `shift.part_card_tips_taken` "Kartentrinkgeld bar genommen" with the negative sum (`ShiftSummaryReceipt.cardTipsTakenCents`) right after "Bar aus Verkäufen", also blind (like the movements); without the field or with 0 the receipt stays byte-identical (all existing goldens unchanged). The per-person line `shift_receipt.tip_card_taken` is shortened to "davon Kartentrinkgeld" so it fits one line on 80 mm. New goldens `expected/shift-{interim,close}-card-tips.*` with their own manifest `fixtures/shift-receipts-card-tips.json` (contract case + shallow `overlay`), so `shift-receipts.json` stays byte-identical. New label `tip_payout.nothing_open` "nichts offen" (instead of "erledigt" at accounts with card tips through the register). `tip.card_kept_setting_hint` now says when "kept" works for a card tip at all (open shift, enough cash in the drawer, employee sees the drawer balance; otherwise it stays open). Reason: start + cash + movements must add up to the expected cash on the receipt, too.
45
+ - **Stage 3 (register surfaces):** `RegisterDeviceUsers.cashregister.cardTips` (`true` only when the account runs card tips through the register; missing otherwise, then the register stays exactly as before). `TIP_CLAIM_SCOPE_LABELS` (`per_drawer` | `per_person` -> `tip_claim_scope.*`, also in `fixtures/pos-texts.json` as `tipClaimScopeLabels`) with the title `tip_claim_scope.title` and the hint `tip_claim_scope.hint` for the customer area, and `my_tips.payout_not_allowed` for "Mein Trinkgeld" without the right to pay out. Reason: the register needs to know whether the account is switched over before it shows the card stage, the done-page line and "Mein Trinkgeld"; the customer area sets where the open claim is kept (F2).
46
+ - **Contract:** `fixtures/v3/*` taken over from the backend (vocabulary entries `getMyTipBalance`, `tipCardKeptMode`, `tipCardKeptByDefault`, `tipSelfPayout`, catalogs `KASSE_BETRIEB_WERTE.tipCardKeptMode`, `TRINKGELD_ANSPRUCH`, expected part `card_tips_taken`, error code `not_a_person_login`), `fixtures/surface.json` lists the call.
47
+ - **„genommen“ instead of „schon genommen“** (both sides, owner 12.11.2026): `shift_receipt.tip_paid_out` (X/Z receipt, cash status) now reads „genommen“, `my_tips.kept_today` „Heute genommen“, and the two keep-setting hints say „gilt als genommen“. Shorter, and the same word on the receipt, in the register, the panel and the shift PDF. Shift receipt fixtures, print goldens and the two twin byte digests of the Z receipt with take-out are redrawn; the Dart twin pulls them with the texts.
48
+ - `fixtures/surface.json`, `pos-texts.json`, `invoice-texts.json`, `hobex-hps-codes.json` and `invoice-api.schema.json` regenerated for the version.
49
+
50
+
51
+ ## 1.36.0 - 2026-11-11
8
52
 
9
53
  Deposit on invoice and credit-note positions, and the EWP report (single-use deposit report) through the API key. Additive; every existing call, invoice and golden behaves as before.
10
54
 
package/README.md CHANGED
@@ -872,6 +872,16 @@ vom 11.08.2026, 09:02 Uhr / Grund: Fehleingabe". The date comes from
872
872
  `cancellationOf.timeStamp` (backend since 2026-09-04); older receipts without
873
873
  it omit that line.
874
874
 
875
+ **Payment receipts (payment on invoices).** A receipt whose positions carry
876
+ `kind: 'invoice_payment'` (`isInvoicePaymentItem`) takes money for one or more
877
+ invoices (cash or card on site) or pays it back for a credit note; only the
878
+ server creates it, and `receipt.invoicePayments` names the invoices in the
879
+ order of the positions. It is cancelled only at its invoice in the customer
880
+ area: `cancelReceipt` answers `invoice_payment_not_cancellable`, and the till
881
+ shows `cancellation.invoice_payment_not_cancellable` (`./pos`). The printed
882
+ receipt shows these positions without tax category and without VAT table,
883
+ with `inkl. USt` below when the invoice shows VAT.
884
+
875
885
  ## Sending a receipt by email
876
886
 
877
887
  ```ts
@@ -981,6 +991,12 @@ fitted, never scaled up. Banners (TESTKASSE, STORNOBELEG, …) are framed by
981
991
  `=` lines, the same on every path. The package rasterises finished RGBA pixels;
982
992
  loading and decoding the image (PNG, JPEG) stays with your application.
983
993
 
994
+ A page that shows a receipt in its own arrangement (the cash-register section
995
+ on an A4 invoice) takes the notes from `receiptNotes(receipt, { testCashregister,
996
+ testSignature })` (`./receipt`): `{ kind, title, lines }` for test register, test
997
+ signature, training, cancellation, recorded handwritten receipt and signature
998
+ outage, in this order, with the same words as the printed receipt.
999
+
984
1000
  ### Getting the bytes to the printer
985
1001
 
986
1002
  The package generates ESC/POS bytes and ePOS XML, and it ships three ways to
@@ -13,7 +13,7 @@
13
13
  * umhuellt, muss ihn weiterhin absetzen koennen.
14
14
  */
15
15
  import type { FileOrData, FileOrDataCallOptions, PdfOrData, TransportBodyFields, TransportCallOptions } from './transport.js';
16
- export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createDepExport", "createDepHandoverLink", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getDepExport", "getDepExportFile", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "revokeDepHandoverLink", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "getRegisterInspectionInfo", "reportConnectState", "learnMyLeergutCode", "listMyLeergutCodes", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady", "unfixTerminal", "listDepositTypes", "getEwpReport", "setEwpExtraQuantities"];
16
+ export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createDepExport", "createDepHandoverLink", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getDepExport", "getDepExportFile", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "revokeDepHandoverLink", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "getRegisterInspectionInfo", "reportConnectState", "learnMyLeergutCode", "listMyLeergutCodes", "getMyTipBalance", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady", "unfixTerminal", "listDepositTypes", "getEwpReport", "setEwpExtraQuantities"];
17
17
  export type ApiCall = typeof ALL_CALLS[number];
18
18
  /**
19
19
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -29,7 +29,7 @@ export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "can
29
29
  * die fuenf DEP-Aufrufe); die Kasse ruft sie trotzdem ueber diesen Weg (ein Dialekt
30
30
  * je Client, Nachtrag §5.2).
31
31
  */
32
- export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink", "getRegisterInspectionInfo", "reportConnectState", "learnMyLeergutCode", "listMyLeergutCodes"];
32
+ export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink", "getRegisterInspectionInfo", "reportConnectState", "learnMyLeergutCode", "listMyLeergutCodes", "getMyTipBalance"];
33
33
  export type PublicCall = typeof PUBLIC_CALLS[number];
34
34
  export type PosCall = typeof POS_CALLS[number];
35
35
  /**
@@ -160,6 +160,8 @@ exports.ALL_CALLS = [
160
160
  // Leergut-Codes (Pfand, ./pos): Codes lernen und lesen; nur ueber den Kassenweg.
161
161
  'learnMyLeergutCode',
162
162
  'listMyLeergutCodes',
163
+ // „Mein Trinkgeld“ (./pos): Stand der angemeldeten Person; nur ueber den Kassenweg.
164
+ 'getMyTipBalance',
163
165
  // Kartenterminal am Handy: Geraet, Zugang, TID und Code (nur /v3).
164
166
  'registerTerminalDevice',
165
167
  'getTerminalAccess',
@@ -390,6 +392,8 @@ exports.POS_CALLS = [
390
392
  // Leergut-Codes lernen und lesen: Kassen-Benutzer mit dem Recht depositReturn.
391
393
  'learnMyLeergutCode',
392
394
  'listMyLeergutCodes',
395
+ // „Mein Trinkgeld“: nur ueber den Kassenweg, nur persoenliche Anmeldung.
396
+ 'getMyTipBalance',
393
397
  ];
394
398
  /**
395
399
  * Die Aufrufe **mit Wirkung**, alphabetisch: sie legen etwas an, aendern oder
@@ -549,6 +553,7 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
549
553
  getInvoiceXml: 'read',
550
554
  getKasseSettings: 'read',
551
555
  getMyDrawerState: 'read',
556
+ getMyTipBalance: 'read',
552
557
  getMyShiftReport: 'read',
553
558
  getPartnerBilling: 'read',
554
559
  getPartnerBillingMonth: 'read',
@@ -126,7 +126,7 @@ export interface TipOptions {
126
126
  * Bar-Trinkgeld „gleich behalten“: die Mitarbeiterin steckt das Trinkgeld
127
127
  * beim Verkauf gleich ein. Der Beleg bleibt, wie er ist (signiert, im DEP);
128
128
  * nur im Kassenstand zaehlt der Betrag nicht ins Bar-Soll und gilt sofort als
129
- * „schon genommen“. Nur `true` geht hinaus. Der Server nimmt es nur bei
129
+ * „genommen“. Nur `true` geht hinaus. Der Server nimmt es nur bei
130
130
  * Mitarbeiter-Trinkgeld, bar und sofort erhalten; sonst faellt es still weg.
131
131
  * Vorbelegung des Schalters: [posTipKeptByDefault] der Kassen-Einstellungen.
132
132
  */
@@ -1,5 +1,5 @@
1
1
  export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
2
- export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isVoucherItem, isVoucherFloatItem, isDepositItem, isDepositReturnItem, type Voucher, type VoucherArticle, type IssuedVoucher, type ReturnIssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type VoucherSource, type LegacyValueVoucherWish, VOUCHER_SOURCES, isExternalVoucher, externalVoucherIsValid, normalizeExternalVoucherNumber, checkExternalVoucherNumber, ownVoucherCodeShape, OWN_VOUCHER_CODE_SHAPES, type OwnVoucherCodeShape, type ExternalVoucherNumberCheck, EXTERNAL_VOUCHER_NUMBER_MAX, EXTERNAL_VOUCHER_TAXED_WITH_MAX, EXTERNAL_VOUCHER_VAT_RATES_BP, type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError, type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, RECEIPT_OUTPUT_KINDS, type ReceiptOutputKind, RECEIPT_OUTPUT_LOG_KINDS, type ReceiptOutputLogKind, RECEIPT_OUTPUT_RESULTS, type ReceiptOutputResult, RECEIPT_OUTPUT_ENTRIES_MAX, type ReceiptOutput, type ReceiptOutputActor, RECEIPT_OUTPUT_ENTRY_ERROR_CODES, type ReceiptOutputEntryErrorCode, RECEIPT_OUTPUT_ERROR_CODES, type ReceiptOutputErrorCode, isReceiptOutputErrorCode, receiptOutputErrorCode, isReceiptOutputError, receiptOutputFieldErrors, type ReceiptOutputFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, type CashregisterAutoLogout, type CashregisterAutoLogoutPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
2
+ export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isVoucherItem, isVoucherFloatItem, isDepositItem, isDepositReturnItem, isInvoicePaymentItem, type Voucher, type VoucherArticle, type IssuedVoucher, type ReturnIssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type VoucherSource, type LegacyValueVoucherWish, VOUCHER_SOURCES, isExternalVoucher, externalVoucherIsValid, normalizeExternalVoucherNumber, checkExternalVoucherNumber, ownVoucherCodeShape, OWN_VOUCHER_CODE_SHAPES, type OwnVoucherCodeShape, type ExternalVoucherNumberCheck, EXTERNAL_VOUCHER_NUMBER_MAX, EXTERNAL_VOUCHER_TAXED_WITH_MAX, EXTERNAL_VOUCHER_VAT_RATES_BP, type Receipt, type RegistrationInfo, type InvoicePaymentRef, type InvoicePaymentTaxNote, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError, type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, RECEIPT_OUTPUT_KINDS, type ReceiptOutputKind, RECEIPT_OUTPUT_LOG_KINDS, type ReceiptOutputLogKind, RECEIPT_OUTPUT_RESULTS, type ReceiptOutputResult, RECEIPT_OUTPUT_ENTRIES_MAX, type ReceiptOutput, type ReceiptOutputActor, RECEIPT_OUTPUT_ENTRY_ERROR_CODES, type ReceiptOutputEntryErrorCode, RECEIPT_OUTPUT_ERROR_CODES, type ReceiptOutputErrorCode, isReceiptOutputErrorCode, receiptOutputErrorCode, isReceiptOutputError, receiptOutputFieldErrors, type ReceiptOutputFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, type CashregisterAutoLogout, type CashregisterAutoLogoutPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
3
3
  export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, type KasseneckPdfOrDataTransport, type PdfOrData, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, createPdfOrDataTransport, createFileOrDataTransport, type FileOrData, type FileOrDataCallOptions, type KasseneckFileOrDataTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, type ReceiptOutputEntry, type LogReceiptOutputsOptions, type LogReceiptOutputsResult, type RejectedReceiptOutput, logReceiptOutputs, downloadDailyReport, downloadMonthlyReport, getCashregisterReport, type CashregisterReportPeriod, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, listReceipts, listAllReceipts, fromListReceiptsSummaryPayload, listedReceiptWithCompany, LIST_RECEIPTS_VIEWS, LIST_RECEIPTS_ORDERS, LIST_RECEIPTS_LIMIT_MAX, LIST_RECEIPTS_DAYS_MAX, LIST_ALL_RECEIPTS_MAX_PAGES, LIST_RECEIPTS_ERROR_CODES, type ListReceiptsErrorCode, type ListReceiptsView, type ListReceiptsOrder, type ListReceiptsOptions, type ListReceiptsWindow, type ListReceiptsGrossByRate, type ListReceiptsSummary, type ListReceiptsDaySummary, type ListReceiptsPage, type ListedReceipt, createDepExport, getDepExport, waitForDepExport, getDepExportFile, createDepHandoverLink, revokeDepHandoverLink, DepExportTimeoutError, DepExportChecksumError, DEP_EXPORT_STATUSES, DEP_EXPORT_FILES, DEP_EXPORT_ERROR_CODES, DEP_EXPORT_FAILURES, DEP_EXPORT_POLL_START_MS, DEP_EXPORT_POLL_FACTOR, DEP_EXPORT_POLL_MAX_MS, DEP_EXPORT_WAIT_TIMEOUT_MS, DEP_EXPORT_DOWNLOAD_TIMEOUT_MS, type DepExportStatus, type DepExportFileKind, type DepExportErrorCode, type DepExportFailure, type CreateDepExportOptions, type CreateDepExportResult, type DepExportGap, type DepExportChainBreak, type DepExportFindings, type DepExportItems, type DepHandoverLinkInfo, type DepExport, type WaitForDepExportOptions, type GetDepExportFileOptions, type DepExportFile, type DepHandoverLink, type RevokedDepHandoverLink, registerTerminalDevice, getTerminalAccess, claimTerminal, requestTerminalCode, getTerminalCode, reportTerminalLogin, reportTerminalReady, TERMINAL_PLATFORMS, TERMINAL_SETUP_STATES, TERMINAL_CODE_STATUSES, TERMINAL_CODE_SOURCES, TERMINAL_ERROR_CODES, TERMINAL_LABEL_MAX, TERMINAL_APP_MAX, TERMINAL_REQUESTED_BY_MAX, type TerminalPlatform, type TerminalSetupState, type TerminalCodeStatus, type TerminalCodeSource, type TerminalErrorCode, type TerminalDeviceCredentials, type RegisterTerminalDeviceOptions, type RegisteredTerminalDevice, type GetTerminalAccessOptions, type ClaimTerminalOptions, type RequestTerminalCodeOptions, type ReportTerminalLoginOptions, type TerminalSetup, type TerminalCodeFormat, type TerminalAccess, type TerminalListEntry, type TerminalAccessUnavailable, type TerminalAccessResult, type TerminalCodeRequest, type TerminalCode, EWP_REASONS, EWP_WARNING_CODES, type EwpReason, type EwpWarningCode, type EwpMasterData, type EwpLineSources, type EwpLine, type EwpWarning, type EwpExtraQuantity, type EwpExtraQuantityInput, type EwpReport, type EwpReportFile, type ListedFullReceipt, type ListReceiptsHeader, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
4
4
  export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, type VoucherDueInfo, type VoucherDueArticle, type VoucherDueType, type VoucherRedeemContext, voucherRedeemMaxCents, VOUCHER_ZERO_RATE_BUCKET_FROM, } from './receipt/due.js';
5
5
  export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
package/dist/cjs/index.js CHANGED
@@ -1,10 +1,10 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.EXTERNAL_VOUCHER_VAT_RATES_BP = exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = exports.EXTERNAL_VOUCHER_NUMBER_MAX = exports.OWN_VOUCHER_CODE_SHAPES = exports.ownVoucherCodeShape = exports.checkExternalVoucherNumber = exports.normalizeExternalVoucherNumber = exports.externalVoucherIsValid = exports.isExternalVoucher = exports.VOUCHER_SOURCES = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isDepositReturnItem = exports.isDepositItem = exports.isVoucherFloatItem = exports.isVoucherItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
4
- exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = void 0;
5
- exports.LIST_RECEIPTS_VIEWS = exports.listedReceiptWithCompany = exports.fromListReceiptsSummaryPayload = exports.listAllReceipts = exports.listReceipts = exports.getReportV2 = exports.getCashregisterReport = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.logReceiptOutputs = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createFileOrDataTransport = exports.createPdfOrDataTransport = exports.createBinaryTransport = exports.createTransport = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
6
- exports.parseServerTimeStamp = exports.VOUCHER_ZERO_RATE_BUCKET_FROM = exports.voucherRedeemMaxCents = exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.EWP_WARNING_CODES = exports.EWP_REASONS = exports.TERMINAL_REQUESTED_BY_MAX = exports.TERMINAL_APP_MAX = exports.TERMINAL_LABEL_MAX = exports.TERMINAL_ERROR_CODES = exports.TERMINAL_CODE_SOURCES = exports.TERMINAL_CODE_STATUSES = exports.TERMINAL_SETUP_STATES = exports.TERMINAL_PLATFORMS = exports.reportTerminalReady = exports.reportTerminalLogin = exports.getTerminalCode = exports.requestTerminalCode = exports.claimTerminal = exports.getTerminalAccess = exports.registerTerminalDevice = exports.DEP_EXPORT_DOWNLOAD_TIMEOUT_MS = exports.DEP_EXPORT_WAIT_TIMEOUT_MS = exports.DEP_EXPORT_POLL_MAX_MS = exports.DEP_EXPORT_POLL_FACTOR = exports.DEP_EXPORT_POLL_START_MS = exports.DEP_EXPORT_FAILURES = exports.DEP_EXPORT_ERROR_CODES = exports.DEP_EXPORT_FILES = exports.DEP_EXPORT_STATUSES = exports.DepExportChecksumError = exports.DepExportTimeoutError = exports.revokeDepHandoverLink = exports.createDepHandoverLink = exports.getDepExportFile = exports.waitForDepExport = exports.getDepExport = exports.createDepExport = exports.LIST_RECEIPTS_ERROR_CODES = exports.LIST_ALL_RECEIPTS_MAX_PAGES = exports.LIST_RECEIPTS_DAYS_MAX = exports.LIST_RECEIPTS_LIMIT_MAX = exports.LIST_RECEIPTS_ORDERS = void 0;
7
- exports.depositReturnOf = exports.voucherPermsOf = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.mergePosSettings = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.toViennaWallClock = void 0;
3
+ exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.EXTERNAL_VOUCHER_VAT_RATES_BP = exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = exports.EXTERNAL_VOUCHER_NUMBER_MAX = exports.OWN_VOUCHER_CODE_SHAPES = exports.ownVoucherCodeShape = exports.checkExternalVoucherNumber = exports.normalizeExternalVoucherNumber = exports.externalVoucherIsValid = exports.isExternalVoucher = exports.VOUCHER_SOURCES = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isInvoicePaymentItem = exports.isDepositReturnItem = exports.isDepositItem = exports.isVoucherFloatItem = exports.isVoucherItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
4
+ exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = void 0;
5
+ exports.listedReceiptWithCompany = exports.fromListReceiptsSummaryPayload = exports.listAllReceipts = exports.listReceipts = exports.getReportV2 = exports.getCashregisterReport = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.logReceiptOutputs = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createFileOrDataTransport = exports.createPdfOrDataTransport = exports.createBinaryTransport = exports.createTransport = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = void 0;
6
+ exports.VOUCHER_ZERO_RATE_BUCKET_FROM = exports.voucherRedeemMaxCents = exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.EWP_WARNING_CODES = exports.EWP_REASONS = exports.TERMINAL_REQUESTED_BY_MAX = exports.TERMINAL_APP_MAX = exports.TERMINAL_LABEL_MAX = exports.TERMINAL_ERROR_CODES = exports.TERMINAL_CODE_SOURCES = exports.TERMINAL_CODE_STATUSES = exports.TERMINAL_SETUP_STATES = exports.TERMINAL_PLATFORMS = exports.reportTerminalReady = exports.reportTerminalLogin = exports.getTerminalCode = exports.requestTerminalCode = exports.claimTerminal = exports.getTerminalAccess = exports.registerTerminalDevice = exports.DEP_EXPORT_DOWNLOAD_TIMEOUT_MS = exports.DEP_EXPORT_WAIT_TIMEOUT_MS = exports.DEP_EXPORT_POLL_MAX_MS = exports.DEP_EXPORT_POLL_FACTOR = exports.DEP_EXPORT_POLL_START_MS = exports.DEP_EXPORT_FAILURES = exports.DEP_EXPORT_ERROR_CODES = exports.DEP_EXPORT_FILES = exports.DEP_EXPORT_STATUSES = exports.DepExportChecksumError = exports.DepExportTimeoutError = exports.revokeDepHandoverLink = exports.createDepHandoverLink = exports.getDepExportFile = exports.waitForDepExport = exports.getDepExport = exports.createDepExport = exports.LIST_RECEIPTS_ERROR_CODES = exports.LIST_ALL_RECEIPTS_MAX_PAGES = exports.LIST_RECEIPTS_DAYS_MAX = exports.LIST_RECEIPTS_LIMIT_MAX = exports.LIST_RECEIPTS_ORDERS = exports.LIST_RECEIPTS_VIEWS = void 0;
7
+ exports.depositReturnOf = exports.voucherPermsOf = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.mergePosSettings = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.toViennaWallClock = exports.parseServerTimeStamp = void 0;
8
8
  var index_js_1 = require("./enums/index.js");
9
9
  Object.defineProperty(exports, "ReceiptType", { enumerable: true, get: function () { return index_js_1.ReceiptType; } });
10
10
  Object.defineProperty(exports, "VatRate", { enumerable: true, get: function () { return index_js_1.VatRate; } });
@@ -24,6 +24,7 @@ Object.defineProperty(exports, "isVoucherItem", { enumerable: true, get: functio
24
24
  Object.defineProperty(exports, "isVoucherFloatItem", { enumerable: true, get: function () { return index_js_2.isVoucherFloatItem; } });
25
25
  Object.defineProperty(exports, "isDepositItem", { enumerable: true, get: function () { return index_js_2.isDepositItem; } });
26
26
  Object.defineProperty(exports, "isDepositReturnItem", { enumerable: true, get: function () { return index_js_2.isDepositReturnItem; } });
27
+ Object.defineProperty(exports, "isInvoicePaymentItem", { enumerable: true, get: function () { return index_js_2.isInvoicePaymentItem; } });
27
28
  Object.defineProperty(exports, "toVoucherPayload", { enumerable: true, get: function () { return index_js_2.toVoucherPayload; } });
28
29
  Object.defineProperty(exports, "fromVoucherPayload", { enumerable: true, get: function () { return index_js_2.fromVoucherPayload; } });
29
30
  Object.defineProperty(exports, "voucherIsValid", { enumerable: true, get: function () { return index_js_2.voucherIsValid; } });
@@ -18,6 +18,8 @@ import type { InvoiceLanguage } from './vertrag.js';
18
18
  declare const DE: {
19
19
  readonly 'pdf.title.invoice': "RECHNUNG";
20
20
  readonly 'pdf.title.credit_note': "GUTSCHRIFT";
21
+ readonly 'pdf.title.payment_confirmation': "ZAHLUNGSBESTÄTIGUNG";
22
+ readonly 'pdf.title.refund_confirmation': "RÜCKZAHLUNGSBESTÄTIGUNG";
21
23
  readonly 'pdf.badge.paid': "BEZAHLT";
22
24
  readonly 'pdf.badge.direct_debit': "SEPA-LASTSCHRIFT";
23
25
  readonly 'pdf.meta.number.invoice': "Rechnungsnr.";
@@ -78,9 +80,24 @@ declare const DE: {
78
80
  readonly 'pdf.payment.note_until': "Zahlbar ohne Abzug bis {date}. Vielen Dank für Ihren Auftrag.";
79
81
  readonly 'pdf.payment.note': "Zahlbar ohne Abzug. Vielen Dank für Ihren Auftrag.";
80
82
  readonly 'pdf.payment.qr': "Mit Banking-App scannen & zahlen";
81
- readonly 'pdf.paid.text': "Diese Rechnung ist beglichen. Es ist nichts weiter zu tun.";
83
+ readonly 'pdf.paid.text': "Diese Rechnung ist beglichen.";
82
84
  readonly 'pdf.paid.date': "Bezahlt am";
85
+ readonly 'pdf.paid.cash': "Bar bezahlt am {date}.";
86
+ readonly 'pdf.paid.card': "Mit Karte bezahlt am {date}.";
83
87
  readonly 'pdf.paid.payment_method': "Zahlungsart";
88
+ readonly 'pdf.cash_register.header': "REGISTRIERKASSE";
89
+ readonly 'pdf.cash_register.receipt_number': "Beleg-Nr.";
90
+ readonly 'pdf.cash_register.date': "Datum";
91
+ readonly 'pdf.cash_register.tax.incl_vat': "inkl. USt";
92
+ readonly 'pdf.cash_register.tax.zero_percent': "0 % USt";
93
+ readonly 'pdf.cash_register.tax.see_invoice': "Steuerangaben siehe Rechnung";
94
+ readonly 'pdf.confirmation.intro': "Wir bestätigen den Erhalt Ihrer Zahlung.";
95
+ readonly 'pdf.confirmation.not_invoice': "Diese Bestätigung ist keine Rechnung.";
96
+ readonly 'pdf.confirmation.table.invoice': "Rechnung";
97
+ readonly 'pdf.confirmation.table.amount': "Betrag";
98
+ readonly 'pdf.confirmation.table.paid_so_far': "Bisher bezahlt";
99
+ readonly 'pdf.confirmation.table.received_today': "Heute erhalten";
100
+ readonly 'pdf.confirmation.table.still_open': "Noch offen";
84
101
  readonly 'payment_method.cash': "Bar";
85
102
  readonly 'payment_method.transfer': "Überweisung";
86
103
  readonly 'payment_method.card': "Karte";
@@ -5,6 +5,9 @@ exports.invoiceText = invoiceText;
5
5
  const DE = {
6
6
  'pdf.title.invoice': 'RECHNUNG',
7
7
  'pdf.title.credit_note': 'GUTSCHRIFT',
8
+ // Zahlung auf Rechnung (1.38.0): eigene Bestaetigung, wenn spaeter bar oder mit Karte bezahlt wird.
9
+ 'pdf.title.payment_confirmation': 'ZAHLUNGSBESTÄTIGUNG',
10
+ 'pdf.title.refund_confirmation': 'RÜCKZAHLUNGSBESTÄTIGUNG',
8
11
  'pdf.badge.paid': 'BEZAHLT',
9
12
  'pdf.badge.direct_debit': 'SEPA-LASTSCHRIFT',
10
13
  'pdf.meta.number.invoice': 'Rechnungsnr.',
@@ -73,9 +76,30 @@ const DE = {
73
76
  'pdf.payment.note_until': 'Zahlbar ohne Abzug bis {date}. Vielen Dank für Ihren Auftrag.',
74
77
  'pdf.payment.note': 'Zahlbar ohne Abzug. Vielen Dank für Ihren Auftrag.',
75
78
  'pdf.payment.qr': 'Mit Banking-App scannen & zahlen',
76
- 'pdf.paid.text': 'Diese Rechnung ist beglichen. Es ist nichts weiter zu tun.',
79
+ // Kurz, fuer jede bezahlte Rechnung (auch Ueberweisung); der Satz „Es ist nichts weiter zu tun.“ entfiel mit 1.38.0.
80
+ 'pdf.paid.text': 'Diese Rechnung ist beglichen.',
77
81
  'pdf.paid.date': 'Bezahlt am',
82
+ // Kurztexte (1.38.0) fuer die Zahlung vor Ort; {date} = Zahltag.
83
+ 'pdf.paid.cash': 'Bar bezahlt am {date}.',
84
+ 'pdf.paid.card': 'Mit Karte bezahlt am {date}.',
78
85
  'pdf.paid.payment_method': 'Zahlungsart',
86
+ // Kassenteil (1.38.0): der Zahlungsbeleg der Kasse unten auf Rechnung und Zahlungsbestaetigung. Kopfzeile
87
+ // mit der Kassen-ID dahinter; Vermerke und Positionstexte bleiben deutsch (Pflichtwoerter, receiptNotes).
88
+ 'pdf.cash_register.header': 'REGISTRIERKASSE',
89
+ 'pdf.cash_register.receipt_number': 'Beleg-Nr.',
90
+ 'pdf.cash_register.date': 'Datum',
91
+ // Steuerhinweis unter der Zahlung (Spec 2026-11-11, Abschnitt 16): Umsatzsteuer ausgewiesen, steuerfrei/nicht steuerbar, Reverse Charge.
92
+ 'pdf.cash_register.tax.incl_vat': 'inkl. USt',
93
+ 'pdf.cash_register.tax.zero_percent': '0 % USt',
94
+ 'pdf.cash_register.tax.see_invoice': 'Steuerangaben siehe Rechnung',
95
+ // Zahlungsbestaetigung (1.38.0): Einleitung, Hinweis und die Spalten der Tabelle je Rechnung.
96
+ 'pdf.confirmation.intro': 'Wir bestätigen den Erhalt Ihrer Zahlung.',
97
+ 'pdf.confirmation.not_invoice': 'Diese Bestätigung ist keine Rechnung.',
98
+ 'pdf.confirmation.table.invoice': 'Rechnung',
99
+ 'pdf.confirmation.table.amount': 'Betrag',
100
+ 'pdf.confirmation.table.paid_so_far': 'Bisher bezahlt',
101
+ 'pdf.confirmation.table.received_today': 'Heute erhalten',
102
+ 'pdf.confirmation.table.still_open': 'Noch offen',
79
103
  'payment_method.cash': 'Bar',
80
104
  'payment_method.transfer': 'Überweisung',
81
105
  'payment_method.card': 'Karte',
@@ -220,6 +244,8 @@ const DE = {
220
244
  const EN = {
221
245
  'pdf.title.invoice': 'INVOICE',
222
246
  'pdf.title.credit_note': 'CREDIT NOTE',
247
+ 'pdf.title.payment_confirmation': 'PAYMENT CONFIRMATION',
248
+ 'pdf.title.refund_confirmation': 'REFUND CONFIRMATION',
223
249
  'pdf.badge.paid': 'PAID',
224
250
  'pdf.badge.direct_debit': 'SEPA DIRECT DEBIT',
225
251
  'pdf.meta.number.invoice': 'Invoice no.',
@@ -280,9 +306,24 @@ const EN = {
280
306
  'pdf.payment.note_until': 'Payable without deduction by {date}. Thank you for your business.',
281
307
  'pdf.payment.note': 'Payable without deduction. Thank you for your business.',
282
308
  'pdf.payment.qr': 'Scan with your banking app to pay',
283
- 'pdf.paid.text': 'This invoice has been paid. No further action is required.',
309
+ 'pdf.paid.text': 'This invoice has been paid.',
284
310
  'pdf.paid.date': 'Paid on',
311
+ 'pdf.paid.cash': 'Paid in cash on {date}.',
312
+ 'pdf.paid.card': 'Paid by card on {date}.',
285
313
  'pdf.paid.payment_method': 'Payment method',
314
+ 'pdf.cash_register.header': 'CASH REGISTER',
315
+ 'pdf.cash_register.receipt_number': 'Receipt no.',
316
+ 'pdf.cash_register.date': 'Date',
317
+ 'pdf.cash_register.tax.incl_vat': 'incl. VAT',
318
+ 'pdf.cash_register.tax.zero_percent': '0 % VAT',
319
+ 'pdf.cash_register.tax.see_invoice': 'Tax details see invoice',
320
+ 'pdf.confirmation.intro': 'We confirm receipt of your payment.',
321
+ 'pdf.confirmation.not_invoice': 'This confirmation is not an invoice.',
322
+ 'pdf.confirmation.table.invoice': 'Invoice',
323
+ 'pdf.confirmation.table.amount': 'Amount',
324
+ 'pdf.confirmation.table.paid_so_far': 'Paid so far',
325
+ 'pdf.confirmation.table.received_today': 'Received today',
326
+ 'pdf.confirmation.table.still_open': 'Still open',
286
327
  'payment_method.cash': 'Cash',
287
328
  'payment_method.transfer': 'Bank transfer',
288
329
  'payment_method.card': 'Card',
@@ -27,7 +27,7 @@ export type InvoiceEndpoint = (typeof INVOICE_ENDPOINTS)[number];
27
27
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
28
28
  * aendern. `validation` traegt zusaetzlich `errors: [{ field, message }]`.
29
29
  */
30
- export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete", "language_not_allowed", "brand_not_found", "not_payable", "payment_exceeds_invoice", "tax_scheme_mismatch", "vat_rate_not_in_country", "reverse_charge_reason_required", "reverse_charge_threshold", "mixed_supply_not_allowed", "oss_not_enabled", "einvoice_unavailable", "amount_too_large", "vat_id_invalid", "vat_id_check_pending", "reservation_not_found", "reservation_mismatch", "reservation_not_active", "invoice_number_taken", "deposit_not_enabled", "deposit_type_not_found", "deposit_set_by_server", "invalid_deposit_quantity", "invalid_deposit"];
30
+ export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete", "language_not_allowed", "brand_not_found", "not_payable", "payment_exceeds_invoice", "tax_scheme_mismatch", "vat_rate_not_in_country", "reverse_charge_reason_required", "reverse_charge_threshold", "mixed_supply_not_allowed", "oss_not_enabled", "einvoice_unavailable", "amount_too_large", "vat_id_invalid", "vat_id_check_pending", "reservation_not_found", "reservation_mismatch", "reservation_not_active", "invoice_number_taken", "deposit_not_enabled", "deposit_type_not_found", "deposit_set_by_server", "invalid_deposit_quantity", "invalid_deposit", "cash_receipt_pending"];
31
31
  export type InvoiceErrorCode = (typeof INVOICE_ERROR_CODES)[number];
32
32
  /**
33
33
  * Codes, die Anmeldung und Rand auf jedem Rechnungsaufruf erzeugen koennen,
@@ -88,6 +88,7 @@ exports.INVOICE_ERROR_CODES = [
88
88
  'deposit_set_by_server', // das Pfand zu einer Artikelposition leitet der Server selbst ab
89
89
  'invalid_deposit_quantity', // die Pfandmenge passt nicht zur Menge der Position
90
90
  'invalid_deposit', // sonstige Pfandangabe unzulaessig, `index` nennt die Position
91
+ 'cash_receipt_pending', // Rechnung bar bezahlt, der Kassenbeleg der Zahlung ist noch nicht fertig: PDF spaeter abrufen
91
92
  ];
92
93
  /**
93
94
  * Codes, die Anmeldung und Rand auf jedem Rechnungsaufruf erzeugen koennen,
@@ -54,7 +54,7 @@ export declare function isReturnDisposition(value: unknown): value is ReturnDisp
54
54
  * [PAYMENT_ERROR_CODES]. Ein Code ausserhalb bleibt ueber
55
55
  * `KasseneckApiError.code` lesbar.
56
56
  */
57
- export declare const CANCELLATION_ERROR_CODES: readonly ["receipt_not_found", "receipt_type_not_cancellable", "training_receipt", "already_cancelled", "invalid_line", "quantity_exceeds_remaining", "unknown_reason", "note_too_long", "invalid_items", "cashregister_not_assigned", "not_permitted", "own_receipts_only", "cashregister_incomplete", "cancellation_failed", "cancellation_payments_required", "cancellation_refund_exceeds_payment", "cancellation_refund_reference_required", "cancellation_refund_reference_unknown", "cancellation_outcome_unknown", "invalid_return_disposition", "tip_refund_conflict", "invalid_tip_refund_source", "tip_refund_source_requires_cash", "tip_keep_not_possible_with_voucher", "refund_as_invalid", "refund_as_conflict", "refund_as_voucher_not_available", "refund_as_voucher_reason", "refund_as_voucher_with_voucher", "refund_as_voucher_no_type", "refund_as_voucher_amount", "idempotency_key_required", "account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing", "response_unreadable"];
57
+ export declare const CANCELLATION_ERROR_CODES: readonly ["receipt_not_found", "receipt_type_not_cancellable", "training_receipt", "already_cancelled", "invalid_line", "quantity_exceeds_remaining", "unknown_reason", "note_too_long", "invalid_items", "cashregister_not_assigned", "not_permitted", "own_receipts_only", "cashregister_incomplete", "cancellation_failed", "cancellation_payments_required", "cancellation_refund_exceeds_payment", "cancellation_refund_reference_required", "cancellation_refund_reference_unknown", "cancellation_outcome_unknown", "invalid_return_disposition", "tip_refund_conflict", "invalid_tip_refund_source", "tip_refund_source_requires_cash", "tip_keep_not_possible_with_voucher", "refund_as_invalid", "refund_as_conflict", "refund_as_voucher_not_available", "refund_as_voucher_reason", "refund_as_voucher_with_voucher", "refund_as_voucher_no_type", "refund_as_voucher_amount", "idempotency_key_required", "invoice_payment_not_cancellable", "account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing", "response_unreadable"];
58
58
  export type CancellationErrorCode = (typeof CANCELLATION_ERROR_CODES)[number];
59
59
  export declare function isCancellationErrorCode(value: unknown): value is CancellationErrorCode;
60
60
  /** Der Code eines geworfenen Fehlers, wenn er in [CANCELLATION_ERROR_CODES] steht; sonst `undefined`. */
@@ -106,6 +106,8 @@ exports.CANCELLATION_ERROR_CODES = Object.freeze([
106
106
  'refund_as_voucher_no_type', // keine passende Rueckgabe-Sorte eingestellt
107
107
  'refund_as_voucher_amount', // Betrag ohne Trinkgeld ausserhalb 1,00 bis 10.000,00 Euro
108
108
  'idempotency_key_required', // refundAs ohne idempotencyKey
109
+ // Zahlung auf Rechnung (Server 2026-11): ein Zahlungsbeleg wird nur im Kundenbereich bei der Rechnung storniert
110
+ 'invoice_payment_not_cancellable', // Original ist ein Zahlungsbeleg (Positionen invoice_payment)
109
111
  // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
110
112
  'account_not_found',
111
113
  'action_confirmation_required',
@@ -1,4 +1,4 @@
1
- export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, isVoucherItem, isVoucherFloatItem, isDepositItem, isDepositReturnItem, } from './receipt-item.js';
1
+ export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, isVoucherItem, isVoucherFloatItem, isDepositItem, isDepositReturnItem, isInvoicePaymentItem, } from './receipt-item.js';
2
2
  export { type Voucher, type VoucherArticle, type IssuedVoucher, type ReturnIssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields, type VoucherSource, type LegacyValueVoucherWish, VOUCHER_SOURCES, isExternalVoucher, externalVoucherIsValid, normalizeExternalVoucherNumber, checkExternalVoucherNumber, type ExternalVoucherNumberCheck, ownVoucherCodeShape, OWN_VOUCHER_CODE_SHAPES, type OwnVoucherCodeShape, EXTERNAL_VOUCHER_NUMBER_MAX, EXTERNAL_VOUCHER_TAXED_WITH_MAX, EXTERNAL_VOUCHER_VAT_RATES_BP, } from './voucher.js';
3
3
  export { type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, } from './receipt.js';
4
4
  export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, } from './cancellation.js';
@@ -11,6 +11,7 @@ export { type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayl
11
11
  export { type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, type CashregisterAutoLogout, type CashregisterAutoLogoutPayload, fromCashregisterPayload, } from './cashregister.js';
12
12
  export { type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind } from './receipt-summary.js';
13
13
  export { type ManualReceipt, type ManualReceiptReason, MANUAL_RECEIPT_REASONS, readManualReceipt, type ManualReceiptErrorCode, MANUAL_RECEIPT_ERROR_CODES, isManualReceiptErrorCode, } from './manual-receipt.js';
14
+ export { type InvoicePaymentRef, type InvoicePaymentTaxNote, readInvoicePaymentRefs } from './invoice-payment-ref.js';
14
15
  export { type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, } from './report-month.js';
15
16
  export { type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, } from './stripe-url-session.js';
16
17
  export { type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './hobex-receipt.js';
@@ -1,8 +1,8 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.EXTERNAL_VOUCHER_VAT_RATES_BP = exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = exports.EXTERNAL_VOUCHER_NUMBER_MAX = exports.OWN_VOUCHER_CODE_SHAPES = exports.ownVoucherCodeShape = exports.checkExternalVoucherNumber = exports.normalizeExternalVoucherNumber = exports.externalVoucherIsValid = exports.isExternalVoucher = exports.VOUCHER_SOURCES = exports.voucherServerFields = exports.isNewFormVoucher = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isDepositReturnItem = exports.isDepositItem = exports.isVoucherFloatItem = exports.isVoucherItem = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
4
- exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isManualReceiptErrorCode = exports.MANUAL_RECEIPT_ERROR_CODES = exports.readManualReceipt = exports.MANUAL_RECEIPT_REASONS = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.asksRefundTip = void 0;
5
- exports.hobexReceiptNeedsSignature = void 0;
3
+ exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.EXTERNAL_VOUCHER_VAT_RATES_BP = exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = exports.EXTERNAL_VOUCHER_NUMBER_MAX = exports.OWN_VOUCHER_CODE_SHAPES = exports.ownVoucherCodeShape = exports.checkExternalVoucherNumber = exports.normalizeExternalVoucherNumber = exports.externalVoucherIsValid = exports.isExternalVoucher = exports.VOUCHER_SOURCES = exports.voucherServerFields = exports.isNewFormVoucher = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isInvoicePaymentItem = exports.isDepositReturnItem = exports.isDepositItem = exports.isVoucherFloatItem = exports.isVoucherItem = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
4
+ exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.readInvoicePaymentRefs = exports.isManualReceiptErrorCode = exports.MANUAL_RECEIPT_ERROR_CODES = exports.readManualReceipt = exports.MANUAL_RECEIPT_REASONS = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.asksRefundTip = exports.asksTipRefundSource = void 0;
5
+ exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = void 0;
6
6
  var receipt_item_js_1 = require("./receipt-item.js");
7
7
  Object.defineProperty(exports, "toReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.toReceiptItemPayload; } });
8
8
  Object.defineProperty(exports, "fromReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.fromReceiptItemPayload; } });
@@ -15,6 +15,7 @@ Object.defineProperty(exports, "isVoucherItem", { enumerable: true, get: functio
15
15
  Object.defineProperty(exports, "isVoucherFloatItem", { enumerable: true, get: function () { return receipt_item_js_1.isVoucherFloatItem; } });
16
16
  Object.defineProperty(exports, "isDepositItem", { enumerable: true, get: function () { return receipt_item_js_1.isDepositItem; } });
17
17
  Object.defineProperty(exports, "isDepositReturnItem", { enumerable: true, get: function () { return receipt_item_js_1.isDepositReturnItem; } });
18
+ Object.defineProperty(exports, "isInvoicePaymentItem", { enumerable: true, get: function () { return receipt_item_js_1.isInvoicePaymentItem; } });
18
19
  var voucher_js_1 = require("./voucher.js");
19
20
  Object.defineProperty(exports, "toVoucherPayload", { enumerable: true, get: function () { return voucher_js_1.toVoucherPayload; } });
20
21
  Object.defineProperty(exports, "fromVoucherPayload", { enumerable: true, get: function () { return voucher_js_1.fromVoucherPayload; } });
@@ -106,6 +107,8 @@ Object.defineProperty(exports, "MANUAL_RECEIPT_REASONS", { enumerable: true, get
106
107
  Object.defineProperty(exports, "readManualReceipt", { enumerable: true, get: function () { return manual_receipt_js_1.readManualReceipt; } });
107
108
  Object.defineProperty(exports, "MANUAL_RECEIPT_ERROR_CODES", { enumerable: true, get: function () { return manual_receipt_js_1.MANUAL_RECEIPT_ERROR_CODES; } });
108
109
  Object.defineProperty(exports, "isManualReceiptErrorCode", { enumerable: true, get: function () { return manual_receipt_js_1.isManualReceiptErrorCode; } });
110
+ var invoice_payment_ref_js_1 = require("./invoice-payment-ref.js");
111
+ Object.defineProperty(exports, "readInvoicePaymentRefs", { enumerable: true, get: function () { return invoice_payment_ref_js_1.readInvoicePaymentRefs; } });
109
112
  var report_month_js_1 = require("./report-month.js");
110
113
  Object.defineProperty(exports, "reportMonthFromDate", { enumerable: true, get: function () { return report_month_js_1.reportMonthFromDate; } });
111
114
  Object.defineProperty(exports, "previousReportMonth", { enumerable: true, get: function () { return report_month_js_1.previousReportMonth; } });
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Zahlung auf Rechnung (`invoicePayments` am Beleg, Backend `rechnungszahlung`):
3
+ * Ein Zahlungsbeleg nimmt in der Kasse Geld fuer eine oder mehrere Rechnungen
4
+ * entgegen (bar oder mit Karte vor Ort) bzw. gibt es zu einer Gutschrift
5
+ * zurueck. Seine Positionen tragen `kind: 'invoice_payment'` und zaehlen im
6
+ * RKSV-Feld „Null“; die Umsatzsteuer steht auf der Rechnung, nicht am Beleg.
7
+ *
8
+ * Je Rechnung ein Bezug, in der Reihenfolge der Positionen (eine Zeile je
9
+ * Rechnung). Der Bezug ist nicht signiert (wie `cancellationOf`), die
10
+ * Rechnungsnummer steht zusaetzlich im Text der Position.
11
+ *
12
+ * Nur der Server legt solche Belege an; dieses Paket liest sie nur.
13
+ */
14
+ export interface InvoicePaymentRef {
15
+ invoiceId: string;
16
+ /** Nummer der Rechnung bzw. Gutschrift aus ihrem Rechnungskreis (`2026-0042`). */
17
+ invoiceNumber: string;
18
+ /** Kennung des Zahlungseintrags an der Rechnung. */
19
+ paymentId: string;
20
+ customerId: string | null;
21
+ /** Betrag dieser Zeile in Cent; bei einer Rueckzahlung zu einer Gutschrift negativ. */
22
+ amountCents: number;
23
+ /** Teilzahlung: weniger als der Rechnungsbetrag. */
24
+ partial: boolean;
25
+ /** Zahlungstag `YYYY-MM-DD` (Wiener Tag), `null` wenn unbekannt. */
26
+ paidOn: string | null;
27
+ /**
28
+ * Steuerhinweis unter der Position: `incl_vat` (die Rechnung weist Umsatzsteuer aus), `zero_percent`
29
+ * (steuerfrei oder nicht steuerbar) oder `see_invoice` (Reverse Charge). Fehlt er, steht kein Hinweis.
30
+ */
31
+ taxNote?: InvoicePaymentTaxNote;
32
+ }
33
+ /** Werte von [InvoicePaymentRef.taxNote] (gespeichert `inkl_ust` | `null_prozent` | `siehe_rechnung`). */
34
+ export type InvoicePaymentTaxNote = 'incl_vat' | 'zero_percent' | 'see_invoice';
35
+ /**
36
+ * Liest `invoicePayments` vom Draht. Ein Eintrag ohne Rechnungs-ID, Nummer,
37
+ * Zahlungs-ID oder ganzzahligen Betrag faellt weg (lesen tolerant, der Beleg
38
+ * bleibt anzeigbar); ohne brauchbaren Eintrag gibt es keinen Bezug
39
+ * (`undefined`). Ein unbekannter oder fehlender `taxNote` ergibt keinen
40
+ * Hinweis: ein Beleg behauptet nie eine Steuer, die er nicht kennt.
41
+ */
42
+ export declare function readInvoicePaymentRefs(roh: unknown): InvoicePaymentRef[] | undefined;
@@ -0,0 +1,38 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.readInvoicePaymentRefs = readInvoicePaymentRefs;
4
+ const STEUERHINWEISE = ['incl_vat', 'zero_percent', 'see_invoice'];
5
+ const istText = (w) => typeof w === 'string' && w !== '';
6
+ /**
7
+ * Liest `invoicePayments` vom Draht. Ein Eintrag ohne Rechnungs-ID, Nummer,
8
+ * Zahlungs-ID oder ganzzahligen Betrag faellt weg (lesen tolerant, der Beleg
9
+ * bleibt anzeigbar); ohne brauchbaren Eintrag gibt es keinen Bezug
10
+ * (`undefined`). Ein unbekannter oder fehlender `taxNote` ergibt keinen
11
+ * Hinweis: ein Beleg behauptet nie eine Steuer, die er nicht kennt.
12
+ */
13
+ function readInvoicePaymentRefs(roh) {
14
+ if (!Array.isArray(roh))
15
+ return undefined;
16
+ const raus = [];
17
+ for (const e of roh) {
18
+ if (e === null || typeof e !== 'object' || Array.isArray(e))
19
+ continue;
20
+ const o = e;
21
+ if (!istText(o['invoiceId']) || !istText(o['invoiceNumber']) || !istText(o['paymentId']))
22
+ continue;
23
+ if (!Number.isSafeInteger(o['amountCents']))
24
+ continue;
25
+ const hinweis = o['taxNote'];
26
+ raus.push({
27
+ invoiceId: o['invoiceId'],
28
+ invoiceNumber: o['invoiceNumber'],
29
+ paymentId: o['paymentId'],
30
+ customerId: istText(o['customerId']) ? o['customerId'] : null,
31
+ amountCents: o['amountCents'],
32
+ partial: o['partial'] === true,
33
+ paidOn: istText(o['paidOn']) ? o['paidOn'] : null,
34
+ ...(typeof hinweis === 'string' && STEUERHINWEISE.includes(hinweis) ? { taxNote: hinweis } : {}),
35
+ });
36
+ }
37
+ return raus.length > 0 ? raus : undefined;
38
+ }