@reservation-studio/electron-types 0.0.30 → 0.0.32

package/dist/interfaces/public/fiscal-device/receipts.types.d.ts

@@ -0,0 +1,170 @@
+import { BarcodeData, OperatorInfo } from './shared.types';
+/**
+ * Common payload fields shared by fiscal and non-fiscal receipts.
+ */
+export interface BaseReceipt {
+    /**
+     * Operator information
+     */
+    operator: OperatorInfo;
+    /**
+     * The items in the receipt
+     */
+    items: FiscalReceiptItem[];
+    /**
+     * The client information (for invoice receipts)
+     */
+    client?: FiscalClient;
+    /**
+     * Optional text lines to be printed immediately after the receipt header.
+     */
+    headerText?: string[];
+    /**
+     * Optional text lines to be printed at the end of the receipt (before payments).
+     */
+    footerText?: string[];
+    /**
+     * Optional barcode to be printed at the end of the receipt (footer).
+     * Useful for loyalty programs, order tracking, or return vouchers.
+     */
+    footerBarcode?: BarcodeData;
+}
+/**
+ * Interface for fiscal receipt
+ */
+export interface FiscalReceipt extends BaseReceipt {
+    /**
+     * Numeric string up to 7 digits, used as part of the UNP.
+     */
+    uniqueSaleNumber: string;
+    /**
+     * The payments in the receipt. The total must cover the receipt amount to close.
+     */
+    payments: FiscalPayment[];
+}
+/**
+ * Interface for non-fiscal (service) receipt
+ */
+export interface NonFiscalReceipt extends BaseReceipt {
+    /**
+     * Optional informational payments printed on the receipt.
+     */
+    payments?: FiscalPayment[];
+}
+/**
+ * Interface for fiscal receipt item
+ */
+export interface FiscalReceiptItem {
+    /**
+     * The name of the item
+     */
+    name: string;
+    /**
+     * Optional description providing additional information or context.
+     * This can be used to supply user-friendly details or explanations
+     * associated with a particular resource, item, or operation.
+     */
+    description?: string;
+    /**
+     * The price of the item including tax (VAT inclusive).
+     * This price will be sent directly to the fiscal device and must include all applicable taxes.
+     */
+    unitPrice: number;
+    /**
+     * The quantity of the item
+     */
+    quantity: number;
+    /**
+     * The VAT group of the item
+     */
+    vatGroup: FiscalVATGroup;
+    /**
+     * Discount percentage (optional). Use 0-100, no surcharges.
+     */
+    discount?: number;
+}
+/**
+ * Interface for fiscal payment
+ */
+export interface FiscalPayment {
+    /**
+     * The payment type
+     */
+    type: FiscalPaymentType;
+    /**
+     * The amount of the payment
+     */
+    amount: number;
+}
+/**
+ * Enum for fiscal payment types
+ */
+export declare enum FiscalPaymentType {
+    CASH = "cash",
+    CARD = "card",
+    CHECK = "check",
+    TRANSFER = "transfer"
+}
+/**
+ * Interface for fiscal client information
+ */
+export interface FiscalClient {
+    /**
+     * The name of the client
+     */
+    name: string;
+    /**
+     * The address of the client
+     */
+    address?: string;
+    /**
+     * The tax number of the client
+     */
+    taxNumber?: string;
+    /**
+     * The VAT number of the client
+     */
+    vatNumber?: string;
+}
+/**
+ * Interface for reversal receipt
+ */
+export interface ReversalReceipt extends FiscalReceipt {
+    /**
+     * The reason for the reversal
+     */
+    reason: ReversalReason;
+    /**
+     * The original receipt number
+     */
+    originalReceiptNumber: string;
+    /**
+     * The original receipt date and time
+     */
+    originalReceiptDateTime: Date;
+    /**
+     * The original fiscal memory serial number
+     */
+    originalFiscalMemorySerialNumber: string;
+}
+/**
+ * Enum for reversal reasons
+ */
+export declare enum ReversalReason {
+    VOID = "void",
+    REFUND = "refund",
+    TAX_BASE_REDUCTION = "tax-base-reduction"
+}
+/**
+ * Enum for fiscal VAT groups
+ */
+export declare enum FiscalVATGroup {
+    A = "1",// 20%
+    B = "2",// 9%
+    C = "3",// 0%
+    D = "4",// Exempt
+    E = "5",// Special rate 1
+    F = "6",// Special rate 2
+    G = "7",// Special rate 3
+    H = "8"
+}

