@kreiseck/kasseneck-api 1.33.0 → 1.35.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 (54) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +11 -1
  3. package/dist/cjs/client/api.d.ts +3 -0
  4. package/dist/cjs/client/api.js +2 -0
  5. package/dist/cjs/client/aufrufe.d.ts +2 -2
  6. package/dist/cjs/client/aufrufe.js +11 -0
  7. package/dist/cjs/client/list-deposit-types.d.ts +10 -0
  8. package/dist/cjs/client/list-deposit-types.js +28 -0
  9. package/dist/cjs/client/terminal.d.ts +1 -1
  10. package/dist/cjs/client/terminal.js +2 -0
  11. package/dist/cjs/pos/drucker-katalog.d.ts +148 -0
  12. package/dist/cjs/pos/drucker-katalog.js +260 -0
  13. package/dist/cjs/pos/index.d.ts +1 -0
  14. package/dist/cjs/pos/index.js +8 -3
  15. package/dist/cjs/stored/vokabular.d.ts +1 -1
  16. package/dist/cjs/stored/vokabular.js +1 -1
  17. package/dist/cjs/version.d.ts +1 -1
  18. package/dist/cjs/version.js +1 -1
  19. package/dist/esm/client/api.d.ts +3 -0
  20. package/dist/esm/client/api.js +2 -0
  21. package/dist/esm/client/aufrufe.d.ts +2 -2
  22. package/dist/esm/client/aufrufe.js +11 -0
  23. package/dist/esm/client/list-deposit-types.d.ts +10 -0
  24. package/dist/esm/client/list-deposit-types.js +25 -0
  25. package/dist/esm/client/terminal.d.ts +1 -1
  26. package/dist/esm/client/terminal.js +2 -0
  27. package/dist/esm/pos/drucker-katalog.d.ts +148 -0
  28. package/dist/esm/pos/drucker-katalog.js +252 -0
  29. package/dist/esm/pos/index.d.ts +1 -0
  30. package/dist/esm/pos/index.js +3 -0
  31. package/dist/esm/stored/vokabular.d.ts +1 -1
  32. package/dist/esm/stored/vokabular.js +1 -1
  33. package/dist/esm/version.d.ts +1 -1
  34. package/dist/esm/version.js +1 -1
  35. package/fixtures/hobex-hps-codes.json +1 -1
  36. package/fixtures/invoice-api.schema.json +1 -1
  37. package/fixtures/invoice-texts.json +1 -1
  38. package/fixtures/pos-texts.json +1 -1
  39. package/fixtures/printer-catalog.json +1802 -0
  40. package/fixtures/surface.json +7 -3
  41. package/fixtures/v3/antworten/belege.json +1 -1
  42. package/fixtures/v3/antworten/belegmail.json +1 -1
  43. package/fixtures/v3/antworten/berichte.json +1 -1
  44. package/fixtures/v3/antworten/kasse-belege.json +1 -1
  45. package/fixtures/v3/antworten/kasse.json +2 -2
  46. package/fixtures/v3/antworten/lager.json +1 -1
  47. package/fixtures/v3/antworten/rechnungen.json +1 -1
  48. package/fixtures/v3/antworten/storno.json +1 -1
  49. package/fixtures/v3/stored/belege.json +1 -1
  50. package/fixtures/v3/stored/kasse.json +2 -2
  51. package/fixtures/v3/stored/rechnungen.json +1 -1
  52. package/fixtures/v3/v3-vokabular.json +51 -4
  53. package/fixtures/v3/zahlbetrag-faelle.json +1 -1
  54. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,26 @@ 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.35.0 - unveröffentlicht
