ОБМЕН С Купить модуль
Перед первым обменом: сделайте резервную копию базы 1С и базы данных сайта. Если товары уже существуют и в 1С, и в OpenCart, сначала выполните первичную привязку товаров. Не запускайте полную выгрузку поверх существующего каталога до привязки.

1. Сначала определите, какой у вас каталогнаверх

Первый запуск зависит не от размера магазина, а от того, где уже есть товары. Выберите свой случай:

Товары есть в 1С, сайт пустой

Привязка не нужна. Настройте каталог, сначала проверьте небольшую группу, затем выгружайте товары из 1С в OpenCart.

Товары есть на сайте, в 1С их нет

Загрузите товары из OpenCart в 1С. Обработка создаст номенклатуру и свяжет созданные позиции с товарами сайта.

Товары уже есть и в 1С, и на сайте

Сначала выполните первичную привязку. Это самый важный случай: без привязки одинаковый товар может быть воспринят как новая позиция.

Если товары есть в обеих системах: не начинайте с кнопки "Выгрузить товары" или "Полный обмен". Сначала перейдите к разделу "Связать существующие товары" ниже.
Для первого запуска используйте "Только проверка". Обработка выполнит проверку выбранной операции и покажет результат в журнале, но не изменит товары, цены, остатки, связи или документы.

2. Подготовьте подключениенаверх

  1. Установите и включите модуль на сайте.В панели администратора OpenCart откройте настройки модуля, включите его, создайте API-токен и при необходимости ограничьте доступ IP-адресом компьютера или сервера 1С.
  2. Откройте обработку Live 1C Exchange в 1С.На вкладке подключения укажите адрес API сайта и тот же токен. Адрес обычно выглядит так: https://ваш-сайт.ru/index.php?route=extension/module/live_1c_exchange/api.
  3. Разрешите обработке доступ к сайту.Если обработка просит разрешение на интернет-ресурс, нажмите Разрешить доступ к OpenCart и подтвердите адрес. При смене протокола, домена или порта разрешение нужно выдать заново.
  4. Нажмите "Проверить соединение".Если всё работает, сохраните настройки. Если нет - проверьте адрес API, токен, HTTPS и разрешённый IP.
API-токен - это пароль для обмена. Не публикуйте его и не присылайте в обычной переписке.

3. Если товары уже есть в 1С и OpenCart - сначала свяжите ихнаверх

Связь товара означает, что модуль запоминает: конкретная номенклатура в 1С и конкретный товар OpenCart - это одна и та же позиция.

Для первого поиска одинаковых товаров обработка сравнивает выбранное поле в 1С с выбранным полем OpenCart. После успешной привязки модуль сохраняет постоянную пару и дальше работает по ней. Поэтому SKU или Model не обязаны оставаться неизменными навсегда.

Что такое "Поле связи в 1С"

Это поле, значение которого обработка использует, чтобы один раз найти соответствующий товар на сайте. Можно выбрать Артикул, Код, Наименование, Полное наименование, обычный реквизит номенклатуры или дополнительный реквизит.

Отдельно выбирается "Поле связи OpenCart". В списке будут поля товара сайта, подходящие для поиска: например SKU, Model, название и другие доступные текстовые поля.

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

Что выбрать: SKU, Model или другое поле

ВариантКогда использовать
Артикул 1С - SKU OpenCartРекомендуемый стандартный вариант. Используйте, если артикулы заполнены в обеих системах, совпадают и у разных товаров не повторяются. Эта пара выбрана в обработке по умолчанию.
Код 1С - Model OpenCartИспользуйте, если при старом обмене или ручном заполнении именно код 1С сохранялся в Model товара OpenCart.
Артикул 1С - Model OpenCartПодходит, если артикул фактически хранится на сайте в Model, а поле SKU используется для другого значения или пустое.
Доп. реквизит 1С - SKU / Model / другое полеХороший вариант, если в обеих системах уже есть специальный общий идентификатор товара.
Наименование - названиеИспользуйте осторожно. Названия легко меняются, могут отличаться пробелами или написанием, а у нескольких товаров могут совпадать.

Как понять, какое поле выбрать

  1. Откройте один и тот же товар в 1С и OpenCart.Посмотрите Артикул и Код в 1С, затем SKU и Model на сайте.
  2. Найдите одинаковое значение.Например, в 1С Артикул = ABC-123, а на сайте SKU = ABC-123. Значит выбирайте "Артикул - SKU".
  3. Проверьте несколько товаров.Одного совпадения недостаточно. Убедитесь хотя бы на 10-20 разных позициях, что выбранная схема используется одинаково.
  4. Проверьте уникальность.Одно значение должно обозначать один товар. Если один и тот же SKU или Model стоит у нескольких товаров, такое поле нельзя безопасно использовать для массовой привязки.

