Saltar al contenido principal

Get regex patterns for field validation by country

GET 
/company/country/regex/:code

Devuelve patrones de expresión regular organizados por código de país para validar formatos específicos de campos como identificaciones fiscales, números de teléfono, matrículas de vehículos y direcciones de correo electrónico.

Objetivo​

Permitir la validación en el cliente y en el servidor de datos proporcionados por el usuario según los requisitos de formato específicos de cada país. Esto garantiza la calidad de los datos y el cumplimiento de los estándares regionales.

Casos de uso​

  • Validar números de identificación fiscal (NIF, CIF, VAT) durante el registro de empresas
  • Verificar formatos de número de teléfono antes de almacenar información de contacto
  • Comprobar formatos de matrícula al registrar camiones
  • Validar formatos de correo electrónico con un patrón genérico

Flujo de validación​

flowchart TD
  A[Solicitud del cliente con parámetro code] --> B{¿Tipo de código válido?}
  B -->|taxID| C[Devolver patrones de ID fiscal para 15 países]
  B -->|phoneNumber| D[Devolver patrones telefónicos para 46+ países]
  B -->|plate| E[Devolver patrones de matrícula para 3 países]
  B -->|email| F[Devolver patrón genérico de email]
  B -->|Otro| G[Devolver objeto vacío]
  C --> H[200 OK con mapa país:regex]
  D --> H
  E --> H
  F --> H
  G --> H

Estructura de respuesta​

La respuesta es un mapa donde las claves son códigos de país (códigos ISO de 2 letras) y los valores son cadenas regex.

Notas importantes:

  • Los códigos de país pueden estar en MAYÚSCULAS o minúsculas según el tipo de validación
  • taxID: códigos en minúsculas (es, pt, fr, it, de, lu, pl, se, dk, nl, be, gb, ie, ad, ch)
  • phoneNumber: códigos en MAYÚSCULAS + "ALL" para el patrón genérico
  • plate: códigos en MAYÚSCULAS (ES, FR, PT)
  • email: solo clave "ALL" con regex genérica de correo electrónico
  • Los códigos inválidos devuelven un objeto de datos vacío {status: 200, data: {}}
  • Los patrones regex se cargan desde src/features/common/regEx.json

Autenticación​

Este es un endpoint PÚBLICO. No requiere autenticación.

Ejemplos de solicitud:

# Obtener patrones de validación de ID fiscal para todos los países soportados
GET /company/country/regex/taxID

# Obtener patrones de validación de número de teléfono
GET /company/country/regex/phoneNumber

# Obtener patrones de validación de matrícula de vehículo
GET /company/country/regex/plate

# Obtener patrón de validación de correo electrónico
GET /company/country/regex/email

Ejemplo de integración:

// Obtener patrones de ID fiscal
const response = await fetch('/company/country/regex/taxID');
const { data } = await response.json();

// Validar NIF español
const esNifRegex = new RegExp(data.es);
const isValid = esNifRegex.test("B12345678"); // true para formato válido

// Validar ID fiscal portugués
const ptNifRegex = new RegExp(data.pt);
const isValidPt = ptNifRegex.test("123456789"); // true para 9 dígitos

Request​

Responses​

Operación exitosa. Devuelve un diccionario de patrones regex organizados por código de país.

La estructura de respuesta siempre es {status: 200, data: {...}} donde data contiene el mapa de regex.

Cobertura por tipo:

  • taxID: 15 países europeos
  • phoneNumber: 46+ países incluyendo el patrón genérico "ALL"
  • plate: 3 países (ES, FR, PT)
  • email: Patrón genérico con clave "ALL"
Response Headers