От регистрации до первой брони: модели работы, загрузка каталога, остатки по пунктам выдачи и интеграции.
ЛучМаркет — агрегатор товаров и цен. Покупатель находит товар, а сделка заключается напрямую между ним и магазином. Платформа не проводит оплату и не хранит товар — она приводит покупателя и передаёт вам заявку или переход.
Работать можно в одной из двух моделей — от неё зависит, что видит покупатель на карточке товара и что происходит после клика:
Продавец — это аккаунт с ролью партнёра, к которому привязан один или несколько магазинов. Путь от нуля до активного магазина:
Регистрация по email /register, затем подтвердите адрес по ссылке из письма — без подтверждения вход закрыт.
Форма «Стать партнёром». Расскажите о магазине — мы свяжемся и подключим роль продавца. Уже есть свой интернет-магазин? Поможем перенести каталог.
В кабинете укажите название, сайт и описание, примите условия. Магазин сохраняется в статусе на модерации.
Модератор проверяет магазин и переводит его в активен — после этого товары показываются на витрине.
Модель выбирается в настройках магазина и определяет всю логику карточки товара. Один магазин работает в одной модели.
lm_click| Критерий | Прямой переход | Самовывоз |
|---|---|---|
| Где сделка | На сайте магазина | В пункте выдачи |
| Пункты выдачи | не нужны | обязательны |
| Остатки по точкам | нет | да, ключевое |
| Бронь товара | нет | 24 часа |
| Оплата | На вашем сайте | При получении |
Всё в разделе «Настройки магазина». Основное:
Раздел «Точки выдачи»: адрес, координаты на карте, телефон и часы работы по дням недели. Каждой точке можно задать свой код — тогда остатки через API вы будете слать по своему коду, а не по нашему id.
Каталог наполняется одним из трёх способов — их можно совмещать.
name, price, categoryId, picture, vendor, param| Задача | Канал | Периодичность |
|---|---|---|
| Первичная загрузка каталога | YML-фид | Раз в ~6 часов |
| Поправить один товар | Карточка в кабинете | Мгновенно |
| Актуальные остатки по ПВЗ | API остатков | При каждом изменении |
count в фиде — одно число на товар, оно не раскладывается по точкам выдачи. Реальное наличие по конкретным пунктам ведётся только через API остатков или вручную в кабинете.Наличие товара хранится по каждой паре «товар × пункт выдачи». У остатка два независимых числа:
Ваши обновления остатка никогда не сбрасывают чужие брони.
Выбирает пункт, оставляет имя и телефон. Товар удерживается на 24 часа.
В кабинете, на webhook и на e-mail. Связываетесь с покупателем и готовите к выдаче.
Покупатель забирает товар — либо бронь истекает через 24 часа и удержание снимается автоматически.
Статусы заявки: новая в работе завершена отклонена
Все ключи, примеры и настройки — в кабинете, раздел «Разработка / API». Входящие запросы подписываются вашим API-ключом.
Заголовок X-LM-Signature — это HMAC-SHA256 от тела запроса:
// на вашей стороне
$signature = hash_hmac('sha256', $body, $apiSecret);
// заголовок: X-LM-Signature: {$signature}POST /api/v1/stock/{shopId} — до 1000 записей за запрос. Товар адресуется вашим sku, точка — вашим location_external_id (или нашими id).
{
"updates": [
{ "sku": "ART-12345", "location_external_id": "PVZ-1", "in_stock": true, "quantity": 5 },
{ "sku": "ART-12345", "location_external_id": "PVZ-2", "in_stock": false, "quantity": 0 }
]
}Ответы: 200 — все обновлены, 207 — часть с ошибками, 400/401/403/404 — ошибка запроса, подписи, ключа или магазина.
При новой заявке платформа шлёт POST на ваш Webhook URL с данными покупателя, товара и выбранного пункта. Ждём ответ 2xx; иначе повторяем при следующей синхронизации.
POST /api/webhook/conversion/{shopId} — если работаете по модели «оплата за продажу». Пришлите click_id (из метки lm_click) и сумму заказа — мы посчитаем комиссию.
Для товаров, требующих подтверждения, в карточке можно указать:
Эти поля заполняются вручную в карточке товара или подтягиваются при модерации.