Документация / Прайс-лист и наполнение / Интеграция: автообновление прайса

Интеграция: автообновление прайса

Автоматическое обновление цен, наличия и поставок в пути через YML-фид.

Автоматическое обновление вашего прайса на витрине Liftway без ручной работы: цены, наличие и планируемые поставки подтягиваются из вашего фида по расписанию.

Раздел в кабинете: Кабинет поставщика → Интеграция.

Что умеет интеграция

Функция Формат Статус
Обновление цены и наличия по уже заведённым позициям YML по URL ✅ работает
Поставки в пути — что заказано и едет (статус «В пути») YML по URL ✅ работает
Импорт новой номенклатуры (заведение новых позиций) YML 🔜 в разработке
Обмен по CommerceML (1С) CommerceML 🔜 в планах

Сейчас интеграция обновляет существующие позиции вашего прайса и планирует поставки. Новые позиции пока заводятся вручную (экран «Прайс-лист», «Каталог → в прайс», «Импорт из Excel») — автозаведение новых из фида появится позже.

Как это работает

  1. Вы размещаете файл-фид по постоянной ссылке (URL) на своём сайте / в системе.
  2. В кабинете добавляете эту ссылку в разделе Интеграция.
  3. Liftway сам скачивает фид по расписанию (по умолчанию раз в 12 часов) и обновляет цену/наличие/поставки.
  4. В кабинете виден статус последнего прогона и статистика.

Фид должен быть доступен по прямой ссылке (без капчи и авторизации через браузер). Если файл закрыт — укажите логин/пароль (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.

Подключение в кабинете

  1. Кабинет поставщика → Интеграция → «+ Добавить фид».
  2. Выберите тип фида: «Цены и наличие (YML)» или «Поставки в пути (YML)».
  3. Вставьте ссылку на фид.
  4. При необходимости укажите логин/пароль (если фид закрыт) и интервал обновления.
  5. Сохраните. Нажмите «Запустить сейчас» для первой проверки — через минуту обновите страницу и посмотрите статус.

Можно подключить оба фида одновременно.

Расписание и частота обновлений

  • Liftway опрашивает активные фиды по расписанию (проверка каждый час; каждый фид обновляется не чаще своего интервала).
  • Интервал задаётся при настройке (по умолчанию 720 минут = 12 часов; минимум 15 минут).
  • Кнопка «Запустить сейчас» — внеплановая проверка в любой момент.
  • Кнопка «Пауза» — временно отключить опрос без удаления настроек.

Статусы и диагностика

После прогона в карточке фида отображается статус и статистика.

Показатель Что значит
В фиде сколько позиций (строк) прочитано из файла
Совпало сколько нашлось в вашем прайсе по коду
Обновлено сколько позиций реально обновили цену/наличие (для YML)
Отмечено «в пути» сколько позиций отметили как «в пути» (для фида поставок)
Пропущено не нашлись в прайсе / нечего обновлять

Типичные ситуации:

  • Много «пропущено», мало «совпало» — коды в фиде не совпадают с кодами позиций в прайсе. Проверьте, что <offer id> = ваш код позиции.
  • Ошибка загрузки (HTTP…) — ссылка недоступна, требует авторизации в браузере или вернула не тот файл. Проверьте прямую доступность; при закрытом фиде укажите логин/пароль.
  • «Не удалось разобрать…» — файл не в ожидаемом формате (не YML) или повреждён.

Частые вопросы

Изменит ли фид мои карточки товаров (названия, фото)? Нет. Обновляются только цена и наличие. Карточка — из выверенного эталона каталога.

Заведёт ли фид новые позиции? Пока нет — только обновляет существующие. Автозаведение новых из фида в разработке. Новые позиции добавляйте вручную: «Прайс-лист», «Каталог → в прайс», «Импорт из Excel».

Что если у позиции в прайсе не задан код? Фид её не найдёт. Задайте код позиции (тот же, что в вашем фиде) — при загрузке Excel это колонка ID, при добавлении из каталога — поле «Ваш код».

Можно ли отдавать один общий YML на весь склад? Да. Мы возьмём только те позиции, что есть в вашем прайсе Liftway; остальные пропустим.

Поддерживается ли сжатие? Да, gzip (ссылка .gz или Content-Encoding: gzip). Ограничение размера — 60 МБ.

Как часто обновляются данные? По вашему интервалу (по умолчанию раз в 12 часов). Можно запустить вручную в любой момент.