---
schema_version: "1"
id: 6a2eadb014f5fc584d9e9850f0ad70434fa1030a17fd90184232a2ec63993871
title: Manage Orders with Point of Sale SPIs
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/retail-cloud/guides/manage-orders-with-spis.md
canonical_url: https://developer.salesforce.com/docs/commerce/retail-cloud/guide/manage-orders-with-spis.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 3458ec8b853c0dae22aab80c4217ebcb6b61f36014ba2f2340b2270aa5c9e3f9
products:
  - Point of Sale for Developers
  - Salesforce APIs
---
# Manage Orders with Point of Sale SPIs

Configure Point of Sale SPIs to manage orders when an external order management system isn't available. Improve order processing and management capabilities. Gain the benefits of a robust order management system directly within Point of Sale. Efficiently handle order workflows, track order status, and streamline fulfillment processes.

## Configure SPIs

Create and configure two SPIs in CMS: Search Order and Order Details.

![The CMS shows details of two SPI configurations.](https://developer.salesforce.com/docs/media/retail-cloud/rt-pos-orders-process-spi-order-master-config.png)

### Search Order SPI

1.  In CMS, go to **Integrations** | **Custom Connectors**.

2.  Click **Create**.

3.  For Connector Type, select **SPI**.

4.  For Endpoint Name, select **SEARCH_ORDER**.

5.  Configure the rest of the fields by referring to [Point of Sale API, SPI, and Webhook Overview](https://developer.salesforce.com/docs/commerce/retail-cloud/guide/retail-cloud-api-spi-webhook-specs.html).

6.  Save your changes.

### Order Details SPI

1.  In CMS, go to **Integrations** | **Custom Connectors**.

2.  Click **Create**.

3.  For Connector Type, select **SPI**.

4.  For Endpoint Name, select **GET_ORDER_DETAIL**.

5.  Configure the rest of the fields by referring to [Point of Sale API, SPI, and Webhook Overview](https://developer.salesforce.com/docs/commerce/retail-cloud/guide/retail-cloud-api-spi-webhook-specs.html).

6.  Save your changes.

## Enhanced Search Functionality

Turn on the updated order search service (orderSearchV2) in CMS to leverage Point of Sale latest order search capabilities. The sequence of these calls begins with populating the order history section in the customer profile using the Order Search API. If the SEARCH_ORDER SPI is configured and orderSearchV2 is enabled, the customer's orders are retrieved from an external system and displayed in this section.

**important:** The SPIs must be configured.

1.  In CMS, go to **Store Management** | **Store Settings** | **System**.

2.  Expand **Rollout**.

3.  Turn on the setting "Use new order search service (useOrderSearchV2)."
    ![The CMS shows the use new order search service flag.](https://developer.salesforce.com/docs/media/retail-cloud/rt-pos-orders-process-spi-order-master-search.png)

## Known Issues & Restrictions

**Status & Returns**

Point of Sale enforces a check that prevents orders from being returned unless they have a status of Completed, Exchanged, Partially Exchanged, Fulfilled, or Partially Refunded. Orders with a status of, for example, Shipped can't be returned.