POS vía chat: visión general

Estado documental: Propuesto. Este documento define la modalidad POS vía chat y sus dos formas principales de originar una cobranza: desde el vendedor o desde un sistema integrado.

Qué es POS vía chat

POS vía chat permite iniciar, acompañar y conciliar cobros desde un canal conversacional.

Una operación puede originarse de dos maneras:

1. el vendedor crea manualmente el cobro desde el chat;
2. el sistema de ventas crea la transacción mediante API y YUPY la entrega al turno y dispositivo correspondientes.

Creación manual
Vendedor → chat → YUPY → QR o transferencia

Creación integrada
Sistema de ventas → API de YUPY
                  → turno y dispositivo
                  → chat del vendedor
                  → QR o transferencia

El dinero llega directamente a la cuenta o billetera configurada por la empresa.

El chat es un canal

POS vía chat puede operar mediante:

• WhatsApp;
• Messenger;
• Telegram;
• chat propio de YUPY;
• chat incorporado en una aplicación;
• otros canales conversacionales integrados.

La modalidad se denomina POS vía chat. Ninguna plataforma específica es el nombre del producto.

Participación directa del comprador

Además del uso operativo por vendedores, YUPY puede conversar directamente con el comprador cuando el flujo comercial lo requiera.

Comprador:
“Quiero este producto.”

YUPY:
“El monto es S/ 80.00.
Paga utilizando este QR.”

Cuando el QR llega al mismo teléfono desde el que se realizará el pago, la experiencia puede indicar:

1. Guarda o descarga el QR.
2. Abre Yape o Plin.
3. Elige la opción para leer un QR desde una imagen.
4. Selecciona el archivo guardado.
5. Verifica el monto y el receptor antes de pagar.

Esta es una capacidad adicional. El flujo operativo principal puede seguir siendo atendido por el vendedor.

Opciones de pago documentadas

POS vía chat contempla formalmente dos opciones:

1. QR, mediante Yape o Plin.
2. Transferencia bancaria, mediante cuenta o CCI.

La empresa define durante el setup cuáles se encuentran habilitadas y cómo se presentan.

Flujo principal

1. El usuario abre o retoma el canal autorizado.

2. Inicia turno y se identifica.

3. El turno queda asociado con:
   - usuario;
   - dispositivo;
   - canal;
   - empresa.

4. El cobro se origina:
   - manualmente en el chat; o
   - desde un sistema de ventas mediante API.

5. YUPY entrega al turno:
   - monto;
   - referencia;
   - QR o transferencia;
   - instrucciones;
   - código de transacción.

6. El comprador paga.

7. El vendedor puede:
   - presionar “Ya pagó”; o
   - enviar una captura o fotografía de la constancia.

8. YUPY procesa la información y concilia.

9. YUPY informa:
   - pago confirmado;
   - espera;
   - diferencia;
   - pago tardío;
   - revisión;
   - cancelación;
   - otra condición aplicable.

Creación manual siempre disponible

Aunque exista integración con el sistema de ventas, el vendedor debe conservar la opción de crear un cobro manual desde el chat.

Esto permite cobrar conceptos no controlados por el sistema principal, por ejemplo:

• una gaseosa;
• un embalaje;
• un servicio de ensunchado;
• un cargo adicional;
• otro producto o servicio excepcional.

Datos mínimos de la operación

Cuando el vendedor crea el cobro

YUPY obtiene del turno activo la identidad del usuario, dispositivo y canal. El vendedor debe indicar al menos:

• monto;
• moneda;
• referencia de venta o concepto.

YUPY genera el identificador interno y el código de transacción.

Cuando el sistema crea el cobro por API

La solicitud debe incluir al menos:

• identificador externo de la transacción;
• monto;
• moneda;
• shift_id;
• device_id o terminal_id;
• referencias necesarias para la correlación.

El turno y el dispositivo permiten entregar el QR y las instrucciones al usuario correcto.

Datos del comprador

Se recomienda enviar nombre y apellido cuando estén disponibles.

La empresa también puede enviar ID de cliente, teléfono, correo, documento u otras referencias, pero los datos personales adicionales no son obligatorios para todas las operaciones.

Código de transacción

Cada cobro debe generar un código seguro que permita:

• consultar la operación;
• presentar un reclamo;
• asociar una constancia;
• localizar un pago tardío;
• resolver una diferencia;
• dar seguimiento a una devolución.

El código público no debe ser el token interno ni una credencial.

Captura o fotografía durante la operación

El vendedor puede obtener una captura enviada por el comprador o tomar una fotografía de la pantalla del teléfono.

También puede adjuntar una constancia de depósito o transferencia.

Captura o fotografía
        ↓
YUPY la asocia con la transacción
        ↓
registra la señal equivalente a “Ya pagó”
        ↓
OCR extrae información visible
        ↓
YUPY incorpora los datos a la conciliación

La función está disponible para Yape, Plin y transferencias bancarias, y puede extenderse a otras billeteras habilitadas.

La imagen ayuda a conciliar, pero no confirma por sí sola que el dinero llegó.

QR fijo y monto

En la modalidad inicial, el QR puede identificar el destino receptor sin contener el monto.

El QR identifica el destino.
El comprador ingresa el importe mostrado.

Por ello YUPY contempla diferencias de monto, pagos tardíos y casos que requieren revisión.

Confirmación financiera

“Ya pagó”
≠ pago confirmado

Captura o fotografía
≠ pago confirmado

Movimiento conciliado por YUPY
= pago confirmado por YUPY

Continuidad

Cerrar el chat o finalizar un turno no elimina la transacción ni detiene la conciliación.

Los resultados posteriores permanecen asociados con el turno y el usuario que originaron el cobro.

Criterios de aceptación

1. El cobro puede originarse manualmente o mediante API.
2. La creación manual permanece disponible aunque exista integración.
3. El chat puede ser WhatsApp, Messenger, Telegram u otro canal integrado.
4. YUPY puede atender directamente al comprador cuando el flujo lo requiera.
5. Las opciones formales son QR y transferencia bancaria.
6. La operación por API identifica turno y dispositivo.
7. Nombre y apellido del comprador son recomendados, no universales.
8. La captura o fotografía activa la señal equivalente a “Ya pagó”.
9. OCR incorpora datos visibles a la conciliación.
10. Solo una conciliación financiera confirma el pago.