Container consisting of shipping costs and other details related to a domestic shipping service. A ShippingServiceOptions container is required for each domestic shipping service option that the seller will make available to buyers in an Add/Revise/Relist call. Up to four domestic shipping service options can be offered per listing.
Types that use ShippingServiceOptionsType:
Calls that use ShippingServiceOptionsType:
AddFixedPriceItem, AddItem, AddItems, AddOrder, GetItem, GetItemShipping, GetItemTransactions, GetMyeBayBuying, GetMyeBaySelling, GetOrders, GetSellerList, GetSellerTransactions, RelistFixedPriceItem, RelistItem, ReviseFixedPriceItem, ReviseItem, SendInvoice, VerifyAddFixedPriceItem, VerifyAddItem, VerifyRelistItem
true if the domestic shipping service is considered an expedited shipping service. An expedited service is typically a shipping service that can ship an order that will arrive at the buyer's location within one to two business days.
1 or included first in the call request). If 'free shipping' is for any other shipping service, this field is ignored.
For 'Get' calls, including GetItem, this field is only returned if
Note: If a seller is specifying a shipping service option as 'free shipping', in addition to this FreeShipping boolean field, the seller will also need to include the corresponding ShippingServiceCost field and set its value to
0.0, as eBay will not do this automatically. Note: If the condition is certified refurbished (ConditionID set to
2000, 'Certified - Refurbished'), you must offer a free shipping option. Set FreeShipping as
1) along with the ShippingServiceCost as
0.0 for the first domestic shipping service.
For the Global Shipping Program, which is only supported in the UK, this field contains the total cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties.
For example, if the LocalPickup flag is used with the ShippingServiceOptions and ShippingServiceCost fields, the seller can indicate that local pickup is an available option and that no is fee charged. This is the equivalent of free shipping.
Reserved for internal or future use.
This field is no longer applicable as it is not longer possible for a seller to offer a buyer shipping insurance.
For a list of valid ShippingService values, call GeteBayDetails with DetailName set to
ShippingServiceDetails. The ShippingServiceDetails.ValidForSellingFlow flag must also be present. Otherwise, that particular shipping service option is no longer valid and cannot be offered to buyers through a listing.
To view the full list of domestic shipping service options in the response, look for the ShippingServiceDetails.ShippingService fields. Domestic shipping service options will not have a InternationalService =
true field, as this indicates that the ShippingService value is an International shipping service option.
Note: The eBay standard envelope (eSE) is a domestic envelope service with tracking through eBay. This service applies to specific sub-categories of Trading Cards, and to coins & paper money, postcards, stamps, patches, and similar eligible categories, and is only available on the US marketplace. See eBay standard envelope for details, restrictions, and an envelope size template. To use this service, send envelopes using the USPS mail and set the ShippingService field to
For the REST equivalent, see Using the eBay standard envelope (eSE) service.
The value of this field can even be set to
0 if the seller wants to encourage buyers to buy multiple quantity of the item, or it could be that the seller can fit multiple quantities of the line item in a single shipping package, so the seller is just passing this shipping savings onto the buyer. This field is not applicable for single-quantity listings.
In the case of a multiple-quantity, fixed-price listing, the ShippingServiceAdditionalCost field also becomes applicable, and shows the cost to ship each additional unit of the item if the buyer purchases multiple quantity of the same line item.
Note: If the corresponding shipping service option is set as a 'free shipping' option (FreeShipping=true), the seller still needs to include this ShippingServiceCost field and set its value to
0.0, as eBay will not do this automatically. When returned by GetItemShipping, it includes the packaging and handling cost.
Note that if ShippingService is set to
LocalPickup, ShippingServiceCost must be set to
0.0. Also, if a shipping service has been specified (even LocalPickup), GetItem returns the shipping service cost, even if the cost is zero.
If this is for calculated shipping for a listing that has not yet ended, note that the cost cannot be determined until the listing has ended and the buyer has specified a postal code.
The cut off time is set by eBay and determined in part by the policies and locations of the seller and the shipping carrier.
Sellers can specify up to four domestic shipping services (with four ShippingServiceOptions containers), so valid values are 1, 2, 3, and 4. A shipping service with a ShippingServicePriority value of 1 appears at the top. Conversely, a shipping service with a ShippingServicePriority value of 4 appears at the bottom of a list of four shipping service options.
If this field is omitted from domestic shipping service options, the order of the shipping service options in View Item and Checkout pages will be determined by the order that these shipping service options are presented in the request payload of an Add/Revise/Relist call.
This maximum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option.
This minimum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option.