@kreiseck/kasseneck-api 1.28.0 → 1.30.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 (122) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +111 -0
  3. package/dist/cjs/client/api.d.ts +15 -0
  4. package/dist/cjs/client/api.js +8 -0
  5. package/dist/cjs/client/aufrufe.d.ts +3 -3
  6. package/dist/cjs/client/aufrufe.js +28 -0
  7. package/dist/cjs/client/index.d.ts +1 -0
  8. package/dist/cjs/client/index.js +17 -1
  9. package/dist/cjs/client/list-receipts.d.ts +5 -0
  10. package/dist/cjs/client/list-receipts.js +5 -1
  11. package/dist/cjs/client/receipts.d.ts +6 -0
  12. package/dist/cjs/client/receipts.js +1 -0
  13. package/dist/cjs/client/terminal.d.ts +206 -0
  14. package/dist/cjs/client/terminal.js +288 -0
  15. package/dist/cjs/enums/voucher-type.d.ts +5 -1
  16. package/dist/cjs/enums/voucher-type.js +5 -1
  17. package/dist/cjs/index.d.ts +2 -2
  18. package/dist/cjs/index.js +28 -4
  19. package/dist/cjs/inventory/index.d.ts +2 -2
  20. package/dist/cjs/inventory/index.js +3 -2
  21. package/dist/cjs/inventory/typen.d.ts +39 -1
  22. package/dist/cjs/inventory/vertrag.d.ts +13 -2
  23. package/dist/cjs/inventory/vertrag.js +16 -1
  24. package/dist/cjs/inventory/webhook.d.ts +3 -0
  25. package/dist/cjs/inventory/webhook.js +39 -0
  26. package/dist/cjs/models/index.d.ts +1 -1
  27. package/dist/cjs/models/index.js +10 -2
  28. package/dist/cjs/models/voucher.d.ts +78 -2
  29. package/dist/cjs/models/voucher.js +127 -5
  30. package/dist/cjs/pos/gutschein.d.ts +13 -0
  31. package/dist/cjs/pos/gutschein.js +5 -1
  32. package/dist/cjs/pos/index.d.ts +1 -1
  33. package/dist/cjs/pos/index.js +3 -2
  34. package/dist/cjs/pos/texte.d.ts +20 -0
  35. package/dist/cjs/pos/texte.js +11 -0
  36. package/dist/cjs/receipt/due.d.ts +8 -1
  37. package/dist/cjs/receipt/due.js +1 -0
  38. package/dist/cjs/receipt/gutschein-plan.d.ts +11 -1
  39. package/dist/cjs/receipt/gutschein-plan.js +116 -1
  40. package/dist/cjs/receipt/layout.js +39 -6
  41. package/dist/cjs/stored/draht.js +5 -0
  42. package/dist/cjs/stored/vokabular.d.ts +3 -1
  43. package/dist/cjs/stored/vokabular.js +15 -2
  44. package/dist/cjs/version.d.ts +1 -1
  45. package/dist/cjs/version.js +1 -1
  46. package/dist/esm/client/api.d.ts +15 -0
  47. package/dist/esm/client/api.js +8 -0
  48. package/dist/esm/client/aufrufe.d.ts +3 -3
  49. package/dist/esm/client/aufrufe.js +28 -0
  50. package/dist/esm/client/index.d.ts +1 -0
  51. package/dist/esm/client/index.js +1 -0
  52. package/dist/esm/client/list-receipts.d.ts +5 -0
  53. package/dist/esm/client/list-receipts.js +5 -2
  54. package/dist/esm/client/receipts.d.ts +6 -0
  55. package/dist/esm/client/receipts.js +1 -0
  56. package/dist/esm/client/terminal.d.ts +206 -0
  57. package/dist/esm/client/terminal.js +278 -0
  58. package/dist/esm/enums/voucher-type.d.ts +5 -1
  59. package/dist/esm/enums/voucher-type.js +5 -1
  60. package/dist/esm/index.d.ts +2 -2
  61. package/dist/esm/index.js +2 -2
  62. package/dist/esm/inventory/index.d.ts +2 -2
  63. package/dist/esm/inventory/index.js +1 -1
  64. package/dist/esm/inventory/typen.d.ts +39 -1
  65. package/dist/esm/inventory/vertrag.d.ts +13 -2
  66. package/dist/esm/inventory/vertrag.js +15 -0
  67. package/dist/esm/inventory/webhook.d.ts +3 -0
  68. package/dist/esm/inventory/webhook.js +39 -0
  69. package/dist/esm/models/index.d.ts +1 -1
  70. package/dist/esm/models/index.js +1 -1
  71. package/dist/esm/models/voucher.d.ts +78 -2
  72. package/dist/esm/models/voucher.js +122 -4
  73. package/dist/esm/pos/gutschein.d.ts +13 -0
  74. package/dist/esm/pos/gutschein.js +4 -0
  75. package/dist/esm/pos/index.d.ts +1 -1
  76. package/dist/esm/pos/index.js +1 -1
  77. package/dist/esm/pos/texte.d.ts +20 -0
  78. package/dist/esm/pos/texte.js +11 -0
  79. package/dist/esm/receipt/due.d.ts +8 -1
  80. package/dist/esm/receipt/due.js +1 -0
  81. package/dist/esm/receipt/gutschein-plan.d.ts +11 -1
  82. package/dist/esm/receipt/gutschein-plan.js +117 -2
  83. package/dist/esm/receipt/layout.js +40 -7
  84. package/dist/esm/stored/draht.js +6 -1
  85. package/dist/esm/stored/vokabular.d.ts +3 -1
  86. package/dist/esm/stored/vokabular.js +14 -1
  87. package/dist/esm/version.d.ts +1 -1
  88. package/dist/esm/version.js +1 -1
  89. package/fixtures/expected/voucher-external-redeem.grid32.txt +30 -0
  90. package/fixtures/expected/voucher-external-redeem.grid48.txt +27 -0
  91. package/fixtures/expected/voucher-external-redeem.lines.json +280 -0
  92. package/fixtures/expected/voucher-external-redeem.sheet32.json +206 -0
  93. package/fixtures/expected/voucher-external-redeem.sheet48.json +188 -0
  94. package/fixtures/expected/voucher-external-sale.grid32.txt +27 -0
  95. package/fixtures/expected/voucher-external-sale.grid48.txt +26 -0
  96. package/fixtures/expected/voucher-external-sale.lines.json +256 -0
  97. package/fixtures/expected/voucher-external-sale.sheet32.json +188 -0
  98. package/fixtures/expected/voucher-external-sale.sheet48.json +182 -0
  99. package/fixtures/hobex-hps-codes.json +1 -1
  100. package/fixtures/invoice-api.schema.json +1 -1
  101. package/fixtures/invoice-texts.json +1 -1
  102. package/fixtures/manifest.json +16 -0
  103. package/fixtures/pos-texts.json +22 -2
  104. package/fixtures/receipt-due-voucher-generated.json +2 -2
  105. package/fixtures/receipts/voucher-external-redeem.json +85 -0
  106. package/fixtures/receipts/voucher-external-sale.json +80 -0
  107. package/fixtures/stored/voucher-cases.json +2800 -0
  108. package/fixtures/surface.json +32 -4
  109. package/fixtures/v3/antworten/belege.json +4 -3
  110. package/fixtures/v3/antworten/belegmail.json +2 -2
  111. package/fixtures/v3/antworten/berichte.json +2 -2
  112. package/fixtures/v3/antworten/kasse-belege.json +4 -3
  113. package/fixtures/v3/antworten/kasse.json +16 -10
  114. package/fixtures/v3/antworten/lager.json +6 -3
  115. package/fixtures/v3/antworten/rechnungen.json +2 -2
  116. package/fixtures/v3/antworten/storno.json +2 -2
  117. package/fixtures/v3/stored/belege.json +2 -2
  118. package/fixtures/v3/stored/kasse.json +3 -3
  119. package/fixtures/v3/stored/rechnungen.json +2 -2
  120. package/fixtures/v3/v3-vokabular.json +222 -10
  121. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  122. package/package.json +1 -1
