# はじめに

# ◆ 本書の目的

本書は、X-point とクラウドサインを連携利用する為に必要なシステムの設定ついて説明しています。
本書をよくお読み頂いた上で設定作業を行ってください。

# ◆ 対象とする読者

本書は「X-point」のシステム管理者を対象としています。システム管理者とは「X-point」を運用するにあたり必要な設定
および基本データの作成、維持管理を行う本システムの管理権限を持つユーザを指します。

# ◆ 対応バージョン（2026/8/7 時点）

# ◆ 商標について

本書の一部、または全部を著作権所有者の許諾なしに、商用目的の為に複製、配布することはできません。
X-point、エクスポイントの名称及びロゴは株式会社エイトレッドの商標または登録商標です。
その他、本書に記載されている会社名、製品名およびサービス名は、各社の商標または登録商標です。
最新の他社商標に関する権利表記につきましては、下記Webサイトをご確認ください。
商標について
本書では、©、®、(TM)の表示を省略しています。ご了承ください。

製作著作
©2026 株式会社エイトレッド

# 目次/索引

• はじめに
  • ◆ 本書の目的
  • ◆ 対象とする読者
  • ◆ 対応バージョン（2026/8/7 時点）
  • ◆ 商標について
• 1 電子サイン連携システム全体概要
• 2 電子サイン連携設定
  • 2.1 前提条件
  • 2.2 設定の流れ
    • 2.2.1 フォーム設定
    • 2.2.2 X-point 側の設定
• 3 利用
• 4 補足
  • 4.1 エラー時の対応
  • 4.2 連携時に送付されるメールの種類及び関連パラメータの設定
  • 4.3 サンプル帳票内設定パラメータ一覧

# 1 電子サイン連携システム全体概要

▼ 用語説明

本書は、X-point 運用環境において「電子サイン連携（以下、本システム）」に関する設定について記載したものとなります。
本書は、X-point を構築、運用、管理される方を対象として作成しており、X-point の一般的な利用方法等についての記載は省略しております。

本システムは X-point を用いて、X-point で書類の状態が承認完了となるなど条件を満たした際に、
そのフォーム入力した内容及び添付される PDF ファイル（契約書を前提としています）を電子サインへ連携するものとなります。
この為、X-point が正しくインストール設定され、電子サインの利用契約がされた状態でのみ本システムは稼働致します。
※各電子サインのご契約は利用者様自身で行う必要があります。

【本システムの範囲】

また、本システム構成は X-point からの受付を行う機能、電子サインへ連携を行う機能、
電子サインへの連携設定や認証に必要な情報が納められているデータベース、
データベースへの設定情報を記録させる設定機能、
電子サインからのワークフロー操作を受け付ける機能、
X-point へのワークフロー操作を実施する機能が内在しております。

電子サインへの連携設定に関する詳細については、「電子サイン連携設定ガイド」マニュアルをご参照下さい。

# 2 電子サイン連携設定

# 2.1 前提条件

1. 動作環境 電子サイン側「クラウドサイン」のライセンスが必要となります。
   ※2025 年 9 月現在
   ご利用の場合には、以下のライセンスが対象となります。

   - クラウドサイン連携
   

   また、本システム利用申込時に株式会社エイトレッド（以下、弊社）より配布致しました
   アクセス URL 等の情報についても設定にて必要となります。
   電子サイン連携設定の設定詳細は、別途「電子サイン連携設定ガイド」をご参照ください。

2. ブラウザ環境 X-point の環境がサポートするブラウザを使用してください。

3. フォーム種別 本機能は、フォーム種別が「ワークフロー」のみ対応しております。
   （フォーム種別が「通常」となっているものは非対応となります）

4. クラウドサイン

   • 契約プラン
     「Corporate」「Business」「Enterprise」のいずれかのプランでの契約が必要となります。
   • クラウドサイン連携サービス内での署名者設定
     クラウドサインサービスにおけるクライアント ID の所有者アカウントの名前とメールアドレスが必要となります。
   • クラウドサイン側で IP アドレス制限機能を利用している場合 以下の IP アドレスを許可するように設定ください。

     54.65.255.46 54.65.148.3

5. その他
   ＜ eFormMaker ＞
   本マニュアル記載のフォーム関連の作業には以下のライセンスが必要となります。

   • eFormMaker（フォーム作成ソフト）

   ＜セキュリティ基本サービス＞
   本サービスのネットワーク接続は HTTPS が前提となるため以下のオプションが必要となります。

   • セキュリティ基本サービス

