<?php
/**
 * Soap Service
 *
 * @service OldthingSoapClient
 */
class OldthingSoapClient{
	/**
	 * The WSDL URI
	 *
	 * @var string
	 */
	public static $_WsdlUri='http://api.oldthing.de/soap/soap08.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.
	 * FÃ¼r den Webhook Aufruf gibt es zwei Versionen. FÃ¼r Kunden mit Registrierung vor dem 01.12.2023 gilt Version 1. Alle Kunden mit spÃ¤terer Registrierung arbeiten automatisch mit Version 2. Ein Umstieg von Version 1 auf Version 2 kann jederzeit durch unseren Kundendienst vorgenommen werden.
	 *
	 * @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 Webhook URL (siehe setSaleNotifierUri) einmalig auf, so dass die Verarbeitung eines Verkaufs auf oldthing 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.
	 * 
	 * Durch die Parameter $version ('1' oder '2') und $userType ('private' oder 'commerical') kÃ¶nnen Sie die fÃ¼r Sie zutreffende Version mit den beiden Nutzertypen testen.
	 *
	 * @param string $token
	 * @param int $version
	 * @param string $userType
	 * @return Result
	 */
	public function testSaleNotifierUri($token,$version,$userType){
		return self::_Call('testSaleNotifierUri',Array(
			$token,
			$version,
			$userType
		));
	}

	/**
	 * Gibt die Orders des Members zurÃ¼ck
	 *
	 * @param string $token
	 * @param string $status
	 * @param string $offset
	 * @return Result
	 */
	public function getOrders($token,$status,$offset){
		return self::_Call('getOrders',Array(
			$token,
			$status,
			$offset
		));
	}

	/**
	 * Gibt die Bestellung mit Artikel ID zurÃ¼ck.
	 *
	 * @param string $token
	 * @param string $orderId
	 * @return Result
	 */
	public function getOrder($token,$orderId){
		return self::_Call('getOrder',Array(
			$token,
			$orderId
		));
	}

	/**
	 * Ãndert den Status einer Bestellung und versendet die entsprechenden Emails an den KÃ¤ufer und VerkÃ¤ufer. ACHTUNG: Jeder Aufruf dieser Funktion versendet die entsprechenden Status Emails an den Kunden!
	 *
	 * @param string $token
	 * @param string $orderId
	 * @param string $status - ZulÃ¤ssige Werte sind "payed" Wenn Sie die Zahlung fÃ¼r die Bestellung erhalten haben oder "sent" wenn Sie die Bestellung verschickt haben.
	 * @param string $carrier optional- Name des Versanddienstleisters. Die Tracking Info wird in der Kundenmail nur ausgespielt wenn Sie den Carrier UND eine Trackingnummer oder Url angeben.
	 * @param string $tracking optional - Tracking Nummer oder Tracking Url. Wenn Sie eine Nummer Ã¼bergeben wird in der Mail an den Kunden lediglich die Trackingnummer ausgegeben. Besser ist es Sie Ã¼bergeben eine Url. In diesem Fall wird die Url als Link in der Mail ausgegeben.
	 * @return Result
	 */
	public function setOrderStatus($token,$orderId,$status,$carrier,$tracking){
		return self::_Call('setOrderStatus',Array(
			$token,
			$orderId,
			$status,
			$carrier,
			$tracking
		));
	}

	/**
	 * Storniert eine Bestellung und versendet die entsprechenden Emails an den Kunden und VerkÃ¤ufer.
	 *
	 * @param string $token
	 * @param string $orderId
	 * @param boolean $resetArticles
	 * @return Result
	 */
	public function cancelOrder($token,$orderId,$resetArticles){
		return self::_Call('cancelOrder',Array(
			$token,
			$orderId,
			$resetArticles
		));
	}

	/**
	 * Storniert einen Artikel innerhalb einer Bestellung.
	 *
	 * @param string $token
	 * @param string $orderId
	 * @param string $articleId
	 * @param int $count
	 * @param boolean $resetArticle
	 */
	public function cancelOrderItem($token,$orderId,$articleId,$count,$resetArticle){
		return self::_Call('cancelOrderItem',Array(
			$token,
			$orderId,
			$articleId,
			$count,
			$resetArticle
		));
	}

	/**
	 * Schickt eine Zahlungsaufforderung / Zahlungserinnerung an den KÃ¤ufer.
	 *
	 * @param string $token
	 * @param string $orderId
	 * @param string $notice
	 */
	public function sendPaymentRequest($token,$orderId,$notice){
		return self::_Call('sendPaymentRequest',Array(
			$token,
			$orderId,
			$notice
		));
	}
}