@kreiseck/kasseneck-api 1.10.1 → 1.11.1

package/fixtures/receipt-due-generated.json

@@ -2,7 +2,7 @@
   "_note": "Erzeugt von scripts/v3-zahlbetrag-generieren.mjs mit dem echten Backend-Code. Nicht von Hand pflegen.",
   "_source": {
     "beleg-toepfe.js": "60630493a589469d1cdfeea6fef667d20feb8f3a156819ba4d90b21501fdc4ea",
-    "tip-core.js": "b9bd6e6d8f10c3568fe586bd85dfa392effa37a76ad7e0179890f5f05b433910",
+    "tip-core.js": "2d5b65c3cbe96935c8537d35f02b30906a7477afa340e18325b60bd60af1c7d9",
     "zahlungen-core.js": "741ef265dbb864a3efdfead81605aa875afad7ae8ca05fb9c71390f1379bae4f",
     "vat-buckets.js": "92c69632c0120dbb09a22cef5a36b052e81605d99907eeda7289b0d3db78454c"
   },

package/fixtures/shift-cases.json

@@ -0,0 +1,87 @@
+{
+  "_note": "Shared cases for the shift helpers (npm @kreiseck/kasseneck-api and Dart kasseneck_api): sumDenominations (cents value as key, count as value; null = not a valid count) and parseCentsAllowZero (typed amount -> cents; null = invalid input) and shiftTipLines (tips of one employee -> lines; carried over from earlier shifts first, only when not 0; earned = received immediately + retained, always shown; retained, paid out, refunded by the employee herself and open only when not 0; everything 0 -> no lines). Never round, never guess.",
+  "sumDenominations": [
+    { "denominations": {}, "expected": 0 },
+    { "denominations": { "100": 1, "200": 1, "500": 1, "2000": 1 }, "expected": 2800 },
+    { "denominations": { "2000": 2, "5000": 1, "20000": 1 }, "expected": 29000 },
+    { "denominations": { "1": 3, "2": 1, "5": 4 }, "expected": 25 },
+    { "denominations": { "50000": 2 }, "expected": 100000 },
+    { "denominations": { "1000": 0, "500": 0 }, "expected": 0 },
+    { "denominations": { "10000": 100000 }, "expected": 1000000000 },
+    { "denominations": { "300": 1 }, "expected": null },
+    { "denominations": { "0": 1 }, "expected": null },
+    { "denominations": { "100000": 1 }, "expected": null },
+    { "denominations": { "1000": -1 }, "expected": null },
+    { "denominations": { "1000": 1.5 }, "expected": null },
+    { "denominations": { "1000": "2" }, "expected": null },
+    { "denominations": { "1000": 100001 }, "expected": null },
+    { "denominations": { "10.00": 1 }, "expected": null },
+    { "denominations": { "0500": 1 }, "expected": null },
+    { "denominations": { "": 1 }, "expected": null },
+    { "denominations": null, "expected": null },
+    { "denominations": [], "expected": null }
+  ],
+  "parseCentsAllowZero": [
+    { "text": "0", "expected": 0 },
+    { "text": "0,00", "expected": 0 },
+    { "text": "0.0", "expected": 0 },
+    { "text": "1", "expected": 100 },
+    { "text": "12", "expected": 1200 },
+    { "text": "12,5", "expected": 1250 },
+    { "text": "12.5", "expected": 1250 },
+    { "text": "12,05", "expected": 1205 },
+    { "text": "0,01", "expected": 1 },
+    { "text": " 290,00 ", "expected": 29000 },
+    { "text": "1000", "expected": 100000 },
+    { "text": "007", "expected": 700 },
+    { "text": "", "expected": null },
+    { "text": "   ", "expected": null },
+    { "text": ",50", "expected": null },
+    { "text": "12,", "expected": null },
+    { "text": "12,345", "expected": null },
+    { "text": "1.000", "expected": null },
+    { "text": "1.000,00", "expected": null },
+    { "text": "1 000", "expected": null },
+    { "text": "-5", "expected": null },
+    { "text": "+5", "expected": null },
+    { "text": "1e3", "expected": null },
+    { "text": "12,5 €", "expected": null },
+    { "text": "€ 12", "expected": null },
+    { "text": "abc", "expected": null },
+    { "text": "99999999999999999999", "expected": null }
+  ],
+  "shiftTipLines": [
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": 400, "retainedCents": 0, "paidOutCents": 0, "openCents": 400 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": 400 }, { "key": "shift_receipt.tip_open", "cents": 400 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": 400, "retainedCents": 150, "paidOutCents": 250, "openCents": 150 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": 550 }, { "key": "shift_receipt.tip_retained", "cents": 150 }, { "key": "shift_receipt.tip_paid_out", "cents": 250 }, { "key": "shift_receipt.tip_open", "cents": 150 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": 400, "retainedCents": 0, "paidOutCents": 400, "openCents": 0 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": 400 }, { "key": "shift_receipt.tip_paid_out", "cents": 400 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Anna Chef", "receivedImmediatelyCents": 0, "retainedCents": 0, "paidOutCents": 0, "openCents": 300 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": 0 }, { "key": "shift_receipt.tip_open", "cents": 300 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": 0, "retainedCents": 250, "paidOutCents": 0, "openCents": 0 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": 250 }, { "key": "shift_receipt.tip_retained", "cents": 250 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": 0, "retainedCents": 0, "paidOutCents": 0, "openCents": 0 }, "expected": [] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": -200, "retainedCents": 0, "paidOutCents": 0, "openCents": 0 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": -200 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": 200, "retainedCents": -200, "paidOutCents": 0, "openCents": 0 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": 0 }, { "key": "shift_receipt.tip_retained", "cents": -200 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": 0, "retainedCents": 0, "paidOutCents": 150, "openCents": -150 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": 0 }, { "key": "shift_receipt.tip_paid_out", "cents": 150 }, { "key": "shift_receipt.tip_open", "cents": -150 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": 400, "retainedCents": 0, "paidOutCents": 0, "refundedByEmployeeCents": 200, "openCents": 600 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": 400 }, { "key": "shift_receipt.tip_refunded_by_employee", "cents": 200 }, { "key": "shift_receipt.tip_open", "cents": 600 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "receivedImmediatelyCents": 400, "retainedCents": 0, "paidOutCents": 300, "refundedByEmployeeCents": 200, "openCents": 300 }, "expected": [{ "key": "shift_receipt.tip_earned", "cents": 400 }, { "key": "shift_receipt.tip_paid_out", "cents": 300 }, { "key": "shift_receipt.tip_refunded_by_employee", "cents": 200 }, { "key": "shift_receipt.tip_open", "cents": 300 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "carriedOverCents": 600, "receivedImmediatelyCents": 900, "retainedCents": 0, "paidOutCents": 0, "refundedByEmployeeCents": 0, "openCents": 1500 }, "expected": [{ "key": "shift_receipt.tip_carried_over", "cents": 600 }, { "key": "shift_receipt.tip_earned", "cents": 900 }, { "key": "shift_receipt.tip_open", "cents": 1500 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "carriedOverCents": 600, "receivedImmediatelyCents": 900, "retainedCents": 0, "paidOutCents": 1000, "refundedByEmployeeCents": 0, "openCents": 500 }, "expected": [{ "key": "shift_receipt.tip_carried_over", "cents": 600 }, { "key": "shift_receipt.tip_earned", "cents": 900 }, { "key": "shift_receipt.tip_paid_out", "cents": 1000 }, { "key": "shift_receipt.tip_open", "cents": 500 }] },
+    { "tip": { "registerUserId": "ru_kellner", "name": "Ben Kellner", "carriedOverCents": 600, "receivedImmediatelyCents": 700, "retainedCents": 0, "paidOutCents": 1000, "refundedByEmployeeCents": 200, "openCents": 500 }, "expected": [{ "key": "shift_receipt.tip_carried_over", "cents": 600 }, { "key": "shift_receipt.tip_earned", "cents": 700 }, { "key": "shift_receipt.tip_paid_out", "cents": 1000 }, { "key": "shift_receipt.tip_refunded_by_employee", "cents": 200 }, { "key": "shift_receipt.tip_open", "cents": 500 }] }
+  ],
+  "durationText": [
+    { "minutes": 0, "expected": "0 Min." },
+    { "minutes": 1, "expected": "1 Min." },
+    { "minutes": 59, "expected": "59 Min." },
+    { "minutes": 60, "expected": "1 Std." },
+    { "minutes": 61, "expected": "1 Std. 1 Min." },
+    { "minutes": 512, "expected": "8 Std. 32 Min." },
+    { "minutes": 480, "expected": "8 Std." },
+    { "minutes": 1439, "expected": "23 Std. 59 Min." },
+    { "minutes": 1440, "expected": "1 Tag" },
+    { "minutes": 1500, "expected": "1 Tag 1 Std." },
+    { "minutes": 1620, "expected": "1 Tag 3 Std." },
+    { "minutes": 2880, "expected": "2 Tage" },
+    { "minutes": 2940, "expected": "2 Tage 1 Std." },
+    { "minutes": 10080, "expected": "7 Tage" },
+    { "minutes": -5, "expected": "0 Min." },
+    { "minutes": 90.9, "expected": "1 Std. 30 Min." }
+  ]
+}

