DocuSign API: サーバーサイドドキュメントを使用した複合テンプレートの作成

DocuSign API を活用した効率的なドキュメントワークフロー

デジタルプロトコルが進化し続ける中で、DocuSign の API は、電子署名を自動化するために開発者や企業向けに設計された強力なツールとして際立っています。特に複合テンプレートは、再利用可能なドキュメント構造を可能にし、反復的な署名プロセスを簡素化します。このアプローチは、一貫性と効率が運営コストを大幅に削減できる、大量の契約を処理する企業にとって特に価値があります。サーバーサイドのドキュメントを活用することで、チームはクライアント側のアップロードに頼ることなく、テンプレートを事前に入力およびカスタマイズできるため、セキュリティと制御が向上します。

DocuSignまたはAdobe Signを使用した電子署名プラットフォームを比較していますか？

eSignGlobalは、グローバルコンプライアンス、透明性のある価格設定、およびより迅速なオンボーディングプロセスを備えた、より柔軟で費用対効果の高い電子署名ソリューションを提供します。

👉 無料トライアルを開始

DocuSign API の複合テンプレートの解明

DocuSign API の複合テンプレートは、複数のドキュメント、受信者、署名フィールドを単一の再利用可能なエンベロープに組み合わせるための強力な機能です。基本的なテンプレートとは異なり、複合テンプレートでは、サーバーでホストされているドキュメントを動的な要素と組み合わせることができ、ドキュメントをプログラムで組み立てる必要のある HR のオンボーディングや販売契約などのシナリオに最適です。このサーバーサイドのアプローチにより、ドキュメントは API 呼び出しを通じて安全に保存およびアクセスされ、ユーザーのアップロードに関連する露出リスクを最小限に抑えます。

ビジネスの観点から見ると、複合テンプレートを採用することで、手動による介入を減らすことでワークフローを最適化できます。たとえば、金融サービス会社は、ローン申請と開示フォームをバンドルし、CRM システムから受信者データを事前に入力するために使用できます。API の柔軟性はスケーラビリティをサポートしますが、コンプライアンスの落とし穴を回避するために、認証、エンベロープの作成、およびエラー処理に関する慎重な計画が必要です。

ステップバイステップガイド：サーバーサイドドキュメントを使用した複合テンプレートの作成

DocuSign の API とサーバーでホストされているドキュメントを使用して複合テンプレートを作成するには、開発者は通常、eSignature REST API（バージョン 2.1 以降）と対話します。このプロセスには、OAuth 2.0 による認証、テンプレートの定義、およびエンベロープのアセンブリが含まれます。以下に、主要な手順の概要を示し、公式の DocuSign ドキュメントと企業の実装におけるベストプラクティスを参照します。

ステップ 1：認証と API アクセスの設定

まず、DocuSign 開発者センターから API 資格情報を取得します。JWT Grant または Authorization Code Grant を使用して、安全なトークンを取得します。サーバーサイドの操作では、自動化された非対話型の認証が可能になるため、JWT が推奨されます。HTTP リクエストを簡素化するために、DocuSign SDK（Node.js、Python、Java など用）をインストールします。

DocuSign SDK を使用した Node.js の例：

const dsApi = require('docusign-esign');
const apiClient = new dsApi.ApiClient();
apiClient.setBasePath('https://demo.docusign.net/restapi'); // 本番環境では本番 URL を使用
const accessToken = await getJwtToken(); // あなたの JWT 関数
apiClient.addDefaultHeader('Authorization', `Bearer ${accessToken}`);
const envelopesApi = new dsApi.EnvelopesApi(apiClient);

この基本的な設定により、後続のすべての呼び出しが認証されることが保証されます。これは、ビジネス環境でデータの整合性を維持するための重要なステップです。

ステップ 2：サーバーサイドドキュメントのアップロードと参照

サーバーサイドドキュメントは、DocuSign の一時ストレージにアップロードされるか、URL/バイトストリームを介して直接参照されます。複合テンプレートの場合、エンベロープ定義で compositeTemplates 配列を使用します。まず、uploadDocument メソッドを使用してドキュメントをアップロードするか、base64 エンコードされたバイトとして提供します。