@@ -21,5 +21,5 @@ export { changeStockCondition, createArticle, createReservation, deactivateArtic
21
21
  export { addVariant, createVariantGroup, getVariantGroup, iterateVariantGroups, listVariantGroups, updateVariantGroup, } from './varianten.js';
22
22
  export { cancelStocktake, closeStocktake, createStocktake, getStocktake, getStocktakePdf, iterateStocktakeCounts, iterateStocktakeItems, iterateStocktakes, listStocktakeCounts, listStocktakeItems, listStocktakes, recordStocktakeCount, recountStocktake, reviewStocktake, voidStocktakeCount, } from './inventur.js';
23
23
  export { verifyInventoryWebhookSignature, parseInventoryWebhookEvent, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, type VerifyInventoryWebhookOptions, } from './webhook.js';
24
- export type { AddVariantRequest, Article, CancelStocktakeRequest, CloseStocktakeRequest, CloseStocktakeResult, CreateStocktakeRequest, RecordStocktakeCountRequest, RecountStocktakeRequest, ReviewStocktakeRequest, Stocktake, StocktakeActor, StocktakeCancellation, StocktakeClosing, StocktakeCount, StocktakeCountListQuery, StocktakeCountPage, StocktakeCountResult, StocktakeInventoryLine, StocktakeItem, StocktakeItemListQuery, StocktakeItemPage, StocktakeListQuery, StocktakeNotBooked, StocktakePage, StocktakePdf, StocktakePdfDownload, StocktakePdfInfo, StocktakeProgress, StocktakeRecount, StocktakeReview, StocktakeScope, StocktakeScopeInput, StocktakeSeal, StocktakeTotals, StocktakeWarning, VoidStocktakeCountRequest, ArticleInput, ArticleListQuery, ArticleLookup, ArticlePage, ChangeStockConditionRequest, CreateArticleRequest, CreateInventoryWebhookOptions, CreateReservationRequest, CreateVariantGroupRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptItem, GoodsReceiptPreview, GoodsReceiptPreviewLine, GoodsReceiptPreviewRequest, InventoryShortfall, InventoryWarning, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookEnvelope, InventoryWebhookEvent, InventoryWebhookList, InventoryWebhookPatch, InventoryWebhookTestDelivery, InventoryWebhookTestResult, InventoryWebhookWithSecret, LandedCost, Location, LocationAddress, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationItem, ReleaseReservationRequest, Reservation, ReservationItem, ReservationItemInput, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockBelowMinimumEventData, StockChangedEventData, StockItem, StockLevel, StockListQuery, StockMovement, StockMovementLot, StockMovementPage, StockMovementQuery, StockMovementSourceRef, StockOperation, StockPage, StockResult, StockValue, TransferStockRequest, UpdateArticleRequest, UpdateVariantGroupRequest, VariantAttribute, VariantGroup, VariantGroupDefaults, VariantGroupDefaultsInput, VariantGroupListQuery, VariantGroupMember, VariantGroupPage, VariantInput, } from './typen.js';
25
- export { INVENTORY_ENDPOINTS, INVENTORY_ERROR_CODES, INVENTORY_REQUEST_ERROR_CODES, INVENTORY_WEBHOOK_EVENTS, INVENTORY_WEBHOOK_ENVELOPE_FIELDS, INVENTORY_WEBHOOK_LIMIT, INVENTORY_LIST_LIMIT_MAX, LOCATION_TYPES, STOCK_MOVEMENT_TYPES, STOCK_MOVEMENT_SOURCES, STOCK_CONDITIONS, STOCK_CHANGE_CAUSES, WEBHOOK_DELIVERY_STATUSES, INVENTORY_WARNING_CODES, STOCK_KINDS, STOCK_LOSS_REASONS, WITHDRAWAL_TYPES, LANDED_COST_TYPES, LANDED_COST_ALLOCATIONS, RESERVATION_STATUSES, INVENTORY_IDEMPOTENCY_KEY_MAX, RESERVATION_MINUTES_MIN, RESERVATION_MINUTES_MAX, VARIANT_ATTRIBUTES_MAX, VARIANT_VALUES_MAX, VARIANT_MATRIX_MAX, VARIANT_GROUP_ACTIVE_MAX, STOCKTAKE_STATUSES, STOCKTAKE_TYPES, STOCKTAKE_SCOPE_TYPES, STOCKTAKE_CHECK_REASONS, STOCKTAKE_NOT_BOOKED_REASONS, STOCKTAKE_SOURCES, STOCKTAKE_ACTOR_TYPES, STOCKTAKE_INVENTORY_AS_OF, STOCKTAKE_ITEMS_MAX, STOCKTAKE_RECOUNT_ITEMS_MAX, STOCKTAKE_COUNTS_PER_ITEM_MAX, type StocktakeStatus, type StocktakeType, type StocktakeScopeType, type StocktakeCheckReason, type StocktakeNotBookedReason, type StocktakeSource, type StocktakeActorType, type StocktakeInventoryAsOf, type InventoryEndpoint, type InventoryErrorCode, type InventoryRequestErrorCode, type InventoryWebhookEventType, type LocationType, type StockMovementType, type StockMovementSource, type StockCondition, type StockChangeCause, type WebhookDeliveryStatus, type InventoryWarningCode, type StockKind, type StockLossReason, type WithdrawalType, type LandedCostType, type LandedCostAllocation, type ReservationStatus, } from './vertrag.js';
24
+ export type { AddVariantRequest, Article, CancelStocktakeRequest, CloseStocktakeRequest, CloseStocktakeResult, CreateStocktakeRequest, RecordStocktakeCountRequest, RecountStocktakeRequest, ReviewStocktakeRequest, Stocktake, StocktakeActor, StocktakeCancellation, StocktakeClosing, StocktakeCount, StocktakeCountListQuery, StocktakeCountPage, StocktakeCountResult, StocktakeInventoryLine, StocktakeItem, StocktakeItemListQuery, StocktakeItemPage, StocktakeListQuery, StocktakeNotBooked, StocktakePage, StocktakePdf, StocktakePdfDownload, StocktakePdfInfo, StocktakeProgress, StocktakeRecount, StocktakeReview, StocktakeScope, StocktakeScopeInput, StocktakeSeal, StocktakeTotals, StocktakeWarning, VoidStocktakeCountRequest, ArticleInput, ArticleListQuery, ArticleLookup, ArticlePage, ChangeStockConditionRequest, CreateArticleRequest, CreateInventoryWebhookOptions, CreateReservationRequest, CreateVariantGroupRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptItem, GoodsReceiptPreview, GoodsReceiptPreviewLine, GoodsReceiptPreviewRequest, InventoryShortfall, InventoryWarning, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookEnvelope, InventoryWebhookEvent, ReceiptCreatedEventData, ReceiptCancelledEventData, ReceiptCancelledItem, ReceiptRefund, InventoryWebhookList, InventoryWebhookPatch, InventoryWebhookTestDelivery, InventoryWebhookTestResult, InventoryWebhookWithSecret, LandedCost, Location, LocationAddress, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationItem, ReleaseReservationRequest, Reservation, ReservationItem, ReservationItemInput, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockBelowMinimumEventData, StockChangedEventData, StockItem, StockLevel, StockListQuery, StockMovement, StockMovementLot, StockMovementPage, StockMovementQuery, StockMovementSourceRef, StockOperation, StockPage, StockResult, StockValue, TransferStockRequest, UpdateArticleRequest, UpdateVariantGroupRequest, VariantAttribute, VariantGroup, VariantGroupDefaults, VariantGroupDefaultsInput, VariantGroupListQuery, VariantGroupMember, VariantGroupPage, VariantInput, } from './typen.js';
25
+ export { INVENTORY_ENDPOINTS, INVENTORY_ERROR_CODES, INVENTORY_REQUEST_ERROR_CODES, INVENTORY_WEBHOOK_EVENTS, RECEIPT_WEBHOOK_EVENTS, INVENTORY_WEBHOOK_ENVELOPE_FIELDS, INVENTORY_WEBHOOK_LIMIT, INVENTORY_LIST_LIMIT_MAX, LOCATION_TYPES, STOCK_MOVEMENT_TYPES, STOCK_MOVEMENT_SOURCES, STOCK_CONDITIONS, STOCK_CHANGE_CAUSES, WEBHOOK_DELIVERY_STATUSES, INVENTORY_WARNING_CODES, STOCK_KINDS, STOCK_LOSS_REASONS, WITHDRAWAL_TYPES, LANDED_COST_TYPES, LANDED_COST_ALLOCATIONS, RESERVATION_STATUSES, INVENTORY_IDEMPOTENCY_KEY_MAX, RESERVATION_MINUTES_MIN, RESERVATION_MINUTES_MAX, VARIANT_ATTRIBUTES_MAX, VARIANT_VALUES_MAX, VARIANT_MATRIX_MAX, VARIANT_GROUP_ACTIVE_MAX, STOCKTAKE_STATUSES, STOCKTAKE_TYPES, STOCKTAKE_SCOPE_TYPES, STOCKTAKE_CHECK_REASONS, STOCKTAKE_NOT_BOOKED_REASONS, STOCKTAKE_SOURCES, STOCKTAKE_ACTOR_TYPES, STOCKTAKE_INVENTORY_AS_OF, STOCKTAKE_ITEMS_MAX, STOCKTAKE_RECOUNT_ITEMS_MAX, STOCKTAKE_COUNTS_PER_ITEM_MAX, type StocktakeStatus, type StocktakeType, type StocktakeScopeType, type StocktakeCheckReason, type StocktakeNotBookedReason, type StocktakeSource, type StocktakeActorType, type StocktakeInventoryAsOf, type InventoryEndpoint, type InventoryErrorCode, type InventoryRequestErrorCode, type InventoryWebhookEventType, type ReceiptWebhookEventType, type LocationType, type StockMovementType, type StockMovementSource, type StockCondition, type StockChangeCause, type WebhookDeliveryStatus, type InventoryWarningCode, type StockKind, type StockLossReason, type WithdrawalType, type LandedCostType, type LandedCostAllocation, type ReservationStatus, } from './vertrag.js';
@@ -16,8 +16,8 @@
16
16
  */
17
17
  Object.defineProperty(exports, "__esModule", { value: true });
18
18
  exports.closeStocktake = exports.cancelStocktake = exports.updateVariantGroup = exports.listVariantGroups = exports.iterateVariantGroups = exports.getVariantGroup = exports.createVariantGroup = exports.addVariant = exports.updateArticle = exports.transferStock = exports.reverseStockMovement = exports.releaseReservation = exports.recordStockLoss = exports.receiveGoods = exports.previewGoodsReceipt = exports.listReservations = exports.iterateReservations = exports.getReservation = exports.extendReservation = exports.deactivateArticle = exports.createReservation = exports.createArticle = exports.changeStockCondition = exports.updateWebhook = exports.sendWebhookTest = exports.rotateWebhookSecret = exports.lookupArticleByCode = exports.listWebhooks = exports.listWebhookDeliveries = exports.listStockMovements = exports.listStock = exports.listLocations = exports.listArticles = exports.iterateStockMovements = exports.iterateStock = exports.iterateArticles = exports.getStock = exports.getArticle = exports.deleteWebhook = exports.createWebhook = exports.isInventoryWarningCode = exports.inventoryBusyStocktakeId = exports.inventoryShortfalls = exports.inventoryRetryAfterSec = exports.inventoryFieldErrors = exports.inventoryErrorCode = exports.isInventoryErrorCode = exports.isInventoryError = exports.inventoryKeyAuth = exports.createInventoryClient = void 0;
19
- exports.STOCKTAKE_CHECK_REASONS = exports.STOCKTAKE_SCOPE_TYPES = exports.STOCKTAKE_TYPES = exports.STOCKTAKE_STATUSES = exports.VARIANT_GROUP_ACTIVE_MAX = exports.VARIANT_MATRIX_MAX = exports.VARIANT_VALUES_MAX = exports.VARIANT_ATTRIBUTES_MAX = exports.RESERVATION_MINUTES_MAX = exports.RESERVATION_MINUTES_MIN = exports.INVENTORY_IDEMPOTENCY_KEY_MAX = exports.RESERVATION_STATUSES = exports.LANDED_COST_ALLOCATIONS = exports.LANDED_COST_TYPES = exports.WITHDRAWAL_TYPES = exports.STOCK_LOSS_REASONS = exports.STOCK_KINDS = exports.INVENTORY_WARNING_CODES = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.INVENTORY_WEBHOOK_EVENTS = exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_ENDPOINTS = exports.WEBHOOK_TOLERANCE_SEC = exports.WEBHOOK_DELIVERY_HEADER = exports.WEBHOOK_EVENT_HEADER = exports.WEBHOOK_SIGNATURE_HEADER = exports.parseInventoryWebhookEvent = exports.verifyInventoryWebhookSignature = exports.voidStocktakeCount = exports.reviewStocktake = exports.recountStocktake = exports.recordStocktakeCount = exports.listStocktakes = exports.listStocktakeItems = exports.listStocktakeCounts = exports.iterateStocktakes = exports.iterateStocktakeItems = exports.iterateStocktakeCounts = exports.getStocktakePdf = exports.getStocktake = exports.createStocktake = void 0;
20
- exports.STOCKTAKE_COUNTS_PER_ITEM_MAX = exports.STOCKTAKE_RECOUNT_ITEMS_MAX = exports.STOCKTAKE_ITEMS_MAX = exports.STOCKTAKE_INVENTORY_AS_OF = exports.STOCKTAKE_ACTOR_TYPES = exports.STOCKTAKE_SOURCES = exports.STOCKTAKE_NOT_BOOKED_REASONS = void 0;
19
+ exports.STOCKTAKE_SCOPE_TYPES = exports.STOCKTAKE_TYPES = exports.STOCKTAKE_STATUSES = exports.VARIANT_GROUP_ACTIVE_MAX = exports.VARIANT_MATRIX_MAX = exports.VARIANT_VALUES_MAX = exports.VARIANT_ATTRIBUTES_MAX = exports.RESERVATION_MINUTES_MAX = exports.RESERVATION_MINUTES_MIN = exports.INVENTORY_IDEMPOTENCY_KEY_MAX = exports.RESERVATION_STATUSES = exports.LANDED_COST_ALLOCATIONS = exports.LANDED_COST_TYPES = exports.WITHDRAWAL_TYPES = exports.STOCK_LOSS_REASONS = exports.STOCK_KINDS = exports.INVENTORY_WARNING_CODES = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.RECEIPT_WEBHOOK_EVENTS = exports.INVENTORY_WEBHOOK_EVENTS = exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_ENDPOINTS = exports.WEBHOOK_TOLERANCE_SEC = exports.WEBHOOK_DELIVERY_HEADER = exports.WEBHOOK_EVENT_HEADER = exports.WEBHOOK_SIGNATURE_HEADER = exports.parseInventoryWebhookEvent = exports.verifyInventoryWebhookSignature = exports.voidStocktakeCount = exports.reviewStocktake = exports.recountStocktake = exports.recordStocktakeCount = exports.listStocktakes = exports.listStocktakeItems = exports.listStocktakeCounts = exports.iterateStocktakes = exports.iterateStocktakeItems = exports.iterateStocktakeCounts = exports.getStocktakePdf = exports.getStocktake = exports.createStocktake = void 0;
20
+ exports.STOCKTAKE_COUNTS_PER_ITEM_MAX = exports.STOCKTAKE_RECOUNT_ITEMS_MAX = exports.STOCKTAKE_ITEMS_MAX = exports.STOCKTAKE_INVENTORY_AS_OF = exports.STOCKTAKE_ACTOR_TYPES = exports.STOCKTAKE_SOURCES = exports.STOCKTAKE_NOT_BOOKED_REASONS = exports.STOCKTAKE_CHECK_REASONS = void 0;
21
21
  var api_js_1 = require("./api.js");
22
22
  Object.defineProperty(exports, "createInventoryClient", { enumerable: true, get: function () { return api_js_1.createInventoryClient; } });
23
23
  var auth_js_1 = require("./auth.js");
@@ -100,6 +100,7 @@ Object.defineProperty(exports, "INVENTORY_ENDPOINTS", { enumerable: true, get: f
100
100
  Object.defineProperty(exports, "INVENTORY_ERROR_CODES", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_ERROR_CODES; } });
101
101
  Object.defineProperty(exports, "INVENTORY_REQUEST_ERROR_CODES", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_REQUEST_ERROR_CODES; } });
