<?php
/**
 * Soap Service
 *
 * @service OldthingSoapClient
 */
class OldthingSoapClient{
	/**
	 * The WSDL URI
	 *
	 * @var string
	 */
	public static $_WsdlUri='http://api.oldthing.de/soap/soap05.php?WSDL';
	/**
	 * The PHP SoapClient object
	 *
	 * @var object
	 */
	public static $_Server=null;

	/**
	 * Send a SOAP request to the server
	 *
	 * @param string $method The method name
	 * @param array $param The parameters
	 * @return mixed The server response
	 */
	public static function _Call($method,$param){
		if(is_null(self::$_Server))
			self::$_Server=new SoapClient(self::$_WsdlUri);
		return self::$_Server->__soapCall($method,$param);
	}

	/**
	 * Eine Testfunktion der API, so dass die Verbindung sichergestellt werden kann. Diese Funktion wird im laufenden Betrieb nicht benÃ¶tigt.
	 *
	 * @return Result
	 */
	public function ping(){
		return self::_Call('ping',Array(
		));
	}

	/**
	 * Ermittelt das Token fÃ¼r eine Session zum Aufruf aller anderen Funktionen. Einen API-SchlÃ¼ssel erhalten Sie nach Bewerbung bei oldthing. Ohne Authentifizierung (token) kÃ¶nnen nur die Funktionen "ping()" und "authenticate(apiKey)" aufgerufen werden.
	 *
	 * @param string $apiKey
	 * @return Result
	 */
	public function authenticate($apiKey){
		return self::_Call('authenticate',Array(
			$apiKey
		));
	}

	/**
	 * Gibt die oldthing-Kategorien mit Namen und Id entsprechend ihrer Hirarchie zurÃ¼ck.
	 *
	 * @param string $token Token nach Authentifizierung
	 * @param int $pid parent_id der Kategorie-Ebene
	 * @return Result
	 */
	public function getCategories($token,$pid){
		return self::_Call('getCategories',Array(
			$token,
			$pid
		));
	}

	/**
	 * Gibt alle Items (Produkte / Artikel) als array von Item-Objekten zurÃ¼ck. Mit den optionalen Parametern "offset" und "limit" kann die Auswahl definiert werden.
	 *
	 * @param string $token
	 * @param int $offset
	 * @param int $limit
	 * @return Result
	 */
	public function getItems($token,$offset,$limit){
		return self::_Call('getItems',Array(
			$token,
			$offset,
			$limit
		));
	}

	/**
	 * Gibt alle Items (Produkte / Artikel) als array von Item-Objekten zurÃ¼ck, die lediglich die ID und SKU enthalten. Mit den optionalen Parametern "offset" und "limit" kann die Auswahl definiert werden.
	 *
	 * @param string $token
	 * @param int $offset
	 * @param int $limit
	 * @return Result
	 */
	public function getItemIds($token,$offset,$limit){
		return self::_Call('getItemIds',Array(
			$token,
			$offset,
			$limit
		));
	}

	/**
	 * Gibt das Item (Produkt / Artikel) zurÃ¼ck, welches Ã¼ber die interne id identifiziert wird. Beim EinfÃ¼gen von Items mittels setItem wird die Id des items zurÃ¼ckgegeben.
	 *
	 * @param string $token
	 * @param int $id
	 * @return Result
	 */
	public function getItem($token,$id){
		return self::_Call('getItem',Array(
			$token,
			$id
		));
	}

	/**
	 * Gleiche Funktion wie "getItem", jedoch wird das Item Ã¼ber die Artikelnummer (SKU) des Shopbetreibers ermittelt.
	 *
	 * @param string $token
	 * @param string $sku
	 * @return Result
	 */
	public function getItemBySku($token,$sku){
		return self::_Call('getItemBySku',Array(
			$token,
			$sku
		));
	}

	/**
	 * FÃ¼gt ein neues Item (Produkt / Artikel) ein oder aktualisiert ein bestehendes Item (update). Ein Update erfolgt, wenn eine id gesetzt ist oder ein Item mit gegebener SKU vorhanden ist. Ansonsten wird das Item neu angelegt und erhÃ¤lt eine neue interne id, die zurÃ¼ckgegeben wird.
	 *
	 * @param string $token
	 * @param array $item
	 * @return Result
	 */
	public function setItem($token,$item){
		return self::_Call('setItem',Array(
			$token,
			$item
		));
	}

	/**
	 * LÃ¶scht ein Item (Produkt / Artikel) aus dem Bestand , welches Ã¼ber die interne id identifiziert wird. Diese Id wir z.B. Ã¼ber die Funktionen "getItem" und "getItems" zurÃ¼ckgegeben. Siehe auch "deleteItemBySku".
	 *
	 * @param string $token
	 * @param int $id
	 * @return Result
	 */
	public function deleteItem($token,$id){
		return self::_Call('deleteItem',Array(
			$token,
			$id
		));
	}

	/**
	 * LÃ¶scht ein Item (Produkt / Artikel) aus dem Bestand , welches Ã¼ber die Artikelnummer (SKU) des Shopbetreibers identifiziert wird. Siehe auch <i>deleteItem</i>.
	 *
	 * @param string $token
	 * @param string $sku
	 * @return Result
	 */
	public function deleteItemBySku($token,$sku){
		return self::_Call('deleteItemBySku',Array(
			$token,
			$sku
		));
	}

	/**
	 * Setzt eine HTTP-Adresse, welche beim Kauf eines Produkts (Items) des Shops aufgerufen wird. Die gegebene URL wird nach Bestellungseingang Ã¼ber HTTP mit der POST-Methode aufgerufen (REST-Schnittstelle) wobei Bestelldaten und Details zum Artikel mitgesendet werden. Die URL wird dauerhaft gespeichert, so dass diese Funktion i.d.R. nur einmal aufgerufen werden muss.
	 *
	 * @param string $token
	 * @param string $uri
	 * @return Result
	 */
	public function setSaleNotifierUri($token,$uri){
		return self::_Call('setSaleNotifierUri',Array(
			$token,
			$uri
		));
	}

	/**
	 * Testfunktion: Ruft die vorher gesetzte URL (siehe <i>setSaleNotifierUri</i>) einmalig auf, so dass die Verarbeitung eines verkauften Items getestet werden kann. Die URL wird mittels HTTP-POST aufgerufen. Dabei werden Bestelldaten Ã¼bergeben, die z.B. in einem PHP-Skript Ã¼ber das $_POST array entgegengenommen werden kÃ¶nnen.
	 *
	 * @param string $token
	 * @return Result
	 */
	public function testSaleNotifierUri($token){
		return self::_Call('testSaleNotifierUri',Array(
			$token
		));
	}
}