Как да свържете OpenCart с easySales: пълно ръководство за интеграция

Защо да свържете OpenCart с easySales

Продавате в OpenCart и искате едно място, където да управлявате поръчки, да издавате фактури, да изпращате товарителници към куриери и да преизползвате същите продукти като оферти на маркетплейсите? easySales се справя с всичко от един единствен табло.

След свързването easySales изтегля продуктите и опциите от OpenCart и централизира входящите поръчки. Оттам издавате фактури, създавате товарителници с всеки поддържан куриер и превръщате тези продукти в оферти на eMAG, Allegro, Kaufland, Trendyol и 80+ други канали. Наличностите и статусите на поръчките остават синхронизирани в двете посоки.

Стартирате съветника в easySales, изтегляте модула OpenCart, който съответства на версията на магазина, инсталирате го в админ панела на OpenCart, след което поставяте токена от easySales обратно в модула — без код, без FTP достъп, без промени в темата.

Как работи конекторът OpenCart

easySales се свързва с OpenCart чрез малък модул .ocmod.zip, който изтегляте от акаунта си в easySales и инсталирате чрез админ панела на OpenCart. Модулът предоставя частна крайна точка, която easySales извиква, за да чете каталога и поръчките ви, и регистрира два webhook-а, така че промените в поръчки и наличности да достигат easySales в почти реално време.

Модулът никога не се свързва навън. easySales говори с него, удостоверен с генериран от easySales токен за всеки уебсайт. Идентификационните данни за базата данни на OpenCart, админ паролите и тайните на платежните шлюзове остават в OpenCart инсталацията ви.

Кои версии на OpenCart поддържа easySales

easySales доставя отделен билд на модула за всяка основна версия на OpenCart, така че интеграцията да съответства на API и admin оформлението на магазина:

• OpenCart 1.5.6.4
• OpenCart 2.0.0.0 – 2.1.0.2
• OpenCart 2.2.0.0
• OpenCart 2.3.0.0 – 2.3.0.2
• OpenCart 3.0.0 – 3.0.2.0
• OpenCart 4.0 – 4.1.0.3

Съветникът избира билда, когато избирате версията си. Ако сте на пач между две от тези (например 2.3.0.1), се прилага билдът за най-близката по-ниска версия. Раздвоените дистрибуции на OpenCart и по-старите 1.5.x пач нива не са официално поддържани — модулът може да се инсталира, но админ пътищата могат да се различават.

Интерактивна обиколка

Не ви се чете? Преминете през интерактивната обиколка.

Предварителни условия — какво да подготвите преди да започнете

Няколко изисквания предотвратяват пропускането на продукти при импорта.

Стъпка 1 — Стартирайте съветника в easySales и изтеглете модула

В easySales отидете на Интеграции → Онлайн магазини → Свържи уебсайт, след което изберете OpenCart и посочете версията на магазина. Съветникът се отваря на стъпка Изтегляне на модул.

Натиснете бутона за изтегляне, за да получите архива на модула (easysales.ocmod.zip или име, специфично за версията, като 2market-oc3x.ocmod.zip). Оставете този раздел отворен — ще се върнете към него в Стъпка 3, за да завършите конфигурацията.

Стъпка 2 — Качете и инсталирайте модула в OpenCart

В админ панела на OpenCart отидете на Разширения → Инсталатор. Натиснете Качване, изберете архива .ocmod.zip, който току-що изтеглихте, и изчакайте зеленото потвърждение за "успех".

След това отворете Разширения → Разширения, филтрирайте по Модули в горния падащ списък, намерете easySales в списъка и натиснете зеления бутон Инсталиране (+). След инсталирането натиснете синия бутон Редактиране (молив), за да отворите настройките на модула — ще видите поле Token. Оставете този раздел отворен; в следващата стъпка ще поставите тук токена от easySales.

Стъпка 3 — Конфигурирайте сайта в easySales и поставете токена в OpenCart

