eBay Trading APIVersion 1019

CalculatedShippingRateType

Details pertinent to one or more items for which calculated shipping (or flat rate shipping using shipping rate tables with weight surcharges) has been offered by the seller, such as package dimension and weight and packaging/handling costs. Also returned with the data for an item's transaction.

Note: The CalculatedShippingRate container should only be used to specify values for the InternationalPackagingHandlingCosts, OriginatingPostalCode, and/or PackagingHandlingCosts fields. The rest of the fields in the CalculatedShippingRate container should now be specified in the ShipPackageDetails container instead.

Type that uses CalculatedShippingRateType:

Calls that use CalculatedShippingRateType:

Fields



InternationalPackagingHandlingCosts ( AmountType (double) ) [0..1]
Fees a seller might assess for the shipping of the item (in addition to whatever the shipping service might charge). Any packaging/handling cost specified on input is added to each shipping service on output.

If domestic and international calculated shipping is offered for an item and if packaging/handling cost is specified only for domestic shipping, that cost will be applied by eBay as the international packaging/handling cost. (To specify a international packaging/handling cost, you must always specify a domestic packaging/handling cost, even if it is 0.) For international calculated shipping only.
See the Field Index to learn which calls use InternationalPackagingHandlingCosts.

MeasurementUnit ( MeasurementSystemCodeType ) [0..1]
Note: The value for MeasurementUnit should now be specified in the ShippingPackageDetails container instead. If the MeasurementUnit field is passed in the CalculatedShippingRate container and in the ShippingPackageDetails container, the value in the ShippingPackageDetails container will take precedence.
Specifies the unit type of the weight and dimensions of a shipping package. If MeasurementUnit is used, its value will override the system specified through a measurementSystem attribute in dimension and/or weight-related fields. If neither a MeasurementUnit value nor a measurementSystem attribute are specified, the following defaults will be used:

English: US
Metric: CA, CA-FR, AU

CA and CA-FR support both English and Metric, while other sites only support the site's default.

Use MeasurementUnit with weight and package dimensions. For example, to represent a 5 lbs 2 oz package:

<MeasurementUnit>English</MeasurementUnit>
<WeightMajor>5</WeightMajor>
<WeightMinor>2</WeightMinor>
See the Field Index to learn which calls use MeasurementUnit.

OriginatingPostalCode ( string ) [0..1]
Postal code for the location from which the package will be shipped. Required for calculated shipping. Use Item.PostalCode to specify the location of the item used for searches by location.
See the Field Index to learn which calls use OriginatingPostalCode.

PackagingHandlingCosts ( AmountType (double) ) [0..1]
Fees a seller might assess for the shipping of the item (in addition to whatever the shipping service might charge). Any packaging/handling cost specified on input is added to each shipping service on output.

If domestic and international calculated shipping is offered for an item and if packaging/handling cost is specified only for domestic shipping, that cost will be applied by eBay as the international packaging/handling cost. (To specify a international packaging/handling cost, you must always specify a domestic packaging/handling cost, even if it is 0.) When UPS is one of the shipping services offered by the seller, package dimensions are required on list/relist/revise. For calculated shipping only.
See the Field Index to learn which calls use PackagingHandlingCosts.

ShippingIrregular ( boolean ) [0..1]
Note: The value for ShippingIrregular should now be specified in the ShippingPackageDetails container instead. If the ShippingIrregular field is passed in the CalculatedShippingRate container and in the ShippingPackageDetails container, the value in the ShippingPackageDetails container will take precedence. This field may be deprecated in the future.
This boolean field indicates that the shipping package is considered an irregular shape and/or size by the shipping carrier, and thus requires special handling. For calculated shipping only.
See the Field Index to learn which calls use ShippingIrregular.