Overview
Proper tax configuration ensures that documents imported from Dext into BrightBooks have the correct VAT codes and amounts. This guide explains how to set up tax correctly in Dext and what happens if the critical "Use Tax List" setting is not enabled.
Why Tax Configuration Matters
Incorrect or missing tax codes can cause:
- Wrong VAT amounts on invoices (including items with 0% tax when they should be taxed)
- Compliance issues with HMRC
- Mismatched records between Dext and BrightBooks
- Time-consuming corrections after import
THE CRITICAL SETTING: Use Tax List
Use Tax List must be switched ON in Dext. This tells Dext to apply the VAT rates from your BrightBooks account to imported documents. If Use Tax List is OFF, all documents will arrive with 0% tax—regardless of the actual VAT rates they should have.
Important: This is not a "recommended" setting. It is required for correct tax setup. Without it, your tax data will be incorrect.
Step 1: Enable Use Tax List in Dext (REQUIRED)
- 1. Log into Dext
- 2. Navigate to Connections > Integrations
- 3. Find the "Use Tax List" toggle
- 4. Switch it ON
- 5. Save your changes
What this does: Tells Dext to sync the tax rates configured in your BrightBooks account. Without this, documents will import with 0% tax.
Step 2: Set Default Tax Codes in Dext
After enabling Use Tax List, Dext will ask you to set two default tax codes:
Default Tax for Costs: Select the VAT code you use most for supplier invoices (typically 20% VAT on Purchases). This is applied to cost documents (invoices, bills) that do not specify a different rate.
Default Exempt Tax Code: Select the code for VAT-exempt or reverse-charged items. Use this for documents that should not have VAT applied.
Step 3: Know Your BrightBooks Tax Codes
Common VAT codes in BrightBooks include:
- 20% VAT on Purchases
- 20% VAT on Sales
- 5% VAT (reduced rate)
- 0% VAT / Exempt
- Reverse Charge
Ask your accountant which codes you should use in your business.
Step 4: Check and Fix Tax Codes Before Publishing
Every time you publish a document from Dext to BrightBooks:
- 1. Open the document in Dext (it will have a "To Review" status)
- 2. Check the Tax Code field—verify it shows the correct rate (e.g., 20%, 5%, 0%)
- 3. If the tax code is incorrect, click the dropdown and select the right one
- 4. Click Publish to send the document to BrightBooks
Step 5: Fix Incorrect Tax After Importing
If documents have already been imported into BrightBooks with the wrong tax codes, follow this process:
- 1. Review and correct your tax settings in Dext (see Step 1–2 above, especially Use Tax List)
- 2. In Dext, unarchive the documents that have incorrect tax
- 3. In BrightBooks, delete those documents from your accounts
- 4. In Dext, republish the unarchived documents—they should now have the correct tax codes
- 5. Verify the documents imported correctly in BrightBooks
Troubleshooting: Documents Show 0% Tax
If documents are importing with 0% tax when they should have 20% VAT (or another rate), follow these troubleshooting steps IN ORDER:
Step A: Check Use Tax List status (most common cause)
Go to Dext > Connections > Integrations and check whether "Use Tax List" is ON or OFF.
If Use Tax List is OFF: This is why all your documents have 0% tax. Turn it ON immediately (see Step 1 above). Then unarchive the affected documents in Dext and republish them. They should now import with the correct tax.
If Use Tax List is ON: Proceed to Step B.
Step B: Verify default tax codes
In Dext > Connections > Integrations, check that your "Default Tax for Costs" is set correctly (usually 20% VAT on Purchases). If you recently changed tax rates in BrightBooks, refresh the integration in Dext to sync the new rates.
Step C: Check individual documents
If Use Tax List is ON and defaults are correct, the problem may be document-specific. Open the affected document in Dext and verify the Tax Code field. Some documents may be marked as exempt or have an incorrect code set. Correct the code and republish.
Common Tax Setup Scenarios
All new documents show 0% tax: Use Tax List is OFF. Turn it ON in Dext > Connections > Integrations.
Some documents show 0%, others show 20%: Use Tax List is ON, but some documents are marked as exempt in Dext. Check the Tax Code field on each document.
Tax rates changed in BrightBooks but Dext still shows old rates: Refresh the integration in Dext. Go to Dext > Connections > Integrations > Manage Connections (top dropdown) > Refresh Integration Data. Wait a few minutes for the system to reload.
I deleted taxed documents and want to re-import them: In Dext, unarchive the documents. In BrightBooks, delete the old entries. Then republish from Dext with the correct tax codes.
Summary
- Use Tax List MUST be ON in Dext for correct tax to import.
- Without Use Tax List, all documents will show 0% tax.
- Set default tax codes for Costs and Exempt items.
- Always check the Tax Code field before publishing from Dext.
- If documents import with wrong tax, unarchive in Dext and republish.