---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/warehouses.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/warehouses.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/warehouses.md
  - href: en/step-by-step/warehouses.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

# Working with warehouses

Yandex Market API It allows you to get information about warehouses, as well as disable them or individual models of operation in order to temporarily hide goods from the showcase and turn them back on.

## Get a list of warehouses {#partner-warehouses}

If there are no warehouse groups in the cabinet, make a request [POST v3/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/en/reference/warehouses/getPartnerWarehouses.md).

The method will return a list of cabinet warehouses and work models (FBS, DBS, Express) and API availability for each model.


{% note warning "Метод подходит, только если в кабинете нет групп складов" %}


If there are warehouse groups in the cabinet, use [POST v2/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/en/reference/warehouses/getPagedWarehouses.md). [What are warehouse groups and why are they needed?](https://yandex.ru/support/marketplace/assortment/operations/stocks.html#unified-stocks).


{% endnote %}


## Find out warehouse statuses {#status}


<!-- source: en/_includes/mermaid/warehouse-status.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting warehouse statuses
        Merchant ->>+ Market: Campaign IDs<br>and parameter components with value STATUS<br>POST v2/businesses/{businessId}/warehouses
        Market -->> Merchant: OK: status of each warehouse.
    end
```
<!-- endsource: en/_includes/mermaid/warehouse-status.md -->


If there are warehouse groups in the cabinet, make a request [POST v2/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/en/reference/warehouses/getPagedWarehouses.md) where to specify:

* campaign IDs — `campaignIds`;
* warehouse property — parameter `components` with the value `STATUS`.

If there are no warehouse groups in the cabinet, you can get the statuses of the work models in the response of the method [POST v3/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/en/reference/warehouses/getPartnerWarehouses.md).

## Find out the groups of warehouses for transferring leftovers {#group}

If the warehouses are grouped, you only need to transfer the leftovers for **any one** warehouse. — The information for the other warehouses in this group will be updated automatically. [What are warehouse groups and why are they needed?](https://yandex.ru/support/marketplace/ru/assortment/operations/stocks.html#unified-stocks)


<!-- source: en/_includes/mermaid/warehouse-group.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting warehouses that are grouped together
        Merchant ->>+ Market: Campaign IDs<br>POST v2/businesses/{businessId}/warehouses
        Market -->> Merchant: OK: warehouse information.
    end
```
<!-- endsource: en/_includes/mermaid/warehouse-group.md -->


To find out which warehouses are grouped, get information about all warehouses. To do this, make a request [POST v2/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/en/reference/warehouses/getPagedWarehouses.md) where to specify the campaign IDs — `campaignIds`. Parameter `components` You don't need to transmit it.

If the warehouse's response is:

* There is no parameter `groupInfo` — he is not in the group. Transfer the leftovers by specifying the campaign ID of the store that is associated with the warehouse.
* The parameter returned `groupInfo` — The warehouse is grouped together. Warehouses with the same name `id` in `WarehouseGroupInfoDTO` they belong to the same group. Transfer the leftovers by specifying the campaign ID of any store in this group.

[How to transfer leftovers](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/stocks.md)

## Disable or enable the warehouse operation model {#update-model-status}

If you need to hide or return to the showcase the goods of only one model of work (FBS, DBS or Express), make a request [POST v3/businesses/{businessId}/warehouse/models/status](https://yandex.com/dev/market/partner-api/doc/en/reference/warehouses/updateWarehouseModelStatus.md).

In the request, send:

* warehouse ID — `partnerWarehouseId`;
* the work model — `model`;
* status — `enabled` with the value `false` to disable, or `true` to enable it.

After disabling the model, the products that work on it in this warehouse disappear after 15 minutes. After switching on, they return to the showcase in 15 minutes, and if the model has been turned off for 30 days or longer. — after 4 hours.


{% note info "Если модель отключил Маркет" %}


You will not be able to turn it on manually using this method.


{% endnote %}

