eBay Trading APIVersion 1125

SetShippingDiscountProfilesRequestType ( AbstractRequestType )

This call enables a seller to create and manage shipping discounts rules. These are the same shipping discount rules that can be created or managed in My eBay Shipping Preferences.

The types of shipping discount rules that can be created and managed with this call include flat-rate shipping rules, calculated shipping rules, and promotional shipping rules. This call can also be used by sellers to set whether or not they allow buyers to combine separate line items into one Combined Invoice order, and how many days they allow buyers to perform that action.

A seller can only create, update, or delete one discount rule type with each call. The action to take (either Add, Update, or Delete) is set and controlled with the ModifyActionCode field.

Call that uses SetShippingDiscountProfilesRequestType:

Fields



CalculatedHandlingDiscount ( CalculatedHandlingDiscountType ) [0..1]
This container allows you to create, update, or delete a calculated handling discount profile.
See the Field Index to learn which calls use CalculatedHandlingDiscount.

CalculatedShippingDiscount ( CalculatedShippingDiscountType ) [0..1]
This container allows you to create, update, or delete a calculated shipping discount profile.
See the Field Index to learn which calls use CalculatedShippingDiscount.

CombinedDuration ( CombinedPaymentPeriodCodeType ) [0..1]
This field is used to specify the number of days after the purchase of an item that the buyer or seller can combine multiple and mutual order line items into one Combined Invoice order. In a Combined Invoice order, the buyer makes one payment for all order line items, hence only unpaid order line items can be combined into a Combined Invoice order.
See the Field Index to learn which calls use CombinedDuration.

CurrencyID ( CurrencyCodeType ) [0..1]
The three-digit code of the currency to be used for shipping discounts on Combined Invoice orders. A discount profile can only be associated with a listing if the CurrencyID value of the profile matches the Item.Currency value specified in a listing. This field is required if the user is adding or updating one or more shipping discount profiles.

Note that There is a currencyID attribute on all SetShippingDiscountProfiles elements involving money. To avoid a call error, be sure to use the same currency type in these attributes as what is set for the CurrencyID field.
See the Field Index to learn which calls use CurrencyID.

FlatShippingDiscount ( FlatShippingDiscountType ) [0..1]
This container allows you to create, update, or delete a flat-rate shipping discount profile.
See the Field Index to learn which calls use FlatShippingDiscount.

InternationalShippingInsurance ( ShippingInsuranceType ) [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 InternationalShippingInsurance.

ModifyActionCode ( ModifyActionCodeType ) [0..1]
This field is used to set which action is being taken (Add, Update, or Delete) in the call. If you are adding a shipping discount rule, you will have to supply a name for that shipping discount profile. If you want to update or delete a shipping discount profile, you'll have to provide the unique identifier of this rule through the corresponding containers. The unique identifiers of these rules can be retrieved with the GetShippingDiscountRules call, or the seller can view these identifiers in My eBay Shipping Preferences.
See the Field Index to learn which calls use ModifyActionCode.

PromotionalShippingDiscountDetails ( PromotionalShippingDiscountDetailsType ) [0..1]
This container allows you to create, update, or delete a promotional shipping discount profile.
See the Field Index to learn which calls use PromotionalShippingDiscountDetails.

ShippingInsurance ( ShippingInsuranceType ) [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 ShippingInsurance.