Menu

3 min read

VAT Calculation (Add-on)


How to set up VAT in Shipturtle, from the add-on and your tax details to country-wise VAT rates and vendor tax exemption, and how to read VAT in each payout.

Updated for the current Tax settings  ·  October 2026

⚡Quick Summary

Add the VAT Invoicing & Tax Compliance add-on, enter your tax number in Merchant profile → Billing & invoice, then set everything else in Settings → Setup and configuration → Tax settings: your tax source, standard VAT rate, country-wise VAT rates and vendor tax exemption. Hover over any amount in a payout's Payment breakdown to see the VAT applied.


Who this guide is for

Marketplace owners and admins who sell in VAT countries and need VAT handled correctly on customer invoices, commission or wholesale invoices, and vendor payouts.

What the VAT add-on does

The VAT add-on makes Shipturtle VAT-aware across your marketplace. Once it's set up, Shipturtle:

  • applies VAT to customer orders, either as sent by your store or calculated by Shipturtle,
  • calculates VAT on the invoices between you and your vendors (commission invoices or wholesale invoices),
  • decides, per vendor, whether VAT is removed from their payout (tax exemption), and
  • shows every VAT component in the payout breakdown, so you can check each order.

1. Add the VAT add-on

  1. Go to Settings → Subscription and billing and open the Payouts tab.
  2. Find VAT Invoicing & Tax Compliance and click Add. Once active, the button shows Added.
vc1

The VAT Invoicing & Tax Compliance add-on.

2. Enter your tax details

  1. Go to Settings → Merchant profile and open the Billing & invoice tab.
  2. Enter your Tax number (GST / VAT), and your NIF number if it applies to you.
  3. Scroll down and click Save.

vat2

Merchant profile → Billing & invoice. All business details are blurred.

3. Configure Tax settings

All remaining VAT settings are under Settings → Setup and configuration → Tax settings. They apply at the global level, and some can be overridden for individual vendors from the vendors listing page.

A) How does your platform operate?

Choose Vendor Seller of Record (SoR) or Marketplace Seller of Record (SoR). This decides which invoice carries VAT between you and your vendors: a commission invoice under Vendor SoR, or a wholesale invoice under Marketplace SoR. See Payment flow from customer to vendors for more on selling models.

B) Tax source

Tell Shipturtle whether your store platform (for example, Shopify) already sends tax information with orders:

  • Store sends tax info: Shipturtle uses the tax your store calculated. It checks that tax information, the tax system, and product and shipping tax lines are being received, and shows the detected tax system (GST or VAT).
  • Shipturtle calculates tax: use this when your store doesn't send tax information. Shipturtle calculates taxes internally. Select the tax system your store uses: GST or VAT.

vat3

Store sends tax info: Shipturtle confirms what it detected.

vat4

Shipturtle calculates tax: select your tax system.

C) Tax configuration

Standard VAT rate: the rate used to calculate tax on both the commission and wholesale invoices between you and your vendors (for example, 20%).

Customer-facing settings depend on your tax source:

  • With Store sends tax info, customer tax is calculated by your store and taken as-is, so there's nothing to configure here.
  • With Shipturtle calculates tax, you can tick Charge tax on shipping rates and enter the rate, and set country-wise VAT rates for customer invoices.

vat5

Customer-facing settings when Shipturtle calculates tax.

To add country-wise VAT rates:

  1. Under VAT configuration for customer invoices, click Add VAT rates.
  2. Select a Country, enter the Vat rate %, and click Add.
  3. Repeat for each country you sell to. Use the edit and delete icons to change a rate later.

vat6

Add VAT rates: one rate per country.

⚠️ Note: VAT on product and shipping is calculated from the customer's country of residence. Any country without its own rate uses the Standard VAT rate.


D) Vendor-facing: tax exemption

Tax exemption decides whether tax is removed from a vendor's payout, and whether that decision is made per vendor (Manual) or by Shipturtle (Automatic).

  • Manual: you decide for each vendor.
  • Automatic: Shipturtle decides from the vendor's country and tax ID, using the rules below.

"Exempt" means: under Vendor SoR, no tax on the commission; under Marketplace SoR, no tax on the wholesale payout. Click Details to see the rules Shipturtle uses in Automatic mode:

vatt1



vat7

How tax exemption is decided: Vendor SoR rules.

vat8

How tax exemption is decided: Marketplace SoR rules.

⚠️ Note: Shipturtle does not verify vendor countries or tax IDs. You're responsible for each vendor's eligibility. Switching from Manual to Automatic recomputes exemption for every vendor, and your manual settings are overwritten and won't be restored if you switch back.


