Интеграция с интернет-магазином OpenCart 2.x по API.

Интеграция позволяет:

- выгружать товары из Бизнес.Ру в OpenCart;
- загружать заказы из OpenCart в Бизнес.Ру.
Выгрузка товаров и загрузка заказов возможны как в ручном режиме, так и в автоматическом с заданным периодом.


Интеграция по API возможна для OpenCart 2.1.х.х и OpenCart 2.0.х.х

Перед началом работы настоятельно рекомендуем сделать резервную копию интернет-магазина.

Для интеграции необходимо установить модуль Бизнес.Ру (инструкции по установке ниже).

Актуальная версия модуля Бизнес.Ру


1. Установка дополнительного модуля в OpenCart:

- если к серверу, на котором размещен Ваш интернет-магазин, нет доступа по FTP;

- если к серверу, на котором размещен Ваш интернет-магазин, есть доступ по FTP.


1.1 Установка модуля, если к серверу, на котором размещен Ваш интернет-магазин, нет доступа по FTP

1.1.1 Скачайте модуль QuickFix https://www.opencart.com/index.php?route=marketplace/extension/info&extension_id=18892

1.1.2 Извлеките из скачанного архива файл «localcopy.ocmod.xml»

1.1.3 В панели администратора OpenCart зайдите в Extensions\Extensions installer, нажмите кнопку «Upload» и выберите файл «localcopy.ocmod.xml» из пункта 1.1.2.


1.1.4 В панели администратора OpenCart зайдите в Extensions\Modifications и нажмите кнопку обновления


1.1.5 Скачайте актуальную версию модуля Бизнес.Ру (ссылка в начале инструкции)

1.1.6 В панели администратора OpenCart зайдите в Extensions\Extensions installer, нажмите кнопку «Upload» и выберите файл «class365.ocmod.zip» из пункта 1.1.5, нажмите «Continue».


1.2 Установка модуля, если к серверу, на котором размещен Ваш интернет-магазин, есть доступ по FTP

1.2.1 Скачайте актуальную версию модуля Бизнес.Ру (ссылка в начале инструкции)

1.2.2 Извлеките из архива «class365.ocmod.zip» папку «catalog» и загрузите ее в корневой каталог Вашего сайта.


2. Настройка интеграции в OpenCart

2.1 Если Вы хотите настроить интеграцию с OpenCart 2.1.х.х, то в панели администратора OpenCart:

- зайдите в System\Users\API,

- найдите API с именем Default, - нажмите на кнопку редактирования.


В открывшейся странице зайдите во вкладку «IP addresses» и нажмите на кнопку «+»

В поле «IP» введите «185.70.104.79» и нажмите на кнопку сохранения.


3. Настройка интеграции в Бизнес.Ру

3.1 В Бизнес.Ру зайдите в Администрирование\Интеграции, импорт и экспорт\Подключение интернет-магазинов, кликните «Добавить интернет-магазин», выберите «Openсart 2.х API». Откроется форма интеграции с интернет-магазином.


3.2 Проверка связи с интернет-магазином

3.2.1 Заполняем поля:

«Наименование» - название Вашего интернет-магазина

«Адрес сайта» - URL адрес Вашего интернет-магазина


3.2.2 Если Вы хотите настроить интеграцию с OpenCart 2.1.х.х

Заполняем поля:

«Версия OpenCart» - выбираем «от 2.1»


«Ключ соединения» - ключ из OpenCart, который можно получить следующим образом.

В панели администратора OpenCart:

- зайдите в System\Users\API,

- найдите API с именем Default, - нажмите на кнопку редактирования.


Во вкладке «General» скопируйте содержимое поля «API key» и вставьте в поле «Ключ соединения» формы интеграции в Бизнес.Ру.


3.2.3 Если Вы хотите настроить интеграцию с OpenCart 2.0.х.х

Заполняем поля: «Версия OpenCart» - выбираем «2.0.х»


Значения для полей «Логин» и «Пароль» можно получить следующим образом.

В панели администратора OpenCart:

- зайдите в System\Users\API; - нажмите на кнопку редактирования установленного по умолчанию пользователя;


- отредактируйте при необходимости поле «Username», скопируйте значение этого поля и вставьте его в поле «Логин» формы интеграции в Бизнес.Ру;

- скопируйте значение поля «Password» и вставьте его в поле «Пароль» формы интеграции в Бизнес.Ру;

- нажмите на кнопку сохранения.


