Ügylet XML Export
Az XML-be történő exportá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, akkor, amikor a hagyományos CSV-be történő exportálás valamilyen okból kifolyólag nem lehetséges. A legtöbb esetben nem XML-be, hanem a CSV-be történő exportálást érdemes használni, amelyre vonatkozóan az Exportálás témakörben írtak szerint kell eljárni.
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 XML formátumba.
XML Exportá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 export mezőben adja meg az exportálás célját. A beviteli mezőtől jobbra lévő legördülő listából kiválasztható, hogy mely ügylet típusok kiállítása esetén történjen automatikus exportálás.
XML Exportálás indítása
Állítson ki a szoftverrel egy ügyletet.
További információk
Szoftverünk a megadott URL címre POST üzenetben az AXELPRO_EXP_TRANS kulcs értékeként küldi az XML dokumentumot, így php-ban a $_POST['AXELPRO_EXP_TRANS'] változó értékét kell feldolgozni.
Visszatérési érték
Web URL felé történő exportálás során, ha a weblapon futó php script, vagy más program úgy érzékeli, hogy az adatok megfelelőek, akkor a visszaadott érték kizárólag egy 1-es karakter legyen. Amennyiben valamilyen okból kifolyólag a weblap nem tudja importálni az adatokat, akkor a visszaadott érték egy 0 karakter legyen, majd új sorban a probléma okának szöveges leírása.
Formátum és Mezők
IMG_ID
Típus: Egész szám.
Leírás: Az ügylet egyedi belső automatikusan kiosztott azonosító kódja.
IMG_NR
Típus: Szöveg, maximum 50 karakter.
Leírás: Az ügylet sorszáma.
IMG_TYPE
Típus: Egész szám 0-tól 7-ig.
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_TYPE_NAME
Típus: Szöveg, maximum 20 karakter.
Leírás: Az IMG_TYPE mezőhöz tartozó szöveges megnevezés.
IMG_DATETIME
Típus: Dátum és idő.
Leírás: Kiállítási dátum és időpont, magyar formátumban.
IMG_FULFILMENT_DATE
Típus: Dátum.
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.
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_ISSUER
Típus: Szöveg.
Leírás: Bizonylat kibocsátója.
IMG_PAR_ID
Típus: Egész szám.
Leírás: Ügylethez rendelt partner azonosító kódja. Ha nincs megadva, akkor nincs az ügylethez partner hozzárendelve a program partnerlistájához. Ha meg van adva, akkor az AXEL PRO partnerlistájában található partnerazonosító szám.
IMG_PAR_NAME
Típus: Szöveg, maximum 255 karakter.
Leírás: Az ügylethez hozzárendelt partner megnevezése a partnerlistáról.
IMG_CUSTOMER_NAME
Típus: Szöveg, maximum 255 karakter.
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.
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.
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 található meg, hogy magánszemély vagy vállalkozásról van-e szó.
Lehetséges értékek:
0: ismeretlen
1: magánszemély
2: vállalkozás
IMG_POST_NAME
Típus: Szöveg, maximum 255 karakter.
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.
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_SUM_NE
Típus: Szám.
Leírás: Az ügylet nettó összege.
IMG_SUM_BR
Típus: Szám.
Leírás: Az ügylet bruttó összege.
IMG_SUM_PAY
Típus: Szám.
Leírás: Az ügylet fizetendő végösszege, amely a végösszeg kerekítését is tartalmazza.
IMG_SUM_PAY
Típus: Szám.
Leírás: Az ügylet fizetendő végösszege, amely a végösszeg kerekítését is tartalmazza.
IMG_PAY_NAME
Típus: Szöveg, maximum 20 karakter.
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 kerül ide egy megnevezés, például készpénz, vagy átutalás.
IMG_CURR
Típus: Szöveg, pontosan 3 karakter.
Leírás: Ügylet összegeinek pénzneme három betűvel jelölve, például HUF.
IMG_RATE
Típus: Szám.
Leírás: Árfolyam. Ha HUF a pénznem, akkor 1, 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 tartozik 1-től 3-ig egy szám, amely azt jelöli, hogy az árak normál árak, vagy kedvezményes árak, vagy extra kedvezményes árak.
IMG_DISCOUNT
Típus: Szám.
Leírás: Számla vagy más ügylet egészére vonatkozó kedvezmény százaléka. Ez tételenként is beállítható.
IMG_COPIES
Típus: Egész szám 0-tól 9-ig.
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.
Leírás: Bizonylatra kerülő megjegyzés, amely nyomtatásban is látszódik.
IMG_IS_MOVE
Típus: Egész szám 0 vagy 1.
Leírás: Mozgatja-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.
Leírás: Ügylet ki van-e fizetve. 1, ha igen, 0, ha nem.
IMG_LANG
Típus: Egész szám 0-tól 3-ig.
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.
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.
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.
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.
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.
Leírás: Borítéknyomtatás volt-e az ügylethez, vagy sem. 1, ha igen, 0, ha nem.
IMG_COMPANY_PLUS
Típus: Egész szám 1-től 4-ig.
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. A lehetséges négy közül melyik fejléc lett kiválasztva a számlára, vagy más bizonylatra. Általában 1.
IMG_DOC_IDS
Típus: Szöveg, maximum 255 karakter.
Leírás: Ügylethez rendelt kísérő dokumentumok azonosítókódjainak listája, vesszővel elválasztva.
IMG_GAR_PERCENT
Típus: Szám.
Leírás: Garanciális visszatartás százaléka, általában 0.
IMG_GAR_AMOUNT
Típus: Szám.
Leírás: Garanciális visszatartás összege, általában 0.
IMG_GAR_DATE
Típus: Dátum.
Leírás: Garanciális visszatartás dátuma.
IMG_CREATED_DATETIME
Típus: Dátum és idő.
Leírás: Ügylet létrehozási időpontja.
IMG_CREATED_USE_NAME
Típus: Szöveg, maximum 20 karakter.
Leírás: Ügyletet létrehozó felhasználó neve.
IMG_CHANGED_DATETIME
Típus: Dátum és idő.
Leírás: Ügylet módosítási időpontja.
IMG_CHANGED_USE_NAME
Típus: Szöveg, maximum 20 karakter.
Leírás: Ügyletet módosító felhasználó neve.
ITM_ITE_ID
Típus: Egész szám.
Leírás: Ügyletre kerülő tétel azonosító kódja az árucikk listából, ha a tétel az árucikk listából lett választva.
ITM_NAME
Típus: Szöveg, maximum 255 karakter.
Leírás: Tétel megnevezése, amely a bizonylaton is szerepel.
ITM_ITE_NAME
Típus: Szöveg, maximum 255 karakter.
Leírás: Ha árucikk listából lett az ügyletre a tétel választva, akkor az árucikk megnevezése az árucikk listáról.
ITM_PRICE_PRICE
Típus: Szám.
Leírás: A tétel nettó egységára.
ITM_PRICE_DISCOUNT
Típus: Szám.
Leírás: Tételre vonatkozó százalékos kedvezmény.
ITM_PRICE_ORIG
Típus: Szám.
Leírás: Tétel eredeti nettó egységára a kedvezmény levonás előtt.
ITM_PRICE_VAT_SHORT
Típus: Szöveg, maximum 20 karakter.
Leírás: A tétel áfakulcsának rövidített megnevezése.
ITM_DATETIME
Típus: Dátum és idő.
Leírás: Ugyanaz a dátum és időpont, mint az ügylethez tartozó kiállítási dátum.
ITM_AMOUNT
Típus: Szám.
Leírás: A tétel mennyisége.
ITM_UNIT
Típus: Szöveg, maximum 50 karakter.
Leírás: Tétel mértékegysége (általában: db).
ITM_VTSZSZJ
Típus: Szöveg, maximum 20 karakter.
Leírás: Tétel vtsz/szj száma.
ITM_FROM_STO_ID
és
ITM_TO_STO_ID
Típus: Egész szám.
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)
ITM_ORD
Típus: Egész szám.
Leírás: Tétel sorszáma a bizonylaton 1-től kezdődően.
ITM_COMMENT
Típus: Szöveg, maximum 1000 karakter.
Leírás: Tételhez tartozó megjegyzés, ami a bizonylaton is megjelenik.
Minta XML
AXELPRO_EXP_TRANS_15.XML fájl tartalma:
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<AXELPRO_EXP_TRANS VERSION="1.1">
<TRANS>
<TRANS_HEAD>
<IMG_ID>15</IMG_ID>
<IMG_NR>DEMO-SZ-0000008</IMG_NR>
<IMG_TYPE>7</IMG_TYPE>
<IMG_TYPE_NAME>számla</IMG_TYPE_NAME>
<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_ISSUER>Nem Létező Kft.
1234 Budapest, Ismeretlen u. 123.
Adószám: 12345678-1-23
</IMG_ISSUER>
<IMG_PAR_ID>714</IMG_PAR_ID>
<IMG_PAR_NAME>Diszkont Áron EV.</IMG_PAR_NAME>
<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_SUM_NE>3184</IMG_SUM_NE>
<IMG_SUM_BR>3980</IMG_SUM_BR>
<IMG_SUM_PAY>3980</IMG_SUM_PAY>
<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>
<IMG_DOC_IDS></IMG_DOC_IDS>
<IMG_GAR_PERCENT>0</IMG_GAR_PERCENT>
<IMG_GAR_AMOUNT>0</IMG_GAR_AMOUNT>
<IMG_GAR_DATE></IMG_GAR_DATE>
<IMG_CREATED_DATETIME>2011.10.25. 16:25:29</IMG_CREATED_DATETIME>
<IMG_CREATED_USE_NAME></IMG_CREATED_USE_NAME>
<IMG_CHANGED_DATETIME></IMG_CHANGED_DATETIME>
<IMG_CHANGED_USE_NAME></IMG_CHANGED_USE_NAME>
</TRANS_HEAD>
<TRANS_ITEMS>
<TRANS_ITEM>
<ITM_ID>33</ITM_ID>
<ITM_ITE_ID>109</ITM_ITE_ID>
<ITM_NAME>coca-cola light 0.5l</ITM_NAME>
<ITM_ITE_NAME>coca-cola light 0.5l</ITM_ITE_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_FROM_STO_ID>4</ITM_FROM_STO_ID>
<ITM_TO_STO_ID></ITM_TO_STO_ID>
<ITM_ORD>1</ITM_ORD>
<ITM_COMMENT></ITM_COMMENT>
</TRANS_ITEM>
<TRANS_ITEM>
<ITM_ID>34</ITM_ID>
<ITM_ITE_ID>103</ITM_ITE_ID>
<ITM_NAME>alma közepes zöld érett</ITM_NAME>
<ITM_ITE_NAME>alma közepes zöld érett</ITM_ITE_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_FROM_STO_ID>4</ITM_FROM_STO_ID>
<ITM_TO_STO_ID></ITM_TO_STO_ID>
<ITM_ORD>2</ITM_ORD>
<ITM_COMMENT></ITM_COMMENT>
</TRANS_ITEM>
<TRANS_ITEM>
<ITM_ID>35</ITM_ID>
<ITM_ITE_ID>110</ITM_ITE_ID>
<ITM_NAME>csapolt sör</ITM_NAME>
<ITM_ITE_NAME>csapolt sör</ITM_ITE_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_FROM_STO_ID>4</ITM_FROM_STO_ID>
<ITM_TO_STO_ID></ITM_TO_STO_ID>
<ITM_ORD>3</ITM_ORD>
<ITM_COMMENT></ITM_COMMENT>
</TRANS_ITEM>
<TRANS_ITEM>
<ITM_ID>36</ITM_ID>
<ITM_ITE_ID>105</ITM_ITE_ID>
<ITM_NAME>banán</ITM_NAME>
<ITM_ITE_NAME>banán</ITM_ITE_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_FROM_STO_ID>4</ITM_FROM_STO_ID>
<ITM_TO_STO_ID></ITM_TO_STO_ID>
<ITM_ORD>4</ITM_ORD>
<ITM_COMMENT></ITM_COMMENT>
</TRANS_ITEM>
</TRANS_ITEMS>
</TRANS>
</AXELPRO_EXP_TRANS>