Репрайсер РРЦ V2

Рекомендации по входу в акции с заниженной ценой

Changed on

Отдаёт список артикулов, которым не хватает совсем немного, чтобы попасть в акцию.

В ответ попадают только артикулы с рекомендациями, поэтому total можно использовать как счётчик для уведомления в интерфейсе. Рекомендация отдаётся по каждой акции, в которую можно войти, поэтому один артикул может встретиться в списке несколько раз - с разными action_id.

По каждому артикулу приходит разбор: required_steps - что нужно сделать обязательно (снизить минимальную цену селлера, ниже которой репрайсер не опускается, и включить автоработу с акциями), и alternatives - пути попасть в акцию, из которых достаточно выполнить любой один.

Считается всё от expected_seller_price - цены, которую репрайсер посчитает при текущих настройках. Поэтому применённое изменение не порождает новую рекомендацию до цикла.

Если настройки уже изменены и при них репрайсер войдёт в акцию сам, рекомендация приходит со статусом PENDING_ENTRY и без шагов. В total такие не входят - они считаются в pending_total и идут в конце списка.

Насколько дешёвые акции рассматривать, задаёт gate_percent: смотрим акции в границах «допустимое отклонение по артикулу + gate_percent» ниже рассчитанной цены селлера. Артикулы без настроенного отклонения не пропускаются - для них граница равна самому gate_percent.

Если по магазину включено action_recommend_hidden, ответ всегда пустой.

post/v2/rrc/action-recommendations

Request

  • Base URL: https://api.mpspace.ru (the document declares no server; this is the origin it was published from)
  • URL: https://api.mpspace.ru/v2/rrc/action-recommendations
  • Auth: none declared. Required headers: x-user-id, x-connect-id

Query parameters

limitinteger

Лимит рекомендаций в ответе

offsetinteger

Сдвиг выборки (постраничная навигация)

blockstring

Headers

x-user-idinteger required

ID пользователя

x-connect-idinteger required

ID магазина

Request body

skusinteger[]

Ограничить выборку этими SKU Ozon. Пустой список - весь магазин.

product_idsinteger[]

Ограничить выборку этими product_id. Пустой список - весь магазин.

gate_percentinteger

Запас поиска акций в процентах.

Акции рассматриваются, если их максимальная цена не ниже, чем допустимое отклонение по артикулу + gate_percent процентов от рассчитанной цены селлера. То есть при отклонении 3% и gate_percent = 10 смотрим акции до 13% ниже цены, а при отклонении 0% - до 10%: артикул не пропускается, даже если отклонение ему ещё не настроено.

Значение 0 оставляет только те акции, которые уже проходят по текущей настройке отклонения.

Example request

{
  "skus": [
    175495748
  ],
  "product_ids": [
    24442827
  ],
  "gate_percent": 10
}

Response

Successful Response

totalinteger

Сколько рекомендаций со статусом ACTION_REQUIRED найдено по магазину и фильтрам. Годится как счётчик для уведомления в интерфейсе.

pending_totalinteger

Сколько рекомендаций со статусом PENDING_ENTRY. Всего элементов для постраничной навигации - total + pending_total: сначала идут ACTION_REQUIRED, за ними PENDING_ENTRY.

limitinteger

Лимит из запроса.

offsetinteger

Сдвиг выборки из запроса.

gate_percentinteger

Применённый запас поиска в процентах - см. одноимённое поле запроса.

Example response

{
  "total": 3,
  "pending_total": 1,
  "limit": 1000,
  "gate_percent": 10,
  "recommendations": [
    {
      "status": "ACTION_REQUIRED",
      "product_id": 24442827,
      "sku_sds": 175495748,
      "offer_id": "00-00000028",
      "action_id": 4113327,
      "action_name": "Акция для складов. Юг",
      "max_action_price": 2849,
      "seller_price": 2850,
      "expected_seller_price": 2850,
      "deviation_percent": 0.04,
      "required_percent": 1,
      "current": {
        "min_price": 2850,
        "control_price": 1990,
        "action_deviation_mode": "AUTO",
        "action_deviation_percent": 3
      },
      "required_steps": [
        {
          "action": "LOWER_MIN_PRICE",
          "value": 2849
        }
      ],
      "alternatives": [
        {
          "kind": "AUTO_ENTRY",
          "steps": [
            {
              "action": "LOWER_MIN_PRICE",
              "value": 2849
            }
          ]
        }
      ]
    }
  ]
}

Changes

  • e892f419e8c6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 55ff8dbe9e0dRevision changes
    • info

      endpoint added