Перейти к основному содержимому

Endpoints API товаров (Products/Nomenclatures)

Дата: 2025-02-10 Подзадача: 2-6 - Document all Products API endpoints Статус: ✅ ЗАВЕРШЕНО

Обзор​

Lamoda предоставляет 24 endpoint/method для управления товарами (номенклатурой) через 3 API-системы:

  • B2B Platform API: 9 endpoints (REST) - управление номенклатурой, товарами, ценами
  • Seller JSON-RPC API: 14 methods (JSON-RPC) - полный CRUD для товаров, цены, изображения, атрибуты
  • Seller REST API: 1 endpoint - возвраты с информацией о товарах

Все endpoints поддерживают операции создания, чтения, обновления и удаления товаров, управления ценами, остатками, изображениями и атрибутами.

1. B2B Platform API - Номенклатура и товары​

Base URL: https://api-b2b.lamoda.ru API Format: REST (OpenAPI 3.0.0) Authentication: OAuth2 Bearer Token Total Endpoints: 9

1.1 Список номенклатуры​

Method: GET Path: /api/v1/nomenclatures Operation ID: get_v1_nomenclatures Tags: Номенклатуры

Описание: Получение списка всей номенклатуры с постраничной навигацией.

Параметры запроса:

  • Query parameters:
    • limit (integer, optional): Количество элементов на странице (по умолчанию 25, больше 0)
    • page (integer, optional): Номер запрашиваемой страницы (по умолчанию 1, больше 0)

Ответы:

  • 200 OK: Список номенклатуры получен 
    {
      "page": 1,
      "limit": 25,
      "pages": 10,
      "total": 250,
      "_links": {
        "self": "href",
        "first": "href",
        "last": "href",
        "next": "href",
        "prev": "href"
      },
      "_embedded": {
        "nomenclatures": [...]
      }
    }
  • 400 Bad Request: Неверный параметр
  • 401 Unauthorized: Отказ в доступе
  • 403 Forbidden: Доступ запрещен
  • 500 Internal Server Error: Внутренняя ошибка сервера

Пример запроса:

curl -X GET 'https://api-b2b.lamoda.ru/api/v1/nomenclatures?page=1&limit=25' \
  -H 'Authorization: Bearer YOUR_TOKEN'

1.2 Создание номенклатуры​

Method: POST Path: /api/v1/nomenclatures Operation ID: post_v1_nomenclatures Tags: Номенклатуры

Описание: Создание новой номенклатуры (товара) в системе Lamoda.

Параметры запроса:

  • Body: Схема создания номенклатуры 
    {
      "sku": "string",
      "brandId": "string",
      "categoryId": "string",
      "name": "string",
      "description": "string",
      "attributes": {...},
      "barcodes": ["string"]
    }

Ответы:

  • 201 Created: Номенклатура создана
  • 400 Bad Request: Неверный параметр
  • 401 Unauthorized: Отказ в доступе
  • 403 Forbidden: Доступ запрещен
  • 500 Internal Server Error: Внутренняя ошибка сервера

Пример запроса:

curl -X POST 'https://api-b2b.lamoda.ru/api/v1/nomenclatures' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "sku": "ART12345",
    "brandId": "BRAND001",
    "categoryId": "CAT001",
    "name": "Товар"
  }'

1.3 Обновление номенклатуры​

Method: PATCH Path: /api/v1/nomenclatures/{sku} Operation ID: patch_v1_nomenclatures Tags: Номенклатуры

Описание: Частичное обновление номенклатуры по артикулу (SKU).

Параметры запроса:

  • Path parameters:
    • sku (string, required): Артикул поставщика (длинный или короткий)
  • Body: Схема обновления номенклатуры (частичные изменения)

Ответы:

  • 200 OK: Номенклатура обновлена
  • 400 Bad Request: Неверный параметр
  • 401 Unauthorized: Отказ в доступе
  • 403 Forbidden: Доступ запрещен
  • 404 Not Found: Номенклатура не найдена
  • 500 Internal Server Error: Внутренняя ошибка сервера

