DutyCalculator checkout widget

 

The DutyCalculator Checkout Widget provides international customers with an accurate estimate of any import duty & taxes due, without leaving the checkout process. Now the customer can make informed purchase decisions, with the confidence that they will not face any unexpected customs charges. Advantages for the merchant are a better customer experience and reduced return shipments and unpaid custom charges.

Here you can try out the Dutycalculator Checkout Widget:

Use of the DutyCalculator Checkout widget requires an API key. You can request an API key by contacting DutyCalculator team at DutyCalculator@bundletech.com. The widget API key is restricted to be used from certain domains, which should be specified in the request for an API key. Use of the DutyCalculator Checkout widget is currently free of charge.

 

DutyCalculator Checkout Widget integration - Version 0.4

The DutyCalculator Checkout widget is made on the basis of iframe-container and popup windows. In order to integrate the DutyCalculator Checkout widget the iframe HTML code should be placed on the page where the widget is supposed to be displayed. The src attribute of the iframe should refer to the URI of the following format:

http://www.dutycalculator.com/widget/{widget-API-key}/ \
?background={background color hex code or 'transparent' value} \
&font={font name to be used} \
&text-color={text color hex code} \
&link-color={link color hex code} \
&no-logo={indicates that DutyCalculator logo should not be displayed} \
&merchant-name={name of merchant to be displayed in widget} \
&from={ISO alpha-3 or ISO alpha-2 country code} \
&to={ISO alpha-3 or ISO alpha-2 country code} \
&province={ISO alpha-2 province code in 'importing to' country} \
&shipping={shipping & handling cost} \
&insurance={insurance cost} \
&shipment_wt={total shipment weight} \
&shipment_wt_unit={shipment weight unit} \
&currency={ISO alpha-3 currency code of the products values, shipping cost, insurance cost} \
&id[0]={client referenced item id} \
&title[0]={client referenced item description} \
&manufacture[0]={ISO alpha-3 or ISO alpha-2 country code, item's country of manufacture} \
&value[0]={total item value} \
&qty[0]={item quantity} \
&wt[0]={item weight} \
&wt_unit[0]={item weight unit} \
&amt[0]={item amount} \
&amt_unit[0]={item amount unit} \
&id[1]={client referenced item id} \
&title[1]={client referenced item description} \
manufacture[0]={ISO alpha-3 or ISO alpha-2 country code, item's country of manufacture} \
&value[1]={total item value} \
&qty[1]={item quantity} \
...
{repeat for all items}

 

 

Parameters background, font, text-color, link-color, no-logo are optional. If left out the default DutyCalculator Checkout widget style will be used.

Parameter province is optional. If left out user will be asked to select province on classification popup. Parameter province is currently only required if the ‘importing to’ country is Canada where provincial sales taxes rates are used in calculations.

The parameters wt (weight), amt (amount), amt_unit (amount unit) are only required for some products.

Parameter amt_unit accepts values "m3", "cm3", "in3", "l", "pcs" (pieces), "doz" (dozen), "gr" (gross), "pairs", "jwl" (number of jewels) and "m2". The actual required value of amt_unit depends on the 'import to' country and and the DutyCalculator Item ID values (see table below). Parameters wt, amt and amt_unit are used to determine whether special duty rules should be applied to the shipment/product and also determine the import duty & sales taxes if they are applied.

DutyCalculator Category

Parameters requirement by import to country

Antiques, Art & Collectibles

 

Baby, Children & Toys

-   Weight (default value is 1kg) for some clothing items (USA)

-   Pairs (default value = 1) for shoes (USA)

Bags, Shoes, Watches & Accessories

-   Weight (default value is 1kg) for some clothing items (USA)

-   Pairs (default value = 1) for shoes (USA)

-   Pieces (default value = "item quantity") for some items (USA)

Books, Movies, Music & Instruments

 

Car Parts, DIY & Tools

-   Pieces (default value = "item quantity") for some items (USA)

-   Dozen (default value = 1) for very few items (USA)

Cars & Motorcycles

 

Clothes

-   Weight (default value is 1kg) for some clothing items (USA)

Computer & Office

-   Pieces (default value = "item quantity") for some items (USA)

-   Gross (default value = 1) for very few items (USA)

Electronics & Games

-   Weight (default value is 1kg) for some items (USA)

Health & Beauty

-   Weight (default value is 1kg) for some items (USA)

-   Liter (l) (default value is 1 liter) for beverages (USA)

-   Pieces (default value = "item quantity") for some items (USA)

Home & Garden

-   Weight (default value is 1kg) for some items (USA)

-   Liter (l) (default value is 1 liter) for beverages (USA)

-   Pieces (default value = "item quantity") for some items (USA)

Sports & Leisure

-   Pieces (default value = "item quantity") for some items (USA)

-   Gross (default value = 1) for very few items (USA)



Parameters shipment_wt and shipment_wt_unit are optional. If left out user will be asked to enter shipment weight on classification popup. Shipment weight parameters are currently only used if the 'importing to' country is Brazil and import CIF exceeds US$3000.

The DutyCalculator uses the Parameter id (client referenced item id) to store user classifications for a product and auto-suggest the classification to the next user that wants to estimate the import duty & taxes for the same product. Once 10 users have selected the same DutyCalculator category for a product, that classification is used going forwards and  the widget will provide the import duty & tax estimate at once when widget is loaded.

If a merchant is unable to provide a unique product reference in the API, the parameter id (client referenced item id) should be omitted from the widget query (it needs to be left out,  it is not enough to give it an empty value) and the product title is assumed as product id and performs the same function.

Item's country of manufacture is required to determine if any Anti Dumping Duties apply. If left out (doesn't only have empty value, but is omitted in the widget query), the "from country" is assumed as country of manufacture.

 

Integration example

The following code shows the example of the widget integration for two products:

<iframe width="291" height="70" frameborder="0" src="http://www.dutycalculator.com/widget/{widget-API-key}/?merchant-name=widget&from=usa&to=gbr&shipping=11.28&insurance=0&currency=usd&title[0]=ipad+2&id[0]=ipad2_32gb_3g&value[0]=650&origin[0]=chn&qty[0]=1&title[1]=handbag&id[1]=handbag_042&value[1]=650&origin[1]=chn&qty[1]=1"></iframe>


Widget look in case the estimate based on previous products classifications can not be provided and user should choose product customs categories is displayed on Fig. 1.

Widget 1.png

Figure 1.


Classification popup allows (Fig. 2) user to select categories for the products. Categories for some products can be prefilled (as for 'handbag' product) with the values from the DutyCalculator database that correspond to the selections made for the product in question by other users.


widget 2.png

Figure 2.


The estimate result screen is shown on Fig. 3. It includes import duty, excise (if levied) and VAT calculations, calculation key assumptions (products categories, shipping and insurance costs), link to the classification screen, link to the help page with the explanation on the import taxes for the destination country as well as additional notes on duty and VAT for the buyer to explain the calculation results (in case of duty free items, minimum thresholds or imports within the same customs zone).


widget 3.png

Figure 3.


When the estimate is available the widget iframe changes to the state displayed on Fig. 4.


widget 4.png

Figure 4.


Widget look in case the estimate based on previous products classifications is possible and provided is the same as on Fig. 4. However user can edit the classification of the products by clicking 'See details' link and proceeding to the classification screen from the estimate results screen.

In case DutyCalculator does not support the destination country, or in case of any error, the standard warning message appears in the widget iframe (Fig. 5).


widget 5.png

Figure 5.


 

 

Cookies help us to improve our services and deliver these to you. Read moreOK