🚀 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 Add Integration and Download the TUNL 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. In your TUNL dashboard, under WooCommerce integration, click Generate API Token.
2. 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.

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.
• Still stuck? Contact us via Live Chat, or WhatsApp.

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

Updated on: 04/09/2025