Обновлено

20.03.2026

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

Часто задаваемые вопросы

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

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

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

Неверный метод для вашей модели — методы различаются для FBS и FBO:
- Обновление цен FBS: POST /jsonrpc/v1/nomenclature.set-price
- Обновление цен FBO: POST /jsonrpc/v1/nomenclature.update-price
Токен не соответствует партнёру — убедитесь, что используете токен от нужного кабинета
Токен истёк — 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 от Lamoda B2B Platform Partner API к Seller Partner API?

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

Токен получайте через Lamoda B2B Platform Partner 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

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

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

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

Authorization: Bearer YOUR_ACCESS_TOKEN

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

Отсутствие пробела после "Bearer"
Кавычки вокруг токена
Передача токена GET-параметром — вернёт 404, а не 401

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

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

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

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

Частая ошибка: использование update-price для FBS вернёт "Партнер не найден".

Q: Получаю ошибку "Approved moderation task not found". Что это значит?

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

Решение:

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

Получить правильный Lamoda SKU можно через POST /jsonrpc/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 для методов?

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

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

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

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

Lamoda Seller Partner 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: Как разделить заказ на несколько посылок?

Если товары из одного заказа нужно отправить в нескольких коробках, используйте метод pack-numbers:

Шаг 1. Укажите количество грузовых мест:

GET /api/v1/orders/{orderNr}/pack-numbers
{
  "packQuantity": 2
}

Шаг 2. В ответе получите 2 pack number — по одному на каждое грузовое место.

Шаг 3. Скачайте этикетки — для каждого грузового места будет своя паковая этикетка.

Важно: Вызов pack-numbers с новым packQuantity перезаписывает предыдущий результат. Если сначала вызвали с packQuantity: 1, а потом с packQuantity: 2 — предыдущий pack number будет заменён двумя новыми.

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

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

Условия доступности:

FBS: этикетки доступны в статусах Ждёт сборки, Ждёт отгрузки, Отправлен
Перегенерировать этикетку можно через ЛК, пока заказ в нужном статусе
После перехода заказа в терминальный статус этикетки могут стать недоступны

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

Q: Можно ли увеличить размер этикеток?

Да. Lamoda допускает увеличение размера этикеток при условии, что:

Штрих-коды остаются читаемыми
Текст не искажён
Общая структура этикетки сохранена

Рекомендуем протестировать печать и сканирование на первых заказах.

Поставки FBO

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

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

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

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

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

Статус	Описание
`draft`	Черновик
`validation`	Проверка документов
`ready_for_shipment`	Готова к отгрузке
`unloading_needed`	Требуется выгрузка
`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"

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