Plugin: VAT ID-validation

Table of contents

Introduction

With this interface we allow you to validate VAT-IDs from intern and abroad countries. With the previous interface of the Federal Central Tax Office it was not possible to validate VAT-IDs from Germany. Additionally a request was only possible if you yourself had a valid German VAT-ID. To also allow international customers to validate the correctness of VAT-IDs we have created this new Plugin based on the European interface. Further information about this interface you can be found here: VIES VAT number validation

Installation and configuration

Installation of the plugin

The Plugin "VAT-ID validation" can be installed like a normal plugin. After the installation of the plugin you should reload your backend once, so the plugin is shown in the menu structure, sometimes you might have to clear the cache and reload again.

Plugin configuration

After the successful installation you can start the configuration of the interface. For this you can either edit the plugin in the plugin manager or use the menu Additional settings > VAT Validation in the basic settings.

 

  • (1) Please enter you own VAT-ID here.
  • (2) In this option you can define, if you want to get a notice for an invalid registration. This can e.g. be done by changing the configuration.
  • (3) The extended validation can only be done if you as a shop owner have a German VAT-ID. The request is done with the Federal Central Tax Office and might validate the address data depending on the country.
  • (4) The office mail confirmation is done postal and can be activated optionally. Further information for this can be found on the homepage of the Federal Central Tax Office of Germany
  • (5) If the entry of the VAT-ID is mandatory (this can be set at configuration > basic settings > frontend > login / registration > Mark VAT ID number as required for company customers), you can choose countries that the VAT-ID is not mandatory for in this field. In not-EU-countries there is no VAT-ID, so those are automatically excluded from the compulsory statement.

Registration with simple validation

You can see and change all error messages occurring in the frontend in the snippet management. You find the snippets in the namespace /frontend/swag_vat_id_validation/

Possible error messages:

  • The provided VAT ID is too short. (error1)
  • The provided VAT ID is too long. (error2)
  • The provided VAT ID has an incorrect country code. (error3)
  • The provided VAT ID contains incorrect characters. (error4)

For this you have to mind that there are different ways of presentations in the frontend. On the one hand there is an error message that is validated right after the entry. This one is displayed next to the field on the right. On the other hand there is an error message atop of the area after you send the form.

Registration with extended validation

For the extended validation you must have a German VAT-ID. This has to be entered in the plugin configuration first. After activating the extended check you can get many different error messages:

Possible error messages:

  • The provided VAT ID is invalid or does not match the provided address.
  • The provided VAT ID is not registered in the associated EU member state.
  • The provided VAT ID is not valid until %s.
  • The provided VAT ID was only valid between %s and %s.
  • The provided VAT ID doesn't match the structure of this EU member state's VAT IDs.
  • The provided VAT ID doesn't match the digit check rules that apply to this EU member state's VAT IDs.
  • The provided VAT ID contains incorrect chars.
  • The provided VAT ID has an incorrect country code.
  • Your VAT ID has only been approved for taxing intra-EU transactions. You are not allowed to place confirmation requests.
  • Your German VAT ID is invalid. A confirmation request is not possible. Contact the Federal Central Tax Office in Saarlouis for more information.
  • The provided VAT ID has also been associated to another user. Your request could not be process. Please try again later.
  • The validation of a German VAT ID is not supported.
  • Your German VAT ID is invalid. It has to start with 'DE' followed by 9 digits.
  • Your request does not contain all needed information for a simple confirmation request.
  • Your request does not contain all needed information for an extended confirmation request.
  • An error occurred while processing the data for the requested EU member state, and your request could not be processed.
  • An extended confirmation is not possible at the moment.
  • An error occurred while processing the extended confirmation request.
  • An error occurred while processing your request for an official mail confirmation. You will not receive one.
  • We are not able to process your request at the moment. Please try again later.
  • Currently your request cannot be answered by the associated EU member state

The extended validation is only available for customers with an international VAT-ID or EU-member-countries. A validation of national VAT-IDs is not possible.

VAT-ID in an existing customer account

If you activate the extended validation afterwards the validation is also done for existing customer accounts in the login process. If the previously entered address is wrong the customer gets one of the following messages:

  • The provided company name doesn't match the provided VAT ID
  • The provided street and street number don't match the associated VAT ID
  • The provided zip code doesn't match the associated VAT ID
  • The provided city doesn't match the associated VAT ID

The fitting snippets can be found in the namespace frontend/swag_vat_id_validation/main.

Error message in the account with invalid VAT-ID

Error message in the checkout with invalid VAT-ID

Currently a finish of the checkout is not possible with an invalid VAT-ID.

E-Mail when deleting the VAT-ID

If the validation of a already entered VAT-ID is failing you get informed about the deletion of the ID via mail.

This mail can be changed in the backend. For this you find the template at Configuration > Email templates in the area "System emails" with the name "sSWAGVATIDVALIDATION_VALIDATIONERROR".