package/fixtures/shift-receipts.json

@@ -0,0 +1,41 @@
+{
+  "_note": "Shift receipts (Z, X, cash movement) as line model: name -> contract case in fixtures/v3/antworten/kasse.json (endpoint/case, input = data.receipt), SHA-256 of fixtures/expected/<name>.lines.json and of the 32/48 character grids. Generated by scripts/belege-fixtures.mjs (npm run fixtures:erneuern), never edit by hand.",
+  "receipts": {
+    "shift-close": {
+      "source": "closeMyShift/success_manager",
+      "expected": "b12b8f83a3c5031480446ff0ce75aa8f9c413771a6f8a958a98217c59b7c0143",
+      "grid32": "5eff96c8e2f555add929d0575a17f8e13bcb1eb726a8d1f2341c0b8a69df4527",
+      "grid48": "fde16a05fa94b285db310247b7898d011c6ffa0cbacdde9cc516e75303cfddb5"
+    },
+    "shift-close-blind": {
+      "source": "closeMyShift/success_cashier_blind",
+      "expected": "d11ea9f23752b764e37a136f19b92f93df3e1c67c36d9097c0c47ecfa394a9f8",
+      "grid32": "9f638ea9429289670e7b8e741318d8207fdb0588b6fd2e0f641cd6ce60771e30",
+      "grid48": "333485ed87cd9570655372fc1bfceb576871fe844e981f3803de80e74979ed1a"
+    },
+    "shift-close-take-out": {
+      "source": "closeMyShift/success_manager_take_out",
+      "expected": "1d5b06a8df55ea620ea7c97ecefb050b61c08c76e9b7af263951ef454ef848d9",
+      "grid32": "a219bd3816c36359909ee7bc09897849107ae9f33b0aaf4b90d1e38caef2919a",
+      "grid48": "e2ccec9e7d0e21535f43f7ca8d46f0a750fe176ec22afa7e20fa314e0de7a7d3"
+    },
+    "shift-close-put-in": {
+      "source": "closeMyShift/success_manager_put_in",
+      "expected": "f08d7a9dff4dafd87412dc57fa92a876e76ba3a8612bf89ad44cca12481d6282",
+      "grid32": "e77cbbc07a20fb560fcc2dcdcb93179bc70f5fbf543016db55fc2ec83e8a36ed",
+      "grid48": "e76bad8f7b6ac9b02a1818fc669e5a751a2dc7f205018b202317b772540cff05"
+    },
+    "shift-interim": {
+      "source": "getMyShiftReport/success_manager",
+      "expected": "9d8f2868d4c2d46f7f3be823873a7744e5e4d217b51cbd2d02cbc43842af6103",
+      "grid32": "263aa7140ac646d783ba6d68993fac323b801344b6980ea54e5c2df2debc144a",
+      "grid48": "75c1983043ed746c6e9576a726f1db963f37c1c83c08d6e3dc6b726d62f0f27e"
+    },
+    "cash-movement": {
+      "source": "recordMyCashMovement/success_manager_cash_drop",
+      "expected": "4a0bbafd9e56cc05189dab609fcf9afde3d782527281295b7259d49c18fcdd2f",
+      "grid32": "7e93c4f3901c322200b5ce76edf049e1e75f91a038f54270a40e36d9b0b52283",
+      "grid48": "37a345abff84ae4ee1207d2c8f3bb0fa785bcd070edc9e194810721aa6e125c9"
+    }
+  }
+}

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.10.1",
+  "version": "1.11.1",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"
@@ -134,7 +134,13 @@
       "listMyStocktakeItems",
       "listMyStocktakeCounts",
       "recordMyStocktakeCount",