Пример запроса:

curl -X PATCH 'https://api-b2b.lamoda.ru/api/v1/nomenclatures/ART12345' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Обновленное название"
  }'

1.4 Полное обновление номенклатуры​

Method: PUT Path: /api/v1/nomenclature Operation ID: put_v1_nomenclature Tags: Номенклатуры

Описание: Полное обновление номенклатуры (замена всех полей).

Параметры запроса:

  • Body: Полная схема номенклатуры

Ответы:

  • 200 OK: Номенклатура обновлена
  • 400 Bad Request: Неверный параметр
  • 401 Unauthorized: Отказ в доступе
  • 403 Forbidden: Доступ запрещен
  • 500 Internal Server Error: Внутренняя ошибка сервера

Пример запроса:

curl -X PUT 'https://api-b2b.lamoda.ru/api/v1/nomenclature' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "sku": "ART12345",
    "brandId": "BRAND001",
    ...
  }'

1.5 Список товаров​

Method: GET Path: /api/v1/goods Operation ID: get_v1_goods Tags: Товары

Описание: Получение списка товаров с постраничной навигацией и фильтрацией.

Параметры запроса:

  • Query parameters:
    • limit (integer, optional): Количество элементов на странице (по умолчанию 25)
    • page (integer, optional): Номер страницы (по умолчанию 1)
    • filter (string, optional): Фильтр по номеру паллеты (palletBarcode) или посылки (packBarcode)
      • Пример: packBarcode~=PACKXX951

Ответы:

  • 200 OK: Список товаров получен 
    {
      "page": 1,
      "limit": 25,
      "pages": 1,
      "total": 10,
      "_links": {...},
      "_embedded": {
        "goods": [...]
      }
    }
  • 400 Bad Request: Неверный параметр
  • 401 Unauthorized: Отказ в доступе
  • 500 Internal Server Error: Внутренняя ошибка сервера

Пример запроса:

curl -X GET 'https://api-b2b.lamoda.ru/api/v1/goods?page=1&limit=25' \
  -H 'Authorization: Bearer YOUR_TOKEN'

1.6 Остатки товаров на складе​

Method: GET Path: /api/v1/stock/goods Operation ID: get_v1_stock_goods Tags: Склад

Описание: Получение информации об остатках товаров на складе Lamoda (для FBO модели).

Параметры запроса:

  • Query parameters:
    • limit (integer, optional): Количество элементов на странице
    • page (integer, optional): Номер страницы
    • filter (string, optional): Фильтрация по параметрам

Ответы:

  • 200 OK: Информация об остатках получена 
    {
      "page": 1,
      "limit": 25,
      "pages": 5,
      "total": 120,
      "_embedded": {
        "stock": [
          {
            "sku": "ART12345",
            "quantity": 100,
            "warehouse": "WH001"
          }
        ]
      }
    }

Пример запроса:

curl -X GET 'https://api-b2b.lamoda.ru/api/v1/stock/goods?page=1&limit=25' \
  -H 'Authorization: Bearer YOUR_TOKEN'

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

Method: POST Path: /api/v1/stock/goods Operation ID: post_v1_stock_goods Tags: Склад

Описание: Обновление остатков товаров на складе (используется для синхронизации запасов).

Параметры запроса:

  • Body: Схема обновления остатков 
    {
      "stock": [
        {
          "sku": "ART12345",
          "quantity": 50
        }
      ]
    }

Ответы:

  • 200 OK: Остатки обновлены
  • 400 Bad Request: Неверный параметр
  • 401 Unauthorized: Отказ в доступе
  • 500 Internal Server Error: Внутренняя ошибка сервера

Пример запроса:

curl -X POST 'https://api-b2b.lamoda.ru/api/v1/stock/goods' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "stock": [
      {"sku": "ART12345", "quantity": 50}
    ]
  }'

1.8 Настройки цен и ограничений​

Method: GET Path: /api/v1/nomenclature/sell-values Operation ID: get_v1_nomenclature_sell_values Tags: Цены и ограничения

