ForEach.Vat.Vies 0.1.0

dotnet add package ForEach.Vat.Vies --version 0.1.0
                    
NuGet\Install-Package ForEach.Vat.Vies -Version 0.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ForEach.Vat.Vies" Version="0.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ForEach.Vat.Vies" Version="0.1.0" />
                    
Directory.Packages.props
<PackageReference Include="ForEach.Vat.Vies" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add ForEach.Vat.Vies --version 0.1.0
                    
#r "nuget: ForEach.Vat.Vies, 0.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package ForEach.Vat.Vies@0.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=ForEach.Vat.Vies&version=0.1.0
                    
Install as a Cake Addin
#tool nuget:?package=ForEach.Vat.Vies&version=0.1.0
                    
Install as a Cake Tool

ForEach.Vat.Vies

The VIES implementation of IVatNumberValidator (package ForEach.Vat.Abstractions): asks the VIES REST API of the European Commission whether a VAT number is registered in an EU member state.

services.AddViesVatValidation(options => options.DefaultCountryCode = "BE")
        .AddStandardResilienceHandler();   // optional: timeout and retry live on the named HttpClient

// ...
VatValidationResult result = await validator.ValidateAsync("BE 0202.239.951", cancellationToken);
Member What it does
AddViesVatValidation Registers IVatNumberValidator as a typed client on the named HttpClient ViesVatOptions.HttpClientName ("Vies") and returns its IHttpClientBuilder, so the host can add handlers or resilience.
ViesVatOptions.BaseUrl The VIES REST root without a trailing slash (one is tolerated). Defaults to the public EC endpoint.
ViesVatOptions.DefaultCountryCode The country of a number typed without a prefix. null (default) rejects such a number as InvalidFormat.

The call is GET {BaseUrl}/{country}/vat/{number}. The number is split with VatNumber.TryParse, so the leading 0 of a Belgian number is restored. Outcomes:

VIES / failure Result
isValid true / false Valid / Invalid, with name, address (newlines joined by , ), request date and VIES' userError as ServiceStatus
non-success HTTP status Unverified, ServiceRejected, ErrorDetail = the status name; logged as a warning with the body
HttpRequestException Unverified, Unavailable; logged as an error
TaskCanceledException (timeout or cancel) Unverified, TimedOut
malformed body or JSON null Unverified, InvalidResponse

The number itself is never logged, only the country. No timeout is set by the validator: attach one to the named HttpClient. A host whose resilience pipeline throws its own exceptions (for example a rate limiter rejection) should translate them to HttpRequestException if it wants an Unavailable result for them.

Targets net8.0 and net10.0. The only third-party dependency is Microsoft.Extensions.Http. Source and release notes: https://github.com/foreach-rs/nuget-releases/tree/main/packages/Vat

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0 58 11/19/2026