Piacterek

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ó?