重要な考慮事項：ドキュメントはサポートされている形式（PDF、DOCX）である必要があります。セキュリティを確保するために、機密ファイルを公開しないでください。DocuSign のドキュメントアップロード API を使用して転送を処理します。

ドキュメントをアップロードするためのリクエストボディの例：

{
  "fileName": "Agreement.pdf",
  "documentBase64": "JVBERi0xLjQK..." // サーバーファイルの Base64 エンコード
}

アップロード後、複合テンプレートで参照するために documentId（たとえば、「1」）を割り当てます。

ステップ 3：複合テンプレート構造の定義

複合テンプレートは、インラインドキュメント（サーバーサイド）を既存のテンプレートと組み合わせます。EnvelopeDefinition の compositeTemplates プロパティの下にその構造を構築します。

基本的な要素：

• ServerTemplate：ID を介して既存の DocuSign テンプレートを参照し、署名タブなどの再利用可能なコンポーネントに使用します。
• InlineTemplate：サーバーサイドドキュメントを埋め込み、受信者/タブを動的に定義します。
• Sequence：複合テンプレートを順序付けます（たとえば、サーバーのドキュメント 1、次にテンプレート 2）。

エンベロープ定義 JSON の例：

{
  "status": "sent",
  "compositeTemplates": [
    {
      "compositeTemplateId": "1",
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "your-template-guid",
          "sharedTemplateInstanceRoleName": "Sender"
        }
      ],
      "inlineTemplates": [
        {
          "sequence": "2",
          "recipients": {
            "signers": [
              {
                "email": "recipient@example.com",
                "name": "John Doe",
                "recipientId": "1",
                "tabs": {
                  "signHereTabs": [
                    {
                      "xPosition": "100",
                      "yPosition": "200",
                      "documentId": "1",
                      "pageNumber": "1"
                    }
                  ]
                }
              }
            ]
          },
          "documents": [
            {
              "documentId": "1",
              "name": "ServerDoc.pdf",
              "documentBase64": "JVBERi0xLjQK...", // あなたのサーバードキュメント
              "fileExtension": "pdf"
            }
          ]
        }
      ]
    }
  ]
}

これにより、サーバードキュメントがテンプレートとマージされ、タブの配置によって署名フィールドが配置されます。ビジネスオブザーバーは、正確なタブの配置（アンカーストリングまたは座標を使用）がプロフェッショナルな出力に不可欠であり、複数ページのドキュメントでのずれを防ぐと指摘しています。

ステップ 4：エンベロープの作成と送信

EnvelopesApi で createEnvelope メソッドを呼び出します。

const envelope = new dsApi.EnvelopeDefinition();
envelope.setCompositeTemplates([compositeTemplate]); // ステップ 3 から
const results = await envelopesApi.createEnvelope('accountId', { envelopeDefinition: envelope });
console.log('Envelope ID:', results.envelopeId);

webhook またはポーリングによってステータスを監視します。本番環境では、クォータ制限（たとえば、API プランは年間 600 ドルからで、月あたり 40 個のエンベロープをサポート）に対応するためにエラー処理を統合します。

ステップ 5：ベストプラクティスとトラブルシューティング

• セキュリティ：エンベロープの暗号化とロールベースのアクセス制御を使用します。サーバーサイドの処理は、米国の ESIGN Act などの標準に準拠しており、法的強制力を保証します。
• スケーラビリティ：大量に使用する場合は、一括送信をサポートする高度な API プラン（年間 5,760 ドル）を選択します。
• 一般的な問題：無効な base64 エンコード（サーバーファイルを確認）；テンプレート ID の不一致（GET /templates で確認）。
• テスト：コストを発生させることなく、DocuSign のサンドボックスを使用して反復処理を行います。

商業アプリケーションでは、この方法により署名サイクルが最大 70% 短縮されることが証明されています。業界レポートによると、API の複雑さには開発者のリソースが必要になる可能性があります。

DocuSign のより広範な製品スイートの探索

