Introducing the Tax Guard Monitor – Continuous Identifier Qualification

From CDQ Wiki
Public:Release note/20260904
Jump to navigation Jump to search

Release date: 2026-09-04

Release details

We are pleased to announce the Tax Guard Monitor, a new data monitor that qualifies business partner identifiers continuously against official registers, instead of only on demand through a single request.

Until now, identifier qualification was available as a single-request service via the /qualify endpoint. With the Tax Guard Monitor, you can point a dedicated Tax Guard configuration at your Data Mirror and have your business partners qualified on an ongoing basis — with results available in Cloud Apps, in the API, and in a dedicated report.

What's new

  • A new monitor type: Qualification. Tax Guard Monitor is now available alongside the Data Quality, Augmentation and Duplicate monitors in the Data Clinic app. It can be activated, configured and re-run like any other monitor.
  • Qualification results in the processing log. The processing log has been extended with a qualificationResults structure, so every qualification decision — per identifier, name, locality, post code and thoroughfare — is stored and retrievable, not just returned in a live response.
  • A dedicated Tax Guard Configurator app. Tax Guard configurations are created and maintained in their own app in Cloud Apps, separate from data validation configurations.
  • A new Tax Guard Qualification Report. The full qualification outcome for the monitored business partners can be downloaded from the Reports tab in Data Clinic.

Tax Guard configuration

A Tax Guard configuration is built from three elements:

  • Qualification profile — choose between EU TAX Qualification for European tax identifiers and Worldwide TAX Qualification for global coverage.
  • Features — four options can be switched on or off: SHOW LOOKUP RESULTS, SHOW BUSINESS PARTNER, SHOW DEBUG INFO and FORCE EXTERNAL CALL.
  • Data sources — 18 reference sources can be selected for qualification: AR.NRC, AT.CR, AT.FON, AU.BR, BR.RF, BZST, CA.CR, CH.UIDR, CZ.REE, DK.CR, EU.EORI, FR.RC, NO.RBE, PL.NOBR, SG.BR, UK.EORI, UK.VAT, VIES.

Configurations are validated when they are created or saved, so an incomplete or contradictory setup is reported immediately rather than failing later during a monitor run. A Tax Guard configuration uses a qualification profile and cannot be mixed with a validation profile.

Further improvements

  • Clearer job labelling. In Refresh Jobs for data monitors, a Tax Guard run is now shown as Tax Guard Qualification instead of Validation, so it is immediately clear which monitor a job belongs to.
  • Re-evaluation prompt on configuration changes. When you change a Tax Guard configuration, you are asked whether the affected business partners should be re-evaluated — consistent with the behaviour of the other monitors.
  • More precise message for inactive identifiers. When an identifier was valid in the past but is no longer registered as active, the response now states that the identifier status is INACTIVE and that the qualification results are provided against the latest known values. Previously this case was indistinguishable from a genuinely unknown identifier.

Why this matters

Tax and business identifiers do not stay correct. Registrations are withdrawn, companies move, and names change — and a one-off check at record creation does not catch any of it. Continuous qualification means deviations between your master data and the official register are surfaced as they arise, which supports VAT determination, invoice compliance and audit evidence over the whole lifetime of a business partner record, not just at onboarding.

How to activate the Tax Guard Monitor

  1. Open Cloud Apps and go to Global Settings ➡️ Reference Data Source Management to activate the data sources you want to qualify against.
  2. Create a Tax Guard configuration in the Tax Guard Configurator app: select the qualification profile, the features and the data sources.
  3. In Data Clinic, create a new data monitor of type Qualification and assign your Tax Guard configuration to it.
  4. Run the monitor, then review the results in Data Clinic or download the Tax Guard Qualification Report from the Reports tab.

A step-by-step tutorial is available in the CDQ Developer Portal: How to set up Tax Guard Monitor.