1. Сначала определите, какой у вас каталогнаверх
Первый запуск зависит не от размера магазина, а от того, где уже есть товары. Выберите свой случай:
Привязка не нужна. Настройте каталог, сначала проверьте небольшую группу, затем выгружайте товары из 1С в OpenCart.
Загрузите товары из OpenCart в 1С. Обработка создаст номенклатуру и свяжет созданные позиции с товарами сайта.
Сначала выполните первичную привязку. Это самый важный случай: без привязки одинаковый товар может быть воспринят как новая позиция.
2. Подготовьте подключениенаверх
- Установите и включите модуль на сайте.В панели администратора OpenCart откройте настройки модуля, включите его, создайте API-токен и при необходимости ограничьте доступ IP-адресом компьютера или сервера 1С.
- Откройте обработку Live 1C Exchange в 1С.На вкладке подключения укажите адрес API сайта и тот же токен. Адрес обычно выглядит так:
https://ваш-сайт.ru/index.php?route=extension/module/live_1c_exchange/api. - Разрешите обработке доступ к сайту.Если обработка просит разрешение на интернет-ресурс, нажмите и подтвердите адрес. При смене протокола, домена или порта разрешение нужно выдать заново.
- Нажмите "Проверить соединение".Если всё работает, сохраните настройки. Если нет - проверьте адрес API, токен, HTTPS и разрешённый IP.
3. Если товары уже есть в 1С и OpenCart - сначала свяжите ихнаверх
Связь товара означает, что модуль запоминает: конкретная номенклатура в 1С и конкретный товар OpenCart - это одна и та же позиция.
Для первого поиска одинаковых товаров обработка сравнивает выбранное поле в 1С с выбранным полем OpenCart. После успешной привязки модуль сохраняет постоянную пару и дальше работает по ней. Поэтому SKU или Model не обязаны оставаться неизменными навсегда.
Что такое "Поле связи в 1С"
Это поле, значение которого обработка использует, чтобы один раз найти соответствующий товар на сайте. Можно выбрать Артикул, Код, Наименование, Полное наименование, обычный реквизит номенклатуры или дополнительный реквизит.
Отдельно выбирается "Поле связи OpenCart". В списке будут поля товара сайта, подходящие для поиска: например SKU, Model, название и другие доступные текстовые поля.
Что выбрать: SKU, Model или другое поле
| Вариант | Когда использовать |
|---|---|
| Артикул 1С - SKU OpenCart | Рекомендуемый стандартный вариант. Используйте, если артикулы заполнены в обеих системах, совпадают и у разных товаров не повторяются. Эта пара выбрана в обработке по умолчанию. |
| Код 1С - Model OpenCart | Используйте, если при старом обмене или ручном заполнении именно код 1С сохранялся в Model товара OpenCart. |
| Артикул 1С - Model OpenCart | Подходит, если артикул фактически хранится на сайте в Model, а поле SKU используется для другого значения или пустое. |
| Доп. реквизит 1С - SKU / Model / другое поле | Хороший вариант, если в обеих системах уже есть специальный общий идентификатор товара. |
| Наименование - название | Используйте осторожно. Названия легко меняются, могут отличаться пробелами или написанием, а у нескольких товаров могут совпадать. |
Как понять, какое поле выбрать
- Откройте один и тот же товар в 1С и OpenCart.Посмотрите Артикул и Код в 1С, затем SKU и Model на сайте.
- Найдите одинаковое значение.Например, в 1С Артикул =
ABC-123, а на сайте SKU =ABC-123. Значит выбирайте "Артикул - SKU". - Проверьте несколько товаров.Одного совпадения недостаточно. Убедитесь хотя бы на 10-20 разных позициях, что выбранная схема используется одинаково.
- Проверьте уникальность.Одно значение должно обозначать один товар. Если один и тот же SKU или Model стоит у нескольких товаров, такое поле нельзя безопасно использовать для массовой привязки.
Как выполнить первичную привязку
- Выберите "Поле связи в 1С" и "Поле связи OpenCart".Не ориентируйтесь только на названия полей - ориентируйтесь на реальные одинаковые значения.
- Включите "Только проверка".Обработка покажет, какие товары сможет связать, но ничего не изменит.
- Нажмите "Связать существующие товары".Посмотрите журнал и количество найденных, пропущенных и ошибочных позиций.
- Исправьте неоднозначности.Если по одному значению найдено несколько товаров, не используйте принудительную привязку наугад. Исправьте повторяющиеся значения или выберите другое поле.
- Выключите "Только проверка" и повторите привязку.Теперь модуль сохранит постоянные связи для найденных пар.
- Только после этого запускайте цены, остатки и карточки товаров.Для первого рабочего теста лучше взять небольшую группу товаров.
Что происходит после привязки
OpenCart сохраняет у себя соответствие между внешним идентификатором номенклатуры 1С и product_id товара сайта. Проще говоря, модуль уже знает, какой товар сайта относится к какой позиции 1С.
При последующих обменах не нужно снова искать товар по SKU или Model. Поле связи требуется главным образом для первоначального сопоставления и повторной привязки, если связь была удалена.
Что делать с товарами, которые не удалось связать
| Ситуация | Что делать |
|---|---|
| Товар есть и в 1С, и на сайте, но совпадение не найдено | Проверьте выбранные поля. Возможно, артикул хранится в Model вместо SKU, отличается формат значения или нужное поле пустое. |
| По значению найдено несколько товаров | Исправьте дубли в поле связи или используйте более точное поле. Автоматически выбирать один из нескольких товаров небезопасно. |
| Товар есть только в 1С | После завершения привязки существующих позиций его можно создать в OpenCart обычной выгрузкой товаров. |
| Товар есть только в OpenCart | Можно оставить его локальным на сайте или загрузить в 1С, создать номенклатуру и затем получить постоянную связь. |
4. Передайте новые товары из 1С на сайтнаверх
Этот сценарий подходит для пустого сайта или после того, как существующие товары уже связаны.
- Выберите товары.На вкладке "Отбор товаров" можно оставить весь каталог или ограничить выгрузку. Например, чтобы сначала проверить одну папку, выберите "Категория (группа)" и нужную группу номенклатуры. При необходимости можно включить и её подгруппы.
- Настройте основные данные.Укажите вид цены, склад, статус и другие значения, которые нужны вашему магазину.
- Настройте поля карточки.В "Соответствии полей" можно указать, откуда брать название, описание, SEO URL и мета-поля. Отдельно настраиваются атрибуты, языки и изображения.
- Настройте валюту и акции, если они используются.Дополнительные возможности включайте только если соответствующий плагин установлен и настроен.
- Сначала включите "Только проверка".Для первого теста выберите небольшую группу товаров. В журнале будет видно, что обработка собирается сделать, но на сайте ничего не изменится.
- Выключите проверку и повторите выгрузку.После этого откройте несколько карточек на сайте и проверьте название, категории, цену, количество, изображения и нужные характеристики.
- Отдельно передайте цены и остатки.Кнопки и позволяют обновлять их без повторной передачи всей карточки товара.
5. Загрузите товары из OpenCart в 1Снаверх
Этот сценарий нужен, если магазин уже наполнен товарами, а в 1С соответствующей номенклатуры ещё нет или её нужно дополнить товарами сайта.
- Если одинаковые товары уже есть в 1С - сначала выполните привязку.Не создавайте вторую номенклатуру для товара, который уже существует. Используйте раздел "Связать существующие товары" выше.
- Откройте вкладку "Загрузка товаров".При необходимости ограничьте загрузку категориями OpenCart. ID категории можно увидеть в адресе её страницы в админке:
category_id=.... - Выберите, включать ли подкатегории.Если нужна целая ветка каталога - включите подкатегории; если только одна точная категория - отключите.
- Выберите, какие данные нужно загрузить.Можно перенести основные данные товара, а при необходимости также дополнительные данные и изображения, если соответствующие настройки включены.
- Сначала включите "Только проверка".Начните с небольшой категории. Обработка покажет в журнале, какие товары будут созданы или обновлены в 1С, но пока ничего не изменит.
- Выключите "Только проверка" и загрузите товары.Для отсутствующих в 1С товаров обработка создаст номенклатуру, а для уже найденных обновит данные в соответствии с настройками.
- Проверьте результат в 1С.Откройте несколько карточек и проверьте название, артикул, код, группу и другие нужные данные.
6. Цены и остаткинаверх
Из 1С на сайт
Выберите нужный вид цены и нажмите . Для количества используйте . Эти операции можно запускать отдельно от карточек товаров.
С сайта в 1С
На вкладке загрузки товаров выберите вид цены в 1С и нажмите . Обработка загружает цену только для товаров, связь которых с номенклатурой 1С уже известна. Несвязанные товары пропускаются и отмечаются в журнале.
7. Получите заказы и отправьте статусынаверх
- Откройте вкладку "Заказы".Укажите дату начала и статусы OpenCart, которые нужно получать. Для первого теста выберите свежий тестовый заказ.
- Сначала включите "Только проверка".Посмотрите журнал и убедитесь, что заказ читается корректно. Документ в 1С в этом режиме не создаётся и не изменяется.
- Выключите "Только проверка" и выполните рабочую загрузку.Откройте созданный или обновлённый документ в 1С и проверьте покупателя, товары, сумму, доставку и оплату.
- Настройте обратную передачу статусов.Укажите, какой статус документа в 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-токен присылать не нужно.