@kreiseck/kasseneck-api 1.3.0 → 1.5.0

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3.0",
+  "version": "1.5.0",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"
@@ -54,7 +54,34 @@
       "stripeCaptureIntent",
       "rotatePartnerWebhookSecret",
       "updateCustomer",
-      "updatePartnerWebhook"
+      "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"
     ],
     "pos": [
       "cancelReceipt",
@@ -148,7 +175,34 @@
       "getInvoiceItem",
       "listInvoiceItems",
       "setCustomerMandate",
-      "revokeCustomerMandate"
+      "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"
     ],
     "pos": [
       "pairRegisterDevice",
@@ -772,7 +826,12 @@
       "mixed_supply_not_allowed",
       "oss_not_enabled",
       "einvoice_unavailable",
-      "amount_too_large"
+      "amount_too_large",
+      "vat_id_invalid",
+      "vat_id_check_pending",
+      "reservation_not_found",
+      "reservation_mismatch",
+      "reservation_not_active"
     ],
     "invoiceLanguages": [
       "de",
@@ -788,7 +847,8 @@
     "invoiceNoticeCodes": [
       "cash_receipt_required",
       "recapitulative_statement_due",
-      "place_of_supply_check"
+      "place_of_supply_check",
+      "reservation_expired"
     ],
     "invoicePaymentMethods": [
       "transfer",
@@ -927,5 +987,246 @@
       "domesticReverseCharge",
       "outsideScope"
     ]
+  },
+  "inventory": {
+    "inventoryEndpoints": [
+      "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"
+    ],
+    "inventoryErrorCodes": [
+      "validation",
+      "invalid_cursor",
+      "article_not_found",
+      "webhook_not_found",
+      "webhook_limit",
+      "invalid_webhook_url",
+      "event_not_subscribed",
+      "webhook_inactive",
+      "inventory_api_not_enabled",
+      "module_inactive",
+      "rate_limited",
+      "server_error",
+      "idempotency_key_required",
+      "idempotency_conflict",
+      "location_not_found",
+      "location_inactive",
+      "invalid_location",
+      "invalid_locations",
+      "invalid_transfer",
+      "operation_not_found",
+      "already_reversed",
+      "reversal_not_possible",
+      "reversal_not_supported",
+      "exceeds_stock",
+      "no_positions",
+      "too_many_positions",
+      "invalid_step",
+      "invalid_quantity",
+      "invalid_amount",
+      "invalid_price",
+      "negative_value",
+      "invalid_reason",
+      "note_required",
+      "withdrawal_type_required",
+      "invalid_method",
+      "invalid_stock_kind",
+      "invalid_minimum",
+      "invalid_dimensions",
+      "weight_missing",
+      "invalid_landed_cost",
+      "invalid_distribution",
+      "landed_costs_mismatch",
+      "return_totals_mismatch",
+      "lot_not_found",
+      "invalid_serial",
+      "serial_required",
+      "serial_not_allowed",
+      "serial_already_exists",
+      "serial_not_in_stock",
+      "code_taken",
+      "external_id_taken",
+      "group_not_found",
+      "revenue_group_not_found",
+      "stock_kind_locked",
+      "article_inactive",
+      "invalid_position",
+      "invalid_condition",
+      "reason_required",
+      "insufficient_available",
+      "reservation_not_found",
+      "reservation_not_active"
+    ],
+    "inventoryRequestErrorCodes": [
+      "account_not_found",
+      "admin_required",
+      "api_not_approved",
+      "cashregister_not_assigned",
+      "cashregister_not_found",
+      "cashregister_token_invalid",
+      "cashregister_token_missing",
+      "dialect_mismatch",
+      "internal_translation_error",
+      "live_not_enabled",
+      "method_not_allowed",
+      "mfa_required",
+      "not_found",
+      "register_user_no_business",
+      "register_user_not_allowed",
+      "register_user_not_found",
+      "response_translation_failed",
+      "session_expired",
+      "session_other_cashregister",
+      "unauthorized",
+      "user_disabled",
+      "user_verification_failed",
+      "route_missing"
+    ],
+    "inventoryWarningCodes": [
+      "insufficient_stock",
+      "below_minimum",
+      "return_exceeds_sale",
+      "reservation_exceeded"
+    ],
+    "inventoryWebhookEnvelopeFields": [
+      "id",
+      "type",
+      "createdAt",
+      "accountId",
+      "test",
+      "data"
+    ],
+    "inventoryWebhookEvents": [
+      "stock.changed",
+      "stock.below_minimum",
+      "article.created",
+      "article.updated",
+      "article.deactivated",
+      "reservation.expired",
+      "reservation.released",
+      "reservation.redeemed"
+    ],
+    "landedCostAllocations": [
+      "value",
+      "quantity",
+      "weight",
+      "manual"
+    ],
+    "landedCostTypes": [
+      "freight",
+      "customs",
+      "insurance",
+      "other",
+      "discount",
+      "cash_discount"
+    ],
+    "locationTypes": [
+      "warehouse",
+      "store",
+      "vehicle",
+      "other"
+    ],
+    "reservationStatuses": [
+      "active",
+      "redeemed",
+      "released",
+      "expired"
+    ],
+    "stockChangeCauses": [
+      "sale",
+      "invoice",
+      "credit_note",
+      "cancellation",
+      "goods_receipt",
+      "transfer",
+      "loss",
+      "condition",
+      "reversal",
+      "reservation",
+      "stocktake",
+      "takeover",
+      "other"
+    ],
+    "stockConditions": [
+      "sellable",
+      "defective"
+    ],
+    "stockKinds": [
+      "quantity",
+      "serial"
+    ],
+    "stockLossReasons": [
+      "breakage",
+      "shrinkage",
+      "theft",
+      "expired",
+      "withdrawal",
+      "disposal",
+      "other"
+    ],
+    "stockMovementSources": [
+      "receipt",
+      "invoice",
+      "cancellation",
+      "credit_note",
+      "panel",
+      "register",
+      "api",
+      "stocktake",
+      "system"
+    ],
+    "stockMovementTypes": [
+      "sale",
+      "goods_receipt",
+      "loss",
+      "return",
+      "transfer_out",
+      "transfer_in",
+      "condition_out",
+      "condition_in",
+      "stocktake",
+      "adjustment",
+      "takeover",
+      "reversal",
+      "revaluation",
+      "method_change",
+      "reservation"
+    ],
+    "webhookDeliveryStatuses": [
+      "delivered",
+      "pending",
+      "failed",
+      "dropped"
+    ],
+    "withdrawalTypes": [
+      "private",
+      "staff",
+      "gift",
+      "sample"
+    ]
   }
 }

