Skip to main content
Published: November 06 2009, 11:50:00 AMUpdated: November 28 2020, 8:02:35 PM

How to drop a Item.ShipToLocations field from a listing in a RelistItem or ReviseItem request

In order to drop the field Item.ShiptoLocations, the Item listing must be modified using either the ReviseItem or if ended the RelistItem API. Also the only way you can drop the ShipToLocation for International Shipping is by dropping the entire <InternationalShippingServiceOption> container. It implies that you are swicthing from Internation to Domestic shipping.

In the following example, we initially list an item with ShipToLocations set to WorldWide, but want to remove that in the RelistItem request.

1)  AddItem request:

<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>637</Version>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Item>
    <Country>US</Country>
    <Currency>USD</Currency>
    <Description>ISDA TEST -  FlatSimple</Description>
    <DispatchTimeMax>3</DispatchTimeMax>
    <ListingDuration>Days_7</ListingDuration>
    <Location>San Jose, CA</Location>
    <PaymentMethods>PaymentSeeDescription</PaymentMethods>
    <PaymentMethods>PayPal</PaymentMethods>
    <PayPalEmailAddress>ve2@aol.com</PayPalEmailAddress>
    <PrimaryCategory>
      <CategoryID>2312</CategoryID>
    </PrimaryCategory>
    <Quantity>1</Quantity>
    <StartPrice>1</StartPrice>
    <ListingType>FixedPriceItem</ListingType>
    <Title>ISDA TEST -  FlatSimple</Title>
    <ShippingDetails>
      <ShippingType>Flat</ShippingType>
      <InsuranceDetails>
        <InsuranceOption>Optional</InsuranceOption>
        <InsuranceFee>3.5</InsuranceFee>
      </InsuranceDetails>
      <InternationalInsuranceDetails>
        <InsuranceOption>Required</InsuranceOption>
        <InsuranceFee>5.5</InsuranceFee>
      </InternationalInsuranceDetails>
      <ShippingServiceOptions>
        <ShippingServicePriority>1</ShippingServicePriority>
        <ShippingService>UPS2ndDay</ShippingService>
        <ShippingServiceCost>5</ShippingServiceCost>
        <ShippingServiceAdditionalCost>1</ShippingServiceAdditionalCost>
        <ShippingSurcharge>1</ShippingSurcharge>
      </ShippingServiceOptions>
      <InternationalShippingServiceOption>
        <ShippingServicePriority>1</ShippingServicePriority>
        <ShippingService>USPSPriorityMailInternational</ShippingService>
        <ShippingServiceCost>15</ShippingServiceCost>
        <ShippingServiceAdditionalCost>11</ShippingServiceAdditionalCost>
        <ShipToLocation>Worldwide</ShipToLocation>
      </InternationalShippingServiceOption>
    </ShippingDetails>
    <ReturnPolicy>
      <ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
      <RefundOption>MoneyBack</RefundOption>
      <ReturnsWithinOption>Days_30</ReturnsWithinOption>
      <Description>Text description of return policy details</Description>
      <ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
    </ReturnPolicy>
  </Item>
</AddItemRequest>

2) Now end the item, if you are going to use RelistItem

3)  Now relist the item using RelistItem API.

<?xml version="1.0" encoding="utf-8"?>
<RelistItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <DetailLevel>ReturnAll</DetailLevel>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Version>637</Version>
  <Item>
    <ItemID>120001555466</ItemID>
    <Title>Dropping Intl Shipping</Title>
    <ShipToLocations>US</ShipToLocations>
    <ShippingDetails>
      <ShippingType>Flat</ShippingType>
      <InsuranceDetails>
        <InsuranceOption>Optional</InsuranceOption>
        <InsuranceFee>3.5</InsuranceFee>
      </InsuranceDetails>
      <InternationalInsuranceDetails>
        <InsuranceOption>Required</InsuranceOption>
        <InsuranceFee>5.5</InsuranceFee>
      </InternationalInsuranceDetails>
      <ShippingServiceOptions>
        <ShippingServicePriority>1</ShippingServicePriority>
        <ShippingService>UPS2ndDay</ShippingService>
        <ShippingServiceCost>5</ShippingServiceCost>
        <ShippingServiceAdditionalCost>1</ShippingServiceAdditionalCost>
        <ShippingSurcharge>1</ShippingSurcharge>
      </ShippingServiceOptions>
      <InternationalShippingServiceOption/>
    </ShippingDetails>
  </Item>
</RelistItemRequest>

 

Notice that ShipToLocations is a required field, thus we substitute "WorldWide" with another value by passing in Item.ShipToLocations with "US" as the value.

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