Как выполнить первичную привязку

  1. Выберите "Поле связи в 1С" и "Поле связи OpenCart".Не ориентируйтесь только на названия полей - ориентируйтесь на реальные одинаковые значения.
  2. Включите "Только проверка".Обработка покажет, какие товары сможет связать, но ничего не изменит.
  3. Нажмите "Связать существующие товары".Посмотрите журнал и количество найденных, пропущенных и ошибочных позиций.
  4. Исправьте неоднозначности.Если по одному значению найдено несколько товаров, не используйте принудительную привязку наугад. Исправьте повторяющиеся значения или выберите другое поле.
  5. Выключите "Только проверка" и повторите привязку.Теперь модуль сохранит постоянные связи для найденных пар.
  6. Только после этого запускайте цены, остатки и карточки товаров.Для первого рабочего теста лучше взять небольшую группу товаров.

Что происходит после привязки

OpenCart сохраняет у себя соответствие между внешним идентификатором номенклатуры 1С и product_id товара сайта. Проще говоря, модуль уже знает, какой товар сайта относится к какой позиции 1С.

При последующих обменах не нужно снова искать товар по SKU или Model. Поле связи требуется главным образом для первоначального сопоставления и повторной привязки, если связь была удалена.

Что делать с товарами, которые не удалось связать

СитуацияЧто делать
Товар есть и в 1С, и на сайте, но совпадение не найденоПроверьте выбранные поля. Возможно, артикул хранится в Model вместо SKU, отличается формат значения или нужное поле пустое.
По значению найдено несколько товаровИсправьте дубли в поле связи или используйте более точное поле. Автоматически выбирать один из нескольких товаров небезопасно.
Товар есть только в 1СПосле завершения привязки существующих позиций его можно создать в OpenCart обычной выгрузкой товаров.
Товар есть только в OpenCartМожно оставить его локальным на сайте или загрузить в 1С, создать номенклатуру и затем получить постоянную связь.
Если часть товаров пропущена: посмотрите журнал. Он покажет, если у товаров не заполнено выбранное поле связи. Например, при варианте "Артикул - SKU" товар без артикула в 1С связать автоматически нельзя.
До окончания первичной привязки не включайте действия для отсутствующих товаров. Несвязанный товар, который физически уже есть на сайте, модуль ещё не может считать той же самой позицией из 1С.

4. Передайте новые товары из 1С на сайтнаверх

Этот сценарий подходит для пустого сайта или после того, как существующие товары уже связаны.

  1. Выберите товары.На вкладке "Отбор товаров" можно оставить весь каталог или ограничить выгрузку. Например, чтобы сначала проверить одну папку, выберите "Категория (группа)" и нужную группу номенклатуры. При необходимости можно включить и её подгруппы.
  2. Настройте основные данные.Укажите вид цены, склад, статус и другие значения, которые нужны вашему магазину.
  3. Настройте поля карточки.В "Соответствии полей" можно указать, откуда брать название, описание, SEO URL и мета-поля. Отдельно настраиваются атрибуты, языки и изображения.
  4. Настройте валюту и акции, если они используются.Дополнительные возможности включайте только если соответствующий плагин установлен и настроен.
  5. Сначала включите "Только проверка".Для первого теста выберите небольшую группу товаров. В журнале будет видно, что обработка собирается сделать, но на сайте ничего не изменится.
  6. Выключите проверку и повторите выгрузку.После этого откройте несколько карточек на сайте и проверьте название, категории, цену, количество, изображения и нужные характеристики.
  7. Отдельно передайте цены и остатки.Кнопки Выгрузить цены и Выгрузить остатки позволяют обновлять их без повторной передачи всей карточки товара.
Отбор действует не только на карточки товаров. Если вы выбрали одну группу для теста, тот же отбор используется при привязке, передаче цен и остатков.
Полный обмен используйте после проверки. Не включайте действие для отсутствующих товаров, если текущий отбор содержит только часть каталога.

5. Загрузите товары из OpenCart в 1Снаверх

Этот сценарий нужен, если магазин уже наполнен товарами, а в 1С соответствующей номенклатуры ещё нет или её нужно дополнить товарами сайта.

  1. Если одинаковые товары уже есть в 1С - сначала выполните привязку.Не создавайте вторую номенклатуру для товара, который уже существует. Используйте раздел "Связать существующие товары" выше.
  2. Откройте вкладку "Загрузка товаров".При необходимости ограничьте загрузку категориями OpenCart. ID категории можно увидеть в адресе её страницы в админке: category_id=....
  3. Выберите, включать ли подкатегории.Если нужна целая ветка каталога - включите подкатегории; если только одна точная категория - отключите.
  4. Выберите, какие данные нужно загрузить.Можно перенести основные данные товара, а при необходимости также дополнительные данные и изображения, если соответствующие настройки включены.
  5. Сначала включите "Только проверка".Начните с небольшой категории. Обработка покажет в журнале, какие товары будут созданы или обновлены в 1С, но пока ничего не изменит.
  6. Выключите "Только проверка" и загрузите товары.Для отсутствующих в 1С товаров обработка создаст номенклатуру, а для уже найденных обновит данные в соответствии с настройками.
  7. Проверьте результат в 1С.Откройте несколько карточек и проверьте название, артикул, код, группу и другие нужные данные.
