On July 1, 2021, the 27 countries of the European Union (EU) will implement new value-added tax (VAT) rules on e-commerce sales that affects the sales of goods to EU consumers through online stores including Amazon. Selling partners shipping to the EU from non-EU countries must provide an Import One-Stop Shop (IOSS) Number to their carrier where Amazon has collected the VAT on the sale. To support this change, we have updated Amazon Marketplace Web Services (MWS) and Selling Partner API (SP-API) to surface IOSS Number for applicable orders.
The IOSS number will be returned in the Orders API and the Reports API.
Orders API
Today, in OrdersV0 for Selling Partner API, the getOrderItems
operation returns the IOSS number within the OrderItemList
element for applicable orders.
In Amazon Marketplace Web Services (MWS), the Orders - Version 2013-09-01 section uses the ListOrderItems
operation to return the IOSS number within the OrderItemList
element for applicable orders.
The IOSS Number attribute is part of the OrderItem
datatype. For more information, see the Selling Partner API for Orders Reference Guide.
Attribute details:
Sample API Response
<?xml version="1.0"?>
<ListOrderItemsResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
<ListOrderItemsResult>
<AmazonOrderId>999-9999999-999999999</AmazonOrderId>
<OrderItems>
<OrderItem>
<QuantityOrdered>2</QuantityOrdered>
<Title>Echden - Pellicola Protettiva in Vetro temperato per Fotocamera 3D, 9H</Title>
<PromotionDiscount>
<Amount>0.00</Amount>
<CurrencyCode>EUR</CurrencyCode>
</PromotionDiscount>
<ConditionId>New</ConditionId>
<IsGift>false</IsGift>>
<ASIN>B07VG6HK1B</ASIN>>
<SellerSKU>B07VG6HK1B _mfn</SellerSKU>
<OrderItemId>00860440070822</OrderItemId>
<IsTransparency>false</IsTransparency>
<ProductInfo>
<NumberOfItems>1</NumberOfItems>
</ProductInfo>
<IossNumber>>IMXXXYYYYYYZ</IossNumber>
<QuantityShipped>1</QuantityShipped>
<ConditionSubtypeId>New</ConditionSubtypeId>
<ItemPrice>
<Amount>22.68</Amount>
<CurrencyCode>EUR</CurrencyCode>
</ItemPrice>
<ItemTax>
<Amount>3.94</Amount>
<CurrencyCode>EUR</CurrencyCode>
</ItemTax>
<PromotionDiscountTax>
<Amount>0.00</Amount>
<CurrencyCode>EUR</CurrencyCode>
</PromotionDiscountTax>
</OrderItem>
</OrderItems>
</ListOrderItemsResult>
<ResponseMetadata>
<RequestId>RequestId</RequestId>
</ResponseMetadata>
</ListOrderItemsResponse>
Reports
The IOSS Number will be added, for applicable orders, to the following reports for selling partners who add the IOSS Number column on the Add or remove order report columns page in Seller Central:
Flat File Reports:
ioss-number
XML Report:
<Item>
…….
<IossNumber>IMXXXYYYYYYZ</IossNumber>
</Item>
<OrderItem>
…….
<IossNumber>IMXXXYYYYYYZ</IossNumber>
</OrderItem>
This change applies to all marketplaces where seller-fulfilled orders are shipped to the 27 countries in the EU.
The 27 countries within the EU are Austria, Belgium, Bulgaria, Croatia, Cypress, Czechia, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, and Sweden.
Developers with applications that enable shipping seller-fulfilled orders to any of the 27 countries in the EU are affected by this change.
If you are affected by this change, update your application workflow so that selling partners shipping to an EU country from a non-EU country can view and retrieve the IOSS number to pass it on to their carrier where Amazon has collected VAT on the sale.
See the Seller Central Help article titled, EU VAT on e-Commerce (EU VOEC) Legislation - 2021
On July 1, 2021, the 27 countries of the European Union (EU) will implement new value-added tax (VAT) rules on e-commerce sales that affects the sales of goods to EU consumers through online stores including Amazon. Selling partners shipping to the EU from non-EU countries must provide an Import One-Stop Shop (IOSS) Number to their carrier where Amazon has collected the VAT on the sale. To support this change, we have updated Amazon Marketplace Web Services (MWS) and Selling Partner API (SP-API) to surface IOSS Number for applicable orders.
The IOSS number will be returned in the Orders API and the Reports API.
Orders API
Today, in OrdersV0 for Selling Partner API, the getOrderItems
operation returns the IOSS number within the OrderItemList
element for applicable orders.
In Amazon Marketplace Web Services (MWS), the Orders - Version 2013-09-01 section uses the ListOrderItems
operation to return the IOSS number within the OrderItemList
element for applicable orders.
The IOSS Number attribute is part of the OrderItem
datatype. For more information, see the Selling Partner API for Orders Reference Guide.
Attribute details:
Sample API Response
<?xml version="1.0"?>
<ListOrderItemsResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
<ListOrderItemsResult>
<AmazonOrderId>999-9999999-999999999</AmazonOrderId>
<OrderItems>
<OrderItem>
<QuantityOrdered>2</QuantityOrdered>
<Title>Echden - Pellicola Protettiva in Vetro temperato per Fotocamera 3D, 9H</Title>
<PromotionDiscount>
<Amount>0.00</Amount>
<CurrencyCode>EUR</CurrencyCode>
</PromotionDiscount>
<ConditionId>New</ConditionId>
<IsGift>false</IsGift>>
<ASIN>B07VG6HK1B</ASIN>>
<SellerSKU>B07VG6HK1B _mfn</SellerSKU>
<OrderItemId>00860440070822</OrderItemId>
<IsTransparency>false</IsTransparency>
<ProductInfo>
<NumberOfItems>1</NumberOfItems>
</ProductInfo>
<IossNumber>>IMXXXYYYYYYZ</IossNumber>
<QuantityShipped>1</QuantityShipped>
<ConditionSubtypeId>New</ConditionSubtypeId>
<ItemPrice>
<Amount>22.68</Amount>
<CurrencyCode>EUR</CurrencyCode>
</ItemPrice>
<ItemTax>
<Amount>3.94</Amount>
<CurrencyCode>EUR</CurrencyCode>
</ItemTax>
<PromotionDiscountTax>
<Amount>0.00</Amount>
<CurrencyCode>EUR</CurrencyCode>
</PromotionDiscountTax>
</OrderItem>
</OrderItems>
</ListOrderItemsResult>
<ResponseMetadata>
<RequestId>RequestId</RequestId>
</ResponseMetadata>
</ListOrderItemsResponse>
Reports
The IOSS Number will be added, for applicable orders, to the following reports for selling partners who add the IOSS Number column on the Add or remove order report columns page in Seller Central:
Flat File Reports:
ioss-number
XML Report:
<Item>
…….
<IossNumber>IMXXXYYYYYYZ</IossNumber>
</Item>
<OrderItem>
…….
<IossNumber>IMXXXYYYYYYZ</IossNumber>
</OrderItem>
This change applies to all marketplaces where seller-fulfilled orders are shipped to the 27 countries in the EU.
The 27 countries within the EU are Austria, Belgium, Bulgaria, Croatia, Cypress, Czechia, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, and Sweden.
Developers with applications that enable shipping seller-fulfilled orders to any of the 27 countries in the EU are affected by this change.
If you are affected by this change, update your application workflow so that selling partners shipping to an EU country from a non-EU country can view and retrieve the IOSS number to pass it on to their carrier where Amazon has collected VAT on the sale.
See the Seller Central Help article titled, EU VAT on e-Commerce (EU VOEC) Legislation - 2021
On July 1, 2021, the 27 countries of the European Union (EU) will implement new value-added tax (VAT) rules on e-commerce sales that affects the sales of goods to EU consumers through online stores including Amazon. Selling partners shipping to the EU from non-EU countries must provide an Import One-Stop Shop (IOSS) Number to their carrier where Amazon has collected the VAT on the sale. To support this change, we have updated Amazon Marketplace Web Services (MWS) and Selling Partner API (SP-API) to surface IOSS Number for applicable orders.
The IOSS number will be returned in the Orders API and the Reports API.
Orders API
Today, in OrdersV0 for Selling Partner API, the getOrderItems
operation returns the IOSS number within the OrderItemList
element for applicable orders.
In Amazon Marketplace Web Services (MWS), the Orders - Version 2013-09-01 section uses the ListOrderItems
operation to return the IOSS number within the OrderItemList
element for applicable orders.
The IOSS Number attribute is part of the OrderItem
datatype. For more information, see the Selling Partner API for Orders Reference Guide.
Attribute details:
Sample API Response
<?xml version="1.0"?>
<ListOrderItemsResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
<ListOrderItemsResult>
<AmazonOrderId>999-9999999-999999999</AmazonOrderId>
<OrderItems>
<OrderItem>
<QuantityOrdered>2</QuantityOrdered>
<Title>Echden - Pellicola Protettiva in Vetro temperato per Fotocamera 3D, 9H</Title>
<PromotionDiscount>
<Amount>0.00</Amount>
<CurrencyCode>EUR</CurrencyCode>
</PromotionDiscount>
<ConditionId>New</ConditionId>
<IsGift>false</IsGift>>
<ASIN>B07VG6HK1B</ASIN>>
<SellerSKU>B07VG6HK1B _mfn</SellerSKU>
<OrderItemId>00860440070822</OrderItemId>
<IsTransparency>false</IsTransparency>
<ProductInfo>
<NumberOfItems>1</NumberOfItems>
</ProductInfo>
<IossNumber>>IMXXXYYYYYYZ</IossNumber>
<QuantityShipped>1</QuantityShipped>
<ConditionSubtypeId>New</ConditionSubtypeId>
<ItemPrice>
<Amount>22.68</Amount>
<CurrencyCode>EUR</CurrencyCode>
</ItemPrice>
<ItemTax>
<Amount>3.94</Amount>
<CurrencyCode>EUR</CurrencyCode>
</ItemTax>
<PromotionDiscountTax>
<Amount>0.00</Amount>
<CurrencyCode>EUR</CurrencyCode>
</PromotionDiscountTax>
</OrderItem>
</OrderItems>
</ListOrderItemsResult>
<ResponseMetadata>
<RequestId>RequestId</RequestId>
</ResponseMetadata>
</ListOrderItemsResponse>
Reports
The IOSS Number will be added, for applicable orders, to the following reports for selling partners who add the IOSS Number column on the Add or remove order report columns page in Seller Central:
Flat File Reports:
ioss-number
XML Report:
<Item>
…….
<IossNumber>IMXXXYYYYYYZ</IossNumber>
</Item>
<OrderItem>
…….
<IossNumber>IMXXXYYYYYYZ</IossNumber>
</OrderItem>
This change applies to all marketplaces where seller-fulfilled orders are shipped to the 27 countries in the EU.
The 27 countries within the EU are Austria, Belgium, Bulgaria, Croatia, Cypress, Czechia, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, and Sweden.
Developers with applications that enable shipping seller-fulfilled orders to any of the 27 countries in the EU are affected by this change.
If you are affected by this change, update your application workflow so that selling partners shipping to an EU country from a non-EU country can view and retrieve the IOSS number to pass it on to their carrier where Amazon has collected VAT on the sale.
See the Seller Central Help article titled, EU VAT on e-Commerce (EU VOEC) Legislation - 2021