Developer Hub
此為系統自動產生的翻譯

發票與預訂收據

簡介

在許多情況下,您、您的企業客戶或出差人員都需要查閱住宿預訂的收據或發票:

  • 商務旅客可能需要出示付款證明,才能向雇主申報差旅費
  • 您的客戶可能需要相關文件,以協助核對差旅支出或用於內部報告之用
  • 您可能需要這些文件來進行財務報表編製、與企業帳戶共享資料、開立 bill-back 發票,或進行帳務對帳。
  • 休閒旅客可能需要收據,以便進行個人財務管理或報銷

發票是符合法律規定的正式文件,通常由 tax-registered 的賣家在 check-out 進行住宿預訂時開立。預訂收據是付款證明,可隨時開立 post-payment.

針對住宿預訂,負責向旅客提供預訂收據或發票的單位,將視付款模式而定。

付款模式預訂收據的來源發票來源
入住時付款旅宿會開立一張包含預訂金額及現場費用的預訂收據。旅宿會針對其服務開立稅務發票,Rapid 合作夥伴可透過 Rapid 提出申請。
更新的 Expedia Collect 預付Expedia 會針對預訂金額開立預訂收據,Rapid 合作夥伴可透過 Rapid 提出申請 (詳見下文)。

旅宿提供現場費用的預訂收據。
旅宿會針對其服務開立稅務發票,Rapid 合作夥伴可透過 Rapid 提出申請。
Expedia Collect 預付Expedia 會針對預訂金額開立預訂收據,Rapid 合作夥伴可透過 Rapid 提出申請 (詳見下文)。

旅宿提供現場費用的預訂收據。
旅宿可自行決定是否就其服務開立稅務發票,因為在許多司法管轄區內,該公司並無此義務。

如何辨識已更新的 Expedia Collect 合作飯店

在 Rapid 內容中,更新後的 Expedia Collect 被視為 Expedia Collect 住宿清單的子集。若合作夥伴希望識別一個已更新的 Expedia Collect 旅宿,則expedia_collectupdated_expedia_collect 兩者都必須為 true.

商業模式警示

欄位類型說明
Property_collect布林值旅宿會直接向房客收取款項。
updated_expedia_collect布林值Expedia 會在旅客預訂時向其收取款項,而飯店則會在旅客退房後收到款項。新增了適用於旅宿的通知與付款功能。
expedia_collect布林值Expedia 會在旅客預訂時向其收取款項,而飯店則會在旅客退房後收到款項。

商業模式物件範例

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

預訂收據

Rapid API 的「預訂收據」功能,可讓您取得 Expedia Collect 及更新版 Expedia Collect 預訂之行程 API 回應的 PDF 版本。接著,您可以將這些收據整合到您的工作流程中。

舉例來說,您可以選擇:

  • 將收據透過電子郵件寄送給客戶或旅客
  • 將文件儲存並顯示於行程管理頁面中
  • 將該 PDF 提供給您的客服人員和業務團隊

根據預設,Rapid API 預訂收據會包括:

  • 旅宿資訊,包括名稱、地址、費率類型及客房類型
  • 旅客資料
  • 住宿日期
  • 預訂總費用的明細,包括每晚房價以及任何額外稅金或費用
  • 預訂的目前狀態 (已預訂、已更改或已取消)

multi-room 的預訂皆可提供預訂收據。與該預訂相關的每個客房將顯示在文件中的獨立頁面中。

啟用 Rapid API 預訂收據

想要啟用 Rapid API 預訂收據嗎?請聯絡您的 Expedia Group 業務代表。

設定您的預訂收據

在預訂收據的設定方式上,您擁有一定的彈性。

您可以:

  • 在預訂收據的導入過程中,請選擇預設使用 Expedia 品牌版或非品牌版的文件
  • 透過調整「擷取 API」請求的參數,可覆寫此品牌設定預設值
  • 請在「擷取 API」請求中包含相關資訊,以選擇應在收據上列出的客戶詳細資料,包括公司名稱和/或地址
  • 使用 Rapid Book API 預訂時,請一併提供收件人的電子郵件地址

在預訂、變更或取消時,系統將生成預訂收據並自動發送給收件人

檢索 Rapid API 的預訂收據

您可以透過 Rapid Itinerary API 回應中「non_vat_expedia_invoice」欄位 (itinerary-level) 內的連結,存取預訂收據。

範例行程 API 回應

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

您也可以在「預訂 API」請求正文中加入電子郵件地址,選擇將文件透過電子郵件寄送給特定聯絡人。

預訂 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 Travel / ABC Travel 有限公司
company_name客戶的公司名稱。ACME 公司
company_address客戶的街道地址。10000 台北市中央街 100 號
email請提供用於接收預訂收據 PDF 檔案的電子郵件地址。這可以包括客戶和/或旅客聯絡人。j.doe@acme.com

注意: 您應僅在「email」欄位中填寫旅客的電子郵件地址或其公司電子郵件地址。所提供的電子郵件地址絕不應是您本人的,也不應是您所屬組織內的聯絡人。

發票

Rapid 合作夥伴可使用 Booking API 中的 ``invoicing 物件,向供應商通知需要開立發票。若需要,合作夥伴除旅客姓名外,亦可將企業客戶的詳細資料一併列入發票中。

這比透過電子郵件或傳真傳送 PDF 檔案,或是讓「旅客須知」或「特殊要求」欄位內容過於冗長,都要來得理想。

傳遞增值稅發票請求欄位時,不會觸發發送通知至旅宿。正確來說,這些欄位是透過「Partner Central」外網,以及各平台用來讀取 Expedia Group 預訂資料的連線 API,傳輸至各住宿設施的。

傳入這些欄位有以下好處:

  • 讓物業方預先知悉需要開立增值稅發票
  • 讓他們有機會為該名差旅人員開立發票

然而,針對旅宿上的「Expedia Collect」及「Updated Expedia Collect」預訂,處理開立發票的請求並將發票提供給旅客,仍屬旅宿的責任。

注意

  • 若要將發票請求轉交給供應商,必須傳入布林值 ``consent_to_share

包含開立發票物件的預訂 API 請求範例程式碼片段

{
  ...
  "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"
  }
}

注意: 您應僅在「email」欄位中填寫旅客的電子郵件地址或旅客的公司電子郵件地址。所提供的電子郵件地址絕不應是您本人的,也不應是您所屬組織內的聯絡人。

針對「Updated Expedia Collect」預訂,申請預訂收據及公司發票

已啟用「預訂收據」和「企業發票」兩項功能的合作夥伴,可在預訂中同時使用這兩項功能。

若合作夥伴針對「Expedia Collect」的更新訂單提供consent_to_share

  • Rapid 將把發票申請轉交給供應商,請其透過 check-out, 開立發票,並
  • 合作夥伴亦可檢視該預訂的預訂收據。

若合作夥伴未提供consent_to_share,則不會向供應商傳送任何資訊,但合作夥伴仍可取得預訂收據。

這個頁面對您有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!