> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Use Cases and Flows

## Article: Sample Use Cases and Flows

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/stores-locations-v3/sample-use-cases-and-flows.md

## Article Content:

# Stores Locations API: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. This can be a helpful jumping off point as you plan your implementation.

## Create a new stores location

You want to add a new warehouse or retail store as an inventory location for your Wix store. Locations are created through the Wix Locations API and automatically appear in the Stores Locations API when configured for inventory.

To create a new stores location:

1. Call [Create Location](https://dev.wix.com/docs/api-reference/business-management/locations/create-location.md) in the Wix Locations API. Include `"INVENTORY"` in the `locationTypes` array:

```json
{
  "location": {
    "name": "Downtown Warehouse",
    "locationTypes": ["INVENTORY"],
    "timeZone": "America/Los_Angeles",
    "address": {
      "streetAddress": {
        "name": "Main Street",
        "number": "123"
      },
      "city": "Los Angeles",
      "country": "US"
    }
  }
}
```

2. The location now appears in the Stores Locations API. Call [Query Stores Locations](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/stores-locations-v3/query-stores-locations.md) to confirm and retrieve the location details.

## Retrieve inventory locations for a store

You want to retrieve all available inventory locations for a store to display them in a location selector or to manage inventory across locations.

To retrieve inventory locations:

1. Call [Query Stores Locations](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/stores-locations-v3/query-stores-locations.md) to get all inventory locations:

```json
{
  "query": {
    "cursorPaging": {
      "limit": 50
    }
  }
}
```

2. To find the default location, filter by `default: true`:

```json
{
  "query": {
    "filter": {
      "default": true
    }
  }
}
```

> **Note:** When customers place orders on a Wix Store, inventory automatically deducts from the default location. For multi-location inventory scenarios, see [Online Store Product Purchase Flow](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/online-store-product-purchase-flow.md).

3. Use the location IDs when creating or querying inventory items with the [Inventory Items API](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/inventory-items-v3/introduction.md).