Skip to main content
Published: July 14 2006, 2:53:00 PMUpdated: July 25 2022, 9:49:10 AM

How do I remove or modify only my InternationalShippingServiceOption(s), but not my "domestic" shipping services?

The entire ShippingDetails container should be thought of as 1 entity.
If you want to change any single data point in the ShippingDetails container, you should send in all data points in the container, not just the ones that you want to change.

This is a very important rule to remember. You may notice some exceptions to this rule when you do your own testing of the various combinations of the data points within the ShippingDetails container. Please do not assume any exceptions to the rule that you find are done on purpose or officially supported unless explicitly documented within the eBay Web Services Guide documentation.

As it turns out 1 such exception is Shipping Services (InternationalShippingServices and "domestic" ShippingServices).
At a minimum, you should treat these 2 as a single unit.

In order to remove all InternationalShippingServiceOption containers in an item (meaning that you are not offering any international shipping service options), you should include the following in the ShippingDetails container of the ReviseItem or RelistItem call:

<InternationalShippingServiceOption/>

Please make sure that you also include all other existing data points within the ShippingDetails container in your ReviseItem or RelistItem request. Not doing so may cause other data points to get removed, possibly even the removal of all data points within the ShippingDetails container.

For example, if your Item has the following ShippingDetails container:

  <ShippingDetails>
    <AllowPaymentEdit>true</AllowPaymentEdit>
    <ApplyShippingDiscount>true</ApplyShippingDiscount>
    <InsuranceFee currencyID="USD">3.5</InsuranceFee>
    <InsuranceOption>Optional</InsuranceOption>
    <SalesTax>
      <SalesTaxPercent>7.5</SalesTaxPercent>
      <SalesTaxState>CA</SalesTaxState>
      <ShippingIncludedInTax>false</ShippingIncludedInTax>
    </SalesTax>
    <SellerPostalCode>95125</SellerPostalCode>
    <ShippingServiceOptions>
      <ShippingService>USPSPriority</ShippingService>
      <ShippingServiceCost currencyID="USD">5.0</ShippingServiceCost>
      <ShippingServiceAdditionalCost currencyID="USD">0.0</ShippingServiceAdditionalCost>
      <ShippingServicePriority>1</ShippingServicePriority>
      <ExpeditedService>false</ExpeditedService>
      <ShippingTimeMin>2</ShippingTimeMin>
      <ShippingTimeMax>3</ShippingTimeMax>
    </ShippingServiceOptions>
    <ShippingServiceOptions>
      <ShippingService>USPSFirstClass</ShippingService>
      <ShippingServiceCost currencyID="USD">6.0</ShippingServiceCost>
      <ShippingServiceAdditionalCost currencyID="USD">0.0</ShippingServiceAdditionalCost>
      <ShippingServicePriority>2</ShippingServicePriority>
      <ExpeditedService>false</ExpeditedService>
      <ShippingTimeMin>2</ShippingTimeMin>
      <ShippingTimeMax>5</ShippingTimeMax>
    </ShippingServiceOptions>
    <ShippingServiceOptions>
      <ShippingService>USPSExpressMail</ShippingService>
      <ShippingServiceCost currencyID="USD">7.0</ShippingServiceCost>
      <ShippingServiceAdditionalCost currencyID="USD">0.0</ShippingServiceAdditionalCost>
      <ShippingServicePriority>3</ShippingServicePriority>
      <ExpeditedService>true</ExpeditedService>
      <ShippingTimeMin>0</ShippingTimeMin>
      <ShippingTimeMax>1</ShippingTimeMax>
    </ShippingServiceOptions>
    <InternationalShippingServiceOption>
      <ShippingService>USPSEconomyParcel</ShippingService>
      <ShippingServiceCost currencyID="USD">15.5</ShippingServiceCost>
      <ShippingServiceAdditionalCost currencyID="USD">0.0</ShippingServiceAdditionalCost>
      <ShippingServicePriority>1</ShippingServicePriority>
      <ShipToLocation>DE</ShipToLocation>
      <ShipToLocation>GB</ShipToLocation>
    </InternationalShippingServiceOption>
    <InternationalShippingServiceOption>
      <ShippingService>UPSWorldWideExpress</ShippingService>
      <ShippingServiceCost currencyID="USD">19.75</ShippingServiceCost>
      <ShippingServiceAdditionalCost currencyID="USD">0.0</ShippingServiceAdditionalCost>
      <ShippingServicePriority>2</ShippingServicePriority>
      <ShipToLocation>MX</ShipToLocation>
    </InternationalShippingServiceOption>
    <InternationalShippingServiceOption>
      <ShippingService>UPSWorldWideExpedited</ShippingService>
      <ShippingServiceCost currencyID="USD">25.3</ShippingServiceCost>
      <ShippingServiceAdditionalCost currencyID="USD">0.0</ShippingServiceAdditionalCost>
      <ShippingServicePriority>3</ShippingServicePriority>
      <ShipToLocation>Europe</ShipToLocation>
    </InternationalShippingServiceOption>
    <ThirdPartyCheckout>false</ThirdPartyCheckout>
    <TaxTable />
  </ShippingDetails>

