Как импортировать каталог и товары из 1с через CommerceML

• Стандарт CommerceML
• Как загрузить каталог и информацию о товарах используя CommerceML?
• Как загрузить каталог и товары из CommerceML на сайты платформы beseller?
• Как сформировать выгрузку данных в формат CommerceML?
• Как настроить профиль импорта?
• Как настроить загрузку данных на сайт?
  • Ручная загрузка файла
  • Настройка автоматического импорта по ссылке

Стандарт CommerceML

CommerceML — унифицированный стандарт обмена коммерческой информацией в XML-формате.

Стандарт предполагает передачу (обмен) информации о:

• каталогах товаров;
• заказах;
• документах.

в согласованном структурированном формате.

Стандарт CommerceML был разработан компаниями «1С» и «Extra.RU» при поддержке Microsoft в 2000 году. В настоящее время, опубликованы первая и вторая редакции стандарта CommerceML, а также CommerceML EDI. Скачать XML-схему стандарта и описание схемы CommerceML 2.10 можно по ссылке тут.

Используя стандарт CommerceML можно настроить обмен данными сайта или интернет-магазина, например, загрузку информации о товарах из:

• Приложений группы 1C (Предприятие, Бухгалтерия, Управление торговлей, Розница);
• МойСклад;
• Класс365.

Смотрите также:

• Модуль «Импорт товаров из CommerceML».
• Как создавать и редактировать структуру каталога товаров?
• Как создавать и редактировать карточки товаров?
• Как создавать и редактировать характеристик товаров (групповые поля) товаров?

Как загрузить на сайт каталог и информацию о товарах используя формат CommerceML?

Сайты, созданные на платформе beseller, поддерживают импорт:

• структуры каталога;
• товаров;
• характеристик товаров;
• иллюстраций;
• остатках (наличия) товара;
• цен;

по стандарту CommerceML 2.х.

Для загрузки структуры каталога и информации о товарах, согласно стандарту, необходимо наличие 2-х файлов:

1. import.xml — в нем передается информация о разделах каталога и товарах;
2. offers.xml — в нем передается информация о ценах и остатках.

Не обязательно (допустимо) наличие файлов иллюстраций для товаров.

Для импорта структуры каталога (разделов) используются теги Группы из тега Классификатор файла import.xml, например:

<?xml version="1.0" encoding="UTF-8"?>
<КоммерческаяИнформация xmlns="urn:1C.ru:commerceml_2" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ВерсияСхемы="2.07" ДатаФормирования="2022-03-29T16:11:18">
<Классификатор>
<Ид>c6eef841-7826-4f69-a454-63cfc1badefd</Ид>
<Наименование>Классификатор (Каталог товаров C6EEF841)</Наименование>
<Владелец>
<Ид>90b3c4c4-ac36-11ec-9139-6045cba26dfc</Ид>
<Наименование>Магазин 1</Наименование>
<ОфициальноеНаименование>Магазин 1</ОфициальноеНаименование>
<ОКПО/>
</Владелец>
<Группы>
<Группа>
<Ид>0501a42a-af27-11ec-9139-6045cba26dfc</Ид>
<Наименование>Лег.пром.</Наименование>
<Группы>
<Группа>
<Ид>90b3c4c0-ac36-11ec-9139-6045cba26dfc</Ид>
<Наименование>Обувь</Наименование>
</Группа>
<Группа>
<Ид>0501a40a-af27-11ec-9139-6045cba26dfc</Ид>
<Наименование>Куртки</Наименование>
</Группа>
<Группа>
<Ид>a559a122-ae65-11ec-9139-6045cba26dfc</Ид>
<Наименование>Обувь</Наименование>
<Группы>
<Группа>
<Ид>a559a126-ae65-11ec-9139-6045cba26dfc</Ид>
<Наименование>Обувь</Наименование>
</Группа>
</Группы>
</Группа>
</Группы>
</Группа>
</Группы>

Для загрузки информации о товарах используются теги Товары из тега Каталог файла import.xml, например:

<Каталог СодержитТолькоИзменения="false">
<Ид>c6eef841-7826-4f69-a454-63cfc1badefd</Ид>
<ИдКлассификатора>c6eef841-7826-4f69-a454-63cfc1badefd</ИдКлассификатора>
<Наименование>Каталог товаров C6EEF841</Наименование>
<Владелец>
<Ид>90b3c4c4-ac36-11ec-9139-6045cba26dfc</Ид>
<Наименование>Прога и копыта</Наименование>
<ОфициальноеНаименование>Прога и копыта</ОфициальноеНаименование>
<ОКПО/>
</Владелец>
<Товары>
<Товар>
<Ид>90b3c4c1-ac36-11ec-9139-6045cba26dfc</Ид>
<Артикул/>
<Наименование>Сандали</Наименование>
<БазоваяЕдиница Код="796 " НаименованиеПолное="Штука" МеждународноеСокращение="PCE">
<Пересчет>
<Единица>796</Единица>
<Коэффициент>1</Коэффициент>
</Пересчет>
</БазоваяЕдиница>
<Группы>
<Ид>90b3c4c0-ac36-11ec-9139-6045cba26dfc</Ид>
</Группы>
<Описание/>
<СтавкиНалогов>
<СтавкаНалога>
<Наименование>НДС</Наименование>
<Ставка>20</Ставка>
</СтавкаНалога>
</СтавкиНалогов>
<ЗначенияРеквизитов>
<ЗначениеРеквизита>
<Наименование>Код</Наименование>
<Значение>00-00000001</Значение>
</ЗначениеРеквизита>
<ЗначениеРеквизита>
<Наименование>ВидНоменклатуры</Наименование>
<Значение>Обувь</Значение>
</ЗначениеРеквизита>
<ЗначениеРеквизита>
<Наименование>ТипНоменклатуры</Наименование>
<Значение>Товар</Значение>
</ЗначениеРеквизита>
<ЗначениеРеквизита>
<Наименование>Полное наименование</Наименование>
<Значение>Сандали (GH-2)</Значение>
</ЗначениеРеквизита>
</ЗначенияРеквизитов>
</Товар>

Для импорта информации о ценах и остатках товаров используются теги Предложение из файла offers.xml, например:

<Предложение> <Ид>a559a127-ae65-11ec-9139-6045cba26dfc#a559a129-ae65-11ec-9139-6045cba26dfc</Ид>
<Артикул>АПН-2</Артикул>
<Наименование>Сланцы (40)</Наименование>
<БазоваяЕдиница Код="796 " НаименованиеПолное="Штука" МеждународноеСокращение="PCE">
<Пересчет>
<Единица>796</Единица>
<Коэффициент>1</Коэффициент>
</Пересчет>
</БазоваяЕдиница>
<Цены>
<Цена>
<Представление> 32,4 RUB за PCE</Представление>
<ИдТипаЦены>90b3c4ca-ac36-11ec-9139-6045cba26dfc</ИдТипаЦены>
<ЦенаЗаЕдиницу>32.4</ЦенаЗаЕдиницу>
<Валюта>RUB</Валюта>
<Единица>PCE</Единица>
<Коэффициент>1</Коэффициент>
</Цена>
</Цены>
<Количество>0</Количество>
<Склад ИдСклада="90b3c4c8-ac36-11ec-9139-6045cba26dfc" КоличествоНаСкладе="0"/>
<Склад ИдСклада="a559a132-ae65-11ec-9139-6045cba26dfc" КоличествоНаСкладе="0"/>
</Предложение>

Для импорта информации о характеристиках (свойствах) товаров используются теги ХарактеристикиТовара, ЗначенияСвойств из файла import.xml, например:

<ЗначенияСвойств>
<ЗначенияСвойства>
<Ид>0501a40b-af27-11ec-9139-6045cba26dfc</Ид>
<Наименование>Рукава</Наименование>
<Значение>0501a40c-af27-11ec-9139-6045cba26dfc</Значение>
</ЗначенияСвойства>
</ЗначенияСвойств>
<ХарактеристикиТовара>
<ХарактеристикаТовара>
<Ид>0501a40b-af27-11ec-9139-6045cba26dfc</Ид>
<Наименование>Рукава</Наименование>
<Значение>Монолит</Значение>
</ХарактеристикаТовара>
</ХарактеристикиТовара>

Обратите внимание! Для импорта характеристик:

• необходимо предварительно создать соответствующие групповые поля;
• название свойств в файле импорта должно соответствовать названию групповых полей;
• при формировании профиля импорта групповые поля необходимо сопоставить с названиями свойств.

Как загрузить каталог и товары из CommerceML на сайты платформы beseller?

Для того, чтобы настроить загрузку (добавление и обновление) информацию о структуре каталога и товарах необходимо:

1. Настроить выгрузку данных из приложений 1с, МойСклад, Класс365.
2. В панели администрирования сайтом:
   • Если вы планируете загружать из 1с свойства товаров, сформировать наборы характеристик товаров (группы).
   • Настроить профиль импорта.
   • Сопоставить поля из импортируемых файлов с полями страниц разделов каталога и страниц карточек товаров.
   • Настроить загрузку данных на сайт.

Смотрите также руководство: Как настроить импорт из csv-, yml-, xml-, xlsx-файлов?

Как сформировать выгрузку данных в формат CommerceML?

В приложении 1с настройте формирование zip-архива с файлами:

• import.xml — для загрузки разделов и товаров (обязательно);
• offers.xml — для загрузки цен и остатков (обязательно);
• иллюстраций товаров (не обязательно).

Архив должен содержать директорию webdata с файлами:

• import.xml — для загрузки разделов и товаров;
• offers.xml — для загрузки цен и остатков.

Архив может содержать директорию import_files с файлами картинок для товаров.

Обратите внимание! Размер архива с иллюстрациями не должен превышать 150 Mb.

Как настроить профиль импорта?

Управление настройками импорта и сам импорт осуществляется во вкладке «Разделы и товары», далее «Импорт товаров».

1. Для создания нового профиля импорта перейдите во вкладку «Разделы и товары», далее «Импорт товаров», далее закладка «Профили импорта».
2. Нажмите на кнопку «Добавить».
3. Укажите название профиля импорта. Название профиля удобно формировать, например, по:
   • названию поставщика;
   • типу импортируемого файла;
   • раздела каталога в который загружается информация о товарах.
4. Если вы планируете импортировать структуру каталога (добавить новые разделы каталога) активируйте переключатель «Импортировать структуру каталога». Одновременно загружать и товары и структуру каталога можно только при импорте YML-файлов и файлов в формате CommerceML.
5. Укажите в какой раздел необходимо добавить новые товары в поле «Раздел для новых товаров».
6. Укажите группу (набор характеристик товаров) с которой необходимо связать новые товары в поле «Группа для новых товаров», в случае если загружаемые товары должны быть связаны с группой отличной от группы Товар.
7. Если вы обновляете информацию о существующих в каталоге товарах, укажите по какому полю сопоставлять товары в поле «Обновить по полю». Как правило, обновление информации по товарам проводят по полю «Код товара»
8. В поле «Файл импорта» выберите файл для которого вы формируете профиль и нажмите кнопку  «Загрузить».
9. После подгрузки файла нажмите кнопку «Передать заголовки».
10. Под кнопкой «Передать заголовки» вы увидите названия полей содержащиеся в загруженном файле.
11. Далее, необходимо сопоставить названия полей файла с названиями полей карточки товара. Т.е. указать какие значения из загружаемого файла в какие поля карточки товара попадут.
12. Для модуля «Импорт товаров из CommerceML» мы создали преднастроенный профиль импорта, который вы можете использовать в качестве примера.
13. Если значения каких-то полей из файла не надо загружать на сайте, выберите «Пропустить».
14. Нажмите кнопку «Сохранить».

Профиль импорта настроен! В закладке «Профили импорта» вы можете отредактировать или удалить ранее созданные профили или создать новые.

Обратите внимание! Вы всегда можете получить бесплатную консультацию по работе с сайтом и настройке модулей от службы поддержки платформы beSeller.

Как настроить загрузку данных на сайт?

Перед импортом товаров на сайт, сперва необходимо создать Профиль импорта!

Ручная загрузка файла

1. Для загрузки товаров перейдите во вкладку «Разделы и товары», далее «Импорт товаров», далее закладка «Импорт».
2. В поле «Файл» выберите на локальном компьютере файл, из которого вы планируете импортировать информацию о товарах.
3. В поле «Профиль» выберите ранее созданный профиль импорта.
4. В поле «Товары, отсутствующие в файле импорта» укажите, что необходимо сделать с товарами находящимися на сайте, но отсутствующими в файле.
5. Нажмите кнопку «Импорт».
6. Далее происходит проверка импортируемого прайс-листа на соответствие настройкам профиля и загрузка данных в базу данных и каталог сайта.
7. Если импорт прошел успешно вы увидите соответствующее уведомление, если будут ошибки, ячейки с некорректными данными помечаются красным цветом, при нажатии на ячейку можно увидеть комментарий с описанием ошибки.
8. Перейдите, в соответствующие разделы каталога, для дальнейшей работы с товарами.

Настройка автоматического импорта по ссылке

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