Skip to main content
Published: February 27 2007, 5:32:00 PMUpdated: November 28 2020, 3:19:41 PM

How to specify separate Insurance details for Domestic and International Shipping

Specifying separate Insurance details for Domestic and International Shipping

Detailed Description

The ability to specify separate insurance details for your Domestic shipping and International shipping was introduced in the 477 API release.
In order to specify separate Insurance details, AddItem requests must place the domestic insurance infromation in the InsuranceDetails container.
Before it became possible to specify separate insurance for domestic and international shipping, the insurance could be specified simply in ShippingDetails.InsuranceFee and ShippingDetails.InsuranceOption like this:

    <Item>
         ...
         <ShippingDetails>
              <InsuranceFee>1.3500</InsuranceFee>
              <InsuranceOption>Optional</InsuranceOption>
              ...
         </ShippingDetails>
         ...
    </Item>

If you took the above implementation and tried to use the separate insurance for international shipping feature by simply adding a InternationalInsuranceDetails container like this:

    <Item>
         ...
         <ShippingDetails>
              <InsuranceFee>1.3500</InsuranceFee>
              <InsuranceOption>Optional</InsuranceOption>
              ...
              <InternationalInsuranceDetails>
                   <InsuranceFee>0</InsuranceFee>
                   <InsuranceOption>NotOffered</InsuranceOption>
              </InternationalInsuranceDetails>
         </ShippingDetails>
         ...
    </Item>

what you would find is that effectively your InsuranceFee and InsuranceOption values indicated directly under the ShippingDetails container would get silently ignored, and your listing would go up with no insurance offered even for your domestic shipping.
Obviously this is not what you wanted.
The correct way to implement separate domestic and international insurance would be like this:

    <Item>
         ...
         <ShippingDetails>
              <InsuranceDetails>
                   <InsuranceFee>1.3500</InsuranceFee>
                   <InsuranceOption>Optional</InsuranceOption>
              </InsuranceDetails>
              ...
              <InternationalInsuranceDetails>
                   <InsuranceFee>0</InsuranceFee>
                   <InsuranceOption>NotOffered</InsuranceOption>
              </InternationalInsuranceDetails>
         </ShippingDetails>
         ...
    </Item>

You must put the domestic insurance details in an InsuranceDetails container.
This is an important point to remember, since failing to do this correctly will not return an error.


Version Info

This article is based on the following versions:

API Version 477 and above


Additional Resources

 

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