Taxation (VAT / Sales Tax)
Xilancer can add VAT or sales tax to orders. This page explains, in plain language, how tax works for the employer (the client) and the freelancer, how to turn it on, and where the numbers appear afterwards.
Tax is a core feature of Xilancer, not a plugin. There are two separate mechanisms, and you can use either one or both:
- Freelancer tax — each freelancer declares their own VAT or sales tax, and it is added on top of their service price. This is the main, ready-to-use system.
- Buyer tax rules — the admin sets tax rates per country, and the client is charged based on where they are. This is optional and can be switched off.
Who pays and who remits
This is the part people most often get wrong, so start here:
| Role | What they do |
|---|---|
| Employer (client) | Pays the tax as part of the order total at checkout. |
| Freelancer | Declares the tax rate, receives the collected tax with their earnings, and pays it to their own tax authority. |
| Marketplace admin | Turns tax on, sets the optional country rules, and can see how much tax was collected. |
Xilancer does not withhold or remit tax on a freelancer's behalf. The freelancer is responsible for filing and paying the tax they collect. If you need tax withheld automatically from payouts, that has to be handled outside the platform.
Turning tax on
Tax collection is off by default. To enable it:
- Sign in to the admin panel.
- Open Additional Settings, then Tax / VAT Settings.
- Turn Tax Collection on.
- Save.
While this is off, no tax is added to any order, even if freelancers have filled in their tax details. Turn it on only once you have decided how you want tax handled in your marketplace.
Before you switch it on: tax rules vary a lot by country. Confirm your approach with an accountant or tax adviser, especially if you have freelancers and clients in several countries.
Freelancer tax: how a freelancer sets it up
Once tax collection is enabled, freelancers see a tax section in their profile settings. They:
- Choose the tax type
- I do not charge tax — no tax is added to their orders.
- VAT — value-added tax.
- Sales Tax — sales tax.
- Choose the scheme
- EU VAT — for European Union VAT.
- US Sales Tax — for United States sales tax.
- Other — for any other tax system.
- Enter the rate as a percentage, for example
20for 20%. - Enter the tax country as a two-letter country code, for example
DEorUS. - Optionally add their VAT number, legal name, and tax address. These details are printed on invoices as the seller's identity, which makes the invoice usable for the freelancer's own tax filing.
A freelancer can change these settings at any time, but changes only affect new orders. Orders that have already been placed keep the tax amount that applied when they were placed.
How the tax is calculated
- Tax is calculated on the freelancer's service price, before any platform fees.
- It is added on top of that price, not taken out of it.
- The client pays the price plus the tax.
- The tax amount is passed through to the freelancer.
Worked example
A freelancer charges 20% VAT on a $100 service:
| Line | Amount |
|---|---|
| Service price | $100.00 |
| VAT at 20% | $20.00 |
| Client pays | $120.00 |
The freelancer receives the $100 for the work plus the $20 tax, and remits the $20 to their tax authority.
When no tax is charged
No tax is added if:
- Tax collection is switched off by the admin, or
- The freelancer chose I do not charge tax, or
- The freelancer left the rate at 0, or
- The order qualifies for EU reverse charge (explained below).
EU VAT and reverse charge
For freelancers using the EU VAT scheme, Xilancer supports reverse charge.
Reverse charge means the client, not the freelancer, accounts for the VAT. It applies when all of these are true:
- The freelancer is VAT-registered in one EU country.
- The client is VAT-registered in a different EU country.
- Both VAT numbers have been verified.
When reverse charge applies, the tax rate is 0% and the invoice is marked "Reverse charge". The client self-accounts for the VAT in their own country.
Xilancer verifies EU VAT numbers against VIES, the European Commission's official VAT number checking service. If a number cannot be verified, reverse charge is not applied and the freelancer's normal rate is used instead.
Keep your details current. A wrong or expired VAT number is the most common reason reverse charge fails to apply.
US sales tax
For the US Sales Tax scheme, Xilancer applies the rate the freelancer declared, exactly as entered. It does not automatically work out tax by state, county, or city.
That means:
- The freelancer is responsible for declaring the correct rate for their situation.
- If a freelancer operates in several states, they need to decide what single rate to declare, or handle the difference themselves.
- If you need true location-based US sales tax, use the buyer tax rules described below or consult a tax adviser about a dedicated tax service.
Buyer tax rules (optional)
The second mechanism charges tax based on the client's country, using rules the admin defines.
How it works
- Each rule has a label (for example "VAT" or "GST") and a rate (a percentage).
- When a client from that country checks out, the matching rate is applied.
- A rule with no country acts as the default for any country that does not have its own rule.
Managing rules
From the admin panel:
- Open the Tax Rules area.
- Create a rule — choose a country, or leave it empty to make it the default.
- Enter the label and the rate.
- Set the rule as active or inactive.
- Save.
You can edit rules at any time, deactivate them without deleting them, and delete one or several at once.
Turning it on or off
The buyer tax system has its own on/off switch, separate from freelancer tax. It is found in the general settings under Tax System.
Note: this country-based system is optional and may be switched off on your installation. The freelancer-declared tax is the primary system and works independently of it.
Which system applies if both are on?
They are separate. Freelancer tax follows what the freelancer declared on their profile; buyer tax rules follow the client's country. Decide which one you want to rely on before enabling both, and test a checkout to confirm the result is what you expect.
Where tax appears
At checkout
The tax line is shown before payment, so the client sees the full amount, the rate, and the label before they pay. Nothing is added silently after the fact.
On the invoice
When tax applies, the invoice shows:
- The tax label (for example "VAT (20%)").
- The tax rate.
- The tax amount.
- The seller's identity — the freelancer's legal name, tax address, and VAT number, if they provided them.
The client sees the total they paid, and the freelancer gets an invoice suitable for their own records.
In the tax report
The admin can review collected tax from the Tax Report:
- Open the tax report in the admin panel.
- Choose a start and end date.
- See the total tax collected and a breakdown by tax label.
Only completed orders with tax are included, so the report reflects money actually earned rather than orders still in progress.
Tax is locked to each order
Tax is recorded on an order at the moment it is placed. If a freelancer later changes their rate, country, or VAT number, past orders and their invoices do not change. This keeps your records and the freelancer's filings consistent.
Compliance reminders
- Freelancers must remit the tax they collect to their own tax authority. Xilancer does not do this for them.
- Admins should confirm that enabling tax collection is appropriate for their marketplace and jurisdiction before switching it on.
- VAT numbers are checked against VIES where relevant. Ask freelancers to keep them up to date.
- Rates change. Tax law is not static — review your settings and your freelancers' declarations periodically.
- This page is a product guide, not tax advice. For your own obligations, speak to a qualified tax professional in your country.
Troubleshooting
| Problem | Likely cause | What to do |
|---|---|---|
| No tax on any order | Tax collection is switched off | Turn it on in Tax / VAT Settings |
| No tax on one freelancer's orders | They chose "I do not charge tax" or left the rate at 0 | Ask them to update their tax settings |
| Reverse charge is not applied | VAT number not verified, or both parties are in the same country | Check both VAT numbers and countries |
| Client charged an unexpected rate | A buyer tax rule matched their country | Review the Tax Rules list and the default rule |
| Tax report is empty | No completed orders in the selected dates (or tax was off) | Widen the date range and confirm tax was enabled |
| Old invoice shows an old rate | Tax is locked to the order when placed | This is expected — the original rate is correct for that order |
Quick setup checklist
- Decide whether you will use freelancer tax, buyer tax rules, or both.
- Turn on Tax Collection.
- Ask freelancers to complete their tax type, scheme, rate, country, and VAT number.
- If using country rules, create your rules and set a sensible default.
- Place a test order and confirm the tax line, total, and invoice.
- Check the tax report shows the test order once it is completed.
- Tell freelancers, in writing, that remitting collected tax is their responsibility.

