Инструкция: обмен данными Virtuality CMS с 1С.

1.Плагин.

Его устанавливать не нужно. Он предустановлен в нашей системе.

2.Настройте обмен данными.

Зайдите в раздел «Импорт/экспорт → 1С» и включите автоматический обмен данными. После включения активируется скрипт синхронизации.

Скопируйте адрес скрипта синхронизации из текстового поля — он потребуется для настройки синхронизации на стороне «1С».

Настройка складов

В разделе "Настройки -> Склады" настройте параметр "Обновление склада" на "Не обновляется действиями с заказами". Это означает, что управление складскими остатками полностью осуществляется на стороне "1С", и интернет-магазин не должен обновлять их. В этом случае остатки будут обновляться только во время обмена данными с "1С".

Определение типов цен

В настройках плагина укажите соответствующие данные для вашей системы "1С", если они отличаются от предопределенных значений по умолчанию:

• Тип цены для продаж: Розничная
• Идентификатор типа цены для продаж в системе "1С"
• Тип цены для закупок: Закупочная
• Идентификатор типа цены для закупок в системе "1С"

Экспорт заказов

Для экспорта информации о заказах в «1С» необходимо установить определенные параметры:

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

Импорт товаров.

• Обновление свойств товаров при импорте: выберите, какие свойства должны быть обновлены для уже существующих товаров в магазине VirtualityCMS
•  в процессе синхронизации с "1С". 
• Импорт значений характеристик товаров: выберите, должны ли значения характеристик быть обновлены в магазине для всех товаров или только для тех, которые участвуют в текущей сессии обмена данными.
• Импорт значений характеристик артикулов: выберите, должны ли значения характеристик с форматом "Выбор нескольких значений из списка" быть импортированы в свойства артикулов товаров.
• Импорт наименования артикула: выберите вариант "Наименование предложения".
• Формирование уникальных URL для импортируемых товаров: включите эту настройку для создания уникальных URL для импортированных товаров.
• Категории товаров при импорте: выберите, как информация о категориях товаров должна быть импортирована из "1С" в CMS систему.
• Обновление свойств категорий при импорте: при синхронизации с "1С" выберите, какие свойства следует обновлять для существующих категорий товаров 
• Импорт типов товаров: выберите подходящий вариант импорта типов товаров. Проверка существования типа товаров осуществляется только по названию. 
• Тип товаров по умолчанию: выберите тип товаров по умолчанию, к которому будут отнесены товары, импортированные из "1С", при использовании соответствующих вариантов предыдущей настройки "Импорт типа товаров". 
• Скрытие новых товаров при импорте: включите эту настройку, чтобы новые товары, импортированные из "1С", не были сразу опубликованы на сайте. Они будут иметь статус "Скрыт с сайта", т.е. не будут отображаться на витрине интернет-магазина. Это удобно для подготовки новых товаров к публикации и изменения их статуса на "Опубликован на сайте". 
• Обработка специальных символов в описаниях товаров: включите эту настройку, если в описаниях товаров нужно отображать специальные символы (например, угловые скобки < и >), которые не используются в HTML-тегах.
• Единица измерения: если вы используете единицу измерения в "1С", введите в это поле код характеристики VirtualityCMS, в которую будут импортироваться значения единицы измерения ваших товаров. Если не нужно импортировать единицы измерения товаров, оставьте это поле пустым.

Валюта

• Выбор основной валюты: определите валюту, которая будет использоваться в вашем аккаунте «1С». Если вы выберете другую валюту, цены на товары при импорте будут конвертированы с помощью курса CMS.
• Код валюты: введите значение поля «Наименование» для национальной валюты расчета, указанное в настройках «1С».

Управление складскими остатками

• Для настройки импорта складских остатков из "1С" в интернет-магазин в разделе CommerceML необходимо выбрать соответствующие параметры.
• При выборе склада, для которого должны импортироваться складские остатки товаров, можно указать импорт этих данных в общее свойство товара "На складе", не привязанное к какому-либо отдельному складу.
• Если включить настройку "Создавать новые артикулы с нулевыми остатками", при каждом обмене данными будут устанавливаться нулевые значения на складе для всех вновь импортируемых артикулов товаров. Это действует только на тех складах интернет-магазина, для которых не выбрано соответствие складам "1С". Если настройку отключить, то остатки на несопоставленных складах будут сохраняться бесконечными (незаполненными).
• Если включить настройку "Обнулять остатки в несинхронизированных складах", при каждом обмене данными будет устанавливаться нулевое значение для всех товаров магазина на тех складах интернет-магазина, для которых не выбрано соответствие складам "1С". Если настройку отключить, то никакие дополнительные действия не выполняются.
• Если в файле с информацией о товарах содержатся коды артикулов, которые нужно импортировать в интернет-магазин, необходимо включить настройку "Получать код артикула из информации о товарах".
• Также необходимо выбрать кодировку файлов, которые формирует ваша система учета для обмена данными с интернет-магазином, чтобы обмен данными был успешно выполнен.

