Vertex Validator

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.

The solution offers the following capabilities:

  • Support for more than 70 countries and regions.
  • Support for multiple validation types such as real-time and bulk validations. Available integrated with products like Vertex O Series Cloud.
  • Global validation cache helps you to maintain your validation service even if regional services are down. Validation response times are also reduced due to increased speed of validation.
  • UI-based settings to help you configure validation processing per country and region.
  • Reporting data is available via the UI, CSV download and API.
  • Dual number validation. For example, in Canada it can validate both GST and HST.
  • Some sellers are required to validate a businesses’ tax number before applying a reverse charge and zero rating the transaction. Vertex’s B2B validation service supports this.
  • 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 commercial relationship.

Versions

This documentation is for version 3 of Vertex Validator. The documentation for version 2 is here.

Deployments

There are 3 deployment options for Vertex Validator:

Vertex for e-Commerce integration

Users of the Integrated version can use it as part of your Vertex for Marketplaces deployment to help process B2B transactions as explained in the Integrated Vertex Validator topic.

These implementations use the buyer_tax_number field to send Tax IDs to Vertex Validator. If the ID is valid, the transaction is treated as a a B2B transaction. If the ID is not valid, it is generally treated as a B2C transaction. This behaviour can differ depending on your settings.

Standalone integration

Standalone users use only the Tax ID validation component as described in the Standalone Vertex Validator topic

These integrations use the Validate Tax Number request to check Tax IDs for scenarios such as the following:

  • 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.

Vertex O Series Cloud integration

Vertex O Series Cloud users who want to use Vertex Validator can use the integration described in the Vertex O Series Cloud Integration topic to deploy it as part of their requests.

Settings

You can make settings using the UI or API.

You can control how IDs are validated and other settings in the UI as described in the UI-based Settings topic.

Reporting

You can use the Tax Number Validation Statistics UI and the Validations UI to view information about validations and their statuses.

You can also use the Tax Number Validation Report report as well.

In this section

TopicDescription
Vertex ValidatorVertex Validator is the name of the feature and product that helps you to verify Tax IDs.
Validation Type per CountryRead about the supported countries and the type of validation supported for each one.
External Validation Service DowntimesYou need to be aware of upcoming downtimes for external validation sources like VIES.
Vertex for e-Commerce IntegrationsYou can use Vertex Validator as part of Vertex for e-Commerce.
Standalone Vertex ValidatorYou can use Vertex Validator as a standalone application.
Vertex O Series Cloud IntegrationVertex O Series Cloud customers can integrate Vertex Validator into their requests.
Vertex Validator UIsThis section contains topics that explain the Vertex Validator UIs.
Tax Number Validations UIUse this UI to find information about your Tax ID validation activities.
Validating Multiple Tax IDsYou can also validate multiple Tax IDs in the same request.
Message ProcessingRead about the status messages that can be returned.
Bulk Tax ID ValidationsYou can validate a batch of Tax IDs using the Bulk Validation feature.