@tolinax/ayoune-interfaces 2026.27.0 → 2026.28.0

package/data/modelNames.d.ts

@@ -136,6 +136,7 @@ export declare enum aMN {
     aYOUneUsers = "aYOUneUsers",
     aYOUneVariables = "aYOUneVariables",
     aYOUneWidgets = "aYOUneWidgets",
+    Backorders = "Backorders",
     BankAccounts = "BankAccounts",
     BankTurnovers = "BankTurnovers",
     Beacons = "Beacons",
@@ -444,6 +445,7 @@ export declare enum aMN {
     OwnDatas = "OwnDatas",
     OwnDataTemplates = "OwnDataTemplates",
     OwnValues = "OwnValues",
+    PackConfirmations = "PackConfirmations",
     PackLists = "PackLists",
     PageStats = "PageStats",
     PATs = "PATs",
@@ -515,12 +517,14 @@ export declare enum aMN {
     Reminders = "Reminders",
     References = "References",
     CustomerLogos = "CustomerLogos",
+    ReplenishmentOrders = "ReplenishmentOrders",
     Reports = "Reports",
     ReportTemplates = "ReportTemplates",
     Repositories = "Repositories",
     Requirements = "Requirements",
     ResearchBudgets = "ResearchBudgets",
     Retrospectives = "Retrospectives",
+    ReturnOrders = "ReturnOrders",
     RewardLogs = "RewardLogs",
     RewardRules = "RewardRules",
     RunningPipelines = "RunningPipelines",

package/data/modelNames.js

@@ -140,6 +140,7 @@ var aMN;
     aMN["aYOUneUsers"] = "aYOUneUsers";
     aMN["aYOUneVariables"] = "aYOUneVariables";
     aMN["aYOUneWidgets"] = "aYOUneWidgets";
+    aMN["Backorders"] = "Backorders";
     aMN["BankAccounts"] = "BankAccounts";
     aMN["BankTurnovers"] = "BankTurnovers";
     aMN["Beacons"] = "Beacons";
@@ -448,6 +449,7 @@ var aMN;
     aMN["OwnDatas"] = "OwnDatas";
     aMN["OwnDataTemplates"] = "OwnDataTemplates";
     aMN["OwnValues"] = "OwnValues";
+    aMN["PackConfirmations"] = "PackConfirmations";
     aMN["PackLists"] = "PackLists";
     aMN["PageStats"] = "PageStats";
     aMN["PATs"] = "PATs";
@@ -519,12 +521,14 @@ var aMN;
     aMN["Reminders"] = "Reminders";
     aMN["References"] = "References";
     aMN["CustomerLogos"] = "CustomerLogos";
+    aMN["ReplenishmentOrders"] = "ReplenishmentOrders";
     aMN["Reports"] = "Reports";
     aMN["ReportTemplates"] = "ReportTemplates";
     aMN["Repositories"] = "Repositories";
     aMN["Requirements"] = "Requirements";
     aMN["ResearchBudgets"] = "ResearchBudgets";
     aMN["Retrospectives"] = "Retrospectives";
+    aMN["ReturnOrders"] = "ReturnOrders";
     aMN["RewardLogs"] = "RewardLogs";
     aMN["RewardRules"] = "RewardRules";
     aMN["RunningPipelines"] = "RunningPipelines";

package/data/modelsAndRights.js

@@ -1691,6 +1691,16 @@ const modelsAndRights = [
         searchable: true,
         searchableFields: ['name', 'description'],
     },
+    {
+        plural: "Backorders",
+        singular: "Backorder",
+        module: "warehouse",
+        right: "warehouse.backorders",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "BankAccounts",
         singular: "BankAccount",
@@ -4653,6 +4663,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "PackConfirmations",
+        singular: "PackConfirmation",
+        module: "warehouse",
+        right: "warehouse.packconfirmations",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "PackLists",
         singular: "PackList",
@@ -5331,6 +5351,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "ReplenishmentOrders",
+        singular: "ReplenishmentOrder",
+        module: "warehouse",
+        right: "warehouse.replenishmentorders",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "Reports",
         singular: "Report",
@@ -5393,6 +5423,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "ReturnOrders",
+        singular: "ReturnOrder",
+        module: "warehouse",
+        right: "warehouse.returnorders",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "RewardLogs",
         singular: "RewardLog",

package/interfaces/IBackorder.d.ts

@@ -0,0 +1,35 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Backorder — tracks unfilled portion of a sales order when stock is short.
+ *
+ * Solves the gap that IAssignment only has `overSupply`/`underSupply` boolean flags
+ * with no quantitative tracking and no auto-fulfillment when stock arrives.
+ *
+ * Lifecycle: open → partial → fulfilled | cancelled
+ */
+export interface IBackorder extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    assignment: ObjectId;
+    assignmentPosition?: number;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    unit?: string;
+    qtyOrdered: number;
+    qtyShipped: number;
+    qtyOpen: number;
+    expectedDate?: Date;
+    promisedDate?: Date;
+    priority: number;
+    autoFulfill: boolean;
+    status: "open" | "partial" | "fulfilled" | "cancelled";
+    fulfillmentReservations?: ObjectId[];
+    fulfilledShippings?: ObjectId[];
+    fulfilledAt?: Date;
+    cancelledAt?: Date;
+    cancelReason?: string;
+    note?: string;
+}

package/interfaces/IBackorder.js

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

package/interfaces/IPackConfirmation.d.ts

@@ -0,0 +1,64 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Single product entry inside a packed box.
+ */
+export interface IPackedItem {
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    qty: number;
+    unit?: string;
+    lot?: ObjectId;
+    lotNumber?: string;
+    serialNumbers?: string[];
+}
+/**
+ * One physical box that was packed during a pack confirmation.
+ */
+export interface IPackedBox {
+    pos: number;
+    shippingBox?: ObjectId;
+    boxLabel?: string;
+    contents: IPackedItem[];
+    actualNetWeight?: number;
+    actualGrossWeight?: number;
+    actualLength?: number;
+    actualWidth?: number;
+    actualHeight?: number;
+    actualVolume?: number;
+    trackingNumber?: string;
+    carrierLabel?: string;
+    sealed?: boolean;
+    sealedAt?: Date;
+}
+/**
+ * Pack Confirmation — captures the actual outcome of a packing operation.
+ *
+ * Solves the gap that IPackList tracks what SHOULD be packed but never the actual
+ * boxes filled. Without this, "soll vs. ist" comparison and tracking-number capture
+ * are not possible.
+ *
+ * One-to-one with PackList (or PickList for direct pick-and-pack flows).
+ */
+export interface IPackConfirmation extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    status: "in_progress" | "completed" | "cancelled";
+    packList?: ObjectId;
+    pickList?: ObjectId;
+    shipping?: ObjectId;
+    assignment?: ObjectId;
+    productionOrder?: ObjectId;
+    warehouse?: ObjectId;
+    packedBy?: ObjectId;
+    startedAt?: Date;
+    packedAt?: Date;
+    boxes: IPackedBox[];
+    totalBoxes?: number;
+    totalItems?: number;
+    totalWeight?: number;
+    totalVolume?: number;
+    note?: string;
+}

package/interfaces/IPackConfirmation.js

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

package/interfaces/IReplenishmentOrder.d.ts

@@ -0,0 +1,54 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Replenishment Position — single line in a replenishment order.
+ */
+export interface IReplenishmentPosition {
+    pos: number;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    sourceArea: ObjectId;
+    targetArea: ObjectId;
+    qtyRequested: number;
+    qtyMoved: number;
+    unit?: string;
+    lot?: ObjectId;
+    status: "pending" | "in_progress" | "moved" | "skipped";
+    movedAt?: Date;
+    movedBy?: ObjectId;
+    skipReason?: string;
+    note?: string;
+}
+/**
+ * Replenishment Order — moves stock from bulk storage to pick faces.
+ *
+ * Solves the gap that there is no mechanism to refill pick locations from
+ * reserve/bulk storage when min levels are reached. Critical for multi-tier
+ * warehouses with fast-moving items.
+ *
+ * Triggers:
+ * - min_level: storage area dropped below configured min qty
+ * - manual: warehouse worker requested
+ * - forecast: predictive based on demand patterns
+ * - wave: triggered by upcoming pick wave
+ */
+export interface IReplenishmentOrder extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    warehouse: ObjectId;
+    trigger: "min_level" | "manual" | "forecast" | "wave";
+    status: "pending" | "in_progress" | "completed" | "cancelled";
+    priority: number;
+    assignedTo?: ObjectId;
+    pickWave?: ObjectId;
+    positions: IReplenishmentPosition[];
+    totalLines?: number;
+    movedLines?: number;
+    progress?: number;
+    triggeredAt?: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    note?: string;
+}

package/interfaces/IReplenishmentOrder.js

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

package/interfaces/IReturnOrder.d.ts

@@ -0,0 +1,68 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Return Order Position — single line in an RMA.
+ */
+export interface IReturnPosition {
+    pos: number;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    unit?: string;
+    originalInvoicePosition?: number;
+    originalShippingPosition?: number;
+    qtyReturned: number;
+    qtyReceived: number;
+    qtyRestockable: number;
+    qtyRepairable: number;
+    qtyDisposed: number;
+    qtyReturnedToSupplier: number;
+    conditionOnReceipt?: "new" | "used" | "damaged" | "unsellable";
+    inspectionResult?: "restock" | "repair" | "dispose" | "return_to_supplier";
+    inspectionNote?: string;
+    targetStorageArea?: ObjectId;
+    targetWarehouse?: ObjectId;
+    creditNote?: ObjectId;
+    replacementShipping?: ObjectId;
+    status: "pending" | "received" | "inspected" | "restocked" | "disposed" | "rejected";
+}
+/**
+ * Return Order (RMA) — formal returns workflow.
+ *
+ * Solves the gap that the platform only has a `retour: boolean` flag on IStorageArea
+ * and no formal return process linking original orders to refunds/replacements.
+ *
+ * Lifecycle: requested → approved → received → inspected → completed | rejected
+ */
+export interface IReturnOrder extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    rmaNumber: string;
+    consumer?: ObjectId;
+    user?: ObjectId;
+    status: "requested" | "approved" | "received" | "inspected" | "completed" | "rejected";
+    originalInvoice?: ObjectId;
+    originalShipping?: ObjectId;
+    originalAssignment?: ObjectId;
+    customerReason: string;
+    customerNote?: string;
+    approvedBy?: ObjectId;
+    approvedAt?: Date;
+    rejectedReason?: string;
+    rejectedAt?: Date;
+    receivedAt?: Date;
+    receivedBy?: ObjectId;
+    receivedAtWarehouse?: ObjectId;
+    inspectedAt?: Date;
+    inspectedBy?: ObjectId;
+    completedAt?: Date;
+    resolutionType?: "refund" | "replacement" | "repair" | "store_credit" | "reject";
+    creditNote?: ObjectId;
+    replacementShipping?: ObjectId;
+    refundAmount?: number;
+    positions: IReturnPosition[];
+    totalLines?: number;
+    inspectedLines?: number;
+    progress?: number;
+    note?: string;
+}

