メインコンテンツにスキップ

【AirHost API】「ブッキングエンジン(予約サイト)」実装のFAQ

Y
対応者:Yuuki Fujishima

予約作成時の1泊あたりの料金について

予約を作成または更新する際に、POST /stays(Create a Stay)またはPUT/room_reservations/{id}(Update a Room Reservation)を使用する場合、予約自体の1泊あたりの宿泊料金を指定できるフィールドはありません。

Booking Engineを統合する際には、以下の動作に注意してください。

トピック

説明

理由

booking_fee は合計金額のみを受け付けます

room_reservation. booking_fee は、滞在全体の宿泊料金の合計を表す単一の数値フィールドです。作成時に夜間に分解することはできません。

これは、予約作成のためのパブリックAPI仕様の現在の制限です。

合計が毎晩どのように適用されるか

AirHostは、提出された合計を宿泊日数に均等に分割して、予約の1泊あたりの価格を設定します。
この平均値は、予約注文の詳細に表示される値であり、AirHostの自動宿泊税の計算にも使用されます。

一泊あたりの料金が提出されていないため、システムには夜間の内訳を入力するための他の基盤がありません。

料金は1泊あたりの料金の代替ではありません

charges[] (fee_type: booking_fee / dining_fee / cleaning_fee / cancellation_fee / other_fees) は、個々の請求可能な項目

(例:ダイニング、クリーニング、キャンセル料)を記録するために設計されており、夜間の部屋料金を指定するものではありません。

1泊につき1つの料金入力を日付と金額とともに提出した場合でも、このデータは取引/請求書の記録にのみ反映され、予約の1泊あたりの価格には反映されず、自動的な宿泊税の計算にも影響しません。

料金はAirHostが徴収した雑費を中心に設計されました。
夜間料金の代替として扱うと、夜間データを提出せずに料金を意図した目的で使用する他のインテグレーターに影響を与えます。

宿泊税への影響

AirHostの自動宿泊税の計算は、booking_fee から導き出された1泊あたりの価格に基づいているため、税額は実際の1泊あたりのレートではなく、平均1泊あたりのレートを使用して計算されます。
これにより、1人あたり1泊あたりの税金ブラケットを適用する自治体(例:大阪)では異なる結果が生じる可能性があります。

税金の計算は、予約記録と同じ基礎となる1泊あたりのデータから読み取られます。

現在の回避策

正確な1泊あたりの料金と税額が必要な場合は、現在手動で処理する必要があります。
(1)自動生成された宿泊税額を手動で修正するか、(2)APIではなくAirHost UIを使用して手動で予約を作成します。

現在、APIを介してこれを自動的に解決する方法はありません。

こちらの回答で解決しましたか?