Skip to main content

Documentation Portal

CountryCoefficient

Parameter Name

Type

Description

Mandatory

CoefficientWithVATType

Decimal

Depending on VATRateType . This value is calculated as follows: 

  • “HideVAT ““HideVAT “→ CoefficientWithVATType = Country coefficient

  • VATType = “PocketVAT”CoefficientWithVATType = Country coefficient * Origin Country (Merchant Country) VAT rate

  • VATType = “ForceVAT “CoefficientWithVATType = Country coefficient * Destination country VAT rate

  • If Merchant Account Settings “DisableVATAdjustmentForShopifyCoefficient“ = True → CoefficientWithVATType  = Country Coefficient 

CountryCode

String

2-char ISO country code

IncludeVAT

Decimal

This attribute is applicable only to the Country level (i.e. not applicable to the Product Class level). One of the possible values of IncludeVATOptions enumeration is designated to control the way VAT is handled in browsing on the Merchant’s site and in checkout on Global‑e. Following is a table with a list of IncludeVATOptions values and the expected results for the sample Product.

No

ProductClassCode

String

Product class code used by the Merchant to classify products for using different country coefficient rates per classes of products instead of the single country level default (when no rate is defined for a certain product class, the country level default rate should be used by the Merchant for the respective product).

Rate

Decimal

Country Coefficient rate decimal value. All the prices displayed to the end customer shipping to the country involved must be multiplied by this value.

The IncludeVATOptions enumeration is designated to control the way VAT is handled in browsing on the Merchant’s site and in checkout on Global‑e.

Following is the list of IncludeVATOptions values and the expected results for the sample Product.

In the table below we are considering a product with the original cost in the UK = 100 GBP before VAT to be shipped to Germany (with country coefficient Rate=1 and user selected currency=GBP, for simplicity).

For this sample product UK VAT=20%, DE Duties Total=17%:

IncludeVAT Option Value

Description

Price In Browsing

Price In

Checkout

Price Paid To Merchant

(incl. VAT)

Checkout

Duties Total

Checkout

Total

0

Hide VAT

(default)

100

100

120

17

117

2

Show VAT

120

100

120

17

117

4

“Pocket” VAT (increase the original price by the value of the respective product’s VAT)

120

120

144

20.4 (17%)

140.4

6

Force VAT

(used to support trade agreements between the countries such as EEA, when the end customer must pay VAT; for simplicity assuming UseCountryVAT=false)

120

120

120

0

120

8

Force & Hide VAT

(used to support trade agreements between the countries such as EEA, when end customer must pay VAT but VAT is not shown in browsing; for simplicity assuming UseCountryVAT=false)

100

120

120

0

120