package/interfaces/IReturnOrder.js

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

package/interfaces/index.d.ts

@@ -143,6 +143,7 @@ export * from "./IaYOUneUserAgent";
 export * from "./IaYOUneUserRight";
 export * from "./IaYOUneVariable";
 export * from "./IaYOUneWidget";
+export * from "./IBackorder";
 export * from "./IBankAccount";
 export * from "./IBankTurnover";
 export * from "./IBeacon";
@@ -471,6 +472,7 @@ export * from "./IOverride";
 export * from "./IOwnData";
 export * from "./IOwnDataTemplate";
 export * from "./IOwnValue";
+export * from "./IPackConfirmation";
 export * from "./IPackList";
 export * from "./IPageStat";
 export * from "./IPAT";
@@ -546,6 +548,7 @@ export * from "./IReaction";
 export * from "./IRecommendation";
 export * from "./IRecommendationTemplate";
 export * from "./IReminder";
+export * from "./IReplenishmentOrder";
 export * from "./IReport";
 export * from "./IReportTemplate";
 export * from "./IRepository";
@@ -553,6 +556,7 @@ export * from "./IRequirement";
 export * from "./IRequirementSchema";
 export * from "./IResearchBudget";
 export * from "./IRetrospective";
+export * from "./IReturnOrder";
 export * from "./IRewardLog";
 export * from "./IRewardRule";
 export * from "./IRolloutEnvironment";

