<?php
/**
* Zend Framework
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://framework.zend.com/license/new-bsd
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@zend.com so we can send you a copy immediately.
*
* @category Zend
* @package Zend_Service
* @subpackage Ebay
* @copyright Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id: ListingInfo.php 22791 2010-08-04 16:11:47Z renanbr $
*/
/**
* @see Zend_Service_Ebay_Finding_Abstract
*/
require_once 'Zend/Service/Ebay/Finding/Abstract.php';
/**
* @category Zend
* @package Zend_Service
* @subpackage Ebay
* @copyright Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @uses Zend_Service_Ebay_Finding_Abstract
*/
class Zend_Service_Ebay_Finding_ListingInfo extends Zend_Service_Ebay_Finding_Abstract
{
/**
* Shows whether or not the seller will accept a best offer for the
* associated item.
*
* Best Offer allows a buyer to make a lower-priced binding offer on a fixed
* price item. Buyers cannot see how many offers have been made (only the
* seller can see this information). To make a best offer on a listing, use
* the eBay Web site.
*
* @var boolean
*/
public $bestOfferEnabled;
/**
* Used with competitive-bid auctions, the associated item includes a Buy It
* Now option if this value returns true.
*
* Buy It Now lets a user purchase the item at a fixed price, effectively
* ending the auction. On most sites, the Buy It Now option is removed (and
* this value returns false) once a valid bid is made on the associated item
* (a valid bid could be a bid above the reserve price).
*
* @var boolean
*/
public $buyItNowAvailable;
/**
* The Buy It Now Price of the item (if any), in the currency of the site on
* which the item was listed.
*
* You can use this field to determine if the item was originally listed
* with Buy It Now, even if the Buy It Now option is no longer available for
* the item.
*
* For Basic Fixed-Price (FixedPrice), Store Inventory (StoreInventory), and
* Ad Format (AdFormat) listings, currentPrice is the current fixed price.
*
* Only returned if an item was listed with Buy It Now.
*
* @var float
*/
public $buyItNowPrice;
/**
* The listing's Buy It Now Price (if any), converted into the currency of
* the site to which you sent your search request.
*
* For active items, refresh this value every 24 hours to pick up changes in
* conversion rates (if this value has been converted).
*
* Price fields are returned as doubles, not necessarily in the traditional
* monetary format of the site's country. For example, a US Dollar value
* might be returned as 3.880001 instead of 3.88.
*
* Only returned if an item was listed with Buy It Now.
*
* @var float
*/
public $convertedBuyItNowPrice;
/**
* Time stamp specifying when the listing is scheduled to end, or the actual
* end time if the item listing has ended.
*
* This value is returned in GMT, the ISO 8601 date and time format
* (YYYY-MM-DDTHH:MM:SS.SSSZ). See the "dateTime" type for information about
* the time format, and for details on converting to and from the GMT time
* zone.
*
* @var integer
*/
public $endTime;
/**
* If true, a generic gift icon displays next the listing's title in search
* and browse pages.
*
* @var boolean
*/
public $gift;
/**
* The format of the listing, such as online auction, fixed price, or
* advertisement.
*
* Applicable values:
*
* AdFormat
* Advertisement to solicit inquiries on listings such as real estate.
* Permits no bidding on that item, service, or property. To express
* interest, a buyer fills out a contact form that eBay forwards to the
* seller as a lead. This format does not enable buyers and sellers to
* transact online through eBay and eBay Feedback is not available for
* ad format listings.
*
* Auction
* Competitive-bid online auction format. Buyers engage in competitive
* bidding, although Buy It Now may be offered as long as no valid bids
* have been placed. Online auctions are listed on eBay.com; they can
* also be listed in a seller's eBay Store if the seller is a Store
* owner.
*
* AuctionWithBIN
* Same as Auction format, but Buy It Now is enabled. AuctionWithBIN
* changes to Auction if a valid bid has been placed on the item. Valid
* bids include bids that are equal to or above any specified reserve
* price.
*
* Classified
* Classified Ads connect buyers and sellers, who then complete the sale
* outside of eBay. This format does not enable buyers and sellers to
* transact online through eBay and eBay Feedback is not available for
* these listing types.
*
* FixedPrice
* A fixed-price listing. Auction-style bidding is not allowed. On some
* sites, this auction format is also known as "Buy It Now Only" (not to
* be confused with the Buy It Now option available with
* competitive-bidding auctions). Fixed-price listings appear on
* eBay.com; they can also be listed in a seller's eBay Store if the
* seller is a Store owner.
*
* StoreInventory
* A fixed-price format for eBay Store sellers. Store Inventory listings
* appear after other listings in regular browse and search item
* listings on eBay. Store items have a lower Insertion Fee and longer
* listing durations. This selling type can only be specified by sellers
* who have an eBay Store. Store Inventory listings are listed on
* eBay.com as well as in the seller's eBay Store.
*
* @var string
*/
public $listingType;
/**
* Time stamp that eBay recorded as the moment the listing was made
* available.
*
* This value is returned in GMT, the ISO 8601 date and time format
* (YYYY-MM-DDTHH:MM:SS.SSSZ). See the "dateTime" type for information about
* the time format, and for details on converting to and from the GMT time
* zone. Note that it is possible for startTime to be different from the
* value returned by GetSingleItem.
*
* @var integer
*/
public $startTime;
/**
* @return void
*/
protected function _init()
{
parent::_init();
$ns = Zend_Service_Ebay_Finding::XMLNS_FINDING;
$this->bestOfferEnabled = $this->_query(".//$ns:bestOfferEnabled[1]", 'boolean');
$this->buyItNowAvailable = $this->_query(".//$ns:buyItNowAvailable[1]", 'boolean');
$this->buyItNowPrice = $this->_query(".//$ns:buyItNowPrice[1]", 'float');
$this->convertedBuyItNowPrice = $this->_query(".//$ns:convertedBuyItNowPrice[1]", 'float');
$this->endTime = $this->_query(".//$ns:endTime[1]", 'string');
$this->gift = $this->_query(".//$ns:gift[1]", 'boolean');
$this->listingType = $this->_query(".//$ns:listingType[1]", 'string');
$this->startTime = $this->_query(".//$ns:startTime[1]", 'string');
$this->_attributes['buyItNowPrice'] = array(
'currencyId' => $this->_query(".//$ns:buyItNowPrice[1]/@currencyId[1]", 'string')
);
$this->_attributes['convertedBuyItNowPrice'] = array(
'currencyId' => $this->_query(".//$ns:convertedBuyItNowPrice[1]/@currencyId[1]", 'string')
);
}
}