@tolinax/ayoune-interfaces 2026.28.0 → 2026.30.0

package/data/modelNames.d.ts

@@ -253,6 +253,8 @@ export declare enum aMN {
     DevOpsAlerts = "DevOpsAlerts",
     DiscountGroups = "DiscountGroups",
     DMCampaigns = "DMCampaigns",
+    DockAppointments = "DockAppointments",
+    Docks = "Docks",
     Documents = "Documents",
     DoiLogs = "DoiLogs",
     Dois = "Dois",
@@ -352,6 +354,7 @@ export declare enum aMN {
     InternalChatMessages = "InternalChatMessages",
     InternalForms = "InternalForms",
     InternalOrders = "InternalOrders",
+    InventoryAdjustments = "InventoryAdjustments",
     InventoryLists = "InventoryLists",
     Invoices = "Invoices",
     IoTDevices = "IoTDevices",
@@ -453,6 +456,7 @@ export declare enum aMN {
     PaymentProviders = "PaymentProviders",
     PermissionRequests = "PermissionRequests",
     PickLists = "PickLists",
+    PickWaves = "PickWaves",
     PimSelections = "PimSelections",
     Pipelines = "Pipelines",
     Polls = "Polls",
@@ -609,8 +613,12 @@ export declare enum aMN {
     TextLinks = "TextLinks",
     Tickets = "Tickets",
     Tips = "Tips",
+    TradeChannelEvents = "TradeChannelEvents",
+    TradeChannelOrders = "TradeChannelOrders",
+    TradeChannels = "TradeChannels",
     Trades = "Trades",
     Transactions = "Transactions",
+    TransportOrders = "TransportOrders",
     Travels = "Travels",
     TriggerActionsLogs = "TriggerActionsLogs",
     TriggerChains = "TriggerChains",

package/data/modelNames.js

@@ -257,6 +257,8 @@ var aMN;
     aMN["DevOpsAlerts"] = "DevOpsAlerts";
     aMN["DiscountGroups"] = "DiscountGroups";
     aMN["DMCampaigns"] = "DMCampaigns";
+    aMN["DockAppointments"] = "DockAppointments";
+    aMN["Docks"] = "Docks";
     aMN["Documents"] = "Documents";
     aMN["DoiLogs"] = "DoiLogs";
     aMN["Dois"] = "Dois";
@@ -356,6 +358,7 @@ var aMN;
     aMN["InternalChatMessages"] = "InternalChatMessages";
     aMN["InternalForms"] = "InternalForms";
     aMN["InternalOrders"] = "InternalOrders";
+    aMN["InventoryAdjustments"] = "InventoryAdjustments";
     aMN["InventoryLists"] = "InventoryLists";
     aMN["Invoices"] = "Invoices";
     aMN["IoTDevices"] = "IoTDevices";
@@ -457,6 +460,7 @@ var aMN;
     aMN["PaymentProviders"] = "PaymentProviders";
     aMN["PermissionRequests"] = "PermissionRequests";
     aMN["PickLists"] = "PickLists";
+    aMN["PickWaves"] = "PickWaves";
     aMN["PimSelections"] = "PimSelections";
     aMN["Pipelines"] = "Pipelines";
     aMN["Polls"] = "Polls";
@@ -613,8 +617,12 @@ var aMN;
     aMN["TextLinks"] = "TextLinks";
     aMN["Tickets"] = "Tickets";
     aMN["Tips"] = "Tips";
+    aMN["TradeChannelEvents"] = "TradeChannelEvents";
+    aMN["TradeChannelOrders"] = "TradeChannelOrders";
+    aMN["TradeChannels"] = "TradeChannels";
     aMN["Trades"] = "Trades";
     aMN["Transactions"] = "Transactions";
+    aMN["TransportOrders"] = "TransportOrders";
     aMN["Travels"] = "Travels";
     aMN["TriggerActionsLogs"] = "TriggerActionsLogs";
     aMN["TriggerChains"] = "TriggerChains";

package/data/modelsAndRights.js

@@ -2839,6 +2839,26 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "DockAppointments",
+        singular: "DockAppointment",
+        module: "warehouse",
+        right: "warehouse.dockappointments",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
+    {
+        plural: "Docks",
+        singular: "Dock",
+        module: "warehouse",
+        right: "warehouse.docks",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "Documents",
         singular: "Document",
@@ -3749,6 +3769,16 @@ const modelsAndRights = [
         allowDuplicate: true,
         updateBy: "_id",
     },
+    {
+        plural: "InventoryAdjustments",
+        singular: "InventoryAdjustment",
+        module: "warehouse",
+        right: "warehouse.inventoryadjustments",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "InventoryLists",
         singular: "InventoryList",
@@ -4733,6 +4763,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "PickWaves",
+        singular: "PickWave",
+        module: "warehouse",
+        right: "warehouse.pickwaves",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "PimSelections",
         singular: "PimSelection",
@@ -6203,6 +6243,16 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "TransportOrders",
+        singular: "TransportOrder",
+        module: "warehouse",
+        right: "warehouse.transportorders",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
     {
         plural: "Travels",
         singular: "Travel",
@@ -6646,6 +6696,64 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
     },
+    {
+        plural: "TradeChannels",
+        singular: "TradeChannel",
+        module: "purchase",
+        right: "purchase.tradechannels",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+        searchable: true,
+        searchableFields: ["label", "externalAccountId", "provider"],
+    },
+    {
+        plural: "TradeChannelOrders",
+        singular: "TradeChannelOrder",
+        module: "purchase",
+        right: "purchase.tradechannelorders",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+        searchable: true,
+        searchableFields: ["externalId", "provider", "status", "counterparty.name"],
+        actions: [
+            {
+                title: "Refresh from provider",
+                action: "refresh",
+                availability: "single",
+                method: "POST",
+                icon: "refresh",
+            },
+            {
+                title: "Match products",
+                action: "match-products",
+                availability: "both",
+                method: "POST",
+                icon: "link",
+            },
+            {
+                title: "Promote to SupplierOrder",
+                action: "promote",
+                availability: "single",
+                method: "POST",
+                icon: "upgrade",
+                confirmation: "Promote this trade-channel order into a SupplierOrder + GoodsReceipt? This cannot be undone.",
+            },
+        ],
+    },
+    {
+        plural: "TradeChannelEvents",
+        singular: "TradeChannelEvent",
+        module: "purchase",
+        right: "purchase.tradechannelevents",
+        readOnly: true,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+    },
 ];
 exports.modelsAndRights = modelsAndRights;
 exports.default = modelsAndRights;

package/interfaces/IDock.d.ts

@@ -0,0 +1,37 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Dock — physical loading/unloading bay at a warehouse.
+ *
+ * Used for receiving (inbound) and shipping (outbound) operations.
+ * Can be scheduled via IDockAppointment.
+ *
+ * Solves the gap that there is no formal dock management — currently trucks
+ * just arrive and warehouse workers improvise.
+ */
+export interface IDock extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    warehouse: ObjectId;
+    name: string;
+    code?: string;
+    type: "inbound" | "outbound" | "both";
+    status: "available" | "occupied" | "maintenance" | "blocked";
+    maxWeight?: number;
+    maxLength?: number;
+    maxHeight?: number;
+    maxWidth?: number;
+    hasLeveler?: boolean;
+    hasCanopy?: boolean;
+    hasRefrigeration?: boolean;
+    hasLiveLoad?: boolean;
+    currentAppointment?: ObjectId;
+    currentVehicle?: string;
+    occupiedSince?: Date;
+    coordinates?: {
+        x?: number;
+        y?: number;
+    };
+    note?: string;
+    active?: boolean;
+}

package/interfaces/IDock.js

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

package/interfaces/IDockAppointment.d.ts

@@ -0,0 +1,41 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Dock Appointment — scheduled time slot at a dock for a delivery or pickup.
+ *
+ * Drivers/carriers book a slot in advance; warehouse staff prepare goods
+ * accordingly. Reduces yard congestion and idle truck time.
+ *
+ * Lifecycle: scheduled → confirmed → arrived → loading → completed | no_show | cancelled
+ */
+export interface IDockAppointment extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    dock: ObjectId;
+    warehouse: ObjectId;
+    type: "receiving" | "shipping";
+    status: "scheduled" | "confirmed" | "arrived" | "loading" | "completed" | "no_show" | "cancelled";
+    scheduledStart: Date;
+    scheduledEnd: Date;
+    actualArrival?: Date;
+    actualStart?: Date;
+    actualEnd?: Date;
+    goodsReceipt?: ObjectId;
+    supplierOrder?: ObjectId;
+    shipping?: ObjectId;
+    transportOrder?: ObjectId;
+    carrier?: string;
+    driverName?: string;
+    driverPhone?: string;
+    vehicleLicense?: string;
+    vehicleType?: string;
+    trailerLicense?: string;
+    expectedWeight?: number;
+    expectedVolume?: number;
+    expectedPallets?: number;
+    assignedTo?: ObjectId;
+    notifiedAt?: Date;
+    confirmedAt?: Date;
+    note?: string;
+}

package/interfaces/IDockAppointment.js

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

package/interfaces/IInventoryAdjustment.d.ts

@@ -0,0 +1,54 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Inventory Adjustment — standalone correction entity with reason and approval workflow.
+ *
+ * Solves the gap that stock corrections currently happen via free-form
+ * IStockLog `kindofmovement` strings without structured reasons, audit trail,
+ * or approval requirements.
+ *
+ * Reason types:
+ * - shrinkage: theft / loss / unexplained shortage
+ * - damage: physically damaged, unsellable
+ * - found: surplus discovered during cycle count
+ * - correction: data entry error
+ * - obsolescence: expired / discontinued
+ * - sample: removed for QC sampling
+ * - donation: gifted out
+ * - return_to_supplier: defective batch sent back
+ * - cycle_count: result of cycle count variance
+ */
+export interface IInventoryAdjustment extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    product: ObjectId;
+    productSKU?: string;
+    productTitle?: string;
+    warehouse: ObjectId;
+    storageArea?: ObjectId;
+    lot?: ObjectId;
+    serialNumbers?: string[];
+    qtyBefore: number;
+    qtyAfter: number;
+    qtyDelta: number;
+    unit?: string;
+    reason: "shrinkage" | "damage" | "found" | "correction" | "obsolescence" | "sample" | "donation" | "return_to_supplier" | "cycle_count" | "other";
+    reasonDescription?: string;
+    cycleCount?: ObjectId;
+    status: "draft" | "pending_approval" | "approved" | "applied" | "rejected" | "cancelled";
+    requiresApproval?: boolean;
+    submittedBy?: ObjectId;
+    submittedAt?: Date;
+    approvedBy?: ObjectId;
+    approvedAt?: Date;
+    rejectedBy?: ObjectId;
+    rejectedAt?: Date;
+    rejectedReason?: string;
+    appliedAt?: Date;
+    stockLogRef?: ObjectId;
+    valueImpact?: number;
+    costCenter?: ObjectId;
+    accountingNbr?: string;
+    note?: string;
+}

package/interfaces/IInventoryAdjustment.js

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

package/interfaces/IPickWave.d.ts

@@ -0,0 +1,40 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Pick Wave — bundles multiple PickLists for efficient batch picking.
+ *
+ * Solves the gap that pickers currently process one PickList at a time —
+ * inefficient for warehouses with many small orders. A wave groups orders
+ * by zone / route / shipping cutoff so the picker walks the warehouse once.
+ *
+ * Lifecycle: planned → released (pickers can start) → in_progress → completed | cancelled
+ *
+ * Wave Strategies:
+ * - by_zone: group by warehouse zone (StorageArea cluster)
+ * - by_carrier: group by shipping carrier cutoff time
+ * - by_priority: group by deadline / priority score
+ * - by_product: group by same product (batch picking)
+ */
+export interface IPickWave extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    name?: string;
+    status: "planned" | "released" | "in_progress" | "completed" | "cancelled";
+    warehouse: ObjectId;
+    strategy?: "by_zone" | "by_carrier" | "by_priority" | "by_product" | "manual";
+    pickLists: ObjectId[];
+    assignedTo?: ObjectId[];
+    totalLines?: number;
+    pickedLines?: number;
+    progress?: number;
+    totalOrders?: number;
+    plannedStart?: Date;
+    plannedEnd?: Date;
+    releasedAt?: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    estimatedDuration?: number;
+    walkingDistance?: number;
+    note?: string;
+}

package/interfaces/IPickWave.js

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

package/interfaces/ITradeChannel.d.ts

@@ -0,0 +1,64 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Provider identifier for an external trade channel.
+ * Add new providers here as integrations land.
+ */
+export type TradeChannelProvider = "aliexpress" | "amazon" | "ebay" | "etsy" | "otto" | "bol" | "kaufland" | "tiktokshop" | "shein";
+export type TradeChannelStatus = "unconfigured" | "connected" | "disconnected" | "error" | "expired";
+/**
+ * What this channel can do for the customer. Both flows are independent
+ * because some providers expose only one side (e.g. Amazon retail has no
+ * public buy API — buy is "scrape" only, sell is full SP-API).
+ */
+export interface ITradeChannelCapabilities {
+    canBuy: "api" | "scrape" | "none";
+    canSell: "api" | "none";
+}
+/**
+ * One (customer × provider × external account) connection.
+ * A customer can have multiple AliExpress accounts, etc. — each is its own
+ * TradeChannel row, scoped via externalAccountId.
+ *
+ * Credentials never live here directly. The `_credential` ObjectId points
+ * to the standard Credentials collection (AES-256-CTR encrypted).
+ */
+export interface ITradeChannel extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    provider: TradeChannelProvider;
+    /**
+     * Provider-side account identifier (e.g. AliExpress login email,
+     * Amazon seller ID, eBay user id). Allows multiple accounts per
+     * customer × provider. Required for the unique index.
+     */
+    externalAccountId: string;
+    /** Human-readable label shown in admin-v2 (e.g. "AliExpress (max@firma.de)"). */
+    label?: string;
+    status: TradeChannelStatus;
+    capabilities: ITradeChannelCapabilities;
+    /** Reference to encrypted credentials in the Credentials collection. */
+    _credential?: ObjectId;
+    /** Per-channel sync settings. */
+    settings?: {
+        /** Whether scraped/imported orders should auto-promote to SupplierOrder. Default false. */
+        autoPromote?: boolean;
+        /** Sync schedule for the per-provider worker. Default "manual". */
+        syncSchedule?: "manual" | "hourly" | "daily" | "weekly";
+        /** Default destination warehouse for buy-side dropship orders. */
+        defaultWarehouse?: ObjectId;
+    };
+    /** Last successful sync timestamps per direction. */
+    lastSyncedAt?: {
+        inbound?: Date;
+        outbound?: Date;
+    };
+    /** Last error message + timestamp from a failed sync run. */
+    lastError?: {
+        at: Date;
+        message: string;
+        code?: string;
+    };
+    /** Free-form provider-specific config (rate limits, marketplace ids, fulfillment templates, etc). */
+    providerConfig?: any;
+}