102
102
  Object.defineProperty(exports, "INVENTORY_WEBHOOK_EVENTS", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_WEBHOOK_EVENTS; } });
103
+ Object.defineProperty(exports, "RECEIPT_WEBHOOK_EVENTS", { enumerable: true, get: function () { return vertrag_js_1.RECEIPT_WEBHOOK_EVENTS; } });
103
104
  Object.defineProperty(exports, "INVENTORY_WEBHOOK_ENVELOPE_FIELDS", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_WEBHOOK_ENVELOPE_FIELDS; } });
104
105
  Object.defineProperty(exports, "INVENTORY_WEBHOOK_LIMIT", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_WEBHOOK_LIMIT; } });
105
106
  Object.defineProperty(exports, "INVENTORY_LIST_LIMIT_MAX", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_LIST_LIMIT_MAX; } });
@@ -11,6 +11,7 @@
11
11
  * Tag) `YYYY-MM-DD`.
12
12
  */
13
13
  import type { InventoryWarningCode, InventoryWebhookEventType, LandedCostAllocation, LandedCostType, LocationType, ReservationStatus, StockChangeCause, StockCondition, StockKind, StockLossReason, StockMovementSource, StockMovementType, StocktakeActorType, StocktakeCheckReason, StocktakeInventoryAsOf, StocktakeNotBookedReason, StocktakeScopeType, StocktakeSource, StocktakeStatus, StocktakeType, WebhookDeliveryStatus, WithdrawalType } from './vertrag.js';
