eBay Business Policies Management APIVersion 1.1.0

ShippingPolicyInfoService

Type defining the shippingPolicyInfoService container, which consists of detailed information for a shipping service option being offered to the buyer.

Type that uses ShippingPolicyInfoService:

Calls that use ShippingPolicyInfoService:

Fields



buyerResponsibleForPickup ( boolean ) [0..1]
This field is only applicable to vehicle categories on eBay Motors (US and Canada).

If this field is included and set to 'true', the buyer is responsible for pickup of the vehicle. If this field is 'false', the seller should specify the vehicle pickup arrangements in the item description.

If the vehicle has bids or the listing ends within 12 hours, the seller cannot modify this flag.

If set for one or more shipping services within the shipping policy, this field is returned with shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.

See the Field Index to learn which calls use buyerResponsibleForPickup.

buyerResponsibleForShipping ( boolean ) [0..1]
This field is only applicable to vehicle categories on eBay Motors (US and Canada).

If this field is included and set to 'true', the buyer is responsible for the shipment of the vehicle. If this field is 'false', the seller should specify the vehicle shipping arrangements in the item description.

If the vehicle has bids or the listing ends within 12 hours, the seller cannot modify this flag.

If set for one or more shipping services within the shipping policy, this field is returned with shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.
See the Field Index to learn which calls use buyerResponsibleForShipping.

codFee ( Amount (double) ) [0..1]
This value indicates the Cash-on-Delivery fee that is due from the buyer upon item delivery. This field is only applicable if the selected payment method is 'COD' and if the selected shipping service option suppports the Cash-on-Delivery option.

To see if a domestic shipping service option supports the Cash-on-Delivery option, call GeteBayDetails, including 'ShippingServiceDetails' as a DetailName value, and then look for a CODService=true flag for the corresponding shipping service.

If a Cash-on-Delivery shipping service is defined for the shipping policy, this field is returned in the shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.
See the Field Index to learn which calls use codFee.

fastShipping ( boolean ) [0..1]
This flag indicates whether or not the seller is offering 'Get It Fast' shipping for the listing. 'Get It Fast' shipping is only available for fixed-price listings and auction listings with an active 'Buy It Now' option.

To enable 'Get It Fast' shipping for a listing, the seller must:
  • offer at least one domestic one-day shipping service option, such as USPS Express Mail, UPS Next Day Air, or FedEx Overnight;
  • set the shippingPolicyInfo.dispatchTimeMax value to '0' or '1', which means that the seller is committing to ship the item within one business day after receiving payment from the buyer. A DispatchTimeMax value of '0' will indicate that the seller is offering same-day shipping.
Although it is not required, it is recommended that sellers also offer an immediate payment option to the buyer, so they can get their item even faster. In the payment policy, this option is turned on with the paymentInfo.immediatePay flag. To enable the immediate payment feature on a listing, the seller must:
  • have a Premier or Business PayPal account;
  • provide a valid Item.PayPalEmailAddress value;
  • offer 'PayPal' as the single payment method in the Item.PaymentMethods field.
The fastShipping field should only be included and set to 'true' in domesticShippingPolicyInfoService containers where the shipping service option is a one-day shipping service. The fastShipping field is not applicable for internationalShippingPolicyInfoService containers.

Not supported for UK Half.com items.

If 'Get It Fast' shipping is set for a domestic shipping service, this field is returned in the shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.
See the Field Index to learn which calls use fastShipping.

freeShipping ( boolean ) [0..1]
This flag is used by the seller to offer free domestic shipping to the buyer. This field can only be included and set to 'true' for the first specified domestic shipping service option (it is ignored if set for any other shipping service option). The first specified shipping service option either has a sortOrderId value of '1', or, if the sortOrderId field is not used, the shipping service option specified first in the API call.

If free shipping is set for a domestic shipping service, this field is returned in the shipping business policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.
See the Field Index to learn which calls use freeShipping.

shippingService ( string ) [1]
A domestic or international shipping service being offered by the seller to ship an item to a buyer.

For a list of valid shippingService values, call GeteBayDetails, including ShippingServiceDetails as a DetailName value, and then look through the ShippingServiceDetails containers returned in the response. International shipping services are marked with an InternationalService flag. All shipping services without this flag are domestic shipping services. The ShippingServiceDetails.ValidForSellingFlow flag must be present for both domestic and international shipping services, otherwise, thatspecific shipping service option is no longer valid and cannot be offered to buyers through a listing.

The seller must specify one shipping service in each domesticShippingPolicyInfoService and internationalShippingPolicyInfoService container in an addSellerProfile or setSellerProfile request. Up to four domestic and five international shipping service may be offered to the buyer per listing.

If 'Get It Fast' shipping is being enabled for the shipping policy (fastShipping=true), the first specified domestic shipping service (specified in the first domesticShippingPolicyInfoService.shippingService field) must be a one-day shipping service. To verify that a domestic shipping service is a one-day shipping service (hence, it qualifies for 'Get It Fast' shipping), call GeteBayDetails, including 'ShippingServiceDetails' as a DetailName value, and then look for a ShippingCategory value of 'ONE_DAY' for the corresponding shipping service. 'Get It Fast' shipping is not available for international shipping.

Each shipping service specified for the shipping policy is returned with shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.
See the Field Index to learn which calls use shippingService.

