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
<PackageReference Include="ForEach.Vat.Vies" Version="0.1.0" />
<PackageVersion Include="ForEach.Vat.Vies" Version="0.1.0" />
<PackageReference Include="ForEach.Vat.Vies" />
paket add ForEach.Vat.Vies --version 0.1.0
#r "nuget: ForEach.Vat.Vies, 0.1.0"
#:package ForEach.Vat.Vies@0.1.0
#addin nuget:?package=ForEach.Vat.Vies&version=0.1.0
#tool nuget:?package=ForEach.Vat.Vies&version=0.1.0
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 | Versions 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. |
-
net10.0
- ForEach.Vat.Abstractions (>= 0.1.0)
- Microsoft.Extensions.Http (>= 10.0.5)
-
net8.0
- ForEach.Vat.Abstractions (>= 0.1.0)
- Microsoft.Extensions.Http (>= 8.0.1)
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 |