У Лемана ПРО есть публичный Marketplace API: через него мерчант отдаёт остатки и цены, забирает заказы и печатает сопроводительные документы. Спецификация лежит на developers.lemanapro.ru и открыта без регистрации, а доступы выдают только по отдельной заявке. Разбираем по официальной документации, что API умеет, чего в нём нет и где интеграция обычно ломается. Полный разбор площадки — в статье «Лемана ПРО для селлеров».
Коротко: API читает и обновляет остатки, принимает цены, ведёт заказы и печатает документы. Карточку через него не создать, текущую цену с витрины он не возвращает, а доступы выдают только по заявке.
Факты сверены 10 августа 2026 года с документацией партнёрского API и договором с мерчантами маркетплейса в редакции от 5 июня 2026 года.
Что API умеет, а что остаётся руками
Marketplace API разбит на пять разделов. Права у них разные, и это важнее списка методов.
| Раздел | Что можно | Чего нет |
|---|---|---|
| Товары | Найти свои товары по ЛМ-кодам, получить основную информацию постранично | Создать или изменить карточку: метод только на чтение |
| Цены | Загрузить продажные цены пачкой | Прочитать текущую цену на витрине: метод только на запись |
| Остатки | Прочитать и обновить остатки по одному складу | Пройтись по всем складам одним запросом |
| Отправления | Получить список и карточку заказа, статусы, грузоместа и данные доставки, перевести по статусной модели, скачать PDF-документы | Передать трек-номер сторонней службы доставки |
| Логистика | Получить список своих логистических локаций | Завести новую локацию |
До старта главное: каталог через API не заводится. Раздел «Товары» — это один поисковый GET-метод. Карточка создаётся на портале поставщика и проходит проверку модератора, а API получает уже готовый ЛМ-код и дальше живёт с ним. Про сам портал — в статье «Портал поставщика Лемана ПРО».
Как получить доступ
Выпустить ключи самостоятельно в кабинете нельзя. Порядок такой:
- Стать мерчантом маркетплейса и подписать договор.
- Обратиться за интеграцией через форму партнёрской поддержки или письмом на service.partner@lemanapro.ru.
- Дождаться одобрения заявки. После него площадка передаёт client_id и client_secret.
- Собрать интеграцию и проверить её на реальных ЛМ-кодах: тестовый контур в документации не описан.
Отдельная ловушка — слово «партнёр». На partners.lemanapro.ru живёт партнёрская программа для вебмастеров: вознаграждение до 6,5% с покупки по реферальной ссылке и бонусная шкала за оборот. К Marketplace API она отношения не имеет, хотя сервер авторизации мерчантов называется похоже — partners.auth.lemanapro.ru. Если вам предлагают «подключить партнёрку», уточните, о чём речь.
Токен живёт пять минут
Авторизация построена на Client Credentials Flow поверх Keycloak. Приложение отправляет POST на partners.auth.lemanapro.ru с grant_type=client_credentials, client_id и client_secret; в ответ приходит JWT.
В ответе два поля, на которые смотрят редко. Поле expires_in равно 300 — это пять минут. Поле refresh_expires_in равно нулю: обновлять токен нечем, каждый раз нужен новый.
Практический вывод: токен надо кэшировать и перевыпускать заранее, а не по ответу 401. Долгая пакетная выгрузка остатков легко начинается с валидным токеном и заканчивается с протухшим.
Остатки: один склад, 500 артикулов и ответ 207
Остатки обновляются отдельно по каждому складу. В теле запроса обязательны два поля. Первое — logisticLocationId, семизначный идентификатор склада мерчанта из диапазона 7000001–7999999. Второе — список артикулов, они же ЛМ-коды, от 1 до 500 позиций.
Считаем нагрузку заранее. Три склада и 4 000 SKU — это 24 запроса на чтение и столько же на запись за одну полную синхронизацию. Список своих складов отдаёт раздел «Логистика», руками его собирать не нужно.
Что сломается, если не заложить это в код
- Токен не перевыпускается заранее — длинная выгрузка обрывается на середине.
- Ответ 207 считается успехом — остатки расходятся с площадкой без единой ошибки в логах.
- В запросе больше 500 артикулов — валидация отклоняет весь пакет.
- Цена ставится и не сверяется — расхождение с витриной обнаружит покупатель.
Отдельная история — ответ 207. Он означает «часть данных обновлена, часть нет». Интеграция, которая считает успехом любой ответ из группы 2xx, будет молча терять остатки по отдельным артикулам. Такой же 207 предусмотрен у загрузки цен. Обрабатывайте его как частичную ошибку и разбирайте тело ответа.
Ответ 403 у остатков тоже говорит не то, что кажется. Это не «нет прав вообще», а «нет доступа к указанному складу или ко всем указанным артикулам».
Цены уходят только в одну сторону
В разделе «Цены» ровно один метод — загрузка продажных цен. Обратного нет: узнать через API, какая цена сейчас стоит на витрине, нельзя. Актуальную цену знает только ваша учётная система.
Это меняет логику репрайсинга. Робот ставит цену, но не может подтвердить, что площадка её приняла и не наложила сверху собственную скидку. Сверку закладывайте в регламент и в кабинет, а не в код.
Заказы: статусная модель и документы
Заказ в API называется отправлением. Идентификатор выглядит как MP0123456-001. Список приходит постранично, до 100 штук за запрос, от новых к старым, с фильтрами по статусу и схеме доставки — DBS или FBS.
Статусы в фильтре: created, canceled, packingStarted, awaitingMarking, refused, packingCompleted, shipped, deliveryStarted, delivered. Перевод по модели разложен на отдельные методы: подтвердить, скомплектовать, отгрузить, доставить, отменить. Отмена требует двух параметров — stage (до подтверждения или после) и reason.
Статус awaitingMarking стоит в списке не для красоты. Метод комплектации вернёт 400 с формулировкой про непромаркированные товары, если коды маркировки не переданы. Для категорий под «Честным знаком» это блокирующая проверка, а не предупреждение.
Документы к отправлению
Сопроводительные документы приходят ссылками на PDF. Типов четыре:
- productList — лист товаров;
- barcodeSticker — штрихкод-стикер;
- acceptanceReport — акт приёма-передачи;
- acceptanceReportBarcodeStickers — акт вместе со стикерами.
Ответ может прийти со статусом IN_PROGRESS: файл ещё готовится, ссылку нужно запросить повторно.
Грузоместа можно делить и обновлять, но только пока отправление не скомплектовано: после комплектации метод вернёт 400. Как это связано со схемами доставки — в статье «Доставка и FBO Лемана ПРО».
Лимиты, о которых узнают на проде
- 100 запросов в минуту по каждому методу, а не на интеграцию целиком. В один поток выгрузка остатков упирается в лимит быстро.
- От 1 до 500 артикулов в одном запросе остатков.
- 300 секунд жизни токена и ноль в refresh_expires_in.
- 207 у цен и остатков — частичный успех, который выглядит как успех.
- Два стиля пагинации в одном API. У отправлений — limit и offset, у товаров и локаций — page и perPage.
Что берёт на себя SelSup
SelSup работает с Лемана ПРО по этому же API. Из коробки SelSup синхронизирует остатки, отправляет цены в Лемана ПРО и обрабатывает DBS-заказы при настроенной интеграции со службами доставки.
Чего нет и почему:
- новые карточки из Лемана ПРО не импортируются, потому что в API нет метода их создания; но если тот же товар уже импортирован с другого маркетплейса, SelSup связывает карточки и присылает заказы на этот товар;
- этикетки и акт приёма-передачи не выгружаются;
- трек-номер по DBS-заказу не передаётся;
- статус отменённого заказа не обновляется: SelSup не видит отмену, сделанную в кабинете площадки;
- текущие цены из Лемана ПРО не читаются, потому что обратного метода нет.
Для подключения понадобятся логин и пароль от кабинета Лемана ПРО, ключ x-api-key от техподдержки площадки и отдельные логин и пароль для остатков — их тоже выдаёт поддержка.
Чек-лист перед подключением
- Договор мерчанта с маркетплейсом подписан, кабинет активен.
- Заявка на интеграцию отправлена, client_id и client_secret получены.
- Артикулы в учётной системе совпадают с ЛМ-кодами площадки.
- Список складов получен, идентификаторы зафиксированы в настройках.
- Обработчик ответов 207 и 429 написан до первого боевого запуска.
- Назначен человек, который сверяет цены глазами, раз API их не отдаёт.
- Решено, где живут карточки: заводит человек на портале, обновляет робот.
Если Лемана ПРО — не единственная ваша площадка, точку сборки лучше держать снаружи: один справочник товаров, одни остатки, одна цена, а маркетплейсы получают из неё то, что умеют принимать. Как это выглядит в SelSup, проще показать на живом кабинете — запишитесь на демонстрацию, покажем на ваших товарах и ответим на вопросы по интеграции.
Частые вопросы
Можно ли создать карточку товара через API Лемана ПРО?
Нет. В разделе «Товары» опубликован единственный метод — поиск товаров по заданным параметрам. Карточки заводятся на портале поставщика и проходят проверку площадки. API работает уже с готовыми ЛМ-кодами.
Сколько стоит доступ к Marketplace API?
Отдельная плата за доступ в документации не указана. Ключи выдают мерчантам маркетплейса после одобрения заявки на интеграцию.
Чем Marketplace API отличается от B2B API Лемана ПРО?
Это два разных контура на одном портале документации. Marketplace API — для мерчантов, которые продают на площадке. B2B API — для корпоративных клиентов, которые у Лемана ПРО закупаются: он отдаёт ассортимент, характеристики и цены, а также позволяет создать заявку. Вопросы по нему идут на отдельный адрес поддержки.
Что делать при ответе 429?
Это превышение лимита в 100 запросов в минуту по конкретному методу. Помогает не повтор сразу же, а очередь с паузой: тяжёлые операции разводите по времени — остатки в одно окно, документы в другое.
Обязательно ли подключать API, чтобы продавать на Лемана ПРО?
Нет, вручную в кабинете работать можно. API окупается там, где счёт идёт на сотни SKU и десятки заказов в день: ручное обновление остатков на таком объёме отстаёт от реальности и приводит к отменам.
Продолжайте читать и смотреть
Новости маркетплейсов, автоматизация и практические разборы ИИ — на удобной для вас площадке.
