Меню Рубрики

Установка api на opencart 2

Как пользоваться API в Opencart 2.x

В OpenCart 2.x была представлена новая система API. Это позволяет удаленно управлять вашим магазином на OpenCart 2 для интеграции системы в другие среды, например мобильные приложения. В этой статье, мы объясним, как работает API и как его использовать. С выходом новой версии Opencart был сделан большой прогресс в ветке API и хотя это — ни в коем случае заключительная версия, мы полагаем, что это — хорошая идея, чтобы познакомиться с работой этой системы.

Для того, чтобы использовать любой из методов API, вам нужно будет сначала авторизоваться. Для авторизации вам нужно получить ключ API в админке сайта Меню->Настройки->Пользователи->API. После того, как вы получили ключ — вы готовы начать работать с API.

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

Все контроллеры API находятся в api директории, так что ваш базовый URL, должен выглядеть подобным этому: site.ru/index.php?route=api/controller/method. Здесь site.ru нужно заменить с вашим фактическим доменным именем и методом контроллера или нужным контроллером и методом из API. Имейте в виду, что часть метода необязательна. Если вы хотите вызвать функцию по умолчанию index() , вы можете не писать этот метод в URL.

Добавление товара в корзину через API Opencart 2

После успешного логина, вы можете взаимодействовать с API. Одно из возможностей это добавление товара в корзину, используя метод cart/add. URL для этого действия есть: site.ru/index.php?route=api/cart/add. Основными POST параметрами которые передаються в форме есть product_id и quantity. Вы можете также передавать массив опций option, но необьязательно.

Функции API Opencart 2.x

Мы не можем рассказать про все доступные функции API здесь, но вы можете сами посмотреть какие методы API можно использовать, для этого просмотрите файлы в папке catalog/controller/api/. Таким образом вы будете иметь понятие того, что вы можете сделать с помощью API.

SDK библиотека для работы с API Opencart 2

Существует библиотеки SDK, чтобы помогать нам работать с API без знаний о cookie, GET / POST параметрах и их именах . Вы можете скачать таку библиотеку тут https://github.com/iSenseLabs/OpenCartAPI. Главный класс под названием OpenCart находится в пространстве имен OpenCart.

Для того, чтобы залогиниться, вам нужно назвать порядковую функцию контроллера логина, так URL запрос будет: site.ru/index.php?route=api/login. Тип запроса должен быть POST и требуемые POST переменные -«username» и «password». Каждый метод API возвращает форматированные данные JSON. В случае метода логина, это будет или возвращение сообщения успеха, или сообщение об ошибке. Так, проверяя, имеет ли возвращенный объект в ответе значение успеха или ошибки будет говорить вам, был ли логин успешен или нет. Также вернется cookie, которое является значением ID вашей сессии. Для того, чтобы поддерживать сессию, вам нужно будет извлечь cookie из ответа HTTP и посылать их с каждым последовательным запросом.

Пример авторизации и добавления товара в корзину:

Вы можете также сохранить свою сессию для более позднего использования,добавивт второй параметр к конструктору класса OpenCart. Это должно быть именем файла, где будет храниться cookie. Вы можете указать это где-нибудь в вашей файловой системе. Вот — пример самой простой формы :

Примеры всех методов в этой библиотеке, в том числе оформление заказа через API Opencart 2.x:

Модуль Упрощенный заказ Custom Quick Checkout на Opencart 2.x

Модуль упрощенного заказа Custom Quick Checkout Opencart 2 — по сути модуль заказа на одной странице..

Читайте также:  Установка посудосушителя в шкаф

Модуль Заказ в 1 клик Opencart 2

Модуль Быстрый заказ в 1 клик Opencart2 — очень удобное дополнение для вашего магазина.Позволяет упр..

Модуль Корзина Popup для Opencart 2

Модуль popup-корзины товаров на Opencart 2. Попап окно появляется после добавления товара в корзину ..

Модуль Менеджер заказов Opencart 2

Модуль Менеджер заказов Opencart 2.x — модуль для управления заказами из админки. Модуль позвол..

Модуль Import YML Opencart 2

Модуль Import YML Opencart 2 — для импорта yml-файла с товарами в Ваш интернет-магазин. Импорт ..