Върнете се на раздела easySales — съветникът сега е на стъпка Конфигурация и показва генерирания токен. Копирайте токена, върнете се на OpenCart и го поставете в полето Token на страницата за редактиране на модула easySales. Задайте Status на Enabled, оставете останалите стойности по подразбиране, след което натиснете Запази в OpenCart.

Обратно в easySales, завършете конфигурирането на сайта. Формата под съветника съдържа всичко, от което easySales се нуждае, за да управлява интеграцията.

Име и URL на уебсайта

• Име на уебсайта — етикет, който избирате. Видим само в easySales.
• URL на уебсайта — вашата витрина OpenCart. Използвайте точния URL, на който работи OpenCart, включително https:// и префикса www, ако вашият домейн го използва. Ако OpenCart живее в поддиректория (example.com/shop), включете я.

ДДС и ДДС за доставка

Ако сте регистриран по ДДС, въведете ставката, която се прилага за продуктите ви, и отделна ставка за доставка (например 20 за стандартната ставка в България, или 21 за актуалната стандартна ставка в Румъния). Оставете празно, ако не сте. Данъчните класове на OpenCart не се откриват автоматично — ставката, която задавате тук, е тази, която easySales използва на фактурите и на изходящите оферти за маркетплейси.

Език и валута

Изберете езика на витрината (румънски, български, унгарски, полски или английски) и валутата (RON, BGN, HUF, PLN или EUR). Те служат като стойности по подразбиране за импортираните продукти и като резервен вариант, когато поръчка не носи изрична валута. Никога не пренаписват отделни поръчки — всяка поръчка запазва валутата, докладвана от OpenCart.

Източник на наличности на продуктите

Най-важното решение във формата. Казва на easySales къде се намира меродавната стойност на наличностите:

• Уебсайт — OpenCart е източникът на истината. easySales чете наличностите от OpenCart и никога не ги пренаписва.
• easySales — easySales е източникът на истината. Промените в наличностите в easySales (продажби, ръчни редакции, удръжки от маркетплейс) се изпращат към OpenCart.
• Свързана интеграция — наличностите ви се намират в система на трета страна, която вече е свързана с easySales (счетоводен софтуер, ERP, fulfilment партньор и много други). easySales чете наличностите от тази интеграция и ги изпраща към OpenCart. Първо свържете интеграцията и декларирайте склада ѝ — иначе не можете да изберете тази опция.

Работите с няколко склада? Превключете формата в режим Разширен склад. Вместо да обвържете магазина с един източник на наличности, изберете един или повече easySales складове и определете как наличностите им се агрегират, приоритизират или разделят по канал.

Тип на пакета по подразбиране

Използва се при генериране на товарителница, когато поръчката не указва пакет. Изберете типа, който съответства на повечето ваши поръчки.

Стъпка 4 — Опреснете OpenCart модификациите и финализирайте в easySales

Това е стъпката, специфична за OpenCart, която улавя повечето нови свързвания, и тя трябва да е последното нещо, което правите.

Отворете Разширения → Модификации в админ панела на OpenCart и натиснете синия бутон Обнови в горния десен ъгъл. OpenCart компилира ocmod презаписванията при опресняване — докато не натиснете, модулът е инсталиран, но куките му не са активни.

Сега се върнете в easySales и натиснете Запази, за да финализирате връзката. easySales тества връзката, регистрира webhook-овете на сайта ви OpenCart и започва да импортира каталога.

Какво се случва автоматично след като запазите

easySales се грижи за настройката на webhook-овете и за първоначалния импорт.

1. Два webhook-а се регистрират на сайта ви OpenCart: един за промени в поръчки и един за промени в наличности. Всяка създадена, актуализирана или отменена поръчка в OpenCart достига easySales в почти реално време, същото важи и за обновяванията на наличности.
2. Каталогът ви с продукти се импортира — продуктите и комбинациите им от опции се появяват в Онлайн магазини → Продукти, където можете да ги преглеждате, редактирате и превръщате в оферти за маркетплейси.
3. Входящите OpenCart поръчки се появяват в екрана Поръчки, където издавате фактури, товарителници и пускате автоматизирани процеси.
4. Наличностите се синхронизират според източника, който сте избрали. Ако сте избрали easySales, push-овете на наличности започват да се изпълняват непрекъснато, а витрината ви OpenCart отразява централизирания инвентар.

