Sumex1.net/tardocValidator: overview

Overview

The tardocValidator is an ATL COM module which provides methods to browse, query, and validate records against the Tardoc catalog. The design goals of the module are to help you control the quality and standards compliance of the service records you construct.

When constructing a Tardoc record describing medical services, this module provides the services you need to ensure that the record complies with the complex coding rules defined by Tardoc. Step-by-step checks can be made as the user enters each new piece of information. Query methods allow the construction of selection lists on the fly, such that the user can always be presented with an appropriate range of choices. A complete record can also be validated as a whole.

Please also have a look at the Important Documents that serves as a jump start and might effect the ease of the implementation.

Get started with
Important Documents

Keyfacts at a glance

Last update:	Wednesday, 7 January 2026 - 19:08:48
Module version/date:	1.00.004	7 Jan 2026
Interface version/date:	1.00	11 Aug 2025
DB version/date:	1.43	28 Nov 2025
Covering:	Tardoc 1.4c (1.43) from 28 Nov 2025

Tardoc tariff browser

The Tardoc tariff browser allows you to browse, view, and check the tariff positions of the Tardoc catalog. The tardocValidator internally uses excactly this tariff on one of the given languages for its query and validating services.

Date	Language	Description
11.08.25	German	Tardoc V1.43:	Tariffbrowser online @ OAAT Tariffbrowser online @ FMH
11.08.25	French	Tardoc V1.43:	Tariffbrowser online @ OAAT Tariffbrowser online @ FMH
11.08.25	Italian	Tardoc V1.43:	Tariffbrowser online @ OAAT Tariffbrowser online @ FMH

API browser

The online documentation browser allows you to browse, view, and check the various interfaces, methods und properties of the Dll. Please note, that this documentation is included in the full installer in form of a .CHM file.

Date	Time	API version
11.08.25	12:08:02	V1.00: View API browser
11.08.25	12:08:02	V1.00: Download API browser .CHM file

Download area for tardocValidator related files

Important note: the "Microsoft Jet OLE DB Provider" while a neccessary part of the tardocValidator dll is not part of any installer! If you have not installed the "Jet OLE DB Provider" driver yet then go to the Microsoft Support Center to download the neccessary file or install the ACE.OleDB.16.32bit | ACE.OleDB.12.32bit drivers.

Date Version Description

07.01.26 1.00.004 tardocValidator: important bug fix of IUtility::Expand() - cf. history
Download tardocValidator installer (15.1 MB)

Versioning

07.01.26:

1.00.004 -

tardocValidator100.dll

10.08.25:

1.00.001 -

oopProxyTardocValidator100.exe

10.08.25:

1.00.001 -

tardocValidatorServer100.exe

Revision history

This new build resolves an issue involving the incorrect handling of session-based versus quantity-based restrictions within the IUtility::Expand() function when certain TARDOC services were used.

IUtility::Expand() logic - session vs. quantity limitations:
Fixed an issue in the IUtility::Expand() logic where session-based limitations introduced with new CT_ZR_EINHEIT entries in TARDOC were incorrectly treated as quantity-based. When eRespectQuantityLimits=enYes was set, this could lead to an excessively high pdRemainingNumber.
As a consequence, IUtility::GetFirstExpandRecord() could return an incorrectly low pdQuantity for affected positions (e.g. CG.00.0160) in cases with mixed limitation rules such as "<= 4 per 360 days (sessions)" and "<= 330 per 360 days (quantity)".
The limitation handling has been corrected to properly distinguish between session-based and quantity-based rules.

It is strongly recommended that you upgrade to this new build!

Actions for developers: none Actions for end users: install

show older builds ...

09.12.25 1.00.003 tardocValidator with important updates to correct for TarDoc 1.4c errors - cf. history

Versioning

09.12.25:

1.00.003 -

tardocValidator100.dll

10.08.25:

1.00.001 -

oopProxyTardocValidator100.exe

10.08.25:

1.00.001 -

tardocValidatorServer100.exe

Revision history

This late update of the tardocValidator became necessary because some errors in the TarDoc database 1.4c published by the OAAT on November 28, 2025, had to be corrected programmatically via the validator!

The most important corrections are summarized below:

IUtility::Expand() returned an error for the codes AM.10.0020 and AM.10.0060.
These codes can be expanded to include two additional services. Although this was already supported in TARMED, the hierarchical structure of TARDOC differs from that of TARMED, which caused the error.
This issue has now been resolved and these services should now expand correctly.
IUtility::EmergencyInconvenience()
IUtility::GetFirstEmergencyInconvenienceRecord()/GetNextEmergencyInconvenienceRecord()
In the initial implementation, the parameter pbstrReferenceCode always returned the code supplied to the EmergencyInconvenience method, regardless of the selected EmergencyType.

In the prior published version, this behavior was changed: pbstrReferenceCode was returned as an empty string for all EmergencyType values except enAutomatic. Since the supplied code was no longer inspected for other emergency types, some implementors experienced issues due to the lack of reference information.

In the current version, a best-effort approach has been implemented: The supplied code is now evaluated for all EmergencyType values.
If the code is relevant to the selected EmergencyType, it is returned as the reference code.
If the supplied code does not match the chosen EmergencyType, the reference code is returned empty.
For example:
- Providing a visit code such as AA.00.0010 while using eEmergency = enTelemedicine results in an empty reference code, as the visit code is not applicable to telemedicine.
- Likewise, providing a telemedicine code while requesting a different emergency type also returns an empty reference code.
This update restores meaningful behavior while avoiding incorrect or misleading reference codes in incompatible scenarios.

Actions for developers: none Actions for end users: install

02.12.25 1.00.002 tardocValidator with final TarDoc 1.4c tariff from OAAT - cf. history

Versioning

01.12.25:

1.00.002 -

tardocValidator100.dll

10.08.25:

1.00.001 -

oopProxyTardocValidator100.exe

10.08.25:

1.00.001 -

tardocValidatorServer100.exe

Revision history

tardocValidator with final TarDoc 1.4c tariff - cf. OAAT Newsletter 27

Actions for developers: none Actions for end users: install

11.08.25 1.00.001 tardocValidator with TardDoc 1.4c for developers only - cf. history

Versioning

11.08.25:

1.00.001 -

tardocValidator100.dll

10.08.25:

1.00.001 -

oopProxyTardocValidator100.exe

10.08.25:

1.00.001 -

tardocValidatorServer100.exe

Revision history

Initial tardocValidator with TardDoc 1.4c for developers only.
DO NOT USE THIS VERSION IN PRODUCTION ENVIRONMENTS.

Actions for developers: install Actions for end users: do not use - not public

	Parameters for a silent install / uninstall
	Installation directory: INSTALLDIR=full_path_to_install_dir Optionally install a specific language part: ADDLOCAL={all \| German \| French \| Italian} Silent install: tardocValidatorInstaller.exe /s /v"/quiet INSTALLDIR=\"c:\my test\" ADDLOCAL=French " Silent uninstall: tardocValidatorInstaller.exe /s /v"/quiet REMOVE=ALL INSTALLDIR=\"c:\my test\" "