Интеграция: автообновление прайса
Автоматическое обновление цен, наличия и поставок в пути через YML-фид.
Автоматическое обновление вашего прайса на витрине Liftway без ручной работы: цены, наличие и планируемые поставки подтягиваются из вашего фида по расписанию.
Раздел в кабинете: Кабинет поставщика → Интеграция.
Что умеет интеграция
| Функция | Формат | Статус |
|---|---|---|
| Обновление цены и наличия по уже заведённым позициям | YML по URL | ✅ работает |
| Поставки в пути — что заказано и едет (статус «В пути») | YML по URL | ✅ работает |
| Импорт новой номенклатуры (заведение новых позиций) | YML | 🔜 в разработке |
| Обмен по CommerceML (1С) | CommerceML | 🔜 в планах |
Сейчас интеграция обновляет существующие позиции вашего прайса и планирует поставки. Новые позиции пока заводятся вручную (экран «Прайс-лист», «Каталог → в прайс», «Импорт из Excel») — автозаведение новых из фида появится позже.
Как это работает
- Вы размещаете файл-фид по постоянной ссылке (URL) на своём сайте / в системе.
- В кабинете добавляете эту ссылку в разделе Интеграция.
- Liftway сам скачивает фид по расписанию (по умолчанию раз в 12 часов) и обновляет цену/наличие/поставки.
- В кабинете виден статус последнего прогона и статистика.
Фид должен быть доступен по прямой ссылке (без капчи и авторизации через браузер).
Если файл закрыт — укажите логин/пароль (HTTP Basic-авторизация). Поддерживается
сжатие gzip (ссылка на .gz или отдача с Content-Encoding: gzip).
Ключ сопоставления — код позиции
Это самое важное. По этому коду мы находим вашу позицию в прайсе.
В обоих фидах (цены/наличие и поставки в пути) это атрибут <offer id="...">.
Код должен совпадать с вашим кодом позиции в прайсе Liftway (ID при загрузке
Excel-прайса, поле «Ваш код» при добавлении из каталога). Обычно это ваш внутренний
артикул/код номенклатуры (например M00189).
Правило: используйте один и тот же код позиции везде — в Excel-прайсе, в YML, во втором YML. Тогда все каналы обновления работают согласованно. Если у позиции в Liftway код не задан — фид её не найдёт (в статистике попадёт в «пропущено»).
Фид «Цены и наличие» (YML)
Формат YML (Yandex Market Language) — стандартный XML-фид, который умеет отдавать большинство платформ (1С-Битрикс, InSales, Tilda, Ecwid, МойСклад и др.).
Минимальная структура
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2026-07-23 10:00">
<shop>
<offers>
<offer id="M00189" available="true">
<price>1234.50</price>
<count>5</count>
</offer>
<offer id="M00190" available="false">
<price>980</price>
</offer>
</offers>
</shop>
</yml_catalog>
Что мы читаем из каждого offer
| Данные | Откуда берём | Примечание |
|---|---|---|
| Код позиции | атрибут id |
обязателен; если пусто — берём <vendorCode> |
| Цена | <price> |
точка или запятая как разделитель; пробелы игнорируются |
| Наличие | <count>, либо <quantity_in_stock>, <stock>, <quantity>, либо <param name="Наличие"> (также «Остаток», «Кол-во», «Количество») |
целое число |
| Наличие (если количества нет) | атрибут available |
available="false" → наличие 0; available="true" без количества → наличие не меняем |
- Обновляются только цена и наличие. Карточка товара (название, фото, описание) не меняется — она берётся из выверенного эталона каталога Liftway.
- Позиции из фида, которых нет в вашем прайсе, пропускаются (новые фидом пока не заводятся).
- Прочие поля YML (
<name>,<picture>,<param>и т.п.) не используются — их можно оставлять, они не мешают.
Пример с param для наличия
<offer id="M00189" available="true">
<price>1 234,50</price>
<param name="Наличие">5</param>
</offer>
Фид «Поставки в пути» (YML)
Второй YML-фид — список позиций, которые заказаны и едут (в пути к вам). Ваша система (1С/учёт) генерит его сама из заказов поставщикам — участие человека не требуется. На витрине такие позиции показываются как «В пути · прибудет ДД.ММ», даже если сейчас их нет в наличии.
Структура фида поставок
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog>
<shop>
<offers>
<offer id="M00189">
<count>10</count>
<param name="ДатаПоступления">2026-08-15</param>
</offer>
<offer id="M00190">
<count>5</count>
</offer>
</offers>
</shop>
</yml_catalog>
| Данные | Откуда берём | Обязательно |
|---|---|---|
| Код позиции | атрибут id (или <vendorCode>) |
да |
| Сколько едет | <count> (или <quantity>, <param name="Количество">) |
да — без количества позиция пропускается |
| Дата поступления | <param name="ДатаПоступления"> (также «Дата», «ETA», «Срок поставки») или <date> / <delivery-date> |
нет — если нет, берём сегодня + «Срок доставки по умолчанию» из настроек фида |
Как это применяется
- Снапшот. Фид — это актуальный полный список того, что в пути. Позиция есть в фиде → на витрине «В пути». Позиции больше нет в фиде (приехала или отменилась) → статус «в пути» снимается автоматически.
- Когда товар приедет и появится на складе, он попадёт в фид цен/наличия
(
<count>), а из фида «в пути» вы его уберёте — всё синхронизируется само. - Позиции, которых нет в вашем прайсе Liftway, пропускаются.
Можно подключить оба YML-фида одновременно: один — цены/наличие, второй — поставки в пути.
Как получить фид из вашей системы
YML (цены/наличие):
- 1С-Битрикс — «Экспорт данных → Яндекс.Маркет (YML)». Даёт постоянную ссылку.
- МойСклад — «Розница/Товары → Экспорт → YML-выгрузка» или приложения выгрузки.
- InSales / Ecwid / Tilda Store — раздел выгрузок/фидов для Яндекс.Маркета.
- 1С:Предприятие/УТ — обработка выгрузки в YML (штатная или внешняя).
- Свой сайт — сгенерируйте XML по структуре выше и отдавайте по постоянному URL.
YML (поставки в пути):
- Выгрузка заказанных «в пути» позиций из 1С/учёта в YML по постоянной ссылке.
- Структура — как у фида цен, но с
<count>(сколько едет) и датой поступления.
Главное — постоянная прямая ссылка и стабильный код позиции в
id.
Подключение в кабинете
- Кабинет поставщика → Интеграция → «+ Добавить фид».
- Выберите тип фида: «Цены и наличие (YML)» или «Поставки в пути (YML)».
- Вставьте ссылку на фид.
- При необходимости укажите логин/пароль (если фид закрыт) и интервал обновления.
- Сохраните. Нажмите «Запустить сейчас» для первой проверки — через минуту обновите страницу и посмотрите статус.
Можно подключить оба фида одновременно.
Расписание и частота обновлений
- Liftway опрашивает активные фиды по расписанию (проверка каждый час; каждый фид обновляется не чаще своего интервала).
- Интервал задаётся при настройке (по умолчанию 720 минут = 12 часов; минимум 15 минут).
- Кнопка «Запустить сейчас» — внеплановая проверка в любой момент.
- Кнопка «Пауза» — временно отключить опрос без удаления настроек.
Статусы и диагностика
После прогона в карточке фида отображается статус и статистика.
| Показатель | Что значит |
|---|---|
| В фиде | сколько позиций (строк) прочитано из файла |
| Совпало | сколько нашлось в вашем прайсе по коду |
| Обновлено | сколько позиций реально обновили цену/наличие (для YML) |
| Отмечено «в пути» | сколько позиций отметили как «в пути» (для фида поставок) |
| Пропущено | не нашлись в прайсе / нечего обновлять |
Типичные ситуации:
- Много «пропущено», мало «совпало» — коды в фиде не совпадают с кодами позиций
в прайсе. Проверьте, что
<offer id>= ваш код позиции. - Ошибка загрузки (HTTP…) — ссылка недоступна, требует авторизации в браузере или вернула не тот файл. Проверьте прямую доступность; при закрытом фиде укажите логин/пароль.
- «Не удалось разобрать…» — файл не в ожидаемом формате (не YML) или повреждён.
Частые вопросы
Изменит ли фид мои карточки товаров (названия, фото)? Нет. Обновляются только цена и наличие. Карточка — из выверенного эталона каталога.
Заведёт ли фид новые позиции? Пока нет — только обновляет существующие. Автозаведение новых из фида в разработке. Новые позиции добавляйте вручную: «Прайс-лист», «Каталог → в прайс», «Импорт из Excel».
Что если у позиции в прайсе не задан код?
Фид её не найдёт. Задайте код позиции (тот же, что в вашем фиде) — при загрузке
Excel это колонка ID, при добавлении из каталога — поле «Ваш код».
Можно ли отдавать один общий YML на весь склад? Да. Мы возьмём только те позиции, что есть в вашем прайсе Liftway; остальные пропустим.
Поддерживается ли сжатие?
Да, gzip (ссылка .gz или Content-Encoding: gzip). Ограничение размера — 60 МБ.
Как часто обновляются данные? По вашему интервалу (по умолчанию раз в 12 часов). Можно запустить вручную в любой момент.