TopatsDeliverySendRequest.php 6.3 KB
<?php
/**
 * TOP API: taobao.topats.delivery.send request
 * 
 * @author auto create
 * @since 1.0, 2012-12-13 16:33:03
 */
class TopatsDeliverySendRequest
{
	/** 
	 * 每个tid所对应的物流公司代码。可以不传,表示所有的物流公司都为"其他",但是只要有一个订单需要指定物流公司,所有的订单都需要指定物流公司,每个类型之间用";"连接。排列要和tid顺序一致,不需要指定物流公司的订单,该位置上放上一个空字符串""。可以不传,传了长度和位置要和tid保持一致。

每个company_code表示物流公司代码.如"POST"就代表中国邮政,"ZJS"就代表宅急送.调用 taobao.logisticcompanies.get 获取。如传入的代码非淘宝官方物流合作公司,默认是“其他”物流的方式,在淘宝不显示物流具体进度,故传入需谨慎。如果orderType为delivery_needed,则必传
	 **/
	private $companyCodes;
	
	/** 
	 * 每个tid所对应的卖家备注。可以不传,表示所有的发货订单都不需要卖家备注,但是只要有一个订单需要指定卖家备注,所有的订单都需要指定卖家备注,每个卖家备注之间用";"连接。排列要和tid顺序一致,不需要指定卖家备注的订单,该位置上放上一个空字符串""。可以不传,传了长度和位置要和tid保持一致。卖家备注.最大长度为250个字符。如果orderType为delivery_needed,则必传
	 **/
	private $memos;
	
	/** 
	 * 每个tid所对应的物流发货类型。可以不传,表示所有的发货类型都为"delivery_needed",但是只要有一个订单需要指定发货类型,所有的订单都需要指定发货类型,每个类型之间用";"连接。排列要和tid顺序一致,不需要指定发货类型的订单,该位置上放上一个空字符串""。可以不传,传了长度和位置要和tid保持一致。 每个类型可选( delivery_needed(物流订单发货),virtual_goods(虚拟物品发货). ) 注:选择virtual_goods类型进行发货的话下面的参数可以不需填写。如果选择delivery_needed 则下面的参数必须要填写
	 **/
	private $orderTypes;
	
	/** 
	 * 每个tid所对应的物流公司运单号。可以不传,表示所有的物流订单都没有订单号,但是只要有一个订单需要有订单号,所有的订单都需要指定订单号,每个订单号之间用";"连接。排列要和tid顺序一致,不需要指定订单号的订单,该位置上放上一个空字符串""。可以不传,传了长度和位置要和tid保持一致。
具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入;若company_codes中传入的代码非淘宝官方物流合作公司,此处运单号不校验。如果orderType为delivery_needed,则必传
	 **/
	private $outSids;
	
	/** 
	 * 卖家地址(详细地址).如:XXX街道XXX门牌,省市区不需要提供。如果orderType为delivery_needed,则必传
	 **/
	private $sellerAddress;
	
	/** 
	 * 卖家所在地国家公布的标准地区码.参考:http://www.stats.gov.cn/tjbz/xzqhdm/t20080215_402462675.htm 或者调用 taobao.areas.get 获取。如果orderType为delivery_needed,则必传
	 **/
	private $sellerAreaId;
	
	/** 
	 * 卖家手机号码
	 **/
	private $sellerMobile;
	
	/** 
	 * 卖家姓名。如果orderType为delivery_needed,则必传
	 **/
	private $sellerName;
	
	/** 
	 * 卖家固定电话.包含区号,电话,分机号,中间用 " – "; 卖家固定电话和卖家手机号码,必须填写一个.
	 **/
	private $sellerPhone;
	
	/** 
	 * 卖家邮编。如果orderType为delivery_needed,则必传
	 **/
	private $sellerZip;
	
	/** 
	 * 批量发货的订单id列表,每个订单id必需是合法的数字类型的tid,每个tid之间以";"分隔,至少要指定一个tid,最多不超过40个tid
	 **/
	private $tids;
	
	private $apiParas = array();
	
	public function setCompanyCodes($companyCodes)
	{
		$this->companyCodes = $companyCodes;
		$this->apiParas["company_codes"] = $companyCodes;
	}

	public function getCompanyCodes()
	{
		return $this->companyCodes;
	}

	public function setMemos($memos)
	{
		$this->memos = $memos;
		$this->apiParas["memos"] = $memos;
	}

	public function getMemos()
	{
		return $this->memos;
	}

	public function setOrderTypes($orderTypes)
	{
		$this->orderTypes = $orderTypes;
		$this->apiParas["order_types"] = $orderTypes;
	}

	public function getOrderTypes()
	{
		return $this->orderTypes;
	}

	public function setOutSids($outSids)
	{
		$this->outSids = $outSids;
		$this->apiParas["out_sids"] = $outSids;
	}

	public function getOutSids()
	{
		return $this->outSids;
	}

	public function setSellerAddress($sellerAddress)
	{
		$this->sellerAddress = $sellerAddress;
		$this->apiParas["seller_address"] = $sellerAddress;
	}

	public function getSellerAddress()
	{
		return $this->sellerAddress;
	}

	public function setSellerAreaId($sellerAreaId)
	{
		$this->sellerAreaId = $sellerAreaId;
		$this->apiParas["seller_area_id"] = $sellerAreaId;
	}

	public function getSellerAreaId()
	{
		return $this->sellerAreaId;
	}

	public function setSellerMobile($sellerMobile)
	{
		$this->sellerMobile = $sellerMobile;
		$this->apiParas["seller_mobile"] = $sellerMobile;
	}

	public function getSellerMobile()
	{
		return $this->sellerMobile;
	}

	public function setSellerName($sellerName)
	{
		$this->sellerName = $sellerName;
		$this->apiParas["seller_name"] = $sellerName;
	}

	public function getSellerName()
	{
		return $this->sellerName;
	}

	public function setSellerPhone($sellerPhone)
	{
		$this->sellerPhone = $sellerPhone;
		$this->apiParas["seller_phone"] = $sellerPhone;
	}

	public function getSellerPhone()
	{
		return $this->sellerPhone;
	}

	public function setSellerZip($sellerZip)
	{
		$this->sellerZip = $sellerZip;
		$this->apiParas["seller_zip"] = $sellerZip;
	}

	public function getSellerZip()
	{
		return $this->sellerZip;
	}

	public function setTids($tids)
	{
		$this->tids = $tids;
		$this->apiParas["tids"] = $tids;
	}

	public function getTids()
	{
		return $this->tids;
	}

	public function getApiMethodName()
	{
		return "taobao.topats.delivery.send";
	}
	
	public function getApiParas()
	{
		return $this->apiParas;
	}
	
	public function check()
	{
		
		RequestCheckUtil::checkNotNull($this->tids,"tids");
	}
	
	public function putOtherTextParam($key, $value) {
		$this->apiParas[$key] = $value;
		$this->$key = $value;
	}
}