Обновление цен через API

Статья на модерации

Обновлено

18.12.2025

Содержание статьи

Для обновления цен используются разные методы в зависимости от модели работы (FBS или FBO).

Выбор метода

	FBS	FBO
Метод	`v1.nomenclature.set-price`	`v1.nomenclature.update-price`
API	Seller API	Seller API
Batch	`v1.nomenclatures.set-prices`	—
ID товара	`seller_sku`	`lamoda_parent_sku`

Частая ошибка: "Партнёр не найден" (50400)

Если вы FBS и используете update-price — получите эту ошибку.
Если вы FBO и используете set-price — тоже ошибка.

Проверьте вашу модель и используйте правильный метод!

FBS: Обновление одной цены

POST v1.nomenclature.set-price

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclature.set-price",
  "params": {
    "seller_sku": "MYPRODUCT-001-S",
    "country": "RU",
    "price": 5990,
    "sale_price": 4990,
    "sale_start": "2025-12-01",
    "sale_end": "2025-12-31",
    "force": false
  }
}

Параметры

Параметр	Тип	Обязательный	Описание
`seller_sku`	string	Да	Ваш артикул товара
`country`	string	Да	Код страны: RU, BY, KZ
`price`	number	Да	Базовая цена (кратна 10)
`sale_price`	number	Нет	Цена по акции
`sale_start`	date	Нет	Начало акции (YYYY-MM-DD)
`sale_end`	date	Нет	Конец акции
`force`	boolean	Нет	Пропустить карантин при снижении >70%

FBS: Пакетное обновление цен

POST v1.nomenclatures.set-prices

{
  "jsonrpc": "2.0",
  "id": "...",
  "method": "v1.nomenclatures.set-prices",
  "params": {
    "prices": [
      {
        "seller_sku": "SKU-001",
        "country": "RU",
        "price": 5990,
        "sale_price": null
      },
      {
        "seller_sku": "SKU-002",
        "country": "RU",
        "price": 7990,
        "sale_price": 5990,
        "sale_start": "2025-12-01",
        "sale_end": "2025-12-31"
      }
    ]
  }
}

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

Используйте batch-метод set-prices для массовых обновлений — это снижает нагрузку на API и ускоряет обработку.

FBO: Обновление цены

POST v1.nomenclature.update-price

{
  "jsonrpc": "2.0",
  "id": "...",
  "method": "v1.nomenclature.update-price",
  "params": {
    "lamoda_parent_sku": "MP002XM0ABCD",
    "country": "RU",
    "price": 5990,
    "force": false
  }
}

FBO использует lamoda_parent_sku

Не seller_sku! Получите lamoda_parent_sku из ответа на /v1/nomenclatures.list.

Альтернатива: B2B Platform API

Для FBO также доступен REST-метод:

PUT /api/v1/nomenclature/{sku}/country/{country}/price

{
  "price": 5990,
  "salePrice": 4990,
  "saleStart": "2025-12-01",
  "saleEnd": "2025-12-31"
}

Правила валидации цен

Правило	Ограничение	Что будет при нарушении
Кратность	Цена кратна 10 рублям	Ошибка валидации
Скидка	От 5% до 80%	Ошибка валидации
Снижение >70%	Требуется подтверждение	Карантин или `force: true`
sale_price	Должен быть меньше price	Ошибка валидации

Карантин цен

При резком снижении цены (>70%) она попадает в карантин и требует подтверждения:

Через ЛК: Раздел "Цены" → "На модерации" → Подтвердить
Через API: Передать "force": true

Подробнее в разделе Карантин цен.

Цены для Беларуси и Казахстана

Для стран СНГ используйте соответствующий код:

Страна	Код	Валюта
Россия	`RU`	RUB
Беларусь	`BY`	BYN
Казахстан	`KZ`	KZT

Цены устанавливаются отдельно для каждой страны.

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

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "success": true,
    "seller_sku": "MYPRODUCT-001-S",
    "status": "applied"
  }
}

Статусы

Статус	Описание
`applied`	Цена применена
`quarantine`	В карантине, требует подтверждения
`rejected`	Отклонена (нарушены правила)

Частые ошибки

Ошибка	Причина	Решение
50400 "Партнер не найден"	Неверный метод для модели	FBS → set-price, FBO → update-price
Цена не кратна 10	Неправильное значение	1990 , 1995
Скидка вне диапазона	Скидка < 5% или > 80%	Пересчитайте sale_price
SKU не найден	Неверный идентификатор	Проверьте seller_sku / lamoda_parent_sku

См. также

Помогла эта информация?

Да Нет

Спасибо за отзыв

0/1000 Отправить