IFS Connect for Tax ID Validations¶
The purpose with this page is to provide a step-by-step guide how to, in IFS Connect, create new routing rules and how to use them effectively to connect to different Tax ID Validation Services. An example routing address, routing rule and transformer has been provided for UK VAT Number Validation Service. This guide can be used to configure other Tax ID Validation Services.
A generic interface has been provided to handle request and response messages. A request transformer and a response transformer can be used to transform these generic message formats to the required specific formats of the relevant service end points. Samples of the generic messages can be found below.
Use this page when you want to learn more about how to configure IFS Connect for Tax ID Validations.
Step-By-Step Guide¶
- Open Solution Manager.
- Navigate to Integration / IFS Connect / Setup IFS Connect.
- Start by importing a previously created transformer.
- Go to folder Transformers.
- Press New and assistant to create Transformer opens.
- Select Instance Type and add proper Instance Name.
- Browse the file and press OK.
- Repeat step 4 to 7 for more transformers as needed.
- Navigate to Integration /IFS Connect / Routing Addresses.
- Press New and assistant to create Routing Address opens.
- Select appropriate Transport Connector and add proper Address Name.
- Setup the additional information needed for the relevant Tax ID Validation Service using the Next and Previous buttons to navigate.
- Press Finish.
- Optionally select a previously created transformer file under the Transformers section.
- Optionally select a previously created transformer file under the Response Transformers section.
- Navigate to Integration / IFS Connect / Routing Rules and select the Outbound tab.
- Press New and assistant to create Routing Rule opens.
- Select Direction Outbound and press Next.
- Select a suitable format to Route From and ensure it is set to Enabled. In this example we will use APPLICATION_MESSAGE.
- Add proper Rule Name.
- Press Finish.
- Press New in Content Based Conditions to enter a condition for identifying what kind of files that should be handled by this Routing Rule.
- Select RECEIVER as Search Path, equals as Operation and the relevant <TAX_ID_TYPE> as Match.
- Press New again in the Content Based Conditions section.
- Select MESSAGE_FUNCTION as Search Path, equals as Operation and VALIDATE_TAX_ID_NO_BY_TAX_TYPE as Match.
- Press New again in the Content Based Conditions section.
- Select SENDER as Search Path, equals as Operation and IFS as Match.
- Press Set Destination Address in Destination Address and choose the previously created Routing Address in the dialog.
- Press OK.
Troubleshooting Considerations¶
Incorrect IFS Connect configurations might lead to errors being raised in the application. In such scenarios, a descriptive error message should be available in Solution Manager / Integration / IFS Connect / Application Messages.
Samples¶
The zip file GenericMessageSamples contains,
- Request.xml
- Response.xml