第三方接入-飛豬酒店商品釋出流程

酒店商品釋出

前言

我們接的一個外包要求我們能夠調用代理通和飛豬的接口實作将攜程的資料同步到飛豬, 是以将至記錄下來,以下是參考飛豬酒店商品釋出部分的文檔而寫

商品推送步驟

1. 新增酒店
2. 新增房型
3. 新增rateplan(價格計劃)
4. 新增庫存
5. 新增價格

新增庫存可以分為room共享庫存和rate專有庫存, rate接口參數use_room_inventory,傳true表示使用room共享庫存, 傳false表示使用rate專有庫存

接口說明

使用接口概覽

接口步驟	API接口	接口說明
維護酒店	taobao.xhotel.update	該接口支援酒店資訊的新增和修改,其中入參outer_id必須賣家唯一
–	–	–
維護房型	taobao.xhotel.roomtype.update	該接口支援房型資訊的新增和修改,其中入參outer_id必須賣家唯一
–	–	–
維護Rateplan價格計劃	taobao.xhotel.rateplan.update	該接口支援房價資訊的新增和修改,對接該接口的時候務必注意payment_type,cancel_policy,guarantee_type三個字段的限制關系
taobao.xhotel.rateplan.add	該接口支援房價資訊的新增和修改,對接該接口的時候務必注意payment_type,cancel_policy,guarantee_type三個字段的限制關系
–	–	–
維護房型共享庫存	taobao.xhotel.rooms.update	房型庫存推送接口(批量全量),此接口用于全量更新多個房型的房型庫存,房态
taobao.xhotel.rooms.increment	房型庫存推送接口(批量增量),此接口用于增量更新多個房型的房型庫存,房态,即傳那一天的庫存,房态 就更新那一天的

• 商家可以同時對接room庫存接口和rate庫存接口, room接口是房型共享庫存, rate接口參數use_room_inventory,傳true表示使用room共享庫存, 傳false表示使用rate專有庫存
• 提高使用者試單體驗, 房型若有長期的固定的多房價綁定且使用同樣的庫存來源時, 建議使用room庫存;臨時的階段性的個性化的促銷活動中,用rate庫存.建議批量全量,批量增量接口兼顧使用
• rate接口中的庫存,價格和開關都是獨立更新的,更新庫存為0或者關房,不一定要更新價格,如果必須要預設價格,需要賣價預設price為-1

接口步驟	API接口	接口說明
維護價格和專有庫存	taobao.xhotel.rates.update	多個(房型+價格計劃)全量價格更新,此接口用于全量更新多個房型和房價緯度的全部庫存價格資訊
taobao.xhotel.rates.increment	多個(房型+價格計劃)增量庫存價格,此接口适用于增量更新多個房價和房價緯度的庫存資訊,即傳哪天的價格庫存就更新那天
taobao.xhotel.rate.add	單個(房型+價格計劃)庫存價格新增更新接口,新增online_booking_binding_info參數,可以進行線上預約關聯關系新增

• rate接口中的庫存,價格,開關都是獨立更新的,更新庫存為0或者關房,不必一定要更新價格,如果必須要預設價格,需要賣價預設price=-1
• 特别說明,若商家不用room接口,使用rate接口同時推送庫存和價格,即第四步推送庫存和第五步推送價格就一起實作了. 雖然月曆庫存為0,月曆官方,都實作了當天不可售,建議推送能反映實際場景(即庫存為0是酒店設定的0,月曆關房是酒店設定的月曆關房),友善賣家管理可售情況