package/fixtures/v3/README.md

@@ -17,6 +17,7 @@ Erzeugt von Jest-Tests in zwei Codebases (jede übersetzt mit ihrem eigenen Rand
 | `functions/test/unit/v3-vertrag-export.test.js` | `v3-vokabular.json`, `antworten/belege.json`, `antworten/kasse-belege.json`, `antworten/storno.json`, `antworten/belegmail.json`, `antworten/rechnungen.json`, `stored/belege.json`, `stored/rechnungen.json`, `zahlbetrag-faelle.json` |
 | `functions/test/unit/v3-vertrag-export-kassenweg.test.js` | Teil `default` von `antworten/kasse.json` und `stored/kasse.json` (6 Beleg-Endpunkte der Kasse) |
 | `functions-kasse/test/unit/v3-vertrag-export.test.js` | Teil `kasse` derselben zwei Dateien (die übrigen 19 Kassen-Endpunkte) |
+| `functions-kasse/test/unit/v3-vertrag-export-lager.test.js` | `antworten/lager.json` (Lager-API, Stufe 5a) |
 
 Fest injiziert, damit zwei Läufe dieselben Bytes liefern: eine Uhr für alle Welten
 (26.09.2026 08:00 UTC), `crypto.randomBytes`/`randomUUID`, fortlaufende Dokument-IDs
@@ -46,6 +47,7 @@ bleiben verschieden:
 | `fullReceiptId` (auch im Text) | `000…0.000…0<8 hex>` |
 | `statusPassword`, Token in `statusUrl` (gespeichert: `public_password`, `public_token`) | `EXAM-<4 hex>`, `000…0<8 hex>` |
 | Kopplungscode (`code` bei `pairRegisterDevice`, `register_pairings/<CODE>`) | `EXMP<4 Zeichen>` (Alphabet ohne 0/1/I/O) |
+| Webhook-Secret (`secret` bei `createWebhook`/`rotateWebhookSecret`, auch im Text) | `whsec_EXAMPLE<8 hex>AAAA…` (38 Zeichen) |
 | ungültige Eingaben dieser Felder | `INVALID_EXAMPLE_<8 hex>` |
 
 In `stored/` stehen Schlüssel, Hashes und Salze als `<geheim>`. Ein Test prüft jede Datei
@@ -90,7 +92,7 @@ Code-Änderung zusammen einchecken.
     äußere Codes) und je Quelle: Rand (`edge`), Anmeldung (`auth`),
     `receiptMessages`, Kassen-Handler (`registerHandlers`, je Endpunkt in
     `registerHandlersByEndpoint`), Fälle der Kassen-Welt (`registerCases`), Storno,
