---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
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
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt

# 与仓库合作

Yandex Market API 它允许您获取有关仓库的信息，以及禁用它们或单个操作模型，以便暂时将货物从展柜中隐藏并将其重新打开。

## 获取仓库列表 {#partner-warehouses}

如果机柜中没有仓库组，则提出请求 [POST v3/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/zh/reference/warehouses/getPartnerWarehouses.md).

该方法将返回机柜仓库和工作模型列表（FBS, DBS, Express）和每个模型的API可用性。


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


如果机柜中有仓库组，请使用 [POST v2/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/zh/reference/warehouses/getPagedWarehouses.md). [什么是仓库组，为什么需要它们？](https://yandex.ru/support/marketplace/assortment/operations/stocks.html#unified-stocks).


{% endnote %}


## 了解仓库状况 {#status}


<!-- source: zh/_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 您的店铺
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: 获取仓库状态
        Merchant ->>+ Market: 活动ID<br>及参数components值为STATUS<br>POST v2/businesses/{businessId}/warehouses
        Market -->> Merchant: OK: 每个仓库的状态。
    end
```
<!-- endsource: zh/_includes/mermaid/warehouse-status.md -->


如果机柜中有仓库组，请提出请求 [POST v2/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/zh/reference/warehouses/getPagedWarehouses.md) 在哪里指定:

* 活动Id — `campaignIds`;
* 仓库物业 — 参数 `components` 与值 `STATUS`.

如果机柜中没有仓库组，则可以在方法的响应中获取工作模型的状态 [POST v3/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/zh/reference/warehouses/getPartnerWarehouses.md).

## 找出用于转移剩菜的仓库组 {#group}

如果仓库被分组，您只需要为**任何一个**仓库转移剩菜。 — 此组中其他仓库的信息将自动更新。 [什么是仓库组，为什么需要它们？](https://yandex.ru/support/marketplace/ru/assortment/operations/stocks.html#unified-stocks)


<!-- source: zh/_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 您的店铺
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: 获取合并到组中的仓库
        Merchant ->>+ Market: 活动标识符<br>POST v2/businesses/{businessId}/warehouses
        Market -->> Merchant: OK: 仓库信息
    end
```
<!-- endsource: zh/_includes/mermaid/warehouse-group.md -->


要找出分组的仓库，请获取有关所有仓库的信息。 为此，请提出请求 [POST v2/businesses/{businessId}/warehouses](https://yandex.com/dev/market/partner-api/doc/zh/reference/warehouses/getPagedWarehouses.md) 指定市场活动Id的位置 — `campaignIds`. 参数 `components` 你不需要传送它。

如果仓库的响应是:

* 没有参数 `groupInfo` — 他不在小组里。 通过指定与仓库关联的商店的活动ID来转移剩菜。
* 返回的参数 `groupInfo` — 仓库分组在一起。 同名仓库 `id` 在 `WarehouseGroupInfoDTO` 他们属于同一组。 通过指定此组中任何商店的活动ID来转移剩菜。

[如何转移剩菜](https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/stocks.md)

## 禁用或启用仓库操作模型 {#update-model-status}

如果您需要隐藏或返回展示的商品只有一个模型的工作（FBS, DBS 或 Express），提出要求 [POST v3/businesses/{businessId}/warehouse/models/status](https://yandex.com/dev/market/partner-api/doc/zh/reference/warehouses/updateWarehouseModelStatus.md).

在请求中，发送:

* 仓库ID — `partnerWarehouseId`;
* 工作模式 — `model`;
* 状况 — `enabled` 与值 `false` 禁用，或 `true` 来启用它。

禁用模型后，在此仓库中对其工作的产品在15分钟后消失。 打开后，它们会在15分钟内返回展柜，如果模型已关闭30天或更长时间。 — 4小时后。


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


您将无法使用此方法手动打开它。


{% endnote %}

