Ценовой карантин

Карантин цен — механизм защиты от ошибочного снижения цен. Если цена снижается более чем на установленный порог (например, 70%), она помещается в карантин и требует ручного подтверждения.

Получение товаров в карантине

Для получения списка товаров с ценами в карантине используется метод POST /jsonrpc/v1/nomenclatures.list с фильтром priceQuarantineByCountry:

POST /jsonrpc
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclatures.list",
  "params": {
    "country": "RU",
    "page": 1,
    "limit": 25,
    "filter": [
      {
        "key": "priceQuarantineByCountry",
        "operator": "EQ",
        "value": ["RU"]
      }
    ]
  }
}

Фильтр priceQuarantineByCountry поддерживает только операторы EQ и IN. Подробнее о фильтрации — в Получение товаров.

Пример ответа

Товары в карантине содержат дополнительные поля approve_price_link и price_details:

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "page": 1,
    "limit": 25,
    "pages": 1,
    "total": 3,
    "nomenclatures": [
      {
        "nomenclature": {
          "lamodaSku": "MP002XM0ABCD01",
          "lamodaParentSku": "MP002XM0ABCD",
          "sellerSku": "MYPRODUCT-001-S",
          "sellerParentSku": "MYPRODUCT-001",
          "brand": "Nike",
          "name": "Кроссовки Nike Air Max",
          "price": 299,
          "ruPrice": 299,
          "priceUpdateStatus": "QUARANTINE",
          "approve_price_link": "https://seller.lamoda.ru/nomenclatures?priceQuarantineByCountry=RU",
          "price_details": {
            "created_at": "2025-01-24T12:53:50+03:00",
            "data": {
              "drop_pct": 70.1,
              "new_black_price": 299,
              "old_black_price": 1000,
              "threshold_pct": 70
            },
            "reason": "black_price_diff"
          }
        }
      }
    ]
  }
}

Структура price_details

Причины карантина (reason)

Подтверждение цены через API

Для подтверждения цены в карантине используется метод POST /jsonrpc/v1/nomenclature.set-price (описан в Управление ценами) с флагом force: true:

POST /jsonrpc
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclature.set-price",
  "params": {
    "country": "RU",
    "lamoda_parent_sku": "MP002XM0ABCD",
    "partner_id": 12345,
    "price": 299,
    "force": true
  }
}

При подтверждении укажите ту же цену, что в карантине. Полное описание параметров set-price — в Управление ценами → FBS: Обновление одной цены.

Подтверждение через веб-интерфейс

Также можно подтвердить цену через веб-интерфейс по ссылке из поля approve_price_link:

https://seller.lamoda.ru/nomenclatures?priceQuarantineByCountry=RU

Отмена цены в карантине

Чтобы отменить цену в карантине и вернуть старую цену, установите предыдущую цену методом POST /jsonrpc/v1/nomenclature.set-price без флага force:

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclature.set-price",
  "params": {
    "country": "RU",
    "lamoda_parent_sku": "MP002XM0ABCD",
    "partner_id": 12345,
    "price": 1000
  }
}

Статусы цен (priceUpdateStatus)

Рекомендации

• Регулярная проверка: Периодически проверяйте товары в карантине, чтобы они не простаивали без цен
• Автоматизация: Настройте уведомления о попадании товаров в карантин через вебхуки
• Аккуратность с force: Флаг force: true подтверждает любое снижение цены — используйте осознанно

См. также

• Управление ценами — полное описание методов set-price, set-prices, update-price
• Получение товаров — фильтрация, включая priceQuarantineByCountry