@kreiseck/kasseneck-api 1.32.1 → 1.34.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 (66) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/dist/cjs/client/api.d.ts +3 -0
  3. package/dist/cjs/client/api.js +2 -0
  4. package/dist/cjs/client/aufrufe.d.ts +2 -2
  5. package/dist/cjs/client/aufrufe.js +11 -0
  6. package/dist/cjs/client/list-deposit-types.d.ts +10 -0
  7. package/dist/cjs/client/list-deposit-types.js +28 -0
  8. package/dist/cjs/client/terminal.d.ts +1 -1
  9. package/dist/cjs/client/terminal.js +2 -0
  10. package/dist/cjs/models/hobex-receipt.d.ts +20 -5
  11. package/dist/cjs/models/hobex-receipt.js +17 -6
  12. package/dist/cjs/payments/hobex-hps/connect-client.js +5 -3
  13. package/dist/cjs/payments/hobex-hps/errors.d.ts +32 -5
  14. package/dist/cjs/payments/hobex-hps/errors.js +35 -6
  15. package/dist/cjs/payments/hobex-hps/index.d.ts +1 -1
  16. package/dist/cjs/payments/hobex-hps/index.js +3 -2
  17. package/dist/cjs/payments/index.d.ts +1 -1
  18. package/dist/cjs/payments/index.js +3 -1
  19. package/dist/cjs/pos/texte.d.ts +14 -0
  20. package/dist/cjs/pos/texte.js +7 -0
  21. package/dist/cjs/stored/vokabular.d.ts +1 -1
  22. package/dist/cjs/stored/vokabular.js +1 -1
  23. package/dist/cjs/version.d.ts +1 -1
  24. package/dist/cjs/version.js +1 -1
  25. package/dist/esm/client/api.d.ts +3 -0
  26. package/dist/esm/client/api.js +2 -0
  27. package/dist/esm/client/aufrufe.d.ts +2 -2
  28. package/dist/esm/client/aufrufe.js +11 -0
  29. package/dist/esm/client/list-deposit-types.d.ts +10 -0
  30. package/dist/esm/client/list-deposit-types.js +25 -0
  31. package/dist/esm/client/terminal.d.ts +1 -1
  32. package/dist/esm/client/terminal.js +2 -0
  33. package/dist/esm/models/hobex-receipt.d.ts +20 -5
  34. package/dist/esm/models/hobex-receipt.js +17 -6
  35. package/dist/esm/payments/hobex-hps/connect-client.js +6 -4
  36. package/dist/esm/payments/hobex-hps/errors.d.ts +32 -5
  37. package/dist/esm/payments/hobex-hps/errors.js +34 -5
  38. package/dist/esm/payments/hobex-hps/index.d.ts +1 -1
  39. package/dist/esm/payments/hobex-hps/index.js +1 -1
  40. package/dist/esm/payments/index.d.ts +1 -1
  41. package/dist/esm/payments/index.js +1 -1
  42. package/dist/esm/pos/texte.d.ts +14 -0
  43. package/dist/esm/pos/texte.js +7 -0
  44. package/dist/esm/stored/vokabular.d.ts +1 -1
  45. package/dist/esm/stored/vokabular.js +1 -1
  46. package/dist/esm/version.d.ts +1 -1
  47. package/dist/esm/version.js +1 -1
  48. package/fixtures/hobex-hps-codes.json +1 -1
  49. package/fixtures/invoice-api.schema.json +1 -1
  50. package/fixtures/invoice-texts.json +1 -1
  51. package/fixtures/pos-texts.json +26 -1
  52. package/fixtures/surface.json +7 -3
  53. package/fixtures/v3/antworten/belege.json +1 -1
  54. package/fixtures/v3/antworten/belegmail.json +1 -1
  55. package/fixtures/v3/antworten/berichte.json +1 -1
  56. package/fixtures/v3/antworten/kasse-belege.json +1 -1
  57. package/fixtures/v3/antworten/kasse.json +2 -2
  58. package/fixtures/v3/antworten/lager.json +1 -1
  59. package/fixtures/v3/antworten/rechnungen.json +1 -1
  60. package/fixtures/v3/antworten/storno.json +1 -1
  61. package/fixtures/v3/stored/belege.json +1 -1
  62. package/fixtures/v3/stored/kasse.json +2 -2
  63. package/fixtures/v3/stored/rechnungen.json +1 -1
  64. package/fixtures/v3/v3-vokabular.json +51 -4
  65. package/fixtures/v3/zahlbetrag-faelle.json +1 -1
  66. package/package.json +1 -1
@@ -4,4 +4,4 @@
4
4
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
5
5
  * beim Anheben der Version beide Stellen aendern.
6
6
  */
7
- export declare const PACKAGE_VERSION = "1.32.1";
7
+ export declare const PACKAGE_VERSION = "1.34.0";
@@ -7,4 +7,4 @@ exports.PACKAGE_VERSION = void 0;
7
7
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
8
8
  * beim Anheben der Version beide Stellen aendern.
9
9
  */
10
- exports.PACKAGE_VERSION = '1.32.1';
10
+ exports.PACKAGE_VERSION = '1.34.0';
@@ -6,6 +6,7 @@ import { type CashregisterReportPeriod, type ReportV2, type ReportV2Options } fr
6
6
  import { type CashboxStatus, type SignatureStatus } from './status.js';
7
7
  import { type CreateDepExportOptions, type CreateDepExportResult, type DepExport, type DepExportFile, type DepHandoverLink, type GetDepExportFileOptions, type RevokedDepHandoverLink, type WaitForDepExportOptions } from './dep-export.js';
