Piactéri integrációk

Az Okazii csatlakoztatása az easySales-hez: teljes beállítási útmutató

Az Okazii csatlakoztatása az easySales-hez: teljes beállítási útmutató

Kösd össze az Okazii-t az easySales-szel: a kapcsolat beállításai, a Feed URL és annak megadása az Okazii-ban, mely ajánlatok jutnak el ténylegesen a feedbe, és hogyan érkeznek vissza a rendelések, számlák és AWB-k.

Így működik az Okazii integráció

Az Okazii nem úgy kapcsolódik, ahogy a legtöbb piactér, és ha ezt előre tudod, később rengeteg félreértést megspórolsz.

Az ajánlataidat az easySales soha nem tolja ki az Okazii felé. Az easySales összeállít egy XML fájlt — ez a feed —, és közzéteszi egy privát címen. Az Okazii saját ütemezése szerint letölti ezt a fájlt, és importálja, ami benne van. A termékeid, az áraid és a készleted kizárólag ezen az úton jutnak ki.

A rendelések a másik irányban, az Okazii API-ján keresztül érkeznek, az Okazii-fiókodból származó tokennel. Az easySales minden rendeléshez visszaküldi a számlát és az AWB-számot is.

A beállításnak tehát két fele van: az egyik az easySales-ben, a másik az Okazii felületén. Egyik sem működik a másik nélkül.

Mielőtt nekikezdesz

✓

Okazii eladói fiók

Hozzáféréssel a bolt adminisztrációs felületéhez, mert a beállítás fele ott zajlik.

✓

Az Okazii API Tokened

Az Okazii felületén, a a bolt adminisztrációs felületén, az API-beállítások között. Csak a számokból álló részt másold ki. Nélküle az easySales egyetlen rendelést sem tud beolvasni.

✓

Eladásra kész termékek

Mindegyiknek kell név, SKU, legalább egy kép, legalább 0,10 ár és nullánál nagyobb készlet. Bármelyik hiánya kint tartja a terméket a feedből — lásd az alábbi ellenőrzéseket.

✓

Egy döntés az ÁFÁ-ról

A kapcsolaton az Alapértelmezett ÁFA kulcs mondja meg az easySales-nek, hogy az Okazii-áraid tartalmaznak-e ÁFÁ-t. Mentés előtt tudd, melyik eset áll fenn.

1. lépés — Kösd össze az Okazii-t az easySales-ben

Menj a Beállítás → Integrációk → Piactér oldalra, keress rá az Okazii-ra, és nyisd meg a kártyáját.

A Piactér oldal az easySales-ben Okazii-ra szűrve: a csatlakoztatott Okazii-kártya a román zászlóval és a Szerkesztés művelettel.
Az Okazii a Beállítás → Integrációk → Piactér oldalon.

Töltsd ki a jobb oldali űrlapot.

Az Okazii kapcsolati űrlap teteje: Kapcsolat neve, Új rendelés egyedi státusza, Ár növelése, ÁFA kulcs a szállításra, Alapértelmezett ÁFA kulcs és Számlázás sorozatszáma.
Az űrlap első fele. Az Alapértelmezett ÁFA kulcs dönti el, hogy az áraid ÁFÁ-val mennek-e ki.
Mező Mit írj bele
Kapcsolat neve Kötelező. A te saját elnevezésed ehhez az Okazii-fiókhoz. Több fiók esetén ezek lesznek a fülek nevei.
Új rendelés egyedi státusza Nem kötelező. Egy saját státusz, amelybe minden beérkező Okazii-rendelés kerül.
Ár növelése Kötelező. Az a százalék, amellyel a rendszer megemeli a termék árát az ajánlat létrehozásakor. Az érték abban a pillanatban rögzül az ajánlaton, tehát ha később megváltoztatod, az nem árazza át a már létező ajánlatokat.
ÁFA kulcs a szállításra Az az ÁFA-kulcs, amelyet a rendszer az importált rendelés szállítási sorára alkalmaz. Nem a szállítás díja, hanem a rá vonatkozó adókulcs.
Alapértelmezett ÁFA kulcs Kötelező, és fontosabb, mint amilyennek látszik — lásd alább.
Számlázás sorozatszáma Kötelező. Ezt a sorozatot használja a rendszer, amikor számla készül egy Okazii-rendeléshez. Rendelésenként továbbra is módosítható.
Csomagok típusa Boriték vagy Csomag, ez lesz az alapértelmezés ezeknek a rendeléseknek az AWB-jén.
Leírás típusa Azt dönti el, hogy a feed a saját termékleírásodat viszi-e („Termékleírás használata"), vagy a termék tulajdonságaiból generáltat („Tulajdonságok automatikus létrehozása"). Az Okazii nem fogad el HTML-t.
API Token Kötelező. Az Okazii-fiókodból, a a bolt adminisztrációs felületén, az API-beállítások között — csak a számokból álló részt másold ki.
A kapcsolati űrlap

