facturahub-nif-validator

Parte del ecosistema FacturaHub — facturación en España, Verifactu, IVA, Modelo 303 y automatización fiscal con IA.

Valida NIF, DNI, NIE y CIF españoles con el algoritmo oficial de la AEAT. TypeScript · 0 dependencias · MIT.

Validate Spanish tax IDs (NIF / DNI / NIE / CIF) with the official check-character algorithm.

Instalación

npm i facturahub-nif-validator

Uso

import { isValidNIF, validateNIF } from 'facturahub-nif-validator';

isValidNIF('12345678Z');   // true  (DNI)
isValidNIF('X1234567L');   // true  (NIE)
isValidNIF('A58818501');   // true  (CIF)
isValidNIF('B00000000');   // false

validateNIF(' a-58818501 ');
// { valid: true, type: 'cif', normalized: 'A58818501' }

Acepta el valor con espacios, puntos o guiones — se normaliza solo.

API

| Función | Devuelve | Qué hace | |---|---|---| | isValidNIF(value) | boolean | Valida cualquier ID fiscal (DNI/NIE/CIF) | | validateNIF(value) | { valid, type, normalized } | Valida y clasifica ('dni' \| 'nie' \| 'cif' \| 'unknown') | | isValidDNI(value) | boolean | Solo DNI/NIF de persona física | | isValidNIE(value) | boolean | Solo NIE (X/Y/Z) | | isValidCIF(value) | boolean | Solo CIF (entidades) | | normalize(value) | string | Mayúsculas, sin espacios/puntos/guiones | | dniControlLetter(n) | string | Letra de control de un número de 8 dígitos |

Por qué existe

Al emitir una factura en España necesitas el NIF/CIF correcto del cliente: un dígito de control mal puesto se traduce en facturas rechazadas y problemas con Hacienda. Esta librería implementa los algoritmos oficiales (DNI, NIE y CIF) sin dependencias, para validarlo antes de emitir.

Hecho por FacturaHub — facturación con IA para autónomos en España: emite Verifactu, lleva tu IVA y Modelo 303 y factura por WhatsApp. Gratis.

¿Necesitas validar NIFs sin escribir código? Usa el validador online gratis.

Ecosistema FacturaHub

• 🌐 FacturaHub — la app (gratis, Verifactu incluido)
• 🔌 facturahub-api — API REST + OpenAPI 3.1
• 🤖 facturahub-mcp — servidor MCP (Claude, Cursor, ChatGPT)
• 🧾 facturahub-verifactu — Verifactu por API
• 🧮 Librerías: nif-validator · iva · iban-es · factura-number · verifactu-qr · verifactu-hash · modelo-303
• ⚙️ Automatización: facturahub-n8n · n8n-nodes-facturahub · facturahub-woocommerce · facturahub-shopify

Temas: Verifactu · Facturación electrónica · IVA · Modelo 303 · AEAT · NIF/CIF · Autónomos · MCP · IA · España