более 10 лет
более 10 лет
Перечень файлов участвующих в обменах
Несмотря на то, что на момент написания статьи (2018 год) современные версии модуля обмена данных способна выгружать 8 различных по назначению файлов, основными остались, хорошо нам известные, импорт и офферс, остальные файлы могут и не выгружаться, все зависит от настроек 1С, но я постараюсь детально рассмотреть все типы файлов выгрузки из 1С. В выгрузке присутствуют следующие файлы:
- import.xml - содержит данные о товарах, категориях (группах), типах цен, складах, свойствах товаров и единицах измерения;
- offers.xml - содержит данные о предложениях товаров (SKU/Характеристиках) и их свойствах;
- orders.xml - содержит данные о заказах;
- prices.xml - содержит данные о ценах предложений перечисленных в offers.xml;
- rests.xml - содержит данные о фактических остатках торговых предложений перечисленных в offers.xml;
- documents.xml - содержит информацию о документах прикрепленных к товарам;
- contragents.xml - содержит информацию о контрагентах;
- references.xml - содержит информацию о пользовательских справочниках затронутых в import.xml.
Файлы documents.xml, contragents.xml, references.xml используются крайне редко и структура их не слишком сложная для понимания, по этой причине не будем останавливаться на них, а лучше рассмотрим остальные файлы без которых обмен данными практически невозможен.
Обмен между 1С и Битрикс "Управление сайтом" происходит при помощи обмена файлами в формате XML построенными на основе CommerceML 2.xx. Все файлы выгружаются из 1с в папку на сайте /upload/1c_catalog/. Начнем рассматривать примеры файлов выгрузки в порядке очереди их обработки сайтом в момент обмена.
Первый файл выгружаемый 1с на сайт. Хранит все данные основного каталога товаров. Пример файла приведен ниже.
<КоммерческаяИнформация ВерсияСхемы="2.09" ДатаФормирования="2018-06-26T18:28:09">
<Каталог СодержитТолькоИзменения="true">
<Ид>12345678-ABCD-123A-4567-8910E1234DF5</Ид>
<ИдКлассификатора>12345678-ABCD-123A-4567-8910E1234DF5</ИдКлассификатора>
<Наименование>Каталог товаров</Наименование>
<Товары>
<Товар>
<Ид>XML-ID - Товара A</Ид>
<НомерВерсии>AAAAAQAAAHI=</НомерВерсии>
<ПометкаУдаления>false</ПометкаУдаления>
<Штрихкод/>
<Артикул/>
<Наименование>Название товара</Наименование>
<БазоваяЕдиница>10</БазоваяЕдиница>
<Группы>
<Ид>XML-ID - Категории товара</Ид>
</Группы>
<Описание/>
<Страна/>
<ЗначенияСвойств>
<ЗначенияСвойства>
<Ид>XML-ID - Свойства A</Ид>
<Значение/>
</ЗначенияСвойства>
<ЗначенияСвойства>
<Ид>XML-ID - Свойства B</Ид>
<Значение/>
</ЗначенияСвойства>
<ЗначенияСвойства>
<Ид>XML-ID - Свойства C</Ид>
<Значение/>
</ЗначенияСвойства>
</ЗначенияСвойств>
<СтавкиНалогов>
<СтавкаНалога>
<Наименование>НДС</Наименование>
<Ставка>12</Ставка>
</СтавкаНалога>
</СтавкиНалогов>
<ЗначенияРеквизитов>
<ЗначениеРеквизита>
<Наименование>ВидНоменклатуры</Наименование>
<Значение>Материал</Значение>
</ЗначениеРеквизита>
<ЗначениеРеквизита>
<Наименование>ТипНоменклатуры</Наименование>
<Значение>Товар</Значение>
</ЗначениеРеквизита>
</ЗначенияРеквизитов>
<Вес>0</Вес>
</Товар>
</Товары>
<Описание>Описание каталога</Описание>
</Каталог>
</КоммерческаяИнформация>
Не зависимо от типа файла он будет содержать в структуре ряд общих элементов и ряд уникальных, присущих только данному виду файла. К общим элементам относятся:
- <КоммерческаяИнформация> - Верховный элемент в который входят все остальные. Содержит версию схемы обмена, дату формирования и иную служебную информацию.
- <ПакетПредложений> - Содержит данные о предложениях.
- <Ид> - Уникальный идентификатор пакета предложений. Обязательно наличие символа # для связи с инфоблоком товаров.
- <Наименование> - Название.
- <ИдКаталога> - Уникальный идентификатор каталога, пакет предложений которого прислан.
- <ИдКлассификатора> - Уникальный идентификатор классификатора, который относится к пакету предложений.
- <Предложения> - Головной элемент информации о предложениях товаров.
- <Предложение> - Элемент содержит данные отдельного предложения элемента.
- <Ид> - Идентификатор предложения. В отдельных случаях может иметь формат: <ид_товара>#<ид_элемента>
Уникальные для файла импорта:
- <Группы> - Элемент содержит информацию о группах (разделах) товаров.
- <Группа> - Элемент содержит описание группы элемента.
- <Ид> - Уникальный идентификатор группы (раздела).
- <НомерВерсии> - Номер версии элемента группы (раздела).
- <ПометкаУдаления> - Признак того, что элемент должен быть деактивирован.
- <Наименование> - Наименование группы (раздела).
- <Группы> - Подчиненный элемент, который хранит информацию о подчиненных группах.
- <Свойства> - Элемент содержит информацию о свойствах товаров.
- <Свойство> - Элемент содержит описание свойства элемента.
- <Ид> - Уникальный идентификатор свойства.
- <НомерВерсии> - Номер версии свойства.
- <ПометкаУдаления> - Признак того, что элемент должен быть деактивирован.
- <Наименование> - Наименование свойства.
- <Ид> - Уникальный идентификатор товара.
- <НомерВерсии> - Номер версии товара.
- <ПометкаУдаления> - Признак того, что элемент должен быть деактивирован.
- <Артикул> - Артикул товара.
- <Наименование> - Наименование товара.
- <Описание> - Описание товара, попадающее в подробное описание товара.
- <Картинка> - Элемент содержит информацию о картинках товара. Первый элемент является основной картинкой.
- <БазоваяЕдиница> - Единица измерения товара.
- <Группы> - Элемент содержит информацию о группах (разделах), в которых товар находится.
- <Ид> - Идентификатор группы (раздела) товара.
- <Изготовитель> - Элемент содержит информацию о изготовителе товара.
- <Вес> - Вес товара.
- <Ид> - Идентификатор изготовителя.
- <Наименование> - Наименование производителя.
- <ОфициальноеНаименование> - Официальное наименование производителя.
- <ЗначенияСвойств> - Элемент содержит информацию о свойствах товаров.
- <ЗначенияСвойства> - Элемент содержит описание свойства товара.
- <Ид> - Идентификатор свойства.
- <Значение> - Значение свойства.
- <СтавкиНалогов> - Элемент содержит информацию о налогах товаров.
- <СтавкаНалога> - Элемент содержит описание налога товара.
- <Наименование> - Наименование налога.
- <Ставка> - Ставка налога.
- <ЗначенияРеквизитов> - Элемент содержит информацию о дополнительных данных товара.
Есть предопределенные значения:
- Файл - содержит информацию о местонахождении приложенного файла;
- ОписаниеФайла - описание файла или картинки. Формат: <адрес картинки>#<описание>;
- Вес - вес товара;
- ОписаниеВФорматеHTML - содержит описание товара в формате HTML;
- Полное наименование - информация о анонсе товара.
- <ЗначениеРеквизита> - Элемент содержит описание дополнительной информации товара.
- <Наименование> - Наименование реквизита.
- <Значение> - Значение реквизита.
Возможные дополнительные элементы:
- <ТипыЦен> - Элемент содержит информацию о типах цен товаров.
- <ТипЦены> - Элемент содержит описание типа цены элемента.
- <Ид> - Уникальный идентификатор типа цены.
- <НомерВерсии> - Номер версии типа цены.
- <ПометкаУдаления> - Признак того, что элемент должен быть деактивирован.
- <Наименование> - Наименование типа цены. Наименование типа цены должно быть уникально, иначе новое не добавится.
- <Валюта> - Валюта типа цены.
- <Налог> - Описание налогов для типа цены.
- <Наименование> - Наименование налога.
- <УчтеноВСумме> - Признак того, включен ли налог в стоимость товара.
- <Склады> - Элемент содержит информацию о складах товаров.
- <Склад> - Элемент содержит описание склада элемента.
- <Ид> - Уникальный идентификатор склада.
- <НомерВерсии> - Номер версии склада.
- <ПометкаУдаления> - Признак того, что элемент должен быть деактивирован.
- <Наименование> - Наименование склада.
После обновления модуля обмена в этом файле представлена только основная информация относящаяся только к самим элементам, а цены, остатки и пр. вынесены в отдельные файлы. Пример файла приведен ниже
<КоммерческаяИнформация ВерсияСхемы="2.09" ДатаФормирования="2018-06-26T18:28:09">
<ПакетПредложений СодержитТолькоИзменения="true">
<Ид>12345678-ABCD-123A-4567-8910E1234DF5#</Ид>
<Наименование>Пакет предложений</Наименование>
<ИдКаталога>12345678-ABCD-123A-4567-8910E1234DF5</ИдКаталога>
<ИдКлассификатора>12345678-ABCD-123A-4567-8910E1234DF5</ИдКлассификатора>
<Предложения>
<Предложение>
<Ид>XML-ID - SKU - Предложения A</Ид>
<НомерВерсии>oQAAAAE=</НомерВерсии>
<ПометкаУдаления>false</ПометкаУдаления>
<Наименование>Название предложения - Например цвет - Белый</Наименование>
<ХарактеристикиТовара/>
<ЗначенияСвойств>
<ЗначенияСвойства>
<Ид>XML-ID - Свойства А</Ид>
<Значение>XML-ID - Значения B свойства А</Значение>
</ЗначенияСвойства>
</ЗначенияСвойств>
</Предложение>
<Предложение>
<Ид>XML-ID - SKU - Предложения B</Ид>
<НомерВерсии>oAAAAAEAAAA=</НомерВерсии>
<ПометкаУдаления>false</ПометкаУдаления>
<Наименование>Название предложения - Например цвет - Бежевый</Наименование>
<ХарактеристикиТовара/>
<ЗначенияСвойств>
<ЗначенияСвойства>
<Ид>XML-ID - Свойства А</Ид>
<Значение>XML-ID - Значения С свойства А</Значение>
</ЗначенияСвойства>
</ЗначенияСвойств>
</Предложение>
</Предложения>
</ПакетПредложений>
</КоммерческаяИнформация>
- <НомерВерсии> - Номер версии предложения.
- <ПометкаУдаления> - Признак того, что элемент должен быть деактивирован.
- <ЗначенияСвойств> - Элемент содержит информацию о свойствах предложений.
- <ЗначенияСвойства> - Элемент свойства предложения.
- <Ид> - Идентификатор предложения.
- <Значение> - Значение предложения.
Возможные дополнительные элементы:
- <Свойства> - Элемент содержит информацию о свойствах товаров.
- <Свойство> - Элемент содержит описание свойства элемента.
- <Ид> - Уникальный идентификатор свойства.
- <НомерВерсии> - Номер версии свойства.
- <ПометкаУдаления> - Признак того, что элемент должен быть деактивирован.
- <Наименование> - Наименование свойства.
- <Внешний> - Признак того, что свойство типа справочник и должно хранится в highload-инфоблоке. Если хранит файл или изображение должен принимать значение true.
- <Информационное> - Признак того, что свойство влияет на цену.
- <ТипЗначений> - Тип значения свойства. Тип значения может быть: Строка, Число, Время, Справочник.
- <ВариантыЗначений> - Элемент содержит информацию о вариантах значений, если тип свойства Справочник.
- <Справочник> - Элемент содержит описание варианта значений свойства.
- <ИдЗначения> - Идентификатор варианта значения свойства.
- <Значение> - Значение варианта значения свойства.
- <Картинка> - Адрес файла изображения, если значение свойства хранит картинку.
- <Штрихкод> - Штрих-код предложения.
- <ХарактеристикиТовара> - Элемент содержит информацию о строковых свойствах предложений.
- <ХарактеристикаТовара> - Элемент множественного строкового свойства предложений.
- <Наименование> - Наименование свойства.
- <Значение> - Значение.
- <Комплектующие> - Элемент содержит информацию о комплектующих предложениях.
- <Комплектующее> - Элемент, содержащий информацию о комплектующем предложении.
- <Ид> - Идентификатор комплектующего.
- <Наименование> - Наименование комплектующего.
- <Количество> - Количество товара.
- <ЗначенияРеквизитов> - Элемент содержит информацию о дополнительных данных в предложениях.
- <ЗначениеРеквизита> - Элемент содержит описание дополнительной информации товара.
- <Наименование> - Наименование реквизита.
- <Значение> - Значение реквизита.
Файл содержит информацию о текущих ценах предложений в разрезе всех типов цен на сайте. Пример файла приведен ниже
<КоммерческаяИнформация ВерсияСхемы="2.09" ДатаФормирования="2018-06-26T18:28:09">
<ПакетПредложений СодержитТолькоИзменения="true">
<Ид>12345678-ABCD-123A-4567-8910E1234DF5#</Ид>
<Наименование>Пакет предложений</Наименование>
<ИдКаталога>12345678-ABCD-123A-4567-8910E1234DF5</ИдКаталога>
<ИдКлассификатора>12345678-ABCD-123A-4567-8910E1234DF5</ИдКлассификатора>
<Предложения>
<Предложение>
<Ид>XML-ID - SKU - Предложения</Ид>
<Цены>
<Цена>
<Представление>15 155 грн за шт</Представление>
<ИдТипаЦены>XML-ID - Типа цены А</ИдТипаЦены>
<ЦенаЗаЕдиницу>15155</ЦенаЗаЕдиницу>
<Валюта>UAH</Валюта>
</Цена>
<Цена>
<Представление>30 300 руб за шт</Представление>
<ИдТипаЦены>XML-ID - Типа цены В</ИдТипаЦены>
<ЦенаЗаЕдиницу>30300</ЦенаЗаЕдиницу>
<Валюта>руб</Валюта>
</Цена>
</Предложение>
</Предложения>
</ПакетПредложений>
</КоммерческаяИнформация>
- <Цены> - Элемент содержит информацию о ценах предложения товара.
- <Цена> - Элемент содержит описание цены предложения товара.
- <Представление> - Представление цены (на сайте не используется).
- <ИдТипаЦены> - Уникальный идентификатор (внешний код) - типа цены.
- <ЦенаЗаЕдиницу> - Цена за единицу товара. <Валюта> - Валюта цены.
Файл передает остатки товаров на складах, именно этим файлом заканчивается процедура и только он остается в папке обмена до следующего сеанса связи (если вы не настроили сохранение всех переданых файлов на стороне сайта Отладка обмена с 1с (сохранение файлов обмена)) . Пример файла приведен ниже
<КоммерческаяИнформация ВерсияСхемы="2.09" ДатаФормирования="2018-06-26T18:28:09">
<ПакетПредложений СодержитТолькоИзменения="true">
<Ид>12345678-ABCD-123A-4567-8910E1234DF5#</Ид>
<Наименование>Пакет предложений</Наименование>
<ИдКаталога>12345678-ABCD-123A-4567-8910E1234DF5</ИдКаталога>
<ИдКлассификатора>12345678-ABCD-123A-4567-8910E1234DF5</ИдКлассификатора>
<Предложения>
<Предложение>
<Ид>XML-ID - SKU - Предложения</Ид>
<Остатки>
<Остаток>
<Склад>
<Ид>XML-ID - Склада</Ид>
<Количество>1</Количество>
</Склад>
</Остаток>
</Остатки>
</Предложение>
</Предложения>
</ПакетПредложений>
</КоммерческаяИнформация>
- <Остаток> - Элемент содержит данные об остатках отдельного предложения в разрезе складов.
- <Количество> - Остаток по всем складам.
- <Склад> - Данные о складе и остатке предложения на нем.
- <Ид> - Уникальный идентификатор склада.
- <Количество> - Остаток предложения в разрезе склада.
Файл с данными заказов. Бывает двух видов - сформированный на стороне сайта и забираемый 1С и сформированный 1С и отправляющий на сайт информацию о изменениях в заказах в случае их проведения на стороне 1С после прошлого обмена. В частности, текущий статус заказа после ухода с сайта в 1С.
Для просмотра файла на стороне сайта в том же виде, в котором его увидит 1С достаточно авторизоваться пользователем (группе которого доступны операции обмена с 1С ) и перейти на страницу:
http://ВАШ_САЙТ/bitrix/admin/1c_exchange.php?type=sale&mode=query#authorize
Всё это и многое другое у нас в рассылке, подпишись, чтобы получать прямо в браузере
Концентрат
полезных статей
МЫ собрали для вас самые полезные сервисы, которые упростят работу с сайтом и помогут сделать его удобнее для пользователей.
- 300
- 1 мин
Любое учреждение культуры предоставляет услуги. Значит, оно должно давать пользователям возможность выразить свое мнение о заведении. Это может быть баннер или ссылка, ведущие на сайт системы оценки качества услуг.
- 121
- 5 мин
Что скрывается за понятием “Ведение контекстной рекламы”, так как часто сталкиваюсь с непониманием, из чего складываются трудоемкость этой услуги, что в нее входит и зачем она нужна.
- 149
- 10 мин
При расчете стоимости на наши профильные продукты, где опыт и компетенция нашей команды позволяет получить результат быстро и с первого раза, мы применяем ставку часа специалиста в 3000 рублей.
- 210
- 4 мин