Управление ценами
Для обновления цен используются разные методы в зависимости от модели работы (FBS или FBO).
Выбор метода
| FBS | FBO | |
| Метод (единичный) |
POST /jsonrpc/v1/nomenclature.set-price
|
POST /jsonrpc/v1/nomenclature.update-price
|
| Метод (пакетный) |
POST /jsonrpc/v1/nomenclatures.set-prices
|
— |
| API | Lamoda Seller Partner API | Lamoda Seller Partner API |
| Идентификатор товара |
lamoda_parent_sku + partner_id
|
seller_sku
|
Частая ошибка: «Партнёр не найден» (50400)
Если вы FBS-продавец и используете update-price — получите эту ошибку. Если вы FBO-продавец и используете set-price — тоже ошибка. Проверьте модель работы и используйте правильный метод.
FBS: Обновление одной цены
POST /jsonrpc/v1/nomenclature.set-price
{
"jsonrpc": "2.0",
"id": "550e8400-e29b-41d4-a716-446655440000",
"method": "v1.nomenclature.set-price",
"params": {
"lamoda_parent_sku": "MP002XM0ABCD",
"partner_id": 12345,
"country": "RU",
"price": 5990,
"sale_price": 4990,
"sale_start_date": "2025-12-01T00:00:00+00:00",
"sale_end_date": "2025-12-31T23:59:59+00:00",
"force": false
}
}
Параметры set-price
| Параметр | Тип | Обязательный | Описание |
lamoda_parent_sku
|
string | Да | Lamoda Parent SKU (без размера) |
partner_id
|
integer | Да | ID партнёра |
country
|
string | Да | Код страны: RU, BY, KZ |
price
|
number | Нет | Базовая цена (кратна 10) |
sale_price
|
number | Нет | Цена по акции |
sale_start_date
|
string | Нет |
Начало акции (формат: YYYY-MM-DDThh:mm:ss.fffZ)
|
sale_end_date
|
string | Нет |
Конец акции (формат: YYYY-MM-DDThh:mm:ss.fffZ)
|
force
|
boolean | Нет | Подтвердить цену, минуя карантин. См. Ценовой карантин |
FBS: Пакетное обновление цен
POST /jsonrpc/v1/nomenclatures.set-prices
{
"jsonrpc": "2.0",
"id": "550e8400-e29b-41d4-a716-446655440000",
"method": "v1.nomenclatures.set-prices",
"params": {
"country": "RU",
"partner_id": 12345,
"prices": [
{
"lamoda_parent_sku": "MP002XM0ABCD",
"price": 5990
},
{
"lamoda_parent_sku": "MP002XM0EFGH",
"price": 7990,
"sale_price": 5990,
"sale_start_date": "2025-12-01T00:00:00+00:00",
"sale_end_date": "2025-12-31T23:59:59+00:00"
}
]
}
}
Параметры set-prices
| Параметр | Тип | Обязательный | Описание |
country
|
string | Да | Код страны: RU, BY, KZ |
partner_id
|
integer | Да | ID партнёра |
prices[]
|
array | Да | Массив цен для обновления |
prices[].lamoda_parent_sku
|
string | Да | Lamoda Parent SKU |
prices[].price
|
number | Нет | Базовая цена |
prices[].sale_price
|
number | Нет | Цена по акции |
prices[].sale_start_date
|
string | Нет | Начало акции (ISO 8601) |
prices[].sale_end_date
|
string | Нет | Конец акции (ISO 8601) |
force
|
boolean | Нет | Подтвердить изменение при ошибке валидации акционных цен |
Рекомендация: Используйте batch-метод set-prices для массовых обновлений — это снижает нагрузку на API и ускоряет обработку. В отличие от единичного set-price, здесь country и partner_id указываются один раз на уровне params, а не в каждом элементе.
FBO: Обновление цены
POST /jsonrpc/v1/nomenclature.update-price
{
"jsonrpc": "2.0",
"id": "550e8400-e29b-41d4-a716-446655440000",
"method": "v1.nomenclature.update-price",
"params": {
"seller_sku": "MYPRODUCT-001-S",
"country": "RU",
"price": 5990,
"sale_price": 4990,
"sale_start_date": "2025-12-01 00:00",
"sale_end_date": "2025-12-31 23:59",
"force": false
}
}
Параметры update-price
| Параметр | Тип | Обязательный | Описание |
seller_sku
|
string | Да | Ваш артикул товара |
country
|
string | Да | Код страны: RU, BY, KZ |
price
|
number | Нет | Базовая цена (кратна 10) |
sale_price
|
number | Нет | Цена по акции |
sale_start_date
|
string | Нет |
Начало акции (формат: YYYY-MM-DD hh:mm)
|
sale_end_date
|
string | Нет |
Конец акции (формат: YYYY-MM-DD hh:mm)
|
force
|
boolean | Нет | Подтвердить цену, минуя карантин. См. Ценовой карантин |
Формат дат различается: set-price / set-prices используют ISO 8601 (YYYY-MM-DDThh:mm:ss.fffZ), а update-price — упрощённый формат (YYYY-MM-DD hh:mm).
Альтернатива: Lamoda B2B Platform Partner API (FBO)
Для FBO также доступен REST-метод:
PUT GET /api/v1/nomenclature/{sku}/country/{country}/price
{
"price": 5990,
"salePrice": 4990,
"saleStart": "2025-12-01",
"saleEnd": "2025-12-31"
}
Установка цены через nomenclatures.store
При создании или обновлении товара через POST /jsonrpc/v1/nomenclatures.store можно передать цены в поле prices. В этом случае вызов set-price произойдёт автоматически.
{
"method": "v1.nomenclatures.store",
"params": {
...
"prices": [
{
"country": "RU",
"price": 18990
}
]
}
}
В ответе вернётся поле price_statuses для каждой страны (может содержать статус QUARANTINE, если цена попала в карантин).
Правила валидации цен
| Правило | Ограничение | Что будет при нарушении |
| Кратность | Цена кратна 10 рублям | Ошибка валидации |
| Скидка | От 5% до 80% | Ошибка валидации |
| Резкое снижение (>70%) | Требуется подтверждение | Цена попадает в карантин |
sale_price
|
Должен быть меньше price
|
Ошибка валидации |
Ценовой карантин
При снижении цены более чем на 70% она автоматически помещается в карантин и не публикуется до ручного подтверждения. Подробнее — в Ценовой карантин.
См. также
- Ценовой карантин — подтверждение и отмена цен в карантине
- Создание товаров
- Получение товаров
- Обновление товаров
- Остатки FBS
- Остатки FBO
Помогла эта информация?
Спасибо за отзыв