8
8
  import { type ClaimTerminalOptions, type GetTerminalAccessOptions, type RegisteredTerminalDevice, type RegisterTerminalDeviceOptions, type ReportTerminalLoginOptions, type RequestTerminalCodeOptions, type TerminalAccess, type TerminalAccessResult, type TerminalCode, type TerminalCodeRequest, type TerminalDeviceCredentials } from './terminal.js';
9
+ import type { DepositSettings } from '../pos/pfand.js';
9
10
  import { type ListedReceipt, type ListReceiptsOptions, type ListReceiptsPage, type ListReceiptsView } from './list-receipts.js';
10
11
  import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type LogReceiptOutputsOptions, type LogReceiptOutputsResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult } from './receipts.js';
11
12
  /**
@@ -63,6 +64,8 @@ export interface KasseneckApi {
63
64
  listReceipts<V extends ListReceiptsView = 'summary'>(options: ListReceiptsOptions<V>): Promise<ListReceiptsPage<V>>;
64
65
  /** Alle Belege eines Tages oder Zeitraums, Seite fuer Seite geholt (hoechstens 100 Seiten). */
65
66
  listAllReceipts<V extends ListReceiptsView = 'summary'>(options: ListReceiptsOptions<V>): AsyncGenerator<ListedReceipt<V>, void, undefined>;
67
+ /** Pfandarten des Betriebs (`listDepositTypes`, nur /v3, ohne Kassen-Token); `null` = Pfand aus, dann keine Pfandzeilen senden. */
68
+ listDepositTypes(): Promise<DepositSettings | null>;
66
69
  /** DEP-Export fuer die Kassennachschau einstellen (`createDepExport`, nur /v3); antwortet sofort, der Export laeuft im Hintergrund. */
67
70
  createDepExport(options?: CreateDepExportOptions): Promise<CreateDepExportResult>;
68
71
  /** Zustand, Kennzahlen, Befund und Pruefer-Links eines Exports (`getDepExport`). */
@@ -5,6 +5,7 @@ import { downloadDailyReport, downloadMonthlyReport, getCashregisterReport, getR
5
5
  import { getCashboxStatus, getSignatureStatus } from './status.js';
6
6
  import { createDepExport, createDepHandoverLink, getDepExport, getDepExportFile, revokeDepHandoverLink, waitForDepExport, } from './dep-export.js';
7
7
  import { claimTerminal, getTerminalAccess, getTerminalCode, registerTerminalDevice, reportTerminalLogin, reportTerminalReady, requestTerminalCode, } from './terminal.js';
8
+ import { listDepositTypes } from './list-deposit-types.js';
8
9
  import { listAllReceipts, listReceipts } from './list-receipts.js';
9
10
  import { sellReceipt, sellReceiptWithCompany, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, sendReceiptEmail, logReceiptOutputs, } from './receipts.js';
10
11
  import { listMyCashregisters } from './cashregisters.js';
@@ -41,6 +42,7 @@ export function createKasseneckApi(options) {
41
42
  getReportV2: (o) => getReportV2(rufen, o),
42
43
  listReceipts: (o) => listReceipts(rufen, o),
43
44
  listAllReceipts: (o) => listAllReceipts(rufen, o),
45
+ listDepositTypes: () => listDepositTypes(rufen),
44
46
  createDepExport: (o) => createDepExport(rufen, o),
45
47
  getDepExport: (o) => getDepExport(rufen, o),
46
48
  waitForDepExport: (o) => waitForDepExport(rufen, o),
@@ -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"];
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"];
17
17
  export type ApiCall = typeof ALL_CALLS[number];
18
18
  /**
19
19
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -21,7 +21,7 @@ export type ApiCall = typeof ALL_CALLS[number];
21
21
  * (`fixtures/v3/v3-vokabular.json`, `endpoints.public`, umbenannt nach
22
22
  * `names`). Ein Test haelt beide Listen deckungsgleich.
23
23
  */
24
- export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "getCashregisterReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "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", "listReceipts", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady"];
24
+ export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "getCashregisterReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "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", "listReceipts", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady", "unfixTerminal", "listDepositTypes"];
25
25
  /**
26
26
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
27
27
  * Web-Kasse: gleicher Ursprung `/api/v3`), in der Reihenfolge von
@@ -162,6 +162,10 @@ export const ALL_CALLS = [
162
162
  'getTerminalCode',
163
163
  'reportTerminalLogin',
164
164
  'reportTerminalReady',
165
+ // Feste TID je Geraet loesen (nur dem Namen nach bekannt, keine eigene Methode).
166
+ 'unfixTerminal',
167
+ // Pfandarten des Betriebs lesen, nur unter /v3.
168
+ 'listDepositTypes',
165
169
  ];
166
170
  /**
167
171
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -300,6 +304,10 @@ export const PUBLIC_CALLS = [
300
304
  'getTerminalCode',
301
305
  'reportTerminalLogin',
302
306
  'reportTerminalReady',
307
+ // Feste TID je Geraet loesen (nur dem Namen nach bekannt, keine eigene Methode).
308
+ 'unfixTerminal',
309
+ // Pfandarten des Betriebs lesen, nur unter /v3.
310
+ 'listDepositTypes',
303
311
  ];
304
312
  /**
305
313
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
@@ -563,6 +571,7 @@ export const CALLS_WITHOUT_EFFECT = Object.freeze({
563
571
  listPartnerCustomers: 'read',
564
572
  listPartnerWebhookDeliveries: 'read',
565
573
  listPartnerWebhooks: 'read',
574
+ listDepositTypes: 'read',
566
575
  listReceipts: 'read',
567
576
  listRegisterSessionsForDevice: 'read',
568
577
  listRegisterUsersForDevice: 'read',
@@ -582,6 +591,8 @@ export const CALLS_WITHOUT_EFFECT = Object.freeze({
582
591
  // Kartenterminal: Anmeldung und Einrichtung melden schreiben denselben Stand noch einmal.
583
592
  reportTerminalLogin: 'repeatable',
584
593
  reportTerminalReady: 'repeatable',
594
+ // Kartenterminal: die feste Bindung noch einmal loesen aendert nichts am Server.
595
+ unfixTerminal: 'repeatable',
585
596
  reprintVoucherLabel: 'repeatable',
586
597
  // Eine offene Code-Anfrage juenger als 6 Minuten bleibt; eine Wiederholung legt keine neue an.
587
598
  requestTerminalCode: 'repeatable',
@@ -0,0 +1,10 @@
1
+ import { type DepositSettings } from '../pos/pfand.js';
2
+ import type { InternerTransport } from './aufrufe.js';
3
+ /**
4
+ * Pfandarten des Betriebs lesen (`listDepositTypes`, nur unter `/v3`, API-Schluessel).
5
+ * Die Antwort ist der Block `deposit` aus `getKasseSettings`. Pfand aus ist kein
6
+ * Fehler: `null`, dann darf ein Fremdsystem keine Pfandzeilen schicken. Eine
7
+ * Antwort, in der `deposit` weder `null` noch ein Objekt ist, wirft
8
+ * [KasseneckValidationError] (Richtung `response`), nie still `null`.
9
+ */
10
+ export declare function listDepositTypes(transport: InternerTransport): Promise<DepositSettings | null>;
@@ -0,0 +1,25 @@
1
+ import { posDepositSettingsFromWire } from '../pos/pfand.js';
2
+ import { KasseneckValidationError } from './errors.js';
3
+ /**
4
+ * Pfandarten des Betriebs lesen (`listDepositTypes`, nur unter `/v3`, API-Schluessel).
5
+ * Die Antwort ist der Block `deposit` aus `getKasseSettings`. Pfand aus ist kein
6
+ * Fehler: `null`, dann darf ein Fremdsystem keine Pfandzeilen schicken. Eine
7
+ * Antwort, in der `deposit` weder `null` noch ein Objekt ist, wirft
8
+ * [KasseneckValidationError] (Richtung `response`), nie still `null`.
9
+ */
10
+ export async function listDepositTypes(transport) {
11
+ const daten = await transport('listDepositTypes', {});
12
+ if (daten === null || typeof daten !== 'object' || Array.isArray(daten) || !('deposit' in daten)) {
13
+ throw antwortfehler('Antwort enthaelt keinen Pfandblock (data.deposit fehlt)');
14
+ }
15
+ const deposit = daten['deposit'];
16
+ if (deposit === null)
17
+ return null;
18
+ const einstellungen = posDepositSettingsFromWire(deposit);
19
+ if (einstellungen === undefined)
20
+ throw antwortfehler('data.deposit ist weder null noch ein Objekt');
21
+ return einstellungen;
22
+ }
23
+ function antwortfehler(grund) {
24
+ return new KasseneckValidationError('listDepositTypes', grund, 'response');
25
+ }
@@ -47,7 +47,7 @@ export type TerminalCodeSource = (typeof TERMINAL_CODE_SOURCES)[number];
47
47
  * in dessen Reihenfolge; dazu kommen die gemeinsamen Codes von Anmeldung und