Модуль Export YML — экспорт в Яндекс для Opencart 2

Модуль экспорта товаров на площадку Яндекс.Маркет. Модуль YML Export Opencart 2.x. Позволяет генерир..

Модуль Горизонтальное мега-меню Opencart 2.x

Модуль для формирования многоуровневого меню на основе категорий, производителей, товаров, страниц, ..

Модуль Вертикальное мегаменю для Opencart 2.x

Модуль для создания вертикального мега-меню в колонке на Opencart 2.x. Очень многофункциональное доп..

Модуль Opencart Blog для Opencart 2.x

Большим недостатком системы Opencart 2.x является отсутствие нормального блога записей. Ведь почти к..

Модуль Менеджер рассылки для Opencart 2

Менеджер рассылки — модуль для управления подпиской и рассылкой, он поможет вам упростить процесс сб..

Модуль Стикеры на товары для Opencart 2

Модуль для прикрепления стикетов к товарам на Opencart 2. Стикеры — это бирки, ленты, штамы, звездоч..

Слайдер Revolution для Opencart 2.0 — 2.3

Слайдер №1 для Opencart 2 — это Revolution Slider. Многофукциональный модуль для слайдшоу позволяет ..

источник

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

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

Интеграция поддерживается для официальных оригинальных версий OpenCart от разработчиков компании

Корректная работа интеграции не гарантируется с любыми программными продуктами, основанными на оригинальном OpenCart (например, ocStore, OPENCART.PRO, Opencart «Русская сборка» и т.д. и т.п.).

Корректная работа интеграции не гарантируется при установленном в OpenCart плагине SeoPro.

— выгружать товары из Бизнес.Ру в OpenCart, включая модификации;
— загружать заказы из OpenCart в Бизнес.Ру.
Выгрузка товаров и загрузка заказов возможны как в ручном режиме, так и в автоматическом с заданным периодом.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Читайте также:  Установка пластикового плинтуса на гипсокартон

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

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

3.1 Перейдите в Маркетплейс (шестеренка настройки в правом верхнем углу, пункт меню «Маркетплейс»).

В разделе «Интернет-магазины» кликните по виджету интернет-магазина OpenCart.
В открывшемся информационном окне виджета кликните по кнопке «Подключить», откроется форма интеграции с интернет-магазином.

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

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

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

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

«Версия OpenCart» — выбираем «2.1.х.х-2.3.x.x, от 3.0.3.x»

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

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

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

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

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

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

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

В панели администратора 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 .

В случае загрузки товара через файл Excel, в файле обязательно должна быть колонка «Код из магазина», которая должна содержать идентификатор товара на стороне интернет-магазина, а именно значение колонки product_id таблицы product базы данных интернет-магазина:

В случае, если в файле Excel не будет колонки «Код из магазина», содержащей product_id, либо значения product_id будут неверными, то при выгрузке товаров в интернет-магазин товары в интернет-магазине будут дублироваться.

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

Возможный вариант решения проблем с работой SeoPro

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

На сервере, где установлен OpneCart, выполните следующие действия:

1.Из папки system/storage/cache удалите все файлы, кроме index.html

2. В файл seo_pro.php, находящийся в /catalog/controller/startup , в функцию validate() добавьте код:

Для того, чтобы интеграция работала корректно, любые действия с товарами и группами, в которых находятся товары, необходимо производить только на стороне Бизнес.Ру. Здесь «любые действия» включают в себя, но не ограничиваются следующими действиями:
— создание товаров\групп,
— изменение товаров\групп,
— удаление товаров\групп,
— перемещение товаров\групп в другие группы.
В случае, если вышеуказанные требования пользователем соблюдены не будут, то интеграция будет работать некорректно, при этом привести интеграцию к корректной работе возможности не будет. Удаление интеграции на стороне Бизнес.Ру и создание новой интеграции на стороне Бизнес.Ру также не решит проблему, при этом приведет к новой проблеме — созданию дубликатов товаров на стороне интернет-магазина и стороне Бизнес.Ру. При этом товарный учет и отчетность на стороне Бизнес.Ру будут нарушены.

источник

Добавить комментарий