-    Zahlungen, Belegmail, Rechnung, Partner. Jeder Code, der irgendwo in `antworten/`
+    Zahlungen, Belegmail, Rechnung, Partner, Lager-API (`inventory`). Jeder Code, der irgendwo in `antworten/`
     vorkommt, steht in `all` (Test).
   - `noticeCodes`: Hinweis-Codes (`notice[].code` der Rechnungs-API), keine Fehler.
   - `schemas`: je Endpunkt der Eintrag des Vokabulars (Notation außen → innen);
@@ -109,6 +111,12 @@ Code-Änderung zusammen einchecken.
   Liste, Storno, Gutschrift, Zahlung, Fehler).
 - **`antworten/kasse.json`**: alle 25 Kassen-Endpunkte unter `/api/v3`, je Fall
   (englischer Name) Methode, Aufrufer, Parameter, HTTP-Status, Kopfzeilen und Antwort.
+- **`antworten/lager.json`**: Lager-API unter `/v3` (Kanal `api`) in Ablaufreihenfolge an
+  einem Konto (Bäckerei Kornblum, Standort `haupt`): Artikel, Standorte, Bestand, Bewegungen,
+  mit und ohne Schalter `lagerApi.kosten`, Konto-Webhooks verwalten samt Fehlern
+  (`webhook_limit`, `rate_limited` der Tagesgrenze für Probesendungen …). Dazu
+  `webhookEvents`: die zugestellten Konto-Webhooks (`stock.changed`, `stock.below_minimum`,
+  `article.*`), Hülle wie gesendet.
 - **`stored/`**: die inneren Firestore-Dokumente (deutsch, ohne Geheimnisse), aus denen
   die Antworten entstanden; für `./stored` (gespeicherte Form → englisches Modell).
 - **`zahlbetrag-faelle.json`**: Rechenfälle für `receiptDueCents(items, vouchers,

package/fixtures/v3/antworten/belege.json

@@ -2,8 +2,8 @@
   "_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": "62e0d9891baa5049aa7634f11fcfd9a44d80b2cb8da79da4fee13140ccd96c2a",
-    "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
+    "inputsSha256": "b9dd3d819a4be22c35a201a788e7fcf947d90b6af7d9e41d3d74be3b48f8aa8e",
+    "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
     "inputs": [
       "docs/api/fehlercodes.json",
       "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",

package/fixtures/v3/antworten/belegmail.json

@@ -2,8 +2,8 @@
   "_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": "62e0d9891baa5049aa7634f11fcfd9a44d80b2cb8da79da4fee13140ccd96c2a",
-    "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
+    "inputsSha256": "b9dd3d819a4be22c35a201a788e7fcf947d90b6af7d9e41d3d74be3b48f8aa8e",
+    "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
     "inputs": [
       "docs/api/fehlercodes.json",
       "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",

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

@@ -2,8 +2,8 @@
   "_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": "62e0d9891baa5049aa7634f11fcfd9a44d80b2cb8da79da4fee13140ccd96c2a",
-    "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
+    "inputsSha256": "b9dd3d819a4be22c35a201a788e7fcf947d90b6af7d9e41d3d74be3b48f8aa8e",
+    "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
     "inputs": [
       "docs/api/fehlercodes.json",
       "functions-kasse/test/unit/fixtures/kassen-codes-v3.js",

package/fixtures/v3/antworten/kasse.json

@@ -4,8 +4,8 @@
     "default": {
       "sha256": "bf1e7c100e328517c72d5badf31904183efe22d1fddec308e2fe2722068854bc",
       "head": [],
-      "inputsSha256": "6aae196464196c3abcfb6afed5fb78a99d8c067c79247ca442badf2471e39ddc",
-      "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
+      "inputsSha256": "3a500a9049bc0b7b3955d14e4df69e7c690270bdd6a31071c2ef50f08a9b30cb",
+      "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
       "inputs": [
         "functions-kasse/test/unit/fixtures/kassen-welt.js",
         "functions/gemeinsam/api-rand.js",
@@ -24,7 +24,7 @@
         "channel",
         "note"
       ],
-      "inputsSha256": "b7483cf62e025b0c980b90d013c81c88a99f7acdeaf70f510a7554329ee19285",
+      "inputsSha256": "d1a29138f9bfdb32a861df2bc101f5be672e182c1387aa4f8f1786ab8de8fcc1",
       "backendPackage": "@kreiseck/kasseneck-api@0.14.0",
       "inputs": [
         "functions-kasse/gemeinsam/api-rand.js",