intra-mart Accel Kaiden! 経費旅費 / 管理者操作ガイド 第27版 2024-04-01

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. ジョブネットの設定

ジョブネットの設定を行います。
  1. 「サイトマップ」→「テナント管理」→「ジョブネット設定」をクリックします。
  2. ジョブネット一覧(画面左部)の「Racco宿泊実績データ取得」をクリックします。
    ../../../../../_images/jobnet_0183.png
  3. 「編集」をクリックします。
    ../../../../../_images/jobnet_0283.png
  4. 必要に応じて「実行パラメータ」、「トリガ設定」を編集します。
    ../../../../../_images/jobnet_0383.png

    コラム

    設定が必要な実行パラメータの詳細は、実行パラメータを参照してください。
    トリガ設定の設定方法は『テナント管理者操作ガイド』を参照してください。

    コラム

    複数の「実行パラメータ」、「トリガ設定」を行う場合はジョブネットを複数作成してください。
    ジョブネットの作成方法は『テナント管理者操作ガイド』を参照してください。

    ジョブネット作成時には次のジョブを登録してください。
    ジョブID ジョブ名(ジョブ選択時のツリー)
    kaiden-job-base-racco-external-lodge-data-import Kaiden! / Racco/ 外部 / Racco宿泊実績データ取得
    kaiden-job-base-racco-external-lodge-data-entry Kaiden! / Racco/ 外部 / Racco宿泊実績データ登録
  5. 編集後、「更新」をクリックします。
    ../../../../../_images/jobnet_0483.png
  6. 確認ポップアップの「決定」をクリックします。
    ../../../../../_images/jobnet_0583.png
  7. ジョブネットが設定されました。
    ../../../../../_images/jobnet_0683.png

    コラム

    ジョブネットの設定(実行)後、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 予約時に入力した値