package/interfaces/ITradeChannel.js

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

package/interfaces/ITradeChannelEvent.d.ts

@@ -0,0 +1,31 @@
+import { IDefaultFields } from "./IDefaultFields";
+import { TradeChannelProvider } from "./ITradeChannel";
+/**
+ * Channel-level event (not order-level — order events live on the order
+ * document itself in `events[]`).
+ *
+ * Captures: token refreshes, sync runs, webhook receipts, OAuth callbacks,
+ * connection tests, errors. Append-only with TTL 90d (set in Mongoose model).
+ */
+export type TradeChannelEventType = "channel-created" | "oauth-started" | "oauth-completed" | "oauth-failed" | "token-refreshed" | "token-refresh-failed" | "sync-started" | "sync-completed" | "sync-failed" | "test-connection" | "webhook-received" | "import-batch" | "disconnected" | "error";
+export type TradeChannelEventSeverity = "info" | "warn" | "error";
+export interface ITradeChannelEvent extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    _channel: ObjectId;
+    provider: TradeChannelProvider;
+    type: TradeChannelEventType;
+    severity: TradeChannelEventSeverity;
+    message?: string;
+    code?: string;
+    /** Optional structured payload (sync stats, webhook body summary, etc). */
+    data?: any;
+    /** Filled by import endpoint: how many orders the batch touched. */
+    counts?: {
+        created?: number;
+        updated?: number;
+        skipped?: number;
+        failed?: number;
+    };
+}

