With the Global Shipping Program, the international shipping provider makes use of two item characteristics in determining customs duty, taxes, and whether an item can be shipped to a particular country. Sellers can provide either or both of these two characteristics when listing an item. They're stored as item attributes using the Item.ItemSpecifics container that's available with most Trading API calls that create or update item listings, such as AddItem or ReviseFixedPriceItem. Each instance of Item.ItemSpecifics.NameValueList contains a name/value pair. For the Global Shipping attributes, the names are:

  • <Name>Country Of Manufacture</Name>

    The <Value> provided for Country Of Manufacture should identify the country in which more than 50% of the item's value was created or added.

  • <Name>Harmonized System Code</Name>

    Harmonized System Code is an international standard item classification used to determine customs duty, taxes, and certain restrictions on international shipments.

    The <Value> provided for Harmonized System Code should specify the first 6 digits of the official code corresponding to the item as determined by the U.S. Official Harmonized Tariff Schedule. Use only numeric digits for this value, and omit any decimal point or other separator.

These two attributes are currently optional. For more information about ItemSpecifics, refer to Include Item Specifics.

Multiple Packages

If a shipment for an order is split into two or more packages, the Country Of Manufacture value becomes mandatory. However, in this case it is not provided in ItemSpecifics, but rather in a dedicated field, CountryOfOrigin, using the CompleteSale call. For more information, refer to the reference documentation for CompleteSale.