Bijo integráció

Mikor érdemes ezt a megoldást választanod?

A bijo.hu nagyker az Octopus vállalatirányítási rendszert használja. Így az Octopus és a Shoprenter integrációjával teljes mértékben automatizálható a Bijo nagyker és a Shoprenter integrációja. 

Az Octopus-Shoprenter integráció célja, hogy összekössük az Octopus ERP rendszert a Shoprenter webshop motorral, és így egyszerűsítsük és könnyebbé tegyük a nagykerek, webshopok életét.

Az integrációval megoldható

  • a termékek feltöltése az Octopus rendszeréből Shoprenterbe

  • a feltöltött termékek frissítése a webshopokban

  • illetve a megrendelések visszatöltése Shoprenterből az Octopus rendszerébe

  • ezzel az integrációval lehetséges a Nagykerek számára Dropshipping megoldás indítása is

Megoldható az, hogy a nagyker termékadatai elérhetőek legyenek a Shoprenteres webshopok számára, és így akár 1 nap alatt bárki weshopot nyithasson, vagy a meglévő webshopját használva értékesítse a nagyker termékeit.

Emellett az is megoldható az integrációval, hogy a webshop megrendeléseit a Nagyker szállítsa ki.

Az integráció két részből áll.

  1. Az AdminUI az, ami a nagykerek számára elérhető, és ezen keresztül lehetséges a partnerek menedzselése. Ezen keresztül lehet partnereket felvenni, a partnerek számára az integrációt engedélyezni vagy épp letiltani, illetve statisztikákat megnézni a partnerek forgalmáról.
  2. A KliensUI az a felület, amin keresztül a nagyker partnerei tudják elindítani az integrációt. Ezen keresztül lehet beállítani egy árszorzót, és ezen keresztül lehet kiválasztani azt is, milyen termékeket szeretnének a partnerek feltölteni a webshopjukba.

Admin UI - nagyker beállítások

Mi is az AdminUI?

Az AdminUI az az online adminisztrációs felület, amihez csak a nagyker férhet hozzá. Ezen az alkalmazáson keresztül lehet partnereket felvenni, akik számára engedélyezni és elérhetővé lehet tenni a nagyker integrációt.

Az integráció Shoprenteres webshopokkal építhető fel. Ezzel lehetővé vállnak az alábbi funkciók:

  1. Termékadatok feltöltése Octopus ERP rendszerből Shoprenter webshopba
  2. Termékadatok frissítése az Octopus ERP rendszerből Shoprenter webshopba
  3. Megrendelések beküldése Shoprenter oldalról Octopus ERP-be

