Skip to main content

Find the answer to your question

Advanced Search
Published: November 06 2009, 11:50:00 AMUpdated: August 11 2022, 2:06:20 PM
Product

Question

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

 

Answer

In order to drop the field Item.ShiptoLocations, the Item listing must be modified using either the ReviseItem or if ended by 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 switching from International 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>1123</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>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>1123</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

Print

Email this page