Proyecto de Facturación Electrónica

Este proyecto implementa un sistema de facturación electrónica utilizando TypeScript. Proporciona clases y métodos para generar facturas electrónicas, gestionar pagos y calcular impuestos.

Características

• Generación de facturas electrónicas en formato XML.
• Gestión de pagos y validación de importes.
• Cálculo de impuestos y descuentos con precisión decimal.
• Formateo de números y manejo de datos tributarios.
• Tolerancia automática para diferencias menores de redondeo (≤0.01).
• Sistema de logging integrado para debugging.
• Suite de tests automatizados para garantizar calidad.

Instalación

Para instalar las dependencias del proyecto, ejecuta:

npm install

Ejemplo

import { Factura } from './src/comprobante/core/factura/factura';
import { Pago, DetalleFactura } from './src/comprobante/core';

// Crear una nueva factura
const nuevaFactura = new Factura({
infoTributaria: { /* datos tributarios */ },
fechaEmision: '2023-10-01',
direccionComprador: '123 Calle Principal',
razonSocialComprador: 'Empresa XYZ',
identificacionComprador: '1234567890',
correoComprador: '[email protected]',
telefonoComprador: '123456789',
observaciones: 'Ninguna',
propina: 0.0,
moneda: 'DOLAR',
dirEstablecimiento: 'Sucursal 1',
tipoIdentificacionComprador: '05',
obligadoContabilidad: false,
});

// Agregar detalles a la factura
nuevaFactura.detalles.push(new DetalleFactura({
codigoPrincipal: '001',
descripcion: 'Producto A',
cantidad: 2,
precioUnitario: 10.0,
descuento: 0.0,
impuestos: [/* datos de impuestos */],
}));

// Agregar un pago
nuevaFactura.addPago(new Pago({
formaPago: '01',
total: 20.0,
plazo: '30',
unidadTiempo: 'dias',
}));

// Generar el XML de la factura
const { invoiceXml, accessKey } = nuevaFactura.generateComprobanteXml();
console.log(invoiceXml);
console.log(accessKey);

Desarrollo y Testing

Compilar el proyecto

npm run build

Ejecutar tests

npm test

Herramientas de desarrollo incluidas

• test-suite.js: Suite completa de tests automatizados
• debug-factura.js: Herramienta para debugging de facturas específicas
• logger-factura.js: Sistema de logging para capturar y analizar errores

Funcionalidades de precisión

• Cálculos con precisión decimal: Evita errores de punto flotante
• Tolerancia automática: Acepta diferencias ≤0.01 centavos por redondeo
• Validación robusta: Rechaza diferencias significativas (>0.01)
• Logging detallado: Captura datos de entrada y cálculos paso a paso

Actualización del Paquete

Publicar nuevos cambios

Este paquete incluye scripts automatizados para facilitar la publicación de nuevas versiones:

1. Actualización de versión patch (para correcciones de bugs)

npm run publish:patch

2. Actualización de versión minor (para nuevas funcionalidades)

npm run publish:minor

3. Actualización de versión major (para cambios que rompen compatibilidad)

npm run publish:major

Proceso manual paso a paso

Si prefieres controlar el proceso manualmente:

1. Ejecutar tests para asegurar que todo funciona:

   npm test

2. Actualizar la versión en package.json:

   # Para patch (1.0.8 → 1.0.9)
   npm version patch
      
   # Para minor (1.0.8 → 1.1.0)
   npm version minor
      
   # Para major (1.0.8 → 2.0.0)
   npm version major

3. Publicar al registro de npm:

   npm publish

Notas importantes

• Los tests se ejecutan automáticamente antes de cada publicación (prepublishOnly)
• El comando npm version actualiza automáticamente el package.json y crea un git tag
• Asegúrate de estar autenticado en npm: npm login
• Verifica que tengas permisos de publicación en el paquete

Verificar la publicación

Después de publicar, puedes verificar que la nueva versión esté disponible:

npm view sri-invoice versions --json