發票與預訂收據
簡介
在許多情況下,您、您的企業客戶或旅客需要取得住宿預訂的收據或發票:
- 商務旅客可能需要支付證明,才能向雇主申報差旅費用。
- 您的客戶可能需要文件以協助核對差旅支出或用於內部報告目的
- 您可能需要文件以供財務報告、與企業帳戶共享、生成 bill-back 發票或進行帳務核對之用。
- 休閒旅客可能需要收據以供個人財務管理或費用申報之用。
發票是符合法律規範的正式文件,通常由 tax-registered 賣方於 check-out 辦理預訂登記時開立。訂單收據是付款證明,可隨時開立。post-payment.
負責向旅客提供住宿預訂收據或發票的實體,將取決於支付模式。
| 付款模式 | 預訂收據來源 | 發票來源 |
|---|---|---|
| 入住時付款 | 旅宿提供預訂金額與現場費用的預訂收據。 | 旅宿針對其服務開立稅務發票,Rapid 合作夥伴可透過 Rapid 平台提出申請。 |
| 更新的 Expedia Collect 預付 | Expedia 會提供預訂金額的預訂收據,Rapid 合作夥伴可透過 Rapid 系統申請 (詳見下文)。 旅宿提供現場費用的預訂收據。 | 旅宿針對其服務開立稅務發票,Rapid 合作夥伴可透過 Rapid 平台提出申請。 |
| Expedia Collect 預付 | Expedia 會提供預訂金額的預訂收據,Rapid 合作夥伴可透過 Rapid 系統申請 (詳見下文)。 旅宿提供現場費用的預訂收據。 | 旅宿可自行決定是否為其服務開立稅務發票,因在許多司法管轄區內,其並無此項義務。 |
如何識別更新後的 Expedia 精選酒店
更新後的 Expedia Collect 在 Rapid 內容中呈現為 Expedia Collect 物業的子集。若合作夥伴需識別更新後的 Expedia Collect 旅宿,則expedia_collect 與updated_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 預訂行程的 PDF 格式行程表 API 回應。您隨後可將這些收據整合至您的工作流程中。
例如,您可能選擇:
- 將收據電郵給客戶或旅客
- 在行程管理頁面儲存並顯示文件
- 讓支援人員和業務團隊能夠取得該 PDF 檔案
根據預設,Rapid API 預訂收據會包括:
- 旅宿資訊包含姓名、地址、費率類型及客房類型
- 旅客資料
- 住宿日期
- 總預訂費用明細,包含每晚房價及任何附加稅費
- 預訂的目前狀態 (已預訂、已更改或已取消)
multi-room 的預訂可提供收據。與該預訂相關的每個客房將顯示於文件的獨立頁面中。
啟用 Rapid API 預訂收據
想要啟用 Rapid API 預訂收據嗎?請聯絡您的 Expedia Group 業務代表。
設定您的預訂收據
您在設定預訂收據時擁有一定的彈性空間。
您可以:
- 在預訂收據整合過程中,選擇預設採用 Expedia 品牌版本或無品牌版本的文件
- 您可以透過調整擷取 API 請求的參數來覆寫此品牌設定預設值。
- 選擇應在收據上包含哪些客戶詳細資訊,包括公司名稱和/或地址,方法是在檢索 API 請求中加入這些詳細資訊。
- 透過 Rapid Book API 於預訂時加入收件者電子郵件地址
- 預訂收據將於預訂、變更或取消時自動生成並發送給收件人
檢索 Rapid API 預訂收據
itinerary-level 您可透過快速行程 API 回應中的「non_vat_expedia_invoice」欄位中的連結,存取預訂收據。
範例行程 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 旅遊 / ABC 旅遊有限公司 |
company_name | 客戶公司名稱。 | ACME 公司 |
company_address | 客戶的街道地址。 | 10000 台北市中央街 100 號 |
email | 預訂收據 PDF 應發送至的電子郵件地址。這可以包括客戶和/或旅客聯絡人。 | j.doe@acme.com |
注意: 您僅需在email 欄位中填寫旅客的電子郵件地址或旅客的公司電子郵件地址。所提供的電子郵件地址絕不應是您本人或您所屬組織內的聯絡人。
發票
快速合作夥伴可透過預訂 API 中的invoicing 物件,通知供應商開立發票的需求。合作夥伴亦可選擇在旅行者姓名之外,於發票中加入企業客戶的詳細資訊。
與其透過電子郵件或傳真發送 PDF 檔,或在旅客指示欄位或特殊要求欄位中塞滿資訊,此方式更為理想。
請注意,傳遞增值稅發票請求欄位不會觸發發送通知至旅宿。相反地,這些欄位是透過 Partner Central 外網及其用於處理 Expedia Group 預訂的連線 API,傳輸至各屬性。
傳遞這些欄位具有以下優勢:
- 使物業預先知悉增值稅發票的需求
- 讓他們有機會為旅客開立發票
然而,處理發票請求並將其提供給旅客,仍是旅宿在旅宿收集及更新 Expedia Collect 預訂的責任。
注意
- 為將發票請求傳遞給供應商,必須傳遞
consent_to_share布林值。若未提供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 欄位中填寫旅客的電子郵件地址或旅客的公司電子郵件地址。所提供的電子郵件地址絕不應是您本人或您所屬組織內的聯絡人。
要求提供更新版 Expedia Collect 預訂的預訂收據及公司發票
同時啟用預訂收據與公司發票功能的合作夥伴,可在預訂時使用這兩項功能。
若合作夥伴為已更新的 Expedia Collect 預訂提供consent_to_share:
- Rapid 將把發票請求轉交供應商,請其透過 check-out, 發出發票。
- 合作夥伴亦可檢索該預訂的預訂收據。
若合作夥伴未提供consent_to_share,系統將不會向供應商傳送任何資訊,但合作夥伴仍可取得預訂收據。