A program alkalmas az UNAS Online Kft. által üzemeltetett webáruház API felületén keresztüli adatcserére.

 

Figyelem! Az UNAS csak PREMIUM csomag vásárlása esetén alkalmas az API kapcsolatra, mely szükséges a Machinátorral történő együttműködéshez.

 

Működés

Az adatcsere működhet automatikusan, ez esetben egy időzített folyamatot aktívvá kell tenni, ez negyed óránként elindul a szerveren, és a paraméterezésben megadott ütemezés szerint futtatja a funkciókat.

De működhet kézi indítással is, illetve lehet vegyesen: az automatizálás mellett pl. a cikk feltöltés egy csoportos ármódosítás után menüből is elindítható, de figyelembe kell venni az webshop API óránkénti 20 alkalom korlátozását.

•Cikk feltöltés: A program először lekérdezi a webshopban lévő cikkek alap listáját. Ez után lefuttatja a megadott szűrést. A két lista összehasonlítása alapján meghatározza mely cikkeket kell újként feltölteni, és melyeket módosításként feltölteni. Ha létezik a cikk a Machinátorban és az UNAS-ban is, de a Machinátorban nincs benne az UNAS-ra feltöltendő cikkek szűrésében, az UNAS-ban inaktív lesz.
Amennyiben a cikktörzsben használva van a Cikknév3 mező, az UNAS-ba ez kerül át cikknévként.
 
Mivel az UNAS kizárólag az angol abc kis- és nagybetűit, a számokat, valamit a kötőjel és aláhúzás jel karaktereket kezeli a saját cikkszámában, más karaktereket (is) tartalmazó machinátoros cikkszámok felküldése a következő módon történik:

1. Ha van a paraméterezésben "Szállító cikkszám ügyfele", akkor az ő cikkszáma lesz felküldve. Abba csak olyat szabad bele írni, amit az UNAS is elfogad!

 2. Szóköz helyett aláhúzás.

 3. Pont helyett mínusz.

 4. Vessző helyett mínusz.
 A machinátoros cikkszámot tartalmazó extra mezőt létre kell hozni az UNAS-ban a termék paraméterei közé és annak ID-jét meg  kell adni a Machinátor UNAS paraméterei között  az Eredeti cikkszám ID mezőben.

•Az aktuális cikkek listáját elmenti a készlet feltöltés számára.

•Készlet feltöltés: A program (a beviteli ablak beállítása alapján) vagy előveszi a cikk feltöltés által elmentett listát, ezen cikkere kiszámolja az aktuális készletet, és ezt feltölti a webshopra vagy lekérdezi a webshop cikklistáját és a Machinátorban is megtalálható cikkek készletét tölti fel

•Rendelés letöltés: A program egy megadható dátumtól kezdve (ide elteszi az utoljára letöltött rendelés dátumát), illetve a megadható állapotokra szűrve kérdezi le a webshopból a rendeléseket. A rendelés alapbizonylat számába beleírja a webshopban kapott azonosító, ez alapján keresi vissza, hogy egy rendelés már le van-e töltve, vagy fel kell venni. A rendelés számlázási státuszát, illetve a rendelés státuszát elteszi egy listába, amit elment a rendelés állapot feltöltés számára.
 
Kapott rendelésben lévő cikkszám visszakeresése:

  1. Ha van a paraméterezésben "Szállító cikkszám ügyfele", akkor az ő cikkszámai között keresi a program.

  2. Keressük a cikkszámok között úgy, ahogy megkaptuk.

  3. Az aláhúzás helyett szóköz, és keressük a cikkszámok között.

  4. A kötőjel helyett pont, és keressük a cikkszámok között. 

  5. A kötőjel helyett vessző, és keressük a cikkszámok között. 

  6. Az aláhúzás helyett szóköz + a kötőjel helyett pont, és keressük a cikkszámok között. 

  7. Az aláhúzás helyett szóköz + a kötőjel helyett vessző, és keressük a cikkszámok között. 
A machinátoros cikkszámot tartalmazó extra mezőt létre kell hozni az UNAS-ban a termék paraméterei közé és annak ID-jét meg kell adni a Machinátor UNAS paraméterei között  az Eredeti cikkszám ID mezőben.

