Airbnb API 連線中斷：重新授權房源，避免重複訂房

Airbnb 通路管理系統出現警示時，管理者往往急於釐清兩個問題：訂房是否仍正常接收？重新連線會不會造成重複訂房？最穩妥的復原方式，是保留原有房源，並查明中斷期間的實際情況。

本文所指的 API 是軟體直接連線，而非匯入的日曆連結。恢復授權是一項工作；確認訂房與空房狀況一致，則是另一項工作。

移除任何存取權限前，先確認連線是否中斷

在 Airbnb 電腦版開啟房源，選取受影響的房源，接著在房源編輯器中開啟設定，並檢查物業管理軟體。將此處的狀態與已連接軟體中的警示進行比對。選單名稱可能因帳號與介面版本而異。

確認受影響的是單一房源還是整個帳號。只有一間公寓失去連線，與所有房源同時失去供應商連線，需要採取不同的排查方式。

若軟體仍維持連線，但日曆資料不一致，請先執行供應商支援的空房狀況重新同步，並檢查相關規則。請勿為了修正日曆資料不一致而中斷軟體連線、刪除或重建房源。若問題仍未解決，請交由供應商進一步處理。

若供應商回報服務中斷，且未出現授權錯誤，反覆嘗試重新連線可能無法解決問題。請記錄訊息及最後一次成功更新的時間，並遵循供應商的復原指引。不要將每次更新延遲都歸因於新的存取權限問題。

若確認連線確實中斷，請找出獲授權管理既有房源的 Airbnb 帳號，並確認負責恢復存取權限的人員具備必要權限。團隊成員能查看訂房，並不代表有權重新連接帳號。

保留原有房源，妥善管理中斷期間的營運

變更連線前，先建立簡要的復原紀錄：Airbnb 帳號、房源 ID、對應的飯店管理系統房源單位、最後一次已知成功更新的時間，以及此後新增、修改或取消的訂房。飯店管理系統的英文全名為 Property Management System。

請使用房源 ID，不要只憑名稱判斷。兩個房源單位可能使用相同標題，而更名後的房源仍可能是原本的住宿產品。請儲存既有對應關係，避免員工在重新連線畫面中誤選另行發布房源。

若復原期間無法確保空房狀況可靠，請依核准流程暫停銷售或暫時下架房源，並確認新訂房已受到相應限制。暫停銷售不等於取消既有住宿；仍須持續服務目前的旅客，並處理收到的訂房變更。

指定一名員工統一管理臨時訂房或保留房間。若即將抵達的旅客訂房未出現在飯店管理系統中，請先核對 Airbnb 上的實際訂房確認資料。僅使用住宿業者核准的臨時紀錄或保留房間方式，並清楚標註對應的來源訂房。恢復匯入後，必須完成核對與整併，不能將其留作第二筆住宿紀錄。

中斷期間，手動保留房間與匯入的訂房可能同時占用同一個房源單位。在 Smart Order 中，請將 Airbnb 訂房與接待處訂房日曆進行核對，讓團隊在核准另一筆紀錄前，先確認既有住宿及其對可售房量的影響。復原的目標是恢復一筆可正常管理的訂房，而不只是消除警示。

重新授權帳號，並對應既有房源

請從已連接軟體所支援的 Airbnb 連線或復原流程開始操作。實際按鈕名稱依供應商而異；請勿使用來路不明電子郵件中的連結，也不要將 Airbnb 密碼提供給客服人員。

1. 選擇需要復原的既有 Airbnb 連線。繼續操作前，先確認住宿物業與帳號正確。
2. 依照供應商的登入與授權流程操作。在 Airbnb 官方授權畫面上，先確認帳號及要求的存取權限，再進行授權。
3. 返回軟體，將每個既有 Airbnb 房源 ID 對應至原本的飯店管理系統房源單位或客房產品。請選擇既有房源選項，不要執行發布新房源的操作。
4. 確認預期的同步範圍。依原先約定，恢復房價與空房狀況的同步，或涵蓋更多房源內容的同步；避免在復原過程中意外變更內容管理權限的歸屬。
5. 完成供應商支援的日曆與訂房同步。再次檢查各房源的連線狀態，並記錄仍需處理的項目。