Главное правило: цены и другие данные между системами надёжно передаются для уже связанных товаров. Если товар пропускается, сначала проверьте его связь.

6. Цены и остаткинаверх

Из 1С на сайт

Выберите нужный вид цены и нажмите Выгрузить цены. Для количества используйте Выгрузить остатки. Эти операции можно запускать отдельно от карточек товаров.

С сайта в 1С

На вкладке загрузки товаров выберите вид цены в 1С и нажмите Загрузить цены из OpenCart. Обработка загружает цену только для товаров, связь которых с номенклатурой 1С уже известна. Несвязанные товары пропускаются и отмечаются в журнале.

Если цена не загружается, сначала не меняйте настройки цены - проверьте, связан ли сам товар.

7. Получите заказы и отправьте статусынаверх

  1. Откройте вкладку "Заказы".Укажите дату начала и статусы OpenCart, которые нужно получать. Для первого теста выберите свежий тестовый заказ.
  2. Сначала включите "Только проверка".Посмотрите журнал и убедитесь, что заказ читается корректно. Документ в 1С в этом режиме не создаётся и не изменяется.
  3. Выключите "Только проверка" и выполните рабочую загрузку.Откройте созданный или обновлённый документ в 1С и проверьте покупателя, товары, сумму, доставку и оплату.
  4. Настройте обратную передачу статусов.Укажите, какой статус документа в 1С соответствует какому статусу OpenCart. После изменения состояния заказа используйте Выгрузить статусы заказов.
Загруженный заказ также получает свою постоянную связь. Поэтому повторная загрузка того же заказа предназначена для обновления, а не для создания нового документа.

8. Когда включать автообменнаверх

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

Что делатьПример частоты
Получать новые заказыКаждые 2-5 минут
Передавать статусы заказовОколо 5 минут
Передавать остатки и ценыКаждые 15-30 минут
Полный каталогПо необходимости; обычно значительно реже

Для обычной 1С автоматический запуск можно организовать средствами обработки, 1С или планировщиком Windows. В 1С:Фреш используется серверный запуск дополнительной обработки.

Какая кнопка нужнанаверх

КнопкаКогда использовать
Проверить соединениеПосле ввода или изменения адреса API, токена или настроек доступа.
Связать существующие товарыКогда один и тот же ассортимент уже есть и в 1С, и в OpenCart. Первый раз запускайте с "Только проверка".
Выгрузить товарыЧтобы создать новые товары на сайте или обновить уже связанные карточки из 1С.
Загрузить товары из OpenCartЧтобы создать или обновить номенклатуру в 1С по товарам сайта.
Выгрузить остатки / ценыКогда нужно передать на сайт только количество или стоимость из 1С.
Загрузить цены из OpenCartКогда базовые цены сайта нужно перенести в выбранный вид цен 1С.
Загрузить заказыЧтобы получить заказы OpenCart в 1С.
Выгрузить статусы заказовЧтобы передать изменение состояния заказа из 1С обратно на сайт.
Полный обменПосле первоначальной настройки и тестов. Не используйте первым действием для уже работающего каталога.
"Только проверка" - это безопасный пробный запуск. Используйте его перед первой привязкой, первой выгрузкой, загрузкой товаров и заказов. После проверки отключите режим и повторите ту же операцию.

Если что-то пошло не такнаверх

Соединение не устанавливается
Сверьте адрес API и токен. Проверьте HTTPS, разрешение обработки на доступ к сайту и ограничение по IP в OpenCart.
Не понимаю, что выбрать: SKU или Model
Откройте одинаковый товар в обеих системах и найдите поле с одинаковым уникальным значением. Если Артикул 1С равен SKU - выбирайте Артикул - SKU. Если Артикул равен Model - выбирайте Артикул - Model. Не выбирайте поле только потому, что у него "правильное" название.
Связано слишком мало товаров
Проверьте журнал. Он покажет, если у части товаров пустое выбранное поле связи. Также проверьте, действительно ли значения совпадают. Частые причины: пустые значения, старые артикулы, SKU хранится в Model или значения записаны по-разному.
При проверке найдено несколько товаров
Не включайте принудительную привязку без проверки. Найдите повторяющееся значение и исправьте его либо выберите другое поле связи.
После привязки изменили SKU или Model
Если постоянная связь уже сохранена, обычный обмен продолжает использовать её. Повторная привязка нужна только если связь была удалена или товар заменён другим.
Товар не появился на сайте
Откройте журнал. Проверьте отбор товаров, обязательные данные, режим "Только проверка" и наличие ошибок конкретной позиции.
Создались дубли товаров
Остановите массовую выгрузку. Если товары уже существовали в обеих системах, сначала восстановите правильные связи и только после этого продолжайте обмен.
Цена или остаток пропускаются
Сначала проверьте, связан ли товар. Цены и остатки привязываются к конкретной позиции через сохранённую связь.
Не загрузились заказы
Проверьте дату начала и выбранные статусы. Для теста создайте новый заказ на сайте и повторите операцию.
Нужна помощь
Обратитесь в поддержку и приложите журнал операции, пример товара или заказа и время запуска. API-токен присылать не нужно.