Описание: Получение списка настроек цен и ограничений для продажи товаров в странах СНГ (включая Россию).

Параметры запроса:

  • Query parameters:
    • limit (integer, optional): Количество значений на странице
    • page (integer, optional): Номер страницы
    • filter (string, optional): Фильтрация

Ответы:

  • 200 OK: Список настроек получен 
    {
      "limit": 15,
      "page": 1,
      "pages": 1,
      "total": 3,
      "_embedded": {
        "prices_restrictions": [...]
      }
    }

Пример запроса:

curl -X GET 'https://api-b2b.lamoda.ru/api/v1/nomenclature/sell-values?page=1&limit=15' \
  -H 'Authorization: Bearer YOUR_TOKEN'

1.9 Обновление цены товара для страны​

Method: PUT Path: /api/v1/nomenclature/{sku}/country/{country}/price Operation ID: put_v1_nomenclature_price Tags: Цены и ограничения

Описание: Обновление цены товара для конкретной страны СНГ (кроме России).

Параметры запроса:

  • Path parameters:
    • sku (string, required): Артикул поставщика (длинный или короткий)
    • country (string, required): Код страны (BY, KZ)
  • Body: Схема обновления цены 
    {
      "price": 1500.00,
      "discountPrice": 1200.00
    }

Ответы:

  • 200 OK: Цена обновлена
  • 400 Bad Request: Неверный параметр
  • 401 Unauthorized: Отказ в доступе
  • 403 Forbidden: Доступ запрещен
  • 500 Internal Server Error: Внутренняя ошибка сервера

Пример запроса:

curl -X PUT 'https://api-b2b.lamoda.ru/api/v1/nomenclature/ART12345/country/BY/price' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "price": 1500.00
  }'

1.10 Упаковка номенклатуры​

Method: POST Path: /api/v1/brand-packing/pack-nomenclature Operation ID: post_v1_brand_packing_pack_nomenclature Tags: Упаковка

Описание: Создание упаковки для номенклатуры с фирменными материалами Lamoda.

Параметры запроса:

  • Body: Схема упаковки номенклатуры

Ответы:

  • 200 OK: Упаковка создана
  • 400 Bad Request: Неверный параметр
  • 401 Unauthorized: Отказ в доступе
  • 500 Internal Server Error: Внутренняя ошибка сервера

Пример запроса:

curl -X POST 'https://api-b2b.lamoda.ru/api/v1/brand-packing/pack-nomenclature' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "sku": "ART12345",
    "quantity": 10
  }'

2. Seller JSON-RPC API - Номенклатура​

Base URL: https://public-api-seller.lamoda.ru/jsonrpc API Format: JSON-RPC 2.0 Authentication: OAuth2 Bearer Token Total Methods: 14

2.1 Список номенклатуры​

Method: JSON-RPC Method Name: v1.nomenclatures.list Tags: Номенклатура

Описание: Получение полного списка номенклатуры с постраничной навигацией и фильтрацией.

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclatures.list",
  "params": {
    "page": 1,
    "limit": 100,
    "filter": {
      "status": "active",
      "category": "CAT001"
    }
  },
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "page": 1,
    "limit": 100,
    "pages": 10,
    "total": 1000,
    "items": [
      {
        "sku": "ART12345",
        "name": "Товар",
        "status": "active",
        "price": 1500.00,
        "category": "CAT001"
      }
    ]
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.nomenclatures.list",
    "params": {"page": 1, "limit": 100},
    "id": 1
  }'

2.2 Альтернативный список товаров​

Method: JSON-RPC Method Name: v1.nomenclature.list Tags: Номенклатура

Описание: Альтернативный метод для получения списка товаров (похож на v1.nomenclatures.list).

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclature.list",
  "params": {
    "page": 1,
    "limit": 50
  },
  "id": 1
}

Ответ: Структура аналогична v1.nomenclatures.list

2.3 Создание и обновление товаров​

