コンテンツにスキップ

ZACとの連携設定を行う

ZACとの連携設定の方法についてご案内します。2024.3.19現在、ハヤサブではZACと連携して利用することが前提となっております。ZACとの連携を行うことで、マスタ情報をハヤサブに取り込んだり、契約データを元にZAC上に案件及び売上項目や、請求データをZAC上に自動で作成することができます

  1. サイドバーの「設定」から「ZAC連携」を開く

    サイドバー下部の「設定」をクリックし、設定画面上部のタブから「ZAC連携」を選択します。

    設定画面の上部タブから「ZAC連携」へ移動する様子

  2. 「ZAC連携を有効にする」にチェックを入れる

    「連携設定」セクションの「ZAC連携を有効にする」チェックボックスをオンにします。

    「ZAC連携を有効にする」チェックボックス

  3. 「連携設定」ダイアログで連携情報を入力する

    表示される「連携設定」ダイアログに、ベースURL(必須)・環境名(必須)・顧客ドメイン・Client Id(必須)・Client Secret(必須)を入力します。各項目の値については下記「3️⃣項目」を参照してください。

    連携設定ダイアログ。ベースURL・環境名・顧客ドメイン・Client Id・Client Secret の入力欄がある

  4. 「認証を開始」をクリックする

    入力内容を確認し、ダイアログ右下の「認証を開始」をクリックします。ZACの認証画面に遷移します。

    連携設定ダイアログ右下の「認証を開始」ボタン

  5. ZACにログインして「許可する」をクリックする

    ZACのログイン画面でログイン後、ハヤサブに必要な権限の許可を求める画面が表示されます。内容を確認し「許可する」をクリックします。

    ZACの権限許可画面。「許可する」ボタンがある

  6. 連携が完了したことを確認する

    ハヤサブの設定画面に戻り、「ZACと接続されています」と表示されていれば連携は完了です。あわせて「再認証する」「接続を解除する」ボタンと、各種同期メニューが表示されます。

    「ZACと接続されています」と表示された連携設定セクション

https://secure.zac.ai

ZACの環境名(oro など)

ZACの顧客ドメイン(oro.zac.ai なら oro )

e44f43c6-8280-45f7-8a87-e4d0f13f414b

ZACのAPIアプリケーションマスタで登録したパスワード

4️⃣ZACのAPIアプリケーションマスタの設定

Section titled “4️⃣ZACのAPIアプリケーションマスタの設定”

ZACのAPIアプリケーションマスタには以下の設定を行ってください

任意

任意(例: ハヤサブ)

e44f43c6-8280-45f7-8a87-e4d0f13f414b

任意

Authorization code flow

https://app.hayasub.com/oauth/authorized

◽アクセストークンの有効期間(秒)*

Section titled “◽アクセストークンの有効期間(秒)*”

259200

◽IDトークンの有効期間(秒)*

Section titled “◽IDトークンの有効期間(秒)*”

1800

1800

◽リフレッシュトークンの有効期間(秒)*

Section titled “◽リフレッシュトークンの有効期間(秒)*”

38880000

使用可

※APIアプリケーションマスタの入力例

APIアプリケーションマスタの入力例

5️⃣ZACの連携用ユーザーに必要な権限について

Section titled “5️⃣ZACの連携用ユーザーに必要な権限について”

ハヤサブからZACのAPIを使って売上同期や請求同期が実行される際、ZAC連携に使用したZACユーザーの権限で実行がされます。ZACユーザーには以下の権限をつけるようにしてください

  • すべての操作の権限
  • すべての操作の社外接続権限

また、API連携に使用するユーザーは、ハヤサブ連携専用のユーザーをZACに作成し、それを使用することを推奨いたします。※apiuserなどのユーザーを使うと、別システムとの連携でも使われている、権限制御やパスワード管理が適切に実施できなくなる恐れがあるため