Appearance
useOrderDetails 
Definition 
Composable for managing an existing order.
Basic usage 
ts
const { 
 order,
 status,
 total,
 subtotal,
 shippingCosts,
 shippingAddress,
 billingAddress,
 personalDetails,
 paymentUrl,
 shippingMethod,
 paymentMethod,
 getMediaFile,
 getDocumentFile,
 hasDocuments,
 documents,
 loadOrderDetails,
 handlePayment,
 cancel,
 changePaymentMethod 
} = useOrderDetails(orderId, associations);
Signature 
ts
export function useOrderDetails(
  orderId: string,
  associations?: ShopwareAssociation,
): UseOrderDetailsReturn 
Parameters 
| Name | Type | Description | 
|---|---|---|
| orderId | string | |
| associations | ShopwareAssociation | 
Return type 
See UseOrderDetailsReturn
ts
export type UseOrderDetailsReturn = {
  /**
   * {@link Order} object
   */
  order: ComputedRef<Order | undefined | null>;
  /**
   * Order status (e.g. 'open', 'cancelled')
   */
  status: ComputedRef<string | undefined>;
  /**
   * Order total price
   */
  total: ComputedRef<number | undefined>;
  /**
   * Order subtotal price for all items
   */
  subtotal: ComputedRef<number | undefined>;
  /**
   * Order shipping costs
   */
  shippingCosts: ComputedRef<number | undefined>;
  /**
   * Shipping address
   */
  shippingAddress: ComputedRef<ShippingAddress | undefined>;
  /**
   * Billing address
   */
  billingAddress: ComputedRef<BillingAddress | undefined>;
  /**
   * Basic personal details
   */
  personalDetails: ComputedRef<{
    email: string | undefined;
    firstName: string | undefined;
    lastName: string | undefined;
  }>;
  /**
   * Payment URL for external payment methods (e.g. async payment in external payment gateway)
   */
  paymentUrl: Ref<null | string>;
  /**
   * Selected shipping method
   */
  shippingMethod: ComputedRef<ShippingMethod | undefined | null>;
  /**
   * Selected payment method
   */
  paymentMethod: ComputedRef<PaymentMethod | undefined | null>;
  /**
   * Get order object including additional associations.
   * useDefaults describes what order object should look like.
   */
  loadOrderDetails(): Promise<void>;
  /**
   * Handle payment for existing error.
   *
   * Pass custom success and error URLs (optionally).
   */
  handlePayment(
    successUrl?: string,
    errorUrl?: string,
    paymentDetails?: unknown,
  ): void;
  /**
   * Cancel an order.
   *
   * Action cannot be reverted.
   */
  cancel(): Promise<void>;
  /**
   * Changes the payment method for current cart.
   * @param paymentMethodId - ID of the payment method to be set
   * @returns
   */
  changePaymentMethod(paymentMethodId: string): Promise<void>;
  /**
   * Get media content
   *
   * @param {string} downloadId
   * @returns {Blob}
   */
  getMediaFile: (downloadId: string) => Promise<Blob>;
  /**
   * Get order documents
   * @param {string} documentId
   * @param {string} deepLinkCode
   * @returns
   */
  getDocumentFile: (documentId: string, deepLinkCode: string) => Promise<Blob>;
  /**
   * Check if order has documents
   */
  hasDocuments: ComputedRef<boolean>;
  /**
   * Get order documents
   */
  documents: ComputedRef<OrderDocument[]>;
};
Properties 
| Name | Type | Description | 
|---|---|---|
| order | ComputedRef<Order | undefined | null> | {@link Order} object | 
| status | ComputedRef<string | undefined> | Order status (e.g. 'open', 'cancelled') | 
| total | ComputedRef<number | undefined> | Order total price | 
| subtotal | ComputedRef<number | undefined> | Order subtotal price for all items | 
| shippingCosts | ComputedRef<number | undefined> | Order shipping costs | 
| shippingAddress | ComputedRef<ShippingAddress | undefined> | Shipping address | 
| billingAddress | ComputedRef<BillingAddress | undefined> | Billing address | 
| personalDetails | ComputedRef<{
    email: string | undefined;
    firstName: string | undefined;
    lastName: string | undefined;
  }> | Basic personal details | 
| paymentUrl | Ref< | string> | Payment URL for external payment methods (e.g. async payment in external payment gateway) | 
| shippingMethod | ComputedRef<ShippingMethod | undefined | null> | Selected shipping method | 
| paymentMethod | ComputedRef<PaymentMethod | undefined | null> | Selected payment method | 
| getMediaFile | (downloadId: string) => Promise<Blob> | Get media content | 
| getDocumentFile | (documentId: string, deepLinkCode: string) => Promise<Blob> | Get order documents | 
| hasDocuments | ComputedRef<boolean> | Check if order has documents | 
| documents | ComputedRef<Array<OrderDocument>> | Get order documents | 
Methods 
| Name | Type | Description | 
|---|---|---|
| loadOrderDetails | Promise<void> | Get order object including additional associations.useDefaults describes what order object should look like. | 
| handlePayment | void | Handle payment for existing error.Pass custom success and error URLs (optionally). | 
| cancel | Promise<void> | Cancel an order.Action cannot be reverted. | 
| changePaymentMethod | Promise<void> | Changes the payment method for current cart. |