Зачем продавцу бот для Лемана ПРО
Лемана ПРО (бывший Леруа Мерлен) работает как маркетплейс: сторонние продавцы выставляют товары, обновляют цены и остатки и собирают отправления. Всё это делается в личном кабинете продавца, и на каждое действие уходит время: найти товар по ЛМ-коду, поменять остаток, перевести заказы по статусам, скачать документы.
Задача была дать продавцу помощника в Telegram. Пишешь обычным текстом «поставь остаток 10 по такому-то коду» или «покажи новые отправления», а бот сам выполняет это через партнёрский API маркетплейса.
Подключение к API Лемана ПРО
У маркетплейса есть партнёрский API для продавцов. Авторизация идёт по OAuth 2.0 (Keycloak, client credentials): бот получает токен на сутки и держит его в кеше, чтобы не запрашивать заново. У каждого метода лимит 100 запросов в минуту.
Через API доступны пять групп методов: склады, товары, цены, остатки и отправления. Карточки товаров (описание, фото, характеристики) через API менять нельзя, это делается только в кабинете, и бот честно об этом говорит.
Что умеет бот
- Склады и товары: список складов продавца, поиск товаров по ЛМ-коду, артикулу и названию.
- Цены: загрузка продажных цен пакетом, по списку «код, цена».
- Остатки: просмотр текущих остатков и установка новых, до 500 позиций за раз.
- Отправления: список и карточка заказа, данные доставки, статусы пачкой.
- Документы: листы подбора и стикеры со штрихкодами в PDF, бот сам дожидается генерации и присылает ссылку.
- Напоминания и отчёты по расписанию, отправка файлов на почту.
Отправления: от подтверждения до акта
Заказ на Лемана ПРО проходит статусы: подтверждение, упаковка, отгрузка, доставка. Бот переводит заказы по этой цепочке пакетно, делит отправление на несколько грузомест, формирует акт приёма-передачи и отменяет заказ с указанием причины.
Подтверждение перед записью
Тестового контура у маркетплейса для продавца нет, поэтому любая запись сразу попадает в боевой кабинет. Бот работает по правилу:
- одиночную точную команду («подтверди такой-то заказ») выполняет сразу;
- массовую операцию («залей остатки из файла», «подними цены на 10%», «подтверди все») сначала показывает списком и ждёт «да»;
- после записи перечитывает данные из API и подтверждает результат фактом.
Переходы по статусам необратимы, поэтому бот всегда показывает, что именно переводит.
Каталог в Google Таблице каждое утро
В API нет метода чтения цен, а продавцу нужно видеть актуальную картину. Поэтому каждое утро бот собирает снимок каталога в Google Таблицу: товары, остатки, цены и комиссии из недавних заказов. Снимок можно обновить командой в любой момент. Свои заметки продавец ведёт на отдельных листах, снимок их не трогает.
Как устроено
Python, клиент партнёрского API с кешем токена и обработкой лимитов. Сам бот работает как ИИ-агент на Claude: запрос продавца на естественном языке он превращает в вызовы инструментов, каждый из которых отвечает за одну операцию API. Правила работы с ценами, остатками и отправлениями описаны для агента отдельно, чтобы он не путал абсолютные значения остатков с изменениями и не пропускал подтверждение.
Частые вопросы
Можно ли через API Лемана ПРО изменить описание или фото товара?
Нет. Карточки товаров через партнёрский API только читаются, описание, фото и характеристики меняются в личном кабинете продавца.
Как бот получает доступ к кабинету?
По ключам партнёрского API (OAuth 2.0), которые выдаёт маркетплейс. Пароль от кабинета не нужен, ключи хранятся на сервере и не попадают в переписку.
Что будет, если ошибиться в команде?
Массовые операции бот выполняет только после подтверждения списка изменений. После записи он перечитывает данные и показывает, что получилось.
Можно ли загрузить остатки из файла?
Да, бот читает файл или Google Таблицу, собирает план изменений и после подтверждения загружает до 500 позиций за раз.
Как посмотреть текущие цены, если в API нет чтения цен?
Бот каждое утро собирает снимок каталога в Google Таблицу, там видны цены из недавних заказов. Снимок можно обновить в любой момент.
