DocuSign API：複合テンプレートを使用して複数のPDFを結合する方法

効率的なドキュメントワークフローのための DocuSign API ナビゲーション

今日のペースの速いデジタルビジネスの世界では、DocuSign のような電子署名プラットフォームは、契約管理を効率化し、事務処理を削減するための不可欠なツールとなっています。小規模なチームから大企業まで、これらのツールは安全でコンプライアンスに準拠した署名プロセスを可能にします。DocuSign API エコシステムにおける重要な機能の 1 つは、複合テンプレートです。これにより、開発者は複数の PDF を 1 つのエンベロープに結合して署名することができます。この機能は、多者間契約や自動化されたドキュメントアセンブリなど、複雑なワークフローを扱う企業にとって特に価値があります。この記事では、公式ドキュメントと実際のビジネスアプリケーションを参照しながら、DocuSign API で複合テンプレートを実装する方法を探ります。同時に、ビジネス環境におけるその実用性について中立的な視点を維持します。

電子署名プラットフォームを DocuSign または Adobe Sign と比較検討中ですか？

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

👉 無料トライアルを開始

DocuSign API の複合テンプレートを活用した PDF 結合

複合テンプレートとは？

DocuSign eSignature API の複合テンプレートは、単一のエンベロープ内で複数のドキュメントと署名構成を組み合わせるための強力な方法です。DocuSign の用語では、「エンベロープ」は、署名が必要な 1 つ以上のドキュメントのコンテナです。従来のエンベロープはドキュメントを順番に処理しますが、複合テンプレートは並行アセンブリをサポートしており、異なる PDF を特定の受信者に添付しながら、ドキュメント全体のタブ（署名フィールド）を定義できます。これは、表紙、条項 PDF、および開示フォームが手動で結合することなく同じ当事者によって署名される必要がある、ローン申請のようなシナリオに最適です。

ビジネスの観点から見ると、この機能は API 呼び出しを減らし、ドキュメントルーティングのエラーを最小限に抑え、ターンアラウンドタイムを短縮します。これは、営業チームが取引を成立させたり、人事部が入社パッケージを処理したりする上で非常に重要です。DocuSign の開発者リソースによると、複合テンプレートは Intermediate および Advanced API レベルで利用でき、これらのプランの年間料金は約 3,600 ドルからで、中程度の使用量に適しています。

複合テンプレートを使用するためのステップバイステップガイド

複合テンプレートを使用して複数の PDF を結合するには、DocuSign REST API（バージョン 2.1 以降）とやり取りします。前提条件には、DocuSign 開発者アカウント（無料のサンドボックスを提供）と、OAuth を介して取得した API 認証情報が含まれます。以下は、実践的なガイドです。

1. ドキュメントとテンプレートの準備：

   • PDF を DocuSign の一時ストレージにアップロードするか、base64 エンコードを介して参照します。たとえば、pdf1.pdf（契約）と pdf2.pdf（補遺）を準備します。
   • 再利用可能な場合は、DocuSign Web アプリケーションでテンプレートを作成します。各テンプレートには、署名、日付、またはテキストフィールドなどの事前定義されたタブを含めることができます。DocuSign ダッシュボードからテンプレート ID を記録します。

2. エンベロープ定義の設定：

   • /envelopes エンドポイントを使用して、新しいエンベロープを作成します。JSON リクエストボディで compositeTemplates 配列を構造化します。
   • 重要な要素：
     • document：インラインまたはリモート PDF。
     • serverTemplates または inlineTemplates：既存のテンプレートへのリンク。
     • recipients：署名者（署名者ロールなど）を定義し、それらを複合テンプレートに添付します。

   JSON スニペットの例（Node.js または同様のツールを使用して API 呼び出しを行います）：

   {
     "status": "sent",
     "emailSubject": "Please sign the merged agreement",
     "compositeTemplates": [
       {
         "compositeTemplateId": "template1",
         "document": {
           "documentBase64": "base64_of_pdf1",
           "name": "Main Contract",
           "fileExtension": "pdf",
           "documentId": "1"
         },
         "serverTemplates": [
           {
             "sequence": "1",
             "templateId": "your-template-id-1"
           }
         ],
         "inlineTemplates": [
           {
             "sequence": "1",
             "recipients": {
               "signers": [
                 {
                   "email": "signer@example.com",
                   "name": "John Doe",
                   "recipientId": "1",
                   "tabs": {
                     "signHereTabs": [
                       {
                         "documentId": "1",
                         "pageNumber": "1",
                         "xPosition": "100",
                         "yPosition": "200"
                       }
                     ]
                   }
                 }
               ]
             }
           }
         ]
       },
       {
         "compositeTemplateId": "template2",
         "document": {
           "documentBase64": "base64_of_pdf2",
           "name": "Addendum",
           "fileExtension": "pdf",
           "documentId": "2"
         },
         "serverTemplates": [
           {
             "sequence": "2",
             "templateId": "your-template-id-2"
           }
         ]
       }
     ],
     "recipients": {
       "signers": [
         {
           "email": "signer@example.com",
           "name": "John Doe",
           "recipientId": "1",
           "routingOrder": "1"
         }
       ]
     }
   }
   

   これにより、pdf1 と pdf2 が 1 つのエンベロープに結合されます。最初の複合テンプレートは、テンプレート 1 を最初の PDF に添付し、署名タブを追加します。2 番目のテンプレートは、テンプレート 2 を介して補遺を追加します。受信者は、個別のエンベロープを表示することなく、結合されたドキュメントに署名します。

