Tharanis API v 2.2 (2016.01.31) Az eljáráshívás minden esetben SOAP-on keresztül történik. A kapcsolat létrehozása (PHP): $client = new SoapClient(null, array('location' => "https://login.tharanis.hu/kapcs.php", 'uri' => "urn://kapcs")); A rendszerben haszbálatos nyelvek lekérdezése: $client->lekerd_nyelv(ügyfélkód,cégkód,jelszó); jelszó: Egyelőre egy üres string ("") Output XML: <nyelvek> <nyelv> <kod>m</kod> <nev>magyar</nev> </nyelv> <nyelv> <kod>a</kod> <nev>angol</nev> </nyelv> </nyelvek> Cikkek lekérdezése webáruházas megjelenítéshez: 1
$client->lekerd_cikk(ügyfélkód,cégkód,jelszó[,shop[,cikkszám[,árak[,valuta,[,utolsó módosítás[,nyelv]]]]]]); jelszó: Egyelőre egy üres string ("") shop: A lekérdező webshop neve. (Ez szerepeljne a programban a webáruházak között is) Amennyiben meg van adva, és a cikkszam paraméter üres, csak azon cikkek szerepelnek az XML-ben, amelyek webes megjelenítési adatai nincsenek megadva, vagy be van állítva, hogy a cikk megjelenjen a shop partamétzerben megadott webáruházban. arak: Itt adható meg, hogy mely eladási árakra vagyunk kiváncsiak, azaz egyes,kettes, vagy hármas. Ennek megfelelően a paraméter "1","2","3", vagy ezek kombinációja ("12","23","123", stb) valuta: Itt adható meg, hogy mely valutanemben (vagy,-vel elválasztava valutranemekben) nyilvántartott árakat szeretnénk látni. Üres ("") esetén az összes ár listázódik. utolsó módosítás: (éééé.hh.nn óó:pp:mm) Opcionális, megadása esetén csak a megadott időpontnál UTÁN módosított cikkek adatai listázódnak. nyelv: Opcionális, megadása esetén csak a megadott nyelvű adatok jelennek meg. Csak a lekerd_nyelv() hívás által visszaadott betűk adhatók meg. Több nyelv is megadható (pl. AO ). Output XML: <cikkek> <cikk> <cikksz></cikksz> => Cikkszám <ean></ean> => Vonalkód <szulocikk></szulocikk> => Szülõ cikk. Csak akkor van kitöltve, ha a cikk a szülõ cikk egy változata (Pl. szín, méret, stb.) <aktiv>i</aktiv> => Aktív I/N <tipus>t</tipus> => T=termék, S=Szolgáltatás <kategoriak> => mely kategóriákban jelenjen meg <kategoria></kategoria> => Kategória kódja <kategoria></kategoria> => Kategória kódja </kategoriak> <gyarto_id></gyarto_id> => Gyártó kódja <garido> => Garanciaidõ </garido> <minimum></minimum> => Minimum rendelhetõ mennyiség. (Ez, vagy ennek többszöröse, a cikktörzsben beállított kiszerelési/bonthatósági adatok alapján) <megnevezes> => A cikk neve különbözõ nyelveken (Ez a cikktörzsben megadott név, ami a számlára is kerülni fog)... megnevezés további nyelveken (Ez a késõbbiekben mindegyik hasonló elemre igaz) </megnevezes> <meegys> => A cikk mennyiségi egysége </meegys> <egys_ar_me> => Egségenkénti ár mennyiségi egysége (Pl. ha valami 200g-os kiszerelés, de az árát kg-ban is fel kell tüntetni) 2
</egys_ar_me> <egys_ar_szorzo>0</egys_ar_szorzo> => Egségenkénti ár a fenti példa alapján 5 <tulajdonsagok> => Tulajdonságok különbözõ nyelveken. A tulajdonság és az érték ::-tal van elválasztva <tulajdonsag> </tulajdonsag> <tulajdonsag> </tulajdonsag>... további tulajdonságok </tulajdonsagok> <megjnev> => A cikk webshopban megjelenítendõ neve különbözõ nyelveken </megjnev> <leiras> => Leírás különbözõ nyelveken, HTML-ben </leiras> <url> => A megjeleníteni kívént URL különbözõ nyelveken </url> <meta_title> => A megjeleníteni kívánt title különbözõ nyelveken </meta_title> <meta_description> => A meta description különbözõ nyelveken </meta_description> <meta_keywords> => A meta keywords különbözõ nyelveken </meta_keywords> <afaszaz> => ÁFA % azon országpk szerint, ahol a cég bejegyzett adószámmal rendelkezik. <HUN></HUN> <SVK></SVK> </afaszaz> <ar1> => A cikk ára különbözõ valutákban. <HUF></HUF> <EUR></EUR>... ár további pénznemekben </ar1> <akciosar1> => A cikk akciós ára különbözõ valutákban. (Ha nincs akció, akkor megegyezik az <ar> taggal) <HUF></HUF> <EUR></EUR>... akciós ár további pénznemekben </akciosar1> <keszlet> => Raktárkészletek a különbözõ raktárakban, egyelõre csak <kozpont></kozpont> van. <kozpont></kozpont> => Központi raktár ksézlete </keszlet> <szallido> => Szállítási idõ, ha a termék nincs raktáron 3
</szallido>> <valt_nev1>=> Az esetleges változatok megnevezése (Pl. Szín) </valt_nev1> <valtozat1> => Megjelenítés ezen változatként (Pl. piros) </valtozat1>... <opciok> => A termékhez kapcsolódó választható kiegészítõk, opciók vagy egyéb dolgok (Lásd példa) <opcio> <megnev> => Az opció megnevezése </megnev> <elemek> => A választható elemek <elem> <nev> => Megjelenõ név </nev> <felar> => Felár, ha van. Ha nincs, az egész <felar></felar> tag hiányzik <HUF></HUF> <EUR></EUR> </felar> </elem>.. további elemek </elemek> </opcio>.. további opciók </opciok> <kapcscikk> => Kapcsolódó cikkek cikkszámai <cikkszam></cikkszam> <cikkszam></cikkszam>.. további cikkek </kapcscikk> <kepek> => Képek URL-jei <kep></kep>.. további képek, mindig az elsõ a "listakép" </kepek> </cikk> </cikkek> Példa: (Hátizsák külömböző színekben választható extra esővédővel) <?xml version="1.0" encoding="utf-8"?> <cikkek> <cikk> <cikksz>dacl141</cikksz> <szulocikk></szulocikk> <ean></ean> <aktiv>i</aktiv> <kategoriak> <kategoria>148</kategoria> </kategoriak> <gyarto_id>248</gyarto_id> <garido> 4
<M><![CDATA[]]></M> <A><![CDATA[]]></A> </garido> <minimum></minimum> <megnevezes> <M><![CDATA[Deuter AC Lite 14 fekete]]></m> <A><![CDATA[]]></A> </megnevezes> <meegys> <M><![CDATA[db]]></M> <A><![CDATA[pc]]></A> </meegys> <egys_ar_me> <M><![CDATA[]]></M> <A><![CDATA[]]></A> </egys_ar_me> <egys_ar_szorzo>0</egys_ar_szorzo> <tulajdonsagok> <tulajdonsag> <M><![CDATA[Ûrtartalom::14 l]]></m> <A><![CDATA[Capacity::14 l]]></a> </tulajdonsag> <tulajdonsag> <M><![CDATA[Tömeg::860 g]]></m> <A><![CDATA[Weight::860 g]]></a> </tulajdonsag> <tulajdonsag> <M><![CDATA[Hátrendszer::Deuter Advanced Aircomfort System]]></M> <A><![CDATA[System::Deuter Advanced Aircomfort System]]></A> </tulajdonsag> <tulajdonsag> <M><![CDATA[Anyag::Ripstop 210/Microrip Nylon]]></M> <A><![CDATA[Material::Ripstop 210/Microrip Nylon]]></A> </tulajdonsag> <tulajdonsag> <M><![CDATA[Méret::50 x 30 x 18 cm]]></m> <A><![CDATA[Size::50 x 30 x 18 cm]]></a> </tulajdonsag> <tulajdonsag> <M><![CDATA[Kialakítás::Uniszex]]></M> <A><![CDATA[Formation::Unisex]]></A> </tulajdonsag> <tulajdonsag> <M><![CDATA[Zsebek::2]]></M> <A><![CDATA[Pockets::2]]></A> </tulajdonsag> </tulajdonsagok> <megjnev> <M><![CDATA[Deuter AC Lite 14 eng]]></m> <A><![CDATA[Deuter AC Lite 14]]></A> </megjnev> <url> <M>deuter-ac-lite-14</M> <A>deuter-ac-lite-14</A> </url> <meta_title> <M><![CDATA[Deuter AC Lite 14]]></M> <A><![CDATA[Deuter AC Lite 14]]></A> </meta_title> <meta_description> <M><![CDATA[Hátizsák 1 napos túrákhoz]]></m> 5
<A><![CDATA[1 daz hikes backpack]]></a> </meta_description> <meta_keywords> <M><![CDATA[Deuter AC Lite 14]]></M> <A><![CDATA[Deuter AC Lite 14]]></A> </meta_keywords> <leiras> <M><![CDATA[Rövidebb, 1 napos túrákhoz kifejezetten ajánlott könnyû hátizsák 3 külömbözõ színben. Esõ és hóálló anyaga biztosítja, hogy minden idõjátási körülmény között kényelmesen használható.<br />]]></M> <A><![CDATA[Backpack for short & one day tours in 3 different colors. Rain and snow resistant materials.]]></a> </leiras> <afaszaz> <HUN>27</HUN> </afaszaz> <ar1> <HUF>14165.35</HUF> <EUR>39.29</EUR> </ar1> <akciosar1> <HUF>14165.35</HUF> <EUR>39.29</EUR> </akciosar1> <ar2> <HUF>14165.35</HUF> <EUR>39.29</EUR> </ar2> <akciosar2> <HUF>12345.3552</HUF> <EUR>29.29</EUR> </akciosa21> <opciok> <opcio> <megnev> <M><![CDATA[Extra védelem]]></m> <A><![CDATA[Extra protection]]></a> </megnev> <elemek> <elem> <nev> <M><![CDATA[Nincs]]></M> <A><![CDATA[None]]></A> </nev> </elem> <elem> <nev> <M><![CDATA[Extra esõvédõ]]></m> <A><![CDATA[Extra rain protector]]></a> </nev> <felar> <HUF>729.93</HUF> <EUR>2.14</EUR> </felar> </elem> </elemek> </opcio> </opciok> <kapcscikk> 6
<cikkszam>dacl221</cikkszam> </kapcscikk> <kepek> <kep><![cdata[http://demo.ashton.hu/kepek/user/9999/dacl14.jpg]]></kep> <kep><![cdata[http://demo.ashton.hu/kepek/user/9999/dacl14_1.jpg]]></kep> <kep><![cdata[http://demo.ashton.hu/kepek/user/9999/dacl14_2.jpg]]></kep> <kep><![cdata[http://demo.ashton.hu/kepek/user/9999/dacl14_3.jpg]]></kep> </kepek> <valt_nev> <M><![CDATA[Szín]]></M> <A><![CDATA[Color]]></A> </valt_nev> <valtozat> <M><![CDATA[fekete]]></M> <A><![CDATA[black]]></A> </valtozat> <tipus>t</tipus> <keszlet> <kozpont>0</kozpont> </keszlet> <szallido> <M><![CDATA[2-3 hét]]></m> <A><![CDATA[2-3 weeks]]></a> </szallido>> </cikk> </cikkek> Termékkategóriák (cikkcsoportok) lekérdezése: $client->lekerd_kateg(ügyfélkód,cégkód,jelszó[,webáruház[,nyelv]]); jelszó: Egyelőre egy üres string ("") webáruház: Az XML-ben csak azon cikkcsoportok fognak megjelenni, amelyekhez beálltottuk hogy ezen werbáruházban megjelenjenek. Az összes cikkcsoport megjelenítéséhez az értékez hagyjuk le, vagy hagyjuk üresen ("") nyelv: Opcionális, megadása esetén csak a megadott nyelvű adatok jelennek meg. Csak a lekerd_nyelv() hívás által visszaadott betűk adhatók meg. Több nyelv is megadható (pl. AO ). Output XML: <kateggoriak> <kategoria> <azon></azon> => Azonosító, nálam mindig numerikus <szulo></szulo> => A szülõ azonosítója <szint></szint> => A kategória szintje (0 = gyökér) <megnev> => Megnevezés különbözõ nyelveken 7
... megnevezés további nyelveken </megnev> <kep></kep> => A ketagóriához tartozó kép URL-je <leiras> => A kategória leírása különbözõ nyelveken (HTML) </leiras> <url> => A megjeleníteni kívént URL különbözõ nyelveken </url> <meta_title> => A megjeleníteni kívént title különbözõ nyelveken </meta_title> <meta_description> => A meta description különbözõ nyelveken </meta_description> <meta_keywords> => A meta keywords különbözõ nyelveken </meta_keywords> </kategoria> </kategoriak> Gyártók lekérdezése: $client->lekerd_gyarto(ügyfélkód,cégkód,jelszó[,webáruház[,nyelv]]); jelszó: Egyelőre egy üres string ("") webáruház: Az XML-ben csak azon gyártók fognak megjelenni, amelyekhez beálltottuk hogy ezen werbáruházban megjelenjenek. Az összes gyártó megjelenítéséhez az értékez hagyjuk le, vagz hagzjuk üresen ("") nyelv: Opcionális, megadása esetén csak a megadott nyelvű adatok jelennek meg. Csak a lekerd_nyelv() hívás által visszaadott betűk adhatók meg. Több nyelv is megadható (pl. AO ). Output XML: <gyartok> <gyarto> <id></id> => ID <megnev> => Megnevezés különbözõ nyelveken... megnevezés további nyelveken </megnev> <kep></kep> => A gyártóhoz tartozó kép URL-je 8
<leiras> => A gyártó leírása különbözõ nyelveken (HTML)... leírás további nyelveken </leiras> <url> => A megjeleníteni kívént URL különbözõ nyelveken... </url> <meta_title> => A megjeleníteni kívént title különbözõ nyelveken... </meta_title> <meta_description> => A meta description különbözõ nyelveken... </meta_description> <meta_keywords> => A meta keywords különbözõ nyelveken... </meta_keywords> </gyarto> </gyartok> Fordítások lekérdezése: (A cikkek magyar nyelven megadott adatainak fordításai a rendszerben használatos idegen nyelvekre. Ilyenek pl. tulajdonságokm változatok, opciók, stb.) $client->lekerd_ford(ügyfélkód,cégkód,jelszó[,nyelv]); jelszó: Egyelőre egy üres string ("") nyelv: Opcionális, megadása esetén csak a megadott nyelvű adatok jelennek meg. Csak a lekerd_nyelv() hívás által visszaadott betűk adhatók meg. Több nyelv is megadható (pl. AO ). Output XML: <elemek> <elem> => Magyar => fordítás... további fordítások </elem> </elemek> 9
Raktárkészlet lekérdezése XML formátumban: (A függvény kiadható készletet adja vissza.) $client->lekerd_keszlet(ügyfélkód,cégkód,jelszó[,cikkszam[,shop[,raktar idr[,keszlet tipus[,utolso modositas]]]]]); jelszó: Egyelőre egy üres string ("") cikkszam: Elhagyva vagy üres értékkel a program csak a készleten lévő cikkek raktárkészleteit adja vissza. Konkrét cikkszámot (vagy cikkszámokat,-vel elválasztva) megadva at adott cikk/cikkek készletét adja vissza, akkor is, ha az 0 vagy negatív. * -ot megadva a cikktörzsben szereplő összes cikk raktárkészlete (vagy annak hiánya) szerepel az XML-ben. (Figyelem! A * haszbálatával egy nagobb cikktörzs esetén az XML több százezer tétel is lehet, csak indokolt esetben használatos!). A paraméter megadása esetén a program az utolso modositas paramétert figyelmen kívül hagyja. shop: A lekérdező webshop neve. (Ez szerepeljne a programban a webáruházak között is) Amennyiben meg van adva, és a raktar paraméter üres, a program azon raktárak készletét adja vissza, amely a rendszerben a webáruház kommunikációs beállításainál meg lett adva. Elhagyása vagy a rendszerben nem létező shop esetén a program a Központi raktár készletét fogja alapul venni. Megadása esetén figyeli továbbá a program, hogy a cikkek közül melyek azok, amelyek a webes megjelenítési adataihoz lett beállítva ez a webáruház. Csak azon cikkek szerepelnek az XML-ben, amelyek webes megjelenítési adatai nincsenek megadva, vagy be van állítva, hogy a cikk megjelenjen a shop partamétzerben megadott webáruházban. raktar id: Megadása esetén a program csak az itt megadott raktár (vagy,-vel elválasztva raktárak) készleteit adja vissza. Elhagyása vagy üres érték esetén, ha a shop paraméter meg van adva, azon raktárak készletét adja vissza, amely a rendszerben a webáruház kommunikációs beállításainál meg lett adva. Ha a shop paraméter üres, a program a Központi raktár készletét fogja visszaadni. keszlet tipus: A visszaadott készlet formátuma. A: Analitika, azaz az egyes raktárak készletei külön-külön kerülnek az XML-be (lásd lentebb), O: ÖŰsszesített érték, azaz a megadott, vagy beállított raktárak összesített készlete kerül az XML-be. Üres érték esetén, ha a shop paraméter meg van adva, a készlet olyan formában kerül az XMLeb, amely a rendszerben a webáruház kommunikációs beállításainál meg lett adva. Ha a shop paraméter üres, a program összesített raktárkészletet listáz. utolso modositas: Megadása esetén csak az itt megadott időpont (éééé-hh-nn óó:pp:mm) UTÁN módosult készleteket szerepelnek az XML-ben. Megadása esetén a listában értelmeszerűen a 0-ás készletek is szerepelni fognak. Output XML : összesített készletformátum esetén <keszletek> <cikk> <cikksz>cs2</cikksz> <menny>2</menny> </cikk> </keszletek> 10
analitikus készletformátum esetén <keszletek> <cikk> <cikksz>cs2</cikksz> <menny[raktár id]>2</menny[raktár id]> pl. <menny1>2</menny1> <menny[raktár id]>1</menny[raktár id]> </cikk> </keszletek> Árak lekérdezése XML formátumban: (A függvény nettó árakat ad vissza) $client->lekerd_arak(ügyfélkód,cégkód,jelszó,árak,valuta[,cikkszam[,shop[,utolso modositas]]); jelszó: Egyelőre egy üres string ("") arak: Itt adható meg, hogy mely eladási árakra vagyunk kiváncsiak, azaz egyes,kettes, vagy hármas. Ennek megfelelően a paraméter "1","2","3", vagy ezek kombinációja ("12","23","123", stb) valuta: Itt adható meg, hogy mely valutanemben (vagy,-vel elválasztava valutranemekben) nyilvántartott árakat szeretnénk látni. Üres ("") esetén az összes ár listázódik. cikkszám: Opcionális, megadása esetén csak az adott cikk (vagy,-vel elválasztva cikkek) adatai listázódnak ki. Megadása esetén a program az utolso modositas paramétert figyelmen kívül hagyja. shop: Megadása esetén figyeli a program, hogy a cikkek közül melyek azok, amelyek a webes megjelenítési adataihoz lett beállítva ez a webáruház. Csak azon cikkek szerepelnek az XML-ben, amelyek webes megjelenítési adatai nincsenek megadva, vagy be van állítva, hogy a cikk megjelenjen a shop paraméterben megadott webáruházban. utolso modositas: Megadása esetén (éééé-hh-nn óó:pp:mm) csak azon cikkek jelennek meg, amelyek ára az itt megadott időpont UTÁN módosult. Output XML: <arak> <cikk> <cikksz>1254</cikksz> <afaszaz>27</afaszaz> <ar1> <HUF>1000</HUF> 11
</ar1> <ar2> <HUF>0</HUF> </ar2> <akciosar1> <HUF>920</HUF> </akciosar1> <akciosar2> <HUF>0</HUF> </akciosar2> </cikk> </arak> Árak és készletek együttes lekérdezése XML formátumban: (A függvény kiadható készletet, valamint nettó árakat ad vissza.) $client->lekerd_arkesz(ügyfélkód,cégkód,jelszó,árak,valuta[,cikkszám[,shop[,raktar idr[,keszlet tipus[,utolso modositas]]]]]); jelszó: Egyelőre egy üres string ("") arak: Itt adható meg, hogy mely eladási árakra vagyunk kiváncsiak, azaz egyes,kettes, vagy hármas. Ennek megfelelően a paraméter "1","2","3", vagy ezek kombinációja ("12","23","123", stb) valuta: Itt adható meg, hogy mely valutanemben nyilvántartott árakat szeretnénk látni. Üres ("") esetén az összes ár listázódik. cikkszám: Opcionális, megadása esetén csak az adott cikk (vagy,-vel elválasztva cikkek) adatai listázódnak ki. Megadása esetén a program az utolso modositas paramétert figyelmen kívül hagyja. shop: A lekérdező webshop neve. (Ez szerepeljne a programban a webáruházak között is) Amennyiben meg van adva, és a raktar paraméter üres, a program azon raktárak készletét adja vissza, amely a rendszerben a webáruház kommunikációs beállításainál meg lett adva. Elhagyása vagy a rendszerben nem létező shop esetén a program a Központi raktár készletét fogja alapul venni. Megadása esetén figyeli továbbá a program, hogy a cikkek közül melyek azok, amelyek a webes megjelenítési adataihoz lett beállítva ez a webáruház. Csak azon cikkek szerepelnek az XML-ben, amelyek webes megjelenítési adatai nincsenek megadva, vagy be van állítva, hogy a cikk megjelenjen a shop paraméterben megadott webáruházban. raktar id: Megadása esetén a program csak az itt megadott raktár (vagy,-vel elválasztva raktárak) készleteit adja vissza. Elhagyása vagy üres érték esetén, ha a shop paraméter meg van adva, azon raktárak készletét adja vissza, amely a rendszerben a webáruház kommunikációs beállításainál meg lett adva. Ha a shop paraméter üres, a program a Központi raktár készletét fogja visszaadni. keszlet tipus: A visszaadott készlet formátuma. A: Analitika, azaz az egyes raktárak készletei külön-külön kerülnek az XML-be (lásd lentebb), O: ÖŰsszesített érték, azaz a megadott, vagy beállított raktárak összesített készlete kerül az XML-be. Üres érték esetén, ha a shop paraméter meg van adva, a készlet olyan formában kerül az XMLeb, amely a rendszerben a webáruház kommunikációs beállításainál meg lett adva. Ha a shop paraméter is üres, a program összesített raktárkészletet listáz. 12
utolso modositas: Megadása esetén (éééé-hh-nn óó:pp:mm) csak azon cikkek jelennek meg, amelyek készlete vagy ára az itt megadott időpont UTÁN módosult. Output XML: Összesített készlet: <arak> <cikk> <cikksz>1254</cikksz> <afaszaz>27</afaszaz> <ar1> <HUF>1000</HUF> </ar1> <ar2> <HUF>0</HUF> </ar2> <akciosar1> <HUF>920</HUF> </akciosar1> <akciosar2> <HUF>0</HUF> </akciosar2> <menny>1</menny> </cikk> </arak> Analitikus készlet: <arak> <cikk> <cikksz>1254</cikksz> <afaszaz>27</afaszaz> <ar1> <HUF>1000</HUF> </ar1> <ar2> <HUF>0</HUF> </ar2> <akciosar1> <HUF>920</HUF> </akciosar1> <akciosar2> <HUF>0</HUF> </akciosar2> 13
<menny1>1</menny1> <menny2>1</menny2> </cikk> </arak> Beszállítási idők lekérdezése XML formátumban: $client->lekerd_beszido(ügyfélkód,cégkód,jelszó[,cikkszám[,shop[,utolso modositas]]]); jelszó: Egyelőre egy üres string ("") cikkszám: Opcionális, megadása esetén csak az adott cikk (vagy,-vel elválasztva cikkek) listázódik ki. shop: A lekérdező webshop neve. (Ez szerepeljen a programban a webáruházak között is) Megadása esetén figyeli a program, hogy a cikkek közül melyek azok, amelyek a webes megjelenítési adataihoz lett beállítva ez a webáruház. Csak azon cikkek szerepelnek az XML-ben, amelyek webes megjelenítési adatai nincsenek megadva, vagy be van állítva, hogy a cikk megjelenjen a shop paraméterben megadott webáruházban. utolso modositas: Megadása esetén (éééé-hh-nn óó:pp:mm) csak azon cikkek jelennek meg, amelyek adatai az itt megadott időpont UTÁN módosultak. Output XML: <beszidok> <cikk> <cikksz>1254</cikksz> <besz_ido>0</besz_ido> </cikk> </beszidok> Megrendelések átadása: $client->rend_berak(ügyfélkód,cégkód,xml); xml: A megrendelés adatai XML formátumban Az XML specifikációja: <?xml version="1.0" encoding="utf-8"?> <megrendeles> <fej> 14
<kuldo>webshop</kuldo> => a webáruház URL-je http://www. nélkül (pl. akarmi.hu) Csak az lehet, amit elõzõleg a rendszerbe felvettünk, mint webáruházat (Törzsek/Értékesítés/Webáruházak) <id>131253809014</id> => rendelésazonosító <beerk>2011.08.05 11:54</beerk> => beérkezés dátuma eeee.hh.nn oo:pp formában <atvdat>2011.08.10</atvdat> => a megrebdelõ által kért teljesítés dátuma <resztelj>i</resztelj> => kér-e részteljesítést (I/N) <email>valaki@valami.com</email> => a megrendelõ email címe. kötelezõ megadni, ez alapján van azonosítva a vevõ a partnertörzsben!!! <telefon></telefon> => megrendelõ telefonszáma <valuta>huf</valuta> => A megrendelés pénzneme (HUF, EUR, stb.) <afaval>hun</afaval> => Meghatározza, hogy a bruttó árak kiszámítása mely ország ÁFA kulcsa alapján történjen. Csak olyan ország kódja szerepelhet, amelyben a cég bejegyzett adószámmal rendelkezik és ez elõzõleg a programben regisztrálva lett. ÁFA nélküli rendelések esetén az érték 0. Élnek a régi értékek is (I/N 1/0 yes/no). I/1/yes esetén a cég székhelye szerinti ÁFA kulcs van figyelembe véve. <fiz_mod>utánvét</fiz_mod> => A következõk lehetnek: Átutalás, Bankkártya, Csekk, Készpénz, Utánvét, Online fizetés <elore_fizetes>n</elore_fizetes> => Átutalás és Csekk fizetési módoknál, I vagy N attól függõen, hogy elõre fizetésrõl van-e szó, egyéb fizetési módok esetében a program az értéket figyelmen kívül hagyja <megjegyzes>valami megjegyzés</megjegyzes> => Megjegyzés <szla_nev>kék laguna búvárköypont</szla_nev> => Számlázási adatok <szla_orszag>hun</szla_orszag> => ISO3 országkód vagy angol megnevezés <szla_irsz>8000</szla_irsz> <szla_telepul>székesfehérvár</szla_telepul> <szla_utca>búvárok útja 222,</szla_utca> <szall_mod>mpl</szall_mod> => Szállítási mód. Csak az lehet, amit elõzõleg a rendszerbe felvettünk (Törzsek/Áruforgalom/Szállítási módok), illetve ha tartalmazza a "személyes átvétel" szóösszetételt, akkor "Személyes átvétel" lesz, ha a TOF vagy trans-o-flex szavakat, akkor "TOF", ha az MPL-t, akkor "MPL", ha pedig a pick vagy ppp szavak valamelyikét, akkor "Pick-Pack" <mpl_tipus></mpl_tipus> => Opcionális. MPL száll. mód esetén a kézbesítés tipusa. HA - házhoz szállítás. (Ez az alapértelmezett, azaz, ha az <mpl_tipus> </mpl_tipus> nem szerepel az XML-ben, a program ezzel dolgozik), PP - Postapontra szállítás, PM - Postán maradó küldemény, CS - Csomagautomata <atvpont></atvpont> => Opcionádlis mezõ. Átvételi ponttal rendelkező szállítási módok (Pick-Pack, MPL PP, MPL PM, MPL CS, Foxpost, GLS csomagpont, DPD csomagpont) esetében használatos, az átvételi pontot azonosítóját tartalmazza. Csak olyan átvételi pontokat fogad el a rendszer, amelyek szerepelnek a szállító cég adatbázisában (MPL: (http://httpmegosztas.posta.hu/partnerextra/out/postinfo_xx.xml, Pick-Pack: http://partner.pickpackpont.hu/stores/validboltlista.xml, Foxpost: https://api.foxpost.hu/ecomm/places, GLS: https://datarequester.gls-hungary.com/glsconnect/getdropoffpoints.php? ctrcode=hu&updated=20130912120000, DPD: https://weblabel.dpd.hu/dpd_wow/parcelshop_info.php). Átvételi pontra történő szállítás esetén az átvevõ címeként az átvételi pont címe és a számlázási cím is szerepelhet, ez utóbbi talán szerencsésebb, az a lényeg, hogy ne maradjon üresen. <szall_nev>kék laguna búvárköypont</szall_nev> => Szállítási adatok 15
<szall_orszag>hun</szall_orszag> => ISO3 országkód vagy angol megnevezés <szall_irsz>8000</szall_irsz> <szall_telepul>székesfehérvár</szall_telepul> <szall_utca>búvárok útja 222,</szall_utca> <nyelv>m</nyelv> => Nyelv, a nyelv_lekerd() fgv által visszaadott kódok valamelyike. <adoszam>11111111-1-11</adoszam> => A vevõ adószáma, ha rendelkezésre áll (opcionális mezõ) </fej> <tetelek> <tetel> <cikksz>bcmuela55m</cikksz> <netto_ar>34944</netto_ar> => A cikk egységára a <fej></fej> szekcióban megadott valutanemben <menny>2</menny> <tmegjegy>mindkét ruhát kérem külön-külön is csomagolják be.</tmegjegy> => A tételhez fûtött esetleges megjegyzés, megadása nem kötelezõ. <thumb>htp://www.akarmi.hu/termekkepek/bcmuela55.jpg</thumb> => A termék képének URL-je. Opcionális mezõ. </tetel> <tetel> <cikksz>beucarpro42</cikksz> <netto_ar>556640</netto_ar> <menny>2</menny> </tetel> </tetelek> </megrendeles> Elég beszédesek a visszaadott esetleges hibaüzenetek (Pl. URES:email, stb), úgyhogy ezt nem részletezem. Ha minden OK, a függvény egy XML-t ad vissza az átadott megrendelésben szereplő cikkek új raktárkészleteivel, ez visszafrissíthető a webre. <?xml version="1.0" encoding="utf-8"?> <keszletek> <cikk> <cikksz>bcmuela55m</cikksz> <menny>4</menny> </cikk> </keszletek> A rendszer alapértelmezésben csak olyan cikkszámokat fogad el, amelyek szerepelnek a cikktörzsben. Ellenkező esetben ISMERETLEN_CIKKSZAM:... hibaüzenetet ad vissza. Amennyiben az XML <tetelek> szekciójában a kötelezően megadandó <cikksz>, <netto_ar> és <menny> elemeken kívül a cikk egyéb, olyan adatait is megadjuk, ami lehetővé teszi a cikk törzsbe történő felvételét, a rendszer automatikusan felveszi azt a törzsbe, így az ISMERETLEN_CIKK hibaüzenet elkerülhető. Az ehhez szükséges adatok a következők: <tipus></tipus> T vagy S (T= term,ék, S = szolgáltatás) <meegys></meegys> Mennyiségi egység (db, nap, l, stb) <megnev></megnev> A cikk neve <afaszaz></afaszaz> ÁFA % 16
Figyelem! A fenti adatok csak abban az esetben vannak figyelembe véve, ha a cikk nem szerepel a törzsben. Már létező cikk esetében a törzsben lévő adatok NEM íródnak felül az itt megadottakkal. Megrendelések módosítása: $client->rend_modos(ügyfélkód,cégkód,xml); xml: A megrendelés adatai XML formátumban, ez szinte teljesen megegyezik a megrendelés átadásánál használatos XML-lel. A megrendelés a számlára vagy szállítólevélre kerülés pillanatáig módosítható maximum 9 alkalommal. Az XML specifikációja: <?xml version="1.0" encoding="utf-8"?> <megrendeles> <fej> <sorszam>webshop</sorszam> => a módosítani kívánt megrendelés Tharanis-os sorszáma (VXnn/nnnnn) <kuldo>webshop</kuldo> => a webáruház URL-je http://www. nélkül (pl. akarmi.hu) Csak az lehet, amit elõzõleg a rendszerbe felvettünk, mint webáruházat (Törzsek/Értékesítés/Webáruházak) <id>131253809014</id> => rendelésazonosító <beerk>2011.08.05 11:54</beerk> => beérkezés dátuma eeee.hh.nn oo:pp formában <atvdat>2011.08.10</atvdat> => a megrebdelõ által kért teljesítés dátuma <resztelj>i</resztelj> => kér-e részteljesítést (I/N) <email>valaki@valami.com</email> => a megrendelõ email címe. kötelezõ megadni, ez alapján van azonosítva a vevõ a partnertörzsben!!! <telefon></telefon> => megrendelõ telefonszáma <valuta>huf</valuta> => A megrendelés pénzneme (HUF, EUR, stb.) <afaval>hun</afaval> => Meghatározza, hogy a bruttó árak kiszámítása mely ország ÁFA kulcsa alapján történjen. Csak olyan ország kódja szerepelhet, amelyben a cég bejegyzett adószámmal rendelkezik és ez elõzõleg a programben regisztrálva lett. ÁFA nélküli rendelések esetén az érték 0. Élnek a régi értékek is 17
(I/N 1/0 yes/no). I/1/yes esetén a cég székhelye szerinti ÁFA kulcs van figyelembe véve. <fiz_mod>utánvét</fiz_mod> => A következõk lehetnek: Átutalás, Bankkártya, Csekk, Készpénz, Utánvét, Online fizetés <elore_fizetes>n</elore_fizetes> => Átutalás és Csekk fizetési módoknál, I vagy N attól függõen, hogy elõre fizetésrõl van-e szó, egyéb fizetési módok esetében a program az értéket figyelmen kívül hagyja <megjegyzes>valami megjegyzés</megjegyzes> => Megjegyzés <szla_nev>kék laguna búvárköypont</szla_nev> => Számlázási adatok <szla_orszag>hun</szla_orszag> => ISO3 országkód vagy angol megnevezés <szla_irsz>8000</szla_irsz> <szla_telepul>székesfehérvár</szla_telepul> <szla_utca>búvárok útja 222,</szla_utca> <szall_mod>mpl</szall_mod> => Szállítási mód. Csak az lehet, amit elõzõleg a rendszerbe felvettünk (Törzsek/Áruforgalom/Szállítási módok), illetve ha tartalmazza a "személyes átvétel" szóösszetételt, akkor "Személyes átvétel" lesz, ha a TOF vagy trans-o-flex szavakat, akkor "TOF", ha az MPL-t, akkor "MPL", ha pedig a pick vagy ppp szavak valamelyikét, akkor "Pick-Pack" <pickpack></pickpack> => Opcionális mezõ Pick-Pack Pont kiszállítás esetén, tartalma az átvételi pont azonosító#cím formában, pl: 102495#1024 II. Lövõház u. 1-5.-Mamut II. <mpl_tipus></mpl_tipus> => Opcionális. MPL száll. mód esetén a kézbesítés tipusa. HA - házhoz szállítás. (Ez az alapértelmezett, azaz, ha az <mpl_tipus> </mpl_tipus> nem szerepel az XML-ben, a program ezzel dolgozik), PP - Postapontra szállítás, PM - Postán maradó küldemény <mpl_atvpont></mpl_atvpont> => Opcionális PP és PM MPL száll. mód esetén ez tartalmazza az átvételi pont nevét, értelemszerûen PP esetén a postapontot, PM esetén a postát. Pl. <mpl_atvpont>12070 sz. MOL töltõállomás</mpl_atvpont> Csak olyan átvételi pontokat fogasok el, amelyek szerepelnek a posta adatbázisában. Átvételi pontra történõ szállítás esetén - ez vonatkozik a Pick-Pack Pontos szállításra is - az átvevõ címeként az átvételi pont címe és a számlázási cím is szerepelhet, ez utóbbi talán szerencsésebb, az a lényeg, hogy ne maradjon üresen. <szall_nev>kék laguna búvárköypont</szall_nev> => Szállítási adatok <szall_orszag>hun</szall_orszag> => ISO3 országkód vagy angol megnevezés <szall_irsz>8000</szall_irsz> <szall_telepul>székesfehérvár</szall_telepul> <szall_utca>búvárok útja 222,</szall_utca> <nyelv>m</nyelv> => Nyelv, a nyelv_lekerd() fgv által visszaadott kódok valamelyike. <adoszam>11111111-1-11</adoszam> => A vevõ adószáma, ha rendelkezésre áll (opcionális mezõ) </fej> <tetelek> <tetel> <cikksz>bcmuela55m</cikksz> <netto_ar>34944</netto_ar> => A cikk egységára a <fej></fej> szekcióban megadott valutanemben <menny>2</menny> <tmegjegy>mindkét ruhát kérem külön-külön is csomagolják be.</tmegjegy> => A tételhez fûtött esetleges megjegyzés, megadása nem kötelezõ. <thumb>htp://www.akarmi.hu/termekkepek/bcmuela55.jpg</thumb> => A termék képének URL-je. Opcionális mezõ. </tetel> <tetel> 18
<cikksz>beucarpro42</cikksz> <netto_ar>556640</netto_ar> <menny>2</menny> OK:sorsz 疥 </tetel> </tetelek> </megrendeles> Elég beszédesek a visszaadott esetleges hibaüzenetek (Pl. URES:email, NEM_MODOSITHATO_MEGRENDELES, stb), úgyhogy ezt nem részletezem. Ha minden OK, a függvény egy értéket ad vissza, ahol a sorszám a módosított megrendelés száma, ami az eredeti megrendelés /1, /2, stb, a módosítások számától függően. Megrendelések törlése: $client->rend_torol(ügyfélkód,cégkód,sorszam,ok); sorszam: A törlendő megrendelés Tharanis-os sorszáma ok: A törlés oka. Csak azok lehetnek, amelyek előzőleg a rendszer törzsadatihoz rögzítésre kerültek. A visszaadott értékek itt is beszédesek, ha a törlés sikeres volt, a visszaadott érték OK. Mrendelés adatainak lekérdezése: $client->lekerd_1rend(ügyfélkód,cégkód,jelszó,sorszam,netes megrendelés azonosító); jelszó: Egyelőre egy üres string ("") sorszam: A megrendelés Tharanis-os sorszáma, ha nem ismerjük, üres ("") netes megrendelés azonosító: A megrendelés internetes azonosítója, amellyel a rendelés át lett adva,, ha nem ismerjük, vagy nincs, akkor üres (""). Figyelem! Az azonosító elé be kell rakni azt a webáruházat azonosító betűjelet, amelyet a törzsben a webáruházhoz beállítottunk (Pl. WS12345) A program először a sorszám alapján próbálja meg azonosítani a rendelést. Ha ez 19
nem sikerül,l akkor nézi a netes megrendelés azonosítót.. Visszaadott értékek: ISMERETLEN_MEGRENDELES: Ismeretlen vagy törölt megrendelés TOBB_MERENDELES: sorszam1,sorszam2,... Abban az esetben jön, ha az internetes azonosító alapján több rendelést is talált. PUFFERBEN_LEVO_MEGRENDELES: A megrendelés még nem került feldolgozásra. Ha minden OK, az adarokat egy XML-ben adja vissza a program. Cikkek átadása: $client->cikk_berak(ügyfélkód,cégkód,jelszó,xml); xml: A cikk adatai XML formátumban Az XML specifikációja: <?xml version="1.0" encoding="utf-8"?> <cikkadat> <cikksz></cikksz> => Cikkszám. Csak az angol ABC betáit és számokat, valamint.- _ karakereket vtartalmazhat. Megadása kötelezõ. <ean></ean> => A cikk EAN kódja. <megnev></megnev> =>A cikk neve. Megadása nem kötelezõ <meegys></meegys> => Mennyiségi egység (db, l, kg, stb.) Megadása nem kötelezõ. <tipus></tipus> => T = Termék, S = Szolgáltatás. Megadása kötelezõ, csak ezt a 2 értéket veheti fel. <afaszaz></afaszaz> => ÁFA %. Megadása nem kötelezõ. <netto_ar1></netto_ar1> => Eladási ár 1. A termék nettó eladási ára. <netto_ar2></netto_ar2> => Eladási ár 1. A termék nettó eladási ára. </cikkadat> Elég beszédesek a visszaadott esetleges hibaüzenetek (Pl. URES:cikkszam, stb), úgyhogy ezt nem részletezem. Ha minden OK, a függvény INSERT_OK, vagy UPDATE_OK stringet ad vissza attól függően, hogy a cikk törzsbe újként került felvételre (INSERT_OK) vagy egy már benne volt, és adatai módosultak (UPDATE_OK). 1. melléklet - Frissítési idők A Tharanis szervere a Pick-Pack, MPL és FoxPost, GLS és DPD átváteli pontokat a következők szerint frissíti: Pick-Pack: minden óra 0 perckor (http://partner.pickpackpont.hu/stores/validboltlista.xml) MPL: naponta egyszer 3 óra 0 perckor 20
(http://httpmegosztas.posta.hu/partnerextra/out/postinfo_pp.xml, http://httpmegosztas.posta.hu/partnerextra/out/postinfo_pm.xml, http://httpmegosztas.posta.hu/partnerextra/out/postinfo_cs.xml FoxPost: naponta egyszer 3 óra 10 perckor https://api.foxpost.hu/ecomm/places GLS: naponta egyszer 3 óra 12 perckor https://datarequester.glshungary.com/glsconnect/getdropoffpoints.php?ctrcode=hu&updated= 20130912120000 DPD: naponta egyszer 3 óra 14 perckor https://weblabel.dpd.hu/dpd_wow/parcelshop_info.php 2. melléklet - Verzió változások 2.0-2015.11.21: lekerd_cikk() Paraméter lista változás:(ügyfélkód,cégkód,jelszó[,shop[,cikkszám[,árak [,valuta,[,utolsó módosítás[,nyelv]]]]]]) Output XML változása: Az <ar></ar>, <akcios_ar></akcios_ar> XML tag-ek <ar1></ar1>, <akcios_ar1></akcios_ar1>, <ar2></ar2>, <akcios_ar2> </akcios_ar2>... változott. lekerd_arak() Plusz paramétr: shop, utolso modositas Paraméter változás árak, valuta. (Több ár és valutanem is megadható,-vel elválasztva) lekerd_arkesz() Plusz paramétr: shop, utolso modositas, raktar, keszlet tipus Paraméter változás árak, valuta. (Több ár és valutanem is megadható,-vel elválasztva) lekerd_keszlet() Plusz paramétr: shop, utolso modositas, raktar, keszlet tipus lekerd_beszido() Plusz paramétr: shop, utolso modositas 2.2-2016.01.31: GLS és DPD csomagpontok 21