Az űrlap többi része azt szabályozza, hogyan írja le a feed a termékeidet.

Az Okazii kapcsolati űrlap alsó fele: Csomagok típusa, Leírás típusa, API Token, Méret attribútumok, Szín attribútumok, Tulajdonságok beszúrása a feedbe és Ajánlatok automatikus engedélyezése, ha a termékek készleten vannak.
A második fél. Az API Token az, amitől a rendelésimport működik.
  • A Méret attribútumok és a Szín attribútumok mezőben mondod meg az easySales-nek, hogy a terméktulajdonságaid közül melyik hordozza a méretet és a színt, így a változatok egyetlen Okazii-hirdetésbe kerülnek több helyett.
  • A Tulajdonságok beszúrása a feedbe minden terméktulajdonságot beletesz a fájlba.
  • Az Ajánlatok automatikus engedélyezése, ha a termékek készleten vannak magától visszakapcsolja az ajánlatot, amint a termék újra készleten van.

2. lépés — Másold ki a Feed URL-t

A kapcsolat mentése után a bal oldali oszlopban megjelenik a Feed URL. Nagyjából így néz ki: https://app.easy-sales.com/feed/12345/487213904/okazii.xml, és minden csatlakoztatott Okazii-fióknak saját címe van.

Az Okazii kapcsolati oldal bal oldali oszlopa az easySales-ben: a Feed URL, alatta az Opciók sor az Összes ajánlat újraküldése és a Rendelések szinkronizálása művelettel.
A Feed URL az a cím, amelyet megadsz az Okazii-nak. Minden csatlakoztatott fióknak saját van.

Az URL feed frissítése és a Fiók hozzáadása — ez utóbbi egy második Okazii-fiókhoz, saját beállításokkal és saját Feed URL-lel — egyaránt a kártya ⋮ menüjében található.

A hárompontos menü megnyitva az Okazii-kártyán az easySales-ben: Fiók hozzáadása, Dokumentáció, URL feed frissítése és Regisztráció.
A kártya menüje. A Fiók hozzáadása egy második Okazii-fiókot köt be; az URL feed frissítése lecseréli a feed címedet.

3. lépés — Irányítsd az Okazii-t a feedre

Ez a fél az Okazii felületén zajlik, amely román nyelvű, függetlenül attól, milyen nyelven használod az easySales-t.

  1. Nyisd meg a Meniu → Administrează Magazin menüpontot (Menü → Bolt kezelése), vagy a Setări → Magazin → Administrare útvonalat (Beállítások → Bolt → Kezelés).
  2. Lépj az Administrează articole → Import Produse menüpontra (Cikkek kezelése → Termékek importálása), és válaszd az Import Automat lehetőséget (automatikus import).
  3. Illeszd be a Feed URL-t az Adaugă URL-ul Feedului mezőbe (add meg a feed URL-jét).
  4. Pipáld ki az Elimină din okazii produsele care nu apar în feed opciót (távolítsa el az Okazii-ról azokat a termékeket, amelyek nem szerepelnek a feedben).
  5. Mentsd a Salvează Opțiunile gombbal (beállítások mentése).

4. lépés — Hozd létre az ajánlataidat

Az Okazii-ajánlat mindig egy olyan termékből jön létre, amely már megvan az easySales-ben. Nyisd meg a Termékek oldalt, jelöld ki a kívánt termékeket, és használd az eszköztár Ajánlatok hozzáadása gombját — vagy egyetlen soron az Ajánlat hozzáadása műveletet —, majd válaszd az Okazii-t.

Az ajánlataid közül melyek jutnak el ténylegesen az Okazii-ra

Szinte minden „az Okazii csak néhány termékemet importálta" jellegű probléma mögött ez a kérdés áll. Egy ajánlat csak akkor kerül bele a feed fájlba, ha mind a négy állítás igaz rá:

Feltétel Hol látod
Az ajánlat Bekapcsolva állapotú Az Állapot kapcsoló az ajánlat sorában.
Az ajánlat Összekötve van egy termékkel Az Összekötve sor az ajánlat neve alatt.
Annak a terméknek a készlete nullánál nagyobb A Készlet sor az ajánlat neve alatt.
Az ajánlatnak nincs blokkoló hibája A Hibák oszlop.
Egy ajánlat csak akkor kerül a feedbe, ha mind a négy igaz

