預訂收據
透過 Rapid API 向旅客提供已預付的預訂收據。
簡介
在許多情況下,您、您的企業客戶和旅客需要取得住宿預訂的收據或付款證明:
- 商務旅客可能需要取得付款證明,才能向雇主申請旅遊費用。
- 您的客戶可能需要取得文件,以利進行旅遊支出對帳作業,並做為內部回報之用。
- 您可能需要透過文件處理財務報告、分享給公司會計、開立帳單發票,或進行預訂對帳作業。
- 休閒旅客可能需要收據,以進行個人財務管理或費用報告。
Rapid API 預訂收據
Rapid API 的預訂收據功能可讓您取得 PDF 形式的行程 API 回應,以利將這些收據整合到您的各種工作流程中。例如,您可以選擇透過電子郵件將收據傳送給客戶或旅客、在旅行管理頁面上儲存和顯示文件,或將 PDF 提供給支援人員和業務團隊使用。
根據預設,Rapid API 預訂收據會包括:
- 旅宿資訊,包括名稱、地址、房價類型和房型
- 旅客資料
- 住宿日期
- 總預訂費用的細項,包括每晚房價和任何額外收費或稅金
- 預訂的目前狀態 (已預訂、已更改或已取消)
多客房預訂可提供預訂收據。與預訂相關的每間客房將顯示在文件的個別頁面上。
設定您的預訂收據
您在預訂收據的設定上也有一些靈活性。您可以:
- 在預訂收據配置期間,您可以選擇使用預設的 Expedia 品牌版本或無品牌版本的文件。您可以透過調整「擷取 API」要求的參數,來覆寫這個品牌預設值。
- 在「擷取 API」要求中包含這些詳細資料,以選擇收據應包含哪些客戶詳細資料,包括公司名稱和/或地址。
- 使用「 Rapid 預訂 API」時,請在預訂時包含收件者的電子郵件地址。隨後將產生預訂收據,並在預訂、變更或取消時自動傳送給收件人。
擷取 Rapid API 預訂收據
透過 Rapid 行程 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
欄位中的連結存取檔案,然後利用自己的內部系統來透過電子郵件將收據傳送給旅客或旅行社。
包含在 Rapid API 預訂收據中的選用詳細資料
您可以選擇在預訂 API 要求中提供其他公司、客戶和旅客詳細資訊,以進一步修改預訂收據。這些內容都是選用參數,並非產生預訂收據的必要資訊。請參閱下表,以了解可供使用之選用參數的詳細資料。
選用參數 | 詳情 | 範例 |
---|---|---|
point_of_sale_display | 要在預訂收據文件上顯示的合作夥伴公司名稱或法人實體 | ABC 旅行社 ABC 旅行社有限公司 |
company_name | 客戶的公司名稱 | ACME 公司 |
company_address | 客戶的街道地址 | 10000 台北市中央街 100 號 |
用來接收預訂收據 PDF 的電子郵件地址。這可以包括客戶和/或旅客聯絡人。 | j.doe@acme.com |
預訂收據與發票文件來源
負責為住宿預訂提供收據或發票的實體,將視合作夥伴、房價類型,以及負責向旅客收取費用的實體而定。
- **入住時付款:**如果旅宿是向旅客收取住宿費用,以及旅客入住期間進行之現場消費費用的實體,則旅宿應負責向旅客提供收據和/或稅務發票。Expedia Group 無法代表旅宿提供入住時付款預訂的預訂收據和/或發票。
- Expedia Collect 預付和更新的 Expedia Collect 預付: 如同先前所述,Expedia 現在可針對透過 Rapid API 預付費用的預訂提供預訂收據。請注意,此預訂收據文件可做為預訂的付款證明,但並非稅務發票。針對在旅宿支付的任何預訂費用,以及旅客在入住期間於進行之額外現場消費,旅宿仍需負責提供收據和/或稅務發票。請參閱下方與 Rapid 預訂收據功能相關的詳細資料。
付款模式 | 預訂收據的來源 | 稅務發票的來源 |
---|---|---|
入住時付款 | 旅宿會提供預訂金額和現場費用的收據。 | 旅宿可針對其服務開立稅務發票 |
更新的 Expedia Collect 預付 | Expedia 會提供預訂金額的收據。旅宿會提供現場費用的收據。 | 旅宿可針對其服務開立稅務發票 |
Expedia Collect 預付 | Expedia 會提供預訂金額的收據。旅宿會提供現場費用的收據。 | 旅宿可針對其服務開立稅務發票。注意:Expedia 無需為自身提供的服務開立稅務發票 |
想要啟用 Rapid API 預訂收據嗎?歡迎與您的 Expedia 業務代表聯絡。