預訂收據

透過 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 Collect 預付和更新的 Expedia Collect 預付：如同先前所述，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 業務代表聯絡。