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: 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):
1
$client->lekerd_cikk(ügyfélkód,cégkód,jelszó[,shop[,cikkszám[,árak[,valuta,[,utolsó 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 ("") 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:
=> 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>
2
<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> <ar1> => 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>
3
> => 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
4
<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>
5
<meta_keywords> <M> <M>]]> 27 <ar1> 14165.35 <EUR>39.29 14165.35 <EUR>39.29 <ar2> 14165.35 <EUR>39.29 12345.3552 <EUR>29.29 <megnev> <M> <elemek> <elem> <M> <elem> <M> 729.93 <EUR>2.14
6
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> 7
... 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 8
=> 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 9
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[,raktar idr[,keszlet tipus[,utolso modositas]]]]]); ü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 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 CS2 <menny>2 10
analitikus készletformátum esetén CS2 <menny[raktár id]>2 pl. <menny1>2 <menny[raktár id]>1
Á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[,cikkszam[,shop[,utolso modositas]]); ü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 (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> 1254 27 <ar1> 1000 <EUR>0 11
<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.) Hívás (PHP): $client->lekerd_arkesz(ügyfélkód,cégkód,jelszó,árak,valuta[,cikkszám[,shop[,raktar idr[,keszlet tipus[,utolso modositas]]]]]); ü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. 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> 1254 27 <ar1> 1000 <EUR>0 <ar2> 0 <EUR>0 920 <EUR>0 0 <EUR>0 <menny>1
Analitikus készlet: <arak> 1254 27 <ar1> 1000 <EUR>0 <ar2> 0 <EUR>0 920 <EUR>0 0 <EUR>0 13
<menny1>1 <menny2>1
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[,shop[,utolso modositas]]]); ü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 (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: 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> 14
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" <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 => 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 => Szállítási adatok 15
<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
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 szekciójában a kötelezően megadandó , é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: → T vagy S (T= term,ék, S = szolgáltatás) <meegys> → Mennyiségi egység (db, nap, l, stb) <megnev> → A cikk neve → Á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: 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 17
(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. 15.-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õ. 18
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 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: 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).
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>, XML tag-ek <ar1>, , <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
