Карантин цен в API

Что такое карантин цен

Как это работает

1. Вы отправляете запрос на изменение цены через API
2. Система проверяет: снижение > 70%?
3. Если да → цена попадает в карантин, статус QUARANTINE
4. Если нет → цена применяется сразу, статус APPLIED
5. Цену из карантина нужно подтвердить в Личном кабинете

Новое поле price_status

В ответах методов обновления цен появилось новое поле price_status:

Структура price_status

{
  "price_status": {
    "code": "QUARANTINE",
    "details": {
      "created_at": "2025-12-08T12:53:50+03:00",
      "data": {
        "drop_pct": 70.1,
        "new_black_price": 299,
        "old_black_price": 1000,
        "threshold_pct": 70
      },
      "reason": "black_price_diff"
    }
  }
}

Пример: цена в карантине

Запрос

POST https://public-api-seller.lamoda.ru/jsonrpc/v1/nomenclature.update-price
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclature.update-price",
  "params": {
    "seller_sku": "SHOE-001",
    "black_price": 299,
    "country": "RU"
  },
  "id": 1
}

Ответ (цена в карантине)

{
  "jsonrpc": "2.0",
  "result": {
    "seller_sku": "SHOE-001",
    "price_status": {
      "code": "QUARANTINE",
      "details": {
        "created_at": "2025-12-08T14:30:00+03:00",
        "data": {
          "drop_pct": 70.1,
          "new_black_price": 299,
          "old_black_price": 1000,
          "threshold_pct": 70
        },
        "reason": "black_price_diff"
      }
    }
  },
  "id": 1
}

Пример: цена применена

Ответ (цена применена сразу)

{
  "jsonrpc": "2.0",
  "result": {
    "seller_sku": "SHOE-001",
    "price_status": {
      "code": "APPLIED"
    }
  },
  "id": 1
}

Как подтвердить цену из карантина

Подтверждение возможно только через Личный кабинет:

1. Войдите в seller.lamoda.ru
2. Перейдите в раздел Товары → Цены
3. Найдите товары со статусом На проверке
4. Подтвердите или отклоните изменение цены

Фильтрация товаров в карантине

Метод v1.nomenclatures.list теперь поддерживает фильтр по статусу цены:

POST https://public-api-seller.lamoda.ru/jsonrpc/v1/nomenclatures.list
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclatures.list",
  "params": {
    "price_status": "QUARANTINE",
    "page": 1,
    "limit": 100
  },
  "id": 1
}

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

Best practices:

• После массового обновления цен проверяйте поле price_status в ответе
• Настройте мониторинг: если много цен попадает в карантин — возможна ошибка в данных
• Проверяйте ЛК ежедневно на наличие цен в карантине
• Используйте фильтр price_status: "QUARANTINE" для получения списка товаров на проверке

Частые вопросы

Почему порог именно 70%?

Это значение выбрано как баланс между защитой от ошибок и удобством работы. Снижение цены более чем на 70% редко бывает намеренным и чаще свидетельствует об ошибке.

Можно ли изменить порог?

Нет, порог 70% фиксирован для всех селлеров.

Что будет, если не подтвердить цену?

Товар будет продаваться по старой цене. Цена в карантине хранится 30 дней, после чего автоматически отклоняется.

Применяется ли карантин к повышению цены?

Нет, карантин срабатывает только при снижении цены более чем на 70%.

См. также

• Управление ценами
• Получение списка товаров
• История изменений в API