Valdit.Api.Client.VatValidation

Thanks for installing the Valdit VAT Number Validation API Client!

Getting started

Adding Validation of an European VAT-number requires only a few lines of code. In C#:

// Create a VatValidation API Client var client = new VatValidationClient();

// Setup the Vat Validation API Client with Client Credentials, point it to the API Production Endpoint client.Init("[insert_client_id]", "[insert_client_secret]", EndpointType.Production);

// Check a VAT-number var result = client.Create(VatCountryCode.NL, "806570994B01");

// The result will contain all info you need on the VAT-number, for example to access the address info use: Debug.WriteLine(result.ValditBusinessEntity.BusinessAddress.Street);

Or, in Visual Basic:

' Create a VatValidation API Client Dim client As New Valdit.Api.Client.VatValidation.VatValidationClient

' Setup the Vat Validation API Client with Client Credentials, point it to the API Sandbox Endpoint client.Init("[insert_client_id]", "[insert_client_secret]", Valdit.Api.Client.Common.EndPoints.EndpointType.SandBox)

' Check a VAT-number Dim result As Valdit.Api.Client.VatValidation.BusinessEntityInfo result = client.Create(Valdit.Api.Client.VatValidation.VatCountryCode.NL, "806570994B01")

' The result will contain all info you need on the VAT-number, for example to access the address info use Debug.WriteLine(result.ValditBusinessEntity.BusinessAddress.Street)

Optional usage of a Proxy: If you need to use a Proxy to access the Internet, you can add an additional parameter to the Init call:

// Setup a standard .Net WebProxy (1.2.3.4 just being an example IP address!!) var proxy = new WebProxy("http://1.2.3.4:8080");

// Create a VatValidation API Client var client = new VatValidationClient();

// Setup the Vat Validation API Client with Client Credentials, point it to the API Production Endpoint client.Init("[insert_client_id]", "[insert_client_secret]", EndpointType.Production, proxy);

Environments

Two separate publicly available environments are available for the Valdit VAT Number Validation API:

• For development and testing, a ‘Developer Sandbox’ is offered that runs an exact copy of the production software. The Sandbox can be used while developing your integration with the API. To use the SandBox, set the Endpoint using EndpointType.SandBox (as in the example code above).
• The Production environment is used for regular operation. You will need a subscription to use the Valdit VAT Number Validation API Production environment. For Production, set the Endpoint using EndpointType.Production.

Client Credentials

You will need a set of "client credentials", in the form of a client identifier and a client secret, to work with the API Client. If you don’t have client credentials yet, you can request them by sending an email to [e-mail] using ‘Request for Sandbox Client Credentials’ as subject. Make sure you include your own VAT Number. We will send you a reply within two business hours.

Technical Documentation

The latest technical documentation can be obtained here: https://www.valdit.com/developers/api-documentation

Contact us

Do you have a technical question on using the library? Suggestions for improving this Technical Documentation? Contact our DevOps Team at [e-mail]. We value your input!