Обновление товаров

Обновление информации о товарах выполняется через Seller API (JSON-RPC). Вы можете обновлять атрибуты товара, добавлять новые размеры и изменять статус активности.

Метод обновления товара

Универсальный метод для создания и обновления товаров. Для обновления используется параметр "type": "update".

Процесс обновления

Шаг 1: Получите текущие данные товара

Сначала получите информацию о товаре для корректного обновления:

{
  "jsonrpc": "2.0",
  "id": "unique-request-id",
  "method": "v1.attributes.sku.list",
  "params": {
    "filter": {
      "lamoda_sku": ["XD001XW03JMM"]
    }
  }
}

Шаг 2: Отправьте запрос на обновление

{
  "jsonrpc": "2.0",
  "id": "unique-request-id",
  "method": "v1.nomenclatures.store",
  "params": {
    "seller_id": 12345,
    "type": "update",
    "nomenclatures": [
      {
        "erp_category": "footwear_sneakers",
        "product": {
          "supplier_parent_sku": "SELLER-PARENT-001",
          "brand": "Nike",
          "title": "Кроссовки Air Max — обновлённое название",
          "description": "Обновлённое описание товара...",
          "color": "Чёрный",
          "material_upper": "Текстиль"
        },
        "variations": [
          {
            "sku": "SELLER-SKU-001-42",
            "ean": "4600000000001",
            "size": "42"
          }
        ]
      }
    ]
  }
}

Обязательные поля для обновления

Добавление нового размера

Для добавления нового размера к существующему товару отправьте запрос с новой вариацией:

{
  "jsonrpc": "2.0",
  "id": "unique-request-id",
  "method": "v1.nomenclatures.store",
  "params": {
    "seller_id": 12345,
    "type": "update",
    "nomenclatures": [
      {
        "erp_category": "footwear_sneakers",
        "product": {
          "supplier_parent_sku": "SELLER-PARENT-001",
          "brand": "Nike"
        },
        "variations": [
          {
            "sku": "SELLER-SKU-001-44",
            "ean": "4600000000003",
            "size": "44"
          }
        ]
      }
    ]
  }
}

Совет: При добавлении размера указывайте только обязательные атрибуты продукта и новые вариации. Существующие размеры указывать не нужно.

Обновление статуса активности

Управляет видимостью товара на сайте (активен/неактивен).

{
  "jsonrpc": "2.0",
  "id": "unique-request-id",
  "method": "v1.nomenclatures.update-activation",
  "params": {
    "filter": {
      "key": "lamodaSku",
      "values": ["XD001XW03JMM"]
    },
    "is_active": false,
    "country": "RU"
  }
}

Параметры

Обновление изображений

{
  "jsonrpc": "2.0",
  "id": "unique-request-id",
  "method": "v1.nomenclature-images.update",
  "params": {
    "lamoda_sku": "XD001XW03JMM",
    "images": [
      {
        "url": "https://example.com/images/product1_main.jpg",
        "type": "main"
      },
      {
        "url": "https://example.com/images/product1_additional.jpg",
        "type": "additional"
      }
    ]
  }
}

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

Ошибка: "Approved moderation task not found"

Причина: В атрибуте sku указаны некорректные данные. При создании товара это поле должно содержать Lamoda SKU, а не seller SKU.

Решение: Для новых товаров не заполняйте поле sku в variation_attributes. Для обновления существующих — используйте Lamoda SKU из ответа v1.nomenclatures.list.

Ошибка: "SKU already applied to another product"

Причина: Попытка использовать один supplier_parent_sku для товаров разных цветов.

Решение: Один SKU = одна цветомодель товара. Товары разных цветов должны иметь разные supplier_parent_sku.

Ошибка: неправильный метод обновления цен

Методы цен различаются для FBS и FBO:

• v1.nomenclature.set-price — для FBS
• v1.nomenclature.update-price — для FBO

Правила обновления

1. Один SKU — одна цветомодель: Товары разных цветов одной модели — это разные SKU
2. Сохраняйте parent SKU: Используйте тот же supplier_parent_sku, что и при создании
3. Обязательные атрибуты: При обновлении указывайте все обязательные атрибуты категории
4. Модерация: Изменения некоторых атрибутов могут запускать модерацию

Пример полного запроса обновления

curl -X POST "https://public-api-seller.lamoda.ru/jsonrpc/jsonrpc" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "update-product-001",
    "method": "v1.nomenclatures.store",
    "params": {
      "seller_id": 12345,
      "type": "update",
      "nomenclatures": [
        {
          "erp_category": "footwear_sneakers",
          "product": {
            "supplier_parent_sku": "SELLER-PARENT-001",
            "brand": "Nike",
            "title": "Кроссовки Air Max 90",
            "description": "Легендарные кроссовки с воздушной подушкой Air Max.",
            "color": "Белый",
            "gender": "Мужской",
            "season": "Круглогодичный",
            "material_upper": "Кожа натуральная",
            "material_lining": "Текстиль",
            "material_sole": "Резина"
          },
          "variations": [
            {
              "sku": "SELLER-SKU-001-42",
              "ean": "4600000000001",
              "size": "42",
              "size_supplier": "42 EU"
            },
            {
              "sku": "SELLER-SKU-001-43",
              "ean": "4600000000002",
              "size": "43",
              "size_supplier": "43 EU"
            }
          ]
        }
      ]
    }
  }'

Ответ при успешном обновлении

{
  "jsonrpc": "2.0",
  "id": "update-product-001",
  "result": {
    "success": true,
    "nomenclatures": [
      {
        "lamoda_parent_sku": "XD001XW03JMM",
        "supplier_parent_sku": "SELLER-PARENT-001",
        "variations": [
          {
            "lamoda_sku": "XD001XW03JMMS42",
            "seller_sku": "SELLER-SKU-001-42",
            "status": "updated"
          },
          {
            "lamoda_sku": "XD001XW03JMMS43",
            "seller_sku": "SELLER-SKU-001-43",
            "status": "updated"
          }
        ]
      }
    ]
  }
}

См. также

• Создание товаров
• Получение товаров
• Обновление цен
• Справочники атрибутов