Method: JSON-RPC Method Name: v1.nomenclatures.store Tags: Номенклатура

Описание: Создание новых товаров или обновление существующих (upsert операция).

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclatures.store",
  "params": {
    "nomenclatures": [
      {
        "sku": "ART12345",
        "brandId": "BRAND001",
        "categoryId": "CAT001",
        "name": "Название товара",
        "description": "Описание",
        "attributes": {
          "color": "черный",
          "size": "M",
          "material": "хлопок 100%"
        },
        "barcodes": ["1234567890123"],
        "images": ["url1", "url2"]
      }
    ]
  },
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "created": 10,
    "updated": 5,
    "errors": []
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.nomenclatures.store",
    "params": {
      "nomenclatures": [
        {
          "sku": "ART12345",
          "name": "Товар"
        }
      ]
    },
    "id": 1
  }'

2.4 Обновление активности товаров​

Method: JSON-RPC Method Name: v1.nomenclatures.update-activation Tags: Номенклатура

Описание: Активация или деактивация товаров (включение/выключение продаж).

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclatures.update-activation",
  "params": {
    "nomenclatures": [
      {
        "sku": "ART12345",
        "active": true
      },
      {
        "sku": "ART12346",
        "active": false
      }
    ]
  },
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "updated": 2,
    "errors": []
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.nomenclatures.update-activation",
    "params": {
      "nomenclatures": [
        {"sku": "ART12345", "active": true}
      ]
    },
    "id": 1
  }'

2.5 Установка цен для нескольких товаров​

Method: JSON-RPC Method Name: v1.nomenclatures.set-prices Tags: Цены

Описание: Массовое обновление цен для нескольких товаров за один запрос.

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclatures.set-prices",
  "params": {
    "prices": [
      {
        "sku": "ART12345",
        "price": 1500.00,
        "discountPrice": 1200.00
      },
      {
        "sku": "ART12346",
        "price": 2000.00
      }
    ]
  },
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "updated": 2,
    "errors": []
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.nomenclatures.set-prices",
    "params": {
      "prices": [
        {"sku": "ART12345", "price": 1500.00}
      ]
    },
    "id": 1
  }'

2.6 Установка цены для товара​

Method: JSON-RPC Method Name: v1.nomenclature.set-price Tags: Цены

Описание: Установка или обновление цены для конкретного товара.

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclature.set-price",
  "params": {
    "sku": "ART12345",
    "price": 1500.00,
    "discountPrice": 1200.00
  },
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "sku": "ART12345",
    "price": 1500.00,
    "discountPrice": 1200.00,
    "updatedAt": "2025-02-10T12:00:00Z"
  },
  "id": 1
}

2.7 Обновление цены товара​

Method: JSON-RPC Method Name: v1.nomenclature.update-price Tags: Цены

Описание: Обновление цены товара (частичное обновление, аналогично set-price).

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclature.update-price",
  "params": {
    "sku": "ART12345",
    "price": 1600.00
  },
  "id": 1
}

Ответ: Аналогичен v1.nomenclature.set-price

2.8 Получение категорий Axapta​

Method: JSON-RPC Method Name: v1.nomenclatures-metadata.get-axapta-categories Tags: Метаданные

Описание: Получение списка категорий из системы Axapta (ERP-система Lamoda).

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclatures-metadata.get-axapta-categories",
  "params": {},
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "categories": [
      {
        "id": "CAT001",
        "name": "Одежда",
        "parent": null,
        "level": 1
      },
      {
        "id": "CAT002",
        "name": "Футболки",
        "parent": "CAT001",
        "level": 2
      }
    ]
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.nomenclatures-metadata.get-axapta-categories",
    "params": {},
    "id": 1
  }'

2.9 Получение списка брендов​

Method: JSON-RPC Method Name: v1.nomenclatures-metadata.get-brands Tags: Метаданные

Описание: Получение списка всех брендов, доступных в системе Lamoda.

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclatures-metadata.get-brands",
  "params": {},
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "brands": [
      {
        "id": "BRAND001",
        "name": "Lamoda Brand",
        "country": "Russia"
      }
    ]
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.nomenclatures-metadata.get-brands",
    "params": {},
    "id": 1
  }'

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