-      "voidMyStocktakeCount"
+      "voidMyStocktakeCount",
+      "getMyDrawerState",
+      "openMyShift",
+      "recordMyCashMovement",
+      "logMyDrawerOpenings",
+      "getMyShiftReport",
+      "closeMyShift"
     ]
   },
   "routes": {
@@ -278,7 +284,13 @@
       "listMyStocktakeItems",
       "listMyStocktakeCounts",
       "recordMyStocktakeCount",
-      "voidMyStocktakeCount"
+      "voidMyStocktakeCount",
+      "getMyDrawerState",
+      "openMyShift",
+      "recordMyCashMovement",
+      "logMyDrawerOpenings",
+      "getMyShiftReport",
+      "closeMyShift"
     ]
   },
   "unknownOutcomeCalls": [
@@ -288,6 +300,7 @@
     "cancelReceipt",
     "cancelStocktake",
     "changeStockCondition",
+    "closeMyShift",
     "closeStocktake",
     "createArticle",
     "createCreditNote",
@@ -310,9 +323,12 @@
     "hobexPayApi",
     "hobexRefundApi",
     "issueInvoice",
+    "logMyDrawerOpenings",
+    "openMyShift",
     "pairRegisterDevice",
     "receiveGoods",
     "recordInvoicePayment",
+    "recordMyCashMovement",
     "recordMyStocktakeCount",
     "recordStockLoss",
     "recordStocktakeCount",
@@ -526,6 +542,7 @@
   ],
   "registerErrorCodes": [
     "account_not_found",
+    "action_confirmation_required",
     "admin_required",
     "api_not_approved",
     "app_check_invalid",
@@ -561,6 +578,7 @@
     "register_user_not_found",
     "register_user_only",
     "response_translation_failed",
+    "second_factor_required",
     "session_ended",
     "session_expired",
     "session_not_running",
@@ -591,6 +609,10 @@
     "splitPayment"
   ],
   "pos": {
+    "afterCountTypes": [
+      "cash_drop",
+      "change_in"
+    ],
     "callsWithEffect": [
       "createReceipt",
       "cancelReceipt",
@@ -601,27 +623,103 @@
       "createPrintJob",
       "sendReceiptEmail"
     ],
+    "cashLocations": [
+      "bank",
+      "safe"
+    ],
+    "eurDenominations": [
+      50000,
+      20000,
+      10000,
+      5000,
+      2000,
+      1000,
+      500,
+      200,
+      100,
+      50,
+      20,
+      10,
+      5,
+      2,
+      1
+    ],
+    "manualMovementTypes": [
+      "change_in",
+      "cash_drop",
+      "owner_deposit",
+      "owner_withdrawal",
+      "tip_payout",
+      "other_in",
+      "other_out",
+      "transfer_out"
+    ],
+    "manualOpeningReasons": [
+      "change",
+      "check",
+      "misoperation",
+      "other"
+    ],
+    "movementTypes": [
+      "change_in",
+      "cash_drop",
+      "owner_deposit",
+      "owner_withdrawal",
+      "tip_payout",
+      "other_in",
+      "other_out",
+      "transfer_out",
+      "transfer_in",
+      "expense",
+      "count_difference",
+      "handover_difference"
+    ],
+    "openingReasons": [
+      "sale",
+      "cash_movement",
+      "shift_open",
+      "shift_close",
+      "change",
+      "check",
+      "misoperation",
+      "other"
+    ],
+    "posBusinessOptionalFields": [
+      "tipKeptByDefault"
+    ],
+    "posDeviceOptionalFields": [
+      "drawerId"
+    ],
     "posErrorCodes": [
       "account_not_found",
+      "action_confirmation_required",
       "admin_required",
+      "after_count_not_permitted",
       "api_not_approved",
       "app_check_invalid",
       "app_check_missing",
       "article_not_found",
       "article_not_in_scope",
       "article_not_tracked",
+      "cash_movement_exceeds_balance",
       "cashregister_not_assigned",
       "cashregister_not_found",
       "cashregister_token_invalid",
       "cashregister_token_missing",
+      "comment_required",
       "count_already_voided",
       "count_not_found",
       "device_not_found",
       "dialect_mismatch",
+      "drawer_inactive",
+      "drawer_not_found",
       "idempotency_conflict",
       "idempotency_key_required",
       "internal_translation_error",
+      "invalid_amount",
       "invalid_cursor",
+      "invalid_denominations",
+      "invalid_movement_type",
       "invalid_quantity",
       "invalid_serial",
       "live_not_enabled",
@@ -635,25 +733,34 @@
       "module_inactive",
       "not_found",
       "not_permitted",
+      "note_required",
       "password_change_required",
       "print_job_not_found",
       "print_layout_failed",
       "printer_not_found",
+      "recount_exhausted",
       "register_user_no_business",
       "register_user_not_allowed",
       "register_user_not_found",
       "response_translation_failed",
+      "second_factor_required",
       "serial_already_counted",
       "serial_not_allowed",
       "serial_required",
       "server_error",
       "session_expired",
       "session_other_cashregister",
+      "shift_already_open",
+      "shift_closed",
+      "shift_mode_off",
+      "shift_not_open",
       "stocktake_closed",
       "stocktake_closing",
       "stocktake_not_found",
       "stocktake_not_open",
+      "tip_payout_exceeds_claim",
       "too_many_counts",
+      "transfer_same_drawer",
       "unauthorized",
       "user_disabled",
       "user_verification_failed",
@@ -680,6 +787,11 @@
       "defective",
       "disposed"
     ],
+    "shiftReceiptKinds": [
+      "shift_close",
+      "shift_interim",
+      "cash_movement"
+    ],
     "stockLocationTypes": [
       "warehouse",
       "store",
@@ -994,6 +1106,7 @@
     ],
     "invoiceRequestErrorCodes": [
       "account_not_found",
+      "action_confirmation_required",
       "admin_required",
       "api_not_approved",
       "app_check_invalid",
@@ -1013,6 +1126,7 @@
       "register_user_not_allowed",
       "register_user_not_found",
       "response_translation_failed",
+      "second_factor_required",
       "session_expired",
       "session_other_cashregister",
       "unauthorized",
@@ -1259,6 +1373,7 @@
     ],
     "inventoryRequestErrorCodes": [
       "account_not_found",
+      "action_confirmation_required",
       "admin_required",
       "api_not_approved",
       "app_check_invalid",
@@ -1278,6 +1393,7 @@
       "register_user_not_allowed",
       "register_user_not_found",
       "response_translation_failed",
+      "second_factor_required",
       "session_expired",
       "session_other_cashregister",
       "unauthorized",

package/fixtures/v3/antworten/belege.json

@@ -2,7 +2,7 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "sha256": "61892b91e6a8a0f273dcfdeb63809d92d98fb837a3c0baa782f03b29dd3b8b7a",
-    "inputsSha256": "055d351ec81c75c91de099983372701eda34a9b8f53487ea30a21bca2a5d465f",
+    "inputsSha256": "95fd7b1f3704811d3a3f79b1dbb6aea668e8c0e3a663e5b0ca9c07f2e11e37b5",
     "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/antworten/belegmail.json

@@ -2,7 +2,7 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "sha256": "265bcf3e14cdea33ec3c4df399eb487d40c0d7793ee23d2ee12bcf664bcad550",
-    "inputsSha256": "055d351ec81c75c91de099983372701eda34a9b8f53487ea30a21bca2a5d465f",
+    "inputsSha256": "95fd7b1f3704811d3a3f79b1dbb6aea668e8c0e3a663e5b0ca9c07f2e11e37b5",
     "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/antworten/kasse-belege.json

@@ -2,7 +2,7 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "sha256": "aad7147db385e4a6d88ba5fb59d24c04e7e1f01195778aa70ccdc68fb90adcd7",
-    "inputsSha256": "055d351ec81c75c91de099983372701eda34a9b8f53487ea30a21bca2a5d465f",
+    "inputsSha256": "95fd7b1f3704811d3a3f79b1dbb6aea668e8c0e3a663e5b0ca9c07f2e11e37b5",
     "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
     "inputs": [
       "docs/api/fehlercodes.json",