Hogyan kapcsold össze a Skroutzot az easySalesszel: teljes integrációs útmutató
Árulj a Skroutzon, Görögország legnagyobb piacterén, és kezeld mindezt egyetlen felületről. Az easySales terméklistán (feed) keresztül teszi közzé a katalógusodat a Skroutzon, automatikusan fogadja a Skroutz-rendeléseidet, és a Merchant API-tokeneddel visszaküldi a rendelés elfogadását, a nyomon követést és a számlákat. Ez az útmutató végigvezet a Skroutz összekapcsolásán, a termékek listázásán, valamint azon, hogyan működik a rendelés, a szállítás és a számlázás.
Miért érdemes összekapcsolni a Skroutzot az easySalesszel
A Skroutz Görögország legnagyobb piactere és árösszehasonlító platformja, és az itteni értékesítés azt jelenti, hogy rendben kell tartanod a listázásokat, a rendeléseket és a számlákat. Az easySales egyetlen felületre hozza a Skroutzot a többi értékesítési csatornád mellé, így egyetlen katalógust és egyetlen rendelésfolyamot kezelsz ahelyett, hogy képernyők között kapcsolgatnál.
Az összekapcsolás után a Skroutz-rendeléseid úgy érkeznek az easySalesbe, hogy készen állnak a számlázásra, a folyamatokkal (automatizálásokkal) való feldolgozásra és a szállításra. A katalógusod ellenkező irányba halad: az easySales közzéteszi a termékeidet a Skroutzon, és naprakészen tartja azok árát és készletét, így egyetlen katalógust vezetsz ahelyett, hogy minden egyes Skroutz-listázást kézzel szerkesztenél.
Hogyan működik a Skroutz-csatlakozó
A Skroutz egy hibrid integráció — részben terméklista, részben élő API —, ezért érdemes megérteni a felosztást, mielőtt belekezdesz.
- A katalógusod terméklistán (feed) keresztül megy ki. Az easySales egy XML terméklistát épít a listázásaidból — nevek, leírások, márkák, EAN-ok, kategóriák, képek, árak, ÁFA, készlet, súly és tulajdonságok —, és visszatérő ütemezés szerint frissíti. A Skroutz ebből a listából olvassa be és frissíti a listázásaidat.
- A rendelések webhookon keresztül érkeznek. A Skroutz minden új és frissített rendelést közvetlenül az easySalesbe küld, ahol a Rendelések és ügyfelek → Rendelések alatt jelenik meg, készen a számlázásra és a folyamatokra.
- A rendelési műveletek a Merchant API-tokeneden keresztül mennek vissza. A kapcsolatba beillesztett token teszi lehetővé, hogy az easySales a Skroutz-rendeléseiden műveleteket végezzen — elfogadja vagy elutasítsa őket, elküldje a nyomon követési adatokat, és feltöltse a számlákat a Skroutzra.
Mivel a katalógus oldala terméklistán fut, néhány dolog másképp működik, mint egy tisztán API-alapú piactéren. Az easySalesben végzett módosítások nem azonnaliak a Skroutzon — a következő terméklista-frissítéssel utaznak. És a folyamat helyenként egyirányú: az easySales nem olvassa vissza az ajánlataid státuszát a Skroutzról, és a meglévő Skroutz-listázások nem importálódnak az easySalesbe.
Előfeltételek — mit készíts elő, mielőtt belekezdesz
Néhány dolognak a helyén kell lennie az első szinkronizálás előtt.
Egy aktív Skroutz eladói fiók
Szükséged van egy élő Skroutz eladói fiókra, amely készen áll a terméklistád fogadására és a rendelések küldésére. Ha még nincs ilyened, írj a international-sales@skroutz.gr címre a regisztrációhoz.
Súllyal ellátott termékek
A Skroutz-ajánlatok az easySales termékeidből épülnek fel, és a Skroutz mindegyiknél megköveteli a súlyt — állítsd be kilogrammban a közzététel előtt.
A Skroutz Merchant API-tokened
A Skroutz ezt a terméklistád érvényesítése után bocsátja ki, így nincs rá szükséged az első napon — először összekapcsolsz, majd később adod hozzá a tokent.
Egy előkészített számlázási sorozat
Egy számlázási sorozat, amely megegyezik a számlázószoftvereddel, hogy az importált Skroutz-rendelések a kezdetektől helyesen legyenek számozva.
1. lépés — Kapcsold össze a Skroutzot az easySalesben
Az easySalesben az oldalsávból lépj az Integrációk → Piactér menüpontra, keresd meg a Skroutz kártyát, és kattints rajta a Bejelentkezés gombra. Megnyílik a Skroutz beállítási űrlapja két füllel: Fő beállítások (az alapkonfiguráció) és További beállítások (a szinkronizálási viselkedés). Először a Fő beállításokban fogsz dolgozni.
A Fő beállítások fülön add meg, hogyan építse fel az easySales a terméklistádat, hogyan árazza az ajánlataidat, és hogyan kezelje a rendeléseidet:
- Kapcsolat neve — egy általad választott címke ehhez a kapcsolathoz. Csak az easySalesen belül látható.
- Ár növelése — egy opcionális százalék, amely rákerül a termékárra, amikor egy új ajánlat kerül közzétételre a Skroutzon. Az újonnan létrehozott ajánlatokra vonatkozik.
- ÁFA kulcs a szállításra — a Skroutz-rendeléseid szállítási tételére alkalmazott ÁFA-kulcs.
- Alapértelmezett ÁFA kulcs — az ajánlataidra és rendeléseidre alkalmazott alapértelmezett ÁFA-százalék. Állítsd 0-ra, ha nem vagy ÁFA-fizető.
- API Token — a Skroutz Merchant API-tokened. Egyelőre hagyd üresen; a Skroutz akkor bocsátja ki, miután érvényesítette a terméklistádat, és ide fogsz visszatérni, hogy beilleszd (lásd a 4. lépést).
- Számlázás sorozatszáma — az importált Skroutz-rendelésekhez rendelt alapértelmezett számlázási sorozat, amely megegyezik a számlázószoftveredben használt sorozattal.
- Csomagok típusa — hogy a küldeményeid alapból borítékként vagy csomagként menjenek.
- Méret attribútumok és Szín attribútumok — azok a terméktulajdonságok, amelyeket a Skroutz egy variáció méreteként és színeként olvas be. Ezek leképezése teszi lehetővé, hogy a Skroutz egyetlen családba csoportosítsa a variánsaidat (lásd a 3. lépést).
- Ajánlatokból kizárt tulajdonságok — bármely tulajdonság, amelyet nem szeretnél beleírni a Skroutz-terméklistádba.
- Tulajdonságok megjelenítése a termékleírásban és Termék dokumentáció helyi nyelven — szabályozzák, hogyan jelennek meg a tulajdonságok és a termékszöveg a Skroutzon.
- Kézbesítési napok — az ajánlataiddal közzétett feldolgozási idő.
- Rendelés véglegesítése AWB létrehozásakor és a szállítási beállítások — az alábbi rendelésekről szóló szakaszban tárgyaljuk.
Kattints a Mentés gombra a kapcsolat létrehozásához.
2. lépés — Listázd a termékeidet, és küldd el a terméklistáidat a Skroutznak
A fiók összekapcsolása önmagában még nem teszi ki a katalógusodat a Skroutzra — te választod ki, mely termékeket listázod.
Az oldalsávból lépj az Online Áruházak → Termékek menüpontra, jelöld ki a Skroutzon értékesíteni kívánt termékeket, majd a tömeges műveletek sávjából használd az Ajánlat(ok) hozzáadása a műveletet, kiválasztva a Skroutz-kapcsolatodat. Az easySales minden termékhez létrehoz egy Skroutz-ajánlatot, a katalógusodban hozzá kapcsolva. Ettől kezdve az ajánlat a terméklistádban utazik, a készlete és az ára pedig a forrástermékhez marad kötve. Csak az aktív, szinkronizált és katalógustermékhez kapcsolt ajánlatok kerülnek be a terméklistába. A közzétett ajánlataid a Piactér → Ajánlatok alatt, a Skroutz fülön jelennek meg, ahol áttekintheted és szerkesztheted őket.
Amikor mented a kapcsolatot, az easySales két terméklistát generál, amelyek működtetik az integrációt. Mindkettő megjelenik a Skroutz kártyádon az Integrációk → Piactér alatt:
- Feed URL — az XML terméklista, amelyet a Skroutz beolvas a listázásaid felépítéséhez és frissítéséhez.
- Orders URL — a cím, ahová a Skroutz elküldi a rendeléseidet.
Az easySales nem regisztrálja automatikusan ezeket az URL-eket — a Skroutz kártyádról másolod ki, és átadod őket a Skroutznak, és mindegyik más helyre kerül a Skroutz Merchants fiókodban:
- Feed URL — küldd be a Services → XML file (XML-fájl) alatt: érvényesítsd a terméklistádat, majd használd a Send XML link műveletet. A Skroutz csapata további ellenőrzéseket futtat, és befejezi az átvizsgálást.
- Orders URL — a Skroutzon nyisd meg a Services → Skroutz Marketplace menüt, és görgess le az Integration with the online store → Order webhooks részhez: illeszd be az URL-t a Webhook URL mezőbe, és pipáld be az Enable jelölőt, hogy a Skroutz elkezdje az easySalesbe küldeni a rendeléseidet.
Az élesítés egy működési lépés, amely eltarthat egy ideig, nem történik azonnal. Egy összekapcsolt terméklista rendelések nélkül normális, amíg a Skroutz még beépíti (onboarding) a terméklistádat.
Variációk családba csoportosítása
Ha egy terméket több méretben vagy színben árulsz, a Skroutz a variánsokat egyetlen családlistázásként tudja megjeleníteni külön termékek helyett. Az easySales ezt a csoportosítást teljes egészében a saját termékadataidból építi fel — a termékcsalád és annak tulajdonságai —, plusz egy apró leképezésből, amelyet a kapcsolaton állítasz be. Így illeszkednek össze a részek:
- A család a termékstruktúrádból származik. Az egymáshoz tartozó variánsoknak közös szülőterméket kell megosztaniuk az easySalesben (ugyanaz a variációs család). Az easySales ezt automatikusan átveszi, ha a termékek már csoportosítva vannak a forrásáruházadban; egyébként kézzel vagy Excel-importtal állítod be a variációt minden egyes ajánlaton. Azok a variánsok, amelyek nem osztoznak szülőn, önálló listázásként kerülnek a Skroutzra, a családlistázás pedig a nevét a szülőtermékből veszi.
- A méret- és színértékek a termék tulajdonságaiból olvasódnak be. Minden variáns mérete — és színe — közvetlenül az adott termék saját tulajdonságaiból származik, például egy „” tulajdonságból „” értékkel, vagy egy „” tulajdonságból „” értékkel. Ezeket nem kell újra beírnod a Skroutzhoz; a termékből húzódnak át.
- Te képezed le, melyik tulajdonság a méret és melyik a szín. A kapcsolat Fő beállítások fülén használd a Méret attribútumok mezőt, hogy megmondd az easySalesnek, melyik tulajdonság tartalmazza a méretet, a Szín attribútumok mezőt pedig a színhez. Ez a leképezés az, ami a terméktulajdonságaidat a Skroutz méret- és színdimenzióivá alakítja.
Két feltétel dönti el, hogy egy család ténylegesen kialakul-e:
- Egy méret attribútumot le kell képezni. A család a méretdimenzió köré épül — ha nem képeztél le Méret attribútumot, vagy egy terméknek nincs rá értéke, az a termék önálló listázásként megy ki, ahelyett hogy családhoz csatlakozna. Egy Szín attribútum önmagában való leképezése nem hoz létre családot; csak a színdimenziót adja hozzá a méret szerint már csoportosított variánsokhoz.
- A méret- vagy színérték nem szerepelhet az ajánlat címében. Egy család variánsai ugyanazt a terméknevet osztják, a méret pedig a saját mezőjében él, ezért ne írd bele a „” vagy „” szöveget a címbe — különben a Skroutz nem tudja tisztán csoportosítani őket.
Az attribútum leképezése csak azt mondja meg az easySalesnek, melyik tulajdonságot olvassa be — neked még ki kell töltened azt a tulajdonságértéket minden terméken. Az easySales sosem talál ki méretet, így egy olyan termék, amelynek a méret-tulajdonsága üres, méret nélkül kerül elküldésre, és nem csatlakozik családhoz. Ez a leggyakoribb oka annak, hogy egy méret hiányzik a Skroutz-terméklistából. Ha több terméknél hiányzik az érték, töltsd ki tömegesen a Mass edit (tömeges szerkesztés) segítségével a Skroutz-ajánlataid listájából. Egy olyan termékhez, amelynek valóban nincs mérete, add meg a szó szerinti One Size értéket (angolul) azon a tulajdonságon — a Skroutz pontosan ezt a szöveget várja, és az easySales változatlanul küldi. Ha az értékek a helyükön vannak, az easySales automatikusan generálja a méretvariációkat azokhoz a termékekhez, amelyek már variánsként vannak csoportosítva — nincs szükség további beállításra.
3. lépés — Finomhangold a szinkronizálást
A További beállítások fül azt szabályozza, hogyan szinkronizál az easySales a Skroutzcal, miután a kapcsolat élesedett.
- MPN küldése — válaszd ki, mit küldjön az easySales a Skroutznak a termék MPN-jeként (gyártói cikkszám). Négy lehetőség van: ne küldjön semmit, az ajánlat SKU-ja, a Szülő SKU (a szülőtermék SKU-ja — hasznos a csoportosított variánsokhoz, amelyeknek egy közös MPN-t kellene megosztaniuk), vagy egy adott tulajdonság értéke. Ha a Tulajdonság lehetőséget választod, megjelenik egy második mező, ahol kiválasztod, melyik tulajdonságot küldd (Válasszon MPN tulajdonságot).
- Ajánlatok automatikus engedélyezése, ha a termékek készleten vannak — automatikusan újraaktiválja az ajánlatokat, amint egy termék nulla feletti készletre tér vissza.
4. lépés — Add meg az API-tokent, miután a Skroutz érvényesíti a terméklistát
Ez az a rész, amelyen az eladók elakadnak, ezért érdemes világosan kiemelni. A Skroutz nem ad neked Merchant API-tokent előre — azután bocsátja ki, hogy érvényesítette a nekik elküldött terméklistát. A sorrend tehát:
- Kapcsold össze a Skroutzot az easySalesben, és listázd az ajánlataidat (1–2. lépés).
- Küldd el a Feed URL-t és az Orders URL-t a Skroutznak.
- Miután a Skroutz jóváhagyta a terméklistádat, generáld le a Merchant API-tokenedet a Skroutz Merchants fiókodban a Products → API alatt, a Generate a new API token használatával. A Skroutz egyszerre csak egy aktív tokent tart meg, így egy új generálása felülírja a korábbi kulcsot.
- Vissza az easySalesben, nyisd meg a Skroutz-kapcsolatodat, illeszd be a tokent a Fő beállítások API Token mezőjébe, és ments.
Amíg a token nincs a helyén, a rendelések meg tudnak érkezni, de az easySales nem tudja elfogadni őket, sem nyomon követést és számlákat visszaküldeni a Skroutznak — ezek a műveletek mind a tokennel hitelesítenek. Ha azt látod, hogy jönnek a rendelések, de nem fogadódnak el, egy üres API Token az első dolog, amit ellenőrizned kell.
Hogyan működnek a Skroutz-rendelések, a szállítás és a számlák
A rendelések a Skroutz azon része, amely önállóan fut. Az easySales nem húzza le a rendeléseket a Skroutzról — a Skroutz minden rendelést az Orders URL-edre küld, így a Skroutz irányítja a kézbesítést. Az easySales mindegyiket importálja, EAN alapján párosítva a termékeket, és mindent euróban árazva. Amint az API-tokened a helyén van, az easySales automatikusan visszaigazolja a rendelést a Skroutzon, és foglal egy futár-átvételi időablakot. Az Átvételi időablak késleltetése beállítás dönti el, melyik idősávot foglalja le: alapból bekapcsolva a legkésőbbi elérhető ablakot veszi; kapcsold ki, hogy a legkorábbit foglalja.
Mivel a kézbesítés push-alapú, ha egy rendelés valaha nem érné el az easySalest, magad is újraküldheted a Skroutzról: nyisd meg azt a rendelést a Skroutz Merchants fiókodban, és annak Webhook paneljén kattints a New Request gombra, hogy újra elküldd.
A szállítás kétféleképpen működhet, és kapcsolatonként te választasz:
- A Skroutz biztosítja a címkét. Kapcsold be az AWB csatolása a piactérről beállítást, és az easySales csatolja a Skroutz által a rendeléshez kiállított szállítási utalványt, így nem kell külön AWB-t generálnod.
- Te generálod az AWB-t. Generáld le a szállítási címkét az easySalesben a szokásos módon, és az easySales visszaküldi a nyomon követési adatokat a Skroutznak. A Skroutz ehhez rögzített futárkészletet ismer fel — DPD, DHL, GLS, ACS, Speedex, ELTA és Geniki Taxydromiki —, ezért használj egyet ezek közül, hogy a nyomon követés bejegyződjön a Skroutzon.
A számlák is visszaküldésre kerülnek: amikor számlát generálsz egy Skroutz-rendeléshez, az easySales automatikusan feltölti a PDF-et a Skroutzra. A Rendelés véglegesítése AWB létrehozásakor alapból be van kapcsolva, így az easySales véglegesítettként is megjelöli a rendelést, amint annak szállítási címkéje csatolva van — kapcsold ki, ha inkább magad kezelnéd ezt a státuszt.
| Skroutzról → easySalesbe | easySalesből → Skroutzra |
|---|---|
| Rendelések (új és frissített) | Terméklistázások — név, leírás, márka, kategória |
| A szállítási címke (AWB), ha a Skroutzot szállíttatod | EAN, képek, súly és tulajdonságok |
| — | Ár euróban (ÁFÁ-val) és készlet-elérhetőség |
| — | Rendelés elfogadása / elutasítása és nyomon követési frissítések |
| — | Számlák (feltöltve a Skroutzra) |
Össze vagy kapcsolva — mi a következő
Mostmár érkeznek a rendelések, a következő lépés az automatizálás: állíts be folyamatokat a Feldolgozás → Folyamatok alatt, hogy számlákat generálj és feldolgozd a rendeléseket, ahogy beérkeznek. Tartsd szemmel az ajánlataidat a Piactér → Ajánlatok alatt, a Skroutz fülön, ahol az érvényesítésen elbukó ajánlatok meg vannak jelölve — és fordulj a ügyfélszolgálathoz, ha valami nem stimmel.
Kapcsold össze a Skroutzot, és árulj egész Görögországban egyetlen felületről
Próbáld ki az easySalest ingyen 14 napig. Bankkártya nem szükséges.