and you want to drop the international shipping service options in your ReviseItem or RelistItem call, then you should send in the following ShippingDetails container as part of the call:

  <ShippingDetails>
    <AllowPaymentEdit>true</AllowPaymentEdit>
    <ApplyShippingDiscount>true</ApplyShippingDiscount>
    <InsuranceFee currencyID="USD">3.5</InsuranceFee>
    <InsuranceOption>Optional</InsuranceOption>
    <SalesTax>
      <SalesTaxPercent>7.5</SalesTaxPercent>
      <SalesTaxState>CA</SalesTaxState>
      <ShippingIncludedInTax>false</ShippingIncludedInTax>
    </SalesTax>
    <SellerPostalCode>95125</SellerPostalCode>
    <ShippingServiceOptions>
      <ShippingService>USPSPriority</ShippingService>
      <ShippingServiceCost currencyID="USD">5.0</ShippingServiceCost>
      <ShippingServiceAdditionalCost currencyID="USD">0.0</ShippingServiceAdditionalCost>
      <ShippingServicePriority>1</ShippingServicePriority>
      <ExpeditedService>false</ExpeditedService>
      <ShippingTimeMin>2</ShippingTimeMin>
      <ShippingTimeMax>3</ShippingTimeMax>
    </ShippingServiceOptions>
    <ShippingServiceOptions>
      <ShippingService>USPSFirstClass</ShippingService>
      <ShippingServiceCost currencyID="USD">6.0</ShippingServiceCost>
      <ShippingServiceAdditionalCost currencyID="USD">0.0</ShippingServiceAdditionalCost>
      <ShippingServicePriority>2</ShippingServicePriority>
      <ExpeditedService>false</ExpeditedService>
      <ShippingTimeMin>2</ShippingTimeMin>
      <ShippingTimeMax>5</ShippingTimeMax>
    </ShippingServiceOptions>
    <ShippingServiceOptions>
      <ShippingService>USPSExpressMail</ShippingService>
      <ShippingServiceCost currencyID="USD">7.0</ShippingServiceCost>
      <ShippingServiceAdditionalCost currencyID="USD">0.0</ShippingServiceAdditionalCost>
      <ShippingServicePriority>3</ShippingServicePriority>
      <ExpeditedService>true</ExpeditedService>
      <ShippingTimeMin>0</ShippingTimeMin>
      <ShippingTimeMax>1</ShippingTimeMax>
    </ShippingServiceOptions>
    <InternationalShippingServiceOption/>
  </ShippingDetails>

Again, the actual behavior at this time does not require you to send in fields other than the ShippingServiceOptions and InternationalShippingServiceOption containers when trying to remove InternationalShippingServices.
However, the safe recommendation is to treat the entire ShippingDetails container as 1 unit.

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

Got thoughts? Click the feedback button – your insights help us improve!