Tienda online + taller integrado, hecho a la medida para un taller de motos Hero en Medellín.
El problema que resolvemos
Cuando un cliente llega a Convergencia Motos con su Hero Xpulse, Splendor o Hunk, hay dos necesidades en paralelo:
- Comprar repuestos o accesorios — filtros, bujías, cascos, guayas, todo lo que su moto necesita.
- Dejar la moto en el taller — desde un cambio de aceite hasta una reparación completa.
La mayoría de ecommerce resuelven solo lo primero. Nosotros construimos una plataforma que integra las dos líneas de negocio sin que el administrador tenga que manejar 5 herramientas distintas.
┌─────────────────────────────────────────────────────────────┐
│ CONVERGENCIA MOTOS │
├────────────────────────┬────────────────────────────────────┤
│ │ │
│ ECOMMERCE │ TALLER (sub-app interna) │
│ │ │
│ • Catálogo Hero │ • Recepción de motos │
│ • Carrito + pagos │ • Escaneo de licencia (OCR) │
│ • Seguimiento orden │ • Cotización y diagnóstico │
│ • Rastreo por email │ • Galería de fotos del proceso │
│ • Pagos Wompi │ • Chat con el cliente │
│ (Nequi, tarjeta, │ • PDF de orden firmada │
│ Bancolombia, PSE) │ • Vista pública para el cliente │
│ │ (sin login) │
└────────────────────────┴────────────────────────────────────┘El ecommerce — lo que el cliente ve
Recorrido del comprador
Landing → Catálogo → Producto → Carrito → Checkout → Pago Wompi → Confirmación
│ │ │ │ │ │ │
│ │ │ │ │ │ ▼
│ │ │ │ │ │ Email con
│ │ │ │ │ │ link de rastreo
│ │ │ │ │ │
└─────────┴──────────┴──────────┴──────────┴───────────┘
Navegación sin fricción, optimizada para móvilLo que hace diferente al ecommerce
Pagos multi-método con Wompi
- Tarjeta de crédito/débito
- Nequi (pago asincrónico vía push en el celular)
- Bancolombia Transfer
- PSE (cualquier banco colombiano)
Envío inteligente
- Tarifas dinámicas configurables desde el panel admin
- Envío gratis al superar cierto monto (configurable)
- Cotización en tiempo real según la ciudad/departamento de destino
- Zonas con tarifas específicas + integración con Envia API
Experiencia de tracking de orden
- Cliente recibe un email con un link único
- Página pública de rastreo sin necesidad de login (para compras como invitado)
- Auto-refresh mientras el pago se procesa (crítico para Nequi, que puede tardar minutos)
- Notificaciones por email en cada cambio de estado: pagado, enviado, entregado
Promociones en vivo
- Banners configurables desde admin
- Descuentos por producto con fecha de inicio/fin
- Popup de promoción que aparece al cliente (configurable)
- Cupones con reglas personalizadas
Recuperación de carrito abandonado
Si un cliente deja productos en el carrito y se va, recibe un recordatorio por email automático. Reduce abandono y recupera ventas que se hubieran perdido.
El taller — la sub-app interna
Esta es la parte que ningún ecommerce estándar ofrece. El equipo del taller usa una app dentro del mismo dominio pero con su propio flujo, diseñada para el día a día operativo.
Flujo de recepción de una moto
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ CLIENTE │ │ VEHÍCULO │ │ ORDEN │ │ SEGUIMIENTO │
│ │ → │ │ → │ │ → │ │
│ • Datos │ │ • Foto de │ │ • Servicios │ │ • Estados │
│ • Teléfono │ │ licencia │ │ • Precios │ │ • Fotos del │
│ • Email │ │ • OCR auto- │ │ • Firma │ │ proceso │
│ │ │ llena datos│ │ digital │ │ • Chat │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘Características que aceleran el trabajo del taller
Escaneo OCR de licencia de tránsito
Operario abre la orden desde el computador → se genera un QR en pantalla → operario escanea el QR con el celular → toma foto de la licencia → Google Cloud Vision API lee los datos (placa, motor, chasis, propietario) → el computador auto-llena el formulario en tiempo real.
Elimina 3-5 minutos de digitación manual por moto y evita errores de transcripción.
Desktop Móvil del operario
┌──────────┐ ┌──────────┐
│ Nueva │ genera │ Foto de │
│ orden │────QR───────▶│ licencia │
│ │ │ │
│ Form │◀──OCR result─│ Sube a │
│ auto- │ │ backend │
│ lleno │ │ │
└──────────┘ └──────────┘
▲ │
└────────Redis pub/sub────┘
(la foto se procesa con Google Vision
y el desktop recibe el resultado)Vista pública para el cliente
- Al crear la orden, se genera un link único (UUID como token)
- Cliente abre ese link desde su celular SIN cuenta
- Ve: estado actual de su moto, fotos del proceso, totales, firma digital
- Puede chatear con el taller directamente desde ahí
Galería de fotos del proceso
- Mecánicos suben fotos del antes/durante/después del trabajo
- Cliente las ve en su vista pública
- Transparencia total: el cliente confía porque ve lo que pasa
PDF de orden de ingreso firmada
- Al recibir la moto, se genera un PDF con los datos + firma digital del cliente
- Queda archivada como respaldo legal
- Ambas partes tienen el documento
Chat cliente-taller
- El cliente puede preguntar algo desde su vista pública
- El mecánico responde desde el panel del taller
- Reduce llamadas telefónicas y deja historial escrito
Arquitectura — cómo está construido
No usamos una plataforma SaaS cerrada. Todo es código propio, construido para durar y escalar.
┌─────────────────────────────────────────────────────────────────┐
│ FRONTEND │
│ Next.js 14 + TypeScript + Tailwind │
│ │
│ / /admin /taller │
│ (tienda pública) (panel admin) (app del taller) │
└─────────────────────────────┬───────────────────────────────────┘
│
HTTPS / REST
│
┌─────────────────────────────▼───────────────────────────────────┐
│ BACKEND │
│ NestJS + TypeORM + JWT │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Órdenes │ │ Pagos │ │ Taller │ │ Email │ │
│ │ │ │ Wompi │ │ │ │ (Resend) │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │Inventario│ │ Envíos │ │ Cupones │ │Reportes │ │
│ │(multi- │ │ Dinámico │ │ │ │ admin │ │
│ │ bodega) │ │ │ │ │ │ │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
└───────────┬─────────────────┬───────────────────┬───────────────┘
│ │ │
┌────────▼────────┐ ┌──────▼──────┐ ┌────────▼────────┐
│ PostgreSQL │ │ Redis │ │ Google Cloud │
│ (datos de │ │ (cache + │ │ Vision │
│ órdenes, │ │ sesiones + │ │ (OCR licencias)│
│ productos, │ │ OCR) │ └─────────────────┘
│ taller) │ │ │
└─────────────────┘ └─────────────┘Servicios externos
| Servicio | Para qué |
|---|---|
| Wompi | Pasarela de pagos (tarjetas, Nequi, PSE, Bancolombia) |
| Resend | Envío de emails transaccionales |
| Google Vision | OCR de licencias de tránsito |
| Envia API | Cotización de envíos a nivel nacional |
| Seenode | Hosting (staging + producción) |
Lo que hace al proyecto robusto
1. Pagos confiables end-to-end
El pago no se da por hecho cuando el cliente da clic. Tenemos múltiples mecanismos de confirmación:
Cliente paga ─┬─▶ Wompi webhook ──▶ Actualiza orden a PAID ──▶ Email de confirmación
│
├─▶ Redirect a /checkout/success ──▶ Verifica pago
│
└─▶ Reconciliación manual (admin) ──▶ Consulta Wompi → sincronizaSi algún mecanismo falla, otros lo respaldan. La orden no se marca pagada hasta que Wompi confirma. El cliente no recibe "Orden Confirmada" antes de pagar.
2. Inventario multi-bodega
Convergencia tiene productos en diferentes ubicaciones físicas. El sistema sabe:
- Cuánto hay en cada bodega
- Cuánto está reservado (para órdenes pendientes de pago)
- Cuándo avisar al admin para reabastecer
Reservas automáticas al crear orden, liberación automática si el pago falla.
3. Seguridad y permisos
- Admin: acceso a todo
- Cliente registrado: sus propias órdenes, lista de deseos, direcciones guardadas
- Invitado: puede comprar sin cuenta, rastrea por email + ID de orden
- Taller: panel separado con sus propios permisos
JWT + guards en cada endpoint crítico.
4. Emails transaccionales profesionales
No se usa SMTP casero — va por Resend con plantillas React Email renderizadas server-side:
- Bienvenida al registrar cuenta
- Confirmación de orden (solo cuando se paga)
- Actualización de estado (procesando, enviado, entregado)
- Pago rechazado con instrucciones
- Recuperación de contraseña
- Productos de nuevo en stock
- Carrito abandonado
- Promociones
- Orden del taller creada
Todos con el branding de Convergencia y link de tracking único.
Dashboard admin — las métricas que importan
┌─────────────────────────────────────────────────────────────┐
│ Dashboard │
├─────────────────────────────────────────────────────────────┤
│ Ventas de hoy: $1.234.000 │
│ Órdenes del mes: 87 (+23% vs mes anterior) │
│ Tasa de aprobación: 96.5% │
│ Productos bajos: 5 (requieren reabastecer) │
├─────────────────────────────────────────────────────────────┤
│ Mapa de clientes por departamento │
│ [mapa de Colombia con puntos donde hay clientes] │
└─────────────────────────────────────────────────────────────┘Todo lo que el dueño necesita ver para tomar decisiones, en una sola pantalla:
- Ingresos del día/semana/mes
- Órdenes por estado (pendientes, pagadas, enviadas)
- Tasa de aprobación de pagos
- Inventario con alertas de stock bajo
- Mapa de clientes por ciudad
- Productos más vendidos
Qué viene
- Reportes exportables a Excel/PDF para contabilidad
- Variantes de producto (tallas, colores) para accesorios
- Múltiples direcciones guardadas por cliente
- Integración con transportadoras (rastreo automático de guías)
- Campañas segmentadas por historial de compra
Por qué un ecommerce a la medida
Una plantilla genérica (Shopify, Wix) funcionaría para vender productos. Pero no maneja:
- El flujo del taller con OCR y firma digital
- Tarifas de envío dinámicas por zona colombiana
- Pagos con Nequi y PSE integrados de forma nativa
- Dashboard de inventario multi-bodega
- Chat directo cliente-mecánico
Construir a la medida significa que el software se adapta al negocio, no al revés.
Convergencia Motos
Repuestos y servicio técnico especializado en motos Hero.
Medellín · C. 50 #70-30, Laureles · Colombia