facturahub-iva

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

IVA e IRPF para facturas en España: tipos 21/10/4, recargo de equivalencia, retención IRPF y desglose. TypeScript · 0 dependencias · MIT.

Instalación

npm i facturahub-iva

Uso

import { desgloseFactura, calcularIVA, baseDesdeTotal } from 'facturahub-iva';

calcularIVA(1000, 21);              // 210

desgloseFactura({ base: 1000, ivaTipo: 21, irpfTipo: 15 });
// { base: 1000, ivaTipo: 21, iva: 210, irpfTipo: 15, irpf: 150, total: 1060 }

baseDesdeTotal(1210, 21);           // 1000

API

| Función | Qué hace | |---|---| | calcularIVA(base, tipo) | Cuota de IVA | | desglose(base, tipo) | { base, tipo, cuota, total } | | desgloseConRecargo(base, tipo) | Añade recargo de equivalencia | | desgloseFactura({ base, ivaTipo, irpfTipo? }) | Totales de factura: base + IVA − IRPF | | recargoEquivalencia(tipo) | 21→5.2, 10→1.4, 4→0.5 | | retencionIRPF(base, tipo=15) | Retención (15% general, 7% nuevos autónomos) | | baseDesdeTotal(total, tipo) | Extrae la base de un total con IVA | | round2(n) | Redondeo a céntimos |

Por qué existe

Calcular bien el IVA, el recargo de equivalencia y la retención de IRPF es lo que diferencia una factura correcta de una que Hacienda rechaza. Esta librería centraliza esa lógica (con los tipos vigentes en España) sin dependencias.

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.

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