Shopping_ShippingServiceOptionType Class Reference
| Inherits from | NSObject |
| Conforms to | PicoBindable |
| Declared in | Shopping_ShippingServiceOptionType.h Shopping_ShippingServiceOptionType.m |
Overview
Shipping costs and options related to a domestic shipping service.
@ingroup ShoppingInterface
Tasks
-
shippingInsuranceCostThe insurance cost associated with shipping a single item with this shipping
property
service. If the buyer bought more than one of this item, this proportional to
QuantitySold. If the item has not yet been sold, insurance information cannot
be calculated and the value is 0.00. For calculated shipping only. -
shippingServiceNameA domestic shipping service offered for shipping the item (for example, UPS
property
Ground). For flat and calculated shipping. -
shippingServiceCostThe basic shipping cost of the item.
property
Flat shipping: single-item listing: this matches (in)ShippingServiceCost;
multi-quantity listing: with a request version of 665 or greater,
this is the total of (in)ShippingServiceCost plus
((in)ShippingServiceAdditionalCost times the number of items beyond the first
item), and with a request version lower than 665, this is (in)ShippingServiceCost.
Promotional shipping: For a request version lower than 665, promotional
shipping has no effect on shipping costs. Otherwise: if the promotional
shipping option is lower than other shipping services being offered, the
savings is reflected in the returned shipping cost;
the shipping service named Promotional Shipping Service (or whatever is
the localized name for it) is included among the shipping services;
if the promotional shipping cost is lower than the cost of other shipping
services being offered, it is presented first in the list (the lowest shipping
service cost is always presented first, regardless of whether there is
promotional shipping). -
shippingServiceAdditionalCostThe cost of shipping each additional item beyond the first item (flat shipping).
property
For single-item listings, if this is not provided, it is defaulted
to zero. For multi-quantity listings, if this is not provided, it
is set to the value of (in)ShippingServiceCost (unless the request
version is lower than 665, in which case ShippingServiceAdditionalCost
is required and is not defaulted).
Not applicable to Half.com. -
shippingServicePrioritySeller-preferred presentation order relative to other
property
service options. Valid values: 1 (1st choice), 2 (2nd choice),
3 (3rd choice). For flat and calculated shipping.
Not applicable to Half.com. -
expeditedServiceIndicates whether the service is an expedited shipping service. See Enabling Get It Fast.
property
Not applicable to Half.com. -
shippingTimeMinThe minimum guaranteed number of business days in which the shipping carrier
property
can ship an item (not including the time it takes the seller to
deliver the item to the shipping carrier). See Enabling Get It Fast.
Not applicable to Half.com. -
shippingTimeMaxThe maximum guaranteed number of business days the shipping carrier will
property
take to ship an item (not including the time it takes the seller to
deliver the item to the shipping carrier). See Enabling Get It Fast.
Not applicable to Half.com. -
shippingSurchargeAn additional fee to charge US buyers who ship via UPS to Alaska, Hawaii
property
or Puerto Rico. Can only be assigned a value for Parts and Accessories
items on the eBay US and Motors sites. Only returned if set.
If some transactions in an order have a surcharge, surcharge is added
only for those transactions.
Flat rate shipping only.
With a request version of 665 or greater, total shipping cost includes any
surcharge, and ShippingSurcharge is no longer returned as an individual tag. -
shipsToAn international location or region to which the item may be shipped via this
property
particular shipping service. Associated with the shipping service by the
seller. Use GeteBayDetails to determine which locations are valid per site.
These values are string equivalents of values found in ShippingRegionCodeType
and CountryCodeType.
Returned with request version 665 or greater, if set via Trading API. -
estimatedDeliveryMinTimeThe minimum guaranteed date in which the item could reach the
property
buyer’s location.
Not applicable to Half.com. -
estimatedDeliveryMaxTimeThe maximum guaranteed date in which the item could reach the
property
buyer’s location.
Not applicable to Half.com. -
fastAndFreeIndicates whether the service is fast in delivery to the end user (less than 4 days) and free for buyer.
property -
any(public property)
property
Properties
any
(public property)
@property (nonatomic, retain) NSMutableArray *anyDiscussion
(public property)
entry type : PicoAnyElement, wrapper for primitive anyelement
Declared In
Shopping_ShippingServiceOptionType.hestimatedDeliveryMaxTime
The maximum guaranteed date in which the item could reach the
buyer’s location.
Not applicable to Half.com.
@property (nonatomic, retain) NSDate *estimatedDeliveryMaxTimeDiscussion
The maximum guaranteed date in which the item could reach the
buyer’s location.
Not applicable to Half.com.
type : NSDate, wrapper for primitive date
Declared In
Shopping_ShippingServiceOptionType.hestimatedDeliveryMinTime
The minimum guaranteed date in which the item could reach the
buyer’s location.
Not applicable to Half.com.
@property (nonatomic, retain) NSDate *estimatedDeliveryMinTimeDiscussion
The minimum guaranteed date in which the item could reach the
buyer’s location.
Not applicable to Half.com.
type : NSDate, wrapper for primitive date
Declared In
Shopping_ShippingServiceOptionType.hexpeditedService
Indicates whether the service is an expedited shipping service. See Enabling Get It Fast.
Not applicable to Half.com.
@property (nonatomic, retain) NSNumber *expeditedServiceDiscussion
Indicates whether the service is an expedited shipping service. See Enabling Get It Fast.
Not applicable to Half.com.
type : NSNumber, wrapper for primitive bool
Declared In
Shopping_ShippingServiceOptionType.hfastAndFree
Indicates whether the service is fast in delivery to the end user (less than 4 days) and free for buyer.
@property (nonatomic, retain) NSNumber *fastAndFreeDiscussion
Indicates whether the service is fast in delivery to the end user (less than 4 days) and free for buyer.
type : NSNumber, wrapper for primitive bool
Declared In
Shopping_ShippingServiceOptionType.hshippingInsuranceCost
The insurance cost associated with shipping a single item with this shipping
service. If the buyer bought more than one of this item, this proportional to
QuantitySold. If the item has not yet been sold, insurance information cannot
be calculated and the value is 0.00. For calculated shipping only.
@property (nonatomic, retain) Shopping_AmountType *shippingInsuranceCostDiscussion
The insurance cost associated with shipping a single item with this shipping
service. If the buyer bought more than one of this item, this proportional to
QuantitySold. If the item has not yet been sold, insurance information cannot
be calculated and the value is 0.00. For calculated shipping only.
type : class Shopping_AmountType
Declared In
Shopping_ShippingServiceOptionType.hshippingServiceAdditionalCost
The cost of shipping each additional item beyond the first item (flat shipping).
For single-item listings, if this is not provided, it is defaulted
to zero. For multi-quantity listings, if this is not provided, it
is set to the value of (in)ShippingServiceCost (unless the request
version is lower than 665, in which case ShippingServiceAdditionalCost
is required and is not defaulted).
Not applicable to Half.com.
@property (nonatomic, retain) Shopping_AmountType *shippingServiceAdditionalCostDiscussion
The cost of shipping each additional item beyond the first item (flat shipping).
For single-item listings, if this is not provided, it is defaulted
to zero. For multi-quantity listings, if this is not provided, it
is set to the value of (in)ShippingServiceCost (unless the request
version is lower than 665, in which case ShippingServiceAdditionalCost
is required and is not defaulted).
Not applicable to Half.com.
type : class Shopping_AmountType
Declared In
Shopping_ShippingServiceOptionType.hshippingServiceCost
The basic shipping cost of the item.
Flat shipping: single-item listing: this matches (in)ShippingServiceCost;
multi-quantity listing: with a request version of 665 or greater,
this is the total of (in)ShippingServiceCost plus
((in)ShippingServiceAdditionalCost times the number of items beyond the first
item), and with a request version lower than 665, this is (in)ShippingServiceCost.
Promotional shipping: For a request version lower than 665, promotional
shipping has no effect on shipping costs. Otherwise: if the promotional
shipping option is lower than other shipping services being offered, the
savings is reflected in the returned shipping cost;
the shipping service named Promotional Shipping Service (or whatever is
the localized name for it) is included among the shipping services;
if the promotional shipping cost is lower than the cost of other shipping
services being offered, it is presented first in the list (the lowest shipping
service cost is always presented first, regardless of whether there is
promotional shipping).
@property (nonatomic, retain) Shopping_AmountType *shippingServiceCostDiscussion
The basic shipping cost of the item.
Flat shipping: single-item listing: this matches (in)ShippingServiceCost;
multi-quantity listing: with a request version of 665 or greater,
this is the total of (in)ShippingServiceCost plus
((in)ShippingServiceAdditionalCost times the number of items beyond the first
item), and with a request version lower than 665, this is (in)ShippingServiceCost.
Promotional shipping: For a request version lower than 665, promotional
shipping has no effect on shipping costs. Otherwise: if the promotional
shipping option is lower than other shipping services being offered, the
savings is reflected in the returned shipping cost;
the shipping service named Promotional Shipping Service (or whatever is
the localized name for it) is included among the shipping services;
if the promotional shipping cost is lower than the cost of other shipping
services being offered, it is presented first in the list (the lowest shipping
service cost is always presented first, regardless of whether there is
promotional shipping).
type : class Shopping_AmountType
Declared In
Shopping_ShippingServiceOptionType.hshippingServiceName
A domestic shipping service offered for shipping the item (for example, UPS
Ground). For flat and calculated shipping.
@property (nonatomic, retain) NSString *shippingServiceNameDiscussion
A domestic shipping service offered for shipping the item (for example, UPS
Ground). For flat and calculated shipping.
type : NSString, wrapper for primitive string
Declared In
Shopping_ShippingServiceOptionType.hshippingServicePriority
Seller-preferred presentation order relative to other
service options. Valid values: 1 (1st choice), 2 (2nd choice),
3 (3rd choice). For flat and calculated shipping.
Not applicable to Half.com.
@property (nonatomic, retain) NSNumber *shippingServicePriorityDiscussion
Seller-preferred presentation order relative to other
service options. Valid values: 1 (1st choice), 2 (2nd choice),
3 (3rd choice). For flat and calculated shipping.
Not applicable to Half.com.
type : NSNumber, wrapper for primitive int
Declared In
Shopping_ShippingServiceOptionType.hshippingSurcharge
An additional fee to charge US buyers who ship via UPS to Alaska, Hawaii
or Puerto Rico. Can only be assigned a value for Parts and Accessories
items on the eBay US and Motors sites. Only returned if set.
If some transactions in an order have a surcharge, surcharge is added
only for those transactions.
Flat rate shipping only.
With a request version of 665 or greater, total shipping cost includes any
surcharge, and ShippingSurcharge is no longer returned as an individual tag.
@property (nonatomic, retain) Shopping_AmountType *shippingSurchargeDiscussion
An additional fee to charge US buyers who ship via UPS to Alaska, Hawaii
or Puerto Rico. Can only be assigned a value for Parts and Accessories
items on the eBay US and Motors sites. Only returned if set.
If some transactions in an order have a surcharge, surcharge is added
only for those transactions.
Flat rate shipping only.
With a request version of 665 or greater, total shipping cost includes any
surcharge, and ShippingSurcharge is no longer returned as an individual tag.
type : class Shopping_AmountType
Declared In
Shopping_ShippingServiceOptionType.hshippingTimeMax
The maximum guaranteed number of business days the shipping carrier will
take to ship an item (not including the time it takes the seller to
deliver the item to the shipping carrier). See Enabling Get It Fast.
Not applicable to Half.com.
@property (nonatomic, retain) NSNumber *shippingTimeMaxDiscussion
The maximum guaranteed number of business days the shipping carrier will
take to ship an item (not including the time it takes the seller to
deliver the item to the shipping carrier). See Enabling Get It Fast.
Not applicable to Half.com.
type : NSNumber, wrapper for primitive int
Declared In
Shopping_ShippingServiceOptionType.hshippingTimeMin
The minimum guaranteed number of business days in which the shipping carrier
can ship an item (not including the time it takes the seller to
deliver the item to the shipping carrier). See Enabling Get It Fast.
Not applicable to Half.com.
@property (nonatomic, retain) NSNumber *shippingTimeMinDiscussion
The minimum guaranteed number of business days in which the shipping carrier
can ship an item (not including the time it takes the seller to
deliver the item to the shipping carrier). See Enabling Get It Fast.
Not applicable to Half.com.
type : NSNumber, wrapper for primitive int
Declared In
Shopping_ShippingServiceOptionType.hshipsTo
An international location or region to which the item may be shipped via this
particular shipping service. Associated with the shipping service by the
seller. Use GeteBayDetails to determine which locations are valid per site.
These values are string equivalents of values found in ShippingRegionCodeType
and CountryCodeType.
Returned with request version 665 or greater, if set via Trading API.
@property (nonatomic, retain) NSMutableArray *shipsToDiscussion
An international location or region to which the item may be shipped via this
particular shipping service. Associated with the shipping service by the
seller. Use GeteBayDetails to determine which locations are valid per site.
These values are string equivalents of values found in ShippingRegionCodeType
and CountryCodeType.
Returned with request version 665 or greater, if set via Trading API.
entry type : NSString, wrapper for primitive string
Declared In
Shopping_ShippingServiceOptionType.h