Seguimiento de pedido y reseñas

Después de que un cliente compra, hay dos experiencias que le interesan: saber en qué va su pedido y, más tarde, dejar una reseña. Además, quien compra seguido puede crear una cuenta para no volver a capturar sus datos. Esta página explica cómo lo vive el cliente y —lo más importante para ti— cómo administras y moderas todo eso desde tu ERPNext.

Cómo rastrea el cliente su pedido

Cuando alguien completa una compra en el webshop, el pedido se guarda como una Sales Order en tu ERPNext y el cliente recibe un enlace privado de seguimiento: /pedido/<token>.

• El token es un código imposible de adivinar: nadie puede ver el pedido de otro cambiando un número en la URL. El enlace es la llave. Por eso es seguro mandárselo al cliente por correo o WhatsApp.
• En esa página el cliente ve: el estado del pedido, su referencia (el nombre de la orden), el monto y el método de pago. Si pagó con un voucher tipo OXXO, ve además la referencia para ir a pagar y una nota de tiempo de espera.
• Si el pedido quedó pendiente de pago, la página le ofrece «Completar pago» con su enlace de la pasarela (así se recupera un carrito abandonado). Ese botón nunca aparece para pedidos ya pagados o cancelados.

Los estados de pago que puede mostrar el seguimiento son: pending (pendiente), paid (pagado), cancelled (cancelado), review (pago recibido, en revisión) y underpaid (pagó de menos). El sistema consulta la misma pasarela con la que se abrió el pedido y, cuando confirma el pago, la orden avanza sola.

Importante: el estado de pago (pagó / no pagó) es distinto del estado de surtido (preparando / listo / entregado). El de pago lo maneja la pasarela; el de surtido lo mueves tú (siguiente sección).

Cómo avanzas el surtido del pedido (tu parte)

Cada pedido tiene un estado de surtido (storefront_fulfillment_status) que tú haces avanzar conforme lo preparas. La secuencia es hacia adelante (no puedes retroceder), con la opción de cancelar:

placed (recibido) → paid (pagado) → preparing (preparando) → ready (listo) → delivered (entregado)

1. Abre el pedido: espacio de trabajo «Tienda» → Pedidos (o directamente la Sales Order).
2. Avanza el estado con la acción correspondiente (de «preparando» a «listo», de «listo» a «entregado»). El cambio queda registrado como comentario en la orden.
3. Puedes cancelar mientras no esté ya entregado.

Nota — avisos automáticos al comprador: cuando marcas el pedido «listo» (ready) o lo cancelas, y cuando el pedido se marca pagado, el sistema puede notificar al comprador. Los avisos por correo están encendidos por defecto (storefront_buyer_email_enabled); los avisos por WhatsApp (storefront_buyer_whatsapp_enabled) están apagados y requieren frappe_whatsapp con plantillas aprobadas por Meta (storefront_buyer_wa_templates). Esto último es función en preparación en muchas tiendas.

Nota: también puedes recibir tú una alerta de operador cuando entra un pedido, configurando storefront_operator_whatsapp (tu número con lada) y storefront_operator_wa_template en Doco Business Settings.

La cuenta del cliente

Un cliente puede crear una cuenta para guardar sus datos, ver su historial y sus favoritos. Es opcional: se puede comprar como invitado.

Cómo entra (login por código): el cliente no usa contraseña. Pide un código de un solo uso (OTP):

1. Ingresa su correo o su WhatsApp. (Los canales soportados son email y whatsapp.)
2. Recibe un código de 6 dígitos.
3. Lo escribe y entra. La sesión se mantiene con un token seguro del lado del servidor.

Detalles de seguridad que conviene conocer (todo automático):

• El código dura 5 minutos y admite máximo 5 intentos.
• Se pueden pedir máximo 3 códigos por cada 15 minutos, con 60 segundos de espera entre uno y otro.
• El sistema es a prueba de enumeración: siempre responde «ok» aunque no exista la cuenta, para no revelar quién está registrado. Si un cliente dice «no me llegó el código», suele ser el límite de reenvío: que espere el minuto.

