「到着日で絞る予約API」で滞在中ゲストを取り落とし、空室・閉室を誤判定しない

症状

PMS / チャネルマネージャの予約一覧 API（Beds24 の /bookings?arrivalFrom=&arrivalTo=、同種の checkInFrom/To を持つ API 全般）を 「調べたい期間の開始日〜終了日」で呼ぶと、期間の前に到着して期間中も滞在しているゲストが1件も返らない。 その結果を在庫カレンダーと突き合わせると、在室中の部屋が「予約が無いのに閉じている＝開け忘れ」に見え、 在庫を開ける提案や自動開放に進むとダブルブッキングになる。

実例: 10/1 着〜10/10 発の予約がある部屋を、10/3〜10/30 の窓で照会 → 予約ゼロと判定 → 「10/3〜10/9 を開放してよいか」と担当者に確認してしまった。 担当者が管理画面の予約バーを見て即座に否定した。

原因

到着日フィルタは「期間内に到着した予約」しか返さない。期間と重なる滞在（期間前到着・期間後出発）は条件の外。 API も GAS などの中継層も、エラーを出さず正常応答で件数が少ないだけなので、取得漏れに気付けない。

対策（実装）

1. 照会の開始日を 最長滞在日数ぶん遡る（目安 45 日。施設の最長滞在 + 余裕）:

   fetchFrom = from − LOOKBACK_DAYS
   bookings  = api.bookings({ arrivalFrom: fetchFrom, arrivalTo: to })
   

2. 取った予約を 泊単位に展開し（arrival 〜 departure−1）、調べたい期間の泊だけを占有セットに入れる。 遡った分で窓の外の泊が増えても、照合は窓内の日付しか引かないので切り詰めは不要。
3. 同じ予約が月またぎで二重に返る API では、予約 ID で重複排除する。
4. count と実際に返った件数が食い違う月は「判定不能」として扱い、exit code を分ける（穴ゼロと同じ 0 にしない）。

対策（運用）

• 在庫を「開けてよいか」と人に聞く前に、その部屋・その日に滞在中ゲストがいないことを予約 ID 付きで示す。
• 同じ期間を2本の道具（稼働率ツールと在庫穴ツール）で数え、実予約数が合わなければ、まず取得窓の違いを疑う。
• 読み戻しツールは作業ツリーのコードで動く。修正後も古いブランチで走らせると再発するので、実行前にツリーが main 以降か確認する。

検証

• 修正前後で同じ期間を照会し、「予約なしの閉室」の件数が管理画面の予約バーと一致することを目視で確認する。
• 期間開始日の前日に到着する予約をテストデータに入れ、修正後だけ占有として数えられることをユニットテストにする。