Method: JSON-RPC Method Name: v1.nomenclature-images.update Tags: Изображения

Описание: Загрузка или обновление изображений для товаров. Поддерживает загрузку через Base64.

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.nomenclature-images.update",
  "params": {
    "images": [
      {
        "sku": "ART12345",
        "images": [
          {
            "type": "main",
            "url": "https://example.com/image1.jpg",
            "base64": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
          },
          {
            "type": "additional",
            "url": "https://example.com/image2.jpg"
          }
        ]
      }
    ]
  },
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "updated": 1,
    "images": [
      {
        "sku": "ART12345",
        "count": 2,
        "urls": [
          "https://lamoda.ru/img/ART12345_1.jpg",
          "https://lamoda.ru/img/ART12345_2.jpg"
        ]
      }
    ],
    "errors": []
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.nomenclature-images.update",
    "params": {
      "images": [
        {
          "sku": "ART12345",
          "images": [
            {"type": "main", "url": "https://example.com/image1.jpg"}
          ]
        }
      ]
    },
    "id": 1
  }'

2.11 Получение остатков на складе​

Method: JSON-RPC Method Name: v1.stock.list Tags: Остатки

Описание: Получение информации об остатках товаров на складах Lamoda.

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.stock.list",
  "params": {
    "page": 1,
    "limit": 100,
    "filter": {
      "warehouse": "WH001"
    }
  },
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "page": 1,
    "limit": 100,
    "total": 500,
    "items": [
      {
        "sku": "ART12345",
        "warehouse": "WH001",
        "quantity": 100,
        "reserved": 10,
        "available": 90
      }
    ]
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.stock.list",
    "params": {"page": 1, "limit": 100},
    "id": 1
  }'

2.12 Список складов FBO​

Method: JSON-RPC Method Name: v1.fbo.warehouse.list Tags: Склады FBO

Описание: Получение списка складов Lamoda для модели FBO (Fulfillment by Operator).

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.fbo.warehouse.list",
  "params": {},
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "warehouses": [
      {
        "id": "WH001",
        "name": "Склад Москва",
        "address": "г. Москва, ул. Примерная, д. 1",
        "type": "FBO"
      },
      {
        "id": "WH002",
        "name": "Склад Санкт-Петербург",
        "address": "г. Санкт-Петербург, ул. Примерная, д. 2",
        "type": "FBO"
      }
    ]
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.fbo.warehouse.list",
    "params": {},
    "id": 1
  }'

2.13 Список атрибутов для SKU​

Method: JSON-RPC Method Name: v1.attributes.sku.list Tags: Атрибуты

Описание: Получение списка атрибутов для конкретного SKU (цвет, размер, материал и т.д.).

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.attributes.sku.list",
  "params": {
    "sku": "ART12345"
  },
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "sku": "ART12345",
    "attributes": [
      {
        "code": "color",
        "name": "Цвет",
        "value": "черный",
        "required": true
      },
      {
        "code": "size",
        "name": "Размер",
        "value": "M",
        "required": true
      },
      {
        "code": "material",
        "name": "Материал",
        "value": "хлопок 100%",
        "required": false
      }
    ]
  },
  "id": 1
}

Пример запроса:

curl -X POST 'https://public-api-seller.lamoda.ru/jsonrpc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "v1.attributes.sku.list",
    "params": {"sku": "ART12345"},
    "id": 1
  }'

2.14 Список категорий ERP​

Method: JSON-RPC Method Name: v1.erp-categories.list Tags: Категории

Описание: Получение списка категорий из ERP-системы для классификации товаров.

Параметры запроса:

{
  "jsonrpc": "2.0",
  "method": "v1.erp-categories.list",
  "params": {},
  "id": 1
}

Ответ:

{
  "jsonrpc": "2.0",
  "result": {
    "categories": [
      {
        "id": "ERP001",
        "name": "Одежда",
        "parentId": null,
        "hasChildren": true
      }
    ]
  },
  "id": 1
}