•Ügyfél letöltés: Ügyfelet a webshopban rögzítik a felhasználók és a rendelés letöltés esetén kerül a Machinátorba az új ügyfél. Az ügyfél azonosítása úgy történik, hogy az ügyfelet a webshopban kapott azonosító alapján visszakeresi (ÜgyfélID állomány, 16-os sorszám) a program. Ha nem találja, akkor felveszi. A szállítási nevet a telephely nevében keresi a program, ha nem találja felveszi új telephelyként. A szállítási címet elteszi a rendelés fejbe. A Machinátorban rögzített ügyfelet nem fogad az UNAS webshop, vagyis csak a webshopban rögzített felhasználótól lehet rendelést kapni a webshopból.
Amennyiben egy rendelésben kapott ügyfél mellett nem érkezik unasos ügyfél azonosító vagy ez az azonosító nincs benne az ÜgyfélId állományban, az ÜgyfélId-ben történő rákeresés után a program megnézi az ügyféltörzs adatbázist is, és ha létezik olyan ügyfél, melynek a nevének első 35 karaktere, a hosszú neve, az irányítószáma, a város címe, ill. az utca-házszám címe pontosan megegyezik a kapottal, azt az ügyfelet fogja használni a létrehozott rendelésben. Ha érkezik azonosító is, az felveszi az ÜgyfélId-be a machinátoros ügyfélkóddal.

•Rendelés állapot feltöltés: A rendelés letöltés által elmentett lista alapján: Ha egy rendelés számlázási státusza "Nem számlázható", és a rendelés státusza "Feldolgozásra vár", akkor a webshopban a státuszt átállítja "Visszaigazolva"-ra. Ha a rendeléshez raktárforgalom kapcsolódik, akkor a számlázási státuszt átállítja "Számlázható"-ra, a státuszt "Készletezés alatt"-ra. Ha a rendeléshez számla is kapcsolódik, akkor a számlázási státuszt átállítja "Számlázva"-ra, a státuszt "Kiszállítás"-ra. Ha a számla egyenlege 0, akkor a státuszt átállítja "Megrendelés lezárva"-ra, és törli a listából.

Üzembe helyezés

Webáruház beállítások

•Az API használatát külön engedélyzeni kell a webáruház adminisztrációs felületén. Ehhez lépjen be a webáruház adminisztrációs felületére, majd Beállítások/Külső kapcsolatok/API kapcsolat menüpont. Itt ha engedélyezi az API használatát, akkor megjelenek a Username, PasswordCrypt, ShopId, AuthCode mezők, ezeknek a tartalmát kell az akció beviteli ablakán az "Azonosítás" részben megadni.

•A Beállítások/Alap beállítások menüpontban, a Termékek fülön a "Raktárkészlet alapbeállítások új termék felvitelekor" sorban be kell pipálni a "Használja a Raktárkezelést", így minden feltöltött cikkhez alapértelmezetten lesz készlet kezelés.

•A webshopban a regisztrált felhasználó alapértelmezésben meg tudja változtatni a számlázási címét, amit a Machinátor nem fog átvenni. Ezért a Beállítások/Alap beállítások menüpontban, a Vásárló fülön, a "Vásárló mely adatait ne módosíthassa" sorban be kell pipálni a "Számlázási cím"-et.

•Ha a webshopban a valamely szállítási módhoz szállítási költséget adnak meg, akkor a rendelések hibátlan fogadásához a Machinátorban fel kell venni egy "shipping-cost" cikkszámú terméket. Ha a cikkszám maszk első karaktere "X", akkor csupa nagybetűvel! A hozzá tartozó név "Szállítási költség", érdemes ezt adni, hogy egyezzen a webshop által használttal.  

•Ha a webshopban a valamely fizetései módhoz plusz költséget adnak meg, akkor a rendelések hibátlan fogadásához a Machinátorban fel kell venni egy "handel-cost" cikkszámú terméket. Ha a cikkszám maszk első karaktere "X", akkor csupa nagybetűvel! A hozzá tartozó név "Fizetéssel kapcsolatos kezelési költség", érdemes ezt adni, hogy egyezzen a webshop által használttal.  

•Ha a webshopban a rendelés végösszegéből százalékos kedvezményt adnak, akkor a rendelések hibátlan fogadásához a Machinátorban fel kell venni egy "DISCOUNT-PERCEN" (az utolsó "t" betű a 15 karakteres korlát miatt lemarad!) cikkszámú terméket. Ha a cikkszám maszk első karaktere "x", akkor lehet kisbetűvel is.

