Los comercios que venden por Mercado Libre, Dropi, Falabella y Éxito enfrentan un gran dolor de cabeza:
tienen que entrar a mano a cada tienda, descargar cada venta, digitar la cédula del cliente en el portal contable de Siigo,
generar la Factura Electrónica ante la DIAN y luego subir el archivo PDF a la tienda.
✓Cero digitación manual: 24/7 sin personas pasando datos.
✓Cero rechazos DIAN: Valida el documento en RUES antes de facturar.
✓Conciliación automática: Recibo de caja y comisiones cuadradas al centavo.
🛒
1. Qué Conecta (Fuentes)
Se conecta vía API a las tiendas online del cliente para detectar compras en tiempo real:
Mercado Libre: Lee órdenes pagadas y paquetes de envío.
Dropi: Captura ventas de pago anticipado y contra entrega.
Falabella & Éxito: Ingesta órdenes de marketplace.
⚙️
2. El Motor que lo Mueve
Todo el cerebro operativo corre sobre n8n en contenedores Docker:
Orquestación Modular: Sub-workflows atómicos para cada tarea.
Idempotencia Estricta: Clave única para evitar cobrar o facturar dos veces.
Reintentos Automáticos: Si la red falla, reintenta sin caerse.
🏛️
3. Dónde Impacta (Destinos)
Cierra el ciclo legal y contable ante los entes oficiales:
RUES: Valida si el cliente tiene matrícula activa o cancelada.
Siigo: Emite la Factura Electrónica (FV-27860) con IVA 19%.
Recibo de Caja: Genera el comprobante RC-27862 que salda la deuda a $0.
El Rol de la Persona que Usará la Interfaz
La interfaz que el equipo de frontend va a construir es un Centro de Comando y Control para el equipo de finanzas y operaciones del cliente.
El 95% de las órdenes se facturan y concilian solas en segundo plano. La interfaz existe para:
👀 Monitorear el pulso del día: Saber cuánta plata se vendió hoy y cuántas facturas se emitieron legalmente.
🚨 Gestionar Excepciones: Si un comprador puso mal su cédula y RUES lo bloquea por seguridad, el operador ve la alerta, corrige el número y le da a "Reintentar".
⚡ Sincronización Inmediata: Si entra una venta grande y quieren facturarla en ese segundo sin esperar al reloj automático de 15 minutos, presionan "Sincronizar Canales".
1
Filtro por Canal
El operador puede ver rápidamente solo las órdenes de Mercado Libre, o aislar las de Dropi con un solo clic en las pestañas superiores.
2
Estados de un Vistazo
Cada orden tiene un distintivo de color claro: Verde (100% conciliada), Azul (Facturada en Siigo), o Rojo (Bloqueada por RUES para revisión).
3
Timeline del Pedido
Al hacer clic en cualquier orden, se abre un panel lateral con los 5 pasos completados, el número de factura oficial (ej. `FV-1-1003`) y el botón para descargar el PDF.
Prototipo Interactivo del Dashboard
Este es el modelo funcional de la pantalla que el equipo de frontend va a construir:
● Sincronizado con Siigo y Marketplaces
Canal
ID Orden
Comprador
Valor Total
Estado Flujo
Factura Siigo
Recibo Caja
Acción
Tokens de Diseño Recomendados (UI Kit)
Para mantener la coherencia visual con la identidad de Aztec Lab, el equipo de frontend puede usar estos tokens y componentes: