Документация
Обмен данными с учётной системой
Заказы и остатки ходят между вашей учётной системой и платформой автоматически. Здесь — что именно передаётся, какие есть уровни подключения и что нужно решить до начала работ.
Ваша учётная система и Лотус Маркет могут обмениваться данными автоматически: заказы попадают к вам сами, а витрина показывает тот остаток, который действительно есть на складе.
Эта страница — список: что передаётся, что можно подключить и какие решения нужны от вас. Техническая часть — в гайде внедрения и справочнике API.
Зачем это нужно
Вам. Менеджер перестаёт переносить заказы руками. Остатки на витрине соответствуют складу без ручного обновления. Меньше недостач — меньше разбирательств с покупателями.
Нам. Витрина показывает то, что действительно есть. Покупатель не заказывает проданное, не приезжает зря и возвращается снова.
Общее. Двойной ввод исчезает у обеих сторон. Ваш учёт остаётся вашим: мы в него не вмешиваемся и ничего в нём не меняем.
Как это работает
Обмен автоматический, участие человека не требуется.
- Изменился остаток или цена у вас — витрина обновляется.
- Покупатель оформил заказ у нас — заказ появляется в вашей системе.
- Вы собрали заказ — покупатель получает уведомление, что можно приезжать.
- Чего-то не хватило — покупатель узнаёт об этом заранее, а не на складе.
Инициатива всегда на вашей стороне: ваша система обращается к нам, мы отвечаем. Доступ в вашу сеть нам не нужен ни в каком виде, открывать порты и публиковать базу в интернет не требуется.
Какими данными обмениваемся
| Направление | Что передаётся |
|---|---|
| От вас к нам | Товарные позиции: сорт, категория, длина стебля, страна, размер связки, остаток, цена, склад |
| Готовность заказа к выдаче — и её откат, если документ сборки распровели | |
| Недостача по позиции, если собрано меньше заказанного | |
| По желанию: будущие поставки из вашего документа; список клиентов с их персональными скидками | |
| От нас к вам | Новые заказы: состав, количество, покупатель, склад выдачи |
| Отмена заказа и изменение его состава: вами, платформой или каскадом при отмене вашей поставки | |
| Подтверждение получения покупателем | |
| Факт перечисления вам денег по заказам, оплаченным через платформу |
Вне обмена остаётся: рекламации, споры по качеству и предложение замены товара. Это ведётся в личном кабинете на платформе.
Факт выдачи заказа подтверждает покупатель на складе — сканированием кода. Из вашей системы этот статус не устанавливается: от момента выдачи отсчитываются сроки рекламаций и взаиморасчёты, поэтому подтверждение должно исходить от получателя.
Что можно подключить
Обмен делится на четыре независимых уровня. Порядок мы не навязываем: подключайте в любом составе, начинайте с того, что для вас важнее, и останавливайтесь на любом — уровень, который вы не подключили, просто продолжает работать вручную в кабинете, как сейчас.
| Уровень | Что даёт | Что требуется от вас |
|---|---|---|
| Остатки и цены | Витрина сама показывает актуальный остаток и цену. Меньше недостач и отказов | Разово сопоставить товар и склады в кабинете; ваша система передаёт изменения остатка |
| Заказы | Заказы попадают в вашу систему документами; готовность и недостача уходят к нам из ваших документов | Обработка забирает заказы по расписанию и сообщает о сборке |
| Поставки | Будущая поставка выкладывается из вашего документа и продаётся предзаказом ещё до прихода товара | Передавать документ поставки и сообщать о приходе |
| Контрагенты | Ваши постоянные клиенты со своими скидками переносятся на платформу; она узнаёт их по ИНН — сразу, если клиент уже зарегистрирован, и позже, когда он укажет ИНН | Один раз выгрузить список и обновлять его при изменениях |
Каждый уровень — несколько однотипных запросов от вашей системы к нашей. Основная работа приходится не на общение с нами, а на вашу учётную систему: откуда брать остатки и как формировать документ заказа.
Что мы фиксируем
Эти правила вытекают из устройства платформы и обсуждению не подлежат. Их нужно учесть при доработке вашей системы.
- Количества — в штуках, целыми числами.
- Недостача объявляется кратно связке. Если в связке 25 стеблей, недостача бывает 25, 50, 75 — половину связки покупателю не выдать. Остатки при этом передавайте фактические и не округляйте: 247 стеблей так и встанут на витрину как 247, а кратность связке обеспечит корзина покупателя.
- Цена — за одну штуку, в копейках, целым числом. Не за связку и не за коробку.
- Нам вы передаёте свою цену, а в заказах получаете цену покупателя. Считается она так: из вашей цены вычитается скидка покупателя, если она есть, и уже к уменьшенной цене добавляется комиссия платформы. Реализацию и УПД проводите по ценам заказа — покупатель платит именно эту сумму. На числах: заказ на 100 роз по вашей цене 100 ₽ при комиссии 3 % и без скидки — документы на 10 300 ₽, вам причитается 10 000 ₽, комиссия платформы 300 ₽. По заказам, оплаченным через платёжный сервис платформы, комиссия удерживается из перечисляемой суммы; по остальным приходит отдельным счётом по договору.
- У каждой позиции нужен стабильный код номенклатуры, не меняющийся со временем. По нему мы связываем ваши позиции с карточками на платформе. Если код меняется — при каждом обмене рядом будут появляться вторые позиции того же товара.
- Остаток передаётся физический, не скорректированный. Объёмы, забронированные покупателями, вычитаем мы сами. Если вычесть их и на вашей стороне — вычтется дважды, и у покупателей начнёт пропадать товар из корзин.
- Товар, уже выложенный на платформе, сопоставляется до первого обмена. У выложенного вручную вашего кода нет. Платформа от дублей защищается сама — строку по коду, похожему на уже выложенную позицию, она не применяет, а предлагает связать их в кабинете, — но пока сопоставление не сделано, такие строки будут отклоняться. Это разовая работа менеджера: платформа сама предложит совпадения.
Способы подключения
Бизнес-часть одинакова во всех случаях, различается только техника.
| Ваша система | Как подключаемся | Что требуется от вас |
|---|---|---|
| 1С, любая конфигурация | Внешняя обработка поверх вашей 1С обращается к нам по защищённому каналу. Конфигурация не меняется, с поддержки снимать ничего не нужно | Несколько дней работы вашего специалиста |
| МойСклад | Обмен уже реализован: вы создаёте у себя токен доступа и вставляете его в кабинете | Пять минут, программист не нужен |
| Другая система, умеющая HTTPS-запросы | Так же, как 1С: модуль на вашей стороне, наш API — общий для всех | Зависит от системы |
Во всех вариантах мы предоставляем документацию, тестовую среду в изоляции от живых заказов и прямой контакт нашего разработчика на время работ. Ключ доступа владелец аккаунта выпускает сам в кабинете — обращаться к нам за ним не нужно.
Одновременно работает одна учётная система. Перейти с одной на другую можно в любой момент, но обе сразу вести номенклатуру не могут — иначе остаток на витрине зависел бы от того, чей обмен пришёл последним.
Что нужно решить вам
По каждому пункту достаточно короткого ответа — детали проработаем вместе.
- Есть ли стабильный код номенклатуры, который не меняется при переоформлении карточки товара. Это ключевое техническое условие.
- Ведёте ли учёт связками или только в штуках. Если только в штуках — потребуется завести размер связки как атрибут позиции.
- Каким документом фиксируется сборка заказа и когда проводится реализация — при отпуске со склада или по факту передачи покупателю. От этого зависит, к какому событию привязать сигнал «готов к выдаче».
- Какие уровни подключаем и в каком порядке — из таблицы выше.
- Есть ли уже выложенный на платформе товар, который нужно сопоставить с вашей номенклатурой до первого обмена.
- Кто со стороны вашей компании ведёт работы и в какие сроки готовы начать.
Что дальше
Дальше материалы:
- Гайд внедрения — что делать по каждому уровню, в каком порядке и как проверить, что заработало.
- Справочник API — точный контракт: адреса, форматы, методы, коды ответов.
Ключ доступа выпускает владелец аккаунта в кабинете, в разделе «Подключённые системы».