Vertex Validator offers a real-time business-to-business (B2B) validation service that fits into your users’ workflows and helps fulfil several use cases. This service is especially valuable as the tax treatment can vary from the business-to-consumer (B2C) channel in many locations.

The service's API provides a way to manage your tax ID verification across multiple regions. This helps you to meet demanding and diverse requirements of various tax authorities.

Features

The solution offers the following capabilities:

• Support for more than 50 countries and regions. See Validation Type per Country.
• Customers who may want to integrate supplier verification into their supplier onboarding process can also utilize this service.
• You can use the service to verify their buyer’s business status before commencing a commercial relationship.

Restrictions

• You cannot block countries.
• Single Sign-On (SSO) is not supported in this version.
• You must send 1 Tax ID per request. You cannot verify multiple IDs in a single request.

API Integration

To access the API, you need to retrieve your access token. See Accessing the APIs.

You can use the Validate Tax Number request to integrate.

Settings

The following settings are available and can be set in the request:

Processing

You can use the Cache setting to vary whether the cache is checked or not. The following sections show examples for a real-time validation (where the cache is set to 0) and a cached validation (where the cache is set to 30 days).

Real-Time Validation

The following diagram shows a typical process flow where the cache is set to 0:

The steps are as follows:

1. A Validate Tax Number request is sent to the service. The details are specified in the URL:

https://{service_uri}/api/v3/tax_numbers/ABCD12345/validate&country_code=DE&business_name=Franc%27s%20Flowers&cache_expiry_timeout_days=0&on_error=proceed'

2. The Tax ID is checked against the database for that country.
3. The database returns a result.
4. The result is returned in the response from the Validate Tax Number request. For example:

{
"invoice_address": {
"freeform_address": "---",
"country": "DE"
},
"buyer_tax_number": "123456789",
"tax_deducted": true,
"billing_country_code": "DE",
"buyer_tax_number_format_valid": true,
"warnings": null,
"buyer_tax_number_valid": true,
"buyer_tax_number_normalized": "123456789",
"buyer_name": "---"
}

Cached Validation

The following diagram shows a typical process flow where the cache is set to 30 days:

The steps are as follows:

1. A Validate Tax Number request is sent to the service. The details are specified in the URL:

https://{service_uri}/api/v3/tax_numbers/ABCD12345/validate&country_code=DE&business_name=Franc%27s%20Flowers&cache_expiry_timeout_days=30&on_error=proceed'

2. The service checks the last 30 days of entries in the cache. If the cache does not contain the Tax ID, then the Tax Authority's database is checked (where this available for the country).
3. The result is returned in the Validate Tax Number response. For example:

{
"invoice_address": {
"freeform_address": "---",
"country": "DE"
},
"buyer_tax_number": "123456789",
"tax_deducted": true,
"billing_country_code": "DE",
"buyer_tax_number_format_valid": true,
"warnings": null,
"buyer_tax_number_valid": true,
"buyer_tax_number_normalized": "123456789",
"buyer_name": "---"
}

Post Processing

Messages

Messages are described in the Message Processing topic.

Reports

You can view details about validation requests in the Tax Number Validations UI.

You can also use the Schedule Report for API-based reporting.

Useful Links