忠诚度赚取 API 交付
通过 Loyalty Earn，您可以将客户的忠诚度 Rewards 与您的计划相协调。您还可以使用数据提供待定和已授予积分的 up-to-date 视图、分析计划趋势并为您的利益相关者创建报告。
送货选项
我们的忠诚度赚取服务允许您通过拉取机制检索数据，该机制提供详细的行程数据以支持：
- 数据分析
- 为顾客奖励积分
- 服务台调查
此服务由两个 HTTP GET端点组成，允许您：
- 查看数据最后更新的时间。忠诚度积分每天更新。
- 使用
transaction_date_start、transaction_date_end、and membership_id或itinerary_id变量创建指定时间范围内待定或奖励的忠诚度货币列表
有关身份验证过程的详细信息，请参阅API 设置。
可用字段
下表列出了通过我们的 Push 和 Pull 交付方式提供的字段，包括所有嵌套对象。
| 字段名称 | 定义 | 示例 |
|---|---|---|
itinerary_id | 行程编号或销售网站订单参考编号。 | 72622069245694 |
transaction_type | 已记录的交易类型。 | 可能的值： 购买 奖 修改 取消 |
transaction_date* | 预订最后修改的日期。如果预订从未更新，则这与 book date相同。以 ISO 8601 日期格式表示（YYYY-MM-DD）。 | 2023-02-05 |
transaction_datetime* | 上次修改预订的日期和时间。如果没有进行更新，则该值与相同book_date。 | 2023-10-21T00:00:00.000Z |
booking_item | 代表单个预订元素的对象。请参阅 booking_item表以了解嵌套项。 | — |
package_indicator | 预订项目是否属于套餐的一部分（例如机票 + 酒店）。 | 可能的值： 部分包装 单独预订 未知 |
currency_code | 支付预订的货币，以标准国际银行账号 (IBAN) 货币代码格式表示。 | USD |
gross_booking_value | 总预订价值 (GBV)，即包含税费在内的总预订金额，以支付时使用的货币表示。 | 694.89 |
base_price | 在扣除税款、费用和调整之前向客户收取的金额，以此金额为基础发放积分。以支付时使用的货币显示。 | 154.78 |
award_date* | 获得积分的日期，以 ISO 8601 日期格式表示（YYYY-MM-DD）。 | 2023-03-14 |
point_definition | 改变您计划基本收入模式的营销活动或促销活动的指标。 | Partner_2X_promo |
pending_points | 已获得但尚未授予的积分数。 | 细分为： 总计：-100.11 基数：-90.01 奖金：-10.1 |
awarded_points | 交易所获得的积分数。 | 细分为： 总计：100.11 基数：90.01 奖金：10.1 |
program_name | 会员计划名称。 | 奖励 |
member | 代表客户信息的对象。请参阅 member表以了解嵌套项。 |
所有字段的注释
* 日期字段采用太平洋标准时间 (PST)，以节省夏令时。
** 个人身份信息 (PII) 数据。请务必按照公司的指导方针正确处理此事，并且仅在绝对必要时才包含。
API 详情
查看此页面上的端点定义，然后使用 API 测试软件来了解示例和模式定义与实际输出的比较。