Volver a proyectos
2025 - Actualidad Construido

B2Pago

@ PrevalentWare · Cliente sector financiero

B2Pago

Sistema de automatización para la liquidación quincenal de comisiones comerciales construido sobre n8n. Implementa más de 60 reglas de negocio incluyendo lógica tributaria colombiana completa (Art. 383, RETEICA, IVA, ReteIVA, seguridad social) y un esquema de retención y liberación de pagos cuando la comisión no cubre la cotización a SS. Acompañado por un backend de soporte en Bun + Hono + TypeScript desplegado en AWS Lambda con infraestructura como código (CDK).

Características:

  • Más de 60 reglas de negocio orquestadas en n8n, con lógica tributaria colombiana completa: tabla progresiva del Art. 383 (7 rangos UVT), RETEICA, IVA, ReteIVA y seguridad social con cálculo de IBC (40% del acumulado, piso SMMLV, tope 25 SMMLV)
  • Esquema de retención/liberación: si la comisión no cubre la cotización a SS se retiene "bruta limpia" (sin retenciones) y se libera intra-mes —agrupándose con la siguiente comisión— o fin de mes —como registro sintético en el mes siguiente—
  • Recálculo progresivo de RTI Art. 383 y SS sobre el acumulado mensual con retención del diferencial vs pagos previos; distribución proporcional por bruta y por contribución al pool en la liberación intra-mes
  • Workarounds técnicos sobre limitaciones de n8n: estrategia pre-loop para acumulados (los nodos SQL no comparten visibilidad de INSERTs en el loop) y uso de $getWorkflowStaticData('global') como bus de estado mutable entre iteraciones
  • Validaciones robustas con normalización canónica (insensible a mayúsculas, tildes y espacios), rechazo de valores espurios de Excel (NaN, #N/A, #REF!, #VALUE!) y validaciones cruzadas régimen × IVA × facturación
  • Backend de soporte en Bun + Hono + TypeScript desplegado en AWS Lambda; infraestructura como código en CDK multi-stack (network, dev, test, prod, CI/CD)
  • Persistencia en SQL Server (RDS) con Prisma + adapter MSSQL, autorización con Casbin (RBAC), autenticación con Better-Auth + Cognito, archivos en S3 y secretos en Secrets Manager
  • UPSERT idempotente del maestro de comisionistas, generación de reportes XLSX consolidados y de excepciones, e integración con SharePoint para ingesta y entrega de archivos

Tecnologías

  • n8n
  • TypeScript
  • AWS
  • SQL Server
  • Prisma