eBay Trading API
Version 1359


complexType "ShippingServiceDetailsType"
Namespace:
urn:ebay:apis:eBLBaseComponents
Content:
complex, 22 elements, elem. wildcard
Defined:
in ebaySvc.wsdl/Schema
Includes:
declarations of 22 elements, elem. wildcard
Referenced:
Component Diagram

Content Element Model:
Component
Type / Value
Occurs
Required?
Nillable?
Description
SEQUENCE
1..1
yes
 Description
string
0..1
no
no
Display string that applications can use to present a list of shipping service options in a more user-friendly format (such as in a drop-down list).
 ExpeditedService
boolean
0..1
no
no
Indicates whether a domestic shipping service option is an expedited shipping service. This field is only returned under a ShippingServiceDetails if true. Expedited generally means that the shipment of the order can arrive at the buyer's location within one or two business days.
 InternationalService
boolean
0..1
no
no
Indicates whether the shipping service is an international shipping service. An international shipping service option is required if an item is being shipped from one country (origin) to another (destination).
 ShippingService
token
0..1
no
no
The name of shipping service option. The ShippingServiceDetails.ValidForSellingFlow flag must also be present and true. Otherwise, that particular shipping service option is no longer valid and cannot be offered to buyers through a listing.

This token value is the text that a seller will provide in the ShippingDetails.ShippingServiceOptions.ShippingService field when creating a listing.
 ShippingServiceID
int
0..1
no
no
Numeric identifier. A value greater than 50000 represents an international shipping service (confirmed by InternationalShippingService being true). Some applications use this ID to look up shipping services more efficiently.
 ShippingTimeMax
int
0..1
no
no
The integer value returned here indicates the maximum number of business days that the shipping carrier (indicated in the corresponding ShippingCarrier field) will take to ship an item using the corresponding shipping service option (indicated in the ShippingService field).

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.

For sellers opted into and using eBay Guaranteed Delivery, they should be looking at this value, and this value plus their handling time stated in the listing cannot be greater than 4 business days in order for that listing to be eligible for eBay Guaranteed Delivery.
 ShippingTimeMin
int
0..1
no
no
The integer value returned here indicates the minimum number of business days that the shipping carrier (indicated in the corresponding ShippingCarrier field) will take to ship an item using the corresponding shipping service option (indicated in the ShippingService field).

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.
 ServiceType
ShippingTypeCodeType : enumeration of token
0..∞
no
no
The shipping cost types that this shipping service option supports, such as flat-rate or calculated. A ServiceType field is returned for each shipping cost type supported by the shipping service option.
 ShippingPackage
ShippingPackageCodeType : enumeration of token
0..∞
no
no
The shipping packages that can be used for this shipping service option. A ShippingPackage field is returned for each shipping package supported by the shipping service option.
 DimensionsRequired
boolean
0..1
no
no
This field is only returned if the shipping service option requires that package dimensions are provided by the seller. This field is only returned if 'true'.
 ValidForSellingFlow
boolean
0..1
no
no
If this field is returned as 'true', the shipping service option can be used in a Add/Revise/Relist API call. If this field is returned as 'false', the shipping service option is not currently supported and cannot be used in a Add/Revise/Relist API call.
 SurchargeApplicable
boolean
0..1
no
no
This field is only returned if 'true', and indicates that a shipping surcharge is applicable for this shipping service option.
 ShippingCarrier
ShippingCarrierCodeType : enumeration of token
0..∞
no
no
The enumeration value for the shipping carrier associated with the shipping service option.

Note: Commonly used shipping carriers can also be found by calling GeteBayDetails with DetailName set to ShippingCarrierDetails and examining the returned ShippingCarrierDetails.ShippingCarrier field.
 CODService
boolean
0..1
no
no
This field is deprecated, as there are longer any shipping services that support cash on delivery.
 DeprecationDetails
0..∞
no
no
A mechanism by which details about deprecation of a shipping service is announced. See also MappedToShippingServiceID. If this container is empty, it means that there is no mapping for this shipping service and that the shipping service will be dropped from the listing without an accompanying warning message from the eBay API.
 MappedToShippingServiceID
int
0..1
no
no
The ID of another shipping service that will be used when a shipping service is deprecated. See also DeprecationDetails.
 CostGroupFlat
token
0..1
no
no
If returned, this is the shipping service group to which the shipping service belongs. Valid values are found in CostGroupFlatCodeType.
 ShippingServicePackageDetails
0..∞
no
no
Shipping Package level details for the enclosing shipping service, this complex type replaces the existing ShippingPackage type.
 WeightRequired
boolean
0..1
no
no
If true, a seller who selects this package type for the listing and then offers this shipping service must specify WeightMajor and WeightMinor in the item definition. If not returned, WeightRequired is false.
 DetailVersion
string
0..1
no
no
Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data.
 UpdateTime
dateTime
0..1
no
no
Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data.
 ShippingCategory
token
0..1
no
no
Indicates the shipping category. Shipping categories include the following: ECONOMY, STANDARD, EXPEDITED, ONE_DAY, PICKUP, OTHER, and NONE. International shipping services are generally grouped into the NONE category. For more information about these shipping categories, see the Shipping Basics page on the eBay Shipping Center site.

Note: This field is returned only for those sites that support shipping categories: US (0), CA (2), CAFR (210), UK (3), AU (15), FR (71), DE (77), IT (101) and ES (186).
 {any}
from any namespace
0..∞
no
Description
Type used by the ShippingServiceDetails containers that are returned in the GeteBayDetails response. Each ShippingServiceDetails container consists of detailed information about each shipping service option available for the specified country. These details include the shipping service enumeration value to use when specifying shipping service options in an Add/Revise/Relist call, the shipping carrier, the shipping category (e.g. expedited, economy, etc.), the shipping packages that can be used, and the shipping delivery window.

ShippingServiceDetails containers are returned if a DetailName field is included in the call request and set to ShippingServiceDetails, or if no DetailName field is included in the call request.
Referenced By


WSDL documentation generated with FlexDoc/XML 1.14 using FlexDoc/XML WSDLDoc 2.0 template set. All XSD diagrams generated by FlexDoc/XML DiagramKit.