48
48
  * Rand. Ein Code ausserhalb bleibt ueber `KasseneckApiError.code` lesbar.
49
49
  */
50
- export declare const TERMINAL_ERROR_CODES: readonly ["terminal_not_enabled", "terminal_test_environment", "terminal_device_unknown", "terminal_device_blocked", "invalid_terminal_device", "too_many_terminal_devices", "terminal_not_in_business", "terminal_code_manual", "terminal_code_rate_limited", "terminal_not_assigned", "server_error"];
50
+ export declare const TERMINAL_ERROR_CODES: readonly ["terminal_not_enabled", "terminal_test_environment", "terminal_device_unknown", "terminal_device_blocked", "invalid_terminal_device", "too_many_terminal_devices", "terminal_not_in_business", "terminal_code_manual", "terminal_code_rate_limited", "terminal_not_assigned", "terminal_fixed", "terminal_device_fixed", "server_error"];
51
51
  export type TerminalErrorCode = (typeof TERMINAL_ERROR_CODES)[number];
52
52
  /** Laengen der Texte, die der Server annimmt (nach Abzug von Leerraum am Rand). */
53
53
  export declare const TERMINAL_LABEL_MAX = 60;
@@ -54,6 +54,8 @@ export const TERMINAL_ERROR_CODES = Object.freeze([
54
54
  'terminal_code_manual', // Konto ohne Postfach: die App fragt nach dem Code
55
55
  'terminal_code_rate_limited', // hoechstens 6 Code-Anfragen je Geraet und Stunde
56
56
  'terminal_not_assigned', // dem Geraet ist keine TID zugeordnet: zuerst getTerminalAccess
57
+ 'terminal_fixed', // die TID gehoert fest einem anderen Geraet
58
+ 'terminal_device_fixed', // dem Geraet ist eine TID fest zugeordnet: Wechsel nur ueber den Support
57
59
  'server_error',
58
60
  ]);
59
61
  /** Laengen der Texte, die der Server annimmt (nach Abzug von Leerraum am Rand). */
@@ -8,10 +8,15 @@ import { CreditCardProvider } from '../enums/index.js';
8
8
  * bleibt deshalb bewusst Euro (siehe [toHobexReceiptPayload]/
9
9
  * [fromHobexReceiptPayload]), intern wird ab hier exakt in Cent gefuehrt.
10
10
  *