14
+ import type { ListedFullReceipt } from '../client/list-receipts.js';
14
15
  /**
15
16
  * Ein Artikel, wie `getArticle`, `listArticles`, `lookupArticleByCode` und die
16
17
  * Ereignisse `article.*` ihn senden.
@@ -355,7 +356,44 @@ export interface InventoryWebhookEnvelope<T extends InventoryWebhookEventType, D
355
356
  test: boolean;
356
357
  data: D;
357
358
  }
358
- export type InventoryWebhookEvent = InventoryWebhookEnvelope<'stock.changed', StockChangedEventData> | InventoryWebhookEnvelope<'stock.below_minimum', StockBelowMinimumEventData> | InventoryWebhookEnvelope<'article.created', Article> | InventoryWebhookEnvelope<'article.updated', Article> | InventoryWebhookEnvelope<'article.deactivated', Article> | InventoryWebhookEnvelope<'reservation.expired', Reservation> | InventoryWebhookEnvelope<'reservation.released', Reservation> | InventoryWebhookEnvelope<'reservation.redeemed', Reservation> | InventoryWebhookEnvelope<'variant_group.created', VariantGroup> | InventoryWebhookEnvelope<'variant_group.updated', VariantGroup>;
359
+ /**
360
+ * Nutzlast von `receipt.created` (Beleg-Webhooks): der Beleg wie `listReceipts` mit `view: 'full'` (dieselbe
361
+ * Darstellung, auch Fremdgutscheine mit Nummer, eigene maskiert). Ist der Beleg fuer eine Zustellung zu gross,
362
+ * fehlen seine Positionen (`receipt.items` leer), `truncated` ist `true` und `hint` sagt, ihn mit `getReceipt`
363
+ * zu holen.
364
+ */
365
+ export interface ReceiptCreatedEventData {
366
+ receipt: ListedFullReceipt;
367
+ /** Nur bei einer gekuerzten Zustellung: `true` (die Positionen fehlen). */
368
+ truncated?: true;
369
+ /** Nur bei einer gekuerzten Zustellung: Hinweis (deutsch). */
370
+ hint?: string;
371
+ }
372
+ /** Eine stornierte Position aus dem Storno-Beleg (`cancelledItems[]`). */
373
+ export interface ReceiptCancelledItem {
374
+ /** Index der Position im Original; `null`, wenn der Storno-Beleg ihn nicht traegt (Positionen ohne Artikel). */
375
+ index: number | null;
376
+ quantity: number | null;
377
+ }
378
+ /** Eine Rueckzahlung des Storno-Belegs (`refunds[]`): Betrag positiv in Cent. */
379
+ export interface ReceiptRefund {
380
+ /** Kennung der Zahlung im Original (`payments[].id`); `null` ohne Bezug (etwa bar zurueck). */
381
+ refundOf: string | null;
382
+ amountCents: number | null;
383
+ /** Zahlart wie in `payments[].method`. */
384
+ method: string | null;
385
+ }
386
+ /**
387
+ * Nutzlast von `receipt.cancelled`: der Storno-Beleg wie bei `receipt.created`, dazu Bezug, stornierte Positionen
388
+ * und Rueckzahlungen, abgeleitet aus dem Storno-Beleg selbst. `cancellationOf` ist die Beleg-ID des Originals;
389
+ * der veraltete Storno ohne Bezug traegt `null`.
390
+ */
391
+ export interface ReceiptCancelledEventData extends ReceiptCreatedEventData {
392
+ cancellationOf: string | null;
393
+ cancelledItems: ReceiptCancelledItem[];
394
+ refunds: ReceiptRefund[];
395
+ }
396
+ export type InventoryWebhookEvent = InventoryWebhookEnvelope<'stock.changed', StockChangedEventData> | InventoryWebhookEnvelope<'stock.below_minimum', StockBelowMinimumEventData> | InventoryWebhookEnvelope<'article.created', Article> | InventoryWebhookEnvelope<'article.updated', Article> | InventoryWebhookEnvelope<'article.deactivated', Article> | InventoryWebhookEnvelope<'reservation.expired', Reservation> | InventoryWebhookEnvelope<'reservation.released', Reservation> | InventoryWebhookEnvelope<'reservation.redeemed', Reservation> | InventoryWebhookEnvelope<'variant_group.created', VariantGroup> | InventoryWebhookEnvelope<'variant_group.updated', VariantGroup> | InventoryWebhookEnvelope<'receipt.created', ReceiptCreatedEventData> | InventoryWebhookEnvelope<'receipt.cancelled', ReceiptCancelledEventData>;
359
397
  /**
360
398
  * Die Felder eines Artikels beim Anlegen. Bei der Anlage heisst `null` „nicht
361
399
  * angegeben“ (ausser bei `name`, der Pflicht ist).
@@ -58,9 +58,20 @@ export type WebhookDeliveryStatus = (typeof WEBHOOK_DELIVERY_STATUSES)[number];
58
58
  * Variantengruppe wie `getVariantGroup`; `updated` kommt nur bei einer aussen
59
59
  * sichtbaren Aenderung (neuer Wert, neue oder stillgelegte Variante, Name,
60
60
  * Vorgaben, Stilllegen der Gruppe).
61
+ * `receipt.created` und `receipt.cancelled` (Beleg-Webhooks, Server 2026-11) tragen den Beleg wie
62
+ * `listReceipts` mit `view: 'full'` ([RECEIPT_WEBHOOK_EVENTS]); sie brauchen das Modul Registrierkasse, nicht
63
+ * das Lager (sonst `webhook_event_not_available` beim Anlegen oder Aendern).
61
64
  */