DocuSign は、コアの電子署名を超えて、インテリジェントアグリーメントマネジメント（IAM）や契約ライフサイクルマネジメント（CLM）などの統合ソリューションを提供しています。IAM は、AI を活用して契約の分析、リスク評価、自動化を行い、企業が契約から洞察を得るのを支援します。エンタープライズレベルの一部として、CLM は、起草から更新まで、条項ライブラリや交渉追跡などの機能を備えたエンドツーエンドの契約管理を提供します。これらのツールは通常、大規模な組織向けにカスタマイズされており、コンプライアンスと効率を向上させますが、価格が高く、公開価格はありません。通常、容量に基づいて交渉されます。

電子署名の価格は、個人版（月額 10 ドル、5 つのエンベロープ）から始まり、一括送信を含むビジネスプロフェッショナル版（ユーザーあたり月額 40 ドル）まで拡張されます。API アクセスには個別の開発者プランが必要であり、DocuSign のシートベースのモデルが強調されています。これにより、成長するチームのコストが上昇する可能性があります。

競争環境：中立的な比較

電子署名市場には強力なプレーヤーがおり、それぞれに独自の強みがあります。DocuSign はグローバルな採用率と API の深さでリードしており、Adobe Sign は PDF 統合に優れており、eSignGlobal はアジア太平洋地域（APAC）のコンプライアンスに焦点を当てており、HelloSign（現在は Dropbox Sign）は中小企業のシンプルさを優先しています。以下は、主要なビジネス要因に基づいた Markdown 比較表です。

この表は、トレードオフを強調しています。DocuSign の深さは複雑なワークフローに適していますが、代替案はコストまたは地域的な利点を提供します。

Adobe Sign は Adobe Document Cloud と統合されており、PDF を多用するユーザーにシームレスなエクスペリエンスを提供します。条件付きフィールドとモバイル署名をサポートしており、価格は DocuSign と同様ですが、Adobe の分析ツールを利用できます。ただし、その API は強力ですが、カスタム統合における学習曲線が DocuSign の SDK よりも急であると批判されることがよくあります。

eSignGlobal は、100 の主要国をカバーするコンプライアンスの代替案として位置付けられており、アジア太平洋地域（APAC）に特に強みがあります。APAC の電子署名環境は、断片化、高水準、および厳格な規制を特徴としており、米国（ESIGN Act）および EU（eIDAS）のよりフレームワークベースのアプローチとは対照的です。後者は、広範な法的承認を強調しています。APAC では、標準は「エコシステム統合」モデルに傾いており、企業に対する政府（G2B）のデジタルアイデンティティとの深いハードウェア/API レベルの統合が必要です。これは、西側の市場で一般的な電子メール検証や自己申告をはるかに超えています。eSignGlobal は、香港の iAM Smart やシンガポールの Singpass などのシステムとのシームレスな統合を通じてこれに対処し、多様な管轄区域での法的有効性を保証します。その価格は競合他社よりも控えめです。ベーシック版は年間約 16.6 ドル（年間契約）、最大 100 個の署名付きドキュメント、無制限のユーザーシート、およびアクセスコードによる検証を可能にしながら、コンプライアンスを維持します。これにより、地域的な俊敏性を優先するチームにとって非常に費用対効果が高くなります。

DocuSignよりもスマートな代替案をお探しですか？

eSignGlobalは、グローバルコンプライアンス、透明性のある価格設定、およびより迅速なオンボーディングプロセスを備えた、より柔軟で費用対効果の高い電子署名ソリューションを提供します。

👉 無料トライアルを開始

HelloSign（Dropbox Sign に名称変更）は、直感的なインターフェースと無料の基本プランで小規模な運営を引き付けています。テンプレートとリマインダーをサポートしていますが、DocuSign の高度な API 機能が不足しているため、集中的な自動化にはあまり適していません。

電子署名採用の地域的なニュアンス

米国の ESIGN Act と EU の eIDAS は、電子署名の基本的な合法性を提供していますが、APAC のエコシステムにはローカライズされた統合が必要です。国境を越えて運営する企業は、ツールのデータ所在地と遅延を評価する必要があります。ドキュメントの配信の遅延が取引の完了に影響を与える可能性があるためです。

要するに、DocuSign の API は複雑なテンプレート作成を可能にしますが、eSignGlobal などの地域コンプライアンスのニーズに対応する代替案を検討することで、競争の激しい市場でバランスの取れたオプションを提供できます。