開発者センター

統合ガイド

1. 統合説明

1.1 統合プロセス

統合プロセスは以下の図に示すとおりです。

集成流程.svg

1.1.1 eSignGlobalアカウントの登録

開発者はeSignGlobalの公式サイトにアクセスしてアカウントを登録する必要があります。

OpenAPI連携アドレス:

1.1.2 アプリケーションの作成

eSignGlobalにログインすると、管理者は「設定」-「統合」-「アプリケーション」メニューでアプリケーションを追加し、アプリケーション編集ページでキーを取得し、コールバックアドレスを設定できます。

1.1.3 ビジネスプロセスの定義

開発者は、このドキュメントを読んだ後、既存のビジネスプロセスを整理し、ビジネスで契約ノードが発生したときに対応するインターフェースにアクセスすることで、既存のビジネスプロセスに電子署名機能を実装できます。

1.1.4 インターフェース統合

このステップで正式にドッキング作業を開始します。ドッキング中に問題が発生した場合は、eSignGlobalチームに連絡して解決を支援してもらえます。

1.1.5 ビジネステスト

インターフェース機能のドッキングが完了したら、必要に応じて数回のビジネステストを実施します。テスト中に問題が発生した場合は、eSignGlobalチームに連絡して解決を支援してもらえます。

1.1.6 プロジェクトの立ち上げ

開発者は、次の操作を完了すると、プロジェクトを立ち上げることができます。

  • インターフェースアクセス環境の切り替え:サンドボックス環境➡ 本番環境
  • アプリケーション情報の切り替え:サンドボックスapp_id、app_secret ➡ 本番 app_id、app_secret

2. プロセス例

以下に、いくつかの典型的なアプリケーションシナリオのインターフェース呼び出しプロセスを示します。具体的な呼び出し方法は、お客様のビジネス設計によって異なります。

図中の番号の内容は、標準的な電子署名ビジネス操作プロセスであり、灰色のボックスはeSginGlobalが提供するAPIサービスです。

2.1 インターフェース呼び出しフロー(クラシックシナリオ)——ステップごとの開始

分步发起流程.svg

2.2 インターフェース呼び出しフロー(クラシックシナリオ)——クイック開始

一步发起.svg

3. まとめ

電子署名ビジネスプロセスは、初期化、エンベロープの作成と開始、署名の3つの段階に分かれています。

主要なプロセスノードの説明は次のとおりです。

  1. 署名の重要な情報を抽出:eSignGlobalを介して電子署名を開始する場合、ドッキングプラットフォームは、署名者の情報、署名するドキュメントなどのコンテンツを最小限提供するだけで、契約署名を開始できます。これらの情報のソースは通常、以前のビジネスプロセスで収集され、ビジネスシステムに保存されています。
  2. エンベロープの作成:eSignGlobalは、信頼性の高いグローバル電子署名サービスを構築することを目的としているため、署名するドキュメントの署名アクション(署名タスクとも呼ばれます)はすべてエンベロープを介して表されます。ドッキングプラットフォームは、署名プロセスを作成するときに、件名やメモなどの関連機能をカスタマイズして構成できます。
  3. 署名するドキュメントの生成:現在、eSignGlobalはPDF形式の署名するドキュメントのみをサポートしています。ドッキングプラットフォームは、署名ドキュメントを事前に準備し、「ファイルアップロード関連インターフェース」を介して署名プロセスに追加する必要があります。
  4. 署名者の追加:ドッキングプラットフォームは、このステップでエンベロープに署名者を追加し、署名者のユーザーエクスペリエンス(署名順序、署名位置、アクセスパスワードが必要かどうかなど)を構成できます。
  5. エンベロープの開始:つまり、署名者がドキュメントへの署名を開始できるようにします。エンベロープが開いた後、署名するドキュメントの追加と変更はサポートされていません。同時に、事前に設定された署名順序に従って自動的に流れ始め、eSignGlobalから署名通知が送信されます。
  6. エンベロープの終了:つまり、すべての署名者が署名を完了した後、連携プラットフォームが手動でエンベロープを閉じます。(今後、eSignGlobalはプロセスが閉じられる前に署名者を追加することをサポートする予定です。)
  7. 署名済みファイルのダウンロード:つまり、すべての署名者が署名を完了した後のファイルをダウンロードします。エンベロープの終了後にのみ呼び出すことができます。

1. 統合説明
1.1 統合プロセス
1.1.1 eSignGlobalアカウントの登録
1.1.2 アプリケーションの作成
1.1.3 ビジネスプロセスの定義
1.1.4 インターフェース統合
1.1.5 ビジネステスト
1.1.6 プロジェクトの立ち上げ
2. プロセス例
2.1 インターフェース呼び出しフロー(クラシックシナリオ)——ステップごとの開始
2.2 インターフェース呼び出しフロー(クラシックシナリオ)——クイック開始
3. まとめ