【AirHost API】「社内システム」実装のFAQ

標準人数フィールド

ChildA ～ ChildD フィールド

child_a_count ～ child_d_count は、日本のホテル・旅館業界で使用される年齢区分を参考に、child_count を細分化した値です。

child_d_count と添い寝の関係について

一部OTA（楽天トラベル、一休、手間いらず）では、child_d_count は「寝具不要」の意味として利用されています。そのため、概ね「添い寝」に近い意味として扱われています。ただし、OTAごとに定義が異なるため、child_d_count を「添い寝人数」として完全に信頼することはできません。

[理由]

そのため、infant_count や child_d_count を単純に「添い寝人数」とみなすことはできません。

なお、Airbnb の infant_count は「2歳未満」という比較的明確な定義のため、寝具不要人数の参考値としては最も信頼性が高いフィールドです。

child_count と ChildA～D の関係について

[注意点]

以下の関係は、厳密な一致を保証するものではありません。

child_a + child_b + child_c + child_d ≤ child_count

さらに、実際には < だけでなく > になるケースもあります。これは、ChildA～D が child_count を完全に分割した値ではなく、「OTA情報をもとに可能な範囲で分類した結果」だからです。

A～D 合計が child_count より少なくなるケース（<）

年齢ベースOTA（Booking.com / Expedia / Opera など）では、AirHost側で以下のような簡易マッピングを行っています。

ただし、3歳未満や12歳超は ChildA～D に含まれません。

[例]

の場合：

となります。13歳は ChildA～D の範囲外のため除外されるためです。

A～D 合計が child_count より多くなるケース（>）

日本OTA（一休・楽天トラベル・手間いらず）では、OTA側の child_count に含まれない「幼児区分」が ChildA～D 側には含まれる場合があります。

[例（一休）]

一休では：child_count = ChildA + ChildB

という扱いですが、child_a/b/c/d_count 側には ChildC・ChildD も含まれます。

そのため：child_a + child_b + child_c + child_d > child_count　となる場合があります。

[注意点]

APIで清掃管理を行う場合

清掃管理システムに必要な『予約関連のデータ』を提供することは可能ですが、清掃管理機能そのものは備えておりません。

例えば、APIを介して『清掃タスクの作成』『清掃スタッフの割り当て』『清掃ステータスの更新』などを行うことはできません。これらの機能につきましては、ユーザー様のシステム側で構築・ご対応いただく必要がございます。

トピック

説明

理由

per_dayとNet Room Feeの関係

per_day は1日あたりの部屋料金を表します。ただし、必ずしも正味の部屋料金とは限りません。
​
​include_in_per_day_fee=true の料金項目がある場合、その金額はすでにper_dayに含まれているため、総価値となります。
​
正味の部屋料金を計算するには、含まれている料金を差し引く必要があります。

構成によっては、一部の料金（例:サービス料）が部屋料金にまとめられる場合があるため、per_dayは純価値または総価値のいずれかを表すことができます。

API仕様では、per_dayとfee_breakに対応しています

Public API仕様で定義された正式にサポートされたフィールドです。

これにより、インテグレーターはこの分野の実装に安全に頼ることができます。

チャネルとソース間のアベイラビリティ

per_day は、Booking.com、その他のOTA、手動予約、料金プランなど、チャネルやソースに関係なく返されます。

APIは、異なる予約ソース間で一貫したデータ構造を維持します。

予約状況がper_dayに与える影響

per_day の存在は、部屋の料金ラインが無効になったかどうかによって異なります。
​
•OTAキャンセル:
部屋料金は通常無効になります→ per_day が空になります
​
•手動で作成/ユーザーがキャンセルした予約で、部屋の料金ラインが無効になっていない場合:
​per_day のアイテムはキャンセル後も返品されます。

異なるキャンセルフロー（OTAと手動）は、財務ラインアイテムを異なる方法で処理し、per_day が保持されるかどうかに影響を与えます。

per_dayとその他の料金の関係（例:cleaning_fee、channel_fee）

cleaning_fee とchannel_fee は常に別々の行項目としてリストされます。
​
ただし、それらが per_day に含まれるかどうかは、include_in_per_day_fee によって異なります。
​
•false → per_day から分離する
•true →すでに per_day に含まれています

料金設定によって、料金が個別に項目化されるか、客室料金にまとめられるかが決まります。

トピック

説明

理由

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を介してこれを自動的に解決する方法はありません。

決済金額（payments[].amount）

OTAが宿泊客へ請求した予約金額（総額）です。手数料控除後にOTAから施設へ振り込まれる実際の振込額（ネット額）ではありません。

決済日付（payments[].date）

AirHost上で決済データが作成された日付です。OTAからの実際の振込日ではありません。

OTA手数料の確認方法

payments[].amount に手数料は含まれません。チャネル側から手数料データが共有されている場合、予約詳細API（GET /room_reservations/{id}）の channel_fee フィールドにてご確認いただけます。