3.2.4 В форме интеграции в Бизнес.Ру:

- выберите «Загружать статусы из интернет-магазина» или выберите значение в поле «Присваивать статус»;

- нажмите кнопку «Сохранить»;

- нажмите «Проверить подключение».

В случае, если связь с интернет-магазином установлена, то Вы увидите сообщение «Настройки указаны верно». Перейдите во вкладку «Редактирование» формы интеграции в Бизнес.Ру.


4. Если учет товаров будет вестись в Бизнес.Ру, то настройте Выгрузку товаров. Для того, чтобы товары из Бизнес.Ру появились в OpenCart, нажмите кнопку «Выгрузить сейчас».


"Выгружать только остатки и цены" - если отметка установлена, то будет выгружаться только информация об оставшихся товарах и ценах.


"Все товары" - если отметка установлена, то выгружается весь товар из справочника "Товары и услуги", если отметка отсутствует, необходимо выбрать организацию и склад, с которого выгружается товар для интернет-магазина.


"Использовать нативные модификации товаров" - если отметка установлена, то в OpenCart во вкладке "Option" загруженного из Бизнес.Ру товара будет создана опция с наименованием, соответствующим наименованию характеристики модификации товара, а поля "Option Value" опции будут содержать значения характеристики модификации товара.
Если отметка не установлена, то в OpenCart во вкладке "Option" загруженного из Бизнес.Ру товара будет создана опция с наименованием "Варианты", а поля "Option Value" опции будут содержать наименования характеристики модификации товара и через двоеточие значения характеристики модификации товара.
Например, если из Бизнес.Ру выгружается товар "Сок березовый" с характеристикой модификации "Цвет сока", имеющей значения "Светлый", "Темный", "Очень темный", то при установленной отметке "Использовать нативные модификации товаров" результат выгрузки товара в OpenCart будет следующий:


Если отметка "Использовать нативные модификации товаров" не установлена, то результат выгрузки товара в OpenCart будет следующий:


"Склад" - склады, с которых товар выгружается в интернет-магазин.


"Группы товаров" - группы товаров, которые выгружаются в интернет-магазин.


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


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


5. Настройте Загрузку заказов

Для того, чтобы заказы из OpenCart появились в Бизнес.Ру, нажмите кнопку «Загрузить сейчас». 


"Обновлять информацию о доставке" - если отметка установлена, то при загрузке измененного заказа данные на вкладке "Информация о доставке" будут изменены согласно изменениям в интернет-магазине. Не использовать при необходимости редактирования информации о доставке в Бизнес.Ру.


"Загружать статусы из интернет-магазина" - если отметка установлена, то при загрузке заказов принимаются статусы из интернет-магазина.


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


"Автоматически резервировать товары в загружаемых заказах" - если отметка установлена, то при загрузке заказа покупателя будет автоматически резервироваться товар из заказа.


"Приём онлайн-платежей" - включите, чтобы разрешить приём онлайн-платежей.


"Статус оплач. заказов" - выбрать статус оплаченных заказов.


"Розн. точка с ФР." - выбрать розничную точку с установленным фискальным регистратором.


"Организация" - выбрать организацию, на которую оформляются заказы, загруженные из интернет-магазина.


"Владелец" - сотрудник организации, который отражается на заказах, принятых из интернет-магазина.


"Валюта цен" - валюта цен, которая присваивается загруженным заказам.


"Учёт НДС" - настройка учета НДС в ценах загруженных заказов.


"Загружать каждые" - интервал времени для загрузки новых заказов. Интервал загрузки рассчитывается от момента окончания последней загрузки из интернет-магазина.


6. Нажмите кнопку «Сохранить»

7. Если есть необходимость загрузить товары из OpenCart в Бизнес.Ру, то экспортируйте товары из OpenCart  любым доступным способом, подготовьте файл Excel, содержащий информацию об экспортированных товарах, и импортируйте товары в Бизнес.Ру из Excel согласно инструкции https://support.business.ru/knowledge-bases/5/articles/2954-kak-sdelat-import-tovara-iz-xls-v-sistemu .

Также можно создать заказ в интернет-магазине с полным каталогом товаров и загрузить его в Бизнес.Ру. Все товары из интернет-магазина загрузятся с заказом и отобразятся в разделе «Справочники» в подразделе «Товары и услуги». Загрузятся только наименование товара и его артикул.

This article was helpful for 1 person. Is this article helpful for you?