TeszVesz webAPI

Színezd át a TeszVeszt!

Tedd egyedivé az oldalt! eredeti

Bezár

Alapinformációk

Hasznos tájékoztatók

Biztonsági tudnivalók

TeszVesz API

Információk

A webáruházak számára fejlesztett alkalmazás megkönnyíti a termékek a teszvesz.hu oldalra történő tömeges feltöltését,
és az oldalon - webáruházaddal összhangban - az árukészlet, a termékárak és egyéb termékinformációk naprakészen tartását.

Az alkalmazás segítségével a TeszVesz oldalán keresztül beérkező megrendelések automatikusan le is tölthetők.
A webáruház és a teszvesz közötti szinkronizációt a dokumentációban bemutatott soap kapcsolat biztosítja

A TeszVesz webAPI elérhetősége

A TeszVesz webapi a http://soap.teszvesz.hu oldalon érhető el.
Php kliens esetén a wsdl itt található: http://soap.teszvesz.hu/?wsdl

Soap verzió

A szerver a PEAR modulos SOAP szervert használja, így javasolt ennek használata kliens oldalon php kliens esetén, de bármely nusoap kliens megteszi.

PHP-s megvalósítás:

soap objektum létrehozása

require 'lib/SOAP/Client.php';
$soapclient = new SOAP_Client('http://soap.teszvesz.hu/');

segédváltozók definiálása

$options = array(
		'namespace' => 'urn:SOAP_Vatera_Server',
		'trace' => 1
		);

függvényparaméterek beállítása

$params = array(
		'userbase_login' => 'username',
		'userbase_password' => md5('password')
		);

távoli függvény meghívása (pl)

$ret = $soapclient->call('dologin',$params,$options);

Ezt követően a válasz feldolgozása kliens oldalon történik.

Dokumentáció

Szerveren hívható függvények és paramétereik

Termékfeltöltéshez kapcsolódó függvények

Kategórialista letöltése

Hívandó függvény neve: getcategories

Bemenő paraméterek:

'in' => array(
		'ifmodifiedsince' => 'Int'
		),

Bemenő paraméter értéke:
ifmodifiedsince: a legutóbbi letöltés timestampje - amennyiben mindenképp le akarjuk tölteni az aktuális litát, akkor 1

Visszatérő paraméterek:

'out' => array(
		'returncode' => 'Int',
		'returntext' => 'string',
		'data' => 'Array',
		'lastmodification'=>'Int'
		),

Visszatérési értékek:
returncode: sikeres művelet esetén 1, egyébként numerikus hibakód
returntext: a művelet sikeressége szövegesen

data: a kategórisatruktúra a következő formában:

array(
	14 =>
		stdClass::__set_state(array(
		'category_id' => '362',
		'category_parent_id' => '0',
		'category_description' => 'Antik, műtárgy, régiség',
		)),
		
)

lastmodification: a kategória cache file utolsó legenerálásának timestampje

Kategóriaspecifikus tulajdonságok letöltése

Hívandó függvény neve: getcatspecproperties

Bemenő paraméterek:

'in' => array(
		'ifmodifiedsince' => 'Int'
		),

Bemenő paraméter értéke:
ifmodifiedsince: a legutóbbi letöltés timestampje - amennyiben mindenképp le akarjuk tölteni az aktuális litát, akkor 1

Visszatérő paraméterek:

'out' => array(
		'returncode' => 'Int',
		'returntext' => 'string',
		'data' => 'Array',
		'lastmodification'=>'Int'
		),

Visszatérési értékek:
returncode: sikeres művelet esetén 1, egyébként numerikus hibakód
returntext: a művelet sikeressége szövegesen
data: a kategórispecifikus tulajdonságok a lehetséges választási lehetőségekkel, fontos: amennyiben a csp_feature értéke 1, kötelező a tulajdonság!
lastmodification: time()

Országlista letöltése

Hívandó függvény neve: getcountries

Bemenő paraméterek:

'in' => array(
		'ifmodifiedsince' => 'Int'
		),

Bemenő paraméter értéke:
ifmodifiedsince: a legutóbbi letöltés timestampje - amennyiben mindenképp le akarjuk tölteni az aktuális litát, akkor 1

Visszatérő paraméterek:

