@hantera/portal-app 20260428.0.0-develop.1 → 20260617.0.0-develop.1

package/dist/index.d.ts

@@ -11,10 +11,12 @@ import { DataColumnValuesEnumSet } from '@hantera/design-system';
 import { DataColumnValuesEnumValue } from '@hantera/design-system';
 import { DataProvider } from '@hantera/design-system';
 import { DataRow } from '@hantera/design-system';
+import { DateOnly } from '@hantera/design-system';
 import Decimal from 'decimal.js';
 import { DeepReadonly } from 'vue';
 import { default as default_2 } from 'decimal.js';
 import { DefineComponent } from 'vue';
+import { IconName } from '@hantera/design-system';
 import { InjectionKey } from 'vue';
 import { LabelTagDefinition } from '@hantera/design-system';
 import { PublicProps } from 'vue';
@@ -92,6 +94,8 @@ declare interface AddActivityLogCommand {
     messageTemplate: string;
     /** Dynamic properties to add to the log */
     dynamic?: Record<string, any>;
+    /** Override createdAt to align with external events. If not specified, time will be based on server time. */
+    createdAt?: any;
 }
 
 /**
@@ -105,6 +109,8 @@ declare interface AddActivityLogCommand_2 {
     messageTemplate: string;
     /** Dynamic properties to add to the log */
     dynamic?: Record<string, any>;
+    /** Override createdAt to align with external events. If not specified, time will be based on server time. */
+    createdAt?: any;
 }
 
 /**
@@ -118,6 +124,8 @@ declare interface AddActivityLogCommand_3 {
     messageTemplate: string;
     /** Dynamic properties to add to the log */
     dynamic?: Record<string, any>;
+    /** Override createdAt to align with external events. If not specified, time will be based on server time. */
+    createdAt?: any;
 }
 
 /**
@@ -131,6 +139,8 @@ declare interface AddActivityLogCommand_4 {
     messageTemplate: string;
     /** Dynamic properties to add to the log */
     dynamic?: Record<string, any>;
