Plataforma Ecommerce Abrir demo
Caso de estudio · Comercio electrónico

Una tienda en línea lista para vender en Colombia

Catálogo, carrito, promociones, clientes fieles, pagos con Wompi y facturación electrónica. Cada cliente tiene su propia instalación y la administra desde un panel sencillo.

  • JavaScript
  • Node.js 22
  • SQLite
  • Wompi
  • Factura DIAN
  • 0 dependencias
  • Cloudflare Tunnel
La demo corre completa en el navegador, con datos ficticios. No se cobra ni se envía nada.
6tiendas de ejemplo con su propio rubro y paleta
2temas visuales: Clásico y Fantasía
9secciones en el panel de administración
0dependencias externas: Node 22 y SQLite
El reto

Vender en línea sin pagar una plataforma cada mes

Un emprendedor necesita una tienda que cobre en pesos, emita factura y que pueda manejar sin ayuda. Las plataformas extranjeras cobran en dólares y no resuelven la factura colombiana.

Para el comprador

  • Catálogo con filtros por categoría, precio y marca.
  • Carrito, cupones y descuentos automáticos.
  • Pago en línea, transferencia o contra entrega.
  • Cuenta con historial y beneficios de cliente fiel.

Para el dueño de la tienda

  • Resumen de ventas y alertas de inventario.
  • Productos, fotos, opciones y existencias.
  • Pedidos con estados, de pendiente a entregado.
  • Promociones, cupones y programa de clientes fieles.

Lo que pide Colombia

  • Precios en COP con IVA incluido por producto.
  • Datos para factura: CC, NIT, consumidor final.
  • Pagos con Wompi: tarjeta, PSE y Nequi.
  • Facturación electrónica ante la DIAN.
Una base, muchos negocios

Seis tiendas de ejemplo

El mismo código cambia de paleta según el matiz de cada marca. El tema Fantasía muestra hasta dónde puede llegar la personalización sin tocar el panel.

Portada de Taller Norte, tienda de moda
Taller NorteModa
Portada de Casa Maíz, tienda de alimentos
Casa MaízAlimentos
Portada de Voltio, tienda de electrónica
VoltioElectrónica
Portada de Estudio Lumen, productos digitales
Estudio LumenProductos digitales
Portada de Finca La Esperanza, café del Huila
Finca La EsperanzaCafé de origen
Portada de La Taberna del Dragón con el tema Fantasía
La Taberna del DragónTema Fantasía
Experiencia del comprador

Una compra, paso a paso

El servidor recalcula precios, descuentos y envío al confirmar: el navegador solo muestra. Así nadie puede alterar un total desde su equipo.

1
Comprador

Encuentra el producto

Filtros por categoría, rango de precio y atributos como la marca o la talla. Los filtros activos se ven como etiquetas que se quitan con un clic, y el buscador revisa nombre, categoría, atributos y descripción.

2
Comprador

Elige opciones y agrega al carrito

Talla, color o formato, cantidad y existencias en vivo. El carrito lateral permite ajustar sin salir de la página y el inventario se reserva al confirmar el pedido.

3
Comprador

Aprovecha promociones y cupones

Descuentos por categoría que se aplican solos, cupones con compra mínima y beneficios exclusivos para clientes fieles. El resumen muestra cuánto falta para el envío gratis.

4
Comprador

Paga en tres pasos

Datos y entrega, método de pago y revisión. Incluye los datos para la factura electrónica: cédula, NIT o consumidor final.

En la demo una pasarela simulada reemplaza a Wompi: tú decides si el pago se aprueba, se rechaza o queda pendiente.

5
Comprador

Si el pago falla, reintenta

El pedido queda pendiente con el inventario reservado y el comprador puede completar el pago sin volver a llenar nada. Los pedidos en línea que nunca se pagan expiran solos y devuelven las existencias.

6
Cliente fiel

Beneficios por comprar seguido

Al acumular un monto de compras el cliente pasa a fiel: descuento permanente, envío gratis y promociones exclusivas que se ven al iniciar sesión.

Panel de administración

El negocio en una sola pantalla

Siempre sobrio, sin importar el tema de la tienda. Pensado para que el dueño lo use sin capacitación.

ResumenVentas de 14 días, pedidos por atender e inventario en alerta.
ProductosPrecio con IVA, precio anterior, opciones y categoría nueva al vuelo.
InventarioSumar, restar o escribir existencias; avisos de stock bajo y agotado.
PedidosDe pendiente a entregado, con línea de tiempo y correo al cliente en los cambios clave.
PromocionesPorcentaje, monto fijo o envío gratis, con cupón, compra mínima y fecha.
ClientesReglas del programa fiel y cambio manual de tipo de cliente.
Facturación y correosEmisor, resolución DIAN y buzón de correos enviados.
AjustesDatos de la tienda, color de marca y tema visual.
MóvilMenú lateral, filtros en hoja inferior y compra completa desde el teléfono.
Galería

Capturas de pantalla

Pulsa una imagen para verla completa. Los originales en PNG están a 2880 px de ancho.

Por dentro

Arquitectura simple, decisiones deliberadas

Un proceso de Node, una base SQLite por cliente y nada que compilar: se instala con Docker y se respalda con un comando.

Navegador

  • Tienda y panel en una SPA con rutas #/
  • JavaScript y CSS puros, fuentes locales
  • Temas por variables CSS

Servidor Node 22

  • API pública y de administración
  • Precios compartidos con el navegador y recalculados al comprar
  • Wompi, correo y cola de facturas

SQLite

  • node:sqlite en modo WAL
  • Un archivo por cliente
  • Migraciones numeradas y respaldos

Cada instalación se publica con un túnel de Cloudflare (cloudflared): el servidor no abre puertos y el dominio queda en la cuenta del cliente.

Una instalación por cliente

Datos, dominio y configuración aislados. Sin un sistema multiempresa que complique la seguridad.

La demo es el mismo código

El servidor real corre dentro del navegador: SQLite compilado a WebAssembly y la red reemplazada por llamadas locales. Lo que ves en la demo es lo que se instala.

Pagos con Wompi

Checkout firmado, webhook con verificación de firma, monto y moneda, y consulta del estado real al volver. Las llaves viven solo en variables de entorno.

Facturación electrónica

Documento, numeración por resolución, cola de envío y proveedores intercambiables. El envío a la DIAN depende del proveedor tecnológico que se elija.

Seguridad

Contraseñas con scrypt, sesiones con hash en la base, cookies HttpOnly, CSP estricta, límites de intentos y verificación de origen.

Probado

39 pruebas automáticas sobre precios, promociones, pedidos, Wompi y facturación con node --test.

PNG original