🚀 How to Set Up the TUNL WooCommerce Plugin (Beta)

Welcome to the beta of the TUNL WooCommerce Plugin! 🎉

This guide will walk you through the steps to connect your WooCommerce store to TUNL so you can start showing live international shipping rates (with duties & taxes included) at checkout.

✅ What You’ll Need Before You Start

• Access to your WooCommerce Admin Dashboard
• A TUNL account (sign in at app.tunl.to)
• Product weights, dimensions, and HS codes (for accurate duties & tax calculation)

🎥 Video Walkthrough

To make it even easier to understand how the WooCommerce Live Rates at Checkout feature works, we’ve created a quick video walkthrough.

🛠️ How to Get Started

Step 1: Download & Install the Plugin

1. In your TUNL dashboard, go to Settings → Integrations → WooCommerce.
2. Click Download Plugin (.zip).
3. In your WooCommerce Admin, go to Plugins → Add New → Upload Plugin.
4. Upload the ZIP, then click Install Now and Activate.

Step 2: Generate Your API Token

1. Go back to TUNL
2. Enter your WordPress website URL e.g. https://www.mystore.com
3. Click Generate Token
4. Click Approve
5. Copy the token (click the copy icon — you’ll need it in the next step).

Step 3: Connect WooCommerce to TUNL

1. In WooCommerce Admin, go to Settings → TUNL Plugin.
2. Paste your API token into the field provided.
3. Click Save API Token.

Step 4: Prepare Your Products

For rates to display correctly, each product needs:

• HS Code:

1. Edit a product in WooCommerce.
2. Go to the Attributes section → add attribute called hs_code.
3. Enter the correct HS code and save.

• Country of Origin:

1. Edit a product in WooCommerce.
2. Go to the Attributes section → add attribute called country_of_origin.
3. Enter the correct 2-letter country code (e.g. ZA) and save.

• Weight & Dimensions:

1. While editing a product, go to the Shipping tab.
2. Enter Weight (kg) and Dimensions (L × W × H in cm).
3. Save.

⚠️ Important: Without HS codes and shipping details, rates and duties will not display. Your WooCommerce store should be configured with kg for weight and cm for dimensions.

💡 Tip: For bulk editing, use WooCommerce’s built-in Product CSV Import/Export feature to quickly add or update hs_code and country_of_origin attributes for many products.

Learn more here → WooCommerce Product CSV Importer and Exporter Guide

Step 5: Enable TUNL Shipping Method

1. In WooCommerce, go to Settings → Shipping → Shipping Zones.
2. Edit your international zone (e.g., Rest of the World).
3. Click Add Shipping Method → Choose TUNL Shipping.
4. Save.

Step 6: Choose Services & Duties Settings

1. Back in your TUNL dashboard, go to Settings → Integrations → Rates at Checkout.
2. Select which services you want to offer (Economy, Express).
3. Choose whether to show rates with Duties & Taxes Included (recommended).
4. Click Update TUNL Rates.

🎉 You’re Live!

That’s it! TUNL-powered live rates are now available in your WooCommerce checkout.

• Customers will see transparent international shipping options with duties & taxes included.
• You’ll save time and protect your margins with accurate, automated rates.

🔧 Troubleshooting

• Rates not showing? Double-check that products have HS codes + weight/dimensions.
• Make sure you have the latest version of the tunl-woo zip file.
• Check your WooCommerce store is properly configured with kg for weight and cm for dimensions.
• Still stuck? Contact us via Live Chat, or WhatsApp.

We're compatible with Bobgo! If you're having issues with getting rates, please do the following:

1. Make sure “Don’t return other services rates” is unchecked

• In your WooCommerce store, Bobgo has a setting that prevents other shipping services from returning rates.

This must be unchecked, otherwise TUNL rates may be blocked.

Where to find it:

WooCommerce → Settings → Shipping → Bobgo → Integration settings

2. Add an International Zone in Bobgo (and keep it empty)

• If you’re not able to configure Bobgo rates for international destinations, add an International shipping zone inside Bobgo and set it to No rates.

This prevents Bobgo from overriding or interfering with TUNL’s international rates.

Where to find it:

Bobgo Dashboard → Rates at Checkout → Add Rate / Add Zone → Select International

Below is what it should look like when you're done:

👉 Ready to go? Log in to TUNL and connect your WooCommerce store today.

Updated on: 04/12/2025