+    /** Override createdAt to align with external events. If not specified, time will be based on server time. */
+    createdAt?: any;
 }
 
 /**
@@ -267,11 +277,12 @@ export declare namespace Asset {
         GenerateAssetNumberByPrefixCommand,
         RemoveTagCommand_4 as RemoveTagCommand,
         SetDynamicFieldsCommand_4 as SetDynamicFieldsCommand,
-        SetItemDynamicFieldsCommand_2 as SetItemDynamicFieldsCommand
+        SetItemDynamicFieldsCommand_2 as SetItemDynamicFieldsCommand,
+        SetTagsCommand_4 as SetTagsCommand
     }
 }
 
-declare type AssetCommand = AddActivityLogCommand_4 | AddTagCommand_4 | CreateItemCommand_2 | CreateItemRelationCommand_2 | CreateRelationCommand_2 | DeleteItemCommand_2 | DeleteItemRelationCommand_2 | DeleteRelationCommand_2 | GenerateAssetNumberByPrefixCommand | RemoveTagCommand_4 | SetDynamicFieldsCommand_4 | SetItemDynamicFieldsCommand_2;
+declare type AssetCommand = AddActivityLogCommand_4 | AddTagCommand_4 | CreateItemCommand_2 | CreateItemRelationCommand_2 | CreateRelationCommand_2 | DeleteItemCommand_2 | DeleteItemRelationCommand_2 | DeleteRelationCommand_2 | GenerateAssetNumberByPrefixCommand | RemoveTagCommand_4 | SetDynamicFieldsCommand_4 | SetItemDynamicFieldsCommand_2 | SetTagsCommand_4;
 
 export declare const Authorize: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 
@@ -374,15 +385,15 @@ declare interface BackOrder_2 {
 
 declare interface CalculatedDiscount {
     calculatedDiscountId: string;
-    discountId?: string;
-    promotionId?: string;
+    referenceType: 'staticDiscount' | 'promotion';
+    referenceId: string;
     value: default_2;
 }
 
 declare interface CalculatedDiscount_2 {
     calculatedDiscountId: string
-    discountId?: string
-    promotionId?: string
+    referenceType: 'staticDiscount' | 'promotion'
+    referenceId: string
     value: Decimal
 }
 
@@ -526,44 +537,6 @@ declare interface CreateAuthorizationCommand {
     authorizationState?: 'pending' | 'successful' | 'failed';
 }
 
-/**
- * Adds a new computed Order Discount to an Order using an embedded source code for the logic
- *
- * @see {@link https://developer.hantera.io/reference/actors/order/commands/create-computed-order-discount-by-source/|Hantera Developer Portal}
- */
-declare interface CreateComputedOrderDiscountBySourceCommand {
-    type: 'createComputedOrderDiscountBySource';
-    /** Optional Id. Must be unique. */
-    discountId?: string;
-    /** The source code for the discount logic */
-    source: string;
-    /** Additional parameters to pass to the discount logic, values must be in filtrera format */
-    parameters?: Record<string, string>;
-    /** Dynamic fields for metadata */
-    dynamic?: Record<string, any>;
-    /** Description/Name of discount. Should be meaningful to the customer as it's used on invoices and customer communication. */
-    description?: string;
-}
-
-/**
- * Adds a new computed Order Discount to an Order based on a component
- *
- * @see {@link https://developer.hantera.io/reference/actors/order/commands/create-computed-order-discount/|Hantera Developer Portal}
- */
-declare interface CreateComputedOrderDiscountCommand {
-    type: 'createComputedOrderDiscount';
-    /** Optional Id. Must be unique. */
-    discountId?: string;
-    /** The component to use for the discount logic */
-    componentId: string;
-    /** Additional parameters to pass to the discount logic, values must be in filtrera format */
-    parameters?: Record<string, string>;
-    /** Dynamic fields for metadata */
-    dynamic?: Record<string, any>;
-    /** Description/Name of discount. Should be meaningful to the customer as it's used on invoices and customer communication. */
-    description?: string;
-}
-
 /**
  * Adds a new Delivery to an Order
  *
@@ -676,6 +649,40 @@ declare interface CreateOrderLineCommand {
     skus?: Record<string, Decimal | number>;
 }
 
+/**
+ * Creates a promotion on an Order with inline Filtrera source
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/create-promotion-by-source/|Hantera Developer Portal}
+ */
+declare interface CreatePromotionBySourceCommand {
+    type: 'createPromotionBySource';
+    promotionId?: string;
+    source: string;
+    parameters?: Record<string, any>;
+    dynamic?: Record<string, any>;
+    description?: string;
+    promotionGroup: string;
+    canOnlyCombineWith?: string[];
+    canNotCombineWith?: string[];
+}
+
+/**
+ * Creates a promotion on an Order based on a component
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/create-promotion/|Hantera Developer Portal}
+ */
+declare interface CreatePromotionCommand {
+    type: 'createPromotion';
+    promotionId?: string;
+    componentId: string;
+    parameters?: Record<string, any>;
+    dynamic?: Record<string, any>;
+    description?: string;
+    promotionGroup: string;
+    canOnlyCombineWith?: string[];
+    canNotCombineWith?: string[];
+}
+
 /**
  * Adds a new graph node relation to a Ticket
  *
@@ -805,7 +812,7 @@ declare interface Customer_2 {
     orders: Array<Order_2>;
 }
 
-declare function date(date: Date | string, format?: string): string;
+declare function date(date: DateOnly | Date | string): string;
 
 declare function dateTime(date: Date | string): string;
 
@@ -823,6 +830,9 @@ declare const _default_2: {
         timeline: AppSlot<Record<string, any>>;
     };
     delivery: {
+        header: AppSlot<    {
+        delivery: Delivery;
+        }>;
         footer: AppSlot<    {
         delivery: Delivery;
         }>;
@@ -1008,6 +1018,16 @@ declare interface DeleteOrderLineCommand {
     orderLineId: string;
 }
 
+/**
+ * Deletes a promotion from an Order
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/delete-promotion/|Hantera Developer Portal}
+ */
+declare interface DeletePromotionCommand {
+    type: 'deletePromotion';
+    promotionId: string;
+}
+
 /**
  * Removes a graph node relation from a Ticket
  *
@@ -1050,8 +1070,6 @@ declare interface Delivery {
     deliveryNumber: string;
     deliveryState: 'open' | 'processing' | 'completed' | 'cancelled' | 'cancelledByOrder';
     deliveryAddress: Address;
-    inventoryKey: string;
-    inventoryDate?: Date;
     shippingPrice: default_2;
     shippingTaxFactor: default_2;
     shippingTaxTotal: default_2;
@@ -1073,8 +1091,6 @@ declare interface Delivery_2 {
     deliveryNumber: string
     deliveryState: 'open' | 'processing' | 'completed' | 'cancelled' | 'cancelledByOrder'
     deliveryAddress: Address_2
-    inventoryKey: string
-    inventoryDate?: Date
     shippingPrice: Decimal
     shippingTaxFactor: Decimal
     shippingTaxTotal: Decimal
@@ -1092,6 +1108,8 @@ declare interface Delivery_2 {
     shippingDiscounts: Array<Discount_2>
 }
 
+export declare type Dialogs = ReturnType<typeof useDialogs>;
+
 declare interface Discount {
     discountId: string;
     discountType: 'percentage' | 'absolute';
@@ -1236,6 +1254,7 @@ export declare namespace Graph {
         Delivery_2 as Delivery,
         Payment_2 as Payment,
         Address_2 as Address,
+        InvoiceRecipient,
         ActivityLog,
         Checkpoint,
         Invoice,
@@ -1256,6 +1275,7 @@ export declare namespace Graph_2 {
         Delivery,
         Payment,
         Address,
+        InvoiceRecipient_2 as InvoiceRecipient,
         ActivityLog_2 as ActivityLog,
         Checkpoint_2 as Checkpoint,
         Invoice_2 as Invoice,
@@ -1649,7 +1669,7 @@ declare interface Invoice {
     invoiceNumber: string
     invoiceTotal: Decimal
     createdAt: Date
-    invoiceAddress: Address_2
+    invoiceRecipient: InvoiceRecipient
     invoiceLines: InvoiceLine[]
     invoiceNetTotal: Decimal
     invoiceTaxTotal: Decimal
@@ -1663,7 +1683,7 @@ declare interface Invoice_2 {
     invoiceNumber: string;
     invoiceTotal: default_2;
     createdAt: Date;
-    invoiceAddress: Address;
+    invoiceRecipient: InvoiceRecipient_2;
     invoiceLines: InvoiceLine_2[];
     invoiceNetTotal: default_2;
     invoiceTaxTotal: default_2;
@@ -1726,6 +1746,18 @@ declare interface InvoiceLineDiscount_2 {
     description: string;
 }
 
+declare interface InvoiceRecipient extends Address_2 {
+    taxId?: string
+    taxIdType?: string
+    taxCountryCode?: string
+}
+
+declare interface InvoiceRecipient_2 extends Address {
+    taxId?: string;
+    taxIdType?: string;
+    taxCountryCode?: string;
+}
+
 declare interface JobCompletedData {
     jobId: string;
     jobDefinitionId: string;
@@ -2312,9 +2344,18 @@ declare interface LiveQueryResult<T = unknown> {
     loading: DeepReadonly<Ref<boolean>>;
     totalCount: DeepReadonly<Ref<number | null>>;
     capped: DeepReadonly<Ref<boolean>>;
+    revision: DeepReadonly<Ref<number>>;
     dispose(): void;
 }
 
+declare function loadLocales(): Promise<LocaleInfo[]>;
+
+declare interface LocaleInfo {
+    key: string;
+    label: string;
+    language: string;
+}
+
 declare interface LocalizedLabel {
     default: string
     [languageCode: string]: string
@@ -2419,7 +2460,7 @@ declare interface Order {
     currencyCode: string
     channelKey?: string
     customerNumber?: string
-    invoiceAddress: Address_2
+    invoiceRecipient: InvoiceRecipient
     locale: string
     notes?: string
     orderTaxTotal: Decimal
@@ -2448,7 +2489,7 @@ declare interface Order_2 {
     currencyCode: string;
     channelKey?: string;
     customerNumber?: string;
-    invoiceAddress: Address;
+    invoiceRecipient: InvoiceRecipient_2;
     locale: string;
     notes?: string;
     orderTaxTotal: default_2;
@@ -2478,16 +2519,17 @@ export declare namespace Order_3 {
         CancelDeliveryCommand,
         CancelInvoiceCommand,
         CompleteDeliveryCommand,
-        CreateComputedOrderDiscountBySourceCommand,
-        CreateComputedOrderDiscountCommand,
         CreateDeliveryCommand,
         CreateOrderLineCommand,
+        CreatePromotionBySourceCommand,
+        CreatePromotionCommand,
         CreateReturnCommand,
         CreateStaticOrderDiscountCommand,
         CreateStaticOrderLineDiscountCommand,
         CreateStaticShippingDiscountCommand,
         DeleteDiscountCommand,
         DeleteOrderLineCommand,
+        DeletePromotionCommand,
         DeleteReturnCommand,
         GenerateOrderNumberByPrefixCommand,
         InvoiceCommand,
@@ -2502,14 +2544,14 @@ export declare namespace Order_3 {
         RetractOrderLineFromInvoicingCommand,
         RetractShippingFromInvoicingCommand,
         SetChannelKeyCommand,
-        SetComputedOrderDiscountParametersCommand,
         SetCustomerNumberCommand,
         SetDeliveryAddressCommand,
         SetDeliveryDynamicFieldsCommand,
-        SetDeliveryInventoryCommand,
+        SetDeliveryTagsCommand,
         SetDiscountDescriptionCommand,
         SetDiscountDynamicFieldsCommand,
         SetInvoiceAddressCommand,
+        SetInvoiceRecipientCommand,
         SetLocaleCommand,
         SetNotesCommand,
         SetOrderDynamicFieldsCommand,
@@ -2520,16 +2562,20 @@ export declare namespace Order_3 {
         SetOrderLineTaxCommand,
         SetOrderLineUnitPriceCommand,
         SetOrderStateCommand,
+        SetPromotionDescriptionCommand,
+        SetPromotionDynamicFieldsCommand,
+        SetPromotionParametersCommand,
         SetReturnDynamicFieldsCommand,
         SetShippingPriceCommand,
         SetShippingProductCommand,
         SetShippingTaxCommand,
         SetStaticDiscountValueCommand,
-        UnsetDeliveryInventoryCommand
+        SetTagsCommand,
+        SplitOrderLineCommand
     }
 }
 
-declare type OrderCommand = AddActivityLogCommand | AddDeliveryTagCommand | AddTagCommand | CancelDeliveryCommand | CancelInvoiceCommand | CompleteDeliveryCommand | CreateComputedOrderDiscountBySourceCommand | CreateComputedOrderDiscountCommand | CreateDeliveryCommand | CreateOrderLineCommand | CreateReturnCommand | CreateStaticOrderDiscountCommand | CreateStaticOrderLineDiscountCommand | CreateStaticShippingDiscountCommand | DeleteDiscountCommand | DeleteOrderLineCommand | DeleteReturnCommand | GenerateOrderNumberByPrefixCommand | InvoiceCommand | LinkPaymentCommand | MoveOrderLineToDeliveryCommand | OpenDeliveryCommand | ReleaseDeliveryCommand | ReleaseOrderLineToInvoicingCommand | ReleaseShippingToInvoicingCommand | RemoveDeliveryTagCommand | RemoveTagCommand | RetractOrderLineFromInvoicingCommand | RetractShippingFromInvoicingCommand | SetChannelKeyCommand | SetComputedOrderDiscountParametersCommand | SetCustomerNumberCommand | SetDeliveryAddressCommand | SetDeliveryDynamicFieldsCommand | SetDeliveryInventoryCommand | SetDiscountDescriptionCommand | SetDiscountDynamicFieldsCommand | SetInvoiceAddressCommand | SetLocaleCommand | SetNotesCommand | SetOrderDynamicFieldsCommand | SetOrderLineDynamicFieldsCommand | SetOrderLineProductCommand | SetOrderLineQuantityCommand | SetOrderLineSkusCommand | SetOrderLineTaxCommand | SetOrderLineUnitPriceCommand | SetOrderStateCommand | SetReturnDynamicFieldsCommand | SetShippingPriceCommand | SetShippingProductCommand | SetShippingTaxCommand | SetStaticDiscountValueCommand | UnsetDeliveryInventoryCommand;
+declare type OrderCommand = AddActivityLogCommand | AddDeliveryTagCommand | AddTagCommand | CancelDeliveryCommand | CancelInvoiceCommand | CompleteDeliveryCommand | CreateDeliveryCommand | CreateOrderLineCommand | CreatePromotionBySourceCommand | CreatePromotionCommand | CreateReturnCommand | CreateStaticOrderDiscountCommand | CreateStaticOrderLineDiscountCommand | CreateStaticShippingDiscountCommand | DeleteDiscountCommand | DeleteOrderLineCommand | DeletePromotionCommand | DeleteReturnCommand | GenerateOrderNumberByPrefixCommand | InvoiceCommand | LinkPaymentCommand | MoveOrderLineToDeliveryCommand | OpenDeliveryCommand | ReleaseDeliveryCommand | ReleaseOrderLineToInvoicingCommand | ReleaseShippingToInvoicingCommand | RemoveDeliveryTagCommand | RemoveTagCommand | RetractOrderLineFromInvoicingCommand | RetractShippingFromInvoicingCommand | SetChannelKeyCommand | SetCustomerNumberCommand | SetDeliveryAddressCommand | SetDeliveryDynamicFieldsCommand | SetDeliveryTagsCommand | SetDiscountDescriptionCommand | SetDiscountDynamicFieldsCommand | SetInvoiceAddressCommand | SetInvoiceRecipientCommand | SetLocaleCommand | SetNotesCommand | SetOrderDynamicFieldsCommand | SetOrderLineDynamicFieldsCommand | SetOrderLineProductCommand | SetOrderLineQuantityCommand | SetOrderLineSkusCommand | SetOrderLineTaxCommand | SetOrderLineUnitPriceCommand | SetOrderStateCommand | SetPromotionDescriptionCommand | SetPromotionDynamicFieldsCommand | SetPromotionParametersCommand | SetReturnDynamicFieldsCommand | SetShippingPriceCommand | SetShippingProductCommand | SetShippingTaxCommand | SetStaticDiscountValueCommand | SetTagsCommand | SplitOrderLineCommand;
 
 declare interface OrderJournalEntry {
     orderJournalEntryId: string
@@ -2635,10 +2681,42 @@ declare const orderView: {
     }[];
     }>;
     /**
-     * Allows services to contribute context menu items to delivery panels in the order view
+     * Allows services to contribute context menu items to delivery and payment
+     * panels in the order view. Implement only the methods relevant to the app.
      */
     contextMenuProvider: AppService<    {
-    buildDeliveryContextMenu(context: PortalContext, orderViewContext: OrderViewContext, delivery: Models_2.Graph.Delivery): ContextMenuSection;
+    buildDeliveryContextMenu?(context: PortalContext, orderViewContext: OrderViewContext, delivery: Models_2.Graph.Delivery): ContextMenuSection;
+    buildPaymentContextMenu?(context: PortalContext, orderViewContext: OrderViewContext, payment: Models_2.Graph.Payment): ContextMenuSection;
+    }>;
+    /**
+     * Allows services to react to events occurring in the standard order view,
+     * such as the order being saved.
+     */
+    eventsProvider: AppService<    {
+    /**
+    * Called after the order has been successfully saved (commands applied and
+    * order state refreshed). `appliedCommands` are the commands that were
+    * committed in this save.
+    */
+    onOrderSaved?(event: {
+    context: PortalContext;
+    orderViewContext: OrderViewContext;
+    order: Models_2.Graph.Order;
+    appliedCommands: OrderCommand[];
+    }): Promise<void>;
+    }>;
+    /**
+     * Allows services to contribute options to the "New payment" dropdown in the
+     * payments tab of the order view.
+     */
+    paymentActionsProvider: AppService<    {
+    buildNewPaymentOptions(context: PortalContext, orderViewContext: OrderViewContext): {
+    id: string;
+    label: string | ComputedRef<string>;
+    icon?: IconName;
+    disabled?: boolean;
+    onClick: () => void;
+    }[];
     }>;
 };
 
