Az AXEL PRO tetszőleges webáruházzal, vagy bármilyen külső szoftverrel összekapcsolható az XML export és import funkciók segítségével, amennyiben a webáruház vagy másik program támogatja az AXEL PRO által használt exportálási, illetve importálási formátumot.
Közvetlen kapcsolatú összeköttetéssel a Shoprenter, Unas, vagy a Woocommerce webáruház felé szoftverünk nem rendelkezik.
A funkció használatához a Beállítások főmenü Program gombjának megnyomása után a Főbb funkciók fül alatt a "Webáruház kezelés és mobil elérés" kapcsolót be kell kapcsolni.
Egyszerű Excel vagy más formátumból, alkalmanként történő importáláshoz tekintse meg az Importálás témakört.
Egyszerű Excel vagy más formátumba, alkalmanként történő exportáláshoz tekintse meg az Exportálás témakört.
A webáruház és integráció funkciók használatához az online tudástárban leírtak alapos ismerete szükséges, valamint a megvalósítás általában szoftverfejlesztést igényel a webáruház fejlesztőjének részéről. Kérjük mindenképpen olvassa el a részletes útmutatást, valamint a webáruházzal vagy külső szoftverrel történő összeköttetést mindig először egy demó változatban ellenőrizze! Webes fejlesztést vagy abban való közreműködést cégünk nem vállal.
Beállítások
A webáruházra és integrációra vonatkozó beállítások a Beállítások főmenü Webáruház gombjának megnyomása után végezhetőek el.
Ha az adatcserét az AXEL PRO minden indításánál végre szeretné hajtani, akkor a "Webáruházhoz kapcsolódás automatikusan minden indításnál" kapcsolót kell bekapcsolni.
Ha az adatcserét paraméterezett indítással (vagy axelpro:// URI protokollal) szeretné végrehajtani, akkor kapcsolja be a "Paraméterezett programindítás engedélyezése" kapcsolót.
Ha hitelesítést igénylő weblappal szeretne összeköttetést létesíteni, akkor a "Biztonságos kapcsolódás" kapcsolót kapcsolja be és adja meg a bejelentkezéshez szükséges felhasználónevet és jelszót.
A webáruház beállításoknál az Ügylet import mezőben adja meg az importálás forrását. Ha a beviteli mező mellett található "azonnali nyomtatás" jelölőnégyzet be van kapcsolva, akkor az importált megrendelések, számlák és egyéb ügyletek azonnal kiállításra és nyomtatásra kerülnek. Kikapcsolt állapot esetén az importált ügyletek félbehagyottként jönnek létre, így kiállítás előtt még módosíthatóak.
Az XML export és import során az egyes adatcsere típusokhoz meg kell adni, hogy honnan történjen az import vagy hova történjen az export. A beviteli mezők segítségével az alábbi elérési útvonalak adhatóak meg:
A) URL:
Tetszőleges weblap cím, amely importálás során egy XML fájlt generál, exportálás során pedig HTTP_POST-ban tárolt XML adatokat dolgoz fel. URL címről történő importálás esetén fontos, hogy a weblapnak kell gondoskodnia arról, hogy az adatok lekérése után egy ismételt lekéréssel már ne jelenjenek meg az adatok, így elkerülhető a többszöri duplikált importálás.
Szoftverünkben egyetlen URL cím adható meg, több különböző forrásból / forrásba történő adatcsere nem lehetséges.
B) Mappa:
Tetszőleges helyi mappa, amelyben importálás során az AXEL PRO egy vagy több megadott nevű XML fájlt keres és olvas be, vagy amelybe exportálás során az AXEL PRO létrehoz egy vagy több XML fájlt. Mappából történő sikeres importálás esetén a szoftver törli a már beimportált fájlokat. (így elkerülhető a többszöri duplikált importálás). Mappából történő importáláshoz fontos, hogy az XML fájlok neve az adott típushoz tartozó Minta XML témakörben írt fájlnévvel kezdődjön. Mappából történő ügylet XML importálás során például az AXELPRO_IMP_TRANS*.XML fájlnevek kerülnek csak importálásra, ahol a * karakter helyén tetszőleges szöveg szerepelhet.
C) Fájl:
Tetszőleges helyi mappában lévő XML fájl teljes elérési útvonallal, amelyből importálás során az AXEL PRO adatokat olvas be, vagy amelyet exportálás során az AXEL PRO létrehoz és XML adatokat ír bele. Fájlból történő sikeres importálás esetén a szoftver törli a fájlt. (így elkerülhető a többszöri duplikált importálás)
Minden típus esetén az XML fájlnak BOM kezdő karaktert tartalmazó UTF-8 kódolásúnak kell lennie. Az importálandó XML fájl létrehozásakor a speciális karakterek miatt az alábbiakat kell figyelembe venni:
- and jel (&) helyett a következőt kell használni: &
- relációs jelek (< és >) helyett a következőt kell használni: < és >
Fontos, hogy az XML fájlokban található számértéket tartalmazó mezők esetében a tizedestört értékeknél a tizedes elválasztó karakternek vesszőnek kell lennie!
Adatcsere indítása
Az ügylet export kivételével az adatcsere indításának módjai:
a) Az Eszközök főmenü "Webáruház kapcsolódás" gombján kattintva
b) Állítsa be, hogy minden indításnál történjen adatcsere
c) Használja a -export_import_all parancssori paramétert
d) Használja az axelpro://-export_import_all URI protokollt
Minta
PHP mintaforráskód az ügylet importhoz, amely egy XML-t generál a webáruházból a következő címen található:
www.axel-szamlazo-program.hu/ugylet-import-mintaphp
Működő PHP példaprogram az alábbi címen érhető el:
www.axel-szamlazo-program.hu/ugylet-import
Ezen linkeken található forráskódok csak mintaként szolgálnak, és esetleg elavultak lehetnek. A forráskód alapján (de nem egy az egyben átemelve a kódot) van lehetőség az integráció megvalósítására. Az újabb PHP verziók esetén valószínűleg az adatbázis kapcsolatot PDO segítségével érdemes megvalósítani és sok egyéb ponton is célszerű megváltoztatni, bővíteni a szkriptet. Egyedi szoftverfejlesztés szolgáltatással nem rendelkezünk, így erre vonatkozóan a technikai részletekben nem tudunk segíteni.
Az alábbi adatok kezelésére vonatkozóan lehet összeköttetést kialakítani:
Ügylet import
Számlák, eladások, megrendelések, szállítólevelek, árajánlatok, díjbekérők és más ügyletek automatikusan bevihetőek az AXEL PRO szoftverbe akár félbehagyottként, vagy azonnali nyomtatással. Webáruházzal történő összeköttetés során elsősorban az ügylet importra van szükség.
Árucikk lista import
Árucikkek (szolgáltatások, termékek) adatai automatikusan bevihetőek az AXEL PRO szoftverbe.
Partnerlista import
Partnerek adatai (vevők, beszállítók) automatikusan bevihetőek az AXEL PRO szoftverbe.
Ügylet export
Az AXEL PRO beállítható úgy, hogy minden ügylet kiállításakor automatikusan exportálja a kiállított ügylet adatait és tételeit.
Árucikk lista export
Az AXEL PRO beállítható úgy, hogy manuálisan vagy indításkor automatikusan exportálja az árucikk listát.
Partnerlista export
Az AXEL PRO beállítható úgy, hogy manuálisan vagy indításkor automatikusan exportálja a partnerlistát.
Probléma megoldás
Amennyiben az integráció megvalósítása során váratlan esemény történik, vagy nem az elvárt működés tapasztalható, úgy javasoljuk, hogy vegye fel a kapcsolatot a webshop üzemeltetőjével és vizsgálja meg a naplófájlokat, amelyek fényt deríthetnek arra, hogy pontosan mi történik az adatcsere során. Amennyiben az adatcsere szolgáltatást végző webes szkript nem tartalmazna naplózási funkciót, javasoljuk ennek implementálását, azonban kérjük vegye figyelembe, hogy ilyen szolgáltatást mi nem tudunk nyújtani.
Szoftverünk minden esetben, ha valamilyen rendellenességet észlel, akkor tájékoztató üzenetet jelenít meg. Ennek hiányában az integráció során a webes rész lehet az oka a tapasztalt jelenségnek.
- “Hiba történt a kommunikáció során! Válasz első 20 karaktere: <!DOCTYPE html>”
Az üzenet arra utal, hogy a webáruházhoz történő kapcsolódás során a webes szolgáltatás nem a megfelelő XML formátumú választ adta, hanem hagyományos HTML választ. Ha ez az üzenet jelenik meg, kérjük vegye fel a kapcsolatot a weboldal üzemeltetőjével, vagy rendszergazdájával.
A webáruház és integráció funkció csak az AXEL PRO MAX termék esetében érhető el, az AXEL PRO LITE, PLUS és EXTRA változatban nem.