API para conectar tu sistema con el programa de puntos
Tienda de Puntos es una plataforma de fidelización para comercios y grandes marcas: permite crear programas de puntos, premios, niveles, beneficios y automatizaciones con tu marca, sin que el cliente tenga que descargar una aplicación.
Si tu sistema es propio o todavía no está en la lista de integraciones, se conecta por la API pública: sumar puntos por una venta, consultar el saldo de un cliente, mantener el catálogo de premios y registrar canjes. Es la misma API que usan nuestras integraciones de POS y ERP.
Lo que deja de hacerse a mano
- Sumar puntos por una venta, con el cliente identificado por email o documento.
- Consultar y administrar el padrón de clientes, con su saldo y su nivel.
- Mantener el catálogo de premios y la escalera de niveles.
- Registrar canjes y marcarlos como entregados en el mostrador.
- Listar tus sucursales y operar en nombre de una con un header.
De la venta al punto, paso a paso
La key identifica a tu comercio: no hay OAuth ni tokens que vencen, y todo lo que consultes queda acotado a tus datos. En cada venta mandás el identificador que esa venta tiene en tu sistema —el número de factura, el id del ticket—: si el envío se repite, la API responde que ya existe en vez de acreditar dos veces, y ese mismo identificador es el que después sirve para anular la operación si la venta se cae.
- 1 Pedís la API key desde el panel
La key identifica a tu comercio: todo lo que consultes o modifiques queda acotado a tus datos.
- 2 Traés tus sucursales una vez
La API devuelve los IDs de tus sucursales. Se guardan en la configuración de cada caja o de cada sistema.
- 3 Sumás puntos en cada venta
Mandás el monto, el cliente identificado por email o documento, y el identificador de la venta en tu sistema. Si el cliente no existe, se crea; si preferís que no, hay una opción para eso.
- 4 Registrás y entregás los canjes
Consultás qué premio pidió el cliente y lo marcás como entregado, o descontás puntos por un monto en pesos directamente.
- 5 Y anulás si la venta se cae
Con el mismo identificador que usaste para acreditar. No hace falta guardar un id nuestro.
Lo que gana tu comercio. Nada de lo que hacemos por dentro te está vedado: las integraciones de POS y ERP usan estos mismos endpoints. Si tu sistema puede hacer un pedido HTTP, puede tener programa de puntos.
El detalle que no se ve. La referencia de cada endpoint se genera desde el código, no se escribe a mano: la documentación no puede quedar describiendo una versión que ya no existe. Está publicada en developers.tiendadepuntos.com, con la especificación OpenAPI para generar el cliente en tu lenguaje.
Qué se sincroniza, y en qué dirección
Nada más que esto: lo que hace falta para identificar al cliente, calcular los puntos y entregar el premio. Tienda de Puntos no toma tus precios de costo ni tu información contable.
- Ventas con su monto, su cliente y su identificador de origen.
- Altas y cambios de clientes, premios, niveles y operadores.
- Canjes y entregas.
- El saldo de puntos y el nivel de cada cliente.
- Los puntos acreditados por cada venta, ya con los multiplicadores aplicados.
- Tus sucursales, el catálogo de premios y los niveles configurados.
- La API key del comercio, que se solicita desde el panel, en Configuración → Integraciones.
- Un backend, POS o ERP desde donde llamar (nunca desde el navegador o una app móvil).
- El id de tus sucursales, que se traen una vez y se guardan en la configuración de cada caja.
Dónde esta integración cambia algo
Tres llamadas alcanzan para un punto de venta: traer sucursales, sumar puntos y entregar el canje.
La suma por venta con idempotencia por número de comprobante encaja directo en el flujo de facturación que ya tenés.
Si tu proveedor expone los comprobantes, la API es el otro lado del puente. Contanos qué usás y evaluamos hacerlo nosotros.
Preguntas frecuentes sobre API de Tienda de Puntos y Tienda de Puntos
¿Tienda de Puntos tiene API?
Sí, una API pública para comercios. Permite sumar puntos por una venta, administrar clientes, premios, niveles y operadores, y registrar y entregar canjes. Es la misma que usan nuestras integraciones con POS y ERP.
¿Cómo se autentica?
Con una API key del comercio en un header. No hay OAuth ni tokens que expiren: la key sirve hasta que la revoques. Tratala como una contraseña y usala sólo desde tu backend, tu POS o tu ERP.
¿Cómo evito acreditar los puntos dos veces?
Mandando siempre el identificador de la venta en tu sistema. Si llega repetido, la API responde que ya existe una operación con ese identificador en vez de duplicar los puntos.
¿Puedo anular una operación si se cae la venta?
Sí, con el mismo identificador que usaste para acreditarla.
¿La API calcula los puntos o los mando yo?
Mandás el monto de la venta y el cliente; los puntos los calcula Tienda de Puntos con las reglas, los multiplicadores por nivel y las promociones que configuraste en el panel.
¿Puedo operar por sucursal?
Sí. Traés los IDs de tus sucursales una vez y después indicás en cada llamada en nombre de cuál estás operando.
Otras integraciones y el resto de la plataforma
¿Usás API de Tienda de Puntos? Armemos tu programa de puntos
Te mostramos la plataforma con tu caso sobre la mesa: qué se automatiza con API de Tienda de Puntos, desde cuándo, y qué premios tienen sentido para tu rubro.
Pedir una demo+1.000 comercios ya hacen volver a sus clientes con Tienda de Puntos.