eBay Shopping APIVersion 1085

VATDetailsType

This type is used to display details related to VAT (Value-Added Tax) and Business Seller features.

Note: VAT is not applicable to all countries, including the US. Sellers must be registered as Business Sellers on the site they are selling on in order to use the Business Seller-related fields.

Type that uses VATDetailsType:

Calls that use VATDetailsType:

Fields



BusinessSeller ( boolean ) [0..1]
This field is only returned if set on the listing, and the person making the call owns the listing.
See the Field Index to learn which calls use BusinessSeller.

RestrictedToBusiness ( boolean ) [0..1]
This field is only returned if 'true', and the person making the call owns the listing. The 'Restricted to Business' feature can only be used by registered business sellers on the German, Austrian, and Swiss marketplaces, and only in listing categories that support 'Business-to-Business' listings. In a 'Business-to-Business' listing, the seller restricts sales of their item to users registered on eBay as business users.

The GetCategories Trading API call can be used by the seller (using the eBay marketplace's Site ID value) to see which categories support Business-to-Business listings. A B2BVATEnabled boolean field will be returned as true if a listing category supports Business-to-Business listings.
See the Field Index to learn which calls use RestrictedToBusiness.

VATID ( string ) [0..1]
This is the unique VAT identifier associated with the Business Seller's account. This field will only be returned to Business Sellers who own the specified listing.

Non-Business Sellers will not have a VAT identifier associated with their account, so this field will never be returned for those users.
See the Field Index to learn which calls use VATID.

VATPercent ( float ) [0..1]
This container shows the VAT (Value-added Tax) percentage rate that will be charged to buyers when an item is purchased from the listing.

VAT is not applicable to all countries, including the US. Allowed VAT percentage rates can vary by region/country, so sellers should be aware of the rates they are legally required/allowed to charge, and they are responsible for charging the correct VAT rate.

If VAT is charged on a listing, the seller can choose to print an invoice for the buyer that shows the item's net price, the VAT percentage rate, the VAT amount, and the total price.

This field is returned only if the listing is subject to VAT.

Note: The float value input into an Add/Revise/Relist call can have up to three digits beyond the decimal point (e.g. 12.346).
See the Field Index to learn which calls use VATPercent.

VATSite ( string ) [0..1]
This string value is the Site ID value of the eBay Marketplace where the VAT is applicable and where the seller is registered as a Business Seller.

The eBay sites that support VAT (and their corresponding Site IDs) can be found in the Business Feature Field Differences topic.
See the Field Index to learn which calls use VATSite.