package/interfaces/index.js

@@ -159,6 +159,7 @@ __exportStar(require("./IaYOUneUserAgent"), exports);
 __exportStar(require("./IaYOUneUserRight"), exports);
 __exportStar(require("./IaYOUneVariable"), exports);
 __exportStar(require("./IaYOUneWidget"), exports);
+__exportStar(require("./IBackorder"), exports);
 __exportStar(require("./IBankAccount"), exports);
 __exportStar(require("./IBankTurnover"), exports);
 __exportStar(require("./IBeacon"), exports);
@@ -487,6 +488,7 @@ __exportStar(require("./IOverride"), exports);
 __exportStar(require("./IOwnData"), exports);
 __exportStar(require("./IOwnDataTemplate"), exports);
 __exportStar(require("./IOwnValue"), exports);
+__exportStar(require("./IPackConfirmation"), exports);
 __exportStar(require("./IPackList"), exports);
 __exportStar(require("./IPageStat"), exports);
 __exportStar(require("./IPAT"), exports);
@@ -562,6 +564,7 @@ __exportStar(require("./IReaction"), exports);
 __exportStar(require("./IRecommendation"), exports);
 __exportStar(require("./IRecommendationTemplate"), exports);
 __exportStar(require("./IReminder"), exports);
+__exportStar(require("./IReplenishmentOrder"), exports);
 __exportStar(require("./IReport"), exports);
 __exportStar(require("./IReportTemplate"), exports);
 __exportStar(require("./IRepository"), exports);
@@ -569,6 +572,7 @@ __exportStar(require("./IRequirement"), exports);
 __exportStar(require("./IRequirementSchema"), exports);
 __exportStar(require("./IResearchBudget"), exports);
 __exportStar(require("./IRetrospective"), exports);
+__exportStar(require("./IReturnOrder"), exports);
 __exportStar(require("./IRewardLog"), exports);
 __exportStar(require("./IRewardRule"), exports);
 __exportStar(require("./IRolloutEnvironment"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tolinax/ayoune-interfaces",
-  "version": "2026.27.0",
+  "version": "2026.28.0",
   "description": "Houses TypeScript interfaces for aYOUne",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",