# 2.2 設定の流れ

本システムの利用は以下の手順で設定することを想定しています。

【電子サイン利用契約】
クラウドサインに関する利用契約が必要となります。
契約はお客様ご自身で実施頂く必要があります。

【本システム設定】
本システム設定については、「電子サイン連携設定ガイド」マニュアルをご参照下さい。
設定に当たり、電子サインの利用申込を行った際に受領した設定情報が必要となります。

【フォーム作成】
本システムは X-point を用いて、X-point で書類の状態が承認完了となるなど条件を満たした際に、
そのフォームに添付される PDF ファイル（契約書を前提としています）を電子サインへ連携するものとなります。
この為、専用のフォームが必要となります。

フォームデータのサンプルはお渡し致しますが、御社に合わせて回付設定等の付帯設定が必要となります。
これらのフォーム設定については、4.その他、及び「eFormMaker フォーム作成ガイド」をご参照ください。

【フォーム設定】
フォーム設定の内、本システムに関与する部分についてのみ説明致します。
本システム以外の設定については、「管理者機能マニュアル」をご参照下さい。

# 2.2.1 フォーム設定

本システムでは、電子サイン種別（クラウドサイン）毎に連携するフォームを作成する仕様となります。

クラウドサイン連携用フォームについては、本システムご利用契約時にサンプルとして、サポートサイトにて配布致します。
以降はそれらのフォームが設定されている前提での説明となります。
サンプルフォーム内の項目は「4.3.サンプル帳票内設定パラメータ一覧」をご参照ください。

※サンプルフォームには JavaScript が設定されていますが、サンプルフォームをご利用される場合は必須となります。

# 2.2.2 X-point 側の設定

本システムに必要なフォーム設定は以下の通りとなります。

1. メール設定
   X-point で電子サイン連携用のフォームを送信する際に、申請者のメールアドレスが必要となります。
   X-point 管理者サイトからユーザ管理画面を開き、対象となる申請者のメールアドレスを設定してください。
   不明な場合は「管理者機能マニュアル」をご参照ください

2. Webhook 設定
   管理者サイトログイン後のトップページ左側にあるメニューから、「フォーム」を選択します。

   

   「フォーム一覧」が表示されますので、該当フォームの右側にある「他操作」をクリックします。
   「他操作」が展開され、実施出来る操作メニューが表示されますので、その中から「Webhook 設定」を選択してください。
   （ここではサンプルとして「【クラウドサイン】押印申請書」を選択しております。）

   

   Webhook 設定画面にて Webhook 設定を行います。
   「送信先 URL」については本システムご契約時に弊社より割り当てられた URL、
   及び必要なパラメータを以下のような形式で指定してください。

   https://vykxwumra4edivjt4y5xsrm56y0jvdth.lambda-url.ap-northeast-1.on.aws/?license_no={ライセンス番号}&access_key={アクセスキー}&sign_operator={連携先}

   ※フォーム内の入力値も必要となるため、「テスト送信」を実行してもエラーとなります。

   ▼ Webhook 設定画面

   

   【ご参考】

   弊社より割り当てられた URL 及びその他必要なパラメータは以下の通りとなります。

   （例）

   https://vykxwumra4edivjt4y5xsrm56y0jvdth.lambda‑url.ap‑northeast‑1.on.aws/?license_no=licenseXP&access_key=accessKeyA&sign_operator=CS

   URL 部	パラメータコード	記載内容	登録される値	例
   URL 部		連携用 URL	https://vykxwumra4edivjt4y5xsrm56y0jvdth.lambda-url.ap-northeast-1.on.aws/
   パラメータ ①	license_no	ライセンス番号	ATLED 社より提供されたものを記載	licenseXP
   パラメータ ②	access_key	アクセスキー	電子サイン連携設定で設定した値を記載	accessKeyA
   パラメータ ③	sign_operator	連携先	連携先コードを記載 CS(クラウドサイン)	CS

   【X-point のラインセンス番号の確認方法】
   X-point 管理サイトを開き、システム → システム情報 →X-point 情報内でライセンス番号を確認することができます。

   ▼ ライセンス番号確認画面

   

