Dinaup.Validations

El módulo de validaciones del paquete Dinaup comprueba datos fiscales y geográficos antes de guardarlos: formato de NIF y VAT, alta en VIES y en la AEAT, territorialidad del IVA, códigos postales, provincias, municipios del INE y países. Los módulos ValidationUtils, Municipios y CodigosPostales están en el namespace Dinaup; las consultas a VIES y AEAT se hacen sobre un DinaupClientC conectado.

Antes de empezar

• Paquete Dinaup instalado. Ver SDK .NET.
• Para CheckVATViesAsync y CheckVATAEATAsync, un cliente conectado. Ver Cliente Dinaup.

using Dinaup;

Códigos postales y provincias

Console.WriteLine(ValidationUtils.IsSpanishPostalCode("03201")); // True
Console.WriteLine(ValidationUtils.IsSpanishPostalCode("99999")); // False
Console.WriteLine(ValidationUtils.GetSpainProvinceFromPostalCode("28013")); // Madrid

foreach (var m in CodigosPostales.GetMunicipiosByCP("03201"))
    Console.WriteLine($"{m.CodigoINE} {m.Nombre}");

Municipios del INE

El módulo Municipios embebe la relación oficial de municipios del INE y la expone con índices por código y por provincia. Cada MunicipioData trae CodigoProvincia (dos dígitos), CodigoMunicipio (tres), DigitoControl, Nombre tal como lo publica el INE, CodigoINE (cinco dígitos) y CodigoINEConDC (seis).

var elche = Municipios.GetMunicipio("Elche", "03");
Console.WriteLine(elche.CodigoINE);   // 03065

Nombres de localidad

ValidationUtils.NormalizeLocationName(name) convierte nombres en lenguas cooficiales al nombre en castellano (elx a Elche, Bilbo a Bilbao, Girona a Gerona). Si llega Alicante/Alacant, se queda con el primer tramo. Los nombres que no reconoce vuelven en minúsculas.

ValidationUtils.GetNormalizedAddressDataWithGoogleMaps(codigoPostal, pais, provincia, municipio, apiKey, language = "es") consulta la API de Google Maps y devuelve un NormalizedAddress con Country, CountryCode, Province, City y PostalCode.

Países

CountryData tiene ISO2, ENName, ESName y AllNames. ValidationUtils.AllCountryData es la lista completa y ValidationUtils.CountryEuCodes los códigos de la Unión Europea.

var spain = ValidationUtils.GetCountry("España");
Console.WriteLine($"{spain.ISO2} - {spain.ENName}");   // ES - Spain

Console.WriteLine(ValidationUtils.IsEuCountryCode("DE")); // True
Console.WriteLine(ValidationUtils.IsEuCountryCode("US")); // False

Reglas de región

ValidationUtils.IsLocationMatched(regionRule, isIncludeMode, inputCountryCode, inputProvinceCode, inputPostalCode) decide si una ubicación cumple una regla de regiones. regionRule es una lista separada por comas de patrones: ES (país), ES[Tenerife] (provincia, por nombre o por código postal), ES[Canarias] (códigos postales 35 y 38) y ES[!Tenerife] para negar una provincia. Con isIncludeMode en true solo pasan las ubicaciones que coinciden; en false, pasan todas salvo las que coinciden. Una regla vacía deja pasar todo y un país vacío no pasa nunca. La negación se evalúa antes y gana en los dos modos.

// Todo menos Canarias
bool enviable = ValidationUtils.IsLocationMatched("ES[!Canarias]", false, "ES", "Alicante", "03201");   // True
bool canarias = ValidationUtils.IsLocationMatched("ES[!Canarias]", false, "ES", "Las Palmas", "35001"); // False

// Solo España y Portugal
bool iberia = ValidationUtils.IsLocationMatched("ES,PT", true, "FR", "", "75001");   // False

NIF y VAT

Console.WriteLine(ValidationUtils.IsVIESVatFormat("ES123456789")); // True
Console.WriteLine(ValidationUtils.IsVIESVatFormat("US123456789")); // False

Console.WriteLine(ValidationUtils.IsSpanishBusinessNIFFormat("B12345678")); // True
Console.WriteLine(ValidationUtils.IsSpanishBusinessNIFFormat("X1234567"));  // False

Consultar VIES y AEAT

Las dos consultas salen del servidor de Dinaup y se llaman sobre el cliente conectado.

• CheckVATViesAsync(vatid) pregunta a VIES si el NIF está dado de alta como operador intracomunitario. Devuelve bool?: true alta confirmada, false no es operador (o formato inválido, o país no comunitario) y null si VIES no responde.

  bool? esIntracomunitario = await dinaupClient.CheckVATViesAsync("ESB12345678");

• CheckVATAEATAsync(vatid, name) pregunta a la AEAT si el NIF y el nombre coinciden. Devuelve un CheckVATAEATResponse con Identificado, Nif, Nombre y Resultado. Identificado es true cuando Resultado vale IDENTIFICADO.

  var result = await dinaupClient.CheckVATAEATAsync("12345678Z", "Ana López Martín");
  Console.WriteLine(result.Identificado); // True solo si la AEAT identifica ese NIF con ese nombre

  Si la AEAT no contesta, no lanza excepción: devuelve Resultado vacío, que es "sin veredicto" y no un rechazo. Con un NIF vacío o de menos de 4 caracteres devuelve la respuesta vacía sin preguntar.

Territorialidad del IVA

ValidationUtils.ClassifyVatTerritoriality(nif, countryCode, postalCode, isVies) clasifica una operación por el lugar de tributación y devuelve un VatTerritoriality:

var tipo = ValidationUtils.ClassifyVatTerritoriality("B12345678", "ES", "03201", false);
Console.WriteLine(tipo); // National

var tipo2 = ValidationUtils.ClassifyVatTerritoriality("DE123456789", "DE", "81549", true);
Console.WriteLine(tipo2); // IntraCommunity

Para escribir el resultado en una venta, el campo de impuestos de la sección está en el Catálogo de secciones del núcleo.