预订收据

为通过 Rapid API 进行预付款预订的旅客提供预订收据。

概述

在许多情况下，您、您的企业客户和旅客都需要获得住宿预订的收据或付款证明：

• 商务旅客可能需要提供付款证明才能向雇主报销差旅费。
• 您的客户可能需要相关文件以对差旅费用进行对账和进行内部报告。
• 您可能需要相关文件以进行财务报告、与公司帐户分享、生成账单回单发票、或进行预订对账。
• 休闲旅客可能需要收据以进行个人财务管理或费用报告。

快速 API 预订收据

通过 Rapid API 的预订收据功能，您可以获得 PDF 格式的行程 API 响应，这样您就可以将这些收据整合到您的各种工作流程中。例如，您可以选择通过电子邮件将收据发送给客户或旅客，在行程管理页面上存储和显示文件，或将 PDF 提供给您的支持代理和业务团队。

默认情况下，Rapid API 预订收据包括：

• 酒店信息包括名称、地址、价格类型和房间类型。
• 旅客详细信息。
• 入住日期。
• 总预订费用明细，包括每晚房价和任何额外的税费。
• 预订的当前状态（已预订、更改或取消）。

可以为多个房间预订提供预订收据。预订涉及到的每个房间都将在文件的单独页面上显示。

配置您的预订收据

您还可以灵活地配置预订收据。您可以：

• 在生成预订收据的过程中，选择文件默认使用 Expedia 品牌还是不使用品牌。您可以通过调整检索 API 请求的参数来覆盖此品牌默认设置。
• 选择应包含在收据中的客户详细信息，包括公司名称和/或地址，方法是在检索 API 请求中包含这些详细信息。
• 使用 Rapid 预订 API 预订时，包含收件人邮箱地址。然后将在预订、变更或取消时生成预订收据，并自动发送给收件人。

检索快速 API 预订收据

通过快速 行程 API 响应的 non_vat_expedia_invoice 行程级别字段中的链接访问预订收据。

示例响应

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  "links": {
    "cancel": { ... },
    "non_vat_expedia_invoice": {
      "method": "GET",
      "href": "/v3/itineraries/8999989898988/invoice?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    }
  },
  ...
}

您还可以选择将文件通过电子邮件发送给特定联系人，方法是在预订 API 请求正文中包含邮箱地址。

请求正文示例

{
  "affiliate_reference_id": "4480ABC",
  ...
  "rooms": [ ... ],
  "payments": [ ... ],
  "invoicing": {
    "company_name": "My Employer",
    "company_address": {
      "line_1": "123 Employer Ave",
      "line_2": "Suite 742",
      "city": "Seattle",
      "state_province_code": "WA",
      "postal_code": "98121",
      "country_code": "US"
    },
    "point_of_sale_display": "My Corporate Travel Site",
    "email": "example@myemployer.com"
  },
  ...
  "traveler_handling_instructions": "Please use the card provided for payment."
}

如果您要求从自己的电子邮件域发送预订收据，我们建议您使用行程 API 响应的 non_vat_expedia_invoice 字段中的链接获取文件，然后使用自己的内部系统将收据通过电子邮件发送给旅客或代理。

可选详细信息包含在快速 API 预订收据中

您可以选择在预订 API 请求中提供其他公司、客户或旅行者详细信息，以进一步修改预订收据。这些是可选参数，生成预订收据时不需要提供。请参见下表，了解您可以使用的可选参数的详细信息。

预订收据与发票文件来源

负责为住宿预订提供收据或发票的实体取决于合作伙伴、房价类型、以及哪个实体负责向住客收款。

• 现付：如果在住客入住期间，住宿负责向住客收取住宿费用以及店内消费的费用，则住宿负责向旅客提供收据和/或税务发票。Expedia Group 不能代表住宿为现付预订提供预订收据和/或发票。
• 预付和更新的预付收款：如上所述，Expedia 现在可以为通过 Rapid API 进行的预付款预订提供预订收据。请注意，此预订收据文件可以作为 预订的付款证明，但不是税务发票。住宿仍有责任为住客在住宿支付的任何预订以及住客在入住期间店内进行的额外消费提供收据和/或税务发票。请参见下文，了解 Rapid 预订收据功能的详细信息。

为企业客户开具发票

旅行管理公司的企业客户可能需要代理酒店预订的发票，以用于公司管理流程，并在适用的情况下退还酒店住宿税。根据上表，对于 Property Collect 和更新的 Expedia Collect 预订，酒店均负责向服务接收者旅客开具（税务）发票。

对于 Property Collect 和更新的 Expedia Collect 预订，invoicing 对象允许合作伙伴通知供应商需要发票。invoicing 对象还为合作伙伴提供了一个选项，要求在发票中除了旅行者姓名之外还包含公司客户的详细信息。

重要的：

• 为了将发票请求传递给供应商，必须传递consent_to_share布尔值。如果consent_to_share未提供，则不会与供应商共享该信息。
• 合作伙伴应考虑将 invoicing 对象用于 Property Collect 和更新的 Expedia Collect 预订，作为向酒店传递“特殊发票请求”的一种方式。提供发票仍是酒店的责任，Expedia 无法保证酒店会按照发票要求开具发票。

示例

{
...
    "invoicing": {
        "consent_to_share": true,
        "company_name": "alphaDemandPartner",
        "company_address": {
            "line_1": "555 1st St",
            "line_2": "10th Floor",
            "line_3": "Unit 12",
            "city": "Seattle",
            "state_province_code": "WA",
            "postal_code": "98121",
            "country_code": "US"
        },
        "email": "chucktesta@mydomain.com",
        "vat_number": "1234567890"
        }
    }
}

如何识别已更新的 Expedia Collect 住宿

更新后的 Expedia Collect 在 Rapid 内容中表示为 Expedia Collect 属性的子集。如果合作伙伴想要识别更新的 Expedia Collect 酒店，则 expedia_collect 和 updated_expedia_collect 都必须为真。

示例

{
    ...
    "business_model": {
        "expedia_collect": true,
        "property_collect": false,
        "updated_expedia_collect": true
    }
}

在更新的 Expedia Collect 预订中请求预订收据和公司发票

同时启用预订收据和公司发票的合作伙伴可以在更新的 Expedia Collect 预订中同时使用这两种功能。如果合作伙伴为更新的 Expedia Collect 预订提供 consent_to_share，Rapid 会将发票请求传递给供应商，以便在结账时开具发票，合作伙伴也将能够检索该预订的预订收据。如果合作伙伴不提供consent_to_share，则不会向供应商发送任何信息，但合作伙伴仍然可以获得预订收据。

是否有兴趣启用 Rapid API 预订收据？请联系您的 Expedia 代表。