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.

Contents

Step-By-Step Guide

  1. Open Solution Manager
  2. Navigate to Integration / IFS Connect / Setup IFS Connect
  3. Start by importing a previously created transformer
  4. Expand the folder Transformers
  5. Mark one of the transformers and select Duplicate in the menu bar
  6. Rename the transformer and add proper description in the Description field
  7. Select Transformer Type
  8. Select Load to choose the previously created transformer file
  9. Select the file and press Open
  10. Press the Save icon in the menu bar
  11. Repeat for more transformers as needed
  12. Navigate to Integration / IFS Connect / Routing Addresses
  13. Select Create New in the menu bar
  14. Select the appropriate Destination Type value and enter a Description
  15. Optionally select a previously created transformer file as Transformers
  16. Optionally select a previously created transformer file as Response Transformers
  17. Setup the additional information needed for the relevant Tax ID Validation Service
  18. Save the Routing Address
  19. Navigate to Integration / IFS Connect / Routing Rules and select the Outbound tab
  20. Select Create New in the menu bar
  21. Select APPLICATION_MESSAGE to route from and ensure the checkbox Enabled is selected
  22. Enter a proper description in the Description
  23. Select the None queue
  24. Press New in the Content based conditions area
  25. Select RECEIVER as Search Criteria (Search), equals as Operand (Op) and the relevant <TAX_ID_TYPE> as Matching Criteria (Match)
  26. Press New again in the Content based conditions area
  27. Select SENDER as Search Criteria (Search), equals as Operand (Op) and IFS_GENERIC_VAT as Matching Criteria (Match)
  28. Select Destination Address and choose the previously created Routing Address in the dialog box
  29. Press OK
  30. Select Save in the menu bar

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,

  1. Request.xml
  2. Response.xml