3. 結合ロジックの処理：

   • documentId を使用して、PDF を一意に参照します。テンプレートからのタブは特定のドキュメントに適用されますが、統一されたビューに表示されます。
   • バッチ結合の場合は、Bulk Send API（Business Pro または Advanced プラン）と統合します。年間、ユーザーあたり約 100 回の送信制限があります。
   • エラー処理：base64 サイズ（ドキュメントあたり最大 5MB）を検証し、OAuth スコープに signature が含まれていることを確認します。

4. エンベロープの送信と監視：

   • https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes に POST します。
   • /envelopes/{envelopeId} を介してステータスを取得します。完了したエンベロープは、API を介して結合された PDF を返します。
   • ビジネスヒント：本番環境では、署名完了のリアルタイム通知に webhook（Advanced プランの Connect 機能）を使用します。

5. テストと最適化：

   • サンドボックスでのテストには、エンベロープの割り当ては課金されません。API ダッシュボードで使用量を監視して、超過を回避します。Starter プランでは、月あたり 40 個のエンベロープに制限されています。
   • 複雑な結合の場合は、PowerForms と組み合わせて、一般公開されているテンプレートに使用し、e コマースまたはパートナーのオンボーディングのスケーラビリティを向上させます。

業界のベンチマークによると、この方法により、大量の環境でドキュメントの準備時間を 50〜70％ 短縮できます。ただし、企業の場合、カスタム統合には Enterprise API プランが必要になる場合があり、価格は容量に応じてカスタマイズされます。

DocuSign IAM CLM との統合

DocuSign のインテリジェント契約管理 (IAM) と契約ライフサイクル管理 (CLM) は、複合テンプレートの価値を拡張します。IAM は AI 駆動のリスク評価と条項抽出を提供し、CLM はテンプレートライブラリと分析を含むエンドツーエンドのワークフロー自動化を提供します。API コンテキストでは、これらは複合テンプレートと統合され、動的な PDF 生成に使用されます。たとえば、CRM システムからデータをプルして、結合されたドキュメントに入力します。金融などの規制対象業界の企業は、IAM の監査証跡や SSO などのコンプライアンスツールから恩恵を受けますが、認証などの追加機能には従量課金が発生します。

競争環境における電子署名プラットフォームの評価

企業がグローバル化するにつれて、電子署名プロバイダーの選択には、API の柔軟性、コンプライアンス、およびコストのバランスが必要です。DocuSign は、複合テンプレートなどの堅牢な API 機能でリードしていますが、代替案は異なる利点を提供します。Adobe Sign は、PDF 中心のプロセスに優れており、結合前の高度な編集のために Adobe Acrobat とシームレスに統合されています。その API は、「プロトコル」を介して同様の複合構造をサポートしており、基本プランは月額 10 ドル/ユーザーからです。

HelloSign（現在は Dropbox Sign）は、簡単な結合のためのユーザーフレンドリーな API を提供し、SMB の使いやすさを強調しています。月額 15 ドル/ユーザーのプランで無制限のテンプレートを提供します。DocuSign の条件ロジックの深さに欠けていますが、Google Workspace などのツールとの迅速な統合に優れています。

eSignGlobal は、100 の主要な国と地域でのコンプライアンスをサポートするグローバルな競争相手としての地位を確立しています。電子署名規制が細分化され、高水準で厳しく規制されているアジア太平洋地域 (APAC) での強みを持っています。多くの場合、米国やヨーロッパで一般的なフレームワークベースの ESIGN/eIDAS モデルではなく、エコシステム統合スキームが必要です。APAC では、政府から企業 (G2B) のデジタル ID への深いハードウェア/API レベルのドッキングが必要であり、電子メール検証や自己申告を超える技術的なハードルが高くなります。eSignGlobal は、香港の iAM Smart やシンガポールの Singpass とシームレスに統合されており、Bulk Send や AI 契約ツールなどの機能を提供しています。その Essential プランは、年間 16.6 ドル/月で、100 回のドキュメント送信、無制限のユーザーシート、およびアクセスコード検証を許可しています。コンプライアンスに基づいて強力な価値を提供し、競合他社よりもわずかにコスト上の優位性があります。このプラットフォームは、既存のリーダーに挑戦するために、ヨーロッパおよびアメリカ市場を積極的に拡大しています。

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

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

👉 無料トライアルを開始

競合他社の比較表

この表は、中立的なトレードオフを強調しています。DocuSign は大量の API ニーズに適しており、他のプラットフォームは手頃な価格または地域への適応を優先しています。

電子署名選択の最終的な考察

結論として、DocuSign の複合テンプレートは、API を介して PDF を結合し、ビジネスワークフローの効率を向上させるための信頼できる方法を提供します。代替案を探しているチームにとって、eSignGlobal は、特に APAC 操作を対象とした、中立的で地域に準拠したオプションとして際立っています。