eBay Shopping APIVersion 1085

InternationalShippingServiceOptionType

Container consisting of shipping costs and other details related to an international shipping service that is available to ship an item to the shipping destination specified in the GetShippingCosts call request.

Type that uses InternationalShippingServiceOptionType:

Call that uses InternationalShippingServiceOptionType:

Fields



EstimatedDeliveryMaxTime ( dateTime ) [0..1]
This timestamp indicates the latest date/time that the item should reach the seller's destination based on the seller's stated handling time and the shipping service's transit time. This timestamp is based on an immediate purchase of the item at checkout.
See the Field Index to learn which calls use EstimatedDeliveryMaxTime.

EstimatedDeliveryMinTime ( dateTime ) [0..1]
This timestamp indicates the earliest date/time that the item could possibly reach the seller's destination based on the seller's stated handling time and the shipping service's transit time. This timestamp is based on an immediate purchase of the item at checkout.
See the Field Index to learn which calls use EstimatedDeliveryMinTime.

ImportCharge ( AmountType (double) ) [0..1]
The estimated cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This field is only applicable for international orders being handled through the Global Shipping Program; otherwise, it will not be returned.
See the Field Index to learn which calls use ImportCharge.

ShippingInsuranceCost ( AmountType (double) ) [0..1]
Not used by any call.

This field is no longer applicable as it is not longer possible for a seller to offer a buyer shipping insurance.
See the Field Index to learn which calls use ShippingInsuranceCost.

ShippingServiceAdditionalCost ( AmountType (double) ) [0..1]
The cost of shipping each additional item if the same buyer purchases multiple quantity of the same order line item and uses the shipping service specified in the corresponding ShippingServiceName field. The seller should always supply this value for multiple-quantity, fixed-price listings. Sometimes, the seller will give the buyer a shipping discount if that buyer purchases multiple quantity of the same order line item, so this value should usually be less than the value set for ShippingServiceCost.

The value of this field can even be set to 0 by the seller 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 order 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.

Note: The seller is expected to provide the ShippingServiceAdditionalCost value for all multiple-quantity, fixed-price listings, but it is not a required field when creating, revising or relisting an item. So, if the ShippingServiceAdditionalCost is not returned in GetShippingCosts, it is likely that the seller has not provided this value, in which case the corresponding ShippingServiceCost value may be inaccurate if the user specifies an integer value greater than '1' in the QuantitySold of the call request.
See the Field Index to learn which calls use ShippingServiceAdditionalCost.

ShippingServiceCost ( AmountType (double) ) [0..1]
The cost to ship the quantity of items specified in the QuantitySold field in the call request. If the QuantitySold field is omitted, its value defaults to 1. For example, if the corresponding shipping service charges 5.99 to ship a quantity of 1, and 2.99 to ship each additional unit beyond the first unit, the cost shown in this field will be 8.98 (5.99 + 2.99) if the QuantitySold field in the call request is set to 2. The corresponding ShippingServiceAdditionalCost field shows the cost to ship each additional item if the buyer purchases multiple quantity of the same order line item.

Note: The seller is expected to provide the ShippingServiceAdditionalCost value for all multiple-quantity, fixed-price listings, but it is not a required field when creating, revising or relisting an item. So, if the ShippingServiceAdditionalCost is not returned in GetShippingCosts, it is likely that the seller has not provided this value, in which case the ShippingServiceCost value may be inaccurate if the user specifies an integer value greater than '1' in the QuantitySold of the call request.
See the Field Index to learn which calls use ShippingServiceCost.

ShippingServiceCutOffTime ( dateTime ) [0..1]
This field is no longer applicable and should not be returned for any international shipping service option.
See the Field Index to learn which calls use ShippingServiceCutOffTime.

ShippingServiceName ( token ) [0..1]
The name of an international shipping service option available to ship the item to specified international shipping destination. This field is always returned with each InternationalShippingServiceOption container.

Note: If the seller is using eBay's Global Shipping Program (GSP) to ship the item to the international location, the string value returned in this field is 'International Priority Shipping'.
See the Field Index to learn which calls use ShippingServiceName.

ShippingServicePriority ( int ) [0..1]
This integer value indicates the seller-preferred presentation order of the international shipping service options. A shipping service option with a ShippingServicePriority value of '1' indicates that the shipping service appears in the first position on the listing's View Item and Checkout page. Generally, both the domestic and international shipping service options are returned in order in the GetShippingCosts response. A seller can specify up to five international shipping service options (including the Global Shipping Program option). This field should always be returned with each InternationalShippingServiceOption container.
See the Field Index to learn which calls use ShippingServicePriority.

ShipsTo ( string ) [0..*]
An international location or region to which the item may be shipped via this particular shipping service. These 'ship-to' locations are provided by the seller when they create, revise, or relist their item, or they can be controlled through a Shipping Business Policy associated with the listing. At a bare minimum, the country of the location specified through the DestinationCountryCode field of the call request shall be returned in this field, and possibly many other countries that are serviced by this shipping service option (or GSP).
See the Field Index to learn which calls use ShipsTo.