@@ -2670,12 +2748,24 @@ declare interface OrderViewContext {
     redo(): boolean;
     /**
      * Saves pending changes. Automatically refreshes the order state.
+     * Resolves with the list of commands that were committed in this save
+     * (empty if there was nothing to save).
      */
-    save(): Promise<void>;
+    save(): Promise<OrderCommand[]>;
     /**
      * Refreshes the order state with the server. If there are pending changes, they will be previewed.
      */
     refresh(): Promise<void>;
+    /**
+     * Subscribes to live updates of the order. When there are no pending changes or active timetravel,
+     * incoming updates are bound directly to the state. Otherwise, updates trigger a preview refresh.
+     * Requires the order state to be loaded first (call refresh before this).
+     */
+    startLiveUpdates(): void;
+    /**
+     * Disposes live update subscriptions and pending timers. Call when the view is torn down.
+     */
+    dispose(): void;
     /**
      * Adds a pending changeset to the current instance. Call refresh to update preview.
      *
@@ -2711,6 +2801,7 @@ declare interface Payment {
     paymentId: string;
     paymentNumber: string;
     externalReference?: string;
+    channelKey?: string;
     authorizedAmount: default_2;
     providerKey: string;
     tags: Array<string>;
@@ -2727,8 +2818,10 @@ declare interface Payment_2 {
     paymentId: string
     paymentNumber: string
     externalReference?: string
+    channelKey?: string
     authorizedAmount: Decimal
     providerKey: string
+
     tags: Array<string>
     capturedBalance: Decimal
     creditBalance: Decimal
@@ -2750,7 +2843,8 @@ export declare namespace Payment_3 {
         RemoveTagCommand_2 as RemoveTagCommand,
         SetAuthorizationAmountCommand,
         SetAuthorizationStateCommand,
-        SetDynamicFieldsCommand
+        SetDynamicFieldsCommand,
+        SetTagsCommand_2 as SetTagsCommand
     }
 }
 
@@ -2786,7 +2880,7 @@ declare interface PaymentCapture_2 {
     }
 }
 
-declare type PaymentCommand = AddActivityLogCommand_2 | AddTagCommand_2 | CreateAuthorizationCommand | GeneratePaymentNumberByPrefixCommand | RemoveTagCommand_2 | SetAuthorizationAmountCommand | SetAuthorizationStateCommand | SetDynamicFieldsCommand;
+declare type PaymentCommand = AddActivityLogCommand_2 | AddTagCommand_2 | CreateAuthorizationCommand | GeneratePaymentNumberByPrefixCommand | RemoveTagCommand_2 | SetAuthorizationAmountCommand | SetAuthorizationStateCommand | SetDynamicFieldsCommand | SetTagsCommand_2;
 
 declare interface PaymentJournalEntry {
     paymentJournalEntryId: string;
@@ -3062,7 +3156,7 @@ declare interface ReserveCommand {
     inventoryKey: string;
     /** The number of units to reserve. Must be greater than zero. */
     quantity: Decimal | number;
-    /** Optional date/time when the reserved stock should be available if the stock is not needed immediately. */
+    /** Optional date when the reserved stock should be available if the stock is not needed immediately. */
     inventoryDate?: any;
     /** Optional list of allocations to use for the reservation. */
     stockAllocations?: string[];
@@ -3102,6 +3196,10 @@ declare interface SearchProduct {
 export declare interface ServiceContext {
     processes: Processes;
     backend: BackendApi;
+    dialogs: Dialogs;
+    localization: {
+        resolveLabel: (label: string | Record<string, string> | null | undefined) => string;
+    };
 }
 
 /**
@@ -3169,17 +3267,6 @@ declare interface SetChannelKeyCommand_2 {
     value: string;
 }
 
-/**
- * Sets a computed order discount's parameters
- *
- * @see {@link https://developer.hantera.io/reference/actors/order/commands/set-computed-order-discount-parameters/|Hantera Developer Portal}
- */
-declare interface SetComputedOrderDiscountParametersCommand {
-    type: 'setComputedOrderDiscountParameters';
-    discountId: string;
-    parameters: Record<string, string>;
-}
-
 /**
  * Sets the customer number of an order.
  *
@@ -3225,16 +3312,16 @@ declare interface SetDeliveryDynamicFieldsCommand {
 }
 
 /**
- * Sets the inventory and inventory date of a Delivery. Stock reservations will be updated if there are any.
+ * Replaces all tags on a Delivery
  *
- * @see {@link https://developer.hantera.io/reference/actors/order/commands/set-delivery-inventory/|Hantera Developer Portal}
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/set-delivery-tags/|Hantera Developer Portal}
  */
-declare interface SetDeliveryInventoryCommand {
-    type: 'setDeliveryInventory';
-    /** The ID of the Delivery to set the inventory of */
+declare interface SetDeliveryTagsCommand {
+    type: 'setDeliveryTags';
+    /** The ID of the Delivery to set tags on */
     deliveryId: string;
-    inventoryKey: string;
-    inventoryDate: any;
+    /** The tag keys */
+    keys: string[];
 }
 
 /**
@@ -3310,7 +3397,7 @@ declare interface SetIncomingStockCommand {
     reference: string;
     /** The key of the inventory the incoming stock is expected at. */
     inventoryKey: string;
-    /** Date of when the incoming stock is expected to be available for outbound shipments. */
+    /** Date when the incoming stock is expected to be available for outbound shipments. */
     expectedOn: any;
     /** The number of units expected */
     quantity: Decimal | number;
@@ -3319,6 +3406,7 @@ declare interface SetIncomingStockCommand {
 /**
  * Sets the invoice address of an Order which will be used for new invoices
  *
+ * @deprecated Use SetInvoiceRecipient command instead
  * @see {@link https://developer.hantera.io/reference/actors/order/commands/set-invoice-address/|Hantera Developer Portal}
  */
 declare interface SetInvoiceAddressCommand {
@@ -3336,6 +3424,29 @@ declare interface SetInvoiceAddressCommand {
     phone?: string;
 }
 
+/**
+ * Sets the invoice recipient of an Order which will be used for new invoices
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/set-invoice-recipient/|Hantera Developer Portal}
+ */
+declare interface SetInvoiceRecipientCommand {
+    type: 'setInvoiceRecipient';
+    name?: string;
+    careOf?: string;
+    attention?: string;
+    addressLine1?: string;
+    addressLine2?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    countryCode?: string;
+    email?: string;
+    phone?: string;
+    taxId?: string;
+    taxIdType?: string;
+    taxCountryCode?: string;
+}
+
 /**
  * Sets dynamic fields of a ticket item. Non specified fields will be left unchanged. Set value to null to remove field.
  *
@@ -3500,6 +3611,39 @@ declare interface SetPhysicalStockCommand {
     relative: boolean;
 }
 
+/**
+ * Sets the description on a promotion
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/set-promotion-description/|Hantera Developer Portal}
+ */
+declare interface SetPromotionDescriptionCommand {
+    type: 'setPromotionDescription';
+    promotionId: string;
+    description?: string;
+}
+
+/**
+ * Sets dynamic fields on a promotion
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/set-promotion-dynamic-fields/|Hantera Developer Portal}
+ */
+declare interface SetPromotionDynamicFieldsCommand {
+    type: 'setPromotionDynamicFields';
+    promotionId: string;
+    fields: Record<string, any>;
+}
+
+/**
+ * Sets parameters on a promotion
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/set-promotion-parameters/|Hantera Developer Portal}
+ */
+declare interface SetPromotionParametersCommand {
+    type: 'setPromotionParameters';
+    promotionId: string;
+    parameters: Record<string, any>;
+}
+
 /**
  * Sets dynamic fields of a return. Non specified fields will be left unchanged. Set value to null to remove field.
  *
@@ -3572,7 +3716,55 @@ declare interface SetStaticDiscountValueCommand {
     value: Decimal | number;
 }
 
+/**
+ * Replaces all tags on an Order
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/set-tags/|Hantera Developer Portal}
+ */
+declare interface SetTagsCommand {
+    type: 'setTags';
+    /** The tag keys */
+    keys: string[];
+}
+
+/**
+ * Replaces all tags on a Payment
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/payment/commands/set-tags/|Hantera Developer Portal}
+ */
+declare interface SetTagsCommand_2 {
+    type: 'setTags';
+    /** The tag keys */
+    keys: string[];
+}
+
+/**
+ * Replaces all tags on a Ticket
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/ticket/commands/set-tags/|Hantera Developer Portal}
+ */
+declare interface SetTagsCommand_3 {
+    type: 'setTags';
+    /** The tag keys */
+    keys: string[];
+}
+
+/**
+ * Replaces all tags on an Asset
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/asset/commands/set-tags/|Hantera Developer Portal}
+ */
+declare interface SetTagsCommand_4 {
+    type: 'setTags';
+    /** The tag keys */
+    keys: string[];
+}
+
 declare interface ShippingProduct {
+    /**
+     * Optional unique internal ID, useful if multiple options share the same productNumber.
+     */
+    optionId?: string;
     productNumber: string;
     description: string;
     price: default_2;
@@ -3599,6 +3791,23 @@ export declare namespace Sku {
 
 declare type SkuCommand = ReserveCommand | SetAllocationCommand | SetDynamicFieldsCommand_2 | SetIncomingStockCommand | SetPhysicalStockCommand | UnreserveCommand;
 
+/**
+ * Splits an existing order line into two by moving a portion of its quantity onto a new order line. The new line inherits product, price, dynamic fields and per-unit SKU composition from the original. Discounts and totals are left to be recomputed by the order pipeline.
+ *
+ * @see {@link https://developer.hantera.io/reference/actors/order/commands/split-order-line/|Hantera Developer Portal}
+ */
+declare interface SplitOrderLineCommand {
+    type: 'splitOrderLine';
+    /** The ID of the existing Order Line to split. */
+    orderLineId: string;
+    /** Optional. The ID to assign to the new Order Line. A new GUID is generated when omitted. */
+    newOrderLineId?: string;
+    /** The quantity to move from the original Order Line onto the new one. Must be greater than 0 and less than the original line's quantity. */
+    quantity: Decimal | number;
+    /** Optional. The ID of an existing Delivery to place the new Order Line in. The new line stays in the original line's Delivery when omitted. */
+    newDeliveryId?: string;
+}
+
 export declare namespace standardServices {
     export {
         ShippingProduct,
@@ -3706,11 +3915,12 @@ export declare namespace Ticket {
         RemoveTagCommand_3 as RemoveTagCommand,
         SetChannelKeyCommand_2 as SetChannelKeyCommand,
         SetDynamicFieldsCommand_3 as SetDynamicFieldsCommand,
-        SetItemDynamicFieldsCommand
+        SetItemDynamicFieldsCommand,
+        SetTagsCommand_3 as SetTagsCommand
     }
 }
 
-declare type TicketCommand = AddActivityLogCommand_3 | AddTagCommand_3 | CreateItemCommand | CreateItemRelationCommand | CreateRelationCommand | DeleteItemCommand | DeleteItemRelationCommand | DeleteRelationCommand | GenerateTicketNumberByPrefixCommand | RemoveTagCommand_3 | SetChannelKeyCommand_2 | SetDynamicFieldsCommand_3 | SetItemDynamicFieldsCommand;
+declare type TicketCommand = AddActivityLogCommand_3 | AddTagCommand_3 | CreateItemCommand | CreateItemRelationCommand | CreateRelationCommand | DeleteItemCommand | DeleteItemRelationCommand | DeleteRelationCommand | GenerateTicketNumberByPrefixCommand | RemoveTagCommand_3 | SetChannelKeyCommand_2 | SetDynamicFieldsCommand_3 | SetItemDynamicFieldsCommand | SetTagsCommand_3;
 
 declare function time(date: Date | string): string;
 
@@ -3730,17 +3940,6 @@ declare interface UnreserveCommand {
     orderLineId: string;
 }
 
-/**
- * Removes the inventory from a Delivery. Stock reservations will be updated if there are any.
- *
- * @see {@link https://developer.hantera.io/reference/actors/order/commands/unset-delivery-inventory/|Hantera Developer Portal}
- */
-declare interface UnsetDeliveryInventoryCommand {
-    type: 'unsetDeliveryInventory';
-    /** The ID of the Delivery to set the address to */
-    deliveryId: string;
-}
-
 export declare function useAppContext(): {
     appId: string;
     getAppViewPath(relativePath: string, appId?: string): string;
@@ -3916,6 +4115,20 @@ export declare function useRegistry(): {
     listChannels(): Promise<Record<string, ChannelEntry_2>>;
 };
 
+export declare function useResolveLabel(): {
+    resolve: (label: string | Record<string, string> | undefined | null) => string;
+    locales: Ref<    {
+    key: string;
+    label: string;
+    language: string;
+    }[], LocaleInfo[] | {
+    key: string;
+    label: string;
+    language: string;
+    }[]>;
+    loadLocales: typeof loadLocales;
+};
+
 export declare interface ViewContext {
     /**
      * A unique ID identifying this view instance

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hantera/portal-app",
-  "version": "20260428.0.0-develop.1",
+  "version": "20260617.0.0-develop.1",
   "types": "./dist/index.d.ts",
   "scripts": {
     "build": "cpx ../../portal/portal-app/dist/**/*.d.ts ./dist -C"