При формировании файла 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