> 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/modules-and-features/marketplace/orders.md).

# Orders

An order represents a transaction that starts, changes, or ends a service in Marketplace.

Orders are created under an agreement, and a single agreement can contain multiple orders. The Marketplace supports the following types of orders:

* **Purchase order** – Created when you buy a new product or service by establishing a new agreement.
* **Change order** – Used to modify an existing subscription, such as adding or removing licenses.
* **Termination order** – Used to end an active subscription or agreement.
* **Configuration order** – Used to manage subscription renewal settings. Depending on the vendor and subscription type, configuration orders may provide additional options or capabilities for managing the subscription.
* **Suspend order** – Created by SoftwareOne to temporarily pause an active subscription without terminating it. The subscription configuration, data, and contractual terms are retained.
* **Resume order** – Created by SoftwareOne to reactivate a suspended subscription and restore service access using the existing subscription configuration.

Marketplace orders move through various states from creation to completion. The available actions depend on the current state of the order. For more information, see [Order states](/modules-and-features/marketplace/orders/order-states.md).

### Orders page

The **Orders** page displays all orders in your account. From this page, you can also manage an order, depending on its current status.

To open the page, select **Marketplace** > **Orders** from the main menu.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/eYRBEcJbfE5tVyfEBfie/image.png" alt=""><figcaption><p>Use the Orders page to view and manage your orders.</p></figcaption></figure></div>

On the **Orders** page, you can view details for each order, including order ID, order type, and status.

You can also open an order to view details across several tabs, including entitlements, assets, and subscriptions, attachments and certificates, event history, and logs. For more details, see [View orders](/modules-and-features/marketplace/orders/view-orders.md).

### Related topics

{% content-ref url="/spaces/Z5DNbniz33mXCZoO62Rm/pages/ENblbuxJHehJ6tFEbCaC" %}
[Order states](/modules-and-features/marketplace/orders/order-states.md)
{% endcontent-ref %}

{% content-ref url="/spaces/Z5DNbniz33mXCZoO62Rm/pages/qFA0mZAhSVIxO7Rbxt1T" %}
[View orders](/modules-and-features/marketplace/orders/view-orders.md)
{% endcontent-ref %}

{% content-ref url="/spaces/Z5DNbniz33mXCZoO62Rm/pages/C4eLnu35BcJ5Vnvmo2B0" %}
[Save order for later](/modules-and-features/marketplace/orders/save-order-as-a-draft.md)
{% endcontent-ref %}

{% content-ref url="/spaces/Z5DNbniz33mXCZoO62Rm/pages/rStisPTDT903ya5akqP1" %}
[Add or update order notes](/modules-and-features/marketplace/orders/manage-order-notes.md)
{% endcontent-ref %}

{% content-ref url="/spaces/Z5DNbniz33mXCZoO62Rm/pages/earaLHFbiFOzLQQLDqBe" %}
[Send order reminder email](/modules-and-features/marketplace/orders/send-order-reminder-email.md)
{% endcontent-ref %}

{% content-ref url="/spaces/Z5DNbniz33mXCZoO62Rm/pages/3D6oSHcZyYZ0fQecnmCA" %}
[Change status from Querying to Processing](/modules-and-features/marketplace/orders/set-an-order-to-processing.md)
{% endcontent-ref %}

{% content-ref url="/spaces/Z5DNbniz33mXCZoO62Rm/pages/RyLICiQbF6sDoCoz8oSv" %}
[Submit saved orders](/modules-and-features/marketplace/orders/submit-draft-orders.md)
{% endcontent-ref %}

{% content-ref url="/spaces/Z5DNbniz33mXCZoO62Rm/pages/7Q9NMAbS7diYOWzV1HSQ" %}
[Delete orders](/modules-and-features/marketplace/orders/delete-draft-orders.md)
{% endcontent-ref %}

{% content-ref url="/spaces/Z5DNbniz33mXCZoO62Rm/pages/SlhOtuUthnsboe34pioO" %}
[Create and manage renewal orders](/modules-and-features/marketplace/orders/create-and-manage-renewal-orders.md)
{% endcontent-ref %}


---

# 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/modules-and-features/marketplace/orders.md?ask=<question>&goal=<user_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.