package/interfaces/ITradeChannelEvent.js

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

package/interfaces/ITradeChannelOrder.d.ts

@@ -0,0 +1,143 @@
+import { IDefaultFields } from "./IDefaultFields";
+import { TradeChannelProvider } from "./ITradeChannel";
+/**
+ * Direction of the order from the customer's perspective.
+ * - outbound: WE bought something from the provider (dropship, sourcing).
+ * - inbound:  WE sold something via the provider (we are the seller).
+ */
+export type TradeChannelOrderDirection = "outbound" | "inbound";
+/**
+ * Where this order's data came from.
+ * - provider-api: pulled via official API (DS API, SP-API, eBay Sell, Etsy OpenAPI).
+ * - plugin-scrape: scraped by the aYOUne Companion browser extension.
+ * - provider-webhook: pushed by the provider via webhook.
+ * - manual: hand-entered in admin-v2.
+ */
+export type TradeChannelOrderSource = "provider-api" | "plugin-scrape" | "provider-webhook" | "manual";
+export type TradeChannelOrderStatus = "placed" | "paid" | "processing" | "shipped" | "delivered" | "completed" | "cancelled" | "refunded" | "dispute" | "unknown";
+/**
+ * Single line item on a trade-channel order. Provider-agnostic.
+ * `_product` is filled by the post-import "match-products" worker when
+ * the external SKU/product can be linked to a Products entry.
+ */
+export interface ITradeChannelOrderItem {
+    externalProductId: string;
+    externalSkuId?: string;
+    title: string;
+    qty: number;
+    unitPrice: number;
+    lineTotal?: number;
+    currency?: string;
+    thumbnailUrl?: string;
+    productUrl?: string;
+    /** Filled when the line item is matched to an internal Product. */
+    _product?: ObjectId;
+    /** Filled when the line item is matched to an internal SKU. */
+    _sku?: ObjectId;
+    /** Provider-specific extras (variant attributes, options, etc). */
+    attributes?: Record<string, any>;
+}
+/**
+ * Tracking / shipment data for one parcel on this order.
+ */
+export interface ITradeChannelOrderShipment {
+    carrier?: string;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    shippedAt?: Date;
+    estimatedDelivery?: Date;
+    deliveredAt?: Date;
+    status?: string;
+}
+/**
+ * Append-only event log entry on the order. Captures every meaningful
+ * change so we can audit who-changed-what across the api/scraper/webhook
+ * pipelines and de-duplicate confidently.
+ */
+export interface ITradeChannelOrderEvent {
+    at: Date;
+    source: TradeChannelOrderSource;
+    type: string;
+    data?: any;
+}
+/**
+ * Full shipping address record. Stored in full per the user's choice
+ * (no hashing) — required for fulfillment on the sell side and for
+ * dropship destination on the buy side.
+ */
+export interface ITradeChannelAddress {
+    company?: string;
+    salutation?: string;
+    firstName?: string;
+    lastName?: string;
+    street?: string;
+    houseNumber?: string;
+    addressAdditional?: string;
+    zip?: string;
+    city?: string;
+    state?: string;
+    country?: string;
+    countryCode?: string;
+    phone?: string;
+    email?: string;
+}
+/**
+ * One order flowing through a trade channel — bidirectional via `direction`.
+ * Unique per (customerId, _channel, externalId) so the same provider order
+ * id can never be inserted twice regardless of which pipeline reported it.
+ */
+export interface ITradeChannelOrder extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    /** Reference to the TradeChannel this order flows through. */
+    _channel: ObjectId;
+    /** Cached provider for fast queries without joining _channel. */
+    provider: TradeChannelProvider;
+    direction: TradeChannelOrderDirection;
+    source: TradeChannelOrderSource;
+    /** Provider-side order id. Unique within (_customerID, _channel). */
+    externalId: string;
+    externalUrl?: string;
+    status: TradeChannelOrderStatus;
+    /** Raw provider status string before normalization. */
+    rawStatus?: string;
+    orderDate: Date;
+    currency: string;
+    subtotal?: number;
+    shippingTotal?: number;
+    taxTotal?: number;
+    discountTotal?: number;
+    total: number;
+    /** Counterparty: the seller on outbound (we bought from them) or the buyer on inbound (we sold to them). */
+    counterparty?: {
+        externalId?: string;
+        name?: string;
+        storeUrl?: string;
+        email?: string;
+    };
+    /** Shipping address — full record per user choice (no hashing). */
+    shippingAddress?: ITradeChannelAddress;
+    /** Billing address if it differs. */
+    billingAddress?: ITradeChannelAddress;
+    items: ITradeChannelOrderItem[];
+    shipments?: ITradeChannelOrderShipment[];
+    events?: ITradeChannelOrderEvent[];
+    /** First time this order was seen by aYOUne (set on insert, never updated). */
+    firstSeenAt: Date;
+    firstSeenSource: TradeChannelOrderSource;
+    /** Last time any pipeline touched this order. */
+    lastSyncedAt?: Date;
+    /** When this order was promoted into a SupplierOrder (manual action only). */
+    promotedAt?: Date;
+    /** The SupplierOrder created from this trade-channel order, if promoted. */
+    _supplierOrder?: ObjectId;
+    /** The IncomeInvoice linked to the promotion, if any. */
+    _incomeInvoice?: ObjectId;
+    /** The GoodsReceipt linked to the promotion, if any. */
+    _goodsReceipt?: ObjectId;
+    /** Last raw payload from the provider/scraper, for debugging + diffing. */
+    raw?: any;
+    /** Free-form notes (admin-entered). */
+    note?: string;
+}

