Developer Hub
Esta traducción se ha generado automáticamente

Integración de la API para Loyalty Earn

Con Loyalty Earn, puedes sincronizar las recompensas de fidelidad de los clientes con tu programa. También puedes usar los datos para ofrecer una visión up-to-date de los puntos pendientes y concedidos, analizar las tendencias del programa y crear informes para tus partes interesadas.

Opciones de envío

Nuestra oferta «Loyalty Earn» te permite recuperar datos mediante un mecanismo de extracción, que proporciona información detallada sobre los itinerarios para facilitar:

  • Análisis de datos
  • Otorga puntos a los clientes
  • Investigaciones del servicio de asistencia técnica

Este servicio consta de dos puntos de conexión de HTTP GET que te permiten:

  • Mira cuándo se actualizaron los datos por última vez. Los puntos de fidelidad se actualizan a diario.
  • Crea una lista de la moneda de fidelidad pendiente o canjeada en un intervalo de tiempo determinado utilizando las variables transaction_date_start, transaction_date_end, and membership_id o itinerary_id

>> Descubre más sobre el proceso de autenticación .

Campos disponibles

En las tablas siguientes encontrarás los campos, incluidos objetos anidados, disponibles a través de nuestros métodos de entrega push y pull.

Nombre del campoDefiniciónEjemplo
itinerary_idNúmero de itinerario o el número de referencia del pedido en el punto de venta.72622069245694
transaction_typeTipo de transacción registrada.Valores posibles:
COMPRAR
PREMIO
MODIFICACIÓN
CANCELAR
transaction_date*La fecha en la que se modificó por última vez una reserva. Esto es lo mismo que el « book date » si la reserva nunca se actualiza. Expresado en el formato de fecha ISO 8601 (YYYY-MM-DD).2023-02-05
transaction_datetime*La fecha y la hora de la última modificación de una reserva. Si no se han realizado actualizaciones, este valor es el mismo que el de book_date.2023-10-21T00:00:00.000Z
booking_itemObjeto que representa elementos individuales de una reserva. Echa un vistazo a la tabla « booking_item » para ver los elementos anidados.
package_indicatorSi el elemento de la reserva forma parte de un paquete (como vuelo + hotel).Valores posibles:
Parte del paquete
Reservas independientes
Desconocido
currency_codeMoneda en la que se pagó la reserva, expresada en el formato estándar del código de moneda del número de cuenta bancaria internacional (IBAN).USD
gross_booking_valueEl valor bruto de la reserva (GBV), o el importe total de la reserva, incluidos impuestos y comisiones, en la moneda utilizada para el pago.694.89
base_priceEl importe cobrado al cliente antes de aplicar impuestos, tasas y ajustes, el cual constituye la base para la concesión de puntos. Se muestra en la moneda con la que se paga.154.78
award_date*Fecha en la que se otorgarán los puntos, expresada en el formato de fecha ISO 8601 (YYYY-MM-DD).2023-03-14
point_definitionIndicador de una campaña o promoción que modifica el modelo de ganancias básico de tu programa.Partner_2X_promo
pending_pointsNúmero de puntos ganados pero que aún no se han concedido.Desglosado de la siguiente manera:
total: –100,11
base: –90,01
bonificación: –10,1
awarded_pointsNúmero de puntos que se otorgan por la transacción.Desglosado de la siguiente manera:
total: 100,11
base: 90,01
bonificación: 10,1
program_nameNombre del programa de fidelidad.Recompensas
memberObjeto que representa la información del cliente. Echa un vistazo a la tabla « member » para ver los elementos anidados. 
|

booking_item

Estos campos definen los detalles de cada elemento de una reserva.

Nombre del campoDefiniciónEjemplo
idIdentificador de la reserva.1329922272
booking_date*La fecha en la que se hizo la reserva por primera vez, expresada en el formato de fecha ISO 8601 (YYYY-MM-DD).2023-02-05
product_lineEl tipo de operación al que pertenece la partida de reserva.Valores posibles:
Air
Alquiler de coches
Crucero
Servicios en el destino
Insurance
Alojamiento
Paquete
desconocido
begin_use_date*La fecha en la que empieza el viaje: fecha de salida, fecha de « check-in », fecha de « pick-up », etc., expresada en el formato de fecha ISO 8601 (YYYY-MM-DD).2023-02-13
end_use_date*La fecha en la que termina el viaje: fecha de llegada, fecha de « check-out », fecha de « drop-off », etc., expresada en el formato de fecha ISO 8601 (YYYY-MM-DD).2023-02-20

miembro

Estos campos identifican al miembro del programa de fidelización.

Nombre del campoDefiniciónEjemplo
idIdentificador único del registro del miembro.456178230
last_name**Apellidos del miembro del programa de fidelidad.Doe
loyalty_tierNivel del programa en el que se encuentra el miembro. Se puede utilizar para determinar los puntos de bonificación, por ejemplo.Estándar

Notas para todos los campos

  • Los campos de fecha están en hora estándar del Pacífico (PST), teniendo en cuenta el horario de verano.
    ** Datos de información de identificación personal (PII). Asegúrate de gestionarlo correctamente según las directrices de tu empresa y de incluirlo solo cuando sea absolutamente necesario.

Detalles de la API

Explora las definiciones de los puntos de conexión en esta página y usa un software de pruebas de API para ver la diferencia entre los ejemplos y las definiciones de esquemas, y el resultado real.




¿Te ha resultado útil esta página?
¿Cómo podemos mejorar este contenido?
¡Gracias por ayudarnos a mejorar!