•Ha a webshopban a valamely cikk árából összeg szerű kedvezményt adnak, akkor a rendelések hibátlan fogadásához a Machinátorban fel kell venni egy "DISCOUNT-AMOUNT" cikkszámú terméket. Ha a cikkszám maszk első karaktere "x", akkor lehet kisbetűvel is.

Teszt webáruház

Az UNAS Online Kft. két heti teszt időszakot biztosít ingyen minden leendő ügyfelének. Ebben a teszt áruházban az API kapcsolat is működik, így a Machinátor kapcsolat is kipróbálható, bizonyos korlátozásokkal, pl.: a cikkek száma 1000-ben van korlátozva. Az áruház a https://shop.unas.hu/webaruhaz_keszites oldalon egy egyszerű regisztráció után létrejön. A tesz áruházban vannak minta cikkek. Ezeket a webshop adminisztrációs felületén törölni kell, mivel a cikkszámaik hosszabbak, mint a Machinátor által tárolt 15 karakter, ezért a cikk feltöltés funkció nem fogja tudni törölni őket. A cikkek száma korlátozva van, így a paraméterezésben olyan cikk szűrést kell beállítani, amiben legfeljebb 1000 cikk van, különben a a cikk feltöltés mindig hiba választ fog visszakapni a webshoptól, és bár az első 1000 cikk megjelenik a webshop felületén, a tárolt cikk lista nem készül el, és a készlet feltöltés nem fog működni!

Nagy Machinátor

Az adatcsere működhet automatikusan, ez esetben a 3000000013-as időzített folyamatot aktívvá kell tenni (mely a 3000000327-es automatizált feladatot hívja meg), ez negyed óránként elindul a szerveren, és a paraméterezésben megadott ütemezés szerint futtatja a funkciókat.

 

Menüből való indításhoz CF_UNASW akciónak a következő üzemmódjai vannak:

 

•WEBSHOP paraméterezés: Üzemmód = Bevitel

 Beviteli ablak

 
 

•Cikk feltöltés: Üzemmód = Cikk feltöltés

•Készlet feltöltés: Üzemmód = Készlet feltöltés

•Rendelés letöltés: Üzemmód = Rendelés letöltés

•Rendelés állapot feltöltés: Üzemmód = Rendelés állapot feltöltés

Korlátozások

•A webshop a cikkszámban csak az angol ábécé kis és nagybetűit, a számokat, a mínuszt (kötőjelet) és az aláhúzás karaktert fogadja el. Azaz a feltöltött cikkek Machinátoros cikkszámokban sem szerepelhet más.

Megjegyzés: Az UNAS képes átkonvertálni a cikkszámban kapott szóközöket aláhúzás jellé, ill. a pont karaktert kötőjellé, így a szóköz és a pont is használható abban az esetben, ha a machinátoros cikkszámban nincs egyszerre szóköz is és aláhúzás jel is vagy pont és kötőjel, ill. akkor, ha nincs két olyan cikkszám, amelyekből az egyikben szóköz, a másikban aláhúzás van azonos pozícióban és minden más karakter megegyezik. Ezekben az esetekben ugyanis cikkszám duplikáció lépne fel, ami tiltott.

•Az API nem teszi lehetővé, hogy egy már feltöltött cikk alap tulajdonságait a későbbiekben a Machinátor megváltoztassa. Gyakorlatilag csak a cikk neve, ára, és a készlet fog frissülni. Ha egy termék besorolása (kategóriája), képe változik az a webshopban nem fog automatikusan megjelenni. (Törölni kell a cikket a webshop admin felületén, majd a Machinátorban kézzel indítani egy cikk feltöltést, ez újra felveszi a cikket, és a készlet feltöltés sem fut hibára.)
Megjegyzendő, hogy az ügyféltörzsben beállítható Cikkenkénti engedmény/ár helyen beállított árak nem módosítják a cikkek utolsó módosítási dátumát, a feltöltés viszont ezt figyeli, így az ügyféltörzsben történő változtatás után egy cikktörzs feltöltéssel az akciós árak nem változnak!

