Wildberries’ning Opencart bilan integratsiyasi

WB Marketplace bozoriga tovarlarni yuklash;
narxlar va chegirmalarni yuklab olish;
OpenCart’ga yangi FBS buyurtmasini yuklab olish;
FBS sozlamalari va havolalari bilan ishlash;
WB grafiklari bilan OpenCart grafiklaridan foydalanish;
sinxronizatsiyalarni jurnalga yozish;
Pluginhub litsenziyasini tekshirish.

Ichki administratorlar RU, EN, KK, UZ va ZH tillarida mahalliylashtirilgan.

Repozitoriy tuzilishi

Loyihada OpenCartning turli versiyalari uchun alohida to‘plamlar mavjud:

yuklash / - OpenCart 3 uchun asosiy to'plam.x;
2.3 / OpenCart 2.3 uchun yuklab olish/ - ilova.x;
4.0/kengaytma/ pluginhub / - OpenCart 4 uchun platforma.x, pluginhub kengaytma ishlab chiqaruvchisi tomonidan ishlab chiqilgan;
install.xml, 2.3/install.xml, 4.0/install.xml-OCMOD-metadata. Hozirgi ko‘rinishda ular yadro fayllariga tuzatishlar kiritmaydi;
install.php , 2.3/install.php, 4.0/install.php - yordamchi o‘rnatish kontrollerlari, administrator paneli orqali o‘rnatish uchun shart emas.

Muhim: fayllarni OpenCart versiyalari bilan aralashtirmang. Do‘kon versiyasiga mos keladigan faqat bitta to‘plamni o‘rnating.

Tahlildan so‘ng joriy holat

Jumladan, quyidagi asosiy funksiyalarni o‘z ichiga olgan tuzilma: administrator kontrollerlari, planshet modellari, WB API biotekasi, litsenziyalash biotekasi, til shablonlari mavjud.

Ishchi do‘konga o‘rnatishdan oldin nimalarga e’tibor berish muhimOpenCart 4.x tizimida alohida buyurtma, yetkazib berish, tovarlar va hisobotlarni xaritalash sahifalari mavjud, ammo asosiy boshqaruvchida 3.x tizimidagi kabi alohida Ajax litsenziyasini tekshirish ekrani mavjud emas. Litsenziya kaliti sozlamalarda saqlanadi va litsenziya kutubxonasi mavjud.
OpenCart 2.3 asosiy adapterga o‘xshab ko‘rinadi: mahsulotlar, sharhlar va boshqalarni sinxronlashtirish mavjud, alohida qaydlar, postlar, repostlar va 2.3 jildidagi sharhlar mavjud emas.
install.xml fayli hozirda faqat o‘zgartirishlar tavsifi sifatida taqdim etilmoqda. Bu tasvirni avtomatik ravishda o‘zgartirishga olib keladi deb o‘ylamang.
O‘chirish planshetlarning ishlashiga ta’sir qilmasligi mumkin. Qayta o‘rnatish xavfsiz, ammo to‘liq o‘chirishda buni bilish muhimKrona va muxolifat uchun bir xil shaxs muhim ahamiyatga ega. Kutubxona www orqali domenni normallashtiradi, shunchaki shunday, lekin foydalanuvchilarni topish imkoniyati mavjud bo‘lgan boshqa xost orqali kronani chaqirish uchun emas.

Talablar

OpenCart 2.3.x, 3.x yoki 4.x.
PHP-dan OpenCart versiyangiz yordamida foydalanish mumkin.
PHP curl-dan foydalanish.
HTTPS protokoli orqali ishlaydi va Wildberries va pluginhub.pro foydalanuvchilari uchun to‘g‘ridan-to‘g‘ri SSL-havolalar.
<url> https://pluginhub.pro/license-check manzilida to‘xta.
Wildberries tokeni sotuvchiga kerakli bo‘limlarga kirish uchun API taqdim etadi: Kontent, marketpleys, narxlar va statistika.
Tovarlarni yuklash uchun ID-sinf WB Marketplace savdo maydonchasi.

O‘rnatish

O‘rnatishdan oldin do‘kon fayllari va ma’lumotlar bazasining zaxira nusxasini yarating.

OpenCart 3.x

1. Yangilangan OpenCart ildiziga qo‘llab-quvvatlanadigan ilovani yuklab ko‘ring.
2. Admin panelida Qo‘shimchalar -> Qo‘shimchalar bo‘limini oching.
3. Filtrda Modullar-ni tanlang.
4. Wildberries-ni toping va o‘rnatishni so‘rang.
5. Modul sozlamalarini oching.
6. Litsenziya kalitini kiriting va Litsenziyani tekshirish-ni bosing.
7. Qo‘llab-quvvatlash va holat buyurtmalari uchun API-interfeyslar, URL, bo‘limdan foydalaning.
8. Saqlash tugmasini bosing.
9. Agar siz haqiqatan ham OCMOD-dan foydalansangiz, modulyatorlar bilan tanishib chiqing.