package/interfaces/ITradeChannelOrder.js

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

package/interfaces/ITransportOrder.d.ts

@@ -0,0 +1,60 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Transport Order — staging entity that bundles one or more shipments
+ * for a single carrier pickup.
+ *
+ * Solves the gap that IShipping goes directly to a carrier with no
+ * intermediate stop for route optimization, multi-stop tours, or
+ * carrier handoff documentation (Bill of Lading equivalent).
+ *
+ * Lifecycle: planned → confirmed → ready → in_transit → delivered | cancelled
+ */
+export interface ITransportOrder extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    nbr?: string;
+    referenceNumber?: string;
+    bolNumber?: string;
+    status: "planned" | "confirmed" | "ready" | "in_transit" | "delivered" | "cancelled";
+    shippings: ObjectId[];
+    carrier?: string;
+    carrierAccount?: string;
+    serviceLevel?: string;
+    plannedPickup?: Date;
+    actualPickup?: Date;
+    plannedDelivery?: Date;
+    estimatedDelivery?: Date;
+    actualDelivery?: Date;
+    tourNumber?: string;
+    stopSequence?: number;
+    totalStops?: number;
+    pickupDock?: ObjectId;
+    pickupAppointment?: ObjectId;
+    deliveryAddress?: {
+        company?: string;
+        street?: string;
+        zip?: string;
+        city?: string;
+        country?: string;
+    };
+    driverName?: string;
+    driverPhone?: string;
+    vehicleLicense?: string;
+    trailerLicense?: string;
+    totalWeight?: number;
+    totalVolume?: number;
+    totalPackages?: number;
+    totalPallets?: number;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    bolUrl?: string;
+    cmrUrl?: string;
+    sealNumbers?: string[];
+    transportCost?: number;
+    fuelSurcharge?: number;
+    accessoryCharges?: number;
+    totalCost?: number;
+    currency?: string;
+    note?: string;
+}