Qué encuentra el cliente en su cuenta (páginas /cuenta, /cuenta/pedidos, /cuenta/perfil, /cuenta/favoritos):

• Historial de pedidos (account_orders).
• Perfil editable (account_profile / account_profile_update): nombre, teléfono y datos de envío (dirección, ciudad, estado, CP, notas de entrega) que se precargan en el checkout.
• Favoritos / wishlist (account_wishlist / account_wishlist_toggle).
• Carrito guardado entre dispositivos (account_cart_get / account_cart_save).
• Puntos de lealtad (account_loyalty), si tu tienda tiene un Loyalty Program asignado en el Storefront Profile (loyalty_program). Los puntos se acumulan en la factura pagada y se pueden ver y canjear desde la cuenta. Sin programa asignado, no hay puntos.

Nota: cada cuenta de cliente (registro Storefront Customer) se mapea 1:1 a un Customer de ERPNext. Así, sus pedidos en línea y sus compras quedan bajo el mismo cliente.

Advertencia [VERIFICAR: alcance del área de cuenta sin webshop]: el historial de pedidos y el carrito guardado tienen más sentido con el webshop activo. Con la tienda como vitrina (sin webshop), confirma qué partes de «Mi cuenta» quedan visibles.

Reseñas: cómo se dejan y cómo se moderan

Tu tienda muestra reseñas en la ficha de cada producto (estrellas 1-5, título y comentario), ordenadas poniendo primero las de compra verificada y luego las más recientes.

Cómo llega una reseña. Hay dos caminos:

1. Cliente con cuenta: desde su historial, reseña un producto que compró. Si el sistema encuentra que su Customer tiene una orden de ese producto, la reseña queda marcada como compra verificada (verified_purchase).
2. Invitación tras una venta (incluye mostrador/POS): después de una venta se le puede mandar por WhatsApp un enlace /resena/<token> (registro Storefront Review Invite). El cliente califica sin necesidad de crear cuenta, y la reseña queda verificada automáticamente porque el enlace nació de una factura real. Cada invitación es una sola reseña y hay una invitación por factura (para no duplicar).

Importante — las reseñas se publican solas: una reseña enviada queda publicada de inmediato (published = encendido por defecto). No hay una cola de aprobación previa. La moderación es posterior: si una reseña te parece inadecuada, la despublicas.

Cómo moderas (despublicar una reseña):

1. En el Escritorio, abre la lista Storefront Review.
2. Localiza la reseña (por producto, autor o fecha). Verás su «Rating», «Title», «Comment», «Author Name» y si es «Verified Purchase».
3. Para ocultarla del sitio, apaga la casilla «Published» (published) y guarda. Deja de mostrarse (la tienda solo lista reseñas con published = 1). Para restaurarla, vuelve a encenderla.

Nota: el campo «Helpful Votes» (helpful) cuenta los votos de «me sirvió» de otros clientes. El nombre que se muestra sale de la cuenta del cliente o, en reseñas por invitación, del «Author Name» / «Buyer Name» de la invitación.

Protección contra abuso (automática): el envío de reseñas está limitado (máximo 8 envíos por cada 5 minutos por origen) y el texto se sanitiza. Las invitaciones expiran (expires_on) y se marcan como usadas (used) al enviarse, así que un enlace no sirve dos veces.

Advertencia: como no hay aprobación previa, revisa tus reseñas nuevas de vez en cuando (la lista Storefront Review, ordenada por fecha). Es más rápido despublicar una mala reseña ocasional que frenar todas — y las reseñas visibles ayudan mucho a vender. [captura: lista Storefront Review con la casilla «Published»]

Nota final: las notificaciones por WhatsApp (invitaciones a reseñar, avisos de pedido) dependen de plantillas aprobadas por Meta y de frappe_whatsapp. Donde eso no esté listo, el flujo funciona por correo o compartiendo tú el enlace a mano. Es función en preparación según la tienda. [VERIFICAR: estado de las plantillas de WhatsApp en tu tienda]