3. Seller REST API - Товары в возвратах​

Base URL: https://public-api-seller.lamoda.ru/api API Format: REST (OpenAPI 3.0.0) Authentication: Bearer Token Total Endpoints: 1 (в контексте возвратов)

3.1 Список возвращенных товаров FBS​

Method: GET Path: /v2/fbs/return-items Tags: Возвраты FBS

Описание: Получение списка товаров, возвращенных покупателями в рамках модели FBS. Включает информацию о товарах в контексте возвратов.

Параметры запроса:

  • Query parameters:
    • limit (integer, optional): Количество элементов на странице
    • page (integer, optional): Номер страницы
    • filter (string, optional): Фильтрация (по статусу, дате и т.д.)

Ответы:

  • 200 OK: Список возвращенных товаров получен 
    {
      "page": 1,
      "limit": 25,
      "total": 100,
      "items": [
        {
          "itemId": "RET001",
          "sku": "ART12345",
          "productName": "Товар",
          "quantity": 1,
          "reason": "Возврат",
          "status": "received",
          "returnDate": "2025-02-10"
        }
      ]
    }
  • 400 Bad Request: Неверный параметр
  • 401 Unauthorized: Отказ в доступе

Пример запроса:

curl -X GET 'https://public-api-seller.lamoda.ru/api/v2/fbs/return-items?page=1&limit=25' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Сводная таблица всех endpoints​

API SystemEndpoint/MethodMethodDescriptionИспользуется для
B2B Platform API/api/v1/nomenclaturesGETПолучение списка номенклатурыВсе модели
B2B Platform API/api/v1/nomenclaturesPOSTСоздание номенклатурыВсе модели
B2B Platform API/api/v1/nomenclatures/{sku}PATCHОбновление номенклатурыВсе модели
B2B Platform API/api/v1/nomenclaturePUTПолное обновление номенклатурыВсе модели
B2B Platform API/api/v1/goodsGETСписок товаровВсе модели
B2B Platform API/api/v1/stock/goodsGETОстатки на складеFBO, B2B FF
B2B Platform API/api/v1/stock/goodsPOSTОбновление остатковFBO, B2B FF
B2B Platform API/api/v1/nomenclature/sell-valuesGETНастройки цен и ограниченийВсе модели
B2B Platform API/api/v1/nomenclature/{sku}/country/{country}/pricePUTОбновление цены для страныВсе модели
B2B Platform API/api/v1/brand-packing/pack-nomenclaturePOSTУпаковка номенклатурыВсе модели
JSON-RPC APIv1.nomenclatures.listJSON-RPCСписок номенклатурыВсе модели
JSON-RPC APIv1.nomenclature.listJSON-RPCАльтернативный список товаровВсе модели
JSON-RPC APIv1.nomenclatures.storeJSON-RPCСоздание/обновление товаровВсе модели
JSON-RPC APIv1.nomenclatures.update-activationJSON-RPCОбновление активностиВсе модели
JSON-RPC APIv1.nomenclatures.set-pricesJSON-RPCМассовое обновление ценВсе модели
JSON-RPC APIv1.nomenclature.set-priceJSON-RPCУстановка ценыВсе модели
JSON-RPC APIv1.nomenclature.update-priceJSON-RPCОбновление ценыВсе модели
JSON-RPC APIv1.nomenclatures-metadata.get-axapta-categoriesJSON-RPCКатегории AxaptaВсе модели
JSON-RPC APIv1.nomenclatures-metadata.get-brandsJSON-RPCСписок брендовВсе модели
JSON-RPC APIv1.nomenclature-images.updateJSON-RPCОбновление изображенийВсе модели
JSON-RPC APIv1.stock.listJSON-RPCОстатки на складеВсе модели
JSON-RPC APIv1.fbo.warehouse.listJSON-RPCСписок складов FBOFBO, B2B FF
JSON-RPC APIv1.attributes.sku.listJSON-RPCАтрибуты SKUВсе модели
JSON-RPC APIv1.erp-categories.listJSON-RPCКатегории ERPВсе модели
REST API/v2/fbs/return-itemsGETВозвращенные товарыFBS

Всего: 24 endpoints/methods

Статусы товаров​

СтатусОписание
activeТовар активен и доступен для продажи
inactiveТовар неактивен, недоступен для продажи
draftЧерновик, товар не опубликован
deletedТовар удален

Операторы фильтрации​

При использовании параметра filter в запросах поддерживаются следующие операторы:

ОператорОписаниеПример
~=Содержитfilter=name~=Товар
=Равноfilter=status=active
!=Не равноfilter=status!=deleted
>Большеfilter=price>1000
<Меньшеfilter=price<5000
>=Больше или равноfilter=quantity>=10
<=Меньше или равноfilter=quantity<=100

Типы атрибутов товаров​

Код атрибутаНазваниеОбязательныйПример значения
colorЦветДачерный
sizeРазмерДаM, L, XL
materialМатериалНетхлопок 100%
brandБрендДаLamoda Brand
countryСтрана производстваНетРоссия
seasonСезонНетлето
genderПолДаженский, мужской, унисекс

Примечания по использованию​

Аутентификация​

  • B2B Platform API: OAuth2 токен (24 часа), получить через /auth/token
  • JSON-RPC API: OAuth2 токен (15 минут), получить через v1.tokens.create
  • REST API: Bearer токен (15 минут), получить через v1.tokens.create

Rate Limiting​

  • Лимиты официально не задокументированы
  • Рекомендуется не более 10 запросов в секунду
  • Используйте экспоненциальную паузу при получении ошибок

Пагинация​

  • B2B Platform API: Параметры page и limit, по умолчанию limit=25
  • JSON-RPC API: Параметры page и limit в params, максимальный limit=100

Фильтрация​

  • Используйте параметр filter с операторами (см. таблицу выше)
  • Для JSON-RPC фильтры передаются в объекте params.filter

Лучшие практики​

  1. Используйте v1.nomenclatures.store для массового создания/обновления товаров
  2. Кэшируйте справочники (бренды, категории) для снижения нагрузки
  3. Обновляйте остатки регулярно (каждые 15-30 минут для FBO)
  4. Используйте массовые операции для обновления цен (v1.nomenclatures.set-prices)
  5. Загружайте изображения через Base64 или URL в v1.nomenclature-images.update

Примеры интеграционных сценариев​

Сценарий 1: Создание нового товара​

  1. Получить список брендов: v1.nomenclatures-metadata.get-brands
  2. Получить категории: v1.nomenclatures-metadata.get-axapta-categories
  3. Создать товар: v1.nomenclatures.store
  4. Загрузить изображения: v1.nomenclature-images.update
  5. Установить цену: v1.nomenclature.set-price
  6. Активировать товар: v1.nomenclatures.update-activation

Сценарий 2: Массовое обновление цен​

  1. Получить список товаров: v1.nomenclatures.list
  2. Подготовить данные о новых ценах
  3. Массовое обновление: v1.nomenclatures.set-prices

Сценарий 3: Синхронизация остатков (FBO)​

  1. Получить список складов: v1.fbo.warehouse.list
  2. Получить текущие остатки: v1.stock.list
  3. Обновить остатки: POST /api/v1/stock/goods (B2B API)

Дата создания: 2025-02-10 Следующее обновление: После следующих изменений в API

Источник документации:

  • B2B Platform API: /Users/antonnozdrin/Tools/SCRAP/marketplace-api-specs/lamoda/lamoda_b2b_openapi.yaml
  • Seller JSON-RPC API: /Users/antonnozdrin/Tools/SCRAP/marketplace-api-specs/lamoda/lamoda_seller_jsonrpc_api.yaml
  • Seller REST API: /Users/antonnozdrin/Tools/SCRAP/marketplace-api-specs/lamoda/lamoda_seller_rest_api.yaml