ShippingServiceDetailsType
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.
No calls use ShippingServiceDetailsType.
Fields
This field is only returned if'true', and indicates that the corresponding ShippingServiceDetails.ShippingService value is a COD (Cash-On-Delivery) service.
COD shipping services are not supported by all sites.
If returned, this is the shipping service group to which the shipping service belongs. Valid values are found in CostGroupFlatCodeType.
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.
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).
Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data.
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'.
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.
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).
The ID of another shipping service that will be used when a shipping service is deprecated. See also DeprecationDetails.
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.
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.
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).
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.
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.
For future use.
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.
Shipping Package level details for the enclosing shipping service, this complex type replaces the existing ShippingPackage type.
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.
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.
This field is only returned if 'true', and indicates that a shipping surcharge is applicable for this shipping service option.
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.
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.
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.