package/interfaces/ITransportOrder.js

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

package/interfaces/index.d.ts

@@ -270,6 +270,8 @@ export * from "./IDesktopClient";
 export * from "./IDesktopNotification";
 export * from "./IDiscountGroup";
 export * from "./IDMCampaign";
+export * from "./IDock";
+export * from "./IDockAppointment";
 export * from "./IDocument";
 export * from "./IDoi";
 export * from "./IDoiLog";
@@ -373,6 +375,7 @@ export * from "./IIntermediary";
 export * from "./IInternalChatMessage";
 export * from "./IInternalForm";
 export * from "./IInternalOrder";
+export * from "./IInventoryAdjustment";
 export * from "./IInventoryList";
 export * from "./IInvoice";
 export * from "./IIoTDevice";
@@ -480,6 +483,7 @@ export * from "./IPaymentGroup";
 export * from "./IPaymentProvider";
 export * from "./IPermissionRequest";
 export * from "./IPickList";
+export * from "./IPickWave";
 export * from "./IPimSelection";
 export * from "./IPipeline";
 export * from "./IPoints";
@@ -649,7 +653,11 @@ export * from "./ITicket";
 export * from "./ITip";
 export * from "./ITitle";
 export * from "./ITrade";
+export * from "./ITradeChannel";
+export * from "./ITradeChannelEvent";
+export * from "./ITradeChannelOrder";
 export * from "./ITransaction";