11
- * Nur der Cloud-API-Pfad (`fromJson` im Dart-Vorbild) ist Teil dieses Pakets;
12
- * das lokale HPS-Terminal (`fromHps`, TCP-Anbindung an ein physisches Geraet)
13
- * ist wie SumUp/myPOS eine Android/Desktop-Geraete-Anbindung, die ein
14
- * Browser-/Node-Paket nicht bedienen kann.
11
+ * Zwei Wege hinein, je nach Weg der Zahlung:
12
+ *
13
+ * - **Cloud-API** (`fromJson` im Dart-Vorbild): [fromHobexReceiptPayload].
14
+ * - **HPS-Terminal ueber Kasseneck Connect** (`fromHps` im Dart-Vorbild):
15
+ * `hobexReceiptFromHps` aus `@kreiseck/kasseneck-api/payments` auf die
16
+ * Terminal-Antwort (`HpsPaymentResult.response`). Nur dieser Weg setzt den
17
+ * Anbieter `hobexHps` und damit die HPS-Zusatzfelder in
18
+ * [hobexReceiptToCardPaymentData]; er liest auch `cvm` als Zahl und
19
+ * nicht gefuehrte Felder (`null`) als leeren Text.
15
20
  */
16
21
  export interface HobexReceipt {
17
22
  transactionId: string;
@@ -52,7 +57,17 @@ export interface HobexReceiptPayload {
52
57
  cvm: string | number;
53
58
  }
54
59
  export declare function toHobexReceiptPayload(receipt: HobexReceipt): HobexReceiptPayload;
55
- export declare function fromHobexReceiptPayload(payload: HobexReceiptPayload): HobexReceipt;
60
+ /**
61
+ * Liest eine Hobex-Nutzlast der **Cloud-API**.
62
+ *
63
+ * Der Anbieter ergibt sich aus dem Weg, nicht aus dem JSON; Vorgabe ist
64
+ * `hobexCloudApi`. Fuer eine Antwort des HPS-Terminals ist der richtige Weg
65
+ * `hobexReceiptFromHps` (`@kreiseck/kasseneck-api/payments`) — wer trotzdem
66
+ * hier hereinkommt, gibt [provider] `CreditCardProvider.hobexHps`
67
+ * mit, sonst fehlen am Beleg Genehmigungsnummer, Ablaufdatum, Kartenausgeber,
68
+ * Betrag und Waehrung (siehe [hobexReceiptToCardPaymentData]).
69
+ */
70
+ export declare function fromHobexReceiptPayload(payload: HobexReceiptPayload, provider?: CreditCardProvider): HobexReceipt;
56
71
  /**
57
72
  * Wandelt den Beleg in die `cardPaymentData`-Map, die auf dem Kasseneck-Beleg
58
73
  * landet (siehe [Receipt.cardPaymentData]). Bei HPS-Zahlungen kommen weitere
@@ -21,7 +21,17 @@ export function toHobexReceiptPayload(receipt) {
21
21
  cvm: receipt.cvm,
22
22
  };
23
23
  }
24
- export function fromHobexReceiptPayload(payload) {
24
+ /**
25
+ * Liest eine Hobex-Nutzlast der **Cloud-API**.
26
+ *
27
+ * Der Anbieter ergibt sich aus dem Weg, nicht aus dem JSON; Vorgabe ist
28
+ * `hobexCloudApi`. Fuer eine Antwort des HPS-Terminals ist der richtige Weg
29
+ * `hobexReceiptFromHps` (`@kreiseck/kasseneck-api/payments`) — wer trotzdem
30
+ * hier hereinkommt, gibt [provider] `CreditCardProvider.hobexHps`
31
+ * mit, sonst fehlen am Beleg Genehmigungsnummer, Ablaufdatum, Kartenausgeber,
32
+ * Betrag und Waehrung (siehe [hobexReceiptToCardPaymentData]).
33
+ */
34
+ export function fromHobexReceiptPayload(payload, provider = CreditCardProvider.hobexCloudApi) {
25
35
  return {
26
36
  transactionId: payload.transactionId,
27
37
  tid: payload.tid,
@@ -48,11 +58,12 @@ export function fromHobexReceiptPayload(payload) {
48
58
  amountCents: euroToCents(payload.amount),
49
59
  tipCents: euroToCents(payload.tip),
50
60
  cvm: String(payload.cvm),
51
- // Die Cloud-API-Nutzlast traegt keinen eigenen Provider-Schluessel — der
52
- // Provider ergibt sich aus dem Transportweg (Cloud vs. HPS), nicht aus
53
- // dem JSON. Das Dart-Vorbild setzt ihn in `fromJson` deshalb ebenfalls
54
- // nicht, sondern belaesst den Konstruktor-Default.
55
- creditCardProvider: CreditCardProvider.hobexCloudApi,
61
+ // Die Nutzlast traegt keinen eigenen Provider-Schluessel — der Provider
62
+ // ergibt sich aus dem Transportweg (Cloud vs. HPS), nicht aus dem JSON.
63
+ // Das Dart-Vorbild setzt ihn in `fromJson` deshalb ebenfalls nicht,
64
+ // sondern belaesst den Konstruktor-Default (Cloud); den Weg kennt nur
65
+ // der Aufrufer.
66
+ creditCardProvider: provider,
56
67
  };
57
68
  }
58
69
  /**
@@ -1,4 +1,4 @@
1
- import { HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, PREFLIGHT_CONNECT_CODES, } from './errors.js';
1
+ import { HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, PREFLIGHT_CONNECT_CODES, TERMINAL_UNREACHABLE_CONNECT_CODES, } from './errors.js';
2
2
  import { isValidHpsTransactionId } from './transaction-id.js';
3
3
  import { parseHpsTransactionResponse } from './transaction-response.js';
4
4
  const DEFAULT_BASE_URL = 'http://127.0.0.1:27182';
@@ -56,15 +56,17 @@ export function createHpsConnectClient(options) {
56
56
  const message = typeof h.error?.message === 'string' && h.error.message.trim() !== ''
57
57
  ? h.error.message
58
58
  : `Kasseneck Connect meldet einen Fehler (HTTP ${antwort.status})`;
59
- if (code !== undefined && PREFLIGHT_CONNECT_CODES.has(code)) {
59
+ if (code !== undefined && (PREFLIGHT_CONNECT_CODES.has(code) || TERMINAL_UNREACHABLE_CONNECT_CODES.has(code))) {
60
60
  // Siehe errors.ts: diese Codes entstehen laut `kasseneck-connect`
61
- // ausnahmslos VOR jedem Terminal-Kontakt -- beweisbar nichts gesendet.
61
+ // ausnahmslos VOR jedem Terminal-Kontakt bzw. vor jedem gesendeten Byte
62
+ // (`terminal_unreachable`: keine TCP-Verbindung) -- beweisbar nichts
63
+ // gesendet.
62
64
  throw new HpsPreflightError(message, code);
63
65
  }
64
66
  // terminal_error / timeout / terminal_offline -- oder ein Code, den
65
67
  // dieses Paket nicht kennt. Bewusst dieselbe Klasse fuer beide: ein
66
68
  // unbekannter Code ist keine bewiesene Nicht-Aussendung, siehe
67
- // PREFLIGHT_CONNECT_CODES.
69
+ // PREFLIGHT_CONNECT_CODES und TERMINAL_UNREACHABLE_CONNECT_CODES.
68
70
  //
69
71
  // `error.detail.terminalHttpStatus` reist seit `kasseneck-connect`
70
72
  // Commit `0fb6f66` mit, wenn das TERMINAL selbst einen HTTP-Status
@@ -7,9 +7,11 @@
7
7
  * - [HpsPreflightError] — es ist NACHWEISLICH nichts gesendet worden. Entweder
8
8
  * die Kennung selbst war unbrauchbar (siehe `connect-client.ts`), oder
9
9
  * Connect hat die Anfrage VOR dem Terminal-Kontakt abgelehnt (falscher
10
- * Host, keine Kopplung, ...). Wird von `payments.ts` unveraendert
11
- * weitergeworfen, niemals in einen Ausgang uebersetzt — Zwilling von
12
- * Dart's `ArgumentError`-Sonderfall in `HpsPayments.pay()`.
10
+ * Host, keine Kopplung, ...), oder die TCP-Verbindung zum Terminal kam gar
11
+ * nicht erst zustande ([TERMINAL_UNREACHABLE_CONNECT_CODES]). Wird von
12
+ * `payments.ts` unveraendert weitergeworfen, niemals in einen Ausgang
13
+ * uebersetzt — Zwilling von Dart's `ArgumentError`-Sonderfall in
14
+ * `HpsPayments.pay()`.
13
15
  * - [HpsConnectTerminalError] — die Anfrage GING RAUS (oder der Versuch dazu
14
16
  * scheiterte am Transport), aber es kam keine schluessige Antwort. Das
15
17
  * umfasst ausdruecklich auch [isTerminalBusy]: HTTP `409` ist die einzige
@@ -27,7 +29,12 @@ export declare abstract class HpsConnectException extends Error {
27
29
  /**
28
30
  * Nichts ist gesendet worden. `reason` ist deutscher Klartext, `connectCode`
29
31
  * gesetzt, wenn die Ablehnung von Connect kam (statt von der lokalen
30
- * Kennungspruefung).
32
+ * Kennungspruefung) — ein Code aus [PREFLIGHT_CONNECT_CODES] oder aus
33
+ * [TERMINAL_UNREACHABLE_CONNECT_CODES].
34
+ *
35
+ * Fuer die Kasse heisst das: sicher nichts belastet, ein neuer Versuch ist
36
+ * gefahrlos. Bei `terminal_unreachable` liegt die Ursache am Terminal (aus,
37
+ * anderes Netz, falsche IP), bei den anderen Codes an Connect oder der Kopplung.
31
38
  */
32
39
  export declare class HpsPreflightError extends HpsConnectException {
33
40
  readonly name: string;
@@ -61,11 +68,31 @@ export declare class HpsTransactionIdError extends HpsPreflightError {
61
68
  * einen Fehlercode erweitert wird, der doch am Terminal entsteht.
62
69
  */
63
70
  export declare const PREFLIGHT_CONNECT_CODES: ReadonlySet<string>;
71
+ /**
72
+ * Connect-Fehlercodes, die AM Weg zum Terminal entstehen, aber beweisbar vor
73
+ * jedem gesendeten Byte: Connect hat die TCP-Verbindung zum Terminal
74
+ * versucht, und sie kam nicht zustande (Verbindung abgelehnt, keine Route zum
75
+ * Host, Zeitablauf beim Verbindungsaufbau). Ohne Verbindung kein Request —
76
+ * am Terminal ist nichts angekommen, also auch nichts belastet.
77
+ *
78
+ * Getrennt von [PREFLIGHT_CONNECT_CODES], weil die Ursache eine andere ist:
79
+ * dort lehnt Connect die Anfrage ab, ohne das Terminal ueberhaupt zu
80
+ * versuchen; hier hat Connect es versucht, und das Terminal war nicht da. Fuer
81
+ * den Ausgang zaehlt beides gleich ([HpsPreflightError]).
82
+ *
83
+ * Nur Connect-Fassungen ab der Einfuehrung von `terminal_unreachable` senden
84
+ * den Code. Aeltere melden jeden Netzfehler zum Terminal als
85
+ * `terminal_offline` — und der bleibt unklar: dort kann die Verbindung auch
86
+ * NACH dem Senden gerissen sein. Wie bei [PREFLIGHT_CONNECT_CODES] gilt die
87
+ * Positivliste: was hier nicht steht, ist [HpsConnectTerminalError].
88
+ */
89
+ export declare const TERMINAL_UNREACHABLE_CONNECT_CODES: ReadonlySet<string>;
64
90
  /**
65
91
  * Die Anfrage ging (oder der Versuch dazu) in Richtung Terminal, aber es kam
66
92
  * keine schluessige Antwort — Connect meldete `terminal_error`, `timeout`
67
93
  * oder `terminal_offline` (`kasseneck-connect/lib/src/terminal/hps.dart`),
68
- * oder einen Fehlercode, den dieses Paket nicht kennt.
94
+ * oder einen Fehlercode, den dieses Paket nicht kennt. `terminal_unreachable`
95
+ * gehoert NICHT hierher (beweisbar nichts gesendet, [HpsPreflightError]).
69
96
  */
70
97
  export declare class HpsConnectTerminalError extends HpsConnectException {
71
98
  readonly name = "HpsConnectTerminalError";
@@ -8,9 +8,11 @@ import { NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS } from './transaction-
8
8
  * - [HpsPreflightError] — es ist NACHWEISLICH nichts gesendet worden. Entweder
9
9
  * die Kennung selbst war unbrauchbar (siehe `connect-client.ts`), oder
10
10
  * Connect hat die Anfrage VOR dem Terminal-Kontakt abgelehnt (falscher
11
- * Host, keine Kopplung, ...). Wird von `payments.ts` unveraendert
12
- * weitergeworfen, niemals in einen Ausgang uebersetzt — Zwilling von
13
- * Dart's `ArgumentError`-Sonderfall in `HpsPayments.pay()`.
11
+ * Host, keine Kopplung, ...), oder die TCP-Verbindung zum Terminal kam gar
12
+ * nicht erst zustande ([TERMINAL_UNREACHABLE_CONNECT_CODES]). Wird von
13
+ * `payments.ts` unveraendert weitergeworfen, niemals in einen Ausgang
14
+ * uebersetzt — Zwilling von Dart's `ArgumentError`-Sonderfall in
15
+ * `HpsPayments.pay()`.
14
16
  * - [HpsConnectTerminalError] — die Anfrage GING RAUS (oder der Versuch dazu
15
17
  * scheiterte am Transport), aber es kam keine schluessige Antwort. Das
16
18
  * umfasst ausdruecklich auch [isTerminalBusy]: HTTP `409` ist die einzige
@@ -28,7 +30,12 @@ export class HpsConnectException extends Error {
28
30
  /**
29
31
  * Nichts ist gesendet worden. `reason` ist deutscher Klartext, `connectCode`
30
32
  * gesetzt, wenn die Ablehnung von Connect kam (statt von der lokalen
31
- * Kennungspruefung).
33
+ * Kennungspruefung) — ein Code aus [PREFLIGHT_CONNECT_CODES] oder aus
34
+ * [TERMINAL_UNREACHABLE_CONNECT_CODES].
35
+ *
36
+ * Fuer die Kasse heisst das: sicher nichts belastet, ein neuer Versuch ist
37
+ * gefahrlos. Bei `terminal_unreachable` liegt die Ursache am Terminal (aus,
38
+ * anderes Netz, falsche IP), bei den anderen Codes an Connect oder der Kopplung.
32
39
  */
33
40
  export class HpsPreflightError extends HpsConnectException {
34
41
  name = 'HpsPreflightError';
@@ -75,11 +82,33 @@ export const PREFLIGHT_CONNECT_CODES = new Set([
75
82
  'not_found',
76
83
  'body_too_large',
77
84
  ]);
85
+ /**
86
+ * Connect-Fehlercodes, die AM Weg zum Terminal entstehen, aber beweisbar vor
87
+ * jedem gesendeten Byte: Connect hat die TCP-Verbindung zum Terminal
88
+ * versucht, und sie kam nicht zustande (Verbindung abgelehnt, keine Route zum
89
+ * Host, Zeitablauf beim Verbindungsaufbau). Ohne Verbindung kein Request —
90
+ * am Terminal ist nichts angekommen, also auch nichts belastet.
91
+ *
92
+ * Getrennt von [PREFLIGHT_CONNECT_CODES], weil die Ursache eine andere ist:
93
+ * dort lehnt Connect die Anfrage ab, ohne das Terminal ueberhaupt zu
94
+ * versuchen; hier hat Connect es versucht, und das Terminal war nicht da. Fuer
95
+ * den Ausgang zaehlt beides gleich ([HpsPreflightError]).
96
+ *
97
+ * Nur Connect-Fassungen ab der Einfuehrung von `terminal_unreachable` senden
98
+ * den Code. Aeltere melden jeden Netzfehler zum Terminal als
99
+ * `terminal_offline` — und der bleibt unklar: dort kann die Verbindung auch
100
+ * NACH dem Senden gerissen sein. Wie bei [PREFLIGHT_CONNECT_CODES] gilt die
101
+ * Positivliste: was hier nicht steht, ist [HpsConnectTerminalError].
102
+ */
103
+ export const TERMINAL_UNREACHABLE_CONNECT_CODES = new Set([
104
+ 'terminal_unreachable',
105
+ ]);
78
106
  /**
79
107
  * Die Anfrage ging (oder der Versuch dazu) in Richtung Terminal, aber es kam
80
108
  * keine schluessige Antwort — Connect meldete `terminal_error`, `timeout`
81
109
  * oder `terminal_offline` (`kasseneck-connect/lib/src/terminal/hps.dart`),
82
- * oder einen Fehlercode, den dieses Paket nicht kennt.
110
+ * oder einen Fehlercode, den dieses Paket nicht kennt. `terminal_unreachable`
111
+ * gehoert NICHT hierher (beweisbar nichts gesendet, [HpsPreflightError]).
83
112
  */
84
113
  export class HpsConnectTerminalError extends HpsConnectException {
85
114
  name = 'HpsConnectTerminalError';
@@ -18,7 +18,7 @@
18
18
  * des Aufrufers.
19
19
  */
20
20
  export { type HpsConnectCancelOptions, type HpsConnectClient, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectRefundOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, createHpsConnectClient, } from './connect-client.js';
21
- export { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, PREFLIGHT_CONNECT_CODES, } from './errors.js';
21
+ export { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, PREFLIGHT_CONNECT_CODES, TERMINAL_UNREACHABLE_CONNECT_CODES, } from './errors.js';
22
22
  export { type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, } from './events.js';
23
23
  export { type CardPaymentOutcome, type HpsPaymentResult, isHostUncertainResult, mayRetrySafely, } from './outcome.js';
24
24
  export { type HpsCancelOptions, type HpsPaymentOptions, type HpsPayments, type HpsPaymentsOptions, type HpsRefundOptions, createHpsPayments, } from './payments.js';
@@ -18,7 +18,7 @@
18
18
  * des Aufrufers.
19
19
  */
20
20
  export { createHpsConnectClient, } from './connect-client.js';
21
- export { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, PREFLIGHT_CONNECT_CODES, } from './errors.js';
21
+ export { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, PREFLIGHT_CONNECT_CODES, TERMINAL_UNREACHABLE_CONNECT_CODES, } from './errors.js';
22
22
  export { isHostUncertainResult, mayRetrySafely, } from './outcome.js';
23
23
  export { createHpsPayments, } from './payments.js';
24
24
  export { MAX_TRANSACTION_ID_LENGTH, createHpsTransactionIdGenerator, isValidHpsTransactionId, newHpsTransactionId, } from './transaction-id.js';
@@ -43,4 +43,4 @@
43
43
  export { StripeLinkMode, type StripeLinkModeKey } from '../enums/index.js';
44
44
  export { type CreateStripeLinkOptions, type StripeCaptureResult, createStripeLink, stripeCaptureIntent, } from './stripe.js';
45
45
  export { type HobexPayOptions, type HobexRefundOptions, type HobexTransactionIdOptions, hobexPay, hobexRefund, newHobexTransactionId, } from './hobex.js';
46
- export { type CardPaymentOutcome, type HpsConnectClient, type HpsConnectCancelOptions, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectRefundOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, type HpsCancelOptions, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, type HpsPaymentOptions, type HpsPayments, type HpsPaymentResult, type HpsPaymentsOptions, type HpsRefundOptions, type HpsTransactionIdGeneratorOptions, type HpsTransactionResponse, ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';
46
+ export { type CardPaymentOutcome, type HpsConnectClient, type HpsConnectCancelOptions, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectRefundOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, type HpsCancelOptions, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, type HpsPaymentOptions, type HpsPayments, type HpsPaymentResult, type HpsPaymentsOptions, type HpsRefundOptions, type HpsTransactionIdGeneratorOptions, type HpsTransactionResponse, ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, hobexReceiptFromHps, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TERMINAL_UNREACHABLE_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';
@@ -43,4 +43,4 @@
43
43
  export { StripeLinkMode } from '../enums/index.js';
44
44
  export { createStripeLink, stripeCaptureIntent, } from './stripe.js';
45
45
  export { hobexPay, hobexRefund, newHobexTransactionId, } from './hobex.js';
46
- export { ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';
46
+ export { ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, hobexReceiptFromHps, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TERMINAL_UNREACHABLE_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';
@@ -250,6 +250,16 @@ declare const MELDUNGEN_ROH: {
250
250
  readonly placeholders: readonly ["response"];
251
251
  readonly only: readonly ["web"];
252
252
  };
253
+ readonly 'terminal.several_found': {
254
+ readonly text: "Mehrere Terminals gefunden: {hosts}. Die IP-Adresse des richtigen von Hand eintragen.";
255
+ readonly placeholders: readonly ["hosts"];
256
+ readonly only: readonly ["web"];
257
+ };
258
+ readonly 'terminal.tid_not_found': {
259
+ readonly text: "Mehrere Terminals gefunden: {hosts}. Keines meldet die TID {tid} – TID prüfen oder die IP-Adresse von Hand eintragen.";
260
+ readonly placeholders: readonly ["hosts", "tid"];
261
+ readonly only: readonly ["web"];
262
+ };
253
263
  readonly 'gptom.app_missing': {
254
264
  readonly text: "Die GP-Tom-App ist auf diesem Gerät nicht da.";
255
265
  readonly only: readonly ["app"];
@@ -783,6 +793,10 @@ declare const MELDUNGEN_ROH: {
783
793
  readonly text: "Kasseneck Connect nicht gefunden – bitte installieren.";
784
794
  readonly only: readonly ["web"];
785
795
  };
796
+ readonly 'connect.local_network_blocked': {
797
+ readonly text: "Der Browser sperrt den Zugang zu Kasseneck Connect. Freigeben: Schloss neben der Adresse (installierte App: Menü ⋮ → App-Info) → Website-Einstellungen → „Lokales Netzwerk“ → „Zulassen“.";
798
+ readonly only: readonly ["web"];
799
+ };
786
800
  readonly 'connect.unpair_question': {
787
801
  readonly text: "Diesen Browser wirklich von Connect trennen? Der Bondruck geht dann nicht mehr.";
788
802
  readonly only: readonly ["web"];
@@ -135,6 +135,10 @@ const MELDUNGEN_ROH = {
135
135
  'card_payment.unpair_card_charged': { text: 'Auf diesem Gerät liegt noch eine gebuchte Kartenzahlung ohne Beleg – sie muss von Hand am Terminal zurückerstattet werden (Betrag siehe unten).' },
136
136
  'terminal.none_found': { text: 'Kein Hobex-Terminal gefunden – ist es eingeschaltet und im selben Netz wie dieser Rechner?', only: ['web'] },
137
137
  'terminal.not_ready': { text: 'Terminal antwortet, ist aber nicht betriebsbereit: {response} – TID prüfen.', placeholders: ['response'], only: ['web'] },
138
+ // Terminal-Suche mit mehreren Treffern (1.33.0): uebernommen wird nur ein Treffer, an dem die
139
+ // Diagnose die TID dieses Geraets bestaetigt -- sonst nennt die Kasse die Adressen und setzt keine.
140
+ 'terminal.several_found': { text: 'Mehrere Terminals gefunden: {hosts}. Die IP-Adresse des richtigen von Hand eintragen.', placeholders: ['hosts'], only: ['web'] },
141
+ 'terminal.tid_not_found': { text: 'Mehrere Terminals gefunden: {hosts}. Keines meldet die TID {tid} – TID prüfen oder die IP-Adresse von Hand eintragen.', placeholders: ['hosts', 'tid'], only: ['web'] },
138
142
  'gptom.app_missing': { text: 'Die GP-Tom-App ist auf diesem Gerät nicht da.', only: ['app'] },
139
143
  'gptom.search_failed': { text: 'GP Tom: Suche nach der App fehlgeschlagen: {reason}', placeholders: ['reason'], only: ['app'] },
140
144
  'gptom.payment_failed': { text: 'GP Tom: Zahlung fehlgeschlagen: {reason}', placeholders: ['reason'], only: ['app'] },
@@ -381,6 +385,9 @@ const MELDUNGEN_ROH = {
381
385
  'connect.printer_unknown': { text: 'Diesen Drucker kennt Kasseneck Connect nicht (mehr) – bitte neu suchen.', only: ['web'] },
382
386
  'connect.origin_not_allowed': { text: 'Kasseneck Connect nimmt von dieser Adresse nichts an (Ursprung nicht freigegeben).', only: ['web'] },
383
387
  'connect.not_installed': { text: 'Kasseneck Connect nicht gefunden – bitte installieren.', only: ['web'] },
388
+ // Chrome fragt ab 142 vor dem Zugriff einer https-Seite auf 127.0.0.1 nach („Lokales Netzwerk“).
389
+ // Ist das gesperrt, findet die Kasse Connect nicht -- installieren hilft dann nicht (1.33.0).
390
+ 'connect.local_network_blocked': { text: 'Der Browser sperrt den Zugang zu Kasseneck Connect. Freigeben: Schloss neben der Adresse (installierte App: Menü ⋮ → App-Info) → Website-Einstellungen → „Lokales Netzwerk“ → „Zulassen“.', only: ['web'] },
384
391
  'connect.unpair_question': { text: 'Diesen Browser wirklich von Connect trennen? Der Bondruck geht dann nicht mehr.', only: ['web'] },
385
392
  // --- Einstellungen -------------------------------------------------------
386
393
  'settings.load_failed': { text: 'Die Einstellungen konnten nicht geladen werden.' },
@@ -1,5 +1,5 @@
1
1
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
2
- export declare const VOKABULAR_QUELLE = "168261a0b5130d454fc3b5d51e8ee567d6a3e9a5d2d8e172829e9ccb17c47f31";
2
+ export declare const VOKABULAR_QUELLE = "820ce0391fbe5a2f51ad441f6b0777e4c2370cafd83fe69b94edb349836caad5";
3
3
  /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
4
4
  export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
5
5
  export interface SchemaObjekt {
@@ -1,7 +1,7 @@
1
1
  // Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
2
2
  // Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
3
3
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
4
- export const VOKABULAR_QUELLE = "168261a0b5130d454fc3b5d51e8ee567d6a3e9a5d2d8e172829e9ccb17c47f31";
4
+ export const VOKABULAR_QUELLE = "820ce0391fbe5a2f51ad441f6b0777e4c2370cafd83fe69b94edb349836caad5";
5
5
  /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
6
6
  export const SCHEMAS = {
7
7
  "getReceipt": {
@@ -4,4 +4,4 @@
4
4
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
5
5
  * beim Anheben der Version beide Stellen aendern.
6
6
  */
7
- export declare const PACKAGE_VERSION = "1.32.1";
7
+ export declare const PACKAGE_VERSION = "1.34.0";
@@ -4,4 +4,4 @@
4
4
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
5
5
  * beim Anheben der Version beide Stellen aendern.
6
6
  */
7
- export const PACKAGE_VERSION = '1.32.1';
7
+ export const PACKAGE_VERSION = '1.34.0';
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.32.1",
2
+ "version": "1.34.0",
3
3
  "measuredOn": {
4
4
  "tid": "3600335",
5
5
  "hpsVersion": "1.10.0",
@@ -2,7 +2,7 @@
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "title": "Kasseneck Rechnungs-API",
4
4
  "version": 2,
5
- "package": "1.32.1",
5
+ "package": "1.34.0",
6
6
  "endpoints": {
7
7
  "createCustomer": {
8
8
  "request": {
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.32.1",
2
+ "version": "1.34.0",
3
3
  "languages": [
4
4
  "de",
5
5
  "en"