62
- export declare const INVENTORY_WEBHOOK_EVENTS: readonly ["stock.changed", "stock.below_minimum", "article.created", "article.updated", "article.deactivated", "reservation.expired", "reservation.released", "reservation.redeemed", "variant_group.created", "variant_group.updated"];
65
+ export declare const INVENTORY_WEBHOOK_EVENTS: readonly ["stock.changed", "stock.below_minimum", "article.created", "article.updated", "article.deactivated", "reservation.expired", "reservation.released", "reservation.redeemed", "variant_group.created", "variant_group.updated", "receipt.created", "receipt.cancelled"];
63
66
  export type InventoryWebhookEventType = (typeof INVENTORY_WEBHOOK_EVENTS)[number];
67
+ /**
68
+ * Die Beleg-Ereignisse der Konto-Webhooks: `receipt.created` fuer jeden neu signierten Beleg jeder Art (auch den
69
+ * Storno-Beleg), `receipt.cancelled` zusaetzlich fuer jeden Storno-Beleg. Ein Storno bringt also beide. Die
70
+ * Ereignis-ID ist je Beleg und Ereignis fest: darauf entdoppeln. Fehlt eine fortlaufende Belegnummer einer Kasse,
71
+ * den Zeitraum mit `listReceipts` nachholen.
72
+ */
73
+ export declare const RECEIPT_WEBHOOK_EVENTS: readonly ["receipt.created", "receipt.cancelled"];
74
+ export type ReceiptWebhookEventType = (typeof RECEIPT_WEBHOOK_EVENTS)[number];
64
75
  /**
65
76
  * Die Felder der Huelle jeder Zustellung, in der Reihenfolge am Draht. Statt
66
77
  * `partnerId` (Partner-Webhooks) traegt sie `accountId`; `test` steht nur auf
@@ -117,7 +128,7 @@ export declare const INVENTORY_LIST_LIMIT_MAX = 200;
117
128
  * `stocktake_not_closed` (das Protokoll gibt es erst nach dem Abschluss, auch
118
129
  * nicht fuer eine abgebrochene Inventur).
119
130
  */
120
- export declare const INVENTORY_ERROR_CODES: readonly ["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", "variant_group_not_found", "variant_already_exists", "invalid_variant_attributes", "variant_group_inactive", "variant_limit", "stocktake_not_found", "stocktake_not_open", "stocktake_closed", "stocktake_not_in_review", "stocktake_closing", "stocktake_location_busy", "stocktake_review_running", "stocktake_recount_open", "article_not_in_scope", "article_not_tracked", "count_not_found", "count_already_voided", "serial_already_counted", "too_many_counts", "stocktake_not_closed"];
131
+ export declare const INVENTORY_ERROR_CODES: readonly ["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", "webhook_event_not_available", "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", "variant_group_not_found", "variant_already_exists", "invalid_variant_attributes", "variant_group_inactive", "variant_limit", "stocktake_not_found", "stocktake_not_open", "stocktake_closed", "stocktake_not_in_review", "stocktake_closing", "stocktake_location_busy", "stocktake_review_running", "stocktake_recount_open", "article_not_in_scope", "article_not_tracked", "count_not_found", "count_already_voided", "serial_already_counted", "too_many_counts", "stocktake_not_closed"];
121
132
  export type InventoryErrorCode = (typeof INVENTORY_ERROR_CODES)[number];
122
133
  /**
123
134
  * Codes, die Anmeldung und Rand auf jedem Lager-Aufruf erzeugen koennen,
@@ -15,7 +15,7 @@
15
15
  * deckungsgleich mit dieser Datei; nichts hier wird geraten.
16
16
  */
17
17
  Object.defineProperty(exports, "__esModule", { value: true });
18
- exports.STOCKTAKE_COUNTS_PER_ITEM_MAX = exports.STOCKTAKE_RECOUNT_ITEMS_MAX = exports.STOCKTAKE_ITEMS_MAX = exports.STOCKTAKE_INVENTORY_AS_OF = exports.STOCKTAKE_ACTOR_TYPES = exports.STOCKTAKE_SOURCES = exports.STOCKTAKE_NOT_BOOKED_REASONS = exports.STOCKTAKE_CHECK_REASONS = exports.STOCKTAKE_SCOPE_TYPES = exports.STOCKTAKE_TYPES = exports.STOCKTAKE_STATUSES = exports.VARIANT_GROUP_ACTIVE_MAX = exports.VARIANT_MATRIX_MAX = exports.VARIANT_VALUES_MAX = exports.VARIANT_ATTRIBUTES_MAX = exports.RESERVATION_MINUTES_MAX = exports.RESERVATION_MINUTES_MIN = exports.INVENTORY_IDEMPOTENCY_KEY_MAX = exports.RESERVATION_STATUSES = exports.LANDED_COST_ALLOCATIONS = exports.LANDED_COST_TYPES = exports.WITHDRAWAL_TYPES = exports.STOCK_LOSS_REASONS = exports.STOCK_KINDS = exports.INVENTORY_WARNING_CODES = exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.INVENTORY_WEBHOOK_EVENTS = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_ENDPOINTS = void 0;
18
+ exports.STOCKTAKE_COUNTS_PER_ITEM_MAX = exports.STOCKTAKE_RECOUNT_ITEMS_MAX = exports.STOCKTAKE_ITEMS_MAX = exports.STOCKTAKE_INVENTORY_AS_OF = exports.STOCKTAKE_ACTOR_TYPES = exports.STOCKTAKE_SOURCES = exports.STOCKTAKE_NOT_BOOKED_REASONS = exports.STOCKTAKE_CHECK_REASONS = exports.STOCKTAKE_SCOPE_TYPES = exports.STOCKTAKE_TYPES = exports.STOCKTAKE_STATUSES = exports.VARIANT_GROUP_ACTIVE_MAX = exports.VARIANT_MATRIX_MAX = exports.VARIANT_VALUES_MAX = exports.VARIANT_ATTRIBUTES_MAX = exports.RESERVATION_MINUTES_MAX = exports.RESERVATION_MINUTES_MIN = exports.INVENTORY_IDEMPOTENCY_KEY_MAX = exports.RESERVATION_STATUSES = exports.LANDED_COST_ALLOCATIONS = exports.LANDED_COST_TYPES = exports.WITHDRAWAL_TYPES = exports.STOCK_LOSS_REASONS = exports.STOCK_KINDS = exports.INVENTORY_WARNING_CODES = exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.RECEIPT_WEBHOOK_EVENTS = exports.INVENTORY_WEBHOOK_EVENTS = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_ENDPOINTS = void 0;
19
19
  /** Die 44 Endpunkte (14 aus 5a, 13 aus 5b, 5 aus 5c, 12 der Inventur), in der Reihenfolge von `endpoints.public`. */
