Devoluciones

Zentto Store incluye un flujo completo de devoluciones que permite al cliente solicitar la devolución de productos y al operador gestionar la aprobación y reembolso de forma controlada.

Flujo de devolución

Cliente solicita → Revisión → Aprobada/Rechazada → Recepción mercancía
→ Inspección → Reembolso procesado

Solicitud de devolución

El cliente puede solicitar una devolución desde su cuenta en la tienda dentro del plazo configurado (por defecto 30 días desde la entrega). Debe indicar:

• Productos a devolver y cantidad.
• Motivo: defectuoso, no coincide con descripción, cambio de opinión, etc.
• Fotos (opcional pero recomendado para productos defectuosos).
• Preferencia: reembolso o cambio por otro producto.

📸 Captura: Formulario de solicitud de devolución del cliente

Revisión y aprobación

El operador revisa la solicitud en Ecommerce → Devoluciones y puede:

Acción	Efecto
Aprobar	Se genera etiqueta de envío de retorno y se notifica al cliente
Rechazar	Se notifica al cliente con el motivo del rechazo
Solicitar información	Se pide al cliente fotos o datos adicionales

📸 Captura: Panel de gestión de devoluciones con solicitudes pendientes

Recepción e inspección

Al recibir la mercancía devuelta en el almacén:

1. Se registra la recepción con fecha y condición.
2. Se realiza inspección de calidad:
   • Apto para reventa: se reingresa al inventario.
   • Defectuoso: se marca como merma o se envía a garantía del proveedor.
3. Se actualiza el estado de la devolución.

Reembolso

Una vez aprobada la devolución e inspeccionada la mercancía:

• Reembolso al método original: se procesa vía Paddle automáticamente.
• Crédito en tienda: se genera un código de descuento por el monto.
• Reembolso parcial: si solo se devuelven algunos productos de la orden.

El reembolso genera automáticamente una nota de crédito en el módulo de facturación del ERP.

Configuración

En Administración → Ecommerce → Devoluciones se configuran:

• Plazo máximo para solicitar devolución (días).
• Motivos de devolución disponibles.
• Si se requiere aprobación manual o es automática.
• Política de costos de envío de retorno (cliente o empresa).

Métricas

El dashboard de devoluciones muestra:

• Tasa de devolución por período.
• Motivos más frecuentes.
• Tiempo promedio de procesamiento.
• Monto total reembolsado.

Flujo del usuario

Vista no técnica del proceso de devolución. Pensada para atención al cliente, operadores de almacén y administradores de 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: state machine de ecom.Return + sequence con usp_ecom_Return_*, ajuste de inventario y nota de crédito.

Componente	Tipo	Ubicación
POST /v1/ecom/returns	Route Express	web/api/src/routes/ecom/returns.ts
usp_ecom_Return_Request	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Return_Approve	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Return_Reject	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Return_Receive	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Return_Refund	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_inv_StockMove_Return	Stored procedure inventario	web/api/sqlweb-pg/includes/sp/
usp_bill_CreditNote_Create	Stored procedure facturación	web/api/sqlweb-pg/includes/sp/
ecom.Return	Tabla operativa (state machine)	web/api/migrations/postgres/
DevolucionesPage.tsx	Componente Frontend	web/modular-frontend/packages/module-ecommerce/src/

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