A shopGold összekapcsolása az easySalesszel: a connector beállítása
Kapcsold össze a shopGold-webáruházadat az easySalesszel: töltsd fel a kétfájlos connectort az API kulcsoddal, mappeld a rendelési státuszokat, katalógusszámok és mi szinkronizálódik merre.
Mit csinál a shopGold-kapcsolat
A shopGold egy lengyel webáruház-szoftver, amely a saját szervereden fut. Az easySalesszel összekapcsolva behozza a webáruházad termékeit és rendeléseit az easySalesbe, az easySalesből naprakészen tartja a webáruház készletét, és visszaküldi a webáruháznak a rendelések státuszát.
Három dolog, amit érdemes tudnod, mielőtt elkezded:
- A kapcsolat egy kis connector, amelyet feltöltesz a webáruházadba. Letöltesz két fájlt az easySalesből, az egyikbe beilleszted az API kulcsodat, és mindkettőt feltöltöd a webáruház gyökérmappájába, az
index.phpmellé. - Minden terméknek és változatnak kell katalógusszám (Nr katalogowy). Az easySales ez alapján azonosítja a termékeket. A katalógusszám nélküli termék nem kerül importálásra, és az ilyen terméket tartalmazó rendelést az easySales elutasítja.
- A csatlakozás után mappeld a rendelési státuszokat. A shopGold státuszai a saját státuszaid, ezért az easySalesnek tudnia kell, melyik jelent új, teljesített vagy törölt rendelést. Amíg nem mappeled őket, minden rendelés New marad.
Mielőtt elkezded
Hozzáférés a webáruház fájljaihoz
FTP-n vagy a tárhelyed fájlkezelőjén keresztül, két fájl feltöltéséhez.
Katalógusszám minden terméken
Nr katalogowy minden terméken és minden változaton.
Egy egyszerű szövegszerkesztő
Például a Jegyzettömb (Notepad), hogy beilleszd az API kulcsot a connectorba.
1. lépés — Add hozzá a webáruházat az easySalesben
Menj az Integrációk → Webáruházak oldalra, és kattints a Bejelentkezés a weboldalba gombra. Töltsd ki a webáruház adatait:
| Mező | Mit írj bele |
|---|---|
| Weboldal neve | A webáruház neve, amelyet az easySalesben használsz. |
| Weboldal URL-je |
A webáruházad címe pontosan úgy, ahogy a böngészőben megnyílik — ugyanazzal a https:// előtaggal, és ugyanúgy www.-vel vagy anélkül. Az easySales nem követi az átirányításokat.
|
| Ország | A webáruház országa, Lengyelország. |
| ÁFA | A webáruházad áraiban foglalt ÁFA-kulcs, általában 23%. |
| Szállítási ÁFA | A szállítás ÁFA-kulcsa. |
| Nyelv, Pénznem | A webáruház nyelve és pénzneme. |
| Új rendelés egyedi státusza | Opcionális: az az egyedi státusz, amelyet az új shopGold-rendelések az easySalesben kapnak. |
| A raktáron levő termékek forrása | Hol tartod nyilván a webáruház készletét: Klasszikus raktár egy forrással, például EasySales, vagy Fejlett raktár. |
| Csomagtípus | Az a csomagtípus, amelyet az új rendelések kapnak, és amelyet a címkéik létrehozásakor használsz. |
| Számlák sorozata | Az ennek a webáruháznak a rendeléseihez kiállított számlák sorozata. |
2. lépés — Töltsd fel a connectort a webáruházadba
Az adatok alatt válaszd a shopGold csempét, majd a ShopGold verziót. A Részletek fülön látod a beállítás lépéseit, a Modul letöltése gombot és az API kulcs mezőt.
- Kattints a Modul letöltése gombra, és csomagold ki a fájlt. Benne van az
easy-sales-api.phpés azeasy-sales-api-key.php. - Nyisd meg az
easy-sales-api-key.phpfájlt egy egyszerű szövegszerkesztőben, például a Jegyzettömbben (Notepad), és illeszd be az API kulcs értékét az idézőjelek közé. Az idézőjelek maradjanak egyenesek — egy dokumentumszerkesztő átalakítja őket, és ettől a fájl elromlik. - Töltsd fel mindkét fájlt a webáruház gyökérmappájába, az
index.phpmellé. - Az easySalesben kattints a Mentés gombra. Az easySales teszteli a kapcsolatot, és betölti a webáruházad rendelési státuszait és fizetési módjait.
3. lépés — Mappeld a rendelési státuszokat
Nyisd meg újra a webáruházat, és válaszd a Preferenciák lehetőséget.
- Rendelési státusz mappelése: minden shopGold-státuszhoz válaszd ki azt az easySales-státuszt, amelyet jelent — például egy rendelés, amelyet a webáruházad elküldöttnek jelöl, az easySalesben Completed. A nem mappelt státusz New-ként érkezik.
- Rendelési státusz küldése a ShopGold felé: válaszd ki azt a shopGold-státuszt, amelyet egy rendelés kap, amikor az easySalesben teljesíted, törlöd vagy visszaküldöttnek jelölöd. Csak ez a három kerül elküldésre; a hozzárendelés nélkül hagyott státusz nem kerül elküldésre.
Kattints a Mentés gombra.
Mi szinkronizálódik
| A shopGoldból az easySalesbe | Az easySalesből a shopGoldba |
|---|---|
| Kategóriák és termékek, árakkal, képekkel, leírásokkal és tulajdonságokkal | Készlet |
| Új és frissített rendelések, az átvételi ponttal, ha a vevő választott egyet | A rendelés státusza, amikor teljesítesz, törölsz vagy visszaküldöttnek jelölsz egy rendelést |
| Követési számok, bekapcsolt Dokumentumok lekérése a webáruházból opcióval | Az általad létrehozott címke követési száma |
- A rendelések a csatlakozás után azonnal elkezdenek beérkezni. A termékeket az easySales néhány óránként olvassa be, ezért hagyj időt az első importnak, mielőtt az új rendelésekkel dolgozol: az a rendelési tétel, amely a terméke létrejötte előtt érkezik, termék nélkül marad, és nem foglal le készletet.
- Készlet: ha a webáruház készletforrása EasySales, az easySales minden változáskor elküldi a webáruháznak az egyes termékek készletét. Ha a forrás a webáruház, az easySales 30 percenként beolvassa a webáruház készletét.
- Követési számok: amikor egy rendelés címkét kap az easySalesben, annak követési száma elküldésre kerül a webáruháznak. A shopGoldban megadott követési számok behozatalához kapcsold be a Dokumentumok lekérése a webáruházból opciót a Preferenciák alatt.
- Az árakat az easySales a webáruházból olvassa be. A shopGoldban módosítsd őket.
A connector frissítése
Amikor az easySales új connectort ad ki, a webáruházadban csak az easy-sales-api.php fájlt cseréld le. Az easy-sales-api-key.php maradjon változatlan — a benne lévő kulcs érvényes marad. Ha megnyomod az API kulcs melletti frissítés gombot, illeszd be újra az új kulcsot az easy-sales-api-key.php fájlba.
Ha valami nem működik
| Üzenet | Teendő |
|---|---|
| Connection failed. Make sure easySales module is properly configured. If you need assistance, please contact us. |
Ellenőrizd, hogy mindkét fájl a webáruház gyökérmappájában van-e, a kulcs be van-e illesztve az easy-sales-api-key.php fájlba, és a Weboldal URL-je pontosan egyezik-e a webáruház címével.
|
| Set your easySales key in easy-sales-api-key.php | A kulcsfájl még üres. Illeszd be az API kulcsot az idézőjelek közé, és töltsd fel újra a fájlt. |
| easy-sales-api-key.php was changed. Upload a clean copy from the release zip and paste the key again. | A kulcsfájl szerkesztés közben megsérült. Vedd ki újra a zip-fájlból, illeszd be a kulcsot egy egyszerű szövegszerkesztőben, és töltsd fel. |
| Shop configuration not found. Upload this file inside your shopGold directory, or fill in the database settings at the top of it. |
A fájlok nincsenek a webáruház gyökérmappájában. Helyezd át őket az index.php mellé.
|
| The product.sku field is required. | A terméknek nincs katalógusszáma a shopGoldban. Töltsd ki a Nr katalogowy mezőt a terméknél és minden változatánál. |
| order.order_products.1.sku jest obowiązkowe. | A rendelés egyik termékének nincs katalógusszáma. Töltsd ki a shopGoldban; a rendelés a következő ellenőrzéskor érkezik be. |