package/dist/interfaces/{fiscal-device.interface.js → public/fiscal-device/receipts.types.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BarcodeType = exports.FiscalVATGroup = exports.ReversalReason = exports.FiscalPaymentType = void 0;
+exports.FiscalVATGroup = exports.ReversalReason = exports.FiscalPaymentType = void 0;
 /**
  * Enum for fiscal payment types
  */
@@ -16,7 +16,7 @@ var FiscalPaymentType;
  */
 var ReversalReason;
 (function (ReversalReason) {
-    ReversalReason["OPERATOR_ERROR"] = "operator-error";
+    ReversalReason["VOID"] = "void";
     ReversalReason["REFUND"] = "refund";
     ReversalReason["TAX_BASE_REDUCTION"] = "tax-base-reduction";
 })(ReversalReason || (exports.ReversalReason = ReversalReason = {}));
@@ -34,10 +34,3 @@ var FiscalVATGroup;
     FiscalVATGroup["G"] = "7";
     FiscalVATGroup["H"] = "8"; // Special rate 4
 })(FiscalVATGroup || (exports.FiscalVATGroup = FiscalVATGroup = {}));
-var BarcodeType;
-(function (BarcodeType) {
-    BarcodeType["EAN8"] = "EAN8";
-    BarcodeType["EAN13"] = "EAN13";
-    BarcodeType["CODE128"] = "CODE128";
-    BarcodeType["QR"] = "QR";
-})(BarcodeType || (exports.BarcodeType = BarcodeType = {}));

package/dist/interfaces/public/fiscal-device/shared.types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Types for fiscal device communication between renderer and main process.
+ */
+export type DeviceId = string;
+export type TransportType = 'serial' | 'tcp' | 'bluetooth-spp' | 'bluetooth-ble' | 'hid' | 'sdk';
+/**
+ * Interface for operator information
+ */
+export interface OperatorInfo {
+    /**
+     * The operator number
+     */
+    number: number;
+    /**
+     * A string representing the password for authentication or security purposes.
+     * This variable typically holds sensitive information and should be handled securely.
+     * Ensure this value is kept private and not exposed in any logs or outputs.
+     */
+    password: string;
+    /**
+     * Optional operator code. If not provided, driver may derive it from operator number.
+     */
+    code?: string;
+}
+export declare enum BarcodeType {
+    EAN8 = "EAN8",
+    EAN13 = "EAN13",
+    CODE128 = "CODE128",
+    QR = "QR"
+}
+export interface BarcodeData {
+    type: BarcodeType;
+    data: string;
+    height?: number;
+    printText?: boolean;
+}

package/dist/interfaces/public/fiscal-device/shared.types.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BarcodeType = void 0;
+var BarcodeType;
+(function (BarcodeType) {
+    BarcodeType["EAN8"] = "EAN8";
+    BarcodeType["EAN13"] = "EAN13";
+    BarcodeType["CODE128"] = "CODE128";
+    BarcodeType["QR"] = "QR";
+})(BarcodeType || (exports.BarcodeType = BarcodeType = {}));

package/dist/interfaces/public/http.interface.js

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

package/dist/interfaces/public/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api.interface';
+export * from './certificate-info.interface';
+export * from './http.interface';
+export * from './fiscal-device';

package/dist/interfaces/public/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./api.interface"), exports);
+__exportStar(require("./certificate-info.interface"), exports);
+__exportStar(require("./http.interface"), exports);
+__exportStar(require("./fiscal-device"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reservation-studio/electron-types",
-  "version": "0.0.30",
+  "version": "0.0.32",
   "description": "TypeScript типове за ReservationStudioElectron",
   "scripts": {
     "build": "tsc --project tsconfig.json",