Validator Settings
Manage how the validation service functions.
The Tax Number Validation Settings feature enables you to configure business tax number validation settings for countries and regions across the different validation endpoints.
You can also configure API-based settings. For more information, see Standalone Vertex Validator.
Configure the settings
To configure the settings, follow these steps:
- Select Validator > Settings.
- Under Jurisdiction, click All Regions to configure the default settings, or select a specific country or region.
- Enter all applicable information, noting all required fields.
- Click Save.
The Tax Number Validator Settings feature
Jurisdictions
Configure the default settings for all countries and regions, then configure each country or region as needed.
On the All Regions page, you can configure the default settings for all tax number validations. You can override these default settings at the country or region level. The country or region-level settings take precedence.
For example, a timeout set on the Australia page overrides the timeout defined on the All Regions page.
Settings
You can configure these settings for the Integrated Vertex Validator or Standalone Vertex Validator. If you don't configure settings, the service applies default values.
This table lists the available settings and their descriptions.
| Field | Description | Default |
|---|---|---|
| Validation Strategy | Determines the validation type. | Full Validation |
| Full Validation Request Timeout (milliseconds) | Specifies how long the service waits for a response from the external tax authority system before timing out. | 20 seconds |
| Full Validation Error Handling Strategy | Specifies how the service handles errors when full validation can't run (for example, when the external tax authority system is unavailable). Integrated Vertex Validator can proceed with a syntax check, mark the tax number as invalid, or block tax calculation. Standalone Vertex Validator can either perform a syntax check or mark the tax number as invalid. | Proceed |
| Full Validation Cache Expiry (days) | The service can cache validation results. Control how long the service stores and reuses validation results. Set to 30 to cache results for 30 days. Set to 0 to disable caching and validate each request using real-time validation. | 30 days |
Considerations
Note the following considerations:
- Full validation in Bahrain, India, Oman, and the United Arab Emirates can take tens of seconds. The default timeout in these countries is 60 seconds, and for the Integrated Vertex Validator, the default strategy is syntax validation.
- Full validation in Italy (by the Italian Revenue Agency) can also take tens of seconds. VAT Information Exchange System (VIES) validation is typically faster.