Личный кабинет OneBox CRM
Связаться с нами
+380 67 447 91 27 - Вайбер
+380 66 232 46 00
+380 63 999 50 11
Кабинет клиентаБаза знаний › Просмотр базы знаний

Разбор файла xml для импорта в систему OneBox

При формировании файла xml для импорта в OneBox следует отметить 3 основных момента - Источник файла, Массивы файла, Поля системы. 

СКАЧАТЬ ПРИМЕР ФАЙЛА

 

Разберем их подробнее:

 

1. Источник файла. 

Файл можно загрузить тремя способами:

1) FTP - вы кладете свой файл на какой-нибудь сервер и прописываете доступы в настройках

Бокс подключается к серверу и скачивает файл.

2) Локальная папка - папка на сервере, где размещен бокс. Для этого нужно иметь доступ к какой-нибудь из папок, а дальше можно указать путь к файлу. Система будет искать файл по указанному пути и загружать его.

3) API URL (внешняя ссылка) - прямая ссылка на открытие файла в браузере. Не должно быть никаких паролей для открытия ссылки, так как система не сможет её открыть и закачать все товары.

 

2. Массивы.

1) Массив категорий - для импорта дерева категорий

2) Массив продуктов - для импорта информации о товарах 

3) Массив дополнительных полей - для импорта дополнительных поле товара. Массив должен быть внутри массива товаров

4) Массив картинок товара - для импорта дополнительных фото товара. Массив должен быть внутри массива товаров

5) Массив фильтров и характеристик товара - для импорта параметров товара. Массив должен быть внутри массива товаров

6) Массив поставщиков товара - для импорта поставщиков товара. Массив должен быть внутри массива товаров

7) Массив цен продуктов - для импорта дополнительных цен продуктов. Массив должен быть внутри массива товаров

 

3. Поля системы.

Сразу следует понять, что НЕ имеет никакого значения как будут называться теги или атрибуты в вашем файле, так как импорт настраивается универсально и можно указать какой тег или артибут из файла соответствует какому полю в системе. То есть тег в файле может быть "<vendorCode>" а мы его загрузим как "артикул товара".

 

Теперь описание полей, которые мы можем загружать с файла. Для удобства они разбиты по массивам.

1) Массив категорий

ID категории - из вашей системы, используется для обновления категорий. Поле с типом - число челое

Имя категории - поле с типом строка

ID родительской категории - Поле с типом - число челое

Cкрытость категории - категория скрывается для отображения

Описания категории - поле с типом текст

Картинки категории - поле с типом текст

 

2) Массив продуктов

ID товара - из вашей системы (используется для обновления продуктов, по данному полю происходит поиск продуктов в системе). Поле с типом - число челое

Имя товара - поле с типом строка

ID категории товара - будет использоваться id из массива категорий. Поле с типом - число челое

ID бренда товара - id производителя товара в системе OneBox (внутренний код). Можно узнать, только если создать бренд в системе. Поле с типом - число челое

Имя бренда товара - название  производителя товара в системе OneBox (как он будет называться).  Если такого бренда нет, то будет создан новый. Поле типа - строка

Артикул товара - можно использовать для обновления продуктов вместо внешний id. При указании обоих полей приоритетным будет поле внешний id. Поле типа строка - можно указывать буквы, цифры, пробелы

Валюта товара - ключ валюты товара в OneBox. Базово есть 4 валюты - UAH, USD, RUB и EUR. Могут быть созданны свои валюты. При создании новой валюты можно указать её ключ, например PLN

Базовая цена товара - цена закупки товара, поле с типом - число с плавающей точной, например 15.22

Cтарая цена товара - поле с типом - число с плавающей точной, например 15.22

Цена товара - цена продажи товара

Краткое описание товара - текстовое поле

Описание товара - текстовое поле

Характеристики товара - текстовое поле

Наличие товара - наличие товара определяется отметкой в карточке товара, поле с типом - чекбокс, передавать нужно значения 1 или 0, где 1 - есть в наличии, 0 - нет в наличии.

Текст наличия товара - в свободной форме, можно указать "В наличии" или "Под заказ"

Скрытость товара - поле с типом - чекбокс, передавать нужно значения 1 или 0, где 1 - скрытый, 0 - не скрытый.

Максимальная скидка товара - указывается значение в процентах 

Модельный ряд - поле с типом строка

Модель товара - поле с типом строка

Синхронизация наличия товара - поле с типом - чекбокс, передавать нужно значения 1 или 0

Cинхронизация цены товара - поле с типом - чекбокс, передавать нужно значения 1 или 0

Cкидка товара - указывать в процентах. Поле с типом - число с плавающей точной, например 15.22

Штрих код товара - 

Url товара - 

Дата обновления товара - поле с типом - дата

Дата создания товара - поле с типом - дата

Дробимость товара - поле с типом - число с плавающей точной, например 15.22

Остаток на складе - поле с типом - число с плавающей точной, например 15.22

Единица измерения товара - поле с типом строка

Картинка товара - указывать нужно активную слылку, по которой картинку можно открыть в браузере и скачать.

 

3) Массив дополнительных полей

Дополнительное поле - указывать нужно значение поля. У данного поля может быть несколько типов - Строка, Текст, Чекбокс, Число целое, Число с плавающей точкой, Дата, Дата и Время, Выпадающий список, Редактор.

 

4) Массив картинок товара - в данном массиве нужно передавать ссылки на дополнительные фото товара

 

5) Массив фильтров и характеристик товара

Имя фильтра товара - название фильтра (параматра) товара, например - "Вес". Поле с типом строка

Значение фильтра товара - значение фильтра (параметра) товара, например "1 кг". Поле с типом строка

Использования характристики в таблицы фильтров - отображать или не отображать фильтр в таблице на странице продукта. поле с типом - чекбокс, передавать нужно значения 1 или 0

Доступность фильтра как характеристики в таблице - поле с типом - чекбокс, передавать нужно значения 1 или 0

 

6) Массив поставщиков товара

ID поставщика товара - id поставщика из системы OneBox

Имя поставщика товара - если такого поставщика в системе нет, то будет создан новый. Полес типом строка

Код поставщика товара - код, по которому можно будет сделать последующее обновление данных о поставщике у товара. Поле с типом строка

Цена поставщика товара - поле с типом - число с плавающей точной, например 15.22

Валюта поставщика товара - ключ валюты товара в OneBox. Базово есть 4 валюты - UAH, USD, RUB и EUR. Могут быть созданны свои валюты. При создании новой валюты можно указать её ключ, например PLN

Наличия поставщика товара - поле с типом строка

Текст наличия поставщика товара - поле с типом строка

 

7) Массив цен продуктов

Имя цены продукта - поле с типом строка

Валюта цены продукта - ключ валюты товара в OneBox. Базово есть 4 валюты - UAH, USD, RUB и EUR. Могут быть созданны свои валюты. При создании новой валюты можно указать её ключ, например PLN

Значение цены продукта - поле с типом - число с плавающей точной, например 15.22