Skip to main content
Published: March 29 2007, 2:54:00 PMUpdated: November 28 2020, 3:25:19 PM

How can I remove Insurance from a listing?

Removing shipping Insurance from a listing

Detailed Description
When looking at the schema for the InsuranceDetails container in order to remove Insurance from a listing, there can be 4 possible combinations of input.  To illustrate what happens when each combination is used, we will start with this AddItem example that indicates an Optional Shipping Insurance charge:

<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
 <Version>507</Version>
 <ErrorLanguage>en_US</ErrorLanguage>
 <WarningLevel>High</WarningLevel>
 <Item>
   <PrimaryCategory>
     <CategoryID>3833</CategoryID>
   </PrimaryCategory>
   <Country>US</Country>
   <Currency>USD</Currency>
   <Description>This is a test for Shipping Insurance</Description>
   <ListingDuration>Days_7</ListingDuration>
   <Location>Farmington Hills</Location>
   <StartPrice currencyID="USD">0.99</StartPrice>
   <SKU>000-TEST</SKU>
   <PaymentMethods>AmEx</PaymentMethods>
   <Quantity>1</Quantity>
   <Site>US</Site>
   <Title>Shipping Insurance</Title>
   <ListingType>Chinese</ListingType>
   <ShippingDetails>
     <SalesTax>
       <SalesTaxPercent>6.00</SalesTaxPercent>
       <SalesTaxState>MI</SalesTaxState>
     </SalesTax>
     <ShippingServiceOptions>
       <ShippingService>ShippingMethodStandard</ShippingService>
       <ShippingServiceCost>3.50</ShippingServiceCost>
       <ShippingServiceAdditionalCost>2.00</ShippingServiceAdditionalCost>
       <ShippingServicePriority>1</ShippingServicePriority>
     </ShippingServiceOptions>
     <ShippingType>Flat</ShippingType>
     <InsuranceDetails>
       <InsuranceFee currencyID="USD">2</InsuranceFee>
       <InsuranceOption>Optional</InsuranceOption>
     </InsuranceDetails>

   </ShippingDetails>
 </Item>
 <RequesterCredentials>
   <eBayAuthToken>token</eBayAuthToken>
 </RequesterCredentials>
</AddItemRequest>

Here are the results that can be expected when using each combination in a ReviseItem call:

  • ReviseItem call with full ShippingDetails container and <InsuranceOption>NotOffered</InsuranceOption>
    <?xml version="1.0" encoding="utf-8"?>
    <ReviseItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
     <Version>507</Version>
     <ErrorLanguage>en_US</ErrorLanguage>
     <WarningLevel>High</WarningLevel>
     <Item>
       <ItemID>xxx</ItemID>
       <ShippingDetails>
         <SalesTax>
         <SalesTaxPercent>6.00</SalesTaxPercent>
         <SalesTaxState>MI</SalesTaxState>
         </SalesTax>
         <ShippingServiceOptions>
           <ShippingService>ShippingMethodStandard</ShippingService>
           <ShippingServiceCost>3.50</ShippingServiceCost>
           <ShippingServiceAdditionalCost>2.0000</ShippingServiceAdditionalCost>
           <ShippingServicePriority>1</ShippingServicePriority>
         </ShippingServiceOptions>
         <ShippingType>Flat</ShippingType>
         <InsuranceDetails>
           <InsuranceOption>NotOffered</InsuranceOption>
         </InsuranceDetails>
       </ShippingDetails>
     </Item>
     <RequesterCredentials>
       <eBayAuthToken>token</eBayAuthToken>
     </RequesterCredentials>
    </ReviseItemRequest>

    This will correctly remove the Insurance from the listing.
    Please note that this is the recommended way of implementing the removal of Insurance from a listing through the ReviseItem call.
  • ReviseItem call with full ShippingDetails container and <InsuranceOption>NotOffered</InsuranceOption> and <InsuranceFee>0</InsuranceFee>
    <?xml version="1.0" encoding="utf-8"?>
    <ReviseItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
     <Version>507</Version>
     <ErrorLanguage>en_US</ErrorLanguage>
     <WarningLevel>High</WarningLevel>
     <Item>
       <ItemID>xxx</ItemID>
       <ShippingDetails>
         <SalesTax>
         <SalesTaxPercent>6.00</SalesTaxPercent>
         <SalesTaxState>MI</SalesTaxState>
         </SalesTax>
         <ShippingServiceOptions>
           <ShippingService>ShippingMethodStandard</ShippingService>
           <ShippingServiceCost>3.50</ShippingServiceCost>
           <ShippingServiceAdditionalCost>2.0000</ShippingServiceAdditionalCost>
           <ShippingServicePriority>1</ShippingServicePriority>
         </ShippingServiceOptions>
         <ShippingType>Flat</ShippingType>
         <InsuranceDetails>
           <InsuranceOption>NotOffered</InsuranceOption>
           <InsuranceFee>0</InsuranceFee>
         </InsuranceDetails>
       </ShippingDetails>
     </Item>
     <RequesterCredentials>
       <eBayAuthToken>token</eBayAuthToken>
     </RequesterCredentials>
    </ReviseItemRequest>

    At the time of this writing, this will also remove the Insurance from the listing without errors.
    However it is not recommended since the behavior of including <InsuranceFee>0</InsuranceFee> in the ReviseItem request may change without notice.
  • ReviseItem with only the Insurance related field <InsuranceOption>NotOffered</InsuranceOption> in the ShippingDetails container
    <?xml version="1.0" encoding="utf-8"?>
    <ReviseItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
     <Version>507</Version>
     <ErrorLanguage>en_US</ErrorLanguage>
     <WarningLevel>High</WarningLevel>
     <Item>
       <ItemID>xxx</ItemID>
       <ShippingDetails>
         <InsuranceDetails>
           <InsuranceOption>NotOffered</InsuranceOption>
         </InsuranceDetails>
       </ShippingDetails>
     </Item>
     <RequesterCredentials>
       <eBayAuthToken>token</eBayAuthToken>
     </RequesterCredentials>
    </ReviseItemRequest>

    This will remove all ShippingDetails without errors, which is not at all what is intended here.
    Do not attempt to send only InsuranceDetails and nothing else in the ShippingDetails container in a ReviseItem call.
  • ReviseItem with only the Insurance related fields <InsuranceOption>NotOffered</InsuranceOption> and <InsuranceFee>0</InsuranceFee> in the ShippingDetails container
    <?xml version="1.0" encoding="utf-8"?>
    <ReviseItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
     <Version>507</Version>
     <ErrorLanguage>en_US</ErrorLanguage>
     <WarningLevel>High</WarningLevel>
     <Item>
       <ItemID>xxx</ItemID>
       <ShippingDetails>
         <InsuranceDetails>
           <InsuranceOption>NotOffered</InsuranceOption>
           <InsuranceFee>0</InsuranceFee>
         </InsuranceDetails>
       </ShippingDetails>
     </Item>
     <RequesterCredentials>
       <eBayAuthToken>token</eBayAuthToken>
     </RequesterCredentials>
    </ReviseItemRequest>

    This will remove all ShippingDetails without errors, which is not at all what is intended here.
    Do not attempt to send only InsuranceDetails and nothing else in the ShippingDetails container in a ReviseItem call.


Additional Resources

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