Saltar al contenido principal

Validadores

Todos los validadores retornan boolean. Aceptan tanto entradas sin formato como con guiones.

validateCedula

Valida una cédula dominicana usando el algoritmo de Luhn (mod-10).

Argumentos

ParámetroTipoDescripción
cedulastringCédula sin formato o con guiones (ej. '40220579912' o '402-2057991-2')

Retorna booleantrue si es válida, false en caso contrario.

Ejemplo

import { validateCedula } from 'dr-utils'

validateCedula('40220579912') // true
validateCedula('402-2057991-2') // true (acepta guiones)
validateCedula('12345678901') // false

validateRNC

Valida un RNC (Registro Nacional del Contribuyente) dominicano usando el algoritmo de Luhn. También acepta cédulas de 11 dígitos como RNCs válidos.

Argumentos

ParámetroTipoDescripción
rncstringRNC sin formato o con guiones (ej. '130500292' o '130-50029-2')

Retorna booleantrue si es válido, false en caso contrario.

Ejemplo

import { validateRNC } from 'dr-utils'

validateRNC('130500292') // true
validateRNC('130-50029-2') // true (acepta guiones)

validateNCF

Valida un NCF (Número de Comprobante Fiscal) dominicano. Soporta tanto el formato físico (11 caracteres) como el electrónico e-CF (13 caracteres).

Argumentos

ParámetroTipoDescripción
ncfstringCadena NCF a validar

Retorna booleantrue si es válido, false en caso contrario.

Ejemplo

import { validateNCF } from 'dr-utils'

validateNCF('B0183920391') // true (físico, 11 caracteres)
validateNCF('E319123402392') // true (electrónico e-CF, 13 caracteres)

validatePhoneNumber

Valida un número de teléfono dominicano. Acepta varios formatos incluyendo local, formateado y con código de país. Rechaza números no dominicanos.

Argumentos

ParámetroTipoDescripción
numberstringNúmero de teléfono en cualquier formato dominicano común

Retorna booleantrue si es válido, false en caso contrario.

Ejemplo

import { validatePhoneNumber } from 'dr-utils'

validatePhoneNumber('8092201111') // true
validatePhoneNumber('(829) 555-3000') // true
validatePhoneNumber('18492001234') // true (con código de país)
validatePhoneNumber('+1 (781) 575 4238') // false (no es número dominicano)

validatePlate

Valida una placa de vehículo dominicana contra la lista oficial de categorías de la DGII.

Argumentos

ParámetroTipoDescripción
platestringCadena de placa (sin distinción entre mayúsculas y minúsculas)

Retorna booleantrue si es válida, false en caso contrario.

Ejemplo

import { validatePlate } from 'dr-utils'

validatePlate('A123456') // true (privado)
validatePlate('EL12345') // true (eléctrico)
validatePlate('ZZ12345') // false (categoría desconocida)

Categorías de placas

Una letra: A (Automóvil), B (Interurbano público), C (Turístico), D (Autobús público urbano), F (Remolque), G (Jeep), H (Ambulancia), I (Autobús privado), J (Montacargas), K (Motocicleta), L (Carga), M (Carro fúnebre), P (Autobús turístico), R (Interurbano público), S (Volteo), T (Automóvil público urbano), U (Máquinas pesadas), X (Exhibición), Z (Exonerada)

Dos letras: OE (Ejército Nacional), OF (Fuerza Aérea), OM (Marina de Guerra), OP (Policía Nacional), EA/ED/EG/EI/EL/EM (Exonerada estatal — norma No. 14-2011 DGII), VC (Consular), WD (Diplomática), OI (Organismo internacional), EX/YX/NZ (Exonerada), DD (Dealer)