Sistema fiscal en producción

Sistema de Facturación Electrónica DTE

Plataforma fiscal en producción que conecta un sistema legado con el flujo moderno de facturación electrónica, reduciendo trabajo manual y mejorando la trazabilidad.

herramientas

  • Next.js
  • TypeScript
  • PostgreSQL
  • AWS
  • JWT
  • Docker
  • Playwright
  • Zod
  • Cloudflare
  • ESLint
  • pnpm
Dashboard principal del sistema DTE de Construfijaciones
1 / 8

00 · Impacto real

Una operación fiscal más rápida y rastreable

  • +300 facturas mensuales gestionadas en producción
  • Ahorro de más de la mitad del tiempo operativo de facturación
  • Reducción de doble digitación entre sistema legado y DTE
  • Integración con Ministerio de Hacienda, PDF, correo y almacenamiento
  • Mayor trazabilidad de documentos emitidos, enviados y respaldados
  • Control interno sobre el flujo fiscal sin depender completamente de terceros

01 · Problema operativo

Un flujo fiscal moderno conectado a un sistema legado

La empresa necesitaba adaptarse a la facturación electrónica exigida en El Salvador, pero su operación dependía de un sistema legado sin integración directa. El proceso anterior obligaba a repetir información, revisar datos manualmente y emitir documentos con demasiados pasos, aumentando tiempo operativo y riesgo de errores.

02 · Solución implementada

Automatización, emisión, firma, envío y respaldo

Construcción de un sistema web full-stack para emitir Documentos Tributarios Electrónicos, tomar datos desde el sistema legado mediante automatización autorizada con Playwright, validar la información, generar el JSON fiscal, firmarlo, enviarlo al Ministerio de Hacienda, generar PDF, enviar correos y almacenar respaldos de forma segura.

03 · Módulos e integraciones

Las piezas que sostienen el flujo completo de DTE

  • Emisión de Factura, Crédito Fiscal, Nota de Crédito y Sujeto Excluido
  • Obtención de datos desde sistema legado mediante Playwright
  • Generación y validación de JSON según esquemas fiscales
  • Firma digital de documentos con JWT RS512
  • Envío de documentos al Ministerio de Hacienda
  • Generación de PDF con representación gráfica del DTE
  • Envío de correos transaccionales a clientes
  • Almacenamiento de JSON y PDF en AWS S3
  • Acceso seguro a documentos mediante URLs firmadas
  • Ciclos de vida de almacenamiento para respaldos a largo plazo
  • Autenticación, sesiones y control de acceso interno
  • Reportes y consulta de documentos emitidos

04 · Decisiones técnicas

Tecnología aplicada a un proceso fiscal real

  • Next.js como framework full-stack para interfaz y lógica del sistema
  • TypeScript para modelar flujos fiscales complejos con mayor seguridad
  • Playwright para automatizar extracción autorizada desde el sistema legado
  • JWT y firma RS512 para cumplir el flujo de firmado digital
  • PDFKit para generar la representación gráfica del documento
  • AWS S3 para almacenar documentos fiscales y respaldos
  • URLs firmadas para acceso temporal y seguro a archivos
  • Docker para desplegar componentes con dependencias como Playwright

05 · Mi rol

Desarrollo completo, implementación y mantenimiento

Diseñé, desarrollé, implementé, mantuve y desplegué el sistema de extremo a extremo. Trabajé la lógica fiscal, experiencia de emisión, integración con servicios externos, generación de PDF, firma digital, autenticación, almacenamiento y adaptación del flujo operativo real de la empresa.

06 · Experiencia de emisión

Menos pasos para una tarea crítica

La interfaz se diseñó para reducir el proceso a pasos mínimos: seleccionar tipo de documento, ingresar serie y correlativo del sistema legado, cargar la información, revisar datos clave y emitir. El objetivo fue que una tarea crítica y repetitiva pudiera completarse rápido, con validaciones claras y menos riesgo de error humano.

07 · Aprendizaje principal

Un sistema fiscal exige precisión, trazabilidad y criterio

El mayor aprendizaje fue entender que un sistema fiscal no se resuelve solo con código: requiere dominar reglas de negocio, esquemas oficiales, validaciones estrictas, errores humanos, trazabilidad, despliegue y confianza operativa. También reforcé el valor de adaptar tecnología moderna a sistemas legados sin romper el flujo real de trabajo.

Trabajemos juntos

Si tu proyecto necesita avanzar con criterio, hablemos.

Puedo ayudarte a convertir una idea, proceso interno o problema operativo en una herramienta clara, rápida y mantenible.