shippingServiceAdditionalCost ( Amount (double) ) [0..1]
This value sets the cost of shipping each additional item if the buyer purchases multiple identical items in a multi-quantity, fixed-price listing. This field is required for all multi-quantity, fixed-price listings where flat-rate shipping is used.

This value is at the seller's discretion. Generally, it should be the same price or lower than the shippingServiceCost value. The seller may consider specifying a lower price to ship additional items as an incentive to the buyer to purchase multiple items. The seller may also consider a lower price if he/she is able to ship multiple items in the same box. In this scenario, the seller is able to save on shipping costs and passes these savings down to the buyer.

The total shipping costs for an order line item is calculated with the following formula:

Total shipping costs = shippingServiceCost + (shippingServiceAdditionalCost * quantity purchased)

So, if a buyer purchases four identical items, and the seller has specified shippingServiceCost as $6.00 and shippingServiceAdditionalCost as $2.00, the total shipping cost for the order line item is $12.00 ($6.00 + ($2.00 * 3)).

This field is not applicable to calculated shipping.

If set for one or more shipping services within the shipping policy, this field is returned with shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.
See the Field Index to learn which calls use shippingServiceAdditionalCost.

shippingServiceCost ( Amount (double) ) [0..1]
This value sets the cost of shipping for the item if the buyer selects this shipping service option. This field is required in the input for all listings where flat-rate shipping is used, and is not applicable to calculated shipping.

This value is at the seller's discretion but should reflect the approximate cost of the shipping service option plus handling. This value defaults to '0.0' if the freeShipping field is set to 'true'.

The total shipping costs for an order line item is calculated with the following formula:

Total shipping costs = shippingServiceCost + (shippingServiceAdditionalCost * quantity purchased)

So, if a buyer purchases four identical items, and the seller has specified shippingServiceCost as $6.00 and shippingServiceAdditionalCost as $2.00, the total shipping cost for the order line item is $12.00 ($6.00 + ($2.00 * 3)).

This field is always returned (for each shipping service) with shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.
See the Field Index to learn which calls use shippingServiceCost.

shippingSurcharge ( Amount (double) ) [0..1]
An additional charge that US sellers can add to the cost of an order line item if that order line item is an eBay Motors Parts and Accessories item that is being shipped to a buyer in Alaska, Hawaii, or Puerto Rico through a UPS or FedEx shipping service that charges a surcharge to ship to those areas.

In order for sellers to add a shipping surcharge at the shipping service level, the following must be true:
  • a surcharge is applicable for the shipping service (call GeteBayDetails with DetailName set to ShippingServiceDetails, and then look for ShippingServiceDetails.SurchargeApplicable=true in the response;
  • flat-rate shipping is used
If set for one or more shipping services within the shipping policy, this field is returned with shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.
See the Field Index to learn which calls use shippingSurcharge.

shipToLocation ( token ) [0..*]
An international region (such as Asia or Europe) or a country (represented by two-letter country code) to where the seller will ship an item. To obtain valid 'Ship-To locations' for their site, the seller must call GeteBayDetails, using ShipppingLocationDetails as a DetailName value in the request, and then scanning the ShippingLocationDetails.ShippingLocation values that are returned in the response. The shipping regions and countries that may be specified as shipToLocation values will vary according to eBay site. The seller may include as many valid shipToLocation values as necessary based on where they are willing to ship an item.

If no shipToLocation field is included in the domesticShippingPolicyInfoService container when using the addSellerProfile or setSellerProfile calls, eBay will automatically add the seller's listing country as a 'Ship-To Location'.

If the seller does want to offer international shipping as part of the shipping policy, at least one shipToLocation field in the internationalShippingPolicyInfoService container is required when using the addSellerProfile and setSellerProfile calls. To offer shipping to every region and country (supported by eBay shipping services), the seller can pass in 'Worldwide' as a shipToLocation value. If the seller wants to ship to a specific region, but would like to exclude one or more countries in that region, the seller should include that region as a shipToLocation value, but then exclude one or more countries in that region by including one or more instances of the shippingPolicyInfo.excludeShipToLocation field.

Each ship-to location specified for the shipping service is returned with shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.
See the Field Index to learn which calls use shipToLocation.

sortOrderId ( int ) [0..1]
This integer value controls the order (relative to other shipping service options) in which the corresponding shipping service option will appear in the View Item and Checkout pages.

Sellers can specify up to four domestic shipping services (in four separate domesticShippingPolicyInfoService containers), so valid values are 1, 2, 3, and 4. A shipping service option with a sortOrderId value of '1' appears at the top of View Item and Checkout pages. Conversely, a shipping service option with a sortOrderId value of '4' appears at the bottom of a list of four shipping service options.

Sellers can specify up to five international shipping services (in five separate internationalShippingPolicyInfoService containers), so valid values are 1, 2, 3, 4, and 5. Similarly to domesstic shipping service options, the sortOrderId value of a international shipping service option controls the placement of that shipping service option in the View Item and Checkout pages.

If the sortOrderId field is not used, the order of domestic and international shipping service options will be determined by the order they are listed in the API call.

This field is always returned (for each shipping service) with shipping policies returned in the getSellerProfiles, addSellerProfile, or setSellerProfile calls.

See the Field Index to learn which calls use sortOrderId.