About Tax ID Number Validation
Introduction
In IFS Cloud, tax ID number can be validated by integrating with external services. Three variants of validation
are available
- Validation of tax ID number with EU prefix
- Validation of tax ID number without EU prefix for EU country
- Validation of tax ID number for country outside EU, available for UK by default
Tax ID number can also be set to valid without validation, after it is validated manually by the user using
external information.
Basic Data Setup
Validation of tax ID number with EU prefix
- The first two characters of the number must indicate EU country. In case of Greece, 'EL' prefix must
be used.
- Tax ID Type can optionally be defined. Setup of the Tax ID Number
Validation toggle for the Tax ID Type does not have an impact.
Validation of tax ID number without EU prefix for EU country
- The first two characters of the number cannot indicate an EU country.
- Tax ID Type must be defined for an EU country.
- The Tax ID Type must enable the Tax ID Number Validation toggle.
- The country of the company for which the tax ID number is defined must match the country of the Tax
ID Type. In case of IPD related customer basic data, country of supply company(instead of the country of
the company) must match the country of the Tax ID Type.
Validation of tax ID number for country outside EU
- The first two characters of the number cannot indicate an EU country.
- Tax ID Type must be defined for country outside EU.
- Tax ID Type must have the Tax ID Number Validation toggle enabled.
Setting tax ID number to valid without validation
- Tax ID Type must have the Automatically Set to Valid toggle enabled.
Data Sent for Validation
Data sent for validation can differ depending on the validation variant
Validation of tax ID number with EU prefix
- Integration with EU validation service (VIES) is configured by default.
- Parameter 1 (Country for external service) - First two characters of the Tax ID Number
field.
- Parameter 2 (Tax ID Number for external service) - Remaining characters from the Tax ID
Number field.
Validation of tax ID number without EU prefix for EU country
- Integration with EU validation service (VIES) is configured by default.
- Parameter 1 (Country for external service) - Value from the Country Code field connected to
Tax ID Type. In case of Greece, 'EL' is sent.
- Parameter 2 (Tax ID Number for external service) - Value of the Tax ID Number field.
Validation of tax ID number for country outside EU
- Integration with UK validation service is configured by default for Tax Id Type 'GBTAX'.
- Parameter 1 (Country for external service) - Value from the Country Code field connected to
Tax ID Type. Not used in case of UK service.
- Parameter 2 (Tax ID Number for external service) - Value of the Tax ID Number field. If the
Tax ID Number field starts with 'GB', 'GB' prefix is removed.
Setting tax ID number to valid without validation
- IFS Cloud considers the Tax ID number as valid
Handling Validation Result
Validation includes two steps
- In the first step, IFS Cloud considers data selected for validation to decide whether and which validation
variant can be used. If no variant can be used, this step ends with error.
- In the second step, with a use of Application Message functionality, IFS Cloud connects to the external
validation service and processes response received from the external service. Based on status of the Application
Message and details of Response Message, IFS Cloud considers tax id number as valid, not valid or not possible to
validate.
When tax ID number is valid
- The Tax ID Validated Date field is set to current date.
- The Tax ID Error Message field is cleared.
When tax ID number is not valid
- The Tax ID Validated Date field remains unchanged.
- The Tax ID Error Message is set to 'Tax ID Number is not valid.'.
When the tax ID number has non alphanumeric characters, none of the three validation variants can be used,
external service cannot validate the tax ID number, or tax ID number cannot be validated due to other reasons
- The Tax ID Validated Date field remains unchanged.
- The Tax ID Error Message field includes details of the error.
When setting tax ID number to valid without validation
- The Tax ID Validated Date field is set to current date.
- The Tax ID Error Message field is cleared.
Support for Validations Based on Tax ID Type
Some system functions have limited support for validations based on Tax ID Type or do not
support Tax ID Type based validations
- When validating tax ID number in the Customer Order related flows, Tax ID Type is not
available in the Customer Order pages. For the purpose of the validation, Tax ID Type is fetched
from customer basic data.
- In case of IPD flow, Tax ID Type based validation is only supported for basic data.
Support for Validation of Invoices
- Validation of tax ID number for Manual Supplier Invoices, Outgoing Supplier Invoices is only available for
One-Time Supplier.
- Validation of tax ID number for Instant Invoices and Manual Customer Invoices is only available for One-Time
Customer.
- Validation of tax ID number for payment proposal item is only available for One-Time Supplier/Customer.
Technical Setup
IFS Connect
Validation of tax ID number with EU prefix and validation of tax ID number without EU prefix for EU country
- In order to integrate with EU validation service (VIES), the following routing address and routing rule are
available by default.
- Example Routing Address - Example_Tax_ID_Number_Validation_For_Countries_Inside_EU
- Example Routing Rule - Example_Tax_ID_Number_Validation_For_Countries_Inside_EU
Validation of tax ID number for country outside EU
- In order to integrate with UK validation service, the following routing address and routing rule are
available by default.
- Example Routing Address - Example_Tax_ID_Number_Validation_For_Countries_Outside_EU
- Example Routing Rule - Example_Tax_ID_Number_Validation_For_Countries_Outside_EU
- Authentication details must be added as per requirements of UK validation service. Refer to IFS Cloud Technical Documentation for details.
- In order to integrate with external validation service other than UK, refer to IFS Cloud Technical Documentation for details.
Setting tax ID number to valid without validation
- No technical setup required.
HTTP Response Status Code
External validation services use different rules when responding to invalid tax number.
- Some services, for example EU validation service (VIES), respond with successful HTTP status codes
(200-299).
- Other services, for example UK validation service, respond with client error HTTP status codes
(400-499).
In case of validation of tax ID number for country outside EU, configured for UK by default, HTTP status codes
400 and 404 are accepted. Application Message continues processing the response for these two HTTP status codes. In
case validation of tax ID number with EU prefix and validation of tax ID number without EU prefix for EU country,
Application Message gets Failed status for these two HTTP status codes.