若找不到正確房源，請先停止操作，不要發布替代房源。請與供應商核對目前登入的帳號、房源存取權限及已儲存的連線。新增房源無法修復與舊房源訂房或評價之間的連結。

請勿將移除軟體的 Airbnb 存取權限當作例行的第一步。此操作會中斷所有與該軟體關聯的房源連線。只有在供應商確認確有必要，且已妥善保障受影響房源的情況下，才依序移除權限並重新連線。若決定改用其他飯店管理系統，則屬於獨立的系統移轉作業，並非一般的重新連線。

核對連線中斷期間收到的訂房

根據 Airbnb 訂房紀錄建立受影響清單，並與飯店管理系統比對。若無法確定中斷的確切開始時間，請將查核範圍往前延伸至最後一次已知成功更新之前，保留重疊的查核時段。請確認供應商可匯入的資料範圍，不要假設所有舊有住宿紀錄都會自動重新出現。

針對每筆訂房，先核對Airbnb 確認碼與房源 ID，再比對目前狀態、日期、入住人數與客房分配。僅憑旅客姓名不足以可靠識別訂房，因為同一位旅客可能確實有兩筆不同的住宿。

若飯店管理系統中已有一筆正確紀錄，請確認後續支援的變更會更新至該筆紀錄。不要只因最新的日期變更尚未同步，就再次匯入同一筆訂房。若尚無紀錄，請使用供應商核准的資料擷取方式，並在手動建立任何紀錄前再次搜尋。

若臨時紀錄與復原後匯入的紀錄同時存在，請停止重複發送訊息、付款請求及進一步編輯。由主管確認應保留哪一筆已連線紀錄，並在採用核准的重複紀錄處理流程前，妥善保留客房分配、備註及財務往來資料。切勿為了整理飯店管理系統中的紀錄，而取消 Airbnb 上的真實訂房。

決定保留哪筆紀錄後，統一核對一次可售房量。移除多餘的保留房間紀錄時，可能已釋出一個房源單位；若再手動增加一個可售單位，就可能造成超賣。請確認取消訂房會釋出正確日期的房量，且訂房修改會調整原有住宿，而非新增第二筆抵達紀錄。

確認訂房流程各環節資料一致後，再恢復銷售

顯示已連線不代表復原完成。請確認連接的仍是原有房源、目前每筆訂房僅出現一次，且 Airbnb 日曆與飯店實際可售房源單位一致。檢查一個正常開放銷售的日期及一個已保留或封鎖的日期，並抽查具代表性的房價與住宿限制。

使用 Smart Order 的Airbnb 通路管理系統，依據已核對完成的飯店管理系統紀錄，將剩餘空房狀況同步至通路，接著確認通路端的結果。必須先釐清目前由哪個系統控制這些日期，才能解除暫停銷售。

若有核准的測試環境或訂房測試程序，請確認訂房變更會更新同一筆飯店管理系統紀錄，且取消訂房時只會釋出一次對應的可售房量。否則，請密切監控接下來的真實訂房異動，並在復原紀錄中註明此項驗證限制。

若房源仍未恢復連線，或紀錄仍不一致，請提供房源 ID、受影響的確認碼、警示文字、附時區的事件時間，以及已採取的處理措施，交由供應商進一步處理。請遮蔽不必要的旅客個人資料，切勿提供密碼或信用卡資料。

當原有房源恢復連線、中斷期間的住宿均已核對處理，且由雙方確認的單一空房資料來源重新統一管理，才算完成復原；另行發布一套房源並不代表問題已解決。