Retrato de Carlos Manuel Hernández Vivas

@carlosmhernandezv

Desarrollo sistemas digitales que contribuyen al crecimiento de empresas en el mundo de los negocios

Integramos, mejoramos y creamos entornos de Facturación electrónica CFDI 4.0, migración de sistemas legados en Excel y VBA, trazabilidad documental y liquidación de nómina. Trabajo donde las reglas del negocio son complicadas y el margen de error es cero.

9,535 CFDI migrados y validados
16,401 documentos con cadena trazable
17 empresas en un solo sistema
~7.000 líneas de VBA revertidas

Lo que desarrollo

Cada proyecto tiene una estrategia bien pensada, objetivos y resultados personalizados a cada problema para soluciones integrales y de calidad.

Facturación electrónica CFDI 4.0 y SAT

Ingestión de comprobantes fiscales con idempotencia por UUID, lectura del Timbre Fiscal Digital y clasificación automática de material o servicio a partir de los catálogos oficiales del SAT. Diseño del conector de Descarga Masiva con e.firma.

Python · XML · catálogos c_ClaveProdServ y c_ClaveUnidad · e.firma

Ver la evidencia

Migración de sistemas legados

Ingeniería inversa de un archivo .xlsm en operación: 24 módulos VBA, cerca de 7.000 líneas y 23 hojas de cálculo, convertidos en un modelo de datos explícito. Las abreviaturas reales de las empresas salieron de leer el código, no de un catálogo.

VBA · Excel · análisis estático · PostgreSQL

Ver la evidencia

Auditoría forense de datos

Validación de un histórico de 35.365 registros contra los comprobantes fiscales reales: ninguno existía. Detectar que la fuente era dato fabricado evitó cargar 12.436 documentos falsos a un sistema con obligaciones fiscales.

SQL · conciliación de datos · validación cruzada

Ver la evidencia

Modelado de datos para información fiscal

Esquemas que preservan la integridad del comprobante — un CFDI no se corrige, se conserva — y permiten auditar la cadena documental completa. 22 tablas, folios con secuencia real en vez de MAX+1, vistas de saldo y consulta recursiva de trazabilidad.

PostgreSQL · CTE recursivos · triggers · Alembic (12 migraciones)

Ver la evidencia

Backend y API

35 endpoints sobre SQL explícito y versionado, pensados para que la consulta que corre en el servidor sea la misma que se puede leer y auditar.

Python · FastAPI · SQLAlchemy Core · Alembic · Docker

Ver la evidencia

Interfaces de captura y consulta

15 pantallas de trabajo real: trazabilidad de la cadena documental, listados con filtros y paginación, captura, asignación por lote y bandeja de clasificación. En vanilla JS, una calculadora de nómina completa con persistencia local y exportación a PDF.

React · Next.js 16 (App Router) · JavaScript ES6+ · HTML5 · CSS3

Probar la calculadora

Análisis de negocio y levantamiento

Modelado de dos cadenas de compraventa (proveedor → materialista → constructora) y auditoría contra el diagrama que entregó el cliente, que destapó que faltaba la mitad del flujo. Esa parte no es programar: es entender el negocio antes de escribir código.

Entrevistas · modelado de procesos · documentación funcional

Ver la evidencia

Generación documental

Cinco plantillas replicadas celda por celda desde el Excel original, con branding por empresa y salida en PDF sin límite de ítems. Los desprendibles de pago de la calculadora de nómina usan el mismo enfoque.

Generación de PDF · plantillas · jsPDF

Probar la calculadora

Seguridad aplicada

Validación de archivos subidos por números mágicos y no por extensión, nombres derivados del RFC para neutralizar path traversal, y sesión por cookie en lugar de autenticación básica. Cada decisión con su motivo escrito.

Validación de entrada · manejo de sesión · superficie de archivos

Ver la evidencia

Entornos reproducibles y documentación