8
+
9
+ Printer catalog for setting up a receipt printer through Kasseneck Connect with one click. Additive; every existing call, receipt and golden behaves as before.
10
+
11
+ - **`printerCatalogEntry(model: string | null | undefined)`** (`./pos`) returns the approved catalog entry for a model name as Connect reports it (mDNS, `GS I`), or `null` for an unknown model; `undefined` is allowed because Connect leaves `model` out of a find it cannot name. **`printerCatalogSettings(entry)`** returns what the entry proposes for the first setup: `device` (`paperSize`, `codePage`, `cut`, `qrMode`, `drawerEnabled`), sendable as it is with `setMyRegisterDeviceSettings`, and `paperSizeNeedsCheck`. Reason: the boss should set up a known printer without knowing paper width, code page or QR mode; an unknown model only asks for the paper width.
12
+ - **Paper width:** an entry lists the paper size settings that fit the model (`paperSizes`; another roll needs the paper guide and a printer setting) and its factory setting (`values.paperSize`), plus `nativeCharsPerLine`, the font A columns the printer has at its factory setting (data sheet). No size in `paperSizes` may lay out more characters than that. When there is more than one, `paperSizeNeedsCheck` is `true`: the proposed width is only the factory setting, and the till confirms it with a test print at the first setup. `drawerEnabled` (from `drawerKick`) is only a proposal for the first setup as well; the till never overrides a choice the boss made.
13
+ - **Only approved entries count.** An entry that is not approved behaves like an unknown model. Approval needs a complete device test: date, Connect version, printer firmware, who tested, every value field checked (`checked`, the code page with € and umlauts) and a print at every paper width (`checkedPaperSizes`).
14
+ - **Starting stock**, not approved yet, so `printerCatalogEntry` answers `null` for every model until a device test approves an entry in a later version: Epson TM-m30III, TM-m30II and TM-T20III (80 mm and 48 characters by default, 58 mm with the paper guide according to the Epson data sheet), TM-m10 (58 mm only, 32 characters) and TM-T88VI, TM-T88VII; all with drawer port, QR from the printer, CP1252. The TM-T88 models print at 180 dpi (512 dots on 80 mm, font A 42 columns), so 48 characters do not fit: they get the till's 32-character layout (`paperSize: 'mm58'`, the 384 dots of `GS W` fit into their 512) even with 80 mm paper, never propose `mm80` and need no width confirmation, until there is a 42-character setting.
15
+ - **Model names are normalized** before matching: `a-z` to upper case (ASCII only), any other character outside ASCII that is neither punctuation nor white space (`Ï`, `ı`, `é`, `®`, `ff`) makes the name unknown, every run of other characters than `A-Z`/`0-9` becomes one `-`, none at the edges, and one leading manufacturer of the catalog (`EPSON-`, the longest first) is dropped. `TM-m30III`, `EPSON TM-m30III`, `tm m30iii` and `(EPSON TM-m30III)` find the same entry. Separators stay as one `-` instead of disappearing, because `TM-T20II-i` is a model of its own and would otherwise match `TM-T20III`; written without the hyphen (`TM-T20IIi`) it cannot be told apart. Matching is exact: `TM-m30III-H`, `TM-T88V` or `TM-m30` are unknown.
16
+ - **Values only from the device settings:** `cut` is `partial` or `none` (what the till offers), `qrMode` `escpos` or `raster` (`auto` means "not decided" and says nothing about a model), and `charsPerLine` must match the factory paper size (`CHARS_PER_PAPER_SIZE`: 32 for `mm58`, 48 for `mm80`).
17
+ - **Contract:** new file `fixtures/printer-catalog.json` with the entries, the value sets and the test cases (normalization, lookup with the shipped catalog, with every entry approved, with some approved and with a catalog of its own with overlapping manufacturers, proposals, catalog problems such as a match name in two entries, a paper size wider than the printer or an incomplete device test). The Dart twin computes the same cases. The catalog itself is checked only by the tests; at run time nothing is repaired or dropped silently.
18
+
19
+ ## 1.34.0 - unveröffentlicht
20
+
21
+ Read the deposit types of a business with the API key: new `listDepositTypes()` on the API client (`/v3` only, right `read`, no effect). Additive; every existing call, receipt and golden behaves as before.
22
+
23
+ - **`listDepositTypes(): Promise<DepositSettings | null>`** returns the `deposit` block of `getKasseSettings` (`singleUse`, `reusable`, `depositTypes[]` with `id`, `kind`, `name`, `type`, `amounts[{ from, cents }]`, `returnRate`, `used`), read with `posDepositSettingsFromWire`. Deposit switched off is not an error: the answer is `null`, which tells a merchandise system that it must not send deposit lines. An answer where `deposit` is missing or neither `null` nor an object throws `KasseneckValidationError` (scope `response`), never a silent `null`. Reason: a third-party merchandise system needs the deposit types of the business to send correct deposit lines.
24
+ - **Contract:** `unfixTerminal` and the codes `terminal_fixed`, `terminal_device_fixed` (fixed TID per device) are known by name (call lists, `TERMINAL_ERROR_CODES`); a typed method follows. `listDepositTypes` needs no till token.
25
+ - `fixtures/v3/*` taken over from the backend (vocabulary entry `listDepositTypes`), `fixtures/surface.json` lists the call.
26
+
7
27
  ## 1.33.0 - unveröffentlicht