3. フォームに対する閲覧権限
   電子サイン連携用フォームに入力した情報を取得するには、電子サイン連携設定の XP の設定で指定したユーザが
   該当書類を閲覧可能な状態にする必要があります。
   詳細は「管理者機能マニュアル」をご参照下さい。

   管理者サイトログイン後のトップページ左側にあるメニューから、「フォーム」を選択します。

   

   「フォーム一覧」が表示されますので、該当フォームの右側にある「他操作」をクリックします。
   「他操作」が展開され、実施出来る操作メニューが表示されますので、その中から「Webhook 設定」を選択してください。
   （ここではサンプルとして「【クラウドサイン】押印申請書」からの画面を選択しております。）

   

   

   電子サイン連携設定で指定した管理者ユーザに、以下のいずれかの方法で権限を与えてください。

   
   ※電子サイン連携設定画面の X-point の設定で指定したユーザがフォームに対する閲覧権限を持っていない場合は、本システムで電子サイン連携を実施することができませんので、必ず設定してください。

   1. フォームに対する閲覧権限を付与する場合
      アクセス権限画面にて、承認状況が【承認完了】のフォームに対する閲覧権限で、
      「全ユーザに権限を与える（※）」または「指定したユーザに権限を与える」を選択してください。
      「指定したユーザに権限を与える」を選択した場合は、電子サイン連携設定画面にある X-point の設定で指定したユーザを指定してください。

      電子サイン連携設定により、電子契約連携タイミングを特定の承認ステップに設置している場合は、
      承認状況が【承認中】のフォームに対する閲覧権限も同様に付与してください。
      ※電子サイン連携設定については別紙『電子サイン連携 設定ガイド』をご確認ください。

      ※「全ユーザに権限を与える」を選択した場合は全ユーザに対して、 該当するフォームの閲覧権限を与えてしまうため、「指定したユーザに権限を与える」を推奨しております。

      画像はサンプルとして、「指定したユーザに権限を与える」を選択しております。
      「指定したユーザに権限を与える」場合は、電子サイン連携設定で設定したユーザを追加してください。

      

      

   2. 書類に対する閲覧権限を付与する場合
      電子サイン連携設定で指定したユーザを必ずワークフロー関係者に含むようにしてください。

# 3 利用

本章では、本システムの利用例を記載致します。

X-point 内で電子サイン連携用フォーム申請
説明ではサンプルとして、「【クラウドサイン連携】押印申請書（複数行版）」を選択しております。

提出　 → 　汎用申請書関連　 → 　電子サイン連携用のフォームを選択

ポップアップウィンドウに表示された各フォームに必要事項を入力し、「添付」に契約書となる PDF で生成されているファイルを添付処理し、申請（回付を開始）致します。
※連携のため添付する PDF は複数添付が可能です。
※埋め込み情報が反映される PDF は添付した順で最初のものが対象になります。
※クラウドサイン側で添付したファイルを X-point 側へ連携することはできません。
※X-point 側で添付したファイルのうち、クラウドサイン側へ連携されるのは PDF ファイルのみです。
　・添付された PDF が連携の対象となり、契約書として扱われます。
　・Word やパワーポイントなどの PDF 以外のファイルは連携の対象になりません。
　・PDF が 1 件も添付されていない書類は、連携時にエラーとなります。
　・PDF が添付されていれば、その他のファイルが添付されていてもエラーにはなりません。

※クラウドサイン側の仕様で署名できない PDF を添付した場合エラーとなるため、添付の際は PDF の設定をご確認ください。
署名できない PDF は以下のいずれかの設定がされている PDF になります。

• PDF の設定で署名を禁止している
• PDF の暗号化処理をしている
• PDF にパスワードがかかっている

回付完了したタイミングで、2 章にて設定した Webhook 処理が実行されクラウドサインへ連携が開始されます。

以下はサンプルフォームの画像です。
サンプルフォームの印影には、「確認」と「決裁」という印影コンポーネントが X-point に登録されている前提となっています。

※短縮コードの入力欄はサンプルフォーム上では非表示設定になっていますが、説明のため表示設定にしています。

必須項目及び、電子サイン側に反映される項目を以下の表に記述します。

必須項目が入力されていない場合は申請が不可能です。必須項目を入力してから申請を行ってください。

※各項目の詳細については、補足 4.3.「サンプル帳票内設定パラメータ一覧」をご参照ください

連携が終了すると、上記「締結先情報：担当者メールアドレス」宛に記載したメールアドレスに、
クラウドサインから「確認依頼メール」が送付されます。

