Real-time validation enables you to integrate business tax number validation into your sales journey or onboarding management. Use this endpoint for the following scenarios:

• ERP integration—Integrate validation at the point in your ERP process where it adds the most business value.
• Checkout—Perform validation before tax determination to reduce latency.
• Customer or vendor onboarding—Perform validation as part of your existing onboarding processes.

Real-time validation uses the Validate Tax Number request.

Real-time validation

Here's what happens during real-time validation (when the cache is set to 0 days):

1. Send a Validate Tax Number request to the service.

https://{service_uri}/api/v3/tax_numbers/1234567890/validate&country_code=GB&business_name=Vertex&cache_expiry_timeout_days=0&on_error=proceed

2. The service checks the tax number against the tax authority system.
3. The tax authority system returns the validation result.
4. The service returns the validation result in the Validate Tax Number response.

{
  "invoice_address": {
  "freeform_address": "",
  "country": "GB"
},
  "buyer_tax_number": "1234567890",
  "tax_deducted": true,
  "billing_country_code": "GB",
  "buyer_tax_number_format_valid": true,
  "warnings": null,
  "buyer_tax_number_valid": true,
  "buyer_tax_number_normalized": "1234567890",
  "buyer_name": "Vertex"
}

The following diagram illustrates this process.