docker-compose, devcontainer y scripts de arranque para Windows y Linux, más 15 especificaciones por módulo y una bitácora de decisiones. Documentar por qué se tomó una decisión vale más que documentar qué hace el código.

Docker · Codespaces · Git · especificación técnica

Ver la evidencia

Desarrollo asistido por IA

Uso a Claude como herramienta de desarrollo diaria, y es lo que me ha permitido ampliar el alcance técnico de mi trabajo: entrar a PostgreSQL, FastAPI y Next.js en proyectos reales, y sostener solo un sistema que de otro modo habría necesitado un equipo.

La clave no es pedir código, es dirigirlo: escribo primero un documento de contexto con las reglas de negocio y las restricciones legales, reviso cada decisión y verifico los resultados contra los datos reales. La IA acelera la ejecución; el criterio del dominio sigue siendo mío.

Claude Code · documentos de contexto · MCP

Ver la evidencia

Proyectos

Sistema de trazabilidad documental y CFDI

Construido · en fase de despliegue

Un grupo empresarial mexicano del sector construcción, con 17 empresas, operaba toda su documentación desde un Excel con cerca de 7.000 líneas de macros. Lo reemplacé por un sistema web que ingiere CFDI, genera los documentos de la cadena comercial y permite auditar cualquier factura hasta su cotización de origen.

  • 9.535 CFDI migrados
  • 16.401 documentos generados con cadena completa
  • 22 tablas · 35 endpoints · 15 pantallas
  • Cero duplicados: UUID como llave natural

Python · FastAPI · PostgreSQL · SQLAlchemy · Alembic · Next.js 16 · React · Docker

Leer el caso completo Código privado bajo licencia propietaria

Calculadora de liquidación de nómina — Colombia 2026

Demo en vivo

Herramienta de liquidación quincenal ajustada a la legislación laboral colombiana vigente: detecta recargos nocturnos y dominicales a partir de las horas de entrada y salida, reconoce el calendario de festivos y emite un desprendible de pago en PDF. Pensada para pequeños empresarios con turnos rotativos.

  • Recargo nocturno del 35% calculado por intervalos, incluidos turnos que cruzan medianoche
  • Recargo dominical y festivo del 75% con calendario oficial 2026
  • Gestión de empleados e histórico con persistencia en el navegador
  • Desprendible de pago exportable a PDF

JavaScript ES6+ · HTML5 · CSS3 · localStorage · jsPDF

Sobre mí

Me interesa el software donde las reglas no las inventa el programador: facturación electrónica, liquidación de nómina, trazabilidad documental. Son dominios en los que un error no es un detalle cosmético, sino un problema legal o fiscal para alguien.

Mi forma de trabajar empieza por escribir las reglas del negocio antes que el código. En el sistema de CFDI eso significó revertir 24 módulos de VBA y auditar el diagrama del cliente contra la realidad de sus datos; en la calculadora de nómina, dejar por escrito el marco legal antes de calcular un solo peso. Es más lento al principio y ahorra el rediseño completo después.

Trabajo con Claude como herramienta de desarrollo, y lo digo abiertamente porque ha sido parte de cómo llegué hasta aquí: me permitió pasar de HTML y CSS a levantar un backend en FastAPI, diseñar un esquema de 22 tablas en PostgreSQL y montar un frontend en Next.js dentro de un proyecto real. Lo que no delego es el criterio: las reglas fiscales y laborales las escribo yo antes de que se genere una línea de código, y los resultados los verifico contra los datos del cliente.

Vengo de formación autodidacta y de Platzi. Hoy curso Análisis y Desarrollo de Software en el SENA y me estoy especializando en analítica de datos con certificaciones de IBM SkillsBuild, sin dejar de aprender en proyectos reales con usuarios reales.

Hablemos

¿Tienes un proceso corriendo en Excel que ya no aguanta, o necesitas ordenar tu documentación fiscal? Escríbeme.