Быстрый старт работы с API

Новость на модерации

Обновлено

18.12.2025

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

Пошаговый чек-лист интеграции — от получения доступов до обработки первого заказа.

Ключевые факты перед началом:

Один набор credentials для обоих API (Seller и B2B)
TTL токена = 15 минут для обоих API
Demo-стенда нет — тестируйте на Production с тестовыми данными
Используйте Postman-коллекции для быстрого старта

Чек-лист интеграции

1 Получение доступов

Что получить	От кого	Для чего
`client_id`	Менеджер Lamoda (KAM)	Авторизация в API
`client_secret`	Менеджер Lamoda (KAM)	Авторизация в API
`partner_id`	Менеджер Lamoda (KAM)	Идентификация в запросах

Подсказка: Одни и те же credentials работают для Seller API и B2B Platform API.

2 Проверка авторизации

Убедитесь, что можете получить токен:

curl -X POST https://public-api-seller.lamoda.ru/jsonrpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "test-auth",
    "method": "v1.tokens.create",
    "params": {
      "client_id": "YOUR_CLIENT_ID",
      "client_secret": "YOUR_CLIENT_SECRET",
      "grant_type": "client_credentials"
    }
}'

Ожидаемый ответ:

{
  "jsonrpc": "2.0",
  "id": "test-auth",
  "result": {
    "access_token": "eyJhbGciOiJIUzI1NiIs...",
    "token_type": "bearer",
    "expires_in": 900
  }
}

TTL = 15 минут!
expires_in: 900 = 900 секунд = 15 минут.
Реализуйте автоматическое обновление токена! Ошибка 50400 "Партнер не найден"?
Проверьте client_id и client_secret. Подробнее: Коды ошибок

3 Загрузка товаров Seller API

Действие	Метод
Создать товары	`v1.nomenclatures.store`
Загрузить изображения	`v1.nomenclature-images.update`
Установить цены	`v1.nomenclature.set-price`
Обновить остатки	`v1.stock.update`

Валидация цен для России:

Цена должна быть кратна 10 (без копеек)
Скидка: от 5% до 80%
При снижении цены >70% — попадает в карантин

4 Получение заказов B2B API

curl -X GET "https://api-b2b.lamoda.ru/api/v1/orders?status=confirmed" \
-H "Authorization: Bearer YOUR_TOKEN"

Статус confirmed — заказ подтверждён и готов к сборке.

5 Сборка и отгрузка B2B API

Шаг	Метод
1. Подтвердить сборку	`PUT /api/v1/orders/{orderNr}/collected`
2. Сгенерировать pack numbers	`POST /api/v1/orders/{orderNr}/pack-numbers`
3. Получить этикетки	`POST /api/v1/label/packs`
4. Создать отгрузку	`POST /api/v1/shipments/out`

warehouse_code обязателен!
При создании отгрузки указывайте warehouse_code.

Endpoints

API	Endpoint	Назначение
Seller	`https://public-api-seller.lamoda.ru/jsonrpc`	Товары, цены, остатки
B2B	`https://api-b2b.lamoda.ru`	Заказы, отгрузки, нотификации

Postman-коллекции

Для быстрого старта используйте готовые коллекции:

Lamoda Seller API Postman
Lamoda B2B Platform API Postman

Готово! После прохождения всех шагов вы готовы к работе с Lamoda API.

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

Ошибка	Причина	Решение
`50400` "Партнер не найден"	Неверные credentials	Проверить client_id/secret
`50401` Unauthorized	Токен истёк (TTL 15 мин)	Запросить новый токен
"Цена должна быть кратна 10"	Указана цена 1995 вместо 1990	Округлить до десятков
Цена в карантине	Снижение >70%	Подтвердить в ЛК seller.lamoda.ru

Следующие шаги

Помогла эта информация?

Да Нет

Спасибо за отзыв

Отправить

Получение списка товаров

Быстрый спорт в работе с API