Our service is a full hosted service, but we realise that our customers are all unique and so is their business. This module gives you the ability to amend the responses and error text you get from the service, allowing you to tailor it to meet your own business requirements and to allow you to personalise the service.
Our customers can modify each of the errors to have their own text and to set the error to whatever status they want without any coding or mapping tables using the error management tool in the self service hub.
All the errors in our service are split into 2 sections we give a simple error status and then a more detailed error comment which tells you why you have received this status.
These can both be changed very simply by an administrator. If the administrator logs into our self service hub using the link below.
https://management.bankersalmanac.com/vss-web
Then select manage errors, they will be able to change both the errors and the error text for all the users within their company whichever interface they are using.
Error Status
This is the status of the query you have made. It allows you to quickly see if the validation has passed or not and if not then if the query was totally wrong (fail) or if we are warning you that there is a potential issue.
For every call you will get this response with either
- PASS
- CAUTION
- FAIL
These are designed to give you a quick reference so you can make a fast decision on how to proceed with the validation
PASS
It passes all the checks that we can make and we believe that you can proceed with these details
CAUTION
We advise that you re-check this account as either
- we can’t check this as far as we can with other accounts in that country or jurisdiction
- it does not pass all the checks we have made and we have made a recommended change
FAIL
Accounts that fall into this category, we can’t find the bank that you are requesting or it does not meet the countries or jurisdictions account standards.
Error Comment
The error comment gives you detail on the error and explains why the validation has received the status that it has. The error comment comes in 2 forms these are standard or enhanced.
The standard comment is a short error that gives you basic details on the reason for the error status.
The enhanced comment gives a far more verbose error which explains the reason in a more user friendly way. The Validate user interface uses the enhanced comment but in the API you can choose which comment is returned with a flag (errorComment) which needs to be set to E to return the enhanced comments.
Error text
We have 2 sets of error text, simple error text and enhanced error text.
Validate User Interface
Validate uses the enhanced error text which can be edited in the Self Service hub.
Validate API
Within Validate API have added a new flag, this will allow you to select either the long or the short errors. All you do is add the element errorComment to the parameters of the API call and set it E if you want the long text (that you can edit). If you want the standard short text then just make the call without the parameter
Editing Errors
Changing Error Status
By going into the self service hub as an administrator you can change these status simply by clicking on the new status and saving the change at the bottom.
The next search performed by any account using any interface (User interface or API) will see this change. Currently reporting does not reflect these changes, you will be billed and report against our default errors.
Changing Error Text
To amend the enhance comment text you will need to follow the process below:
- Select the error text you want to change,
- select the edit button
- Edit the text,
- click the edit button again,
- then select the save button and save the changes.
The process is a little intensive but you won’t have to do it often and it’s the most seamless way we could find. If this is causing you lots of problems then please contact us and we’ll help out or make changes to make the process easier for you.