Cómo funciona / Caja y Shopify
Un solo saldo para tu caja y tu tienda Shopify
Lo que tu cliente compra en tu sucursal y en tu tienda en línea suma al mismo monedero. Lo usa donde prefiera: en caja como descuento o en línea con un código de descuento de un solo uso.
POST /api/v1/members/$CLIENTE/earnings Authorization: Bearer pts_… { "amount": "850.00", "reference": "caja1-3001" } 201 Created { "points": "25.50", "balance_after": "271.50" }
Saldo de María López271.50 puntos
- Venta 3001 en caja+25.50
- Pedido #1042 en línea+27.00
Así funciona
-
Tú
En Configuración › Conexiones creas una llave de API para cada caja y conectas tu tienda Shopify.
-
Tu punto de venta
Busca al cliente por su celular, que le da su id, y registra cada venta con el monto y el folio del ticket. Si la red falla y la caja reintenta, la venta no suma dos veces.
curl -X POST https://simplepuntos.com/api/v1/members/$CLIENTE/earnings \ -H "Authorization: Bearer $LLAVE" \ -H "Content-Type: application/json" \ -d '{"amount": "850.00", "reference": "caja1-3001"}' -
Shopify
Avisa cada pedido pagado y su subtotal suma al mismo saldo. Si quien compró aún no estaba registrado, queda registrado con su celular o su correo.
-
Tu cliente
Desde el portal de tu negocio convierte sus puntos en un código de descuento para tu tienda en línea. Es de un solo uso y vence en 30 días.
-
Tu punto de venta
Si le devuelven mercancía, revierte el movimiento de esa venta, completo o solo la parte devuelta. Las cancelaciones y los reembolsos de Shopify se descuentan solos.
curl -X POST https://simplepuntos.com/api/v1/entries/$MOVIMIENTO/reverse \ -H "Authorization: Bearer $LLAVE" \ -H "Content-Type: application/json" \ -d '{"points": "12.75", "reference": "caja1-dev-3001"}'
Lo que configuras
- Una llave de API por caja, para revocar una sin detener las demás.
- Tu tienda Shopify, conectada con el Client ID y el secreto de una app tuya.
- Cuántos días vale el código de descuento de la tienda en línea.
- Qué datos extra guardas de cada cliente: su mascota, su sucursal o su número de cliente.
Preguntas frecuentes
- ¿Qué necesita mi programador?
- Una llave de API y la documentación de tu panel, con ejemplos que ya usan tus datos. Son pocas llamadas: buscar al cliente, registrarlo, acumular, canjear y revertir.
- ¿Qué pasa si la red se cae a media venta?
- Tu caja repite la llamada con el mismo folio. Si la primera sí había llegado, recibe el movimiento original y la venta no suma dos veces.
- ¿Qué compras de Shopify suman?
- Los pedidos pagados en pesos, según su subtotal. Si un pedido se cancela o se reembolsa, se quitan los puntos que dio.
- ¿Funciona con la tarjeta de sellos?
- Las compras de Shopify suman al monedero. La tarjeta de sellos se sella en caja, desde el Mostrador o desde tu punto de venta.
Pruébalo con tus clientes este mes
Creas tu cuenta en minutos y registras a tu primer cliente hoy mismo.