API
- En el panel
- Menú → Configuración → API token
- Quién lo usa
- Dueño
La API conecta tu punto de venta, tu sistema de facturación o tu ERP con tu programa de puntos. Así, cada venta entrega los puntos sola, sin que tu equipo los cargue a mano.
Qué puede hacer tu sistema
- Crear clientes: con nombre, apellido, documento, email, teléfono y tu código externo.
- Buscar clientes: por código de cliente, documento, email, teléfono o nombre. Devuelve su código y sus puntos.
- Dar puntos: con el monto de la compra (o los puntos, si no usas equivalencia), identificando al cliente por su código de cliente, tu código externo o su email.
- Descontar puntos: con el código del cliente y los puntos.
Empezar
- En Configuración → API token, presiona Crear Token. Toca el token para copiarlo.
- Escríbenos para recibir la dirección (host) de tu API.
- Revisa la documentación técnica de cada recurso.
Tu sistema envía el token en cada consulta, en el encabezado token.
Por ejemplo, con el token “elTokenGenerado” y el host https://bluepoints.api.pretii.lat, esta es la búsqueda de clientes con el texto “texto de búsqueda”, usando curl desde la consola:
Ten en cuenta
- Los puntos que entrega la API siguen la equivalencia de tu programa de puntos.
- Descontar puntos cuenta como un canje de tu plan. Ver Canjes.
- El token da acceso a tu programa: compártelo solo con quien integra tu sistema.
Cambiar el token
Presiona Borrar Token y después Crear Token. Desde que lo borras, el token anterior deja de funcionar: actualízalo en tu sistema.