'out' => array(
		'returncode' => 'Int',
		'returntext' => 'string',
		'data' => 'Array',
		'lastmodification'=>'Int'
		),

Visszatérési értékek:
returncode: sikeres művelet esetén 1, egyébként numerikus hibakód
returntext: a művelet sikeressége szövegesen
data: országlista id és név (feltöltéskor az id használandó!)
lastmodification: az ország cache file utolsó legenerálásának timestampje

Régiólista letöltése

Hívandó függvény neve: getregions

Bemenő paraméterek:

'in' => array(
		'ifmodifiedsince' => 'Int'
		),

Bemenő paraméter értéke:
ifmodifiedsince: a legutóbbi letöltés timestampje - amennyiben mindenképp le akarjuk tölteni az aktuális litát, akkor 1

Visszatérő paraméterek:

'out' => array(
		'returncode' => 'Int',
		'returntext' => 'string',
		'data' => 'Array',
		'lastmodification'=>'Int'
		),

Visszatérési értékek:
returncode: sikeres művelet esetén 1, egyébként numerikus hibakód
returntext: a művelet sikeressége szövegesen
data: megyelista id és név (feltöltéskor az id használandó!)
lastmodification: az ország cache file utolsó legenerálásának timestampje

Fizetési/szállítási sablonok letöltése

Hívandó függvény neve: getdeliverytemplates

Bemenő paraméterek:

'in' => array(
		'userbase_login' => 'string',
		'userbase_password' => 'string',
		),

Bemenő paraméter értéke:
userbase_login: felhasználónév
userbase_password: jelszó md5 -ölve

Visszatérő paraméterek:

'out' => array(
		'returncode' => 'Int',
		'results' => 'template[]', (array of $template_type)
		),


$template_type=array(
		'delivery_template_id'=>'Int',
		'delivery_template_description'=>'string',
		'list'=>'delivery[]', (array of $delivery_type)
		'delivery_template_name'=>'string',
		);

$delivery_type=array(
		'id'=>'Int',
		'delivery_type'=>'Int',
		'type_name'=>'string',
		'default_price'=>'Int',
		'quantityreduced_rate'=>'Int',
		'quantityreduced_limit'=>'int',
		'quantityreduced_price'=>'Int',
		'pricereduced_rate'=>'Int',
		'pricereduced_limit'=>'Int',
		'pricereduced_price'=>'Int',
		);

Visszatérési értékek:
returncode: sikeres művelet esetén 1, egyébként numerikus hibakód
results: Asszociatív tömb a fenti kinézettel. Az egyetlen használatos paraméter feltöltéskor a szükséges delivery_template_id. Létrehozni nem lehet soap híváson keresztül szállítási és fizetési sablont, az a személyes menü adott alpontjában lehetséges. (itt a legördülő menü forrásából is ki lehet deríteni a szállítási sablon id-jét, így nem kell soap hívást irni hozzá.)

Termékfeltöltés

Hívandó függvény neve: doupload

Bemenő paraméterek:

'in' => array(
		'userbase_login' => 'string',
		'userbase_password' => 'string',
		'product'=>'vateraproduct[]',
		),

Bemenő paraméter értéke:

userbase_login: felhasználónév
userbase_password:	elszó md5 -ölve
product: termékadatok, a következőképpen:
$vateraproduct=array(
	'product_id'=>'Int', feltöltéskor nem használatos, akármi jöhet itt
	'product_title'=>'string', termék megnevezés
	'product_subtitle'=>'string', alcím (fizetős!)
	'product_description'=>'string', termékleírás
	'product_quantity'=>'Int', mennyiség
	'product_start_price'=>'Int', kikiáltási ár (kötelező, nem lehet 0)
	'product_min_price'=>'Int', minimál ár (ha nincs minimál ár, a kikiáltási árral megeyező érték írandó ide)
	'product_fix_price'=>'Int', fix / villámár (nem kötelező)
	'product_bid_increment'=>'Int', licitlépcső (0: automatikus, egyéb esetben a megadott érték)
	'product_start_date'=>'string', 0 vagy az indítási időpont timestampje
	'duration'=>'Int', aukció időtartama (értékek: 1..11, 14, 21)
	'product_category_id'=>'Int', kategória kód
	'product_region_id'=>'Int', régió kód
	'product_country_id'=>'Int', országkód
	'product_delivery_template_id'=>'Int', szállítási/ fizetési sablon kód
	'product_remaining_relist'=>'Int', automatikus ujraindítások száma (0..3,999)
	'product_feature'=>'Int', kiemelések, lehetséges értékek: (alábbiak tetszőleges összege)
		524288 => "Félkövér",
		1048576 => "Listázások elejére",
		2097152 => "Bekeretezés",
		4194304 => "Színes háttér",
		8388608 => "5 perces hosszabbítás",
		16777216 => "Terméklink a nyitólapon",
		33554432 => "Alcím a listázóban/terméklapon",
		32768 => "Zárt aukció! (Díjmentes)",
		262144 => "Az én ajánlatom (Díjmentes)",
		
	'product_flag'=>'Int', termékjellemzők, lehetséges értékek: (alábbiak tetszőleges összege)
		2 => Minimálár látható,
		4 => szállítási költség az eladót terheli,
		8 => száll. költség a vevőt terheli (vagy egyik vagy másik!),
		16 => a termék új,
		128 => az eladó ad számlát a termékről,
		256 => ha van "én ajánlatom", akkor annak elfogadása automatikus
		512 => vaterára legyen feltöltve
		1024 => teszveszre legyen feltöltve
	'product_warranty' => 'Int', garanciakód lehetséges értékek:
		1 => 'Nincsen',
		3 => '1 hét',
		4 => '1 hónap',
		5 => '3 hónap',
		6 => '6 hónap',
		7 => '1 év',
		8 => '2 év',
		9 => 'Több mint 2 év',
		10 => 'Élettartam garancia',
	'product_bestofferminpercent'=>'Int', fix áras termék esetén "az én ajánlatom funkció" - hány % tól fogadok el ajánlatokat
	'product_image' => 'vateraimage[]', array of $vateraimage_type
		$vateraimage_type=array(
			'picid'=>'Int', (1..4)
			'pic'=>'base64', (a kép base64 encodeolva)
			'picurl'=>'string', (feltöltéskor semmi)
		);
	'product_csp'=>'vateraproductcsp[]', array of $vateraproductcsp_type
		$vateraproductcsp_type=array(
			'csp_id'=>'Int',
			'csp_value'=>'string'
		);
	'product_item_template_id' => 'Int', kinézeti sablon azonosító
	'product_note' => 'string', egyedi kliensoldali azonosító (ezt visszakapja letöltés esetén)
);

Visszatérő paraméterek:

'out' => array(
		'returncode' => 'Int',
		'returntext' => 'string',
		'result' => 'Array',
		),

Visszatérési értékek:
returncode: sikeres művelet esetén 1, egyébként numerikus hibakód (csak a kommunikációra vonatkozik, az eredménytelen feltöltés esetén is 1 lehet)
returntext: Az eredmény szövegesen (szintén csak a kommunikációra vonatkozik)
result: Az eredmény kifejtve
'product_id' => '169226070', - a feltöltött termék kódja a Vaterán
'tmpid' => '355', - a feltöltéskor megadott product_id
'returncode' => 8, - eredménykód (sikertelenség esetén: 7)
'returntext' => 'Sikeres feltöltés', - szöveges eredmény

Termékadatmódosítás

Termékármódosítás

Figyelem! Csak a fixáras, és licitmentes aukciók módosíthatók!

Hívandó függvény neve: repriceauction

Bemenő paraméterek:

'in' => array(
	'userbase_login' => 'string',
	'userbase_password' => 'string',
	'product_id' => 'Int',
	'new_price' => 'Int',
),

Bemenő paraméter értéke:

userbase_login: felhasználónév userbase_password: jelszó md5 -ölve product_id: termékkód new_price: új ár

Visszatérő paraméterek:

'out' => array(
		'returncode' => 'Int',
		'returntext' => 'string',
		),

Visszatérési értékek:
returncode: sikeres művelet esetén 1, egyébként numerikus hibakód returntext: Szöveges eredmény

Termékmennyiség módosítás

Figyelem! Csak a fixáras, és licitmentes aukciók módosíthatók!

Hívandó függvény neve: changequantity

Bemenő paraméterek:

'in' => array(
	'userbase_login' => 'string',
	'userbase_password' => 'string',
	'product_id' => 'Int',
	'new_quantity' => 'Int',
),

