Skip to main content

Understanding the Tax configuration app

Written by Maxime

The Tax configuration app is where you adapt Banqup Tax Validation to your own products, invoices and reporting. This article explains who uses it, how your own settings work together with the standard tax rules, and what each section of the app is for.

Who uses Tax configuration

Tax configuration comes with Tax Scan and Tax Connect. When you subscribe, our team activates it in your space and helps you set it up. To get started, contact our sales team at [email protected].

The app is meant for tax specialists and integrators. The standard tax rules work out of the box wherever possible, but in practice some configuration is always needed: for example, to recognise your own products or to add the tax codes your accounting uses.

How standard rules and your own settings work together

Most sections of the app have two tabs:

  • Admin: the standard tax content, maintained by Banqup. You can view it but not change it.

  • Client: the content you create for your own space.

When the engine works out the tax, it looks at your Client content first. If your content does not cover the case, it uses the standard Admin content. To handle a case differently from the standard rules, you add your own content rather than change the standard one.

What each section is for

Country level content

The standard tax rules for each country, such as where a transaction is taxed and when a zero rate applies. Use it to look up how the engine treats a country.

Products

  • Product register: the lists of tax products the engine recognises. You can create your own register and use Product mapping to link your own product codes or descriptions to tax products.

  • Override mappings: rules that choose a different tax product in specific situations, for example for one country or from a given date.

Custom rules

  • Input rules: complete or correct the transaction data before the tax is worked out, for example by filling in a missing country.

  • Output rules: adjust the result after the tax is worked out, for example to apply a specific rate.

  • Territory resolution: the standard rules that decide which territory applies when a region is taxed differently from its country. This is standard content.

  • Lookup tables: lists of values, such as customer or product codes, that your rules can check.

  • Sourcing rules: tell the engine where to find a value, such as a country, when a field is empty.

Invoice

  • Invoice wordings: the legal texts that must appear on an invoice for a given outcome, such as a reverse charge note.

  • Tax codes: link each tax outcome to the code your accounting or reporting uses.

Transaction memo

  • Memo configuration: the messages the engine can add to a result, to explain it or flag it for review.

  • Memo rules: decide when each message is added.

Export/import configuration

Export your configuration. Many sections also have an Export button that downloads their content as an Excel file.

Most rules use the same building blocks: a Condition that decides when the rule applies and an Action that says what it changes. Rules also have validity dates, so you can prepare a change in advance.

Testing your configuration

A change in Tax configuration affects the tax result of every transaction it applies to. Before you rely on it, test your scenarios:

  1. Wait a few seconds after saving, so the change is taken into account.

  2. Open the Tax Simulator and enter a transaction your change should affect. Check that the result is what you expect.

  3. Also test a transaction your change should not affect, to make sure it does not apply too widely.

Good to know: The engine checks all your rules in order, not only the first one that matches. A later rule can change what an earlier rule did. If a result surprises you, check the order of your rules.

FAQ

Can I change the standard Admin content?

No. The Admin content is read-only. To treat a case differently, add your own content in the Client tab: it is used before the standard content.

Do I need to configure anything before I start?

Usually, yes. The standard rules cover common cases, but most companies need at least their own products mapped and their own tax codes. Our team helps you with this when you start.

Can I import a configuration from a file?

No. You can export content as an Excel file, but the app does not import files. You add and change content directly in the app.

What does ITX mean?

ITX is the tax type the engine works with: indirect taxes such as VAT. You see it next to countries and tax products.

Next steps

Did this answer your question?