===== Külső webshop csatlakoztatása ===== Az eVIR **webshop connector** modulja négy webáruház-platformmal tud kétirányú kapcsolatot tartani: **Unas**, **Shoprenter**, **Shopify** és **WooCommerce**. A termékek, kategóriák, árak, készletek az eVIR-ből mennek a webshopba, a megrendelések pedig a webshopból az eVIR vevői rendeléskezelőjébe. Vissza az áttekintőhöz: [[evir:folyamatok:logisztikai_folyamat|Az eVIR logisztikai folyamata]] ---- ==== Négy alapelv, amit érdemes előre tudni ==== * **Az eVIR az adatgazda.** A termékadatok az eVIR-ben keletkeznek, és onnan mennek a webshopba — nem fordítva. * **Csak a változás megy át.** A szinkron nem tölti fel mindig az összes terméket, csak amit módosítottak. * {{fa>exclamation-circle?lg}} **Az eVIR sosem töröl a webshopból.** Ha egy termék nem kell többé, azt a webshopban kell kezelni (vagy a láthatóságát átállítani). * **Kapcsolótáblák kötik össze a két rendszert.** Ha ezek megsérülnek, a szinkron rossz terméket frissít — ezért van külön ellenőrző funkció. Részletesen: [[evir:webshop_connector:alapelvek|A webshop connector alapelvei]] Üzleti, jogi és technikai előfeltételek (domain, tárhely, SSL, ÁSZF, GDPR): [[evir-faq:webshop_inditas|Webshop indítás]] ---- ==== A beüzemelés menete ==== digraph ws_kulso { rankdir=LR; node [shape=box, style=rounded, fontsize=10]; api [label="1. API-hozzáférés\na shop admin felületén"]; shop [label="2. Webshop felvétele\naz eVIR-ben"]; par [label="3. Paraméterek\n(kapcsolat, termék,\nrendelés letöltés)"]; torzs [label="4. Törzsadat-\nösszehangolás"]; cikk [label="5. Cikk-előkészítés\n(közös a belső shoppal)"]; rakt [label="6. Raktárak"]; sync [label="7. Szinkron\nbeállítása"]; ell [label="8. Ellenőrzés"]; fel [label="9. Első feltöltés\n(kötött sorrend!)"]; rend [label="10. Rendelés-\nletöltés élesítése"]; api -> shop -> par -> torzs -> cikk -> rakt -> sync -> ell -> fel -> rend; } A lépéseknél ''[KÖZÖS]'' = mind a négy platformnál azonos, a platformnév = csak arra vonatkozik. ---- ==== 1. API-hozzáférés a shop admin felületén ==== Ezt a lépést **nem az eVIR-ben**, hanem a webáruház saját admin felületén kell elvégezni. ^ Platform ^ Hol ^ Mit kell megszerezni ^ | **Unas** | Beállítások → Külső kapcsolatok → API kapcsolat | **API kulcs** → [[evir:unas:beallitas|Unas beállítás]] | | **Shoprenter** | Beállítások → API beállítások | **Felhasználónév + jelszó + API URL** → [[evir:shoprenter:beallitas|Shoprenter beállítás]] | | **Shopify** | Settings → Apps → Develop apps → custom app | **Admin API access token** {{fa>exclamation-circle?lg}} csak egyszer látható! Scope-ok: Inventory, Customers, Orders, Products → [[evir:shopify:beallitas|Shopify beállítás]] | | **WooCommerce** | WordPress admin | **REST API kulcs** (''ck_…'' / ''cs_…''), külön WP felhasználó a képekhez, HTTP basic auth bővítmény, **https mindkét oldalon** → [[evir:woocommerce:telepites|WooCommerce telepítés]] | === Shop-oldali kiegészítő beállítások === * **Adószámítás**: [[evir:shopify:taxes_and_duties|Shopify Taxes and duties]], [[evir:woocommerce:adoszamitas_beallitasok|WooCommerce adószámítás]] * **Shopify Location** (raktár-azonosító): [[evir:shopify:location|Shopify location]] * **Szállítási módok** a shop admin felületén: [[evir:unas:rendeles_szallitasi_mod|Unas]] · [[evir:shoprenter:rendeles_szallitasi_mod|Shoprenter]] · [[evir:shopify:rendeles_szallitasi_mod|Shopify]] · [[evir:woocommerce:rendeles_szallitasi_mod|WooCommerce]] * **Kedvezmények** a shop admin felületén: [[evir:unas:unas_kedvezmeny|Unas]] · [[evir:shoprenter:shoprenter_kedvezmeny|Shoprenter]] · [[evir:shopify:shopify_kedvezmeny|Shopify]] · [[evir:woocommerce:woocommerce_kedvezmeny|WooCommerce]] ---- ==== 2. Webshop felvétele az eVIR-ben [KÖZÖS] ==== - ''Webshop connector -> **Beállítás** -> Webshopok -> Új'' - **Típus** kiválasztása — csak a telepített modulokhoz tartozó típusok jelennek meg - **Név** megadása Részletesen: [[evir:webshop_connector:beallitas:webshopok|Webshopok]], [[evir:webshop_connector:beallitas:wconn_beallitas_menu|Beállítás menü]] ---- ==== 3. A webshop paramétereinek kitöltése ==== A webshop adatlapja területekre tagolódik. A váz közös, a mezők egy része platformfüggő. ^ Terület ^ Közös leírás ^ Platform-specifikus ^ | **Paraméterek** (típus, név, aktív, működés) | [[evir:webshop_connector:beallitas:parameterek|Paraméterek]] | – | | **Kapcsolat** (API) | [[evir:webshop_connector:beallitas:kapcsolat|Kapcsolat]] | [[evir:webshop_connector:beallitas:unas_kapcsolat|Unas]] · [[evir:webshop_connector:beallitas:shoprenter_kapcsolat|Shoprenter]] · [[evir:webshop_connector:beallitas:shopify_kapcsolat|Shopify]] · [[evir:webshop_connector:beallitas:woocommerce_kapcsolat|Woo]] | | **Termék** | [[evir:webshop_connector:beallitas:termek|Termék]] | [[evir:webshop_connector:beallitas:unas_termek|Unas]] · [[evir:webshop_connector:beallitas:shoprenter_termek|Shoprenter]] · [[evir:webshop_connector:beallitas:shopify_termek|Shopify]] · [[evir:webshop_connector:beallitas:woocommerce_termek|Woo]] | | **Rendelés letöltés** | [[evir:webshop_connector:beallitas:rendeles_letoltes|Rendelés letöltés]] | [[evir:webshop_connector:beallitas:unas_rendeles_letoltes|Unas]] · [[evir:webshop_connector:beallitas:shoprenter_rendeles_letoltes|Shoprenter]] · [[evir:webshop_connector:beallitas:shopify_rendeles_letoltes|Shopify]] · [[evir:webshop_connector:beallitas:woocommerce_rendeles_letoltes|Woo]] | | **Vevői rendelés** | [[evir:webshop_connector:beallitas:vevoi_rendeles|Vevői rendelés]] | – | | **Szolgáltatások** (szállítási díj, kezelési költség, egyéb díj, engedmény cikkszáma) | [[evir:webshop_connector:beallitas:szolgaltatasok|Szolgáltatások]] | [[evir:webshop_connector:beallitas:unas_szolgaltatasok|Unas]] · [[evir:webshop_connector:beallitas:shoprenter_szolgaltatasok|Shoprenter]] · [[evir:webshop_connector:beallitas:shopify_szolgaltatasok|Shopify]] · [[evir:webshop_connector:beallitas:woocommerce_szolgaltatasok|Woo]] | | **Hibakezelés** | [[evir:webshop_connector:beallitas:hibakezeles|Hibakezelés]] | – | Gyűjtőoldal: [[evir:webshop_connector:beallitas:webshop_beallitas|Webshop beállítás]] === A leglényegesebb platform-eltérések === * **Unas**: ''Szinkron tiltás vége'', ''Lezárt rendelések státusza'', ''Kezelési költség cikkszáma'', ''Vonalkód paraméterének neve'', ''Egyéb díj cikkszáma'' * **Shopify**: API **access token** (nem felhasználó/jelszó), ''Alapértelmezett raktár azonosító'' (Location, az első rendelésletöltéskor töltődik), ''Variánsok kezelése'', képszinkron ismeretlen képekre. {{fa>exclamation-circle?lg}} A rendelésletöltés **fizetési státusz** szerint működik (''paid'' / ''pending''), nem rendelés-státusz szerint. * **Shoprenter**: ''Kategória: Saját / Szülő és saját'', ''Fizetési díj cikkszám'' * **WooCommerce**: ''Wordpress felhasználó'' + ''Wordpress jelszó'' (a képfeltöltéshez a WP médiatárba), ''Egyéb díj cikkszám'' * **0 Ft árú termék kezelése**: Unas / Shopify / Shoprenter esetén beállítható, WooCommerce-nél nincs ilyen mező ---- ==== 4. Törzsadat-összehangolás [KÖZÖS — kritikus] ==== Ezek nélkül a letöltött rendelés nem tud korrekt vevői rendeléssé alakulni. - **Fizetési módok** — ''Törzsadatok -> Pénzügyi -> **Fizetési módok**'', az ''Unas / Shoprenter / Shopify / Woocommerce gateway'' mezőben kell megadni a webshop-oldali azonosítót. {{fa>info-circle?lg}} A mező csak akkor jelenik meg, ha az adott platform modulja telepítve van. → [[evir:torzsadatok:penzugyi:fizetesi_modok|Fizetési módok]] - **Rendelés folyamat állapotok** — ''Törzsadatok -> Rendelés -> **Rendelés folyamat állapotok**'', a ''… webshop beállítás'' mezőben. Az oldal kész megfeleltetési táblázatot ad mind a négy platformra. → [[evir:torzsadatok:rendeles:torzs_rendeles_folyamat_allapotok|Rendelés folyamat állapotok]] - **Szállítási módok** — ''Törzsadatok -> Rendelés -> **Szállítási mód**'', a ''… webshop beállítás'' mezőben a shop-oldali név betűhív másolatával (Shopify: ''Custom rate name'', Unas: ''Megnevezés'', Woo: ''Title'', Shoprenter: a szállítási mód neve) → [[evir:torzsadatok:rendeles:rendeles_szallitasi_mod|Szállítási mód]] - **Szolgáltatás-cikkszámok** létrehozása a cikktörzsben: szállítási díj, kezelési költség, egyéb díj, engedmény → [[evir:torzsadatok:cikktorzs:szolgaltatasok|Szolgáltatások]] - Opcionális: **futárcégek** (a csomagkövető URL feltölthető a webshopba) → [[evir:torzsadatok:rendeles:futarcegek|Futárcégek]] Részletesen: [[evir:webshop_connector:webshop_torzsadatok_beallitasai|Webshop törzsadatok beállításai]] ---- ==== 5. Cikk-előkészítés [KÖZÖS a belső webshoppal] ==== Ugyanaz a blokk, mint a belső webshopnál — az [[evir:folyamatok:elokeszites|Előkészítés — törzsadatok]] oldal //Webshopos cikk-előkészítés// szakasza írja le. Ezen felül a connectornél két külön döntés van: === Kategóriakezelési mód === * **Kategória törzsadatból** — a cikk kategóriák a szokásos törzsadatból mennek → [[evir:torzsadatok:cikktorzs:cikk_kategoriak|Cikk kategóriák]] * **1-9 kategória a cikk tulajdonságokból** — a kategóriastruktúra tulajdonságokból épül fel → [[evir:webshop_connector:webshop_kategoria_cikk_tulajdonsag|Kategória cikk tulajdonságból]] Részletesen: [[evir:webshop_connector:webshop_kategoria_kezeles|Webshop kategória kezelés]] {{fa>exclamation-circle?lg}} Kategória átnevezésének vannak buktatói: [[evir:webshop_connector:webshop_kategoria_modositas|Webshop kategória módosítás]] === Tömeges beállítás connectorral === * ''Webshop connector -> Beállítás -> **Cikkek beállítása**'' → [[evir:webshop_connector:beallitas:cikkek_beallitasa|Cikkek beállítása]] * ''Webshop connector -> Beállítás -> **Tulajdonságok beállítása**'' → [[evir:webshop_connector:beallitas:tulajdonsagok_beallitasa|Tulajdonságok beállítása]] === Shopify variánsok === Shopify esetén a variánsok kezelése önálló, 10 lépéses eljárás: [[evir:webshop_connector:variansok|Variánsok]] ---- ==== 6. Raktárak [KÖZÖS + platformfüggő] ==== Egy raktár esetén elég a webshop ''Termék'' területén az **Alapértelmezett raktár** beállítása. === Több raktár === ''Webshop connector -> **Beállítás** -> Egyéb raktárak'' {{fa>exclamation-circle?lg}} **Három feltétel, mind kell** — bármelyik hiánya esetén nem szinkronizál: - A raktár rögzítve a webshop oldalán - Az eVIR ''Egyéb raktárak'' beállításban felvéve a kapcsolat (webshop + eVIR raktár + webshop location) - Az ''Egyéb raktárak kezelése'' = **Engedélyezett** a webshop ''Termék'' területén ^ Platform ^ Shop-oldali raktárrögzítés ^ Végigvezető leírás ^ | Shopify | [[evir:shopify:raktarak_rogzitese|Raktárak rögzítése]] | [[evir:shopify:tobb_raktar_kezelese|Több raktár kezelése]] | | Unas | [[evir:unas:raktarak_rogzitese|Raktárak rögzítése]] | [[evir:unas:tobb_raktar_kezelese|Több raktár kezelése]] | | WooCommerce | [[evir:woocommerce:raktarak_rogzitese|Raktárak rögzítése]] | – | | Shoprenter | – | – | Részletesen: [[evir:webshop_connector:beallitas:raktarak|Egyéb raktárak]] ---- ==== 7. Szinkron beállítása [KÖZÖS] ==== - ''Webshop connector -> **Beállítás** -> Szinkron'' — új szinkron beállítás létrehozása - Mezőnként eldönthető, mi menjen fel: webshop beállítás, készlet, ár, kategória, keresőbarát URL, megnevezés, leírás, rövid leírás, tulajdonságok, metaadatok, címkék, súly, méret, vásárlói megjegyzés, helyettesítő és kapcsolódó termékek, vonalkód, Kategória 1-9, kollekció, variáns opciók - {{fa>exclamation-circle?lg}} **Vissza kell menni a webshop ''Termék'' területére**, és beállítani az ''Alapértelmezett termék szinkronizálás'' mezőt erre a szinkronra. Ha üresen marad, a rendszer az első szinkront használja. Platform-eltérés: a ''Kategória szinkronizálása'' Unas / Shoprenter / WooCommerce esetén értelmezett; a ''Kategória alapú kollekció'' és a ''variáns option 1/2/3'' Shopify-specifikus. Részletesen: [[evir:webshop_connector:beallitas:szinkron|Szinkron]], [[evir:webshop_connector:beallitas:egyedi_szinkron_beallitas|Egyedi szinkron beállítás]] ---- ==== 8. Ellenőrzés indulás előtt [KÖZÖS] ==== * ''Webshop connector -> **Technikai** -> Kapcsolótáblák ellenőrzése'' — új webshop esetén érdemes lefuttatni → [[evir:webshop_connector:technikai:kapcsolotablak_ellenorzese|Kapcsolótáblák ellenőrzése]] * ''Webshop connector -> **Listák** -> Termék hibalista'' — nem aktív cikk; Unas esetén a cikkszám karakterei és hossza, mennyiségi egység, megnevezés, kategória → [[evir:webshop_connector:listak:termek_hibalista|Termék hibalista]] * ''Webshop connector -> Listák -> **Kép hibalista**'' → [[evir:webshop_connector:listak:kep_hibalista|Kép hibalista]] * ''Webshop connector -> Listák -> **Kategóriák kapcsolat**'' → [[evir:webshop_connector:listak:kategoriak|Kategóriák]] Részletesen: [[evir:webshop_connector:listak:listak_menu|Listák menü]], [[evir:webshop_connector:technikai:technikai_menu|Technikai menü]] ---- ==== 9. Az első feltöltés — kötött sorrend [KÖZÖS] ==== {{fa>exclamation-circle?lg}} **A sorrend nem tetszőleges.** digraph elso_feltoltes { rankdir=LR; node [shape=box, style=rounded, fontsize=10]; "1. Kategória\nszinkronizálása" -> "2. Cikk szinkronizálása\n(Teljes feltöltés)" -> "3. Ár\nszinkronizálása" -> "4. Készlet\nszinkronizálása" -> "5. Képek\nszinkronizálása"; } - ''Webshop connector -> **Szinkronizálások** -> Kategória szinkronizálása'' \\ Ezt kell legelőször futtatni: **amíg nincs kategória, nem kerül fel cikk a webshopba**. - ''… -> **Cikk szinkronizálása**'' — a ''Teljes feltöltés'' bepipálásával - ''… -> **Ár szinkronizálása**'' - ''… -> **Készlet szinkronizálása**'' - ''… -> **Képek szinkronizálása**'' — külön lépés, mert lassú {{fa>info-circle?lg}} A ''Cikk szinkronizálása'' az egyedi szinkron beállításai szerint mellékesen frissítheti az árat és a készletet is, de a **pontos egyezést csak a dedikált ár-, készlet- és képszinkron garantálja**. Részletesen: [[evir:webshop_connector:szinkronizalasok|Szinkronizálások]] === Platform-specifikus utómunka === * {{fa>exclamation-circle?lg}} **Shopify**: a szinkronizált termékek **nem lesznek automatikusan közzétéve**. Products → Include in sales channels → Online store. → [[evir:shopify:cikkek_kozzetetele|Cikkek közzététele]] * **Unas**: a vonalkód-paraméter és a tulajdonságok megjelenítését az Unas felületén kézzel kell bekapcsolni * Általánosságban: a legtöbb webshopnál a tulajdonság nem jelenik meg automatikusan a vásárlói felületen ---- ==== 10. Rendelés-letöltés élesítése [KÖZÖS] ==== - ''Webshop connector -> **Megrendelés** -> Megrendelések letöltése'' → [[evir:webshop_connector:megrendeles:megrendelesek_letoltese|Megrendelések letöltése]] - ''Webshop connector -> Megrendelés -> **Várakozó megrendelések**'' — a sikertelen vagy törölt rendelések, kézi lezárással. 14 nap után a rendszer figyelmeztet. → [[evir:webshop_connector:megrendeles:varakozo_megrendelesek|Várakozó megrendelések]] - ''Webshop connector -> Megrendelés -> **Feldolgozott megrendelések**'' Részletesen: [[evir:webshop_connector:megrendeles:megrendeles_menu|Megrendelés menü]] === A rendelés útja === digraph rendeles_ut { rankdir=TB; node [shape=box, style=rounded, fontsize=10]; vas [label="A vásárló leadja\na rendelést a webshopban"]; szur [label="Szűrés: 'Letöltendő rendelések\nstátuszai' szerint"]; tetel [label="Tételazonosítás cikkszám alapján\n(nem cikk jellegű tétel ->\nszolgáltatás cikkszám)"]; part [label="Partnerazonosítás:\n1) adószám 2) név + email"]; kesz [label="Készletkezelés a\n'Rendelés letöltés működés' szerint"]; rend [label="eVIR VEVŐI RENDELÉS", style="rounded,bold"]; vissza [label="Státusz visszaírása\na webshopba"]; vas -> szur -> tetel -> part -> kesz -> rend -> vissza; } {{fa>exclamation-circle?lg}} **Amit tudni kell:** * A rendelés-letöltésnek **nem feltétele** a termékszinkron, de a **cikkszámoknak létezniük kell** a cikktörzsben. * Ha egy rendelés státusza nem szerepel a letöltendők között, a rendszer kihagyja — és **megáll az „utolsó letöltött rendelés" léptetése**. * A letöltés **után** a webshopban végzett rendelésmódosítás **nem vezetődik át** az eVIR-be. * Shopify esetén a szűrés **fizetési** státusz szerint történik (''paid'' / ''pending''), nem rendelés-státusz szerint. Partnerazonosítás részletesen: [[evir:webshop_connector:partnerkezeles|Partnerkezelés]] A készletkezelési módok: [[evir:webshop:webshop_keszletkezeles|Webshop készletkezelés]] Opcionális előlegszámla fizetett rendelésnél: [[evir:webshop_connector:beallitas:vevoi_rendeles|Vevői rendelés beállítások]] Innentől a folyamat azonos a kézzel rögzített rendelésével: [[evir:folyamatok:ertekesites|Értékesítési folyamat]] → [[evir:folyamatok:kiszallitas|Kiszállítás]] → [[evir:folyamatok:szamlazas|Számlázás]] ---- ==== 11. Automatizálás [OPCIONÁLIS] ==== A szinkronok és a rendelésletöltés időzített feladatként is futtathatók. Javasolt gyakoriságok: ^ Szinkron ^ Gyakoriság ^ | Cikk | naponta | | Készlet | 5-60 perc | | Ár | 15-120 perc | {{fa>exclamation-circle?lg}} Az időzített feladatokat **a rendszer üzemeltetője** állítja be; a webshop-feladatok alapból inaktív mintaként vannak felvéve. → [[evir:rendszer:beallitasok:utemezett_feladatok:utemezett_feladatok|Ütemezett feladatok]] Részletesen: [[evir:webshop_connector:webshop_szinkronizalas|Webshop szinkronizálás]] === Naplók, hibakeresés === * ''Webshop connector -> **Naplók** -> Szinkron napló'' / ''Folyamat napló'' * ''Webshop connector -> **Technikai** -> Információk / Folyamat job napló / Folyamat cache / Kapcsolatok lista'' ---- ==== Kedvezmények ==== A kedvezményeket a shop admin felületén kell beállítani, az eVIR pedig a letöltött rendelésen szolgáltatás-tételként fogadja őket. ^ Platform ^ Termék kedvezmény ^ Végösszegi kedvezmény ^ Egyéb ^ | Unas | [[evir:unas:unas_termek_kedvezmeny|Termék]] | [[evir:unas:unas_vegosszegi_kedvezmeny|Végösszeg]] | – | | Shopify | [[evir:shopify:shopify_termek_kedvezmeny|Termék]] | [[evir:shopify:shopify_vegosszegi_kedvezmeny|Végösszeg]] | – | | WooCommerce | [[evir:woocommerce:woocmmerce_termek_kedvezmeny|Termék]] | [[evir:woocommerce:woocommerce_vegosszegi_kedvezmeny|Végösszeg]] | [[evir:woocommerce:woocommerce_kedvezmeny_korlatozo|Kedvezmény korlátozó]] | | Shoprenter | – | – | [[evir:shoprenter:shoprenter_kedvezmeny|Kedvezmény]] | A kedvezményhez tartozó szolgáltatás-cikkszámot az eVIR-ben kell megadni: → [[evir:torzsadatok:cikktorzs:engedmeny_szolgaltatas|Engedmény szolgáltatás]] ---- ==== Platformonkénti áttekintők ==== * [[evir:unas:altalanos|Unas — általános]] * [[evir:shoprenter:altalanos|Shoprenter — általános]] * [[evir:shopify:altalanos|Shopify — általános]] * [[evir:woocommerce:altalanos|WooCommerce — általános]] ---- __Kapcsolódó oldalak:__ * [[evir:folyamatok:logisztikai_folyamat|Az eVIR logisztikai folyamata (áttekintés)]] * [[evir:folyamatok:webshop_belso|Belső (B2B) webshop beüzemelése]] * [[evir:folyamatok:elokeszites|Előkészítés — törzsadatok]] * [[evir:webshop_connector:kulso_webshop|Külső webshop üzemeltetése]] * [[evir:webshop_connector:webshop_connector_menu|Webshop connector menü]] * [[evir:webshop_connector:alapelvek|Alapelvek]] * [[evir:rendszer:beallitasok:rendeles|Rendszerbeállítások: Rendelés]]