Execute cli (Service)


Background processing cannot be started from the user interface directly. To execute background processing for VAT validation, open a command line in the directory where the


and call it with the parameter --mode auto. Around to use the European interface, add the --vies.

Background processing processes all VAT files that are located in the import directory. In the backup directory, a Copy of the import file saved and the finished test result in the export directory. In the log directory, individual processing steps are recorded.

The call with the option --mode auto can be scheduled via a repetitive task or cronjob.



ew_service_vat --help

and you get an overview of all parameters that you can pass to the cli or the service.

Usage of ew_service_vat.exe:
--checklicence        Return the status of your licence.
--dataobject string JSON object for single validation mode.
--getlicence          Return information of your licence.
--info Return info.
--inputfile string input CSV file for batch validation.
--mode string set the validation mode (single, batch, auto).
--outputfile string Output file for batch validation.
--returncodesbzst Writes the returncodes for BZSt to user dir.
--returncodesvies Writes the returncodes for VIES to user dir.
--testmail Send a testmail.
--update Check for updates.
--version Return the version information.
--vies Use VIES instead of BzSt.


Verifies that the entered license data, consisting of VAT ID number and license key, are valid.

--dataobject string

The data of the query formatted as JSON. Used only in conjunction with --mode single.


Reads the information about the license data stored at erpware using the VAT ID number and the license key.


You can use this information to find out which configuration files are used and whether the service has access to them.

--inputfile string

This parameter specifies the import file used during batch processing.

--mode string

The mode in which you want the check to take place. Possible values are: single, batch, auto

--outputfile string

The output file when using Batch mode where you will find the results for the VAT validation. All checked values are stored here and can then be processed further.


With the help of this parameter, the default return values of the BZst can be restored. At each Starting the IDValidation (interface), this function is called.


With the help of this parameter, the default return values of VIES can be restored. At each Starting the IDValidation (interface), this function is called.


If you have set up the sending of e-mails, you can send a test email. So , you can check if the parameters are correct.


It checks whether an update of the ID Validation or VAT module exists. Additional release information, if any, is returned.


This parameter returns the current version of the ServiceVAT.

--validatefile string

With this parameter you can check a file in advance and get the number of records inside the import file.


If a mode (single, batch, auto) is additionally called with this parameter, VIES/MIAS is used as an interface.

Issues of CLI/Service

All outputs are in JSON format and vary according to your return values.


The ew_service_vat CLI is configured via JSON files or the interface application. More information on the page about the VAT configuration files.