@tolinax/ayoune-interfaces 2026.26.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",
@@ -406,6 +407,7 @@ export declare enum aMN {
     IndustryKPIs = "IndustryKPIs",
     MarketResearches = "MarketResearches",
     Markets = "Markets",
+    MaterialCommissionings = "MaterialCommissionings",
     MeetingLocations = "MeetingLocations",
     MeetingMinutes = "MeetingMinutes",
     Meetings = "Meetings",
@@ -443,12 +445,14 @@ export declare enum aMN {
     OwnDatas = "OwnDatas",
     OwnDataTemplates = "OwnDataTemplates",
     OwnValues = "OwnValues",
+    PackConfirmations = "PackConfirmations",
     PackLists = "PackLists",
     PageStats = "PageStats",
     PATs = "PATs",
     PaymentGroups = "PaymentGroups",
     PaymentProviders = "PaymentProviders",
     PermissionRequests = "PermissionRequests",
+    PickLists = "PickLists",
     PimSelections = "PimSelections",
     Pipelines = "Pipelines",
     Polls = "Polls",
@@ -495,6 +499,7 @@ export declare enum aMN {
     PublicationRuns = "PublicationRuns",
     Publications = "Publications",
     PublisherAPIs = "PublisherAPIs",
+    PutAwayOrders = "PutAwayOrders",
     PushClicks = "PushClicks",
     PushDeliveries = "PushDeliveries",
     PushErrors = "PushErrors",
@@ -512,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",
@@ -571,6 +578,7 @@ export declare enum aMN {
     StateLogs = "StateLogs",
     States = "States",
     StockLogs = "StockLogs",
+    StockReservations = "StockReservations",
     Stocks = "Stocks",
     StorageAreas = "StorageAreas",
     StoreAssets = "StoreAssets",

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";
@@ -410,6 +411,7 @@ var aMN;
     aMN["IndustryKPIs"] = "IndustryKPIs";
     aMN["MarketResearches"] = "MarketResearches";
     aMN["Markets"] = "Markets";
+    aMN["MaterialCommissionings"] = "MaterialCommissionings";
     aMN["MeetingLocations"] = "MeetingLocations";
     aMN["MeetingMinutes"] = "MeetingMinutes";
     aMN["Meetings"] = "Meetings";
@@ -447,12 +449,14 @@ var aMN;
     aMN["OwnDatas"] = "OwnDatas";
     aMN["OwnDataTemplates"] = "OwnDataTemplates";
     aMN["OwnValues"] = "OwnValues";
+    aMN["PackConfirmations"] = "PackConfirmations";
     aMN["PackLists"] = "PackLists";
     aMN["PageStats"] = "PageStats";
     aMN["PATs"] = "PATs";
     aMN["PaymentGroups"] = "PaymentGroups";
     aMN["PaymentProviders"] = "PaymentProviders";
     aMN["PermissionRequests"] = "PermissionRequests";
+    aMN["PickLists"] = "PickLists";
     aMN["PimSelections"] = "PimSelections";
     aMN["Pipelines"] = "Pipelines";
     aMN["Polls"] = "Polls";
@@ -499,6 +503,7 @@ var aMN;
     aMN["PublicationRuns"] = "PublicationRuns";
     aMN["Publications"] = "Publications";
     aMN["PublisherAPIs"] = "PublisherAPIs";
+    aMN["PutAwayOrders"] = "PutAwayOrders";
     aMN["PushClicks"] = "PushClicks";
     aMN["PushDeliveries"] = "PushDeliveries";
     aMN["PushErrors"] = "PushErrors";
@@ -516,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";
@@ -575,6 +582,7 @@ var aMN;
     aMN["StateLogs"] = "StateLogs";
     aMN["States"] = "States";
     aMN["StockLogs"] = "StockLogs";
+    aMN["StockReservations"] = "StockReservations";
     aMN["Stocks"] = "Stocks";
     aMN["StorageAreas"] = "StorageAreas";
     aMN["StoreAssets"] = "StoreAssets";

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",
@@ -4266,6 +4276,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "MaterialCommissionings",
+        singular: "MaterialCommissioning",
+        module: "warehouse",
+        right: "warehouse.materialcommissionings",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "MeetingLocations",
         singular: "MeetingLocation",
@@ -4643,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",
@@ -4693,6 +4723,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "PickLists",
+        singular: "PickList",
+        module: "warehouse",
+        right: "warehouse.picklists",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "PimSelections",
         singular: "PimSelection",
@@ -5151,6 +5191,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "PutAwayOrders",
+        singular: "PutAwayOrder",
+        module: "warehouse",
+        right: "warehouse.putawayorders",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "PushClicks",
         singular: "PushClick",
@@ -5301,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",
@@ -5363,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",
@@ -5843,6 +5913,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "StockReservations",
+        singular: "StockReservation",
+        module: "warehouse",
+        right: "warehouse.stockreservations",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "Stocks",
         singular: "Stock",

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/IMaterialCommissioning.d.ts

@@ -0,0 +1,58 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Material Commissioning Position — single material line in a commissioning order.
+ */
+export interface IMaterialCommissioningPosition {
+    pos: number;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    qtyRequired: number;
+    qtyReserved?: number;
+    qtyPicked?: number;
+    qtyDelivered?: number;
+    qtyConsumed?: number;
+    qtyReturned?: number;
+    unit?: string;
+    lot?: ObjectId;
+    storageArea?: ObjectId;
+    warehouse?: ObjectId;
+    stockReservation?: ObjectId;
+    status: "pending" | "reserved" | "picked" | "delivered" | "consumed" | "returned" | "short";
+    pickedAt?: Date;
+    deliveredAt?: Date;
+    consumedAt?: Date;
+    note?: string;
+}
+/**
+ * Material Commissioning — formal workflow for picking and delivering material to a production step.
+ *
+ * Solves the gap that material is currently embedded as a subdocument in IProductionOrder.material[]
+ * and IProductionOrdersPosition.material[] without standalone CRUD or audit trail.
+ *
+ * Lifecycle: planned → reserved → picking → delivered → consumed
+ */
+export interface IMaterialCommissioning extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    status: "planned" | "reserved" | "picking" | "delivered" | "consumed" | "cancelled";
+    productionOrder: ObjectId;
+    productionOrderPosition?: number;
+    productionOrderPositionStep?: number;
+    workCenter?: ObjectId;
+    machine?: ObjectId;
+    positions: IMaterialCommissioningPosition[];
+    totalLines?: number;
+    completedLines?: number;
+    progress?: number;
+    pickList?: ObjectId;
+    plannedFor?: Date;
+    reservedAt?: Date;
+    pickedAt?: Date;
+    deliveredAt?: Date;
+    consumedAt?: Date;
+    deliveredBy?: ObjectId;
+    note?: string;
+}

package/interfaces/IMaterialCommissioning.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/IPickList.d.ts

@@ -0,0 +1,68 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Pick List Position — single line in a pick list.
+ */
+export interface IPickListPosition {
+    pos: number;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    storageArea?: ObjectId;
+    warehouse?: ObjectId;
+    qtyRequested: number;
+    qtyPicked?: number;
+    qtyMissing?: number;
+    unit?: string;
+    lot?: ObjectId;
+    lotNumber?: string;
+    serialNumbers?: string[];
+    sourceType: "assignment" | "productionOrder" | "shipping" | "internalOrder" | "manual";
+    sourceId: ObjectId;
+    sourcePosition?: number;
+    sourceStep?: number;
+    stockReservation?: ObjectId;
+    status: "pending" | "picked" | "short" | "skipped" | "cancelled";
+    pickedAt?: Date;
+    pickedBy?: ObjectId;
+    note?: string;
+    skipReason?: string;
+}
+/**
+ * Pick List — formal picking instruction for warehouse workers.
+ *
+ * Replaces the gap where IPackList was used loosely for both picking and packing.
+ * IPickList is strictly for picking; IPackList stays for packing.
+ *
+ * Picking strategies:
+ * - single_order: one assignment / production order per pick
+ * - wave: multiple orders grouped, picker walks once
+ * - batch: same product across many orders, then sort
+ * - cluster: multiple bins on a cart, sorted in real-time
+ */
+export interface IPickList extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    name?: string;
+    status: "open" | "in_progress" | "completed" | "cancelled";
+    type: "single_order" | "wave" | "batch" | "cluster";
+    warehouse: ObjectId;
+    assignedTo?: ObjectId;
+    assignments?: ObjectId[];
+    productionOrders?: ObjectId[];
+    shippings?: ObjectId[];
+    internalOrders?: ObjectId[];
+    pickWave?: ObjectId;
+    positions: IPickListPosition[];
+    totalLines?: number;
+    pickedLines?: number;
+    progress?: number;
+    pickingStrategy?: "fifo" | "lifo" | "fefo" | "random" | "shortest_path";
+    walkingPath?: ObjectId[];
+    startedAt?: Date;
+    completedAt?: Date;
+    deadline?: Date;
+    pickConfirmation?: ObjectId;
+    note?: string;
+}

package/interfaces/IPickList.js

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

package/interfaces/IPutAwayOrder.d.ts

@@ -0,0 +1,58 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Put-Away Position — single line in a put-away order.
+ */
+export interface IPutAwayPosition {
+    pos: number;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    qty: number;
+    unit?: string;
+    lot?: ObjectId;
+    lotNumber?: string;
+    serialNumbers?: string[];
+    sourceArea?: ObjectId;
+    suggestedArea?: ObjectId;
+    suggestedReason?: "empty_bin" | "same_product" | "abc_class" | "fefo" | "fifo" | "manual";
+    actualArea?: ObjectId;
+    placedAt?: Date;
+    placedBy?: ObjectId;
+    status: "pending" | "placed" | "skipped";
+    note?: string;
+}
+/**
+ * Put-Away Order — instruction for warehouse workers to place received goods in storage.
+ *
+ * Solves the gap that after a GoodsReceipt is approved, there is no formal instruction
+ * where to put the items. Receiving area accumulates without systematic placement.
+ *
+ * Strategies:
+ * - empty_bin: prefer empty storage areas first
+ * - same_product: consolidate with existing stock of same product
+ * - abc_class: place high-velocity items in close locations
+ * - fefo: first-expiry-first-out (for perishables)
+ * - fifo: first-in-first-out
+ * - manual: warehouse worker decides
+ */
+export interface IPutAwayOrder extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    status: "pending" | "in_progress" | "completed" | "cancelled";
+    warehouse: ObjectId;
+    assignedTo?: ObjectId;
+    goodsReceipt?: ObjectId;
+    productionOrder?: ObjectId;
+    internalOrder?: ObjectId;
+    returnOrder?: ObjectId;
+    strategy?: "empty_bin" | "same_product" | "abc_class" | "fefo" | "fifo" | "manual";
+    positions: IPutAwayPosition[];
+    totalLines?: number;
+    completedLines?: number;
+    progress?: number;
+    startedAt?: Date;
+    completedAt?: Date;
+    note?: string;
+}

package/interfaces/IPutAwayOrder.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/IStock.d.ts

@@ -8,6 +8,14 @@ export interface IStock extends IDefaultFields {
     warehouse?: ObjectId;
     storageArea?: ObjectId;
     amount?: number;
+    /** Sum of active stock reservations against this stock record (computed). */
+    amountReserved?: number;
+    /** amount - amountReserved (computed). Authoritative for available-to-promise. */
+    amountAvailable?: number;
+    /** Quantity currently in quality control. */
+    amountInQC?: number;
+    /** Quantity currently in quarantine. */
+    amountInQuarantine?: number;
     unit?: string;
     serialNumber?: string;
     lotNumber?: string;

package/interfaces/IStockLog.d.ts

@@ -1,4 +1,32 @@
 import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Canonical movement types for stock log entries.
+ *
+ * Use these constants instead of free-form strings to prevent typos.
+ * The `kindofmovement` field on IStockLog stays a `string` for backward compat —
+ * but new code should use values from this enum.
+ */
+export declare enum StockMovementKind {
+    Incoming = "incoming",
+    Outgoing = "outgoing",
+    Transfer = "transfer",
+    Reservation = "reservation",
+    ReservationRelease = "reservation_release",
+    Production = "production",
+    Consumption = "consumption",
+    PutAway = "putaway",
+    Picking = "picking",
+    Pack = "pack",
+    Ship = "ship",
+    Return = "return",
+    Adjustment = "adjustment",
+    QuarantineIn = "quarantine_in",
+    QuarantineOut = "quarantine_out",
+    QcIn = "qc_in",
+    QcOut = "qc_out",
+    Replenishment = "replenishment",
+    InventoryCount = "inventory_count"
+}
 export interface IStockLog extends IDefaultFields {
     _customerID: ObjectId;
     _clientID?: ObjectId[];

package/interfaces/IStockLog.js

@@ -1,2 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.StockMovementKind = void 0;
+/**
+ * Canonical movement types for stock log entries.
+ *
+ * Use these constants instead of free-form strings to prevent typos.
+ * The `kindofmovement` field on IStockLog stays a `string` for backward compat —
+ * but new code should use values from this enum.
+ */
+var StockMovementKind;
+(function (StockMovementKind) {
+    StockMovementKind["Incoming"] = "incoming";
+    StockMovementKind["Outgoing"] = "outgoing";
+    StockMovementKind["Transfer"] = "transfer";
+    StockMovementKind["Reservation"] = "reservation";
+    StockMovementKind["ReservationRelease"] = "reservation_release";
+    StockMovementKind["Production"] = "production";
+    StockMovementKind["Consumption"] = "consumption";
+    StockMovementKind["PutAway"] = "putaway";
+    StockMovementKind["Picking"] = "picking";
+    StockMovementKind["Pack"] = "pack";
+    StockMovementKind["Ship"] = "ship";
+    StockMovementKind["Return"] = "return";
+    StockMovementKind["Adjustment"] = "adjustment";
+    StockMovementKind["QuarantineIn"] = "quarantine_in";
+    StockMovementKind["QuarantineOut"] = "quarantine_out";
+    StockMovementKind["QcIn"] = "qc_in";
+    StockMovementKind["QcOut"] = "qc_out";
+    StockMovementKind["Replenishment"] = "replenishment";
+    StockMovementKind["InventoryCount"] = "inventory_count";
+})(StockMovementKind || (exports.StockMovementKind = StockMovementKind = {}));

package/interfaces/IStockReservation.d.ts

@@ -0,0 +1,35 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Stock Reservation — quantitative reservation of stock for a specific source document.
+ *
+ * Solves the gap that IStock only knows `amount` (no available vs. reserved distinction)
+ * and IAssignment.stock_booked is just a boolean flag.
+ *
+ * Lifecycle: active → fulfilled (when picked) | released (manual cancel) | expired (TTL).
+ */
+export interface IStockReservation extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    product: ObjectId;
+    warehouse: ObjectId;
+    storageArea?: ObjectId;
+    lot?: ObjectId;
+    serialNumbers?: string[];
+    qtyReserved: number;
+    qtyFulfilled?: number;
+    unit?: string;
+    sourceType: "assignment" | "productionOrder" | "internalOrder" | "shipping" | "manual";
+    sourceId: ObjectId;
+    sourcePosition?: number;
+    sourceStep?: number;
+    status: "active" | "released" | "fulfilled" | "expired";
+    reservedAt?: Date;
+    expiresAt?: Date;
+    releasedAt?: Date;
+    fulfilledAt?: Date;
+    priority?: number;
+    pickList?: ObjectId;
+    reservedBy?: ObjectId;
+    note?: string;
+}

package/interfaces/IStockReservation.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";
@@ -429,6 +430,7 @@ export * from "./IMarketBudgetByIndustry";
 export * from "./IIndustryKPI";
 export * from "./IMarketResearch";
 export * from "./IMaterial";
+export * from "./IMaterialCommissioning";
 export * from "./IMeeting";
 export * from "./IMeetingGroup";
 export * from "./IEventRegisterView";
@@ -470,12 +472,14 @@ export * from "./IOverride";
 export * from "./IOwnData";
 export * from "./IOwnDataTemplate";
 export * from "./IOwnValue";
+export * from "./IPackConfirmation";
 export * from "./IPackList";
 export * from "./IPageStat";
 export * from "./IPAT";
 export * from "./IPaymentGroup";
 export * from "./IPaymentProvider";
 export * from "./IPermissionRequest";
+export * from "./IPickList";
 export * from "./IPimSelection";
 export * from "./IPipeline";
 export * from "./IPoints";
@@ -527,6 +531,7 @@ export * from "./IPublication";
 export * from "./IPublicationOptions";
 export * from "./IPublicationRun";
 export * from "./IPublisherAPI";
+export * from "./IPutAwayOrder";
 export * from "./IPushClick";
 export * from "./IPushDelivery";
 export * from "./IPushError";
@@ -543,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";
@@ -550,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";
@@ -609,6 +616,7 @@ export * from "./IState";
 export * from "./IStateLog";
 export * from "./IStock";
 export * from "./IStockLog";
+export * from "./IStockReservation";
 export * from "./IStorageArea";
 export * from "./IStore";
 export * from "./IStoreAsset";

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);
@@ -445,6 +446,7 @@ __exportStar(require("./IMarketBudgetByIndustry"), exports);
 __exportStar(require("./IIndustryKPI"), exports);
 __exportStar(require("./IMarketResearch"), exports);
 __exportStar(require("./IMaterial"), exports);
+__exportStar(require("./IMaterialCommissioning"), exports);
 __exportStar(require("./IMeeting"), exports);
 __exportStar(require("./IMeetingGroup"), exports);
 __exportStar(require("./IEventRegisterView"), exports);
@@ -486,12 +488,14 @@ __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);
 __exportStar(require("./IPaymentGroup"), exports);
 __exportStar(require("./IPaymentProvider"), exports);
 __exportStar(require("./IPermissionRequest"), exports);
+__exportStar(require("./IPickList"), exports);
 __exportStar(require("./IPimSelection"), exports);
 __exportStar(require("./IPipeline"), exports);
 __exportStar(require("./IPoints"), exports);
@@ -543,6 +547,7 @@ __exportStar(require("./IPublication"), exports);
 __exportStar(require("./IPublicationOptions"), exports);
 __exportStar(require("./IPublicationRun"), exports);
 __exportStar(require("./IPublisherAPI"), exports);
+__exportStar(require("./IPutAwayOrder"), exports);
 __exportStar(require("./IPushClick"), exports);
 __exportStar(require("./IPushDelivery"), exports);
 __exportStar(require("./IPushError"), exports);
@@ -559,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);
@@ -566,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);
@@ -625,6 +632,7 @@ __exportStar(require("./IState"), exports);
 __exportStar(require("./IStateLog"), exports);
 __exportStar(require("./IStock"), exports);
 __exportStar(require("./IStockLog"), exports);
+__exportStar(require("./IStockReservation"), exports);
 __exportStar(require("./IStorageArea"), exports);
 __exportStar(require("./IStore"), exports);
 __exportStar(require("./IStoreAsset"), exports);

package/package.json

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