A program kapcsolatot tud létesíteni a ShopRenter nevű általános webshop programmal.
Figyelem! A Shoprenter csak GOLD csomag vásárlása esetén alkalmas az általános API kapcsolatra, mely szükséges a Machinátorral történő együttműködéshez.
A funkcióban a ShopRenter kapcsolat alapbeállításai adhatók meg.
Shoprenter paraméterezés
Üzembe helyezés
A webshoppal felépíthető kapcsolathoz szükség van a néhány beállításra.
Először be kell lépni a létrehozott bolt adminisztrációs felületére.
Ezután a Beállítások/Integrációk/API beállítások menüben az API státuszt Engedélyezett-re,az API debug mezőt Letiltott-ra kell állítani. Meg kell adni egy felhasználónevet, majd elmenteni a beállítást. Ekkor kapunk egy jelszót. A Machinátorba a felhasználónevet, a jelszót és az API url-t kell megadni a Beviteli ablakban.
A webshop beállítások, és a pillanatnyi adatok a szerveren egy ShopRenter/kötetjel könyvtárban tárolódnak. Ez a könyvtár a mentésbe nem kerül bele!
Az első adat export-import előtt be kell olvasni a Machinátorba webshop néhány törzsadatát, és meg kell adni az összerendelését a saját törzsadatokkal.
A webshop képes fogadni a Machinátorból cikktörzset, ill lehetőség van arra is, hogy a webshopban feltöltött cikktörzset a Machinátorba küldjük.
A Machinátor cikkszám mezője max. 15 karakter, de felhasználói beállításokkal lehet rövidebb is. Ugyanakkor a cikkszám alapértelmezetten csak nagybetűket tartalmazhat, ez szintén felülbírálható. Amennyiben a webshopból vesszük át a cikktörzset és ott használva vannak kisbetűk is, az átvételkor a program a cikkszámokat nagybetűsre alakítja, de 40 hosszan külön eltárolja a webshopban megadott cikkszámot is, hogy a kommunikációban arra hivatkozhasson. Így a 15-nél hosszabb cikkszámokkal csak akkor van probléma, ha a 15-re csonkolt verzió két terméknél azonos.
Jelenleg a következő mezők exportja-importja van megvalósítva:
- Cikkszám <-> Cikkszám
- Terméknév (magyar) <-> Cikknév1-2
- Terméknév (angol) <-> Külföldi megnevezés (angol)
- Ismertető (magyar,angol) <-> Cikkszámhoz kapcsolt megjegyzés (magyar,angol). A webshopban szerkesztett szöveg html tageket tartalmaz, amik a Machinátorban szövegesen jelennek meg. A Machinátorban bevitt megjegyzés a webshopban szimpla (formázatlan) szövegként jelenik meg. A megjegyzés beállítás alapján átkerülhet a cikkhez készített megjegyzés típusú extra mezőből is, ld. Beviteli ablak
- Mértékegység neve <-> Mértékegység.
- Áfakulcs <-> ÁFA kód.
- Méret (hosszúság, szélesség, magasság) <-> További adatok, karton adatok (hosszúság, szélesség, magasság), csak a mérőszám, a mértékegység nem.
- Súly <-> További adatok, bruttó tömeg, csak a mérőszám, a mértékegység nem.
- Elsődleges kép <-> Képet át lehet adni a cikkhez iktatott kép dokumentum alapján vagy szöveg típusú extra mezőben megadható URL alapján, ld. Beviteli ablak
A cikk letöltés két részből áll:
- Cikk lista letöltése: A lista a cikkszámot, a webshop CikkId-jét, a cikk státuszát, rendelhetőségét, készletét tartalmazza. Ezt a listát használja a cikk (státusz) feltöltés is, azaz először mindig cikk letöltést kell futtatni!
- Cikk import: új cikkek importálása, meglévők adatainak frissítése.
A cikk feltöltés feltétele a letöltött cikk lista. Ha az régebbi mint egy nap, akkor a feltöltés előtt a program automatikusan letölti!
A cikk feltöltés a következő adatokat frissíti:
- Cikk állapot: Ha egy cikk nem létezik a Machinátorban vagy nincs benne a megadott a cikk szűrésben vagy az ára nulla, akkor "Letiltott", különben "Engedélyezett".
- Rendelhető termék: Ha a cikk készlete nem nulla, akkor "Igen", különben "Nem".
- Készlet
- Ár
Rendelések letöltése, státusz feltöltés
A szállítási és számlázási adatokból a Machinátor a következőket importálja:
- Vezeték és keresztnév, vagy a cégnév,
- Ország
- Irányítószám,
- Helység,
- Cím1
- Adószám (csak a számlázási adatoknál),
- Email cím.
Ha vezeték és keresztnév van megadva, a Machinátor egy szóközzel összefűzi egy névvé.
Az ügyfél név ellenőrzés a program az első 35 karakterre végzi (utána állhat sorszám), és egyezés esetén a hosszú nevet is ellenőrzi teljes hosszában! Értelemszerűen új ügyfél felvételénél a hosszú nevet is kitölti.
Megadott adószám esetén is kell a név és cím egyezés is, különben új ügyfelet fog felvenni!
A szállítási nevet/címet a program ügyfél telephelyként felveszi.
A letöltés mindig az előző letöltés időpontja utáni rendeléseket kérdezi le a webshoptól.
A program a letöltött rendelések iktatószámát, és webshop azonosítóját eltárolja a szerveren (Rendelesek.bin). A státusz feltöltés ezen lista alapján működik. Ebből a listából kikerülnek a kiegyenlített számlával rendelkező, és páratlan rendelések.
Automatizálás:
Ha valamely gyakoriság meg van adva, akkor a program a szerverre létre fog hozni egy megfelelő időzített folyamatot. A létrejött folyamat az Időzített/eseményvezérelt feladatok menüpontban megtekinthető, azonban ott még a státusza (Aktív=Igen/Nem) sem módosítható. Attól lesz a feladat inaktív, ha a ShopRenter paraméterekben minden folyamatot Kézzel indítva állapotúra állítunk.
Megjegyzendő, hogy a Cikk letöltés, ill. a Cikk feltöltés folyamat igen hosszú időt is igénybe vehet cikkszám mennyiségtől, ill. internet sebességtől függően. Ilyenkor a Naponta időzítést állítsuk be, amely éjfélkor fog futni. (Amennyiben a Machinátor szerver nem folyamatosan, szolgáltatásként működik, az ilyen időzítés a napi első belépéskor fog lefutni.)
Paraméterek
