Skip to main content
Published: April 18 2007, 11:31:00 AMUpdated: November 28 2020, 3:36:45 PM

Now that shipping discount profiles are available, will the seller's original combined shipping preference continue to exist and be available via the API? Are the sellers required to create shipping discount profiles?

Summary

Yes, if the seller had set their combined shipping  preference prior to the availability of Shipping Discount Profiles, they will continue to be available via the API.  You need to make a call to GetShippingDiscountsProfile to be able to get the users preference.  Sellers are not required to create shipping discount profiles and their original preferences continue to exist, till they change it.
 


Detailed Description

As Shipping Discount Profiles are now available, the call GetUserPreferences will no longer return the combined shipping preferences and you need to use the new API call GetShippingDiscountsProfile. 

Here is a sample GetShippingDiscountsProfile API call:
 

<?xml version="1.0" encoding="utf-8"?>

<GetShippingDiscountProfilesRequest xmlns="urn:ebay:apis:eBLBaseComponents">

  <RequesterCredentials>

    <eBayAuthToken>*****</eBayAuthToken>

  </RequesterCredentials>

</GetShippingDiscountProfilesRequest>

Here is a sample response for a seller that has set the combined shipping preferences, but not created any profiles:

<?xml version="1.0" encoding="utf-8"?>

<GetShippingDiscountProfilesResponse xmlns="urn:ebay:apis:eBLBaseComponents">

  <Timestamp>20070418T18:12:29.565Z</Timestamp>

  <Ack>Success</Ack>

  <Version>507</Version>

  <Build>e507_core_Bundled_4487707_R1</Build>

  <CurrencyID>USD</CurrencyID>

  <FlatShippingDiscount>

    <DiscountName>EachAdditionalAmount</DiscountName>

    <DiscountProfile>

      <DiscountProfileID>646342012</DiscountProfileID>

      <EachAdditionalAmount>3.0</EachAdditionalAmount>

    </DiscountProfile>

  </FlatShippingDiscount>

  <CalculatedShippingDiscount>

    <DiscountName>CombinedItemWeight</DiscountName>

    <DiscountProfile>

      <DiscountProfileID>645037012</DiscountProfileID>

    </DiscountProfile>

  </CalculatedShippingDiscount>

  <PromotionalShippingDiscount>false</PromotionalShippingDiscount>

  <CalculatedHandlingDiscount>

    <DiscountName>IndividualHandlingFee</DiscountName>

  </CalculatedHandlingDiscount>

  <ShippingInsurance>

    <InsuranceOption>NotOffered</InsuranceOption>

  </ShippingInsurance>

  <InternationalShippingInsurance>

    <InsuranceOption>NotOffered</InsuranceOption>

  </InternationalShippingInsurance>

  <CombinedDuration>Days_30</CombinedDuration>

</GetShippingDiscountProfilesResponse>

Notice that the preferences are now returned as a discount profile, even though the user has not explicitly created a profile.  You can think of this as a default profile.

If the user has created discount profiles, then the response will return the DiscountProfileName as below:

<?xml version="1.0" encoding="utf-8"?>

<GetShippingDiscountProfilesResponse xmlns="urn:ebay:apis:eBLBaseComponents">

  <Timestamp>20070418T18:12:29.565Z</Timestamp>

  <Ack>Success</Ack>

  <Version>507</Version>

  <Build>e507_core_Bundled_4487707_R1</Build>

  <CurrencyID>USD</CurrencyID>

  <FlatShippingDiscount>

    <DiscountName>EachAdditionalAmount</DiscountName>

    <DiscountProfile>

      <DiscountProfileID>646342012</DiscountProfileID>

      <DiscountProfileName>FlatShip1</DiscountProfileName>

      <EachAdditionalAmount>3.0</EachAdditionalAmount>

    </DiscountProfile>

    <DiscountProfile>

      <DiscountProfileID>646344012</DiscountProfileID>

      <DiscountProfileName>FlatShip2</DiscountProfileName>

      <EachAdditionalAmount>2.0</EachAdditionalAmount>

    </DiscountProfile>

  </FlatShippingDiscount>

  <CalculatedShippingDiscount>

    <DiscountName>CombinedItemWeight</DiscountName>

    <DiscountProfile>

      <DiscountProfileID>645037012</DiscountProfileID>

    </DiscountProfile>

  </CalculatedShippingDiscount>

  <PromotionalShippingDiscount>false</PromotionalShippingDiscount>

  <CalculatedHandlingDiscount>

    <DiscountName>IndividualHandlingFee</DiscountName>

  </CalculatedHandlingDiscount>

  <ShippingInsurance>

    <InsuranceOption>NotOffered</InsuranceOption>

  </ShippingInsurance>

  <InternationalShippingInsurance>

    <InsuranceOption>NotOffered</InsuranceOption>

  </InternationalShippingInsurance>

  <CombinedDuration>Days_30</CombinedDuration>

</GetShippingDiscountProfilesResponse>


Note:

GetUserPreferences will not be able to return the combined shipping preferences, irrespective of whether the seller has created any profiles or not.   You need to use GetShippingDiscountProfiles instead. 

If you are using Schema XML, you need to update your application to version 499 or higher.
If you are using the .NET or the Java SDK, then you should update your application to version 503 or higher.


Version Info

The code example above was based on the versions specified below:

API Schema Version 507


Additional Resources

How well did this answer your question?
Answers others found helpful