20
20
  exports.INVENTORY_ENDPOINTS = [
21
21
  'getArticle',
@@ -139,6 +139,9 @@ exports.WEBHOOK_DELIVERY_STATUSES = ['delivered', 'pending', 'failed', 'dropped'
139
139
  * Variantengruppe wie `getVariantGroup`; `updated` kommt nur bei einer aussen
140
140
  * sichtbaren Aenderung (neuer Wert, neue oder stillgelegte Variante, Name,
141
141
  * Vorgaben, Stilllegen der Gruppe).
142
+ * `receipt.created` und `receipt.cancelled` (Beleg-Webhooks, Server 2026-11) tragen den Beleg wie
143
+ * `listReceipts` mit `view: 'full'` ([RECEIPT_WEBHOOK_EVENTS]); sie brauchen das Modul Registrierkasse, nicht
144
+ * das Lager (sonst `webhook_event_not_available` beim Anlegen oder Aendern).
142
145
  */
143
146
  exports.INVENTORY_WEBHOOK_EVENTS = [
144
147
  'stock.changed',
@@ -151,7 +154,16 @@ exports.INVENTORY_WEBHOOK_EVENTS = [
151
154
  'reservation.redeemed',
152
155
  'variant_group.created',
153
156
  'variant_group.updated',
157
+ 'receipt.created',
158
+ 'receipt.cancelled',
154
159
  ];
160
+ /**
161
+ * Die Beleg-Ereignisse der Konto-Webhooks: `receipt.created` fuer jeden neu signierten Beleg jeder Art (auch den
162
+ * Storno-Beleg), `receipt.cancelled` zusaetzlich fuer jeden Storno-Beleg. Ein Storno bringt also beide. Die
163
+ * Ereignis-ID ist je Beleg und Ereignis fest: darauf entdoppeln. Fehlt eine fortlaufende Belegnummer einer Kasse,
164
+ * den Zeitraum mit `listReceipts` nachholen.
165
+ */
166
+ exports.RECEIPT_WEBHOOK_EVENTS = ['receipt.created', 'receipt.cancelled'];
155
167
  /**
156
168
  * Die Felder der Huelle jeder Zustellung, in der Reihenfolge am Draht. Statt
157
169
  * `partnerId` (Partner-Webhooks) traegt sie `accountId`; `test` steht nur auf
@@ -221,6 +233,9 @@ exports.INVENTORY_ERROR_CODES = [
221
233
  'module_inactive',
222
234
  'rate_limited',
223
235
  'server_error',
236
+ // Seit Beleg-Webhooks (Server 2026-11, Stelle wie im Vertrag): ein Ereignis, dessen Modul dem Konto fehlt
237
+ // (`receipt.*` ohne Registrierkasse, `stock.*` u. a. ohne Lager), laesst sich nicht abonnieren; mit `field: 'events'`.
238
+ 'webhook_event_not_available',
224
239
  'idempotency_key_required',
225
240
  'idempotency_conflict',
226
241
  'location_not_found',
@@ -46,6 +46,9 @@ export declare function verifyInventoryWebhookSignature(secret: string | readonl
46
46
  * - `variant_group.created|updated` tragen die Gruppe wie `getVariantGroup`
47
47
  * (seit 1.6.0). Zwei Zustellungen koennen sich ueberholen: den Stand nur
48
48
  * uebernehmen, wenn `data.updatedAt` neuer ist als der gespeicherte.
49
+ * - `receipt.created|cancelled` (Beleg-Webhooks) tragen den Beleg wie
50
+ * `listReceipts` mit `view: 'full'` ([ReceiptCreatedEventData],
51
+ * [ReceiptCancelledEventData]).
49
52
  * - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
50
53
  * `KasseneckValidationError` (`scope: 'response'`).
51
54
  *
@@ -22,6 +22,7 @@ const errors_js_1 = require("../client/errors.js");
22
22
  const webhook_signatur_js_1 = require("../partner/webhook-signatur.js");
23
23
  const lesen_js_1 = require("./lesen.js");
24
24
  const vertrag_js_1 = require("./vertrag.js");
25
+ const list_receipts_js_1 = require("../client/list-receipts.js");
25
26
  var webhook_signatur_js_2 = require("../partner/webhook-signatur.js");
26
27
  Object.defineProperty(exports, "WEBHOOK_SIGNATURE_HEADER", { enumerable: true, get: function () { return webhook_signatur_js_2.WEBHOOK_SIGNATURE_HEADER; } });
27
28
  Object.defineProperty(exports, "WEBHOOK_EVENT_HEADER", { enumerable: true, get: function () { return webhook_signatur_js_2.WEBHOOK_EVENT_HEADER; } });
@@ -72,6 +73,9 @@ function kaputt(grund) {
72
73
  * - `variant_group.created|updated` tragen die Gruppe wie `getVariantGroup`
73
74
  * (seit 1.6.0). Zwei Zustellungen koennen sich ueberholen: den Stand nur
74
75
  * uebernehmen, wenn `data.updatedAt` neuer ist als der gespeicherte.
76
+ * - `receipt.created|cancelled` (Beleg-Webhooks) tragen den Beleg wie
77
+ * `listReceipts` mit `view: 'full'` ([ReceiptCreatedEventData],
78
+ * [ReceiptCancelledEventData]).
75
79
  * - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
76
80
  * `KasseneckValidationError` (`scope: 'response'`).
77
81
  *
@@ -116,7 +120,42 @@ function parseInventoryWebhookEvent(rawBody) {
116
120
  case 'variant_group.created':
117
121
  case 'variant_group.updated':
118
122
  return { ...huelle, type: huelle.type, data: (0, lesen_js_1.variantengruppe)(ort, data) };
123
+ case 'receipt.created':
124
+ return { ...huelle, type: huelle.type, data: belegDaten(data) };
125
+ case 'receipt.cancelled':
126
+ return { ...huelle, type: huelle.type, data: stornoDaten(data) };
119
127
  default:
120
128
  return { ...huelle, type: huelle.type, data: (0, lesen_js_1.artikel)(ort, data) };
121
129
  }
122
130
  }
131
+ /** `data` von `receipt.created`: der Beleg der vollen Ansicht, bei einer gekuerzten Zustellung mit Hinweis. */
132
+ function belegDaten(data) {
133
+ const beleg = (0, lesen_js_1.objekt)(data['receipt']);
134
+ if (!beleg)
135
+ throw kaputt('Ereignis ohne data.receipt');
136
+ return {
137
+ receipt: (0, list_receipts_js_1.vollerBeleg)(beleg),
138
+ ...(data['truncated'] === true ? { truncated: true } : {}),
139
+ ...(typeof data['hint'] === 'string' ? { hint: data['hint'] } : {}),
140
+ };
141
+ }
142
+ const ganzOderNull = (w) => (typeof w === 'number' && Number.isInteger(w) ? w : null);
143
+ const textOderNull = (w) => (typeof w === 'string' && w !== '' ? w : null);
144
+ /** `data` von `receipt.cancelled`: dazu Bezug, stornierte Positionen und Rueckzahlungen aus dem Storno-Beleg. */
145
+ function stornoDaten(data) {
146
+ const { cancellationOf, cancelledItems, refunds } = data;
147
+ if (cancellationOf !== null && typeof cancellationOf !== 'string')
148
+ throw kaputt('data.cancellationOf ist weder Text noch null');
149
+ if (!Array.isArray(cancelledItems) || cancelledItems.some((x) => !(0, lesen_js_1.objekt)(x)))
150
+ throw kaputt('data.cancelledItems ist keine Liste von Positionen');
151
+ if (!Array.isArray(refunds) || refunds.some((x) => !(0, lesen_js_1.objekt)(x)))
152
+ throw kaputt('data.refunds ist keine Liste von Rueckzahlungen');
153
+ return {
154
+ ...belegDaten(data),
155
+ cancellationOf: cancellationOf === '' ? null : cancellationOf,
156
+ cancelledItems: cancelledItems.map((p) => ({ index: ganzOderNull(p['index']), quantity: ganzOderNull(p['quantity']) })),
157
+ refunds: refunds.map((r) => ({
158
+ refundOf: textOderNull(r['refundOf']), amountCents: ganzOderNull(r['amountCents']), method: textOderNull(r['method']),
159
+ })),
160
+ };
161
+ }
@@ -1,5 +1,5 @@
1
1
  export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, isVoucherItem, isVoucherFloatItem, } from './receipt-item.js';
2
- export { type Voucher, type VoucherArticle, type IssuedVoucher, type ReturnIssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields } from './voucher.js';
2
+ export { type Voucher, type VoucherArticle, type IssuedVoucher, type ReturnIssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields, type VoucherSource, type LegacyValueVoucherWish, VOUCHER_SOURCES, isExternalVoucher, externalVoucherIsValid, normalizeExternalVoucherNumber, checkExternalVoucherNumber, type ExternalVoucherNumberCheck, EXTERNAL_VOUCHER_NUMBER_MAX, EXTERNAL_VOUCHER_TAXED_WITH_MAX, EXTERNAL_VOUCHER_VAT_RATES_BP, } from './voucher.js';
3
3
  export { type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, } from './receipt.js';
4
4
  export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, } from './cancellation.js';
5
5
  export { type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-payment.js';
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherServerFields = exports.isNewFormVoucher = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isVoucherFloatItem = exports.isVoucherItem = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
4
- exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isManualReceiptErrorCode = exports.MANUAL_RECEIPT_ERROR_CODES = exports.readManualReceipt = exports.MANUAL_RECEIPT_REASONS = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = void 0;
3
+ exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.EXTERNAL_VOUCHER_VAT_RATES_BP = exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = exports.EXTERNAL_VOUCHER_NUMBER_MAX = exports.checkExternalVoucherNumber = exports.normalizeExternalVoucherNumber = exports.externalVoucherIsValid = exports.isExternalVoucher = exports.VOUCHER_SOURCES = exports.voucherServerFields = exports.isNewFormVoucher = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isVoucherFloatItem = exports.isVoucherItem = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
4
+ exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isManualReceiptErrorCode = exports.MANUAL_RECEIPT_ERROR_CODES = exports.readManualReceipt = exports.MANUAL_RECEIPT_REASONS = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = void 0;
5
5
  var receipt_item_js_1 = require("./receipt-item.js");
6
6
  Object.defineProperty(exports, "toReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.toReceiptItemPayload; } });
7
7
  Object.defineProperty(exports, "fromReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.fromReceiptItemPayload; } });
@@ -18,6 +18,14 @@ Object.defineProperty(exports, "fromVoucherPayload", { enumerable: true, get: fu
18
18
  Object.defineProperty(exports, "voucherIsValid", { enumerable: true, get: function () { return voucher_js_1.voucherIsValid; } });
19
19
  Object.defineProperty(exports, "isNewFormVoucher", { enumerable: true, get: function () { return voucher_js_1.isNewFormVoucher; } });
20
20
  Object.defineProperty(exports, "voucherServerFields", { enumerable: true, get: function () { return voucher_js_1.voucherServerFields; } });
21
+ Object.defineProperty(exports, "VOUCHER_SOURCES", { enumerable: true, get: function () { return voucher_js_1.VOUCHER_SOURCES; } });
22
+ Object.defineProperty(exports, "isExternalVoucher", { enumerable: true, get: function () { return voucher_js_1.isExternalVoucher; } });
23
+ Object.defineProperty(exports, "externalVoucherIsValid", { enumerable: true, get: function () { return voucher_js_1.externalVoucherIsValid; } });
24
+ Object.defineProperty(exports, "normalizeExternalVoucherNumber", { enumerable: true, get: function () { return voucher_js_1.normalizeExternalVoucherNumber; } });
25
+ Object.defineProperty(exports, "checkExternalVoucherNumber", { enumerable: true, get: function () { return voucher_js_1.checkExternalVoucherNumber; } });
26
+ Object.defineProperty(exports, "EXTERNAL_VOUCHER_NUMBER_MAX", { enumerable: true, get: function () { return voucher_js_1.EXTERNAL_VOUCHER_NUMBER_MAX; } });
27
+ Object.defineProperty(exports, "EXTERNAL_VOUCHER_TAXED_WITH_MAX", { enumerable: true, get: function () { return voucher_js_1.EXTERNAL_VOUCHER_TAXED_WITH_MAX; } });
28
+ Object.defineProperty(exports, "EXTERNAL_VOUCHER_VAT_RATES_BP", { enumerable: true, get: function () { return voucher_js_1.EXTERNAL_VOUCHER_VAT_RATES_BP; } });
21
29
  var receipt_js_1 = require("./receipt.js");
22
30
  Object.defineProperty(exports, "toReceiptPayload", { enumerable: true, get: function () { return receipt_js_1.toReceiptPayload; } });
23
31
  Object.defineProperty(exports, "fromReceiptPayload", { enumerable: true, get: function () { return receipt_js_1.fromReceiptPayload; } });
@@ -12,7 +12,22 @@ import { VoucherAction, VoucherType } from '../enums/index.js';
12
12
  */
13
13
  export interface Voucher {
14
14
  name?: string;
15
+ /**
16
+ * Code eines eigenen Gutscheins (Einloesung, Auszahlung). Am gelesenen Eintrag die Maske. Ein Wunsch der
17
+ * Altform mit frei getipptem Code ist veraltet ([LegacyValueVoucherWish]).
18
+ */
15
19
  code?: string;
20
+ /**
21
+ * Fremdgutschein (Server 2026-11): `external` = Gutschein eines anderen Systems (Warenwirtschaft, Webshop) mit
22
+ * seiner Nummer in [number]. Kein Dokument bei Kasseneck, kein Saldo, keine Pruefung: Art, Satz und Betrag sagt
23
+ * der Betrieb. Fehlt bei eigenen Gutscheinen.
24
+ */
25
+ source?: VoucherSource | string;
26
+ /**
27
+ * Nummer des Fremdgutscheins (nur mit `source: 'external'`): nach [normalizeExternalVoucherNumber] 1 bis 40
28
+ * Zeichen aus `A–Z a–z 0–9 - _ . /`; ein eigener Gutscheincode ist keine Fremdnummer. Steht voll am Bon.
29
+ */
30
+ number?: string;
16
31
  action: VoucherAction | string;
17
32
  /**
18
33
  * Art des Gutscheins. Beim Verkauf ueber eine Sorte die Art der Sorte
@@ -119,6 +134,8 @@ export interface VoucherArticle {
119
134
  export interface VoucherPayload {
120
135
  name?: string | null;
121
136
  code?: string | null;
137
+ source?: string;
138
+ number?: string;
122
139
  action: string;
123
140
  type: string;
124
141
  value?: number | null;
@@ -142,16 +159,35 @@ export interface VoucherPayload {
142
159
  exempt?: boolean;
143
160
  zeroRateBucket?: boolean;
144
161
  }
162
+ /**
163
+ * Wunsch der Altform: Wertgutschein mit frei getipptem Code (`{ action, type: 'value', code, valueCents }`).
164
+ * Nur als Typ fuer Aufrufer, die ihn noch senden; ein gelesener Beleg ist davon nicht betroffen.
165
+ *
166
+ * @deprecated Server 2026-11: der Weg bleibt gueltig, die Antwort traegt `deprecation`
167
+ * ([ReceiptWithCompany.deprecation]). Der Code wird nicht geprueft, steuerlich ist das ein fremder
168
+ * Mehrzweckgutschein. Einen Gutschein eines anderen Systems als Fremdgutschein senden: `{ source: 'external',
169
+ * action, type: 'multi_purpose', number, amountCents }`; eigene Gutscheine ueber eine Sorte (`typeId`)
170
+ * verkaufen und mit ihrem Code einloesen.
171
+ */
172
+ export type LegacyValueVoucherWish = Voucher & {
173
+ type: 'value';
174
+ code: string;
175
+ };
145
176
  /** Arten der neuen Gutscheinform (die Altwerte sind `value` und `promo`). */
146
177
  export declare const NEUE_GUTSCHEINARTEN: readonly string[];
178
+ /** Herkunft eines Gutscheins: `external` = Fremdgutschein (Katalog `GUTSCHEIN_QUELLE`). */
179
+ export type VoucherSource = 'external';
180
+ export declare const VOUCHER_SOURCES: readonly VoucherSource[];
181
+ /** Fremdgutschein (`source: 'external'`)? Zwilling von `gutschein-beleg.istFremd`. */
182
+ export declare function isExternalVoucher(voucher: Pick<Voucher, 'source'>): boolean;
147
183
  /** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
148
- export declare function isNewFormVoucher(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'>): boolean;
184
+ export declare function isNewFormVoucher(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'> & Pick<Voucher, 'source'>): boolean;
149
185
  /**
150
186
  * Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
151
187
  * oder nur ueber die Sorte). Paketintern: Zahlbetrag und Pruefung vor dem
152
188
  * Senden entscheiden daran, ob eine Sorte noetig ist.
153
189
  */
154
- export declare function istWertVerkauf(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'>): boolean;
190
+ export declare function istWertVerkauf(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'> & Pick<Voucher, 'source'>): boolean;
155
191
  /**
156
192
  * Felder, die nur der Server setzt; an einem Wunsch sind sie `voucher_invalid`.
157
193
  * Sortenname und Auszahlung friert der Server beim Verkauf ein (Stufe 4b).
@@ -175,3 +211,43 @@ export declare function fromVoucherPayload(payload: VoucherPayload): Voucher;
175
211
  * Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
176
212
  */
177
213
  export declare function wunschFormGueltig(v: Voucher, sorteNoetig: boolean): boolean;
214
+ /** Hoechstlaenge der Nummer eines Fremdgutscheins (nach dem Abschneiden des Rands). */
215
+ export declare const EXTERNAL_VOUCHER_NUMBER_MAX = 40;
216
+ /** Hoechstlaenge von `taxedWith` (Vermerk, mit welchem Beleg im fremden System der Einzweckgutschein versteuert ist). */
217
+ export declare const EXTERNAL_VOUCHER_TAXED_WITH_MAX = 40;
218
+ /**
219
+ * Saetze, mit denen ein fremder Einzweckgutschein verkauft sein kann (Basispunkte): die Saetze der Kasse
220
+ * (20, 10, 13, 19, 4,9 %) und 0 = befreit verkauft (Kleinunternehmer).
221
+ */
222
+ export declare const EXTERNAL_VOUCHER_VAT_RATES_BP: readonly number[];
223
+ /**
224
+ * Nummer eines Fremdgutscheins in der Form, mit der der Server sie speichert und druckt
225
+ * (`gutschein-core.normiereFremdnummer`): Rand weg, **keine** Unicode-Normalisierung, Gross-/Kleinschreibung
226
+ * bleibt; dann 1 bis 40 Zeichen aus `A–Z a–z 0–9 - _ . /`. Sonst `null` (`external_voucher_number_invalid`).
227
+ * Einen eigenen Gutscheincode erkennt erst [checkExternalVoucherNumber].
228
+ */
229
+ export declare function normalizeExternalVoucherNumber(text: unknown): string | null;
230
+ /** Ergebnis von [checkExternalVoucherNumber]: die Nummer wie gespeichert, oder der Fehlercode des Servers. */
231
+ export type ExternalVoucherNumberCheck = {
232
+ ok: true;
233
+ number: string;
234
+ } | {
235
+ ok: false;
236
+ code: 'external_voucher_number_is_own_code' | 'external_voucher_number_invalid';
237
+ };
238
+ /**
239
+ * Prueft eine Fremdnummer in der Reihenfolge des Servers (`gutschein-beleg.pruefeFremd`): zuerst, ob sie ein
240
+ * gueltiger eigener Gutscheincode ist (12 Zeichen mit Pruefzeichen, in jeder Schreibweise der Kasse, auch mit `.`, `_`
241
+ * oder `/` als Trenner) – dann
242
+ * `external_voucher_number_is_own_code`, der Gutschein gehoert als eigener eingeloest –, danach die Form.
243
+ */
244
+ export declare function checkExternalVoucherNumber(text: unknown): ExternalVoucherNumberCheck;
245
+ /**
246
+ * Ist der Fremdgutschein sendbar? Die Form wie `gutschein-beleg.pruefeFremd` (ohne die Freigabe des Kontos, die
247
+ * kennt nur der Server bzw. `PosVoucherSettings.externalVouchers`): Aktion `sell`/`redeem`/`payout`, Art
248
+ * `multi_purpose`/`single_purpose`, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit
249
+ * einem Satz aus [EXTERNAL_VOUCHER_VAT_RATES_BP], Mehrzweck ohne; `taxedWith` nur bei Einzweck-Einloesung bzw.
250
+ * -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener
251
+ * Gutscheine (Code, Sorte, Artikel, Menge, Positionen) und Serverfelder nie.
252
+ */
253
+ export declare function externalVoucherIsValid(voucher: Voucher): boolean;