Mind a négyet egyetlen pillantással látod a Piactér → Ajánlatok → Okazii képernyőn.

Az Ajánlatok képernyő Okazii füle az easySales-ben, hat ajánlattal: fotó, név, összekötött SKU, készlet, ár, állapotkapcsoló és egy 1006 Missing product images hiba.
Minden, ami eldönti, hogy egy ajánlat eljut-e az Okazii-ra, ezen a képernyőn látszik: állapot, összekötött termék, készlet és hibák.

Az ellenőrzésen elbukó ajánlat kikapcsolódik, az okát pedig a Hibák oszlop mutatja.

Hiba Mit javíts
1000 Missing product name A terméknek nincs neve.
1001 Missing product sku A terméknek nincs SKU-ja.
1004 Invalid product price Az eladási ár 0,10 alatt van.
1005 Invalid images data Az ajánlat képei nem használható formában vannak. Mentsd újra a képeket a terméken.
1006 Missing product images A terméknek egyáltalán nincs képe. Messze ez a leggyakoribb.
Azok a hibák, amelyek kint tartják az ajánlatot a feedből

Mennyi idő alatt jelenik meg egy változás

Az easySales legfeljebb óránként egyszer építi újra a feed fájlt, és rendszerint csak azután, hogy az Okazii beolvasta az előző változatot. Ezután az Okazii-nak még le kell futtatnia a saját importját. A gyakorlatban egy frissen felvett ajánlat általában azután jelenik meg, hogy az Okazii kétszer letöltötte a fájlt, tehát számolj inkább néhány órával, mint azonnali megjelenéssel.

Kategóriák

Az ajánlat Kategória mezője egyszerű szöveg, amelyet a rendszer egyszer vesz át abból a kategóriából, amelybe a termék elsőként tartozik. Az easySales nem tárolja az Okazii kategóriafáját, ezért a saját kategórianeveid és az Okazii kategóriái közötti megfeleltetés magában az Okazii-ban történik, az Administrare Articole → Administrare Catalog menüpont alatt (Cikkek kezelése → Katalógus kezelése).

Ha meg akarod változtatni azt a szöveget, amelyet az easySales küld, az easySales-ben írd át: magán az ajánlaton (Piactér → Ajánlatok → Okazii → Szerkesztés), vagy egyszerre sok ajánlaton a Tömeges szerkesztés → Kategória és jellemzők szerkesztése művelettel. A kategória az ajánlat létrehozásakor rögzül, és utána nem frissül, tehát ha később megváltoztatod a termék kategóriáit, az nem változtat azon, amit a feed tartalmaz.

Rendelések

Az új Okazii-rendeléseket nagyjából percenként veszi át a rendszer, és naponta néhányszor egy szélesebb utólagos futás is végigmegy rajtuk. Ha ennél messzebbre kell visszanyúlnod, a kapcsolat oldalán ott az Opciók → Rendelések szinkronizálása, amely legfeljebb 30 napos időszakot fogad el.

Mi Irány Hogyan
Termékek, árak, készlet easySales → Okazii Az XML feed, amelyet az Okazii tölt le.
Rendelések Okazii → easySales Az Okazii API-ja, az API Tokeneddel.
A számla PDF-je easySales → Okazii Automatikusan kimegy, amint a számla elkészült.
Az AWB-szám easySales → Okazii Akkor megy ki, amikor létrehozod a fuvarlevelet. Ezzel egyben véglegesítettre is áll a rendelés az easySales-ben.
Rendelésstátusz semmi A státuszokat a rendszer soha nem küldi vissza.
Meglévő Okazii-hirdetések semmi Ezek soha nem kerülnek be az easySales-be.
Mi mozog az easySales és az Okazii között

Amikor elmaradnak a rendelések

Ha nincs hibasáv, és a rendelések egyszerűen sosem érkeznek meg, először a kapcsolaton lévő API Token mezőt nézd meg. Az a kapcsolat, amelyet még azelőtt mentettek, hogy a token kötelezővé vált, teljesen rendben lévőnek látszik — csatlakoztatottként jelenik meg, a feed is működik —, de egyetlen rendelést sem tölt le, és semmi nem figyelmeztet rá.

Utána haladj végig ezen a listán egy olyan termékkel, amely nincs fenn az Okazii-n:

  • Az ajánlat Bekapcsolva állapotú?
  • Összekötve van egy termékkel?
  • Van annak a terméknek nullánál nagyobb készlete?
  • Mutat az ajánlat hibát?
  • Az Okazii-ban megadott Feed URL az aktuális?

