Calculadora de IVA

Librería moderna para calcular IVA (Impuesto al Valor Agregado) en México con las 3 tasas oficiales: 16% (general), 8% (frontera) y 0% (exento).

🚀 Características

• ✅ 3 tasas de IVA - 16%, 8% y 0%
• ✅ Cálculo desde subtotal - Obtener IVA y total
• ✅ Cálculo inverso - Obtener subtotal desde total con IVA
• ✅ Múltiples conceptos - Calcula IVA para varios productos
• ✅ Categorías exentas - Identifica productos sin IVA
• ✅ TypeScript ready - Incluye definiciones de tipos
• ✅ Zero dependencies - Totalmente standalone
• ✅ Totalmente probado - Cobertura > 90%

📦 Instalación

npm install calculadora-iva

🔧 Uso

Calcular IVA (desde subtotal)

import { calcularIVA } from 'calculadora-iva';

// IVA al 16% (tasa general)
const resultado = calcularIVA(1000);
console.log(resultado);
// {
//   subtotal: 1000,
//   tasaIVA: 16,
//   iva: 160,
//   total: 1160
// }

// IVA al 8% (zona fronteriza)
const frontera = calcularIVA(1000, 0.08);
console.log(frontera);
// { subtotal: 1000, tasaIVA: 8, iva: 80, total: 1080 }

Calcular subtotal (desde total)

import { calcularSubtotal } from 'calculadora-iva';

// Obtener subtotal desde un total que ya incluye IVA
const desglose = calcularSubtotal(1160);
console.log(desglose);
// {
//   total: 1160,
//   tasaIVA: 16,
//   subtotal: 1000,
//   iva: 160
// }

Múltiples conceptos

import { calcularIVAMultiple } from 'calculadora-iva';

const conceptos = [
  { subtotal: 100, tasa: 0.16, descripcion: 'Laptop' },
  { subtotal: 50, tasa: 0.16, descripcion: 'Mouse' },
  { subtotal: 200, tasa: 0, descripcion: 'Libro' } // Exento
];

const factura = calcularIVAMultiple(conceptos);
console.log(factura.totales);
// {
//   subtotal: 350,
//   iva: 24,
//   total: 374
// }

Usar constantes

import { calcularIVA, IVA_GENERAL, IVA_FRONTERA, IVA_EXENTO } from 'calculadora-iva';

const general = calcularIVA(1000, IVA_GENERAL);   // 16%
const frontera = calcularIVA(1000, IVA_FRONTERA); // 8%
const exento = calcularIVA(1000, IVA_EXENTO);     // 0%

📋 API

calcularIVA(subtotal, tasa?): Object

calcularSubtotal(total, tasa?): Object

calcularTotal(subtotal, tasa?): number

calcularIVAMultiple(conceptos): Object

obtenerTasasIVA(): Object

estaExento(categoria): boolean

💰 Tasas de IVA en México

| Tasa | Porcentaje | Aplicación | |------|------------|------------| | General | 16% | Todo el país | | Fronteriza | 8% | Región fronteriza norte | | Exenta | 0% | Alimentos, medicinas, libros, educación, salud |

📄 Licencia

MIT © Gerardo Lucero

💖 Apoya el Ecosistema Mexicano OSS

• Ko-fi
• Buy Me a Coffee