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 fiirst 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
- IFS Cloud configures integration with the EU validation service
(VIES) 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'. See Technical Setup for other configurations.
- 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.