发票和预订收据
概述
在许多情况下,您、您的企业客户或旅行者都需要获取住宿预订的收据或发票:
- 商务旅客可能需要提供付款证明才能向雇主报销差旅费用。
- 您的客户可能需要相关文件来帮助核对差旅支出或用于内部报告。
- 您可能需要用于财务报告、与公司账户共享、生成 bill-back 发票或账务对账的文档。
- 休闲旅行者可能需要收据用于个人财务管理或费用报销。
发票是符合法律规定的正式文件,通常由 tax-registered 卖家在 check-out 住宿预订时开具。预订收据是付款证明,可随时开具 post-payment。
负责向旅客提供住宿预订收据或发票的实体取决于付款模式。
| 付款模式 | 预订收据来源 | 发票来源 |
|---|---|---|
| 现付 | 酒店会提供预订收据,列明预订金额和现场费用。 | 物业会为其服务开具税务发票,Rapid 合作伙伴可以通过 Rapid 申请该发票。 |
| 更新的预付 | Expedia 提供预订金额的预订收据,Rapid 合作伙伴可以通过 Rapid 请求该收据(见下文)。 酒店会提供现场费用的预订收据。 | 物业会为其服务开具税务发票,Rapid 合作伙伴可以通过 Rapid 申请该发票。 |
| 预付 | Expedia 提供预订金额的预订收据,Rapid 合作伙伴可以通过 Rapid 请求该收据(见下文)。 酒店会提供现场费用的预订收据。 | 物业公司可自行决定是否为其服务开具税务发票,因为在许多司法管辖区,他们没有义务这样做。 |
如何识别已更新的 Expedia 收集属性
更新后的 Expedia Collect 在 Rapid 内容中表示为 Expedia Collect 属性的子集。如果合作伙伴想要标识已更新的 Expedia 收集属性,则 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 收集和更新的 Expedia 收集预订的行程 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"
}
},
...
}您还可以通过在 Booking 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 预订收据中可包含的可选详细信息
您可以在 Booking API 请求中提供额外的公司、客户或旅行者详细信息,以进一步修改预订收据。这些是可选参数,生成预订收据时不需要提供。
请参阅下表,了解有关可选参数的更多详细信息。
| 可选参数 | 说明 | 示例 |
|---|---|---|
point_of_sale_display | 合作公司名称或法人实体名称将显示在预订收据上。 | ABC 旅行社/ABC 旅行有限公司 |
company_name | 客户公司名称。 | ACME Corp |
company_address | 客户的街道地址。 | 100 Main St, Miami, FL 10000 US |
email | 请提供接收预订收据 PDF 文件的电子邮件地址。这可能包括客户和/或旅客联系人。 | j.doe@acme.com |
注意: 您只需在email字段中提供旅行者的电子邮件地址或旅行者的公司电子邮件地址。提供的电子邮件地址绝不能是您本人的,也不能是您所在组织内任何联系人的。
发票
Rapid 合作伙伴可以使用 Booking API 中的 invoicing 对象来通知供应商需要发票。合作伙伴还可以选择在发票上添加企业客户的详细信息(除旅行者姓名外)。
这比通过电子邮件或传真以 PDF 格式发送信息,或者在旅客须知或特殊要求字段中填写过多信息要好得多。
需要注意的是,填写增值税发票申请字段不会触发向物业发送通知。相反,这些字段通过 Partner Central 外联网和它们用来处理 Expedia Group 预订的连接 API 传输到各个属性。
传递这些字段的好处是:
- 提前告知物业需要增值税发票
- 让他们有机会为旅行者生成发票。
但是,对于 Property Collect 和 Updated Expedia Collect 预订,处理发票请求并将其提供给旅行者仍然是酒店的责任。
注意
- 要向供应商发送发票请求,必须传递布尔值
consent_to_share。如果未提供consent_to_share,则不会与供应商共享该信息。
包含发票对象的 Booking 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 收集预订信息)
同时启用预订收据和企业发票功能的合作伙伴可以在预订时使用这两个功能。
如果合作伙伴提供consent_to_share更新后的 Expedia 收款预订:
- Rapid 会将发票请求转发给供应商,以便其在 check-out 开具发票,并且
- 合作伙伴还可以获取预订的预订收据。
如果合作伙伴不提供consent_to_share,则不会向供应商发送任何信息,但合作伙伴仍可获得预订收据。