vat9

Switching to Automatic mode asks you to confirm.

E) Invoice configuration

Below Tax configuration, Invoice configuration lets you set the template, logo and invoice number sequence for each invoice type, such as the Customer invoice (both models) and the Vendor to marketplace invoice (wholesale invoice) (Marketplace SoR only). Click Configure next to an invoice type to set it up.

vat10

Tax exemption and Invoice configuration.

4. Vendor setup

For Automatic tax exemption to work correctly, each vendor needs an accurate country and tax ID (VAT number) in their profile. Ask your vendors to add their VAT number under their Billing & invoice settings and save.

5. View VAT in payouts

On the Payouts page, every amount is shown ex VAT and inc VAT. Under each vendor's name you'll see their selling model and whether they're VAT registered.

vat11

Payouts list with ex VAT and inc VAT amounts. Order IDs, vendor names and amounts are blurred.

Click View detail on an order to open the Payment breakdown. The header shows the vendor's tax badges, for example VAT registered, Marketplace SoR and Tax exempt.

vat12

Payment breakdown with the vendor's tax badges. Order, vendor, product and amounts are blurred.

Hover over the ⓘ icon next to any amount to see how VAT was applied:

  • Order value breakdown: product cost, shipping cost, order discount, subtotal ex VAT, tax on product and tax on shipping (with the rate), and what the customer pays.
  • Marketplace retains breakup: commission on product and shipping, discount borne by the marketplace, and net tax retained.
  • Payout breakup: product and shipping net of commission, the vendor's discount share, tax on vendor invoice (with the product and shipping VAT rates), adjustment, vendor payout (transfer) and vendor earnings ex VAT.

vat13

Order value breakdown, including tax on product and shipping.

vat14

Marketplace retains breakup, including net tax retained.

vat15

Payout breakup, including tax on the vendor invoice.

💡 Tip: Net tax retained is the tax on the customer invoice minus the tax on the vendor invoice. It is tax you hold to pay to the tax authority, not marketplace income.


6. Example: how VAT flows through an order

This example uses round numbers for illustration. A marketplace runs Marketplace SoR with a 20% VAT rate and a 40% commission. A customer buys a product priced at £100 ex VAT.


vatt2


In both cases the validator holds: what the customer paid, minus what the marketplace retains, equals the vendor payout.

Important notes

  • Missing countries use the standard rate. If a customer's country has no VAT rate of its own, the Standard VAT rate applies.
  • Shipturtle doesn't verify tax status. Vendor countries and tax IDs are taken as entered. Check them, and confirm your setup with your accountant.
  • Switching to Automatic is permanent for manual choices. Manual exemption settings are overwritten and aren't restored if you switch back.

Setup checklist

  • VAT Invoicing & Tax Compliance add-on added
  • Tax number (and NIF, if needed) saved in Merchant profile
  • Selling model chosen in Tax settings
  • Tax source and tax system set
  • Standard VAT rate entered
  • Country-wise VAT rates added (if Shipturtle calculates tax)
  • Tax exemption mode chosen, and vendor countries and tax IDs checked
  • A test order's payment breakdown reviewed

FAQs

What happens if I haven't added a VAT rate for a country?

Orders from that country use your Standard VAT rate.

Should I choose "Store sends tax info" or "Shipturtle calculates tax"?

If your store platform already calculates tax and sends it with each order, choose Store sends tax info. Shipturtle will show what it detected. If it doesn't, choose Shipturtle calculates tax and add your country-wise VAT rates.

Is net tax retained part of my earnings?

No. It's the VAT you hold on the order after the vendor's share, and it isn't marketplace income.

Why is a vendor marked "Tax exempt"?

In Automatic mode, Shipturtle applies the rules in section 3D. For example, under Marketplace SoR a vendor in a different country, or one without a tax ID on file, is exempt.

Troubleshooting

VAT on a customer order uses the wrong rate

Check that the customer's country has its own rate under Add VAT rates. If it doesn't, the Standard VAT rate is used.

A vendor's payout includes (or excludes) VAT unexpectedly

Check the vendor's badges in the Payment breakdown, then their country and tax ID. In Automatic mode, these decide whether the vendor is tax exempt.

My manual exemption settings disappeared

Switching to Automatic overwrites manual settings. Switch back to Manual and set each vendor again.

Recommended next step

Set your tax source and Standard VAT rate first, add VAT rates for the countries you sell to most, then place a test order and check its Payment breakdown before going live.

If you're stuck, reach us at team@shipturtle.com or open a ticket on the support page.