+export * from "./ITransportOrder";
 export * from "./ITravel";
 export * from "./ITrigger";
 export * from "./ITriggerAction";

package/interfaces/index.js

@@ -286,6 +286,8 @@ __exportStar(require("./IDesktopClient"), exports);
 __exportStar(require("./IDesktopNotification"), exports);
 __exportStar(require("./IDiscountGroup"), exports);
 __exportStar(require("./IDMCampaign"), exports);
+__exportStar(require("./IDock"), exports);
+__exportStar(require("./IDockAppointment"), exports);
 __exportStar(require("./IDocument"), exports);
 __exportStar(require("./IDoi"), exports);
 __exportStar(require("./IDoiLog"), exports);
@@ -389,6 +391,7 @@ __exportStar(require("./IIntermediary"), exports);
 __exportStar(require("./IInternalChatMessage"), exports);
 __exportStar(require("./IInternalForm"), exports);
 __exportStar(require("./IInternalOrder"), exports);
+__exportStar(require("./IInventoryAdjustment"), exports);
 __exportStar(require("./IInventoryList"), exports);
 __exportStar(require("./IInvoice"), exports);
 __exportStar(require("./IIoTDevice"), exports);
@@ -496,6 +499,7 @@ __exportStar(require("./IPaymentGroup"), exports);
 __exportStar(require("./IPaymentProvider"), exports);
 __exportStar(require("./IPermissionRequest"), exports);
 __exportStar(require("./IPickList"), exports);
+__exportStar(require("./IPickWave"), exports);
 __exportStar(require("./IPimSelection"), exports);
 __exportStar(require("./IPipeline"), exports);
 __exportStar(require("./IPoints"), exports);
@@ -665,7 +669,11 @@ __exportStar(require("./ITicket"), exports);
 __exportStar(require("./ITip"), exports);
 __exportStar(require("./ITitle"), exports);
 __exportStar(require("./ITrade"), exports);
+__exportStar(require("./ITradeChannel"), exports);
+__exportStar(require("./ITradeChannelEvent"), exports);
+__exportStar(require("./ITradeChannelOrder"), exports);
 __exportStar(require("./ITransaction"), exports);
+__exportStar(require("./ITransportOrder"), exports);
 __exportStar(require("./ITravel"), exports);
 __exportStar(require("./ITrigger"), exports);
 __exportStar(require("./ITriggerAction"), exports);

package/package.json

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