Tharanis API 1.13
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: Hívás (PHP): $client->lekerd_nyelv(ügyfélkód,cégkód,jelszó); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez jelszó: Egyelőre egy üres string ("")
Output XML:
M Magyar A Angol
Cikkek lekérdezése webáruházas megjelenítéshez: Hívás (PHP): $client>lekerd_cikk(ügyfélkód,cégkód,jelszó[,webáruház[,cikkszám[,ár[,ut olsó módosítás[,nyelv]]]]]); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez jelszó: Egyelőre egy üres string ("") webáruház: Opcionális, megadása esetén az XML-ben csak azon cikkek fognak megjelenni, amelyekhez beálltottuk hogy ezen werbáruházban megjelenjenek. Megadása esetén az összes cikk megjelenítéséhez az értékez hagyjuk üresen ("") cikkszám: Opcionális, megadása esetén csak ezen cikk adatai jelennek meg. Megadása esetén az összes cikk megjelenítéséhez az értékez hagyjuk üresen (""). ár: Értéke 1, 2 vagy 3 lehet attól függően, hogy a törzsbe beállított 1-es, 2-es vagy 3-as árat akarjuk látni. Hiánya esetén az XML-ben az 1-es ár fog szerepelni. utolsó módosítás: (éééé.hh.nn) Opcionális, megadása esetén csak a megadott időpontnál nem régebben 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:
=> Cikkszám <ean> => Vonalkód <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.) I => Aktív I/N T => T=termék, S=Szolgáltatás => mely kategóriákban jelenjen meg => Kategória kódja => Kategória kódja => Gyártó kódja => Garanciaidő <M> <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) <M> ... megnevezés további nyelveken (Ez a későbbiekben mindegyik
hasonló elemre igaz) <meegys> => A cikk mennyiségi egysége <M> <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) <M> <egys_ar_szorzo>0 => Egségenkénti ár a fenti példa alapján 5 => Tulajdonságok különböző nyelveken. A tulajdonság és az érték ::-tal van elválasztva <M> <M> ... további tulajdonságok <megjnev> => A cikk webshopban megjelenítendő neve különböző nyelveken <M> => Leírás különböző nyelveken, HTML-ben <M> => A megjeleníteni kívént URL különböző nyelveken <M> <meta_title> => A megjeleníteni kívánt title különböző nyelveken <M> <meta_description> => A meta description különböző nyelveken <M> <meta_keywords> => A meta keywords különböző nyelveken <M> => ÁFA % azon országpk szerint, ahol a cég bejegyzett adószámmal rendelkezik. <SVK> <ar> => A cikk ára különböző valutákban.
<EUR> ... ár további pénznemekben => A cikk akciós ára különböző valutákban. (Ha nincs akció, akkor megegyezik az <ar> taggal) <EUR> ... akciós ár további pénznemekben => Raktárkészletek a különböző raktárakban, egyelőre csak van. => Központi raktár ksézlete <szallido> => Szállítási idő, ha a termék nincs raktáron <M> > => Az esetleges változatok megnevezése (Pl. Szín) <M> => Megjelenítés ezen változatként (Pl. piros) <M> => A termékhez kapcsolódó választható kiegészítők, opciók vagy egyéb dolgok (Lásd példa) <megnev> => Az opció megnevezése <M> <elemek> => A választható elemek <elem> => Megjelenő név <M> => Felár, ha van. Ha nincs, az egész tag hiányzik <EUR> .. további elemek .. további opciók => Kapcsolódó cikkek cikkszámai .. további cikkek => Képek URL-jei .. további képek, mindig az első a "listakép"
Példa: (Hátizsák külömböző színekben választható extra esővédővel)
DACL141 <szulocikk> <ean> I 148 248 <M> <minimum> <megnevezes> <M> <meegys> <M> <egys_ar_me> <M> <egys_ar_szorzo>0 <M> <M> <M> <M> <M>
<M> <M> <megjnev> <M> <M>deuter-ac-lite-14 deuter-ac-lite-14 <meta_title> <M> <meta_description> <M> <meta_keywords> <M> <M>]]> 27 <ar> 14165.35 <EUR>39.29 14165.35 <EUR>39.29 <megnev> <M>
<elemek> <elem> <M> <elem> <M> 729.93 <EUR>2.14 DACL221 <M> <M> T 0 <szallido> <M> >
Termékkategóriák (cikkcsoportok) lekérdezése:
Hívás (PHP): $client>lekerd_kateg(ügyfélkód,cégkód,jelszó[,webáruház[,nyelv]]); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez 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:
=> Azonosító, nálam mindig numerikus <szulo> => A szülõ azonosítója <szint> => A kategória szintje (0 = gyökér) <megnev> => Megnevezés különbözõ nyelveken <M> ... megnevezés további nyelveken => A ketagóriához tartozó kép URL-je => A kategória leírása különbözõ nyelveken (HTML) <M> => A megjeleníteni kívént URL különbözõ nyelveken <M> <meta_title> => A megjeleníteni kívént title különbözõ nyelveken <M> <meta_description> => A meta description különbözõ nyelveken <M> <meta_keywords> => A meta keywords különbözõ nyelveken <M>
Gyártók lekérdezése: Hívás (PHP): $client>lekerd_gyarto(ügyfélkód,cégkód,jelszó[,webáruház[,nyelv]]); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez 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: => ID <megnev> => Megnevezés különbözõ nyelveken <M> ... megnevezés további nyelveken => A gyártóhoz tartozó kép URL-je => A gyártó leírása különbözõ nyelveken (HTML) <M> ... leírás további nyelveken => A megjeleníteni kívént URL különbözõ nyelveken <M> ... <meta_title> => A megjeleníteni kívént title különböző nyelveken <M> ... <meta_description> => A meta description különböző nyelveken <M>
... <meta_keywords> => A meta keywords különböző nyelveken <M> ... 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.) Hívás (PHP): $client->lekerd_ford(ügyfélkód,cégkód,jelszó[,nyelv]); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez 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> <M> => Magyar => fordítás ... további fordítások Raktárkészlet lekérdezése XML formátumban: (A függvény kiadható készletet adja vissza.) Hívás (PHP): $client->lekerd_keszlet(ügyfélkód,cégkód,jelszó[,cikkszam,shop]); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez 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 program a 0 vagy negatív készletű cikkeket is kilistázza. shop: A lekérdező webshop neve. Amennyiben meg van adva, a program, azon raktár készletét adja vissza, amely a rendszerben a webshophoz be lett állítva. Elhagyása
vagy a rendszerben nem létező shop esetén a program a „Központi raktár” készletét fogja alapul venni. Output XML: CS2 <menny>2
Árak lekérdezése XML formátumban: (A függvény nettó árakat ad vissza) Hívás (PHP): $client->lekerd_arak(ügyfélkód,cégkód,jelszó,árak,valuta); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez 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. Output XML: <arak> 1254 <ar1> 1000 <EUR>0 <ar2> 0 <EUR>0 920 <EUR>0 0 <EUR>0
Árak és készletek együttes lekérdezése XML formátumban: (A függvény kiadható készletet, valamint nettó árakat ad vissza. A listában minden cikk szerepel.) Hívás (PHP): $client>lekerd_arkesz(ügyfélkód,cégkód,jelszó,árak,valuta[,cikkszám,shop ]); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez 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. shop: A lekérdező webshop neve. Amennyiben meg van adva, a program, azon raktár készletét adja vissza, amely a rendszerben a webshophoz be lett állítva. Elhagyása vagy a rendszerben nem létező shop esetén a program a „Központi raktár” készletét fogja alapul venni.
Output XML: <arak> 1254 <menny>1 <ar1> 1000 <EUR>0 <ar2> 0 <EUR>0 920 <EUR>0 0 <EUR>0
Beszállítási idők lekérdezése XML formátumban: Hívás (PHP): $client->lekerd_beszido(ügyfélkód,cégkód,jelszó[,cikkszám]); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez jelszó: Egyelőre egy üres string ("") cikkszám: Opcionális, megadása esetén csak az adott cikk listázódik ki.
Output XML: 1254 0
Megrendelések átadása: Hívás (PHP): $client->rend_berak(ügyfélkód,cégkód,xml); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez xml: A megrendelés adatai XML formátumban Az XML specifikációja: <megrendeles> webshop => 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) 131253809014 => rendelésazonosító 2011.08.05 11:54 => beérkezés dátuma eeee.hh.nn oo:pp formában 2011.08.10 => a megrebdelõ által kért teljesítés dátuma I => kér-e részteljesítést (I/N) <email>[email protected] => a megrendelõ email címe. kötelezõ megadni, ez alapján van azonosítva a vevõ a partnertörzsben!!! => megrendelő telefonszáma HUF => A megrendelés pénzneme (HUF, EUR, stb.) HUN => 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. Utánvét => A következők lehetnek: Átutalás, Bankkártya, Csekk, Készpénz, Utánvét, Online fizetés <elore_fizetes>N => Á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 => Megjegyzés <szla_nev>Kék laguna búvárköypont => Számlázási adatok <szla_orszag>HUN => ISO3 országkód vagy angol megnevezés <szla_irsz>8000 <szla_telepul>Székesfehérvár <szla_utca>Búvárok útja 222, <szall_mod>MPL => 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" => 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> => 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> nem szerepel az XML-ben, a program ezzel dolgozik), PP - Postapontra szállítás, PM - Postán maradó küldemény, CS - Csomagautomata <mpl_atvpont> => Opcionális PP, PM és CS 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, CS esetén a csomagautomatát. Pl. <mpl_atvpont>12070 sz. MOL töltőállomás Csak olyan átvételi pontokat fogadok el, amelyek szerepelnek a posta adatbázisában (http://posta.hu/partnerextra). Á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 => Szállítási adatok <szall_orszag>HUN => ISO3 országkód vagy angol megnevezés <szall_irsz>8000 <szall_telepul>Székesfehérvár <szall_utca>Búvárok útja 222, M => Nyelv, a nyelv_lekerd() fgv által visszaadott kódok valamelyike. 11111111-1-11 => A vevő adószáma, ha rendelkezésre áll (opcionális mező) BCMUELA55M 34944 => A cikk egységára a szekcióban megadott valutanemben
<menny>2 Mindkét ruhát kérem külön-külön is csomagolják be. => A tételhez fûtött esetleges megjegyzés, megadása nem kötelezõ. htp://www.akarmi.hu/termekkepek/bcmuela55.jpg => A termék képének URL-je. Opcionális mezõ. BEUCARPRO42 556640 <menny>2 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. BCMUELA55M <menny>4
Megrendelések módosítása: Hívás (PHP): $client->rend_modos(ügyfélkód,cégkód,xml); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez 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: <megrendeles> <sorszam>webshop => a módosítani kívánt megrendelés Tharanis-os sorszáma (VXnn/nnnnn) webshop => 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) 131253809014 => rendelésazonosító 2011.08.05 11:54 => beérkezés dátuma eeee.hh.nn oo:pp formában 2011.08.10 => a megrebdelõ által kért teljesítés dátuma I => kér-e részteljesítést (I/N) <email>[email protected] => a megrendelõ email címe. kötelezõ megadni, ez alapján van azonosítva a vevõ a partnertörzsben!!! => megrendelő telefonszáma HUF => A megrendelés pénzneme (HUF, EUR, stb.) HUN => 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. Utánvét => A következők lehetnek: Átutalás, Bankkártya, Csekk, Készpénz, Utánvét, Online fizetés <elore_fizetes>N => Á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 => Megjegyzés <szla_nev>Kék laguna búvárköypont => Számlázási adatok <szla_orszag>HUN => ISO3 országkód vagy angol megnevezés <szla_irsz>8000 <szla_telepul>Székesfehérvár <szla_utca>Búvárok útja 222, <szall_mod>MPL => 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" => 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> => 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> nem szerepel az XML-ben, a program ezzel dolgozik), PP - Postapontra szállítás, PM - Postán maradó küldemény <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 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 => Szállítási adatok <szall_orszag>HUN => ISO3 országkód vagy angol megnevezés <szall_irsz>8000 <szall_telepul>Székesfehérvár <szall_utca>Búvárok útja 222, M => Nyelv, a nyelv_lekerd() fgv által visszaadott kódok valamelyike. 11111111-1-11 => A vevő adószáma, ha rendelkezésre áll (opcionális mező) BCMUELA55M 34944 => A cikk egységára a szekcióban megadott valutanemben <menny>2 Mindkét ruhát kérem külön-külön is csomagolják be. => A tételhez fûtött esetleges megjegyzés, megadása nem kötelezõ. htp://www.akarmi.hu/termekkepek/bcmuela55.jpg => A termék képének URL-je. Opcionális mezõ. BEUCARPRO42 556640 <menny>2 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 OK:sorsz é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: Hívás (PHP):
$client->rend_torol(ügyfélkód,cégkód,sorszam,ok); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez 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: Hívás (PHP): $client->lekerd_1rend(ügyfélkód,cégkód,jelszó,sorszam,netes megrendelés azonosító); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez 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 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: Hívás (PHP): $client->cikk_berak(ügyfélkód,cégkód,jelszó,xml); ügyfélkód: Tharanis ügyfélkód cégkód: "ab" = éles cég, "aa" = _Gyakorló a fejlesztésekhez xml: A cikk adatai XML formátumban
Az XML specifikációja:
=> Cikkszám. Csak az angol ABC betáit és számokat, valamint .-_ karakereket vtartalmazhat. Megadása kötelezõ. <ean> => A cikk EAN kódja. <megnev> =>A cikk neve. Megadása nem kötelezõ <meegys> => Mennyiségi egység (db, l, kg, stb.) Megadása nem kötelezõ. => T = Termék, S = Szolgáltatás. Megadása kötelezõ, csak ezt a 2 értéket veheti fel. => ÁFA %. Megadása nem kötelezõ. => Eladási ár 1. A termék nettó eladási ára. => Eladási ár 1. A termék nettó eladási ára. 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).