Entrega de API para o programa Loyalty Earn
Com o Loyalty Earn, você pode conciliar os programas de recompensas de fidelidade dos clientes com o seu programa. Você também pode usar os dados para fornecer uma visão geral dos pontos pendentes e concedidos, analisar tendências do programa e criar relatórios para as partes interessadas.
Opções de entrega
Nosso programa de recompensas por fidelidade permite que você recupere dados por meio de um mecanismo de extração, que fornece dados detalhados de itinerário para auxiliar em:
- Análise de dados
- Atribua pontos aos clientes
- Investigações do help desk
Este serviço consiste em dois endpoints HTTP GETque permitem:
- Veja quando os dados foram atualizados pela última vez. Os pontos de fidelidade são atualizados diariamente.
- Crie uma lista de pontos de fidelidade pendentes ou concedidos em um intervalo de tempo específico usando as variáveis
transaction_date_start,transaction_date_end,and membership_idouitinerary_id.
Para obter detalhes sobre o processo de autenticação, consulte Configuração da API .
Campos disponíveis
As tabelas abaixo listam os campos, incluindo quaisquer objetos aninhados, disponíveis por meio dos nossos métodos de entrega push e pull.
| Nome do campo | Definição | Exemplo |
|---|---|---|
itinerary_id | O número do itinerário ou número de referência do pedido do ponto de venda. | 72622069245694 |
transaction_type | O tipo de transação registrada. | Valores possíveis: COMPRAR PRÊMIO MODIFICAÇÃO CANCEL |
transaction_date* | A data em que uma reserva foi modificada pela última vez. Isso é o mesmo que o book datese a reserva nunca for atualizada. Representado no formato de data ISO 8601 (YYYY-MM-DD). | 2023-02-05 |
transaction_datetime* | A data e a hora em que uma reserva foi modificada pela última vez. Se nenhuma atualização tiver sido feita, esse valor será o mesmo que o book_date. | 2023-10-21T00:00:00.000Z |
booking_item | Objeto que representa os elementos individuais da reserva. Consulte a tabela booking_itempara itens aninhados. | — |
package_indicator | Se o item da reserva faz parte de um pacote (como voo + hotel). | Valores possíveis: Parte do pacote Somente acomodação Desconhecido |
currency_code | Moeda em que a reserva foi paga, representada no formato padrão de código de moeda do Número Internacional de Conta Bancária (IBAN). | US$ |
gross_booking_value | O valor bruto da reserva (GBV, na sigla em inglês), ou seja, o valor total da reserva, incluindo impostos e taxas, na moeda utilizada para o pagamento. | 694.89 |
base_price | Valor cobrado do cliente antes de impostos, taxas e ajustes. Serve de base para a atribuição de pontos. Exibido na moeda utilizada para o pagamento. | 154.78 |
award_date* | Data em que os pontos serão atribuídos, representada no formato de data ISO 8601 (YYYY-MM-DD). | 2023-03-14 |
point_definition | Indicador de uma campanha ou promoção que altera o modelo básico de ganhos do seu programa. | Partner_2X_promo |
pending_points | Número de pontos ganhos, mas ainda não atribuídos. | Decomposto em: total: –100,11 base: –90,01 bônus: –10,1 |
awarded_points | Número de pontos atribuídos à transação. | Decomposto em: total: 100,11 base: 90,01 bônus: 10.1 |
program_name | Nome do programa de fidelidade. | Recompensas |
member | Objeto que representa informações do cliente. Consulte a tabela memberpara itens aninhados. |
Observações para todos os campos
* Os campos de data estão no Horário Padrão do Pacífico (PST), levando em consideração o horário de verão.
** Dados de Informação Pessoal Identificável (IPI). Certifique-se de lidar com isso corretamente, seguindo as diretrizes da sua empresa, e inclua essa informação somente quando for absolutamente necessário.
Detalhes da API
Explore as definições dos pontos de extremidade nesta página e use um software de teste de API para comparar os exemplos e as definições de esquemas com o resultado real.