Integrated Vertex Validator users can use the API settings. Standalone users can send the settings as part of the Validate Tax Number request.

Integrated

Integrated users can create settings for the Marketplaces and Sellers.

Marketplace Settings

Some settings can be made for the Marketplace as described in the Marketplace Settings - Vertex Validator topic.

Seller Settings

Some settings can be made for the Marketplace as described in the Seller Settings - Vertex Validator topic.

Standalone

The following settings are available and can be set in the Validate Tax Number request's query parameters:

Setting Description

cache_expiry_timeout_days Validation results can be cached. This setting controls how recent the cached result that is returned is. For example, if it is set to 0, the service will validate the ID against the authority's database in real-time. If it is set to 30, the service will use results cached over the last 30 days.

on_error Controls how the service behaves when the external service returns an error due to unavailability or other reasons. If you specify proceed, the Tax ID will be marked as invalid. If you specify syntax_check, the syntax is checked, the ID is marked as valid (if correct) and the following is returned in the API response: buyer-tax_number-validation-info: "tax-number-syntax-considered-valid-but-not-verified".

Setting	Description
`cache_expiry_timeout_days`	Validation results can be cached. This setting controls how recent the cached result that is returned is. For example, if it is set to 0, the service will validate the ID against the authority's database in real-time. If it is set to 30, the service will use results cached over the last 30 days.
`on_error`	Controls how the service behaves when the external service returns an error due to unavailability or other reasons. If you specify `proceed`, the Tax ID will be marked as invalid. If you specify `syntax_check`, the syntax is checked, the ID is marked as valid (if correct) and the following is returned in the API response: `buyer-tax_number-validation-info: "tax-number-syntax-considered-valid-but-not-verified"`.