8.11. Интеграция на Барси с WooCommerce¶
8.11.1. Въведение¶
Интеграцията на Барси с WooCommerce позволява да управлявате съдържанието на Вашият онлайн магазин през Барси.
- Това включва:
Първоначално теглене на каталог(артикули, категории, атрибути) от WooCommerce към Барси
Периодично изпращане на каталог(артикули, категории, атрибути) от Барси към WooCommerce
Получванане на новосъздадени или променени поръчки от WooCommerce в Барси
Получаване на новорегистрирани клиенти от WooCommerce в Барси
Интеграцията се извършва чрез REST API на WooCommerce и не е необходимо активиране на допълнителни плъгини в интерфейса на WooCommerce.
8.11.2. Интеграция¶
Влизаме в Барси >> Настройки >> Системни >> Отдалечени системи >> Нова отдалечена система
Въвеждаме желаното име, а за протокол се избира “WooCommerce”, желания търговски обект и въвеждаме адреса на магазина в случая от примера http://192.168.77.127 и Запис.
След това влизаме отново в настройките на новосъздадената отдалечена система, кликаме на таб “Още настройки”.
Поле “Домейн на Вашето Барси” е въведено автоматично, ако полето е празно, моля въведете адреса на Вашето Барси. Препоръчително е “Домейн на Вашето Барси” да започва с https://, ако Вашият домейн започва с http:// , моля свържете се с нашият екип Има и други настройки, които могат да бъдат посочени сега или в последствие. Запишете отново и влезте пак в настройките.
Автоматична оторизация¶
Интеграцията на Барси и WooCommerce поддържа автоматична оторизация, ако Вашето Барси използва протокол https
След като “Домейн на Вашето Барси” е въведен можем да натиснем бутона “Конфигуриране”.
Натиснете Click here на отворилия се прозорец.
Ще бъдете препратен във Вашият онлайн магазин за да одобрите операцията.
След това ще бъдете пренасочен отново във Вашето Барси.
Ако оторизацията е преминала успешно във настройките на отдалечената система трябва да са се запълнили тези полета: “Потребителски ключ” и “Секретен ключ”
Ръчна оторизация¶
Ако Вашето Барси е с протокол http или искате интеграцията да е назначена на точно определен WooCommerce потребител можете да конфигурирате ръчно оторизацията в WooCommerce.
Влизате в административния панел на Вашия WordPress сайт, след това в меню WooCommerce >> Settings >> таб Advanced >> таб REST API >> Add key
Въвежда се име/описание на интеграцията, избира се потребител и права (“Четене”, “Писане”, “Четене/Писане”) и се натиска Generate API key
Биват генерирани Consumer key и Consumer secret, които трябва да бъдат копирани в кореспондиращите полета в Барси интерфейса за създаване на интеграция с WooCommerce (Още настройки).
След като напуснете тази страница няма да имате достъп отново до Consumer key и Consumer secret затова е препоръчително да ги копирате на момента. Имайте предвид, че това е чувствителна информация и ако друг разполага с Вашите Consumer key и Consumer secret би могъл да има достъп до Вашият магазин.
След като връзката с WooCommerce магазина е оторизирана, можете да настройте Webhook-овете, чрез тях ще получавате новосъздадени или обновени сметки, или клиенти. За целта натиснете бутона, “Създаване” срещу поле “Създаване на webhook-ове”. При успешно създаване ще получите следното съобщение:
Ако автоматичното създаване на webhook-ове не сработи можете да създадете такива през WooCommerce
Влизате в административния панел на Вашия WordPress сайт, след това в меню WooCommerce >> Settings >> таб Advanced >> таб Webhooks.
- Тук трябва да бъдат въведени 6 записа за всички действия, които искаме да бъдат изпратени към Барси от WooCommerce:
Създаване на сметка (order.created)
Редактиране на сметка (order.updated)
Изтриване/канселиране на сметка (order.deleted)
Създаване на клиент (customer.created)
Редактиране на клиент (customer.updated)
Изтриване на клиент (customer.deleted)
Важно е да бъде формиран Delivery URL, това е адресът във Вашето Барси, които ще приема изпратената информация. Формира се по следния начин : <адресът на Вашето Барси> + /endpoints/json/Remotesystems_receive?remote_id= + id на отдалечената система в Барси id на отдалечената система в Барси можете да видите в първата колона на страницата с всички отдалечени системи или в горния десен ъгъл при “редактиране на отдалечена система
в примера id-то е 6, съответно Delivery URL ще е https://demo.mitko.office.lukanet.com/endpoints/json/Remotesystems_receive?remote_id=6
След като имате формиран Delivery URL можете да преминете към създаване на самите webhook-ове, в WooCommerce натискате Add webhook бутона. Появява се страница със следните полета:
Потвърждаваме с Save webhook.
При създаването на webhook се изпраща тестова информация към посочения Delivery URL, тава позволява да получите обратна връзка дали е формиран правилно (препоръчително е да се ползва https протокол)
Ако след потвърждението видите Webhook updated successfully. значи конфигурирането е минало успешно.
Ако вместо това получите съобщение Error: Delivery URL cannot be reached: A valid URL was not provided. има проблем с адреса за получаване на информация.
Това действие трябва да бъде повторено за всички останали действия описани по-горе. В края на конфигурирането трябва да получите настройки приличащи на тези:
Допълнителни настройки на WooCommerce интеграцията¶
- Описание:
Изпращане на SKU код към артикулите - Тази настройка определя дали искате SKU (Stock keeping unit) кодът въведен в Барси да бъде прехвърлен и в WooCommerce. Ако изберете да не бъде копиран ще бъде генериран нов код за WC. Интеграцията поддържа възможността да бъдат интегрирани няколко търговски обекта от Барси в WooCommerce поддържащ multivendor module, ако искате да се възползвате от такъв тип интеграция, то трябва да настроите системата да не изпраща SKU код.
Стартова категория за синхронизацията - Тук можете да зададете коя или кои категории да бъдат синхронизирани със WooCommerce магазина Ви.
Payment methods - Под “Стартова категория за синхронизацията” следват нефиксиран брой полета свързани с начините на разплащане. Броят на полетата зависи от броя начини на разплащане, които сте активирали в WooCommerce. Целта на тези настройки е смислово да синхронизирате начините на плащане от WooCommerce и Барси. Нови начини за разплащане могат да бъдат добавяни в WooCommerce като активирате съответните плъгини.
Зареждане на артикули - Зареждането на артикули трябва да бъде изключено, защото управлението на търговския Ви обект ще се извършва през Барси.
Изпращане на артикули - Изпращането на артикули трябва да е на всяка минута, за оптимална работа със системата.