Финна настройка на OpenCart връзката

След запазване отворете раздела Предпочитания на уебсайта OpenCart. Две групи настройки заслужават бърз преглед.

Order Behavior

• Allow reopening completed orders — по подразбиране, крайните статуси като "Complete" не могат да се връщат към "Processing". Активирайте, ако трябва да отваряте отново поръчки.
• Allow reopening cancelled orders — същата логика за отказани поръчки (полезно, когато временно отказана, неплатена поръчка в крайна сметка е платена).

Synchronization

• Fetch orders — автоматичен импорт на нови OpenCart поръчки.
• Update order status on OpenCart — изпраща промените в статуса от easySales обратно към OpenCart, така че двете системи да остават синхронизирани.
• Update product stock on OpenCart — изпраща нивата на наличности от easySales към витрината OpenCart. Изключете, ако OpenCart е източникът на наличности.

Натиснете Запази в долната част на страницата, за да приложите промените.

Опции, локери и други особености на OpenCart

Няколко OpenCart-специфични поведения, които си заслужава да знаете:

• Опции на продукти. Продуктите в OpenCart носят опции (размер, цвят и т.н.) с опционални SKU за всяка опция. easySales импортира всяка продаваема комбинация като отделна вариация, обвързана с родителския продукт чрез SKU. Ако магазинът ви използва опции без SKU, тези продукти се импортират като един запис — задайте SKU за опция преди свързване, ако искате да се проследяват индивидуално в маркетплейсите.
• Локери. Ако магазинът ви използва поддържано разширение за локери (Sameday EasyBox, InPost и други мрежи от локери в обслужваните от нас пазари), easySales автоматично чете идентификатора на локера от персонализираните полета на поръчката. Не е необходима конфигурация. Локерът се използва като пункт на доставка при генериране на товарителница.
• Персонализирани методи на плащане. OpenCart позволява добавянето на всякакъв метод на плащане чрез разширения. easySales автоматично мапира стандартните методи (банков превод, наложен платеж, карта чрез често срещаните шлюзове). Нестандартните методи идват като Unknown — свържете се с поддръжката, за да разширим мапирането за вашия конкретен шлюз.
• URL-и на изображения. OpenCart обслужва изображения от пътя image/catalog/... спрямо корена на витрината. Модулът ги пренаписва на абсолютни URL-и при експорт. Ако изображенията на продукти не се появяват в easySales, най-честата причина са липсващи файлове на диска — OpenCart записва пътя, дори когато файлът липсва.
• Кеш на модификациите. Ако промените разширения или теми на админ панела на OpenCart, след като модулът easySales е инсталиран, опреснете Разширения → Модификации отново. OpenCart мълчаливо деактивира ocmod презаписванията при определени админ обновявания.
• Обновявания на модула. Когато се публикува нова версия на модула, easySales показва червено предупреждение в Предпочитанията на уебсайта. Изтеглете новия билд, премахнете стария модул от админ панела на OpenCart (Разширения → Разширения → Modules → Деинсталиране), след което инсталирайте новия архив, следвайки Стъпка 2 отново. Запазете и в OpenCart, и в easySales, след което опреснете Разширения → Модификации.
• Префикс на серия на фактура. Ако искате конкретна серия на фактура върху документите, генерирани надолу по веригата от OpenCart, задайте я в админ панела на OpenCart на Settings → Option → Checkout → Invoice Prefix. easySales чете тази стойност заедно с поръчката.

Свързани сте — какво следва

След като поръчките започнат да пристигат, следващата стъпка е автоматизацията. Настройте процеси за генериране на фактури, създаване на товарителници и изпращане на известия за проследяване. Ако продавате и на маркетплейси, превърнете каталога OpenCart в оферти и оставете easySales да ги разпространи.