Как подключить внешний прайс

Подключение состоит из двух этапов: сначала сохраните источник и настройте поля, затем загрузите данные в витрину. Для настройки войдите в Desktop как администратор.

Подготовить файл или ссылку

Формат	Что подготовить
CSV	Таблицу с заголовками; уточните разделитель колонок и кодировку
XLSX	Книгу Excel; уточните лист и номер строки заголовков
BazDromXml	XML-фид в формате baz-on/baz-drom с записями товаров part

Старый формат .xls для загрузки больше не поддерживается: откройте файл в Excel и сохраните как .xlsx. BazDromXml подходит для указанного формата фида, а не для любого XML.

Для источника по ссылке нужен прямой публичный адрес http:// или https://, по которому скачивается сам файл. Ссылка на страницу сайта или облачного диска с кнопкой скачивания может не подойти. Источники с отдельным входом, логином и паролем, а также адреса локальной сети не поддерживаются.

Для скачивания по ссылке действуют ограничения: до 100 МБ, до 90 секунд и до пяти перенаправлений. Формат URL-источника выбирается явно, даже если в адресе нет расширения файла.

Добавить источник

1. Откройте «Справочники → Внешние прайсы → Прайсы» и нажмите «Добавить».
2. Введите «Название», по которому будет удобно узнавать прайс.
3. При необходимости укажите поставщика: нажмите «Выбрать» рядом с полем «Поставщик», кнопка «Очистить» снимает связь. Связь необязательна: прайс можно сохранить без поставщика.
4. Выберите «Тип источника»:
   • «Файл» — нажмите «Выбрать файл» и укажите файл на компьютере;
   • «URL» — вставьте прямую ссылку в «Путь или HTTP(S)-ссылка».
5. Проверьте «Формат».
6. Для CSV или XLSX откройте «Параметры разбора» и настройте чтение.
7. Нажмите «Прочитать структуру». В строке состояния внизу окна появится «Найдено колонок: N; кодировка: …» — проверьте, что число колонок похоже на правду.
8. Нажмите «Сохранить».
9. Названия колонок и примеры значений проверьте в контекстном меню прайса: «Поля витрины» → вкладка «Колонки источника», столбцы «Заголовок» и «Примеры».

Один прайс можно связать с одним поставщиком; у поставщика может быть несколько прайсов. Позже источник и связь можно изменить через «Источник и формат» в контекстном меню прайса.

Чтение структуры показывает только число найденных колонок и кодировку. Команда «Загрузить все строки» читает весь файл и показывает число строк и колонок. Оба действия ещё не заменяют сохранённую витрину. Изменения источника записываются после «Сохранить».

Настроить чтение таблицы

В «Параметры разбора» проверьте:

Поле	Как заполнить
Лист	Имя листа XLSX. Пустое значение означает первый лист
Строка заголовков	Номер строки с названиями колонок, начиная с 1. Строки выше неё не загружаются
Разделитель CSV	Один символ, которым разделены колонки: например, ; или ,
Кодировка	Обычно «Авто». Для неверно отображающейся кириллицы можно попробовать Windows-1251

Нажмите «ОК», затем перечитайте структуру. Если найдена всего одна колонка, хотя в файле их больше, проверьте разделитель CSV. Если после сохранения на вкладке «Колонки источника» вместо названий видны служебные строки, исправьте номер строки заголовков.

Для BazDromXml параметры разбора недоступны: его структура задана форматом. Колонки называются, например, id, title, price, photoUrls, description. Их можно переименовать для витрины.

Идентификаторы с ведущими нулями, например 00123, храните в XLSX как текст. Одного числового формата ячейки с нулями недостаточно: программа читает значение, а не его оформление в Excel.

Выбрать поля и ключ строки

1. В контекстном меню прайса откройте «Поля витрины».
2. Включите нужные исходные колонки, в том числе будущую колонку ID, и нажмите «Применить витрину».
3. Откройте «Ключ строки и вид».
4. В поле *«ID товара » выберите постоянный идентификатор позиции поставщика.
5. Если ID повторяется у разных предложений, выделите нужные колонки в списке «Дополнительные ключи» (можно выбрать несколько). Например, сочетание артикула и склада отличит предложения с одинаковым артикулом на разных складах.
6. При необходимости настройте количество, цену, фото и вид товара.
7. Нажмите «Применить».

Ключ должен отличать каждую позицию и оставаться прежним при обновлениях. Не используйте изменяющуюся цену как часть ключа.

Строки с пустым ID не загружаются. Если несколько строк имеют один полный ключ, исключаются все строки этой группы. Пробелы по краям частей ключа убираются, регистр букв сохраняется: ABC и abc — разные ключи.

Изменение ключа уже загруженного прайса

Если при сохранении появляется предупреждение «Состав ключа строки изменён. Сохранённые строки и ручные значения будут удалены», подтверждение очищает прежнюю витрину и ручные данные. Такое предупреждение возможно и при изменении настроек количества. При необходимости сначала сохраните нужные данные в Excel.

Загружать только нужные предложения

Например, можно исключить позиции без остатка или оставить только определённые категории поставщика.

1. В списке прайсов выберите правой кнопкой «Фильтрация строк».
2. Нажмите «Добавить условие».
3. Выберите исходную колонку, операцию и значение.
4. Добавьте остальные условия и нажмите «Сохранить».
5. Выполните «Загрузить в витрину», чтобы применить отбор.

Все условия соединяются через И. Например, «Остаток больше 0» и «Категория равно Шины» оставят только шины с положительным остатком. Можно использовать и колонки, скрытые из витрины.

Доступны сравнения текста, проверка пустоты, числовые сравнения, «Из списка» и «Не из списка». Для выбора найденных значений списка сначала прочитайте источник командой «Загрузить все строки».

Изменение этих фильтров влияет на следующую загрузку. Для отбора только в одной выгрузке используйте фильтры набора данных.

Проверить и загрузить результат

1. Для полного предварительного просмотра откройте «Источник и формат», нажмите «Загрузить все строки» и сохраните.
2. В списке прайсов выберите «Предпросмотр».
3. Сравните вкладки «Исходные строки» и «Витрина». При настроенных видах проверьте «Поля вида товара · необязательно».
4. Включите «Только проблемные строки», чтобы проверить ошибки ключей.
5. Закройте предпросмотр и выполните «Загрузить в витрину».
6. Прочитайте итог загрузки, затем выберите «Открыть витрину».

Загрузка заново читает источник по сохранённым настройкам. В дальнейшем используйте этот же путь для ручного обновления.

Скопировать настройки или удалить прайс

«Клонировать» создаёт независимый прайс с копией источника, полей, правил и связи с поставщиком. Новое имя получает пометку «копия». Витрина, ручные значения, расписание, журнал и наборы выгрузки не копируются. Проверьте источник копии и загрузите её отдельно.

«Удалить» убирает прайс и его строки витрины. В текущем окне отдельного подтверждения этой команды нет. Перед удалением проверьте, что прайс больше не нужен в выгрузках и сводном просмотре.