InCash számlázó program és a Webshop Hun rendszer összekötése Az InCash számlázó programkészítő cég, egy köztes programot hozott létre, amely segítségével webáruházakban generálódó megrendeléseket képes betölteni a számlázó rendszerbe. A köztes rendszer képes árlista generálásra is, amelyet ftp segítségével feltölt egy általunk megadott tárhely célzott könyvtárába. Ezen leírásnak nem célja az Incash számlázó program részletes használati leírása, csak azon menüpontok lesznek megemlítve melyek szükségesek a két rendszer közti kommunikációhoz. A Webshop Hun a vásárlói megrendelés készítésekor létrehoz egy.csv fájlt a shop/admin/eszamla/incash könyvtárba. Az InCash köztes programja itt keresi ezt a.csv fájlt, ha talál, akkor azt importálja a rendszerébe, és törli a szerverről a megrendelést tartalmazó.csv fájlt. A köztes program a shop/amin/export_import könyvtárba tölti fel az arlista.csv fájlt. A Webshop Hun program ezt az arlista.csv-t dolgozza fel, ha megtalálja az adott könyvtárban, majd a feldolgozás végén törli azt. A feldolgozás akkor kezdődik, ha a böngészőben megnyitjuk a http://www.sajat_domain.hu/admin/export_import/incash_upload.php-t. Ha a tárhely tartozik adminisztrációs felület és azon belül találunk ilyet, hogy CRON akkor ott megadhatjuk, hogy pl.: óránként hívja meg a fent más említett incash_upload.php-t, ezzel biztosítjuk, hogy ha az arlista.csv a tárhelyre került, akkor elindul a frissítés. A Webshop Hun biztosít egy felületet ahol nyomon követhetjük, hogy mikor lett meghívva az incash_upload.php, az utolsó 100 időpontot tárolja a rendszer, így ellenőrizhetjük, hogy a szerver CRON konfiguráció helyesen működik-e. A felület elérhető a webshop adminisztrációs felületének Számlázás menüpontjából. 1. ábra Webshop Hun admin felület Webshop Hun összekötése az InCash számlázó programmal. 2011 oldal 1
Az InCash rendszer köztes programjának konfigurálása Nyissuk meg az InCash számlázó programot, és a felső menüben keressük a Kiegészítők >> Árlista frissítés menüpontot. 2. ábra Incash menü Az Alapbeállítások fülre kattintva az alábbi tartalmat kell kapnunk. 3. ábra Alapbeállítások Az alapbeállítások menüpontban meg kell tallóznunk azt a könyvtárat ahol a rendszer tárolja az arlista.ini-t. Ez nem az arlista.cs fájl! Ugyanitt állíthatjuk be a frissítési időpontokat. Webshop Hun összekötése az InCash számlázó programmal. 2011 oldal 2
A Működés fülre kattintva a következő képernyőt kapjuk. A fenti panelen állítsuk be a tárhely kapcsolódáshoz szükséges ftp adatokat. A fájl típus legyen CSV. Beállítható, hogy csak a készlettel rendelkező cikkek kerüljenek feltöltésre. A Fájlnév beállításhoz adjuk meg az elérési utat ahol a shopunkban található export_import könyvtár van, ez tárhelyektől függő könyvtár szerkezet, ezért nem tudok minden esetre megoldást adni. Az elérési út végén található arlista részt hagyjuk változatlanul az lesz a feltöltött állomány neve, a köztes program csak mögé rakja a kiterjesztést, és így lesz belőle arlsita.csv. Ha megváltoztatjuk akkor a webshop nem fogja megtalálni az arlista.csv-t így nem frissül az adatbázis! Az elérési utat a gyökérkönyvtártól kell megadni, függetlenül attól, hogy a domain melyik könyvtárra van irányítva, itt ugyanis a program is úgy halad, mint mi, amikor megnyitjuk a tárhelyünket. A végén a Beállítások mentése gombbal rögzítsük a változtatásokat. Webshop Hun összekötése az InCash számlázó programmal. 2011 oldal 3
Az adatbázis fülre kattintva a következő felületet láthatjuk. A fent látható checkboxok legyenek bepipálva, ha többet, vagy kevesebbet jelölünk ki akkor a shop rendszere hibát fog jelezni számunkra, és a frissítés nem hajtódik végre. Amennyiben több adatot szeretnénk beolvastatni a shopba, akkor ezt egyeztessük a Webshop Hun készítőjével, hogy változtatni tudjon a shop rendszerében. A végén a Beállítások mentése gombbal rögzítsük a változtatásokat. A képek/megj menüpontban az alábbi képernyőt láthatjuk. Webshop Hun összekötése az InCash számlázó programmal. 2011 oldal 4
A fenti beállításoktól csak a Könyvtár beállítást változtassuk meg a tárhelyünknek megfelelően. Itt adhatjuk meg, hogy az InCash köztes programja mely könyvtárba töltse fel a termék képeket és a termék leírásokat. A Webshop Hun a shop/kepek/nagy_kepek/proba_termek könyvtárban keresi ezeket, ha a köztes program máshova tölti fel, vagy a tárhely konfigurációja nem engedi meg a könyvtárba írást, vagy nincs létrehozva ez a könyvtár struktúra akkor a felvitt cikknek nem lesz képe, és leírása. Az elérési út végén található termek_ részt hagyjuk változatlanul, ezt a köztes program fogja használni, egyszerűen így fogja hívni a képet, pl.: termek_9.jpg, és a leírást termek_9.txt. Az elérési utat a gyökérkönyvtártól kell megadni, függetlenül attól, hogy a domain melyik könyvtárra van irányítva, itt ugyanis a program is úgy halad, mint mi, amikor megnyitjuk a tárhelyünket. A végén a Beállítások mentése gombbal rögzítsük a változtatásokat. A Teljes termék adatbázis frissítése most gombra klikkelve minden kép, cikk adat, leírás, árlista felkerül a tárhelyre függetlenül attól, hogy volt-e változás adott cikk adataiban. Ez teszteléskor, és első exportáláskor használandó, egyéb esetekben a köztes program csak a változtatott cikkek adatait tölti fel. A következő menüpont az Előrendelés készítése. A Könyvtár beállítást változtassuk meg a tárhelyünknek megfelelően. Itt adhatjuk meg, hogy az InCash köztes programja mely könyvtárba keresse a megrendelésről készült.cs fájlt. A Webshop Hun a shop/admin/eszamla/incash könyvtárban hozza létre a megrendeléskor. Ha a tárhelyünk beállításai szükségessé teszik, akkor állítsuk át az incash könyvtár attribútumát olyanra, hogy írhasson bele a program. Ez általában 777, de egyes szervereken a 755 is megfelelő. Egy teszt vásárlás után azonnal kiderül, hogy a rendszer tud-e írni a könyvtárba. Ha a megrendelésről készített.cs fájl ott van az incash könyvtárban akkor az Előrendelések készítése most gombra kattintva a köztes program beolvass a számlázóban és törli a tárhelyről a.csv fájlt. Webshop Hun összekötése az InCash számlázó programmal. 2011 oldal 5
Az incash_upload.php működése - Megvizsgálja, hogy az arlista.csv megvan-e. Ha nincs akkor a program futása megszakad. - Ha száznál több meghívási időpont van tárolva akkor törli a többit. - Beolvassa az arlista.csv adatait - Megvizsgálja az arlista.csv fejlécét, hogy a megfelelő sorrendben érkeznek-e az adatok, ha nem akkor hibajelzés után a program leáll. - Azon cikkek megjelenését letiltja, amik az InCash számlázóból lettek feltöltve. - Megvizsgálja, hogy a cikk már az adatbázisban van-e, ha igen akkor frissíti a tárolt adatait, és a megjelenését engedélyezi. Ha még nincs az adatbázisban, akkor felveszi a cikket, eltárolja az adatait. - Végül törli az arlista.csv-t 2011-08-10 Webshop Hun összekötése az InCash számlázó programmal. 2011 oldal 6