Ecommerce — Resumen

El módulo de Ecommerce de Zentto permite a las empresas vender productos en línea a través de Zentto Store, una tienda completamente integrada con el inventario, facturación y logística del ERP.

Características principales

• Catálogo sincronizado: los productos del inventario se publican directamente en la tienda sin duplicar datos.
• Gestión de pedidos: ciclo completo desde la orden hasta la entrega, con seguimiento en tiempo real.
• Devoluciones: flujo de solicitud, aprobación y reembolso automatizado.
• Programa de afiliados: sistema de comisiones para referidos con tracking integrado.
• Pasarela de pagos: integración con Paddle para pagos internacionales.

Arquitectura

Zentto Store se conecta directamente con la API del ERP. Cada venta online genera automáticamente:

1. Un pedido en el módulo de ventas.
2. Un movimiento de inventario que reserva el stock.
3. Una factura electrónica (si aplica según el país).
4. Una guía de despacho en logística.

📸 Captura: Dashboard principal de Zentto Store con métricas de ventas

Flujo general

Catálogo → Cliente navega → Agrega al carrito → Checkout → Pago
→ Pedido creado en ERP → Picking → Despacho → Entrega → Factura

Sincronización de inventario

El stock disponible en la tienda se actualiza en tiempo real. Cuando un producto se vende en el POS físico o en la tienda online, ambos canales reflejan el cambio inmediatamente. Esto evita sobreventa y garantiza consistencia.

Requisitos previos

• Módulo de Inventario configurado con productos activos.
• Al menos un almacén asignado como origen de despacho ecommerce.
• Configuración de moneda y tasas de impuesto para el país de operación.
• Cuenta de Paddle vinculada para procesamiento de pagos.

Secciones del módulo

Sección	Descripción
Catálogo	Publicación de productos, categorías e imágenes
Pedidos	Gestión del ciclo de vida de órdenes
Devoluciones	Proceso de devoluciones y reembolsos
Afiliados	Programa de comisiones por referidos

Flujo del usuario

Vista no técnica del módulo. Pensada para personal de operación, administración y marketing de la tienda.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo técnico

Vista técnica para desarrolladores: endpoints, stored procedures, tablas y servicios involucrados.

Componente	Tipo	Ubicación
/v1/ecom/catalog	Route Express	web/api/src/routes/ecom/catalog.ts
/v1/ecom/orders	Route Express	web/api/src/routes/ecom/orders.ts
/v1/ecom/returns	Route Express	web/api/src/routes/ecom/returns.ts
/v1/ecom/affiliates	Route Express	web/api/src/routes/ecom/affiliates.ts
/v1/ecom/webhooks	Route Express (Paddle)	web/api/src/routes/ecom/webhooks.ts
usp_ecom_Product_*	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Order_*	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Return_*	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Affiliate_*	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
ecom.Product	Tabla operativa	web/api/migrations/postgres/
ecom.Order	Tabla operativa	web/api/migrations/postgres/
module-ecommerce	Componente Frontend	web/modular-frontend/packages/module-ecommerce/src/

Editable en draw.io: descarga el SVG → File → Import from → Device.