> For the complete documentation index, see [llms.txt](https://docs.platform.softwareone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.platform.softwareone.com/help-and-support/faqs/buy-products-and-services.md). # How does the Marketplace purchase wizard work? The Marketplace purchase wizard simplifies ordering by guiding you through each step. 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.

Use the Purchase Wizard to place an order.

### 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. * The [data grid](/marketplace-platform/getting-started/customize-the-data-grid.md) 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](/marketplace-platform/getting-started/interface/view-information-cards.md#description-cards) containing information about item prices, enter your details, and more. * 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. ### 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 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. 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.

Create a new agreement or choose an existing one.

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. #### Select licensee 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. 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.

#### Items In the **Items** step, you can choose the items you want to order. For each item, you can view the commitment period, quantity, and pricing details. If you see an info icon (), it means that additional pricing information is available. Hover over the icon to view a [description card](/marketplace-platform/getting-started/interface/view-information-cards.md#description-cards) containing further contextual information.

#### 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](/modules-and-features/marketplace/orders/save-order-as-a-draft.md) and finalize it later.

Add additional IDs and notes for your order.

#### 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.

Read the terms and verify your order before submitting it.

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

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.platform.softwareone.com/help-and-support/faqs/buy-products-and-services.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.