ShippingServiceOptionType

Shipping costs and options related to a domestic shipping service.

Types that use ShippingServiceOptionType:

Call that uses one or more fields of ShippingServiceOptionType:

Fields

EstimatedDeliveryMaxTime ( dateTime )
EstimatedDeliveryMinTime ( dateTime )
ExpeditedService ( boolean )
FastAndFree ( boolean )
ShippingInsuranceCost ( AmountType (double) )
ShippingServiceAdditionalCost ( AmountType (double) )
ShippingServiceCost ( AmountType (double) )
ShippingServiceName ( token )
ShippingServicePriority ( int )
ShippingSurcharge ( AmountType (double) )
ShippingTimeMax ( int )
ShippingTimeMin ( int )
ShipsTo ( string )

EstimatedDeliveryMaxTime ( dateTime ) [0..1]
The maximum guaranteed date in which the item could reach the buyer's location. Not applicable to Half.com.
See the Field Index to learn which calls use EstimatedDeliveryMaxTime.

EstimatedDeliveryMinTime ( dateTime ) [0..1]
The minimum guaranteed date in which the item could reach the buyer's location. Not applicable to Half.com.
See the Field Index to learn which calls use EstimatedDeliveryMinTime.

ExpeditedService ( boolean ) [0..1]
Indicates whether the service is an expedited shipping service. See Enabling Get It Fast. Not applicable to Half.com.
See the Field Index to learn which calls use ExpeditedService.

FastAndFree ( boolean ) [0..1]
Indicates whether the service is fast in delivery to the end user (less than 4 days) and free for buyer.
See the Field Index to learn which calls use FastAndFree.

ShippingInsuranceCost ( AmountType (double) ) [0..1]
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.
See the Field Index to learn which calls use ShippingInsuranceCost.

ShippingServiceAdditionalCost ( AmountType (double) ) [0..1]
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.
See the Field Index to learn which calls use ShippingServiceAdditionalCost.

ShippingServiceCost ( AmountType (double) ) [0..1]
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).
See the Field Index to learn which calls use ShippingServiceCost.

ShippingServiceName ( token ) [0..1]
A domestic shipping service offered for shipping the item (for example, UPS Ground). For flat and calculated shipping.
See the Field Index to learn which calls use ShippingServiceName.

ShippingServicePriority ( int ) [0..1]
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.
See the Field Index to learn which calls use ShippingServicePriority.

ShippingSurcharge ( AmountType (double) ) [0..1]
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.
See the Field Index to learn which calls use ShippingSurcharge.

ShippingTimeMax ( int ) [0..1]
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.
See the Field Index to learn which calls use ShippingTimeMax.

ShippingTimeMin ( int ) [0..1]
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.
See the Field Index to learn which calls use ShippingTimeMin.

ShipsTo ( string ) [0..*]
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.
See the Field Index to learn which calls use ShipsTo.

Copyright © 2006–2013 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.