8
28
 
9
29
  Card terminal and the browser till on a Mac (Chrome as an installed app, Hobex HPS and printer through Kasseneck Connect). Additive; receipts, bons and every existing call behave as before (all goldens unchanged).
package/README.md CHANGED
@@ -208,7 +208,7 @@ adapter:
208
208
  | `…/printing` | ESC/POS generation (byte sequences for thermal printers), QR sizing, printing over WebUSB. |
209
209
  | `…/payments` | Stripe payment links, Hobex cloud (both HTTP endpoints of the backend), and Hobex **HPS** via **Kasseneck Connect** (local device agent that talks to the terminal). |
210
210
  | `…/register` | Sign-in for the browser register: pair and unpair a device, list its users and sessions, sign in by PIN, renew and end the session. |
211
- | `…/pos` | Tile register: register settings (business-wide and per device), article groups and articles for tiles, discount distribution per VAT rate, scopes of register permissions, network printers and print jobs, tip recipients, the register's message catalogue. |
211
+ | `…/pos` | Tile register: register settings (business-wide and per device), article groups and articles for tiles, discount distribution per VAT rate, scopes of register permissions, network printers and print jobs, the printer catalog for setting up a printer through Kasseneck Connect, tip recipients, the register's message catalogue. |
212
212
  | `…/partner` | Partner API (`/v3`, English): create businesses, FinanzOnline link, signature, cash registers, credentials, webhooks with signature verification. **Belongs on a server.** |
213
213
  | `…/stored` | Stored Firestore documents (inner form, German) as the same English models the `/v3` wire returns: receipts with company and layout, register settings, articles. For clients that read Firestore directly, such as the admin panel. |
214
214
  | `…/invoice` | Invoice API: create and search customers, issue finalised invoices, credit notes and cancellation, PDF and e-invoice XML, the contract as data. **Belongs on a server.** |
@@ -1048,6 +1048,16 @@ the register's text catalogue (`MESSAGES`, `LABELS`, `messageText`,
1048
1048
  `messageText('checkout.locked', { reason })`. The rendered German texts are
1049
1049
  the same as in 0.x.
1050
1050
 
1051
+ **Printer catalog.** `printerCatalogEntry(model)` finds the approved catalog
1052
+ entry for a model name as Kasseneck Connect reports it (case, a leading
1053
+ `EPSON` and the kind of separator do not count; `null` for an unknown model),
1054
+ and `printerCatalogSettings(entry)` returns what it proposes for the first
1055
+ setup: `device` (`paperSize`, `codePage`, `cut`, `qrMode`, `drawerEnabled`)
1056
+ and `paperSizeNeedsCheck`, `true` when the model can be switched to another
1057
+ paper width and the till should confirm it with a test print. Only entries
1058
+ approved after a complete device test count; the entries and their test cases
1059
+ are in `fixtures/printer-catalog.json`.
1060
+
1051
1061
  **Stock at the register.** Three calls on the register path (`/api/v3` only),
1052
1062
  permissions checked by the server (`stockView`, `stockCosts`, `stockLocation`
1053
1063
  in `REGISTER_PERMS`):