3. Настройк обмена данными на стороне “1С”

Вот подробная инструкция по настройке обмена данными на стороне «1С: Управление торговлей»:

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

• Для параметра «Использование соглашений с клиентами» выберите «Типовые и индивидуальные соглашения».
• Включите параметр «Договоры с клиентами».
• Убедитесь, что включен параметр «Заказы клиентов».

7. В разделе «НСИ и администрирование → Настройка разделов → Склад»:

• Убедитесь, что включен параметр «Склады».
• Установите соответствие между складами в программе «1С:Управление торговлей» и складами в интернет-магазине в разделе «Соответствие складов».
• Установите соответствие между номенклатурой в программе «1С:Управление торговлей» и товарами в интернет-магазине в разделе «Соответствие товаров».

8. В разделе «НСИ и администрирование → Настройка интернет-магазина»:

• Включите параметр «Вести учет количества товаров на складах».
• Установите соответствие между способами оплаты в интернет-магазине и формами оплаты в программе «1С:Управление торговлей» в разделе «Соответствие форм оплаты».
• Установите соответствие между способами доставки в интернет-магазине и способами доставки в программе «1С:Управление торговлей» в разделе «Соответствие способов доставки».
• Установите соответствие между типами цен в программе «1С:Управление торговлей» и типами цен в интернет-магазине в разделе «Соответствие типов цен».

Экспорт файлов CommerceML

Для настройки соответствия между характеристиками товаров и складами в программе "1С" и VirtualityCMS необходимо экспортировать каталог товаров в файлы формата CommerceML и выполнить их ручной анализ в бэкенде VirtualityCMS. После того, как соответствие будет настроено вручную, оно будет использоваться при автоматической синхронизации в дальнейшем.

5. Включите автоматический обмен данными в настройках «1С»

6. Готово

Ваш интернет-магазин настроен для обмена данными с «1С»!

Что умеет 1С?

1. Программа "1С" может экспортировать в файл формата CommerceML информацию о товарах и заказах для передачи в VirtualityCMS, однако VirtualityCMS принимает только данные о товарах и не обновляет заказы, а "1С" может импортировать из файла только информацию о заказах, но не о товарах.
2. При обмене данными вручную через файл, можно выбрать, экспортировать ли в "1С" только новые (и обновленные) заказы с момента последнего экспорта, либо экспортировать все имеющиеся заказы. При автоматическом обмене экспортируются только заказы, обновленные с момента последнего экспорта. В случае обмена данными о товарах всегда экспортируется весь каталог продукции.
3. При автоматическом обмене "1С" выгружает товары (номенклатуру) в файл, однако не принимает ее обратно. При автоматическом обмене "1С" принимает только данные о заказах, и поэтому до настройки обмена данными о заказах рекомендуется импортировать всю номенклатуру из магазина в "1С" через файл - это единственный способ импорта товаров, который поддерживается в "1С".

Полная выгрузка

Для автоматического обмена данными в программе «1С» по умолчанию инициируется обмен только измененными данными о заказах и товарах. Однако, это может привести к проблеме, когда товары не выгружаются из «1С» и появляется сообщение «Изменения товаров не зарегистрированы. Выгрузка товаров не произведена».

Для решения данной проблемы необходимо в настройках обмена данными (раздел «Сервис → Обмен данными с WEB-сайтом → Настроить обмен данными с WEB-сайтом») установить опцию «Полная выгрузка» и сохранить настройки. Таким образом, будет осуществляться полная выгрузка всех данных о товарах и заказах, а не только измененных, что позволит избежать проблемы с выгрузкой товаров из «1С».

После сохранения настроек обмена данными с опцией «Полная выгрузка» в «1С», программа будет отправлять в магазин полный каталог товаров. Если в вашем каталоге содержится много товаров, то достаточно выполнить обмен данными один раз, чтобы выгрузить все товары из «1С» в магазин. После этого можно вернуть обратно значение «Только изменения», чтобы избежать передачи избыточной информации в файле обмена.

Сопоставление товаров по идентификатору CommerceML

