ShippingServiceOptionsType
Shipping costs and options related to a domestic shipping service.

Types that use ShippingServiceOptionsType:

Calls that use one or more fields of ShippingServiceOptionsType:

Fields

ExpeditedService ( boolean )
FreeShipping ( boolean )
ShippingInsuranceCost ( AmountType (double) )
ShippingService ( token )
ShippingServiceAdditionalCost ( AmountType (double) )
ShippingServiceCost ( AmountType (double) )
ShippingServicePriority ( int )
ShippingSurcharge ( AmountType (double) )
ShippingTimeMax ( int )
ShippingTimeMin ( int )

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.

FreeShipping ( boolean ) [0..1]
A seller offers free shipping by setting FreeShipping to true. This free shipping applies only to the first domestic shipping service. (It is ignored if set for any other shipping service.) If the seller has required shipping insurance as part of shipping (the seller set InsuranceOption to Required) and then the seller specified FreeShipping, eBay sets the insurance cost to 0. However, if the seller made shipping insurance optional, eBay preserves the cost of shipping insurance; it is up to the buyer whether to buy shipping insurance, regardless of whether the seller specified FreeShipping.
See the Field Index to learn which calls use FreeShipping.

ShippingInsuranceCost ( AmountType (double) ) [0..1]
The insurance cost associated with shipping a single item with this shipping service. Exception: for GetItemShipping, this is 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. Also applicable to Half.com (for GetOrders).
See the Field Index to learn which calls use ShippingInsuranceCost.

ShippingService ( token ) [0..1]
A domestic shipping service offered for shipping the item (for example, UPS Ground). For a list of valid values that you can cache for future use, call GeteBayDetails with DetailName set to ShippingServiceDetails. For flat and calculated shipping. Also applicable to Half.com (for GetOrders).

If there are two or more services and one is "pickup", "pickup" must not be specified as the first service.
See the Field Index to learn which calls use ShippingService.

ShippingServiceAdditionalCost ( AmountType (double) ) [0..1]
The cost of shipping each additional item beyond the first item. For input, this is required if the listing is for multiple items and should be zero for single-item listings. Default value is 0.00. For flat shipping only. Not applicable to Half.com.
See the Field Index to learn which calls use ShippingServiceAdditionalCost.

ShippingServiceCost ( AmountType (double) ) [0..1]
The meaning of this element depends on the call and on whether flat or calculated shipping has been selected. (For example, it could be the cost to ship a single item, the cost to ship all items, or the cost to ship just the first of many items, with ShippingServiceAdditionalCost accounting for the rest.) When returned by GetItemShipping, it includes the packaging and handling cost. For flat and calculated shipping.

Also applicable to Half.com (for GetOrders).
See the Field Index to learn which calls use ShippingServiceCost.

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 the eBay US site and for items in the Parts and Accessories category of the eBay Motors site. Only returned if set. If some transactions in an order have a surcharge, surcharge is added only for those transactions. Flat rate shipping only.
See the Field Index to learn which calls use ShippingSurcharge.

ShippingTimeMax ( int ) [0..1]
The maximum guaranteed number of 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 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.

This document was generated with a customized version of the apireferencedocs tool.

© 2005–2009 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.