※「確認依頼メール」が送付された段階で、クラウドサインのページにログインし、
連携完了した書類の情報を確認することが可能です。クラウドサインのページに関する操作は、クラウドサインのマニュアルを参照してください。
「書類を確認する」をクリックするとクラウドサイン内該当書類画面を開くことが出来ますので、順次確認を実施してください。（確認方法については、別途クラウドサイン側の画面仕様をご参照ください。）

※上記メールの From には電子サイン連携設定で指定したクライアント ID に紐づいた名前や会社名が反映されます。
詳細はクラウドサインのマニュアルをご参照下さい。

全ての確認が終了すると、申請者宛に「締結完了メール」が届きます。
また、「共有先情報」を入力していると、締結完了の共有メールが共有先宛に送信されます。

※クラウドサイン側で該当書類を確認したときのイメージ

※連携書類の申請者は共有先と同じ扱いでクラウドサイン上の書類関係者に含まれます。

埋め込み情報を設定することで、連携時に添付した PDF にテキストボックスなどを設置することができます。

連携フォームから設定した埋め込み情報は以下のように PDF に反映されます。

設定値の詳細は「4.3 サンプル帳票内設定パラメータ一覧」を参照ください。

※サンプルフォーム内「埋め込み確認ボタン」から埋め込み情報が PDF のどこに配置されるかの大まかな位置が確認可能です。

# 4 補足

# 4.1 エラー時の対応

書類に PDF を添付しなかった、クラウドサイン側で対応できない PDF を添付した、
書類の入力内容に不備があったなどの場合は電子サイン連携が失敗し、原因に応じたエラーメールが送信されます。

各エラーに対する対応例を以下に記載します。
以下エラーの対応は、電子サイン連携設定済みである場合の対応方法です。

また、電子サイン連携が開始された段階で X-point の書類は更新されております。
エラーメールの原因を取り除いたうえで、必要であれば書類を再提出するなどご対応ください。

※電子サイン連携設定を行っていない場合は、設定を行ってください。
詳細は、「電子サイン連携設定ガイド」をご参照下さい。

(1) エラーメールに対する対応

1. XP の設定でエラーが発生した場合

   • 認証エラー accessKey の値を確認してください

     • Webhook で設定した accessKey が電子サイン連携設定画面で設定した値を同じか確認してください。

   • ドキュメント情報取得に失敗しました:null

     • 該当書類に対して、電子サイン連携設定画面の XP の設定で指定したユーザが権限を持っているか確認してください。

2. 電子サイン連携用フォームでエラーが発生した場合
   電子サイン連携用フォーム内の必須項目が設定、または入力されていない場合は、エラーメール内の[連携失敗の詳細]に以下のような文章が記載されます。

   (例1)
   エラーID:0405 - フィールド名 apply_email は必須項目です。
   
   (例2)
   エラーID:0404 - フィールド SIGNER_EMAIL_N が存在しません。
   

   • 上記のような内容の場合は対象のフィールド ID が存在することを確認してください。
     必要なフィールド ID は「4.3.サンプル帳票内設定パラメータ一覧」をご参照下さい。

   • 対象のフィールドに必要な値が入力されていることを確認してください。
     必須項目は「4.3.サンプル帳票内設定パラメータ一覧」をご参照下さい。

3. クラウドサイン側の API 仕様でエラーとなる場合

   • 文書情報登録に失敗しました。

     ```json
     sc.app.cloudsign.xp.exception.CloudSignApiException:\response body:{\"error\":\"bad_request\",\"message\":\"duplicate email in participants\"}
     ```
     

     • フォーム内の申請ユーザのメールアドレスと締結先メールアドレスまたは、共有先メールアドレスを確認してください。申請者と締結先のメールアドレスまたは共有先メールアドレスが同じ場合、連携に失敗します。

(2) その他のエラー対応

• X-point からの Webhook が送信されない

  • 対象のフォームに Webhook 設定がされているか確認してください。

  • Webhook 設定で指定した licenseNo が正しいか確認してください。

• クラウドサインからの確認依頼メールが誤った相手先に送信されてしまう

  • フォーム内の締結先のメールアドレスを確認してください。

# 4.2 連携時に送付されるメールの種類及び関連パラメータの設定

# 4.3 サンプル帳票内設定パラメータ一覧

以下の項目削除（一部除く）、または ID 変更は行わないでください。

※「options_content_{num}」と「options_order_{num}」は、それぞれ対応する組み合わせを指定する必要があります。
対応する組み合わせが入力されない場合は、ユーザ定義項目に反映されません。

# ■ 改訂履歴