3. Fidelización: Actualizar y crear información

Puede crear o actualizar la información de fidelización de un cliente a través de la aplicación específica POST Punto final de la API que acepta una matriz de objetos como cuerpo de la solicitud.

https://api.jericommerce.com/v1/programs/{programId}/integrations/api

Es importante saber que el usuario debe existir en la API antes de poder añadir información de fidelización.

Puede añadir tanto la información del cliente como la de fidelización en la misma solicitud API, pero debe asegurarse de preservar el orden añadiendo primero la información del cliente.

‍

La información de fidelización debe tener un cliente ya creado

‍

Aquí un ejemplo de cuerpo para actualizar un cliente:

1[
2  {
3    "email": "string",
4    "feature": "loyalty",
5    "payload": {
6      "loyaltyCustomerId": "string",
7      "balance": number,
8      "memberSince": IsoDate,
9      "tierStatus": "string"
10    }
11  }
12]

‍

Propiedades de la carga útil

‍

loyaltyCustomerId

Es la referencia externa de esta información loylaty, útil cuando necesitas asociar esta información con otra base de datos.
Es obligatorio para cada solicitud.

saldo

Una de las propiedades más importantes es el saldo del cliente. Nuestra API no calcula ningún valor aquí, sino que simplemente actualiza el valor con el valor proporcionado en la solicitud.
Es un campo obligatorio, debe tener formato numérico y ser siempre mayor que 0.

‍

miembroDesde

Es la fecha en la que el cliente se registró en su programa de fidelización.
El campo obligatorio debe estar en formato de cadena ISO.
El campo es obligatorio y se requiere para cada llamada.

‍

tierStatus

La dependencia del programa de fidelización podría tener un nivel o no, por lo que podría añadir aquí el nombre del nivel.
La propiedad opcional string podría ser el valor deseado.