@@ -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`). */
@@ -8,6 +8,7 @@ const reports_js_1 = require("./reports.js");
8
8
  const status_js_1 = require("./status.js");
9
9
  const dep_export_js_1 = require("./dep-export.js");
10
10
  const terminal_js_1 = require("./terminal.js");
11
+ const list_deposit_types_js_1 = require("./list-deposit-types.js");
11
12
  const list_receipts_js_1 = require("./list-receipts.js");
12
13
  const receipts_js_1 = require("./receipts.js");
13
14
  const cashregisters_js_1 = require("./cashregisters.js");
@@ -44,6 +45,7 @@ function createKasseneckApi(options) {
44
45
  getReportV2: (o) => (0, reports_js_1.getReportV2)(rufen, o),
45
46
  listReceipts: (o) => (0, list_receipts_js_1.listReceipts)(rufen, o),
46
47
  listAllReceipts: (o) => (0, list_receipts_js_1.listAllReceipts)(rufen, o),
48
+ listDepositTypes: () => (0, list_deposit_types_js_1.listDepositTypes)(rufen),
47
49
  createDepExport: (o) => (0, dep_export_js_1.createDepExport)(rufen, o),
48
50
  getDepExport: (o) => (0, dep_export_js_1.getDepExport)(rufen, o),
49
51
  waitForDepExport: (o) => (0, dep_export_js_1.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
@@ -168,6 +168,10 @@ exports.ALL_CALLS = [
168
168
  'getTerminalCode',
169
169
  'reportTerminalLogin',
170
170
  'reportTerminalReady',
171
+ // Feste TID je Geraet loesen (nur dem Namen nach bekannt, keine eigene Methode).
172
+ 'unfixTerminal',
173
+ // Pfandarten des Betriebs lesen, nur unter /v3.
174
+ 'listDepositTypes',
171
175
  ];
172
176
  /**
173
177
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -306,6 +310,10 @@ exports.PUBLIC_CALLS = [
306
310
  'getTerminalCode',
307
311
  'reportTerminalLogin',
308
312
  'reportTerminalReady',
313
+ // Feste TID je Geraet loesen (nur dem Namen nach bekannt, keine eigene Methode).
314
+ 'unfixTerminal',
315
+ // Pfandarten des Betriebs lesen, nur unter /v3.
316
+ 'listDepositTypes',
309
317
  ];
310
318
  /**
311
319
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
@@ -569,6 +577,7 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
569
577
  listPartnerCustomers: 'read',
570
578
  listPartnerWebhookDeliveries: 'read',
571
579
  listPartnerWebhooks: 'read',
580
+ listDepositTypes: 'read',
572
581
  listReceipts: 'read',
573
582
  listRegisterSessionsForDevice: 'read',
574
583
  listRegisterUsersForDevice: 'read',
@@ -588,6 +597,8 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
588
597
  // Kartenterminal: Anmeldung und Einrichtung melden schreiben denselben Stand noch einmal.
589
598
  reportTerminalLogin: 'repeatable',
590
599
  reportTerminalReady: 'repeatable',
600
+ // Kartenterminal: die feste Bindung noch einmal loesen aendert nichts am Server.
601
+ unfixTerminal: 'repeatable',
591
602
  reprintVoucherLabel: 'repeatable',
592
603
  // Eine offene Code-Anfrage juenger als 6 Minuten bleibt; eine Wiederholung legt keine neue an.
593
604
  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,28 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.listDepositTypes = listDepositTypes;
4
+ const pfand_js_1 = require("../pos/pfand.js");
5
+ const errors_js_1 = require("./errors.js");
6
+ /**
7
+ * Pfandarten des Betriebs lesen (`listDepositTypes`, nur unter `/v3`, API-Schluessel).
8
+ * Die Antwort ist der Block `deposit` aus `getKasseSettings`. Pfand aus ist kein
9
+ * Fehler: `null`, dann darf ein Fremdsystem keine Pfandzeilen schicken. Eine
10
+ * Antwort, in der `deposit` weder `null` noch ein Objekt ist, wirft
11
+ * [KasseneckValidationError] (Richtung `response`), nie still `null`.
12
+ */
13
+ async function listDepositTypes(transport) {
14
+ const daten = await transport('listDepositTypes', {});
15
+ if (daten === null || typeof daten !== 'object' || Array.isArray(daten) || !('deposit' in daten)) {
16
+ throw antwortfehler('Antwort enthaelt keinen Pfandblock (data.deposit fehlt)');
17
+ }
18
+ const deposit = daten['deposit'];
19
+ if (deposit === null)
20
+ return null;
21
+ const einstellungen = (0, pfand_js_1.posDepositSettingsFromWire)(deposit);
22
+ if (einstellungen === undefined)
23
+ throw antwortfehler('data.deposit ist weder null noch ein Objekt');
24
+ return einstellungen;
25
+ }
26
+ function antwortfehler(grund) {
27
+ return new errors_js_1.KasseneckValidationError('listDepositTypes', grund, 'response');
28
+ }
@@ -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;
@@ -64,6 +64,8 @@ exports.TERMINAL_ERROR_CODES = Object.freeze([
64
64
  'terminal_code_manual', // Konto ohne Postfach: die App fragt nach dem Code
65
65
  'terminal_code_rate_limited', // hoechstens 6 Code-Anfragen je Geraet und Stunde
66
66
  'terminal_not_assigned', // dem Geraet ist keine TID zugeordnet: zuerst getTerminalAccess
67
+ 'terminal_fixed', // die TID gehoert fest einem anderen Geraet
68
+ 'terminal_device_fixed', // dem Geraet ist eine TID fest zugeordnet: Wechsel nur ueber den Support
67
69
  'server_error',
68
70
  ]);
69
71
  /** Laengen der Texte, die der Server annimmt (nach Abzug von Leerraum am Rand). */
@@ -0,0 +1,148 @@
1
+ import { type PosCodePage, type PosPaperSize } from './settings.js';
2
+ /**
3
+ * Schnitt eines Eintrags: nur, was die Kasse unter „Papier abschneiden“ anbietet (Teilschnitt oder keiner). Die
4
+ * Einstellung kennt auch `full`, Bondrucker schneiden aber nie ganz durch; ein Katalogwert, den die Kasse nicht
5
+ * anzeigt, waere fuer den Chef nicht pruefbar.
6
+ */
7
+ export declare const PRINTER_CATALOG_CUTS: readonly ["partial", "none"];
8
+ export type PrinterCatalogCut = typeof PRINTER_CATALOG_CUTS[number];
9
+ /** QR-Weg eines Eintrags. `auto` heisst „noch niemand hat entschieden“ und ist darum keine Aussage ueber ein Modell. */
10
+ export declare const PRINTER_CATALOG_QR_MODES: readonly ["escpos", "raster"];
11
+ export type PrinterCatalogQrMode = typeof PRINTER_CATALOG_QR_MODES[number];
12
+ /** Druck-Werte eines Modells mit den Namen und Werten der Geraete-Einstellungen unter /v3. */
13
+ export interface PrinterCatalogValues {
14
+ /** Werkseinstellung der Papierbreite; welche Breiten das Modell sonst kann, steht in `paperSizes`. */
15
+ readonly paperSize: PosPaperSize;
16
+ /**
17
+ * Zeichen je Zeile bei der Werkseinstellung, im Geraetetest bestaetigt. Keine Einstellung: die Kasse leitet sie aus
18
+ * `paperSize` ab (CHARS_PER_PAPER_SIZE). Der Eintrag haelt fest, dass beides an diesem Drucker zusammenpasst; ein
19
+ * Drucker mit anderer Zeichenzahl braeuchte erst eine neue Einstellung.
20
+ */
21
+ readonly charsPerLine: number;
22
+ readonly cut: PrinterCatalogCut;
23
+ /** Ladenanschluss, der auf den Impuls der Kasse (ESC p 0 25 250) oeffnet. */
24
+ readonly drawerKick: boolean;
25
+ readonly qrMode: PrinterCatalogQrMode;
26
+ readonly codePage: PosCodePage;
27
+ }
28
+ /** Ein Wertfeld eines Eintrags; der Geraetetest nennt, welche am Geraet geprueft sind. */
29
+ export type PrinterCatalogValueField = keyof PrinterCatalogValues;
30
+ /** Alle Wertfelder, in der Reihenfolge von [PrinterCatalogValues]; ein Test haelt sie vollstaendig. */
31
+ export declare const PRINTER_CATALOG_VALUE_FIELDS: readonly ["paperSize", "charsPerLine", "cut", "drawerKick", "qrMode", "codePage"];
32
+ /** Protokoll des Geraetetests, der einen Eintrag freigibt. */
33
+ export interface PrinterDeviceTest {
34
+ /** Tag des Tests, `JJJJ-MM-TT` (Wiener Tag). */
35
+ readonly date: string;
36
+ /** Version von Kasseneck Connect, mit der geprueft wurde. */
37
+ readonly connectVersion: string;
38
+ /** Firmware des geprueften Druckers. */
39
+ readonly firmware: string;
40
+ /** Wer geprueft hat: Kuerzel, kein voller Name (die Datei reist im Paket mit). */
41
+ readonly testedBy: string;
42
+ /**
43
+ * Die am Geraet geprueften Wertfelder (`codePage` heisst: € und Umlaute stehen richtig am Bon). Vollstaendig ist der
44
+ * Test erst mit jedem Feld aus `values`: eine Freigabe soll nichts behaupten, was niemand gesehen hat.
45
+ */
46
+ readonly checked: readonly PrinterCatalogValueField[];
47
+ /** Die Papierbreiten, mit denen am Geraet gedruckt wurde; jede aus `paperSizes` muss dabei sein. */
48
+ readonly checkedPaperSizes: readonly PosPaperSize[];
49
+ }
50
+ /** Freigabe eines Eintrags. Nur `approved: true` wirkt; ohne vollstaendigen Geraetetest gibt es keine Freigabe. */
51
+ export interface PrinterCatalogApproval {
52
+ readonly approved: boolean;
53
+ readonly deviceTest: PrinterDeviceTest | null;
54
+ }
55
+ export interface PrinterCatalogEntry {
56
+ /** Feste Kennung `<hersteller>-<modell>`, klein. */
57
+ readonly id: string;
58
+ readonly manufacturer: string;
59
+ /** Modellname zum Anzeigen, so geschrieben wie vom Hersteller. */
60
+ readonly model: string;
61
+ /** Normierte Modellnamen (aus mDNS und `GS I`), an denen der Eintrag erkannt wird. */
62
+ readonly matchNames: readonly string[];
63
+ /**
64
+ * Die Einstellungen der Papierbreite, die an diesem Modell passen (fuer eine andere Rolle mit Papierfuehrung und
65
+ * Einstellung am Drucker), in der Reihenfolge von PAPER_SIZE. Mehr als eine heisst: die Werkseinstellung in `values`
66
+ * kann am Geraet anders stehen.
67
+ */
68
+ readonly paperSizes: readonly PosPaperSize[];
69
+ /**
70
+ * Zeichen je Zeile, die der Drucker in seiner Werkseinstellung mit Schrift A selbst druckt (Datenblatt). Keine
71
+ * Breite aus `paperSizes` darf mehr Zeichen setzen; ist es mehr als `values.charsPerLine`, nutzt die Kasse bewusst
72
+ * ihr schmaleres Layout, bis es eine Einstellung mit dieser Zeichenzahl gibt.
73
+ */
74
+ readonly nativeCharsPerLine: number;
75
+ readonly values: PrinterCatalogValues;
76
+ readonly approval: PrinterCatalogApproval;
77
+ }
78
+ /** Der Teil der Geraete-Einstellungen, den ein bekanntes Modell beim ersten Einrichten vorschlaegt. */
79
+ export interface PrinterCatalogDeviceSettings {
80
+ readonly paperSize: PosPaperSize;
81
+ readonly codePage: PosCodePage;
82
+ readonly cut: PrinterCatalogCut;
83
+ readonly qrMode: PrinterCatalogQrMode;
84
+ /**
85
+ * Aus `drawerKick`: nur ein Vorschlag fuer das erste Einrichten. Hat der Chef die Lade bewusst ausgeschaltet, bleibt
86
+ * sie aus; die Kasse ueberschreibt eine getroffene Wahl nie.
87
+ */
88
+ readonly drawerEnabled: boolean;
89
+ }
90
+ /** Was ein Eintrag beim Einrichten vorschlaegt. */
91
+ export interface PrinterCatalogSettings {
92
+ /** Unveraendert als Teil der Geraete-Einstellungen sendbar (setMyRegisterDeviceSettings). */
93
+ readonly device: PrinterCatalogDeviceSettings;
94
+ /**
95
+ * Das Modell kann mehr als eine Papierbreite: `device.paperSize` ist dann nur die Werkseinstellung, und die Kasse
96
+ * bestaetigt die Breite beim ersten Einrichten mit einem Testdruck.
97
+ */
98
+ readonly paperSizeNeedsCheck: boolean;
99
+ }
100
+ /**
101
+ * Startbestand laut Spec connect-betrieb (Stufe 1), noch ohne Geraetetest und darum nicht freigegeben. Je Eintrag
102
+ * stehen die Werte ausgeschrieben, auch wo sie gleich sind: jeder ist eine eigene Aussage ueber ein Modell und wird
103
+ * einzeln freigegeben.
104
+ *
105
+ * Papierbreiten laut Epson-Datenblatt: TM-m30III, TM-m30II und TM-T20III lassen sich mit der beiliegenden
106
+ * Papierfuehrung auf 58 mm umstellen (dann 420 Punkte, Schrift A 35 Spalten; die Kasse setzt 32 Zeichen), der TM-m10
107
+ * kann nur 58 mm. Bestaetigt ist das erst mit dem Geraetetest.
108
+ *
109
+ * TM-T88VI und TM-T88VII drucken mit 180 dpi (512 Punkte auf 80 mm, Schrift A 42 Spalten); 48 Zeichen passen nicht.
110
+ * Sie bekommen darum das 58-mm-Layout der Kasse (32 Zeichen, die 384 Punkte von `GS W` passen in ihre 512), auch mit
111
+ * 80-mm-Papier, bis es eine Einstellung mit 42 Zeichen gibt.
112
+ */
113
+ export declare const PRINTER_CATALOG: readonly PrinterCatalogEntry[];
114
+ /**
115
+ * Normierter Modellname, die Hersteller aus `catalog`. `EPSON TM-m30III`, `TM-M30III` und `tm m30iii` ergeben
116
+ * `TM-M30III`; der Hersteller allein (`EPSON`) bleibt stehen.
117
+ */
118
+ export declare function normalizePrinterModel(model: string | null | undefined, catalog?: readonly PrinterCatalogEntry[]): string | null;
119
+ /**
120
+ * Der freigegebene Eintrag aus `catalog`, an dem `model` erkannt wird, sonst `null`. Ein nicht freigegebener Eintrag
121
+ * verhaelt sich wie ein unbekanntes Modell. Das Ergebnis ist eindeutig, weil kein Name in zwei Eintraegen steht
122
+ * (Prueffall `match_name_ambiguous`).
123
+ */
124
+ export declare function findPrinterCatalogEntry(catalog: readonly PrinterCatalogEntry[], model: string | null | undefined): PrinterCatalogEntry | null;
125
+ /**
126
+ * Der freigegebene Katalogeintrag zu einem Modellnamen, wie Connect ihn meldet (mDNS, `GS I`), oder `null` fuer ein
127
+ * unbekanntes Modell. Gross- und Kleinschreibung, ein vorangestelltes `EPSON` und die Art der Trenner zaehlen nicht.
128
+ * `undefined` ist erlaubt, weil Connect `model` im Fund weglaesst, wenn es keines kennt.
129
+ */
130
+ export declare function printerCatalogEntry(model: string | null | undefined): PrinterCatalogEntry | null;
131
+ /** Was ein Eintrag beim Einrichten vorschlaegt; `drawerKick` wird zu `drawerEnabled`. */
132
+ export declare function printerCatalogSettings(entry: PrinterCatalogEntry): PrinterCatalogSettings;
133
+ /**
134
+ * Was an einem Katalog nicht stimmt. Jeder Grund gehoert zu genau einem Feld des Eintrags, darum traegt ein Fund kein
135
+ * eigenes Feld. Reihenfolge = Reihenfolge der Pruefung je Eintrag.
136
+ */
137
+ export declare const PRINTER_CATALOG_PROBLEM_REASONS: readonly ["duplicate_id", "match_names_missing", "match_name_not_normalized", "match_name_ambiguous", "model_not_matched", "paper_sizes_invalid", "paper_size_not_listed", "paper_size_too_wide", "cut_not_allowed", "qr_mode_not_allowed", "chars_per_line_mismatch", "device_test_missing", "device_test_incomplete"];
138
+ export type PrinterCatalogProblemReason = typeof PRINTER_CATALOG_PROBLEM_REASONS[number];
139
+ /** Ein Fund der Pruefung: welcher Eintrag, welcher Grund. */
140
+ export interface PrinterCatalogProblem {
141
+ readonly id: string;
142
+ readonly reason: PrinterCatalogProblemReason;
143
+ }
144
+ /**
145
+ * Alle Funde in einem Katalog; leer = gueltig. Die einzige Stelle, an der die Regeln stehen. Der Test ruft sie fuer den
146
+ * ausgelieferten Katalog und die Prueffaelle; ein Fund macht ihn rot, statt zur Laufzeit still zu wirken.
147
+ */
148
+ export declare function printerCatalogProblems(catalog: readonly PrinterCatalogEntry[]): PrinterCatalogProblem[];