Bemenő paraméter értéke:

userbase_login: felhasználónév
userbase_password: jelszó md5 -ölve
product_id: ermékkód
new_quantity: új mennyiség

Visszatérő paraméterek:

'out' => array(
	'returncode' => 'Int',
	'returntext' => 'string',
),

Visszatérési értékek:
returncode: sikeres művelet esetén 1, egyébként numerikus hibakód returntext: Szöveges eredmény

Terméklejáratás

Figyelem! Licitmentes aukciók járathatók le!

Hívandó függvény neve: delproduct

Bemenő paraméterek:

'in' => array(
		'userbase_login' => 'string',
		'userbase_password' => 'string',
		'products'=>'Array',
		),

Bemenő paraméter értéke:
userbase_login: felhasználónév
userbase_password: jelszó md5 -ölve
products: ermékkódok listája tömbként

Visszatérő paraméterek:

'out' => array(
		'results' => 'Array',
		),

Visszatérési értékek:
results: A művelet eredménye - termékkódonként a feltöltés sikeressége

Letöltés

Termékletöltés

Hívandó függvény neve: dodownload

Bemenő paraméterek:

'in' => array(
		'userbase_login' => 'string',
		'userbase_password' => 'string',
		'downloadtype' => 'Int',
		'product_id' => 'Int',
		'fromdate' => 'string',
		'tildate' => 'string',
		),

Bemenő paraméter értéke:

userbase_login: felhasználónév
userbase_password: jelszó md5 -ölve
downloadtype: Mi legyen letöltve? A következő értékek bármely tetszőleges összege:
2 - Eladó termékek
4 - Licitált termékek
8 - Eladott termékek
16 - Lejárt termékek

product_id: az a vaterás termékkód, mely után következő első terméket szeretnénk letölteni
fromdate: letöltés kezdetének timestampje
tildate: letöltés végének timestampje

Visszatérő paraméterek:

'out' => array(
		'returncode' => 'Int',
		'returntext' => 'string',
		'result' => 'Array',
		'product'=> 'vateraproduct[]',
		),

Visszatérési értékek:

result: A művelet eredménye következő termékkód, és sikerességi kód - az első letöltéskor amennyiben 1 a product_id bemenő paraméter, itt kapható vissza az eredményhalmaz mérete (hány db termék van a keresési feltételeknek megfelelően)

'product_id' => 'Int',
		'returncode' => 'Int',
		'returntext' => 'string',

product: A feltöltéshez hasonló formában a termék minden adata, itt a product_id már a valós, Vaterás termékkód, és a képek nem base64 encodeolva, hanem urlként jönnek.

Megrendelések letöltése

Hívandó függvény neve: getorderlist

Bemenő paraméterek:

'in' => array(
		'userbase_login' => 'string',
		'userbase_password' => 'string',
		'start_time' => 'string',
		'end_time' => 'string',
		),

Bemenő paraméter értéke:

userbase_login: felhasználónév
userbase_password: jelszó md5 -ölve
start_time: a letöltési intervallum kezdete
end_time: a letöltési intervallum vége

Visszatérő paraméterek:

'out' => array(
		'returncode' => 'Int',
		'results' => 'orderlist[]',
		),

Visszatérési értékek:

results: array of:
array(
		'order_id' => 'Int',
		'order_buyer_id' => 'Int',
		'order_buyer_login' => 'string',
		'order_date' => 'string',
		'order_value' => 'Int',
		'order_delivery_cost' => 'Int',
		'order_comment' => 'string',
		'order_data' => 'array',
		'order_buyer_address' => 'array',
		'order_buyer_billing_address' => 'array'
		)

itt a megrendelés minden szükséges adata letöltésre kerül.

Egyéb kiegészítő függvények

HTML validálás

Hívandó függvény neve: checkhtml

Bemenő paraméterek:

'in' => array(
		'product_description' => 'string'
		),

Bemenő paraméter értéke:

product_description: A tervezett termékleírás

Visszatérő paraméterek:

'out' => array(
	'returncode' => 'Int',
	'returntext' => 'string',
	'safehtml' => 'string'
),

Visszatérési értékek:

returncode: az eredmény
returncode: az eredmény szövegesen
safehtml: a javított, valid html kód