@lucaapp/service-utils 5.37.1 → 5.39.0

package/dist/lib/kafka/events/fiscalizedPayment.d.ts

@@ -0,0 +1,35 @@
+export declare const FISCALIZED_PAYMENT_EVENT_VERSION = 1;
+export type FiscalizedPaymentEventVersion = typeof FISCALIZED_PAYMENT_EVENT_VERSION;
+/**
+ * Final fiscalization outcome of a payment, decided by backend-tse:
+ * - `FISCALIZED`: the Kassenbeleg is final — signed with its receipt PDF
+ *   materializable, or issued in Notfallmodus.
+ * - `NOT_FISCALIZED`: backend-tse will never fiscalize this payment (a luca-web
+ *   QR / self-service payment at a location that does not fiscalize web
+ *   orders). There is no fiscal row and no Kassenbeleg.
+ */
+export type FiscalizedPaymentStatus = 'FISCALIZED' | 'NOT_FISCALIZED';
+/**
+ * Emitted by backend-tse once a payment's fiscalization outcome is final, so
+ * consumers (backend-pay) need not poll readiness. Delivery is at least once:
+ * dedupe on the envelope `id` (the fiscal payment id, or the payment id when
+ * NOT_FISCALIZED).
+ */
+export type FiscalizedPayment = {
+    version: FiscalizedPaymentEventVersion;
+    status: FiscalizedPaymentStatus;
+    /**
+     * backend-pay `V3Payment.uuid` for luca-web QR / self-service payments. Null
+     * for POS card payments (backend-tse cannot tell the real uuid from the
+     * fast-path one) and cash; resolve those via `checkoutId`.
+     */
+    paymentId: string | null;
+    /**
+     * `fiscal_payment_events.id` — the key for the receipt token / PDF. Null when
+     * NOT_FISCALIZED.
+     */
+    fiscalPaymentEventId: string | null;
+    locationId: string;
+    /** backend-pay `V3Checkout.uuid` for card / web payments. */
+    checkoutId: string | null;
+};

package/dist/lib/kafka/events/fiscalizedPayment.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FISCALIZED_PAYMENT_EVENT_VERSION = void 0;
+exports.FISCALIZED_PAYMENT_EVENT_VERSION = 1;

package/dist/lib/kafka/events/order.d.ts

@@ -26,6 +26,19 @@ export type OrderEventItem = {
     tax?: number;
     subItems?: OrderEventItem[];
 };
+/**
+ * Legal / billing details of the location group, printed as the Kassenbeleg
+ * issuer for mirrored web orders (LUCA-36795).
+ */
+export type OrderEventIssuer = {
+    legalName?: string | null;
+    street?: string | null;
+    postalCode?: string | null;
+    city?: string | null;
+    country?: string | null;
+    taxNumber?: string | null;
+    vatId?: string | null;
+};
 /**
  * Emitted by backend-pay when a luca-web order is created (LUCA-36037).
  * Carries the full order snapshot so consumers can mirror it without a callback.
@@ -45,4 +58,6 @@ export type OrderEvent = {
     note: string | null;
     createdAt: Date;
     items: OrderEventItem[];
+    /** Optional so older producers and consumers keep working. */
+    issuer?: OrderEventIssuer | null;
 };

package/dist/lib/kafka/events.d.ts

@@ -1,6 +1,7 @@
 import type { Payment, PaymentEvent } from './events/payment';
 import type { OrderEvent } from './events/order';
 import type { RefundEvent } from './events/refund';
+import type { FiscalizedPayment } from './events/fiscalizedPayment';
 import type { Consumer } from './events/consumer';
 import type { Operator } from './events/operator';
 import type { LocationGroupEmployees } from './events/locationGroupEmployees';