OpenCart 2.3.x

1. 2.3/yuklab oling/ tarkibini OpenCart 2.3 ildiziga yuklab oling.
2. Admin panelida Qo‘shimchalar -> Qo‘shimchalar bandini oching.
3. Modullar turini tanlang.
4. Wildberries modulini o‘rnatingOpenCart 4.x

1. OpenCart 4 uchun 4.0/kengaytma/ ilovasini kengaytma/ ilovasidan yuklab oling.
2. Avval kengaytmalarni oching -> Extensions.
3. Modullar turini tanlang.
4. Pluginhub yetkazib beruvchisidan Wildberries modulini o‘rnating.
5. Sozlamalarni oching va parametrlarni to‘ldiring.
6. Modul marshrutlari uchun administrator guruhi huquqlarini tekshiring.

OpenCart 4.x xaritalariga kirish va ularni o‘zgartirish zarur:

kengaytma/pluginhub/modul/wildberries
kengaytma/pluginhub/modul/wildberries_orders
kengaytma/pluginhub/modul/wildberries_supplies
kengaytma/pluginhub/modul/wildberries_mapping
kengaytma/pluginhub/modul/wildberries_products
kengaytma/pluginhub/modul/wildberries_reports

Boshlang‘ich sozlash

Tavsiya etilgan tartib:

1. Modulni faqat majburiy parametrlar to‘ldirilgandan so‘ng yoqing.
2. Pluginhub litsenziya kalitidan foydalaning.
3. OpenCart 3.x uchun litsenziyalarni taqdim etish va muvaffaqiyatli javobni kutish kerak.
4. Oddiy WB API tokenidan foydalaning.
5. Ular kontent, marketpleys, narxlar va statistika uchun alohida maydonlarni to‘ldirib, turli WB tokenlaridan foydalanadilar.
6. Agar Wildberries foydalanuvchilarga qulaylikni talab qilmasa, standart API URL manzilini o‘rnating10. Zarur bo‘lsa, tovarlarni narxi, vazni, ishlab chiqaruvchilari yoki toifalari bo‘yicha filtrlang.
11. WB sayti uchun OpenCart ilovalarini o‘rnating.
12. Sozlamalarni saqlang.
13. Avval tovarlarni sinxronlashtiringKontent API: https://content-api.wildberries.ru
Savdo maydonchasi API: https://marketplace-api.wildberries.ru
Narxlar API: https://discounts-prices-api.wildberries.ru
StatistikaVB tokenining huquqlari davlatning muhim hissasi hisoblanadi:

Mazmun - tovarlarning qo‘shimcha ro‘yxati;
Savdo maydonchasi - e’lonlar, eslatmalar, FBS-buyurtmalar, maslahatlar va takliflar;
Narxlar - yuklab olingan;
Statistika - hisobotlar va statistika.

Tovarlarni taqqoslash

Wildberries sotuvchi kodi yozilgan kartochkalardan voz kechmoqda. Modul va ushbu OpenCart mahsuloti tanlab olingan so‘rov bo‘yicha:

artikul - hamma uchun qiymat;
model - ma’muriy rejim.

Agar menyuingizda yovvoyi rezavorlardan tayyorlangan mahsulotlar bo‘lishini istasangiz, ushbu maqola orqali ularni topishingiz mumkin.OpenCart 3.x da mavjud sinxronizatsiya turlari:

tovarlar - WB kartalarini yuklash va OpenCart tovarlariga ulash;
aksiya - tovarlarni WB omboriga yetkazib berish;
narx - yetkazib berish va chegirmalar;
buyurtmalar - yangi FBS-buyurtmalarni import qilish;
sinxronlashning inklyuziv turlari bo‘yicha umumiy so‘rov.

Qoldiqlar 500 tagacha bo‘lgan paketlarda yuklanadi. Narxlar 1000 tagacha bo‘lgan paketlarda yuklanadi. Barcha sharhlar wildberries_sync_log ga yoziladi.

Cron

OpenCart 3.x da upload/admin/controller/cron/wildberries_sync.php brauzeri mavjud.

Oddiy HTTP so‘rovi:

https://example.com/admin/index.php?route=cron/wildberries_sync

Cronni yoqishdan oldin:

1. Litsenziyani tekshiring.
2. Modulni yoqing.
3. Avtomatik sinxronizatsiyani yoqing.
4. Menyuda modul_wildberries_sync_interval ni yoqing.
5. Kerakli sinxronlash bayroqlari yoqilganligiga ishonch hosil qiling: mahsulotlar, qoldiqlar, narxlar, buyurtmalar.

Kronning o‘zi tekshiradi:

litsenziyaning haqiqiyligi;
modulning holati;
avtomatik sinxronizatsiya yoqilganmi;
oxirgi ishga tushirilgandan beri belgilangan muddat o‘tganmi.

Mualliflik litsenziyasi mo‘ljallangan kundan boshlab xronika yaratish tavsiya etiladi.

FBS buyurtmalari

Modul Marketplace API orqali yangi FBS buyurtmalarini taqdim etadi va OpenCart-ga buyurtma berish imkonini beradi. Buyurtma berish uchun Jahon banki bilan bog‘lanishingiz va yovvoyi qorag‘atga buyurtma berishingiz mumkin.

Agar tovar so‘rov yoki artikul bo‘yicha topilganida, u OpenCart bilan bog‘langan bo‘lardi. Agar bunday bo‘lmasa, Jahon bankining texnik ma’lumotlari bilan bog‘lanishi juda muhim.

To‘g‘ri ishlashi uchun quyidagi holatlarni belgilang:

yangi buyurtma;
qayta ishlanmoqda;
jo‘natildi;
yetkazildi;
bekor qilindi.

Etkazib berish va yorliqlar

OpenCart 3.x va 4.x to‘plamlarida joylashtirish va buyurtmalar uchun alohida kontrollerlar mavjud. Marketplace API orqali quyidagi operatsiyalar mavjud:

yetkazib berish ro‘yxati;
yetkazib berishni yaratish;
buyurtmani yetkazib berishga qo‘shish;
yetkazib berishni yopish;
buyurtma yorliqlarini olish.

Biznes uchun token marketpleys - bu davlatning ishtirokidir.

Atributlarni taqqoslash

wildberries_attr_map jadvalini tuzib, unda ishtirokni kuzatish mumkin:

OpenCart atributining identifikatori;
Wildberries identifikatori wb_charc_id;
qiymatlar ajratuvchisi;
saralash tartibi.

Bu OpenCart grafiklari asosida WB grafik muharririni ishlab chiqish uchun zarur00 tagacha bo‘lgan paketlarda yuklanadi. Barcha sharhlar wildberries_sync_log ga yoziladi.

Cron

OpenCart 3.x da upload/admin/controller/cron/wildberries_sync.php brauzeri mavjud.

Oddiy HTTP so‘rovi:

https://example.com/admin/index.php?route=cron/wildberries_sync

Cronni yoqishdan oldin:

1. Litsenziyani tekshiring.
2. Modulni yoqing.
3. Avtomatik sinxronizatsiyani yoqing.
4. Menyuda modul_wildberries_sync_interval ni yoqing.
5. Kerakli sinxronlash bayroqlari yoqilganligiga ishonch hosil qiling: mahsulotlar, qoldiqlar, narxlar, buyurtmalar.

Kronning o‘zi tekshiradi:

litsenziyaning haqiqiyligi;
modulning holati;
avtomatik sinxronizatsiya yoqilganmi;
oxirgi ishga tushirilgandan beri belgilangan muddat o‘tganmi.

Mualliflik litsenziyasi mo‘ljallangan kundan boshlab xronika yaratish tavsiya etiladi.

FBS buyurtmalari

Modul Marketplace API orqali yangi FBS buyurtmalarini taqdim etadi va OpenCart-ga buyurtma berish imkonini beradi. Buyurtma berish uchun Jahon banki bilan bog‘lanishingiz va yovvoyi qorag‘atga buyurtma berishingiz mumkin.

Agar tovar so‘rov yoki artikul bo‘yicha topilganida, u OpenCart bilan bog‘langan bo‘lardi. Agar bunday bo‘lmasa, Jahon bankining texnik ma’lumotlari bilan bog‘lanishi juda muhim.

To‘g‘ri ishlashi uchun quyidagi holatlarni belgilang:

yangi buyurtma;
qayta ishlanmoqda;
jo‘natildi;
yetkazildi;
bekor qilindi.

Etkazib berish va yorliqlar

OpenCart 3.x va 4.x to‘plamlarida joylashtirish va buyurtmalar uchun alohida kontrollerlar mavjud. Marketplace API orqali quyidagi operatsiyalar mavjud:

yetkazib berish ro‘yxati;
yetkazib berishni yaratish;
buyurtmani yetkazib berishga qo‘shish;
yetkazib berishni yopish;
buyurtma yorliqlarini olish.

Biznes uchun token marketpleys - bu davlatning ishtirokidir.

Atributlarni taqqoslash

wildberries_attr_map jadvalini tuzib, unda ishtirokni kuzatish mumkin:

OpenCart atributining identifikatori;
Wildberries identifikatori wb_charc_id;
qiymatlar ajratuvchisi;
saralash tartibi.

Bu OpenCart grafiklari asosida WB grafik muharririni ishlab chiqish uchun zarur.