VAT Validation: Execute cli (service)

cli/service

The background processing cannot be started from the user interface. To start background processing, open a command line in the directory where the ew_service_vat.exe file is located and call it with the --mode=auto parameter.

To use the European interface, add the --vies option.

The background processing will then process all VAT registration number files located in the import directory. A copy of the import file is always stored in the backup directory and the finished check result is stored in the export directory. Individual processing steps are recorded in the log directory.

The call for VAT Validation with the option --mode=auto can be scheduled via a repeating task or cronjob.

Parameter

Execute ew_service_vat --help and you will get the overview of all parameters of the VAT Validation, which you can pass to the cli or service.

Usage of: ew_service_vat.exe [options]
----------------------------------------------------------------------------
-h  --help              Show this help
-v  --version           Version Return the version information.
    --lang              Language (de,en). Overwrites settings.
    --mode              Set the validation mode (single, batch, auto).
    --dataobject        JSON object for single validation mode.
    --inputfile         Input ImportData file for batch validation.
    --outputfile        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.
    --vies              Use VIES instead of BZSt.
    --validatefile      Check file, if structure is readable.
----------------------------------------------------------------------------

-h --help

View all the necessary parameters that support the cli of the VAT Validation.

-v --version

Returns the current installed version of the VAT Validation.

--lang

This parameter allows you to specify or override the language of the VAT Validation.

--mode

The mode in which the VAT Validation should be performed.

--dataobject

This parameter is necessary for a single check of a VAT number.

-i --inputfile

Use this parameter to specify the file with data to be imported for the VAT Validation.

-o --outputfile

The export file for the VAT Validation is specified with this parameter. It is important that this is not identical to the import file.

--returncodesbzst

This parameter creates a configuration file for the VAT Validation to process the return values of the BZSt interface.

--returncodesvies

This parameter creates a configuration file for the VAT Validation to process the return values of the VIES interface.

--testmail

From the VAT Validation, test sending a test e-mail. After processing a file, an e-mail can be sent to you at the end.

--vies

This parameter specifies that the VIES interface is to be used and overwrites any deviating settings.

--validatefile

Check the import file of the VAT Validation for its formal correctness beforehand.

Outputs from cli/Service

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

Configuration

The configuration of the ew_service_vat CLI is done via INI files or via the user interface application. For more information, see the page about the VAT Validation configuration files.