Обмен данными между системами использует специальный внутренний ключ - идентификатор CommerceML для идентификации товаров, категорий и заказов. Каждый товар в списке номенклатуры в «1С» имеет такой идентификатор, в то время как в CMS его нет до первой операции импорта/экспорта.

Дубликаты товаров

При импорте товаров из «1С» в CMS систему может возникнуть проблема дублирования записей. Это может произойти, если товары и категории уже есть в базе данных магазина, но еще не были связаны с номенклатурой 1С. Решение этой проблемы заключается в объединении дублирующихся записей, таким образом, чтобы основным товаром оставался дубликат, имеющий идентификатор CommerceML.

Смена адреса автоматического обмена.

Если вам необходимо изменить адрес скрипта автоматического обмена данными, можно выключить и затем снова включить обмен данными в настройках вашего магазина. Это приведет к генерации нового адреса скрипта синхронизации. Обратите внимание, что пароль и имя пользователя могут быть закодированы в адресе скрипта синхронизации.

Формирование названий товаров и артикулов.

При импорте товаров из внешней системы в название товара могут быть включены элементы из файла каталога товаров, такие как содержимое элемента <Наименование>...</Наименование>.

Название артикула может быть сформировано из значения элемента <Наименование>...</Наименование> в файле с информацией об остатках.

Код артикула может быть сформирован из значения элемента <Артикул></Артикул> в файле с информацией об остатках.

Выбор типа контрагента покупателя при экспорте заказов в «1С»

По умолчанию информация о покупателе экспортируется как о физическом лице. Для экспорта информации о покупателе как о юридическом лице необходимо выбрать соответствующее контактное поле покупателя в настройках плагина. Доступные поля настраиваются в разделе «Настройки → Оформление заказа». Если поле не заполнено при оформлении заказа, информация о покупателе будет экспортироваться как о физическом лице.

Импорт остатков товаров для нескольких складов

Для импорта остатков для нескольких складов необходимо выполнить ручной импорт файла offers.xml и указать соответствие между складами, указанными в файле, и складами, настроенными в интернет-магазине в разделе «Настройки → Склады». При этом бесконечные значения остатков некоторых артикулов товара для отдельных складов запишут бесконечные складские остатки для всего товара. Чтобы этого не происходило, необходимо включить параметры «Создавать новые артикулы с нулевыми остатками» и «Обнулять остатки в несинхронизированных складах» в настройках плагина.

Импорт описания товара.

Импорт описаний товаров включает импорт реквизита <Описание> в полное и краткое описание товара, а также импорт реквизита «Полное наименование» в краткое описание товара, перезаписывая информацию из стандартного реквизита <Описание>. Однако, при импорте CommerceML-файлов можно изменить этот процесс, выбрав импорт реквизита «Полное наименование» в полное или краткое описание товара, игнорирование этого реквизита, или импорт дополнительного реквизита в полное описание товара, который должен быть предварительно настроен и заполнен в «1С».

Как обнулять складские остатки

Если система учёта не отправляет пустое количество на складе:

• Включите настройку «Обнулять складские остатки при отсутствии значений в файле обмена».
• Плагин автоматически установит количество на складе, равное нулю, если значение не отправлено системой учёта при отсутствии товара.

Как получать информацию об артикулах из файла с товарами

• Чаще всего информация об артикулах содержится в файле с предложениями.
• В названии такого файла обычно используется слово offers.
• Некоторые системы учёта выгружают информацию об артикулах в файле с товарами, в названии которого обычно используется слово import.
• Для адаптации к такому формату файлов, включите настройку «Получать код артикула из информации о товарах».

Как импортировать значения характеристик для артикулов товаро:

• В свойствах артикулов товаров можно редактировать значения характеристик, для которых включена такая возможность в разделе «Настройки → Типы и характеристики товаров».
• Такие значения для артикулов товаров можно получать из системы учёта.
• Для этого в настройке «Импорт значений характеристик артикулов» выберите значение «Импортировать».
• Если выбрать «Не импортировать», то значения характеристик будут импортироваться только для товаров, но не для их отдельных артикулов.

Как автоматически скрывать товары на удаление

• Включите настройку «Обновлять статус импортированных товаров», чтобы плагин мог устанавливать нужный статус видимости для товаров, информацию о которых получает от системы учёта. Товары, помеченные на удаление, будут автоматически скрыты на витрине.

Решение проблем

• Если не обновляется информация о заказах, измените значение настройки «Кодировка данных для передачи информации о товарах и заказах».
• Если заказы не импортируются в «1С», выключите настройку «Контроль уникальности рабочего наименования номенклатуры и характеристик» в «1С».