ZAC連携の設定をする
この記事について
ZACとの連携設定の方法についてご案内します。2026.1.1現在、PerlunaではZACと連携して利用することが前提となっております。ZACとの連携を行うことで、マスタ情報のPerlunaへの取込、契約データを元にZAC上に案件及び売上項目や、請求データをZAC上に自動で作成することができます
操作手順
連携設定項目
ベースURL*
環境名*
ZACの環境名(oro など)
ZACのテスト環境等とつなぐ場合、 hoge.zac.ai/hoge_test といったURLの場合は hoge_test を指定してください
顧客ドメイン
ZACの顧客ドメイン(hoge.zac.ai なら hoge )
顧客ドメインはZACマスタデータの識別子の一部として使われるため、ZACの本番、テスト環境と連携する際に必ず同一のものを指定する必要があります。通常顧客ドメインは本番、テスト環境で同一のため、顧客ドメインをそのまま指定してください
Client ID*
a4ff03d8-2a1b-4993-87a7-21c5c61accbe
Client Secret*
ZACのAPIアプリケーションマスタで登録したパスワード
ZACのAPIアプリケーションマスタの設定
ZACのAPIアプリケーションマスタには以下の設定を行ってください
コード*
任意
名称*
任意(例: Perluna)
アプリケーションID*
a4ff03d8-2a1b-4993-87a7-21c5c61accbe
新しいパスワード*
任意
認証フロー*
Authorization code flow
リダイレクトURI*
https://app.perluna.jp/oauth/authorized
ステージング環境の場合は https://staging.perluna.jp/oauth/authorized です
アクセストークンの有効期間（秒）*
3600
IDトークンの有効期間（秒）*
1800
AuthCodeの有効期間（秒）*
1800
リフレッシュトークンの有効期間（秒）*
38880000
使用可・不可*
使用可
ZACの連携用ユーザーに必要な権限について
PerlunaからZACのAPIを使ってZACマスタ同期、ZAC案件同期、ZAC合計請求書同期が実行される際、ZAC連携に使用したZACユーザーの権限で実行がされます。ZACユーザーには以下の権限をつけるようにしてください
- すべての操作の権限
- すべての操作の社外接続権限
Perlunaは社外接続経由でAPIを呼び出すため、社内接続権限も必ず付与するようにしてください
また、API連携に使用するユーザーは、Perluna連携専用のユーザーをZACに作成し、それを使用することを推奨いたします。※apiuserなどのユーザーを使うと、別システムとの連携でも使われている、権限制御やパスワード管理が適切に実施できなくなる恐れがあるため