Az Okazii és a te piacod

Gyakran ismételt kérdések

Közvetlenül nem. Az easySales összeállít egy XML feed fájlt, és közzéteszi a Feed URL-eden; az Okazii letölti ezt a fájlt, és importálja, ami benne van. Az ajánlataidból semmit nem tolunk ki API-n az Okazii felé, ezért kell a Feed URL-t az Okazii oldalán helyesen beállítani, mielőtt bármi megjelenne.

Beállítás → Integrációk → Piactér, majd nyisd meg az Okazii-kapcsolatot. A Feed URL a bal oldali oszlopban látszik, az Opciók sor fölött. Ha több Okazii-fiókot kötöttél be, mindegyik kapcsolatnak saját címe van.

Egy termék csak akkor kerül a feedbe, ha az ajánlata Bekapcsolva van, Össze van kötve egy termékkel, annak a terméknek a készlete nullánál nagyobb, és az ajánlatnak nincs blokkoló hibája. Az elfogyott, a kikapcsolt, az össze nem kötött és a hibás ajánlatok teljesen kimaradnak a fájlból — általában ezért sokkal kisebb az Okazii által importált szám, mint ahány ajánlatot te látsz.

Az easySales nem nulla mennyiséget küld, hanem kihagyja azt a terméket a feedből. Az Okazii pedig csak akkor veszi le a hirdetést, ha az automatikus importja úgy van beállítva, hogy eltávolítja azokat a termékeket, amelyek már nem szerepelnek a feedben — ez az „Elimină din okazii produsele care nu apar în feed" opció. Ha ez nincs bepipálva, a hirdetés a régi készlettel fennmarad.

Az easySales legfeljebb óránként egyszer építi újra a feed fájlt, és rendszerint csak azután, hogy az Okazii beolvasta az előző változatot, tehát egy frissen felvett ajánlathoz általában kétszer kell letöltenie a fájlt az Okazii-nak. Számolj inkább néhány órával, mint azonnali megjelenéssel.

Az Okazii-fiókod API Tokene, elmentve a kapcsolaton. Nélküle egyáltalán nem importálódik rendelés, és nincs hibaüzenet sem, ami erre figyelmeztetne — a kapcsolat csatlakoztatottként látszik, és a feed is működik tovább. Ha a token megvan, a rendszer nagyjából percenként ellenőrzi a rendeléseket.

Nem. Ha egy rendelést az easySales-ben véglegesítettre, teljesítettre vagy töröltre állítasz, az az Okazii-n semmit nem változtat. Két dolog utazik vissza: a számla PDF-je, amint elkészült, és az AWB-szám a futárszolgálattal együtt, amint létrehoztad a fuvarlevelet.

Cargus, FanCourier, DPD, GLS, SameDay és Prioripost. Bármely más futárszolgálat esetén a címke elkészül az easySales-ben, de az Okazii elutasítja a csomagszámot, és neked kell beírnod az Okazii felületén.

Szüntesd meg az okot — ez leggyakrabban az API Token —, majd nyomd meg a Kapcsolat helyreállítása gombot az Okazii-kártyán. A kapcsolati űrlap egyszerű újramentése nem indítja újra a rendelésimportot. Vedd figyelembe, hogy ilyenkor csak a rendelések állnak le; a feedet a rendszer továbbra is kiszolgálja, tehát az ajánlataid élők maradnak az Okazii-n, miközben rendelés nem jön.

Nem. Az Okazii-ajánlatok mindig a saját easySales-termékeidből jönnek létre; a korábbi hirdetéseidből semmit nem olvasunk vissza.

Annak a kategóriának a nevével, amelybe a termék elsőként tartozik, egyszerű szövegként. Az easySales nem tárolja az Okazii kategóriafáját — a saját kategórianeveidet magában az Okazii-ban felelteted meg az Okazii kategóriáinak, az Administrare Articole → Administrare Catalog menüpont alatt. Az easySales által küldött szöveget az ajánlat szerkesztésével, vagy a Tömeges szerkesztés → Kategória és jellemzők szerkesztése művelettel változtathatod meg. A kategória az ajánlat létrehozásakor rögzül, és utána soha nem frissül.

Igen. Használd a kártya ⋮ menüjében a Fiók hozzáadása műveletet. Minden kapcsolatnak saját neve, saját beállításai és saját Feed URL-je van, tehát mindegyik Okazii-fiókba más címet illesztesz be.

Hasznos volt ez az útmutató?