Az XML-ből történő importálás speciális szaktudást és konfigurálást, programozási ismereteket igényel, így csak különleges esetben, rendszerek integrációjakor szabad használni.
Számlák, eladások, megrendelések é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.
XML Importálás beállítása
Végezze el a beállításokat a Webáruház és integráció témakörben írtak szerint.
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.
XML Importálás indítása
a) Kattintson az Eszközök főmenü "Webáruház kapcsolódás" gombján.
b) A webáruház beállításoknál kapcsolja be a "Webáruházhoz kapcsolódás automatikusan minden indításnál" kapcsolót. Ekkor az AXEL PRO minden indításánál megtörténik az importálás.
c) Indítsa az AXEL PRO szoftvert a -import_trans, -import_all, vagy -export_import_all parancssori paraméterrel, ha a webáruház beállításoknál a "Paraméterezett programindítás engedélyezése" be van kapcsolva. A parancssori paraméter használatához hozzon létre olyan asztali parancsikont a Windowsban, amelyik cél beviteli mezőjében a következő szerepel:
C:\AXELPRO\axelpro.exe -import_trans
d) Használja az axelpro://-import_trans, axelpro://-import_all, vagy axelpro://-export_import_all URI protokollt.
Formátum leírás
Az XML importáláshoz az Ügylet XML import témakörben írtak szerint kell eljárni a Minta XML fájl alapján.
IMG_TYPE
Típus: Egész szám 0-tól 7-ig, kötelező.
Leírás: Az ügylet típusát azonosítja.
Értékek:
0: Kimenő Megrendelés
1: Beszerzés
2: Árajánlat
3: Bejövő Megrendelés
4: Díjbekérő
5: Eladás
6: Szállítólevél
7: Számla
IMG_DATETIME
Típus: Dátum és idő, számla kivételével kötelező.
Leírás: Kiállítási dátum és időpont, magyar formátumban. Számlák kivételével kötelező, mivel számla importáláskor mindig az aktuális dátumidő kerül a számla kiállítási dátumához, a mezőtől függetlenül. Más ügylet típusoknál meg kell adni.
IMG_FULFILMENT_DATE
Típus: Dátum, kötelező bizonyos ügylet típusoknál.
Leírás: Teljesítési dátum, amelynek a következő típusoknál van jelentősége: 7,4,5,1
IMG_DEADLINE_DATE
Típus: Dátum, kötelező bizonyos ügylet típusoknál.
Leírás: Határidő vagy érvényességi dátum. A következő típusoknál van jelentősége: 1,2,3,4,5,7
IMG_PAR_ID
Típus: Egész szám, nem kötelező.
Leírás: Ügylethez rendelt partner azonosító kódja, amely egy egész szám. Ha meg van adva, akkor az AXEL PRO partnerlistájában található partnerazonosító számot kell ide írni, amely szerepel az ügylet exportban és a partner lista exportban is. Ha nincs megadva, akkor az ügylet az img_customer_name vevőnév alapján lesz hozzárendelve a program partnerlistájához. Ha nincs a partnerlistán még azonos nevű partner, akkor beállítástól függően automatikusan létrejön egy új partner, amelyhez az ügylet hozzá lesz rendelve.
IMG_CUSTOMER_NAME
Típus: Szöveg, maximum 255 karakter, kötelező.
Leírás: Számlára, vagy más bizonylatra, ügyletre kerülő vevőnév.
IMG_CUSTOMER_ADDRESS
Típus: Szöveg, maximum 255 karakter, csak számlára kötelező.
Leírás: Számlára, vagy más bizonylatra, ügyletre kerülő cím (egy sorban az irányítószám, város, utca, házszám, stb.).
IMG_CUSTOMER_OTHER
Típus: Szöveg, maximum 255 karakter, nem kötelező.
Leírás: Számlára, vagy más bizonylatra, ügyletre kerülő egyéb adat.
IMG_CUSTOMER_TAXNR
Típus: Szöveg
Leírás: A partnerhez tartozó adószám. Ennek hiányában a számlára nem kerül adószám (pl magánszemélyek esetén)
IMG_CUSTOMER_FORM
Típus: Szöveg
Leírás: Ebben a mezőben megadható, hogy magánszemély vagy vállalkozásról van-e szó. Ha nincs megadva a mező, akkor ismeretlen vevő formaként importálódik az ügylet.
Lehetséges értékek:
0: ismeretlen
1: magánszemély
2: vállalkozás
IMG_POST_NAME
Típus: Szöveg, maximum 255 karakter, nem kötelező.
Leírás: Postázási / szállítási név. Csak szállítólevélnél van jelentősége. (típus: 6)
IMG_POST_ADDRESS
Típus: Szöveg, maximum 255 karakter, nem kötelező.
Leírás: Postázási / szállítási cím (egy sorban az irányítószám, város, utca, házszám, stb.). Csak szállítólevélnél van jelentősége. (típus: 6)
IMG_PAR_CTC_NAME
Típus: Szöveg, maximum 255 karakter, nem kötelező.
Leírás: Kapcsolattartó neve. Csak akkor kerül beállításra a partnerhez, ha az ügylet importtal együtt új partner jön létre a partnerlistában.
IMG_PAR_CTC_PHONE
Típus: Szöveg, maximum 50 karakter, nem kötelező.
Leírás: Kapcsolattartási telefonszám. Csak akkor kerül beállításra a partnerhez, ha az ügylet importtal együtt új partner jön létre a partnerlistában.
IMG_PAR_CTC_EMAIL
Típus: Szöveg, maximum 255 karakter, nem kötelező.
Leírás: Kapcsolattartási email cím. Csak akkor kerül beállításra a partnerhez, ha az ügylet importtal együtt új partner jön létre a partnerlistában.
IMG_PAY_NAME
Típus: Szöveg, maximum 20 karakter, kötelező bizonyos ügylet típusoknál.
Leírás: Fizetés módjának megnevezése. A következő típusoknál van jelentősége: 1,4,5,6,7. A programban található lehetséges fizetési módok közül kell egy megnevezését beírni, például készpénz, vagy átutalás
IMG_CURR
Típus: Szöveg, pontosan 3 karakter, nem kötelező.
Leírás: Ügylet összegeinek pénzneme három betűvel jelölve, például HUF
IMG_RATE
Típus: Szám, deviza ügyleteknél kötelező.
Leírás: Árfolyam. Ha HUF a pénznem, akkor 1, vagy kihagyható. Ha nem HUF, hanem például EUR, akkor 1 EUR értéke HUF-ban.
IMG_PRICE_TYPE
Típus: Egész szám 1-től 3-ig, kötelező.
Leírás: A programban bekapcsolható a háromféle eladási ár. Ilyenkor az ügylethez is meg kell adni 1-től 3-ig egy számot, amely azt jelöli, hogy az árak normál árak, vagy kedvezményes árak, vagy extra kedvezményes árak. Célszerű mindig az 1-es számot beírni.
IMG_DISCOUNT
Típus: Szám, nem kötelező.
Leírás: Számla vagy más ügylet egészére vonatkozó kedvezmény százaléka. Mivel ez tételenként is beállítható, ezért ez csak azt határozza meg, hogy a félkész ügylet új tétele milyen alapértelmezett kedvezményt tartalmazzon.
IMG_COPIES
Típus: Egész szám 0-tól 9-ig, nem kötelező.
Leírás: Példányszám 0-tól 9-ig. Számlák esetén minimum 2, szállítóleveleknél minimum 1. A nulla példányszám nyomtatás nélküli tárolást jelent.
IMG_COMMENT
Típus: Szöveg, maximum 1000 karakter, nem kötelező.
Leírás: Bizonylatra kerülő megjegyzés, amely nyomtatásban is látszódni fog.
IMG_IS_MOVE
Típus: Egész szám 0 vagy 1, kötelező.
Leírás: Mozgassa-e az adott ügylet a készletet. Ha 1,5,6,7 típusok valamelyike, akkor 1, egyébként 0. Előlegszámláknál 0.
IMG_IS_PAID
Típus: Egész szám 0 vagy 1, kötelező.
Leírás: Ügylet ki van-e fizetve. 1 vagy 0. Ha nincs megadva, akkor 0.
IMG_LANG
Típus: Egész szám 0-tól 3-ig. kötelező.
Leírás: Bizonylat nyelve az alábbiak szerint:
0: magyar
1: angol
2: német
3: egyéb
IMG_OTHER
Típus: Szöveg, maximum 50 karakter, nem kötelező.
Leírás: Ügylethez rendelhető opcionális egyéb mező, ami a bizonylatra nem feltétlenül kerül rá (beállítható a programban).
IMG_STORNO
Típus: Egész szám, kötelező.
Leírás: Sztornózási állapot az alábbiak szerint:
0: normál ügylet
1: olyan ügylet, ami le lett már sztornózva
2: olyan ügylet, amely egy másikat sztornóz le, tehát ez a mínuszos sztornó.
IMG_IS_ADVANCE
Típus: Egész szám 0 vagy 1, kötelező.
Leírás: Előlegszámla-e, vagy sem. 1, ha igen, 0, ha nem.
IMG_IS_CORRECTION
Típus: Egész szám 0 vagy 1, kötelező.
Leírás: Módosító számla-e (helyesbítő, jóváíró), vagy sem. 1, ha igen, 0, ha nem.
IMG_ENVELOPE
Típus: Egész szám 0 vagy 1, kötelező.
Leírás: Borítéknyomtatás legyen-e vagy sem. 1, ha igen, 0, ha nem.
IMG_COMPANY_PLUS
Típus: Egész szám 1-től 4-ig, kötelező.
Leírás: A programban többféle kibocsátó is beállítható, például különböző bankszámlaszámok esetében. Itt azt kell megadni, hogy a lehetséges négy közül melyik fejléc legyen a számlán, vagy más bizonylaton. Általában 1.
IMG_DOC_IDS
Típus: Szöveg, maximum 255 karakter, nem kötelező.
Leírás: Ügylethez rendelt kísérő dokumentumok azonosítókódjainak listája, vesszővel elválasztva. Csak speciális esetben kell használni, üresen hagyható.
IMG_GAR_PERCENT
Típus: Szám, nem kötelező.
Leírás: Garanciális visszatartás százaléka, általában 0.
IMG_GAR_AMOUNT
Típus: Szám, nem kötelező.
Leírás: Garanciális visszatartás összege, általában 0.
IMG_GAR_DATE
Típus: Dátum, nem kötelező.
Leírás: Garanciális visszatartás dátuma.
IMG_IS_PHOTO
Típus: Egész szám 0 vagy 1, nem kötelező.
Leírás: A bizonylatre nyomtatásra kerüljenek-e az árucikk listáról választott tételekhez tartozó fotók. 1, ha igen, 0, ha nem.
ITM_ITE_ID
Típus: Egész szám, nem kötelező.
Leírás: Ügyletre kerülő tétel azonosító kódja az árucikk listából. Ha meg van adva, akkor az AXEL PRO árucikk listájában a termék vagy szolgáltatás azonosítókódját kell megadni, amely szerepel az ügylet xml exportban és az árucikk lista xml exportban is. Ha nincs megadva, akkor a tétel az itm_name tételnév alapján lesz hozzárendelve a program árucikk listájához. Ha nincs az árucikk listán még azonos nevű árucikk, akkor beállítástól függően automatikusan létrejön egy új árucikk, amelyhez a tétel hozzá lesz rendelve.
ITM_NAME
Típus: Szöveg, maximum 255 karakter, kötelező.
Leírás: Tétel megnevezése, amely a bizonylatra is rákerül.
ITM_PRICE_PRICE
Típus: Szám, nem kötelező.
Leírás: A tétel nettó egységára. Ha tizedestört, akkor a tizedes elválasztó karakter a vessző legyen.
ITM_PRICE_DISCOUNT
Típus: Szám, nem kötelező.
Leírás: Tételre vonatkozó százalékos kedvezmény. Ha tizedestört, akkor a tizedes elválasztó karakter a vessző legyen.
ITM_PRICE_ORIG
Típus: Szám, nem kötelező.
Leírás: Tétel eredeti nettó egységára a kedvezmény levonás előtt. Ha tizedestört, akkor a tizedes elválasztó karakter a vessző legyen.
ITM_PRICE_VAT_SHORT
Típus: Szöveg, maximum 20 karakter, nem kötelező.
Leírás: A tétel áfakulcsának rövidített megnevezése. Kihagyva az alapértelmezett áfakulcs lesz beállítva.
ITM_DATETIME
Típus: Dátum és idő, kötelező.
Leírás: Ugyanazt a dátumot és időpontot kell megadni, mint az ügylethez tartozó kiállítási dátum.
ITM_AMOUNT
Típus: Szám, kötelező.
Leírás: A tétel mennyisége. Ha tizedestört, akkor a tizedes elválasztó karakter a vessző legyen.
ITM_UNIT
Típus: Szöveg, maximum 50 karakter, kötelező.
Leírás: Tétel mértékegysége (általában: db).
ITM_VTSZSZJ
Típus: Szöveg, maximum 20 karakter, nem kötelező.
Leírás: Tétel vtsz/szj száma.
ITM_FROM_STO_ID
és
ITM_TO_STO_ID
Típus: Egész szám, nem kötelező.
Leírás: Ha van készletmozgás az ügylethez, akkor honnan hova mozog az áru.
Számlánál a from 4, a to rész üres.
Megrendelésnél a from 0, a to rész üres.
Ha a from vagy a to rész üres, akkor az azt jelenti hogy nem raktárból/raktárba, hanem partnertől/partnerhez mozgott az áru. Ha 0 van megadva, akkor az azt jelenti, hogy nem történt mozgás raktárból/raktárba. Ha egy konkrét szám van megadva, akkor az a raktár számát jelöli. (4-es az alapértelmezett raktár)
Általában célszerű mindkét mezőt teljesen kihagyni az xml fájlból, mivel ilyenkor az alapértelmezett raktár lesz használva és az ügylet típusától függően mindig a megfelelő raktár lesz beállítva.
ITM_ORD
Típus: Egész szám, kötelező.
Leírás: Tétel sorszáma a bizonylaton 1-től kezdődően.
ITM_COMMENT
Típus: Szöveg, maximum 1000 karakter, nem kötelező.
Leírás: Tételhez tartozó megjegyzés, ami a bizonylaton is megjelenik.
Minta XML
AXELPRO_IMP_TRANS.XML fájl tartalma:
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<AXELPRO_IMP_TRANS VERSION="1.1">
<TRANS>
<TRANS_HEAD>
<IMG_TYPE>7</IMG_TYPE>
<IMG_DATETIME>2011.10.25. 16:25:32</IMG_DATETIME>
<IMG_FULFILMENT_DATE>2011.10.25.</IMG_FULFILMENT_DATE>
<IMG_DEADLINE_DATE>2011.10.25.</IMG_DEADLINE_DATE>
<IMG_CUSTOMER_NAME>Diszkont Áron EV.</IMG_CUSTOMER_NAME>
<IMG_CUSTOMER_ADDRESS>1025 Budapest, Lajos utca 11.</IMG_CUSTOMER_ADDRESS>
<IMG_CUSTOMER_TAXNR>12345678-9-12</IMG_CUSTOMER_TAXNR>
<IMG_POST_NAME></IMG_POST_NAME>
<IMG_POST_ADDRESS></IMG_POST_ADDRESS>
<IMG_PAY_NAME>készpénz</IMG_PAY_NAME>
<IMG_CURR>HUF</IMG_CURR>
<IMG_RATE>1</IMG_RATE>
<IMG_PRICE_TYPE>1</IMG_PRICE_TYPE>
<IMG_DISCOUNT>0</IMG_DISCOUNT>
<IMG_COPIES>2</IMG_COPIES>
<IMG_COMMENT>Ez a számla a DEMO-SZ-0000001 sorszámú számla alapján készült.</IMG_COMMENT>
<IMG_IS_MOVE>1</IMG_IS_MOVE>
<IMG_IS_PAID>1</IMG_IS_PAID>
<IMG_LANG>0</IMG_LANG>
<IMG_OTHER></IMG_OTHER>
<IMG_STORNO>0</IMG_STORNO>
<IMG_IS_ADVANCE>0</IMG_IS_ADVANCE>
<IMG_IS_CORRECTION>0</IMG_IS_CORRECTION>
<IMG_ENVELOPE>0</IMG_ENVELOPE>
<IMG_COMPANY_PLUS>1</IMG_COMPANY_PLUS>
</TRANS_HEAD>
<TRANS_ITEMS>
<TRANS_ITEM>
<ITM_NAME>coca-cola light 0.5l</ITM_NAME>
<ITM_PRICE_PRICE>240</ITM_PRICE_PRICE>
<ITM_PRICE_DISCOUNT>0</ITM_PRICE_DISCOUNT>
<ITM_PRICE_ORIG>240</ITM_PRICE_ORIG>
<ITM_PRICE_VAT_SHORT>25%</ITM_PRICE_VAT_SHORT>
<ITM_DATETIME>2011.10.25. 16:25:29</ITM_DATETIME>
<ITM_AMOUNT>3</ITM_AMOUNT>
<ITM_UNIT>db</ITM_UNIT>
<ITM_VTSZSZJ></ITM_VTSZSZJ>
<ITM_ORD>1</ITM_ORD>
<ITM_COMMENT></ITM_COMMENT>
</TRANS_ITEM>
<TRANS_ITEM>
<ITM_NAME>alma közepes zöld érett</ITM_NAME>
<ITM_PRICE_PRICE>208</ITM_PRICE_PRICE>
<ITM_PRICE_DISCOUNT>0</ITM_PRICE_DISCOUNT>
<ITM_PRICE_ORIG>208</ITM_PRICE_ORIG>
<ITM_PRICE_VAT_SHORT>25%</ITM_PRICE_VAT_SHORT>
<ITM_DATETIME>2011.10.25. 16:25:29</ITM_DATETIME>
<ITM_AMOUNT>5</ITM_AMOUNT>
<ITM_UNIT>kg</ITM_UNIT>
<ITM_VTSZSZJ></ITM_VTSZSZJ>
<ITM_ORD>2</ITM_ORD>
<ITM_COMMENT></ITM_COMMENT>
</TRANS_ITEM>
<TRANS_ITEM>
<ITM_NAME>csapolt sör</ITM_NAME>
<ITM_PRICE_PRICE>320</ITM_PRICE_PRICE>
<ITM_PRICE_DISCOUNT>0</ITM_PRICE_DISCOUNT>
<ITM_PRICE_ORIG>320</ITM_PRICE_ORIG>
<ITM_PRICE_VAT_SHORT>25%</ITM_PRICE_VAT_SHORT>
<ITM_DATETIME>2011.10.25. 16:25:29</ITM_DATETIME>
<ITM_AMOUNT>4</ITM_AMOUNT>
<ITM_UNIT>liter</ITM_UNIT>
<ITM_VTSZSZJ></ITM_VTSZSZJ>
<ITM_ORD>3</ITM_ORD>
<ITM_COMMENT></ITM_COMMENT>
</TRANS_ITEM>
<TRANS_ITEM>
<ITM_NAME>banán</ITM_NAME>
<ITM_PRICE_PRICE>144</ITM_PRICE_PRICE>
<ITM_PRICE_DISCOUNT>0</ITM_PRICE_DISCOUNT>
<ITM_PRICE_ORIG>144</ITM_PRICE_ORIG>
<ITM_PRICE_VAT_SHORT>25%</ITM_PRICE_VAT_SHORT>
<ITM_DATETIME>2011.10.25. 16:25:29</ITM_DATETIME>
<ITM_AMOUNT>1</ITM_AMOUNT>
<ITM_UNIT>kg</ITM_UNIT>
<ITM_VTSZSZJ></ITM_VTSZSZJ>
<ITM_ORD>4</ITM_ORD>
<ITM_COMMENT></ITM_COMMENT>
</TRANS_ITEM>
</TRANS_ITEMS>
</TRANS>
</AXELPRO_IMP_TRANS>