产品报告

方法适用于所有模式.

如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一

返回您在市场上投放的产品的详细报告。 例如,您可以使用该报告来了解库存余额、货物的存储条件等。

⚙️ 限制: 每分钟5,000件物品

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/stats/skus

Path parameters

Name

Description

campaignId

Type: integer

广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:

  • 运动ID;
  • 标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要把它与:

  • 商店的标识符,显示在商家的个人帐户中。
  • 广告活动。

Min value: 1

Body

application/json
{
  "shopSkus": [
    "example"
  ]
}

Name

Description

shopSkus

Type: string[]

您的Id列表 SKU.

Min items: 1

Max items: 500

Unique items: true

Example
[
  "example"
]

Responses

200 OK

产品报告。

Body

application/json
{
  "status": "OK",
  "result": {
    "shopSkus": [
      {
        "shopSku": "example",
        "marketSku": 1,
        "name": "example",
        "price": 0.5,
        "categoryId": 0,
        "categoryName": "example",
        "weightDimensions": {},
        "warehouses": [
          null
        ],
        "tariffs": [
          null
        ],
        "pictures": [
          null
        ]
      }
    ]
  }
}

Type: object

All of 2 types
  • Type: object

    status

    Type: string

    响应的类型。 可能的值:

    • OK — 没有错误。
    • ERROR — 处理请求时出错。

    Enum: OK, ERROR

    服务器响应的标准包装器。

    Example
    {
      "status": "OK"
    }
    
  • Type: object

    result

    Type: object

    shopSkus

    Type: object[]

    categoryId

    Type: integer

    市场上的产品类别的标识符。

    categoryName

    Type: string

    市场上的产品类别的名称。

    Example: example

    marketSku

    Type: integer

    市场上的产品卡的ID。

    Min value: 1

    name

    Type: string

    产品名称。

    Example: example

    pictures

    Type: string[] | null

    连结(URL)产品图像质量好。

    Min items: 1

    Unique items: true

    Example
    [
      "example"
    ]
    

    price

    Type: number

    产品以所设置货币为单位的价格 在市场上的卖方办公室.

    shopSku

    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

    tariffs

    Type: object[]

    amount

    Type: number

    关税的价值。

    currency

    Type: string

    货币代码:

    • RUR — 俄罗斯卢布。
    • UAH — 乌克兰格里夫纳。
    • BYR — 白俄罗斯卢布。
    • KZT — 哈萨克斯坦坚戈。
    • UZS — 乌兹别克总和。

    Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

    parameters

    Type: object[]

    name

    Type: string

    参数的名称。

    Example: example

    value

    Type: string

    参数的值。

    Example: example

    资费计算参数。

    Example
    [
      {
        "name": "example",
        "value": "example"
      }
    ]
    

    type

    Type: string

    市场服务或安置服务的额外收费:

    • AGENCY_COMMISSION — 接受买方的付款。

    • PAYMENT_TRANSFER — 买方付款的转让。

    • STORAGE — 白天在市场仓库存放货物。

    • SURPLUS — 在市场仓库储存盈余。

    • WITHDRAW — 从市场仓库出口货物。

    • FEE — 产品在市场上的放置。

    • DELIVERY_TO_CUSTOMER — 交付给买方。

    • CROSSREGIONAL_DELIVERY — 送到联邦区、市或地方.

    • CROSSREGIONAL_DELIVERY_RETURN — 交付非购买和退款。

    • DISPOSAL — 处置。

    • SORTING_CENTER_STORAGE — 存储非购买和退款。

    • EXPRESS_DELIVERY — 快递给买方。

    • FF_XDOC_SUPPLY_BOX — 通过中转仓库(每箱)交付货物。

    • FF_XDOC_SUPPLY_PALLET — 通过中转仓库(每个托盘)交付货物。

    • SORTING — 订单处理。

    • MIDDLE_MILE — 平均英里。

    • RETURN_PROCESSING — 处理非购买和退款。

    • EXPRESS_CANCELLED_BY_PARTNER — 用快递取消订单.

    • CROSSBORDER_DELIVERY — 从国外交货。

    • INTAKE_SORTING_BULKY_CARGO — 用市场从卖方仓库中提取的大件物品对订单进行排序。

    • INTAKE_SORTING_SMALL_GOODS — 用市场从卖方仓库中取出的小件物品对订单进行排序。

    • INTAKE_SORTING_DAILY — 组织从卖方仓库收集订单.

    • FF_STORAGE_BILLING — 在仓库中储存货物.

    • CANCELLED_ORDER_FEE_QI — 取消订单是卖方的过错。

    • LATE_ORDER_EXECUTION_FEE_QI — 延迟装运或交货.

    • VOLUME_STORAGE — 在仓库中存储货物的成本 — 以每天一立方米计算。

    • GOODS_ACCEPTANCE — 仓库货物的最终验收.

    • CARGO_ACCEPTANCE — 仓库中货物的初始验收。

    • ORDER_PROCESSING — 订单处理。

    • WITHDRAW_EXTERNAL — 运送到外部市场。

    阅读更多关于Yandex的信息。市场服务 在市场对卖家的帮助.

    Enum: AGENCY_COMMISSION, PAYMENT_TRANSFER, STORAGE, WITHDRAW, SURPLUS, FEE, DELIVERY_TO_CUSTOMER, CROSSREGIONAL_DELIVERY, CROSSREGIONAL_DELIVERY_RETURN, DISPOSAL, SORTING_CENTER_STORAGE, EXPRESS_DELIVERY, FF_XDOC_SUPPLY_BOX, FF_XDOC_SUPPLY_PALLET, SORTING, MIDDLE_MILE, RETURN_PROCESSING, EXPRESS_CANCELLED_BY_PARTNER, CROSSBORDER_DELIVERY, INTAKE_SORTING_BULKY_CARGO, INTAKE_SORTING_SMALL_GOODS, INTAKE_SORTING_DAILY, FF_STORAGE_BILLING, CANCELLED_ORDER_FEE_QI, LATE_ORDER_EXECUTION_FEE_QI, VOLUME_STORAGE, GOODS_ACCEPTANCE, CARGO_ACCEPTANCE, ORDER_PROCESSING, WITHDRAW_EXTERNAL

    percent

    Type: number

    关税价值以百分比表示。

    有关您需要为Yandex支付的关税的信息。市场服务。

    对于某些服务,可能会返回几个不同的值。 例如,在模型中 FBS 服务的成本 SORTING (订单处理)取决于运输方式 和货件中的订单数量。 阅读更多有关服务收费的资料 在市场对卖家的帮助.

    Min items: 1

    Example
    [
      {
        "type": "AGENCY_COMMISSION",
        "percent": 0.5,
        "amount": 0.5,
        "currency": "RUR",
        "parameters": [
          {
            "name": "example",
            "value": "example"
          }
        ]
      }
    ]
    

    warehouses

    Type: object[]

    stocks

    Type: object[]

    count

    Type: integer

    剩菜的价值。

    type

    Type: string

    仓库中剩余货物的类型:

    • AVAILABLE (对应于市场上卖方办公室"库存余额"报告中的"可供订购"类型) — 可供出售的物品。

    • DEFECT (对应于"婚姻"类型) — 有缺陷的产品。

    • EXPIRED (对应于"逾期"类型) — 过期的产品。

    • FIT (对应于"适合"类型) — 可供出售或已被保留的物品。

    • FREEZE — 为订单保留的产品。

    • QUARANTINE (对应于"隔离"类型) — 暂时不可出售的物料(例如,物料正在从一个仓库移动到另一个仓库)。

    • UTILIZATION — 将被处置的产品。

    Enum: FIT, FREEZE, AVAILABLE, QUARANTINE, UTILIZATION, DEFECT, EXPIRED

    仓库中剩余货物的信息。

    Example
    [
      {
        "type": "FIT",
        "count": 0
      }
    ]
    

    id

    Type: integer

    仓库ID。

    name

    Type: string

    仓库的名称。

    Example: example

    有关存储货物的仓库的信息。

    如果产品不在任何仓库中,则不会收到该参数。

    Min items: 1

    Example
    [
      {
        "id": 0,
        "name": "example",
        "stocks": [
          {
            "type": "FIT",
            "count": 0
          }
        ]
      }
    ]
    

    weightDimensions

    Type: object

    height

    Type: number

    产品的高度以厘米为单位。

    length

    Type: number

    产品的长度以厘米为单位。

    weight

    Type: number

    以公斤为单位的产品重量。

    width

    Type: number

    产品的宽度以厘米为单位。

    有关产品重量和尺寸的信息。

    如果产品已链接到卡(marketSku),响应将返回市场卡中的尺寸,而不是您提供的尺寸。

    Example
    {
      "length": 0.5,
      "width": 0.5,
      "height": 0.5,
      "weight": 0.5
    }
    

    的产品清单。

    Example
    [
      {
        "shopSku": "example",
        "marketSku": 1,
        "name": "example",
        "price": 0.5,
        "categoryId": 0,
        "categoryName": "example",
        "weightDimensions": {
          "length": 0.5,
          "width": 0.5,
          "height": 0.5,
          "weight": 0.5
        },
        "warehouses": [
          {
            "id": 0,
            "name": "example",
            "stocks": [
              {}
            ]
          }
        ],
        "tariffs": [
          {
            "type": "AGENCY_COMMISSION",
            "percent": 0.5,
            "amount": 0.5,
            "currency": "RUR",
            "parameters": [
              {}
            ]
          }
        ],
        "pictures": [
          "example"
        ]
      }
    ]
    

    产品报告。

    Example
    {
      "shopSkus": [
        {
          "shopSku": "example",
          "marketSku": 1,
          "name": "example",
          "price": 0.5,
          "categoryId": 0,
          "categoryName": "example",
          "weightDimensions": {
            "length": 0.5,
            "width": 0.5,
            "height": 0.5,
            "weight": 0.5
          },
          "warehouses": [
            {
              "id": 0,
              "name": "example",
              "stocks": [
                null
              ]
            }
          ],
          "tariffs": [
            {
              "type": "AGENCY_COMMISSION",
              "percent": 0.5,
              "amount": 0.5,
              "currency": "RUR",
              "parameters": [
                null
              ]
            }
          ],
          "pictures": [
            "example"
          ]
        }
      ]
    }
    
    Example
    {
      "result": {
        "shopSkus": [
          {
            "shopSku": "example",
            "marketSku": 1,
            "name": "example",
            "price": 0.5,
            "categoryId": 0,
            "categoryName": "example",
            "weightDimensions": {
              "length": 0.5,
              "width": 0.5,
              "height": 0.5,
              "weight": 0.5
            },
            "warehouses": [
              {}
            ],
            "tariffs": [
              {}
            ],
            "pictures": [
              "example"
            ]
          }
        ]
      }
    }
    

400 Bad Request

请求包含不正确的数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

500 Internal Server Error

Yandex中的内部错误。 市场。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type
  • Type: object

    All of 2 types
    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
        "status": "OK"
      }
      
    • Type: object

      errors

      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

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