从12月31日开始，push API方法将不可用。 从10月1日开始，它们可能不稳定。

有关如何通过API处理余额的分步说明

请求有关余额的信息

Deprecated

我应该使用哪种方法而不是过时的方法？

PUT v2/campaigns/{campaignId}/offers/stocks

从商店请求有关剩余商品的最新信息。

我们大约每小时收到一次关于每个仓库的请求.

你需要在27秒内回答。 如果你没来，yandex。市场将再次向您发送请求。 在多次未回报的尝试之后，通过以下方式转移剩余资金 POST 股票 它会关闭。

每个请求最多可接收1,000个请求 SKU. 如果有更多的项目库存，不同项目的请求到达在同一时间。

Request

POST

/stocks

Body

application/json
{
  "warehouseId": 0.5,
  "skus": [
    "example"
  ]
}

Name

Description

skus

Type: string[]

你的名单 SKU 需要传输剩余余额信息的产品。

Example
[
  "example"
]

warehouseId

Type: number

仓库ID。

商店的响应必须包含相同的标识符。

Responses

200 OK

在响应中，您需要向市场发送所有请求项目的当前余额。

Body

application/json
{
  "skus": [
    {
      "sku": "example",
      "warehouseId": 0,
      "items": [
        {
          "count": 0,
          "type": "FIT",
          "updatedAt": "2025-01-01T00:00:00Z"
        }
      ]
    }
  ]
}

Name

Description

skus
Type: object[]

items
Type: object[]

count

Type: integer

可用产品的数量。

Min value: 0

Max value: 2000000000

type

Type: string

此参数尚未使用。 — 始终传递值 FIT.

  • FIT — 必须始终传递的值。
  • ACTUAL — 尚未使用的值。

Enum: FIT, ACTUAL

updatedAt

Type: string<date-time>

最后更新有关指定类型余额的信息的日期和时间。

日期和时间格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00：42：42+03：00.

Example: 2025-01-01T00:00:00Z

有关此仓库中剩余货物的信息。

Min items: 1

Max items: 1

Example
[
  {
    "count": 0,
    "type": "FIT",
    "updatedAt": "2025-01-01T00:00:00Z"
  }
]

sku

Type: string

你的 SKU — 系统中的产品ID。

使用规则 SKU:

  • 对于每个产品 SKU 一定有一个。

  • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.

重要

值开头和结尾的空格会自动删除。 例如, " SKU123 " 和 "SKU123" 它们将被视为相同的值。

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Example: example

warehouseId

Type: integer

仓库ID。

您可以在部分的橱柜中找到仓库ID 物流→仓库. 它在字段中指定 仓库ID.

如果你正在回应一个Yandex的。市场请求，指定请求中出现的ID。

有关Yandex中指定的剩余项目的信息。市场要求。

Example
[
  {
    "sku": "example",
    "warehouseId": 0,
    "items": [
      {
        "count": 0,
        "type": "FIT",
        "updatedAt": "2025-01-01T00:00:00Z"
      }
    ]
  }
]

No longer supported, please use an alternative and newer version.