•Lehetőség van devizás árak átadására is. Ha az érvényes ár nem forintos, a Beviteli ablakban megadható az átadandó ár devizaneme. Amennyiben ez megegyezik az átadott érvényes ár devizanemével, nem történik árkonverzió, azaz nem szorzódik fel a devizanem árfolyamával az átadandó érték. Ha itt Ft vagy HUF van megadva és az átadandó érvényes ár devizás, megtörténik a forintosítás a deviza aktuális árfolyamán. Ha a beállított devizanem más, mint az érvényes ár devizaneme (de egyik sem Ft vagy HUF), akkor a két deviza keresztárfolyamával történik a konverzió. Az árfolyammal történő szorzás kizárólag az új engedményrendszer használata esetén elérhető, a hagyományos engedményrendszernél egyáltalán nem történik árkonverzió, mindig a megadott érvényes ár kerül át az UNAS-ba, függetlenül a devizanemektől.

•Az API cikkek feltöltését, készlet feltöltését, rendelések lekérdezését, rendelés állapotok feltöltését óránként 20 alkalommal engedélyezi, utána a felküldő IP címét egy órára kitiltja.

•A webáruház létrehozása után kb 15-30 perc múlva lehetséges csak az első kapcsolat létrehozása, azaz ez előtt "EIdHTTPProtocolException: HTTP/1.1 500 Internal Service Error" hibajelzést fogunk kapni.

•A cikk feltöltés először lekérdezi a webshop cikk listáját, és inaktívra állítja azokat a cikkeket, amelyek nincsenek benne a megadott cikk szűrésbe. Azaz a webshop adminisztrátori felületén nem érdemes cikket felvenni.

•A webshopban szabadon lehet szállítási módokat definiálni, de a Machinátor azt aminek nevében a "Személyes" és az "átvétel" szó is szerepel a rendelésben "Ők szállítanak" szállítási módra fordítja, minden mást "Mi szállítunk"-ra.

•A webshopban szabadon lehet fizetési módokat definiálni, de a Machinátor az adott fizetési mód "Fizetési Mód típusa" mezőjének az értékét veszi át a rendelésre.

•A webshopban a szállítási címet a felhasználó szabadon módosíthatja, ez bele kerül a rendelés fejlécbe is, ezt nem érdemes korlátozni. Viszont a szállítási nevet a rendelés nem tárolja, ezért a Machinátor telephelyként is felveszi a szállítási címet.
A program megnézi, hogy az ügyfélnek van-e olyan telephelye, melynek nevének első 35 karaktere azonos a szállítási cím nevével. Ha nincs, felveszi a telephely-ügyfelet a kapott szállítási címmel és beteszi a vásárló ügyfélhez telephelyként. Ha van, megnézi a 3 cím adatát és ha pontos egyezőséget talál, azt a telephelyet használja, nem vesz fel újat. Ha akár egy karakterben is eltér az ir.szám+város+utca-házszám, új, sorszámozott nevű telephely-ügyfelet vesz fel és azt teszi be új telephelyként a vásárló ügyfélhez és azzal jön létre a rendelés.

•Az UNAS paraméterekben megadható "Rendelés státusza..." állapotok szövegeinek pontosan meg kell egyeznie a webshop adminisztrátori felületén a Beállítások/Vásárlási folyamat/Megrendelés státuszok, típusok/Megrendelés státuszok pontban meglévő állapotokkal. Vagy a Machinátor paraméter ablakában kell olyan szövegeket beállítani, mint amik az UNAS-ban vannak, vagy fordítva.

•A program képes devizás rendelést is fogadni, azonban ehhez szükséges, hogy a Machinátorban fel legyen véve az a devizanem, melyben érkezik a rendelés. Amennyiben nincs felvéve, forintban lesz létrehozva a rendelés!

•Ha a Saját cím/Saját adónemben a cikk szinkron idején Alanyi adómentes elszámolás van beállítva, a cikkek 0%-os áfával, az érvényes nettó ár=bruttó ár módon kerülnek átadásra az UNAS-ba, függetlenül a Machinátor cikktörzsében beállított ÁFA kódtól, mert az UNAS maga nem tudja kezelni azt az esetet, ha a bolt tulajdonos alanyi adómentes, azaz hiába van törvényileg x% áfa az eladott terméken, ő nem fizet áfát. Ezt az UNAS 0%-os áfával tudja csak megoldani. Ezért az ár átadáskor a bruttó ár is a nettó lesz, azaz 0% lesz az ÁFA.

Kapcsolódó paraméterek

Üzemmód

FileNamePre