# How does the Marketplace purchase wizard work?

The SoftwareOne Marketplace's purchase wizard simplifies the ordering process by guiding you through each necessary step of placing an order.&#x20;

There are two ways to launch the wizard, depending on whether you are creating a purchase or a change order. You can either start the wizard by selecting a product on the **Products** page or by selecting **Buy more** on the **agreement details** page.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/bF2YVKWtlp3cplbkW0ep/Wizard.png" alt=""><figcaption><p>Use the Purchase Wizard to place an order.</p></figcaption></figure></div>

### Layout and navigation

The wizard contains a vertical progress bar with step numbers and a title, data grid, and navigation buttons:

* The progress bar shows how far you have progressed and how many steps remain before the order can be placed. The steps are defined by vendors and vary based on the product. You cannot use step numbers to navigate between different pages of the wizard.&#x20;
* The [data grid](https://docs.platform.softwareone.com/marketplace-platform/platform-overview/preferences-and-settings/customize-the-data-grid) is where the main content is displayed. This is where you can select your purchasing options, choose items you want to order, [view description cards](https://docs.platform.softwareone.com/marketplace-platform/platform-overview/interface/view-information-cards#description-cards) containing information about item prices, enter your details, and more.&#x20;
* The **Close**, **Back**, and **Next** buttons allow you to navigate between pages or close the wizard. Some buttons might be unavailable depending on your current step in the wizard.&#x20;

### Guided steps

The purchase guide contains a series of guided steps. Some steps are common and apply to each vendor and product, and some are dynamic, vendor-specific. This section describes the common steps. For product-specific steps, see the respective tutorials.

#### Select agreement&#x20;

In the **Select agreement** step, you can choose whether to use an existing agreement or create a new one. Agreements are essential for placing orders. Your selection in this step determines the subsequent steps in the wizard.&#x20;

You can set up a new agreement if you are new to SoftwareOne or if your procurement needs differ from your existing contract. An existing agreement can be used to add new products, order new items, or adjust the license quantity.

<div data-with-frame="true"><figure><img src="https://1674205915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5DNbniz33mXCZoO62Rm%2Fuploads%2FH3NZ8pEgBVksmXsN1QR6%2Fimage.png?alt=media&#x26;token=5e7a4d17-5ae0-4ef5-afbd-3193043c8bdb" alt=""><figcaption><p>Create a new agreement or choose an existing one.</p></figcaption></figure></div>

If you select an existing agreement instead of creating a new one, you'll see the **Select items** section, where you can directly choose the items to order.&#x20;

#### Select licensee  <a href="#before-you-begin" id="before-you-begin"></a>

The **Select licensee** step allows you to choose a licensee for your new agreement. This step is displayed only when setting up a new agreement.&#x20;

You can either choose an existing licensee or create a new one. If you select **Create licensee**, the wizard closes, and the **Licensees** page opens.&#x20;

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/O9n0UVsoi9vNndRZh7hc/image.png" alt=""><figcaption><p>Select a licensee for the agreement.</p></figcaption></figure></div>

#### Items

In the **Items** step, you can choose the items you want to order.&#x20;

For each item, you can view the commitment period, quantity, and pricing details. If you see an info icon (<i class="fa-circle-info">:circle-info:</i>), it means that additional pricing information is available. Hover over the icon to view a [description card](https://docs.platform.softwareone.com/marketplace-platform/platform-overview/interface/view-information-cards#description-cards) containing further contextual information.&#x20;

<div data-with-frame="true"><figure><img src="https://1674205915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5DNbniz33mXCZoO62Rm%2Fuploads%2FNrUIezTd2vICMAk5DYgD%2Fimage.png?alt=media&#x26;token=483c792b-277f-472c-b9c5-7bea0459f206" alt=""><figcaption><p>Choose the items you want to order.</p></figcaption></figure></div>

#### Details

In the **Details** step, you can enter additional IDs related to your purchase. For example, you can enter a purchase order number in the **Agreement Additional ID** field for your invoice. Additionally, you can [save your order as a draft](https://docs.platform.softwareone.com/modules-and-features/marketplace/orders/save-order-as-a-draft) and finalize it later.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/eHpcgSEKh7BOu14qymYN/image.png" alt=""><figcaption><p>Add additional IDs and notes for your order.</p></figcaption></figure></div>

#### Review order

In the **Review order** step, you can read the terms and conditions of your order using the links in the footer, and submit your order.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/KKqTPvv15ZMmpy7IS9ou/image.png" alt=""><figcaption><p>Read the terms and verify your order before submitting it.</p></figcaption></figure></div>

#### Summary

After the order confirmation is displayed, you can either **close** the wizard or select **View details** to open the **order details** page.

<div data-with-frame="true"><figure><img src="https://1674205915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5DNbniz33mXCZoO62Rm%2Fuploads%2FyIiOX33aBGy0zl0JhzOB%2Fimage.png?alt=media&#x26;token=e5e280f5-9203-49d0-b11f-e2f97675cd6a" alt=""><figcaption><p>Close the wizard or view your order.</p></figcaption></figure></div>