@@ -23,6 +24,7 @@ declare enum KafkaTopic {
     PAYMENTS = "payments",
     ORDERS = "orders",
     REFUNDS = "refunds",
+    FISCALIZED_PAYMENTS = "fiscalized_payments",
     CONSUMERS = "consumers",
     OPERATORS = "operators",
     OPERATORS_PAY = "operators_pay",
@@ -48,6 +50,7 @@ type MessageFormats = {
     [KafkaTopic.PAYMENTS]: Payment | PaymentEvent;
     [KafkaTopic.ORDERS]: OrderEvent;
     [KafkaTopic.REFUNDS]: RefundEvent;
+    [KafkaTopic.FISCALIZED_PAYMENTS]: FiscalizedPayment;
     [KafkaTopic.CONSUMERS]: Consumer;
     [KafkaTopic.OPERATORS]: Operator;
     [KafkaTopic.OPERATORS_PAY]: OperatorPay;
@@ -73,6 +76,7 @@ declare const MessageIssuer: {
     payments: Service;
     orders: Service;
     refunds: Service;
+    fiscalized_payments: Service;
     consumers: Service;
     operators: Service;
     operator_devices: Service;

package/dist/lib/kafka/events.js

@@ -7,6 +7,7 @@ var KafkaTopic;
     KafkaTopic["PAYMENTS"] = "payments";
     KafkaTopic["ORDERS"] = "orders";
     KafkaTopic["REFUNDS"] = "refunds";
+    KafkaTopic["FISCALIZED_PAYMENTS"] = "fiscalized_payments";
     KafkaTopic["CONSUMERS"] = "consumers";
     KafkaTopic["OPERATORS"] = "operators";
     KafkaTopic["OPERATORS_PAY"] = "operators_pay";
@@ -32,6 +33,7 @@ const MessageIssuer = {
     [KafkaTopic.PAYMENTS]: serviceIdentity_1.Service.BACKEND_PAY,
     [KafkaTopic.ORDERS]: serviceIdentity_1.Service.BACKEND_PAY,
     [KafkaTopic.REFUNDS]: serviceIdentity_1.Service.BACKEND_PAY,
+    [KafkaTopic.FISCALIZED_PAYMENTS]: serviceIdentity_1.Service.BACKEND_TSE,
     [KafkaTopic.CONSUMERS]: serviceIdentity_1.Service.BACKEND,
     [KafkaTopic.OPERATORS]: serviceIdentity_1.Service.BACKEND,
     [KafkaTopic.OPERATOR_DEVICES]: serviceIdentity_1.Service.BACKEND,

package/dist/lib/kafka/index.d.ts

@@ -3,6 +3,8 @@ export { KafkaTopic } from './events';
 export type { ConversationMessage } from './events/conversationMessage';
 export type { RefundEvent } from './events/refund';
 export { REFUND_EVENT_VERSION } from './events/refund';
-export type { OrderEvent, OrderEventItem, OrderEventType, OrderEventStatus, OrderEventTranslatableName, } from './events/order';
+export type { OrderEvent, OrderEventIssuer, OrderEventItem, OrderEventType, OrderEventStatus, OrderEventTranslatableName, } from './events/order';
 export { ORDER_EVENT_VERSION } from './events/order';
+export type { FiscalizedPayment, FiscalizedPaymentStatus, } from './events/fiscalizedPayment';
+export { FISCALIZED_PAYMENT_EVENT_VERSION } from './events/fiscalizedPayment';
 export type { KafkaEvent, GenericKafkaEvent, EventPayloadHandler, GenericEventPayloadHandler, KafkaConfiguration, CustomTopicConfig, CustomTopicPoisonContext, CustomTopicPoisonHandler, } from './types';

package/dist/lib/kafka/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ORDER_EVENT_VERSION = exports.REFUND_EVENT_VERSION = exports.KafkaTopic = exports.KafkaClient = void 0;
+exports.FISCALIZED_PAYMENT_EVENT_VERSION = exports.ORDER_EVENT_VERSION = exports.REFUND_EVENT_VERSION = exports.KafkaTopic = exports.KafkaClient = void 0;
 var kafkaClient_1 = require("./kafkaClient");
 Object.defineProperty(exports, "KafkaClient", { enumerable: true, get: function () { return kafkaClient_1.KafkaClient; } });
 var events_1 = require("./events");
@@ -9,3 +9,5 @@ var refund_1 = require("./events/refund");
 Object.defineProperty(exports, "REFUND_EVENT_VERSION", { enumerable: true, get: function () { return refund_1.REFUND_EVENT_VERSION; } });
 var order_1 = require("./events/order");
 Object.defineProperty(exports, "ORDER_EVENT_VERSION", { enumerable: true, get: function () { return order_1.ORDER_EVENT_VERSION; } });
+var fiscalizedPayment_1 = require("./events/fiscalizedPayment");
+Object.defineProperty(exports, "FISCALIZED_PAYMENT_EVENT_VERSION", { enumerable: true, get: function () { return fiscalizedPayment_1.FISCALIZED_PAYMENT_EVENT_VERSION; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucaapp/service-utils",
-  "version": "5.37.1",
+  "version": "5.39.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [