FAQ по работе с API

Авторизация и токены

Q: Получаю ошибку 50400 "Партнер не найден". Что делать?

Возможные причины:

1. Неверный метод для вашей модели — методы различаются для FBS и FBO:
   • Обновление цен FBS: v1.nomenclature.set-price
   • Обновление цен FBO: v1.nomenclature.update-price
2. Токен не соответствует партнёру — убедитесь, что используете токен от нужного кабинета
3. Токен истёк — TTL токена составляет 15 минут, обновите его

Проверьте:

# Посмотрите scope в ответе авторизации
{
  "access_token": "...",
  "scope": "partner_client r_orders ...",  // Здесь видны доступные права
  "expires_in": 900
}

Q: Сколько действует токен авторизации?

С 1 сентября 2025 года TTL токена составляет 15 минут (900 секунд).

Рекомендация: Реализуйте автоматическое обновление токена. Кэшируйте токен на expires_in - 60 секунд.

# Пример логики обновления
if token_expires_at < datetime.now() + timedelta(seconds=60):
    token = refresh_token()

Q: Подходят ли credentials от B2B Platform к Seller API?

Да, одни и те же client_id и client_secret работают для обоих API.

Токен получайте через B2B Platform API:

POST https://api-b2b.lamoda.ru/auth/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id=YOUR_ID&client_secret=YOUR_SECRET

Затем используйте этот токен для запросов к Seller API.

Q: Как передавать токен в запросах?

В заголовке Authorization с префиксом Bearer и пробелом:

Authorization: Bearer YOUR_ACCESS_TOKEN

Частая ошибка: отсутствие пробела после "Bearer" или кавычки вокруг токена.

Товары и номенклатура

Q: Какой метод использовать для обновления цен?

Зависит от модели работы:

Модель	Метод
FBS	v1.nomenclature.set-price
FBO	v1.nomenclature.update-price

Частая ошибка: использование update-price для FBS вернёт "Партнер не найден". Q: Получаю ошибку "Approved moderation task not found". Что это значит?

В атрибуте sku указаны некорректные данные.

Решение:

• Для новых товаров: не заполняйте поле sku в variation_attributes
• Для обновления существующих: используйте Lamoda SKU, а не seller SKU

Получить правильный Lamoda SKU можно через v1.nomenclatures.list.

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

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

Правило: Один SKU = одна цветомодель. Товары разных цветов одной модели — это разные SKU.

# Правильно:
supplier_parent_sku: "MODEL-001-BLACK"  # Чёрный цвет
supplier_parent_sku: "MODEL-001-WHITE"  # Белый цвет

# Неправильно:
supplier_parent_sku: "MODEL-001"  # Для всех цветов

Q: Где взять lamoda_parent_sku для методов?

Используйте метод v1.nomenclatures.list:

{
  "jsonrpc": "2.0",
  "id": "...",
  "method": "v1.nomenclatures.list",
  "params": {
    "filter": {
      "seller_sku": ["YOUR-SKU-001"]
    }
  }
}

В ответе найдите поле lamoda_parent_sku.

Q: Как загружать изображения — по ссылке или Base64?

Seller API требует передачи изображений в формате Base64.

{
  "method": "v1.nomenclature-images.update",
  "params": {
    "lamoda_sku": "XD001XW03JMM",
    "images": [
      {
        "type": "main",
        "content": "data:image/jpeg;base64,/9j/4AAQSkZ..."
      }
    ]
  }
}

Совет: Если изображения большие (5-6 МБ), загружайте их по одному, не батчами.

Заказы и отгрузки

Q: Как получить список заказов?

Используйте метод GET /api/v1/orders с фильтрами:

GET /api/v1/orders?status=Confirmed&page=1&limit=25
Authorization: Bearer YOUR_TOKEN

Или подпишитесь на нотификации для получения заказов в реальном времени.

Q: Какие типы нотификаций существуют?

Тип	Описание
statusChanged	Изменение статуса заказа
itemStatusChanged	Изменение статуса товара в заказе
fulfilmentShipmentStatusChanged	Изменение статуса поставки/отгрузки

Q: Срок действия ссылок на этикетки?

Ссылки на этикетки действительны ограниченное время (обычно несколько дней).

Рекомендация: Скачивайте и сохраняйте этикетки сразу после генерации. Не рассчитывайте на то, что ссылка будет работать через неделю.

Поставки FBO

Q: Параметр warehouse_code обязателен?

Да, с 30 сентября 2025 года параметр warehouse_code стал обязательным при создании поставки.

Получите список доступных складов:

{
  "method": "v1.fbo.warehouse.list",
  "params": {}
}

Q: Что означают новые статусы поставки?

Статус	Описание
draft	Черновик
validation	Проверка документов
ready_for_shipment	Готова к отгрузке
unloading	Выгружается
processing	Обработка на складе
closed	Принята (терминальный)
validation_error	Ошибка валидации
rejected	Отменена (терминальный)

Маркировка

Q: Какой формат кода маркировки использовать?

Используйте UIT (нормализованный DataMatrix без криптохвоста):

• UIT без ТН ВЭД: 31 символ
• UIT с ТН ВЭД: 38 символов

# UIT (правильно)
010467003301005321gJk6o54AQBJfX2406401

# Полный DataMatrix (будет нормализован)
010467003301005321gJk6o54AQBJfX\u001d2406401\u001d91ffd0\u001d92...

Q: Ошибка "Datamatrix count mismatch"

Количество кодов маркировки не соответствует количеству товаров (quantity).

Правило: Если quantity: 3, то в datamatrixes должно быть ровно 3 уникальных кода.

Общие ошибки

Q: Ошибка "IN: arguments count must be greater than 0"

Передан пустой массив в параметрах, где ожидается хотя бы один элемент.

Проверьте:

• Массив items не пустой
• Массив SKU или идентификаторов содержит значения

Q: Как узнать о предстоящих изменениях в API?

1. Telegram-канал: @apilamoda — анонсы изменений
2. Seller Academy: раздел "История изменений в API"
3. Email: уведомления от менеджера

Рекомендация: Подпишитесь на Telegram-канал и не мьютите его — изменения публикуются редко, но они критичны для интеграции.

Q: Как тестировать интеграцию?

Используйте Demo-окружение:

• API: https://api-demo-b2b.lamoda.ru
• Личный кабинет: https://demo-b2b.lamoda.ru

Credentials для Demo отличаются от Production — запросите их у менеджера.

Поддержка

Q: Куда обращаться с техническими вопросами?

1. Документация: Seller Academy — academy.lamoda.ru
2. Форма в ЛК: раздел "Поддержка"
3. Telegram-канал: комментарии к постам в @apilamoda
4. Персональный менеджер: для срочных вопросов

При обращении указывайте:

• Метод API и endpoint
• Полный запрос (curl)
• Полный ответ с ошибкой
• Дату и время запроса

См. также

• Коды ошибок
• Авторизация
• Версии API