Emellet az AdminUI-on láthatóak lesznek a partnerek álltal elvégzett beállítások és álltalános forgalmi adatok is (pl.: mennyi terméket töltöttünk fel és frissítünk Octopus oldalról Shoprenter-be, vagy épp mennyi megrendelést szinkronizáltunk a Shoprenter oldaláról az Octopus felé.

 

Hogyan lehet elérni az AdminUI-t?

Az AdminUI egy URL linken keresztül érhető el, ahol egy login form jelenik meg. A felületet egy email cím + jelszóval lehet elérni.

Csak megadott email címekkel lehet elérni ezt a felületet. Létezik egy superAdmin user, ami nem email címhez van kötve. Ezt csak egy felhasználó kapja meg a nagykernél, aki bármikor be tud majd lépni.

Ha új felhasználót szeretnétek hozzáadni az AdminUI-hoz, akkor kérlek írjatok az info@storesync.io email címre, és felvesszük ezt nektek.

Minden usernek email-ben küldjük ki a számára egyedileg generált jelszót, amit használva be tud majd lépni erre a felületre.

Az AdminUI-ból a bal felső sarokban lévő “Log Out” gombot megnyomva lehet bármikor kilépni.

 

AdminUI kezdő képernyő

Az AdminUI-ra belépve láthatjuk a regisztrált partnerek listáját, illetve a kezdő oldalon tudunk új partnert is felvenni, aki számára engedélyezhetjük a Shoprenter integrációt.

Partnerlista
Belépés után láthatjuk a már regisztrált Partnerek listáját. Ezek azok a userek, akik számára elérhető (vagy korábban elérhető volt) a Shoprenter integráció.

A partnereket mindig az email címük szerint listázzuk. A listában az email címek alapján ABC sorrendben csökkenő sorrendben jelennek meg a Partnerek.

A partnerek listájában az is látható, hogy az adott partner számára elérhető-e a szinkronizáció vagy sem. Ekkor a táblázatban az “Integráció engedélyezése” oszlopban egy “x” látható ha ki van kapcsolva az integráció, és egy “zöld pipa” akkor, ha engedélyezve van az integráció. Ez az engedélyezés csak a nagyker oldaláról lehetséges.

A termékek feltöltése és a Megrendelések betöltése funkciókat csak a Partnerek tudják engedélyezni. Az AdminUI-on információ céljából jelenítjuk meg ezeket a beállításokat. Nagyker oldalról ezeket a beállításokat nem lehet változtatni.

Ha az integráció engedélyeze van, akkor a listában megmutatjuk, hogy az adott hónapban mennyi terméket kezel az integráció (mennyi terméket töltöttünk fel és frissítünk folyamatosan a Shoprenteres webshopban), illetve az is, hogy adott hónapban mennyi megrendelést sikerült szinkronizálni a webshopból az Octopus felé.

A partnerlistában a “zöld ceruza” ikonra kattintva lehetséges a partner adatainak szerkesztése. Ez a felület ugyanaz, mint az “Új partner” felvételére szolgáló oldal.

A “Kék lista” ikonra kattintva pedig elérhetőek a megrendelések részletei.

 

Megrendelések részletei
A partner lista oldalról érhető a megrendelések részletei oldal.

Ezen az oldalon 6 hónapra visszamenőleg tekinthetőek meg havi összegzésben az egyes hónapok megrendeléseinek adatai. Itt látható az, hogy adott hónapban az adott partner mennyi megrendelést adott le a nagyker felé, a megrendelésben mennyi fajta termék szerepelt és mekkora volt a megrendelések bruttó összértéke.

Fontos, hogy a jelenlegi, még nem lezárt hónap adatai folyamatosan változhatnak, ahogy a megrendelések alakulnak. A lezárt hónapok adatai viszont véglegesek. (Lezárt hónapnak tekintjük azt a hónapot, aminek lezáródott az utolsó napja is.)

Egy adott hónap mellett lévő info ikonra kattintva listázódnak az adott hónap minden megrendelése, amit az Octopus rendszerébe szinkronizáltunk. A megrendelések a megrendelések azonosítói szerint csökkenő sorrendben láthatóak egy táblázatos formában. A megrendeléseket a Shoprenter egyedi megrendelés azonosítói alapján lehet beazonosítani. Itt az is megtekinthető, hogy egy adott megrendelésben mennyi fajta termék szerepel (fontos, hogy itt a termékek cikkszáma szerint összegezzük, mennyi fajta terméket rendelt a user, és nem a termékekből megrendelt összes darabszám szerepel a listában). Illetve a táblázatból az is kiolvasható, hogy mennyi volt az adott megrendelés bruttó értéke.


Egy azott megrendelés melleti info ikonra kattintva pedig megjelnnek az adott megrendelés adatai. Itt már az látható, hogy adott cikkszámból mekkora mennyiség is szerepel a megrendelésben, és ennek mekkora volt az értéke a megrendelésen belül.

Új partner felvétele
Az AdminUI kezdő oldalán az “Új Partner” gombra kattintva lehetséges új integráció és új partner felvétele.

A gombot megnyomva egy beállítások oldalra érkezünk, ahol az integrációhoz szükséges alapadatokat tudjuk megadni.

Az adatok, amik a felületen megadhatóak:

Név: A partner neve. Ez egy szabad szavas mező. Akár cégnevet, akár személynevet be lehet írni. Ez elsősorban azért fontos, hogy tudjuk, kihez is tartozik az integráció

Email: Kötelező mező, és a partner/kapcsolattartó email címét kell tartalmazza a mező. Ez egy egyedi azonosító, ez alapján vannak a partnerek rendezve és azonosítva a partnerlistában. Az email címet bármikor át lehet írni, viszont a mező nem maradhat üres.

Integráció engedélyezése: Ennek a checkboxnak a bepipálásával lehet az integrációt a partnernek engedélyezni vagy az engedélyezést visszavonni. Ha ez a checkbox nincs kipipála, akkor a partner integrációja nem fog működni. Nem fognak új termékek megjelnni a webshopjában, illetve a meglévő termékei sem fognak frissülni a webshopban. Emellett megrendeléseket sem fog tudni betölteni az Octopus rendszerébe.

Termékek feltöltése, Megrendelések betöltése: Ezek csak read only mezők. Ezeket az adminok nem tudják szerkeszteni. Azt mutatja meg, hogy az adott partner a webshopjában milyen funkciót engedélyezett. Ha a termékek feltöltését engedélyezte, akkor a termékadatok szinkronja, folyamatos frissítése lesz megoldva. A megrendelések betöltése ha be va kapcsolva, akkor a megrendelések Dropshipping módon lesznek beküldve a nagyker számára.

PID: egyedi azonosító, amit az Octopus rendszerében a nagyker oldalán kell beállítsatok. Az Octopus API hívásokhoz van szükség erre az azonosítóra.

Authentikációs kód (AuthCode): egyedi azonosító, amit az Octopus rendszerében a nagyker oldalán kell beállítsatok. Az Octopus API hívásokhoz van szükség erre az azonosítóra.

Partnerkód: egyedi azonosító, amit az Octopus rendszerében a nagyker oldalán kell beállítsatok. Az Octopus API hívásokhoz van szükség erre az azonosítóra.

API URL: A Shoprenter API URL-je, ami az integrációhoz használható. Ezt a Shoprenter Admin felületen a Beállítások → API Beállítások oldalon lehet elérni. Ezt az adatot a Partnerektől be kell kérni (vagy maga a partner is meg tudja adni ezt az adatot a KliensUI felületen), enélkül az integráció sajnos nem működik. Illetve fontos, hogy a Shoprenter oldalon az API engedélyezett legyen.

API Felhasználónév: A Shoprenter API felhasználóneve, ami az integrációhoz használható. Ezt a Shoprenter Admin felületen a Beállítások → API Beállítások oldalon lehet elérni. Ezt az adatot a Partnerektől be kell kérni (vagy maga a partner is meg tudja adni ezt az adatot a KliensUI felületen), enélkül az integráció sajnos nem működik.

API Jelszó: A Shoprenter API jelszava, ami az integrációhoz használható. Ezt a Shoprenter Admin felületen a Beállítások → API Beállítások oldalon lehet elérni. Ezt az adatot a Partnerektől be kell kérni (vagy maga a partner is meg tudja adni ezt az adatot a KliensUI felületen), enélkül az integráció sajnos nem működik.

Szinkron ellenörzése: A szinkron ellenörzése gomb csak a partner létrehozása után lehetséges. Ha itt egy piros X látható, az azt jelenti, hogy szükséges adatok lekérdezése Octopusból az integráció elindításához és működéséhez. A “Javítás” gombra nyomva indítható el minden Octopus hívás, ami így a szinkront aktualizálja. Viszont fontos tudni, hogy új partnerek létrehozása után nagységrendileg 10 perc kell, hogy az alkalmazás minden szükséges adatot összegyűjtsön, így az új partnereknél a szinkron ellenörzése csak a létrehozás után 1 órával fog ellenörzésre kerülni.

Az adatok megadása után a mentés gombra nyomva lehet a Partnert létrehozni.

Ekkor kerül a Partner rögzítésre, és mint rögzített partnernek, ekkor további további lehetőségek jelennek meg a Partner adatlapján.


Jelszó generálás: Ezt a gombot megnyomva lehet a Partnereknek egyedi jelszót generálni. Ezt a jelszót a partnereknek kell elküldeni, mert ezzel, és az email címükkel fognak tudni belépni a számukra készült felületre, ahol be tudják állítani, milyen termékeket szeretnének a webshopjukba feltölteni, és mekkora árréssel szeretnék ezt értékesíteni.

Feltöltött termékek száma: Ebben a mezőben jelöljük azt, hogy mennyi terméket töltött fel a szinkron az Octopus rendszeréből a Shoprenterbe. Ezeknek a termékeknek utána az alábbi adatait folyamatosan figyeljük és frissítjük is:

  1. ár (normál árat és akciós árat egyaránt)
  2. raktárkészlet
  3. termék elérhetősége (státusza)

Megrendelések száma: Ebben a mezőben mutatjuk, hogy adott hónapban mennyi megrendelés szinkronizáltunk a Shoprenter és az Octopus rendszere között.

Árszorzó és kategóriapárosítás gombok: Ezeken keresztül érhető el, hogy az adott partner mekkora árréssel dolgozik, illetve milyen termékeket töltött fel a saját webshopjába. Ami viszont fontos tudnivaló, hogy ezeken az oldalakon csak read only módban érhetőek el ezek az információk. Ezeket a nagyker csak infomációszerzés céljából láthaja. Sem a partnerek árszorzóját nem változtathatják meg, sem a partnerek álltal feltöltött termékeken nem változtathatnak!

 

Összegzés
Jelenleg az AdminUI-on ezek a funciók érhetőek el. Nagykerként ezen a módon lehet létrehozni és elindítani egy Octopus-Shoprenter integrációt.

Ha létrehozásra került egy új partner, és a számára engedélyezett az integráció, akkor a következő lépés az, hogy a partner számára

  1. át kell küldeni a KliensUI felület eléréséhez használható URL-t
  2. el kell küldeni a jelszó és email cím párost, amivel a partner be tud lépni a KliensUI felületre

A partnerek ezen, a számukra aktivált és készített felületen tudják megcsinálni az integráció működéséhez elengedhetetlen beállításokat.

KliensUI - Webshop beállítások

Mi is az a KliensUI?

A KliensUI az a felület, amin keresztül az Octopus-Shoprenter integrációt a webshop tulajdonosk, a nagyker partnerei el tudják indítani, és egyedi beállítások szerint azt üzemeltetni tudják. Két fontos funkciója van ennek az alkalmazásnak. Az egyik az árszorzó, amivel a webshop tulajdonosk egyedi árakat tudnak beállítani a nagykertől feltöltött termékeknek. A másik fontos funkció pedig a kategóriapárosítás, amivel a webshop tulajdonosok be tudják állítani, hogy melyik termékeket és hová szeretnék feltölteni a Shoprenterbe a nagyker kínálatából.

Ezeket a beállításokat, az aktuális üzleti igények szerint folyamatosan változtatni tudják a webshop tulajdonosok. Illetve ezen a felületen keresztül tudják utánkövetni, hogy adott hónapban mennyi terméket kezelt az integráció (mennyit töltött fel és frissített), illetve azt is, hogy mennyi megrendelés került szinkronizálásra a Shoprenterből az Octopus felé.

Hogyan lehet elérni a KliensUI-t?

A KliensUI felület egy online alkalmazás, így ezt csak a nagykertől kapott URL-en keresztül lehet elérni. Belépéshez is csak a nagyker álltal megadott email cím + jelszó párossal lehet belépni. Az email címet és a jelszót is érdemes elmenteni, mert ezeket megváltoztatni csak a nagyker tudja.

A KliensUI felületről a bal felső sarokban lévő “Log Out” gombot megnyomva lehet bármikor kilépni.

KliensUI kezdő képernyő
Az email cím + jelszó beírása után a partnerek a főoldalra jutnak.

Az email cím és név mezők automatikusan generálódnak aszerint, hogy a nagyker milyen adatokkal töltötte ezt ki. Az email cím az egyedi azonosító a KliensUI felülethez is, így ezt megváltoztatni nem lehet. A név mezőbe érdemes beírni, ki az aki az adott KliensUI felületet használja, így vele a nagyker könnyebben tudja majd felvenni a kapcsolatot.

Az Octopus-Shoprenter integráció két fő részból áll. A termékek feltötlése és frissítése az Octopus rendszeréből a Shoprenter felé, illetve a megrendelések visszatöltése Shoprenterből a Nagyker felé. Ezek a funkciók egyedileg is aktiválhatóak. Ha a KliensUI felhasználója csak a “Termékek feltöltés engedélyezése” melletti cehckbox-ot jelöli ki, akkor csak a termékek szinkronizálása és frissítése fog működni. (Ez a funkció akkor lehet érdekes például, ha egy adott webshopban nem csak a Nagyker termékeit értékesítik, így a megrendelésekben olyen termékek is lehetnek, amiket a Nagyker nem forgalmaz, így nem oldható meg a dropshipping).

Feltöltött termékek száma: A feltöltött termékek száma mezőben található az, hogy az integráción keresztül mennyi termék került feltöltése és napi szinten szinkronizálásra a Nagyker felől a Shoprenter webshopba az adott hónapban.

Ha a webshop tulajdonos a “Megrendelések feltöltése” funkciót is engedélyezi, akkor minden megrendelés bekerül majd a Shoprenterből az Octopus rendszerébe.
Egyszerre is engedélyezhető a megrendelések és a termékek szinkronizálása, ezek tökéletesen működnek egymással párhuzamosan is.

Megrendelések száma: Ebben a mezőben látható az, hogy az adott hónapban mennyi megrendelés került szinkronizálásra a Shoprenterből az Octopus rendszerébe.

Megrendelések részletei: Erre a gombra kattintva érhetőek el a megrendelések részletei, ami a Shoprenterből kerültek az Octopus rendszer felé.

API URL: A Shoprenter API URL-je, ami az integrációhoz használható. Ezt a Shoprenter Admin felületen a Beállítások → API Beállítások oldalon lehet elérni. Enélkül az integráció nem működik. Illetve fontos, hogy a Shoprenter oldalon az API engedélyezett legyen.

API Felhasználónév: A Shoprenter API felhasználóneve, ami az integrációhoz használható. Ezt a Shoprenter Admin felületen a Beállítások → API Beállítások oldalon lehet elérni. Enélkül az integráció nem működik.

API Jelszó: A Shoprenter API jelszava, ami az integrációhoz használható. Ezt a Shoprenter Admin felületen a Beállítások → API Beállítások oldalon lehet elérni. Enélkül az integráció nem működik.

 

Árszorzó

Az árszorzó felületen lehetséges olyan szabályok megadása, amivel egyedi árakat lehet megjeleníteni egy adott termékhez a webshopban.

A nagykerektől kapott árak átalakítására egy sávos árszorzót készítettünk. Ennek célja, hogy a nagykertől eltérő árakat tudjon minden webshop tulajdonos megadni a termékeknek a saját webshopjában.

Fontos, hogy legalább a default árszorzót be kell állítani ahhoz, hogy elinduljon és működjön a termékek feltöltése és szinkronizálása.

 


Minden integrációhoz meg kell adni egy “Alapértelmezett árszorzót”. Ez az Alapértelmezett árszorzó azt jelenti, hogy ha van olyan termék, ami semmilyen sávos árszorzóba nem esik bele, akkor azt a default árszorzót fogja megkapni. Ha például ez az Alapértelmezett árszorzó 1.5, akkor ez azt jelenti, hogy ha egy termék pl bruttó 30 000 forint a nagykerben, akkor a webshopodba 45 000 forint lesz.

Ha meg van adva egy bruttó 1 és 10 000 forint összegre beállított árszorzó, ami például 2, akkor ez azt jelenti, hogy ha egy termék a nagykerből bruttó 700 forinton érkezik, akkor az a webshopban bruttó 1 400 forint lesz.

A sávos árszorzókat bármikor átírhatod, illetve ha az „Árszorzó hozzáadása” gombra kattintasz, akkor új sávos árszorzót tudsz majd megadni. Ami fontos, hogy ha átállítod az árszorzókat, vagy újat viszel fel, akkor mindig nyomj a mentés gombra. Az árszorzók csak ekkor kerülnek be az adatbázisba, és utána tud majd a szinkron ezekkel dolgozni.

Ha egy sávos árszorzót szeretnél törölni, akkor az árszorzó melletti “X” gomb megnyomásával tudod azt metenni.

 

Kategória párosítás

A KliensUI odalon lehetséges a kategóriapárosítás megadása. Mivel a webshopokban és a nagykerekben a termékek kategóriája elég gyakran különböző, ezért készítettünk egy kategóriapárosítást. Ennek célja, hogy a webshop tulajdonosok be tudják állítani, a nagykerben található kategóriák termékei milyen kategóriákba kerüljenek át a Shoprenterbe.

Ennek használata egyszerű.


A megjelenő lista bal oldalán lesznek azok a kategóriák, amik a nagykertől jönnek, a jobb oldalon pedig azok, amik a webshopban találhatóak.

Ezután beállítható, hogy melyik nagyker kategória melyik Shoprenteres kategóriának feleljen meg. A beállított kategóriák termékei közül ezután a “Termékek” gombra kattintva kiválaszthatóak, hogy melyik termékek kerüljenek feltöltésre a webshopba.

Azok a termékek nem fognak felkerülni a webshopba, amiknek nincsenek párosítva a kategóriái, vagy ha a kategórapárosítása létezik is, de nincs kijelölve, mint feltöltendő termék.

NAGYON FONTOS!!!!

A Shoprenterban sajnos alapbeállításként nem léteznek olyan mértékegységek, amik a Bijo-ban a kiszereléshez használva vanak. Ezért Shoprenterben a Beállítások -> Lokáció beállítások -> Súly mértékegységek oldalon fel kell venni az alábbi mértékegységeket az “Új hozzáadása” gomb megnyomásával:

 

Súlymérték megnevezése

Rövidítés

Mililiter

ml

Deciliter

dl

Liter

l

Darab

db

 

Megrendelések részletei

A webshop tulajdonosok a “megrendelések” menüpont alatt érhetik el a megrendeléseik összefoglalóját.

Ezen az oldalon 6 hónapra visszamenőleg tekinthetőek meg havi összegzésben az egyes hónapok megrendeléseinek adatai. Itt látható az, hogy adott hónapban a webshopból mennyi megrendelés kerüét szinkronizálásra a nagyker felé, a megrendelésben mennyi fajta termék szerepelt és mekkora volt a megrendelések bruttó összértéke.

Fontos, hogy a jelenlegi, még nem lezárt hónap adatai folyamatosan változhatnak, ahogy a megrendelések alakulnak. A lezárt hónapok adatai viszont véglegesek. (Lezárt hónapnak tekintjük azt a hónapot, aminek lezáródott az utolsó napja is.)

Egy adott hónapra kattintva listázódnak az adott hónap minden megrendelése, amit az Octopus rendszerébe szinkronizáltunk. A megrendelések a megrendelések azonosítói szerint csökkenő sorrendben láthatóak egy táblázatos formában. A megrendeléseket a Shoprenter egyedi megrendelés azonosítói alapján lehet beazonosítani.

Egy azott megrendelésre kattintva pedig megjelnnek azok adatai.