7.1.4.2. Racco宿泊実績データ取得¶
本項では、「Racco」から宿泊実績データを取得/登録する方法を説明します。
7.1.4.2.1. 概要¶
Racco宿泊実績データ取得は、指定されたRacco契約マスタの情報に基づき「Racco」に接続し、宿泊実績データを取得します。Racco契約マスタの「実績CSV取得URL」を使用して「Racco」と通信します。ジョブ実行日時点で有効なユーザが楽天会員マッピングマスタに登録されていない場合、Racco契約マスタの「担当者所属会社」、「担当者」を利用会社、利用者に設定します。Racco宿泊実績データ取得後、Racco宿泊実績データ登録ジョブを実行して取得したデータを登録します。登録したデータはBTMサービス利用実績データメンテナンスで参照可能です。コラム
実績取得モードを「corp-daily」に設定し、データ取得開始日・データ取得終了日のパラメータを未指定にして毎日実行すると、前日に連携された宿泊実績を日々取得できます。また、毎月特定の日にRaccoから月次の宿泊実績が出力されます。日次と月次の実績に差分が発生する可能性があり、月次のデータが最新となるため、日次と月次両方のデータの取得が必要です。コラム
宿泊予約を変更並びにキャンセルした場合、日次のデータを取り込み後、月次のデータを取り込む際に変更が反映される場合があり、変更前のデータが精算済になってから変更後のデータを取り込むと、金額がマイナスのデータが発生する場合があります。金額がマイナスのデータを精算することはできませんので、ご注意ください。
7.1.4.2.2. ジョブネットの設定¶
ジョブネットの設定を行います。
「サイトマップ」→「テナント管理」→「ジョブネット設定」をクリックします。 ジョブネット一覧(画面左部)の「Racco宿泊実績データ取得」をクリックします。 「編集」をクリックします。 必要に応じて「実行パラメータ」、「トリガ設定」を編集します。コラム
設定が必要な実行パラメータの詳細は、実行パラメータを参照してください。トリガ設定の設定方法は『テナント管理者操作ガイド』を参照してください。コラム
複数の「実行パラメータ」、「トリガ設定」を行う場合はジョブネットを複数作成してください。ジョブネットの作成方法は『テナント管理者操作ガイド』を参照してください。ジョブネット作成時には次のジョブを登録してください。
ジョブID ジョブ名(ジョブ選択時のツリー) kaiden-job-base-racco-external-lodge-data-import Kaiden! / Racco/ 外部 / Racco宿泊実績データ取得 kaiden-job-base-racco-external-lodge-data-entry Kaiden! / Racco/ 外部 / Racco宿泊実績データ登録 編集後、「更新」をクリックします。 確認ポップアップの「決定」をクリックします。 ジョブネットが設定されました。コラム
ジョブネットの設定(実行)後、BTMサービス利用実績データメンテナンスでデータ取得が正しく実行されたことを確認してください。
7.1.4.2.2.1. 実行パラメータ¶
設定が可能な実行パラメータは次の通りです。各実行パラメータに記載がない場合、「Racco宿泊実績データ取得」、「Racco宿泊実績データ登録」両方のジョブで使用されます。
名称 キー 説明/設定値 エラースキップ error_skip 会社別処理でエラー発生時の後続処理をスキップするか設定します。(省略時:false) ロック待ち時間 lock_wait ロックの待ち時間を設定します。(省略時:10秒) コンダクター conductor ジョブの各処理間で実行されるコンダクターを設定します。カンマ区切りで複数指定できます。AbstractGenericJobConductorを継承したクラスのコンポーネント名を指定してください。(省略時:コンダクターを使用しません。) 契約システムID contract_system_id 宿泊実績取得元のRacco契約マスタで設定した「契約システムID」を設定します。(省略時:登録済みの全契約を対象とします。) 会社コード company_cd 宿泊実績取得元のRacco契約・会社マッピングマスタで設定した「会社コード」を設定します。(省略時:契約システムIDに紐づく全会社を対象とします。) 実績取得モード import_mode 「Racco宿泊実績データ取得」で取得する実績の取得モードを設定します。設定は必須です。
corp-daily : 日ごとに出力されたデータを取得します。 corp-monthly : 月ごとに出力されたデータを取得します。 データ取得開始日 import_date_from 「Racco宿泊実績データ取得」で取得するデータの開始日(yyyy/MM/dd)を設定します。設定した場合、「データ取得開始日」から「データ取得終了日」の期間内に「Racco」から連携されたデータを取得します。実績取得モードが「corp-daily」の場合使用します。(省略時:ジョブ実行日の前日) データ取得終了日 import_date_to 「Racco宿泊実績データ取得」で取得するデータの開始日(yyyy/MM/dd)を設定します。設定した場合、「データ取得開始日」から「データ取得終了日」の期間内に「Racco」から連携されたデータを取得します。実績取得モードが「corp-daily」の場合使用します。(省略時:ジョブ実行日の前日) データ取得月 import_date_month 「Racco宿泊実績データ取得」で取得するデータの月(yyyyMM)を設定します。実績取得モードが「corp-monthly」の場合使用します。(省略時:ジョブ実行日の前月)
7.1.4.2.3. 取得データ¶
取得データ取得データが登録される形式です。「k10t_btm_use_data」に登録されます。
項目名 値 備考 relation_service_id RAKUTEN(固定値) result_id 予約番号 company_cd 会社コード IM-共通マスタ(会社) user_cd 宿泊者ユーザID IM-共通マスタ(ユーザ) relation_no Options 1 予約の連携番号 contract_system_id 契約システムID corporate_cd 企業コード relation_auth_user_id 宿泊者ユーザID relation_exe_user_id 予約者ユーザID date1 チェックイン日 date2 チェックアウト日 date3 予約日 date4 キャンセル日 summary1 宿泊先名称 summary2 宿泊先住所 summary3 宿泊先電話番号 summary4 客室タイプ名称 summary5 プラン名 amount1 宿泊金額+キャンセル・不泊料金 精算に使用する金額 amount2 宿泊金額 amount3 キャンセル・不泊料金 status1 ステータス quantity1 泊数 quantity2 宿泊人数 note1 備考1 予約時に入力した値 note2 備考2 予約時に入力した値 note3 備考3 予約時に入力した値