DocuSign API：署名済みドキュメントから「Tab Data」（フォームデータ）を取得する方法

DocuSign API をナビゲートしてフォームデータを抽出する：ビジネス視点

デジタル契約が進化し続ける状況において、企業はワークフローを効率化し、コンプライアンスを確保するために、DocuSign のような電子署名プラットフォームへの依存度を高めています。組織が拡大するにつれて、署名済みドキュメントからのデータ抽出を自動化するために DocuSign の API を統合することが不可欠になります。この記事では、DocuSign の API を使用して「タブデータ」—署名プロセス中に記入されたフォームフィールド—を取得する方法について説明し、開発者とビジネスリーダーに実用的な洞察を提供します。ビジネスの観点から見ると、この機能を習得することで、手作業による処理コストを削減し、データ分析能力を向上させることができますが、統合の落とし穴を避けるためには、API の制限とベストプラクティスを理解する必要があります。

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

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

👉 無料トライアルを開始

DocuSign におけるタブデータとは？

タブデータとは、DocuSign エンベロープ内のフォームフィールド（または「タブ」）によってキャプチャされた構造化された情報を指します。たとえば、署名者が追加したテキストボックス、チェックボックス、日付、または署名などです。ドキュメントが署名されると、このデータは完了したフォームの値を表し、CRM の更新、コンプライアンスレポート、または請求書の生成などのビジネスプロセスにとって不可欠です。DocuSign のエコシステムでは、タブはプラットフォームの作成ツールを介して PDF ドキュメントに埋め込まれ、完了後にサーバー側でその値を保存します。

ビジネスの視点から見ると、API を介してタブデータを抽出することは、大量の契約を処理する企業にとって変革的な機能です。これにより、Salesforce や ERP システムなどのツールとのシームレスな統合が可能になり、データ入力時間を 70〜80％ 短縮できる可能性があります。ただし、エンベロープの状態（たとえば、無効または拒否）やデータシリアル化などの課題により、取得が複雑になる可能性があります（適切に処理されない場合）。

ステップバイステップガイド：DocuSign API を使用して署名済みドキュメントからタブデータを取得する

署名後にタブデータにアクセスするには、DocuSign の REST API（2025 年の安定性を確保するためにバージョン 2.1 を推奨）を使用します。このプロセスでは、開発者アカウント、API 認証情報（統合キー、シークレットキー、およびユーザー ID）、およびアクティブなエンベロープがあることを前提としています。API エンドポイントは OAuth 2.0 によって保護されており、ESIGN や eIDAS などの標準に準拠しています。

前提条件と設定

1. API アクセスを取得する：DocuSign 開発者センター（developer.docusign.com）にログインし、アプリケーションを作成します。統合キーを生成し、認証のために JWT または認証コードグラントを有効にします。本番環境では、サンドボックスからライブ認証情報に切り替えます。

2. エンベロープを識別する：エンベロープが「完了」状態であることを確認します。GET /envelopes/{envelopeId} エンドポイントを使用して検証します。

   curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
   -H "Authorization: Bearer {accessToken}"
   

   これにより、ステータスを含むエンベロープの詳細が返されます。

3. 認証：OAuth を実装します。JWT の場合は、秘密鍵を使用してトークンを生成します。

   import requests
   from docusign_esign import ApiClient, EnvelopesApi
   
   api_client = ApiClient()
   api_client.host = "https://demo.docusign.net/restapi"
   api_client.request_header['Authorization'] = 'Bearer ' + access_token  # JWT フローから
   

ビジネスヒント：リスクの高い環境では、より高い API クォータ（高度な層のカスタム制限が最高で、年間 5,760 ドルから）のためにエンタープライズプランを使用します。無料の開発者サンドボックスは、1 か月あたり 25 個のエンベロープに制限されているためです。

タブデータの取得：コア API 呼び出し

重要なエンドポイントは GET /envelopes/{envelopeId}/documents/{documentId}/form_data ですが、包括的なタブデータについては、エンベロープの受信者とカスタムフィールドと組み合わせて使用します。ワークフローは次のとおりです。

1. エンベロープ内のドキュメントを一覧表示する： 最初にドキュメント ID を取得します。タブデータは特定の PDF に関連付けられているためです。

   curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents" \
   -H "Authorization: Bearer {accessToken}"
   

   応答には documentId が含まれます（たとえば、メイン PDF の場合は 1）。

2. フォームデータ（タブ値）を抽出する： フォームデータエンドポイントを使用して、すべての入力済みタブを取得します。

   curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents/{documentId}/form_data" \
   -H "Authorization: Bearer {accessToken}"
   

   応答の例（JSON）：

   {
     "formData": [
       {
         "name": "customerName",
         "value": "John Doe",
         "pageNumber": 1,
         "xPosition": 100,
         "yPosition": 200,
         "width": 150,
         "height": 20
       },
       {
         "name": "signatureDate",
         "value": "2025-01-15",
         "recipient": "Signer1"
       }
     ]
   }
   

   これにより、テキスト、日付、およびその他のフィールド値がキャプチャされます。注：署名自体は「データ」ではありませんが、recipientId を介して参照できます。

3. 特定の受信者のデータを処理する： 複数の署名者のエンベロープの場合は、GET /envelopes/{envelopeId}/recipients/{recipientId}/tabs を使用して受信者でフィルタリングします。これにより、その署名者に割り当てられたタブが返されます。

   curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/tabs" \
   -H "Authorization: Bearer {accessToken}"
   

   応答には tabLabel（フォームフィールド名と一致）と value が含まれます。

4. 高度な機能：カスタムフィールドと添付ファイル： 署名者の添付ファイルなどの Business Pro 機能を使用している場合は、GET /envelopes/{envelopeId}/custom_fields を介して取得します。完全な監査証跡（コンプライアンスに関連）については、エンベロープクエリに ?include=summary を追加します。

コード実装（Python の例）

DocuSign eSign SDK を使用します。

from docusign_esign import EnvelopesApi, EnvelopeFormData

envelopes_api = EnvelopesApi(api_client)
envelope_id = 'your-envelope-id'
account_id = 'your-account-id'
document_id = 1  # メインドキュメント

# フォームデータを取得する
form_data_result = envelopes_api.get_form_data(account_id, envelope_id, document_id=document_id)
for fd in form_data_result.form_data:
    print(f"Field: {fd.name}, Value: {fd.value}")

このスクリプトは、すべてのタブデータを出力し、CSV にエクスポートしたり、データベースに挿入したりする準備ができています。

一般的な課題とベストプラクティス

• エラー処理：API レート制限（たとえば、中間プランでは 1 時間あたり 1,000 回の呼び出し、年間 3,600 ドル）により、大規模なクエリが制限される可能性があります。指数バックオフを使用した再試行メカニズムを実装します。
• データプライバシー：取得後に機密フィールドをマスクすることにより、GDPR/eIDAS への準拠を確保します。
• テスト：コストをかけずに署名をシミュレートするために、サンドボックスエンベロープを使用します。バッチシナリオでは、Connect Webhook を利用して完了イベントでデータプルをトリガーし、ポーリングのオーバーヘッドを削減します。
• コストへの影響：API 呼び出しはエンベロープクォータにカウントされます（たとえば、標準プランでは 1 か月あたり 100 個、ユーザーあたり年間 300 ドル）。超過すると従量課金が発生するため、API 使用状況の中央監視を行います。

ビジネスの観点から見ると、この API 統合は自動化によって ROI を生み出すことができます—企業は契約サイクルが 50％ 高速化されたと報告しています—ただし、事前の開発時間が必要です（堅牢な設定には 2〜4 週間かかります）。企業の場合、DocuSign の高度な API 層（年間 5,760 ドル）は、バッチ送信と Webhook 機能をアンロックし、拡張に適しています。

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

DocuSign は、コアの電子署名を超えて、インテリジェント契約管理（IAM）などのツールを提供し、契約ライフサイクル管理（CLM）を統合してエンドツーエンドのワークフローを実現します。IAM CLM は、起草、交渉、および保管を自動化し、タブデータを分析ダッシュボードに取り込んでリスク評価を行います。価格は、拡張プランのカスタムから始まり、SSO と大規模チームのガバナンスを重視しています。

競争環境：電子署名プラットフォームの比較

50 億ドルを超える価値のある電子署名市場では、DocuSign は強力な API 機能でリードしていますが、代替案は価格設定、コンプライアンス、および地域的な焦点において異なる利点を提供しています。以下は、2025 年の公開データに基づいた主要なプレーヤーの中立的な比較です。

DocuSign の概要

DocuSign は、前述のように、タブデータ抽出のための包括的な API サポートを備えたグローバルなリーダーです。その強みは、エンタープライズレベルの機能（バッチ送信や認証アドオン（従量課金））にあります。ただし、シートベースの価格設定は、大規模なチームでは急激に上昇する可能性があり、アジア太平洋地域での遅延がパフォーマンスに影響を与える可能性があります。

Adobe Sign の概要

Adobe Sign は Adobe Acrobat エコシステムと統合されており、REST API（たとえば、GET /agreements/{agreementId}/formData）を介して同様のフォームデータアクセスを提供します。シームレスな PDF 処理とエンタープライズセキュリティで高く評価されており、個人プランは月額 10 ドル/ユーザーから始まります。欠点としては、高度な自動化のコストが高く、DocuSign と比較してカスタムワークフローの柔軟性が低いことが挙げられます。

eSignGlobal の概要

eSignGlobal は、グローバルで 100 以上の主要国の電子署名をサポートするコンプライアンス代替案として位置付けられています。アジア太平洋地域では、電子署名規制が断片化され、高水準で厳格に規制されているため、優れたパフォーマンスを発揮します—多くの場合、政府のデジタル ID との深いハードウェア/API ドッキング（G2B）など、エコシステム統合のアプローチが必要です。米国と EU が電子メール検証または自己申告のフレームワークスタイルの ESIGN/eIDAS 標準に依存しているのとは異なり、アジア太平洋地域では法的有効性を確保するためにローカル統合が必要です。eSignGlobal の Essential プランは、年間 299 ドル（約月額 24.9 ドル、プロモーション価格では月額 16.6 ドル相当まで下がる可能性があります）で強力な価値を提供し、最大 100 個の署名ドキュメント、無制限のユーザーシートを許可し、アクセスコード検証を介して提供します。香港の iAM Smart およびシンガポールの Singpass とシームレスに統合されており、追加料金なしで地域コンプライアンスに最適です。グローバルでは、米国と EU を含む eSignGlobal は、API 駆動のフォームデータ取得などの機能を維持しながら、競合他社よりもコストを抑えることで競争しています。

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

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

👉 無料トライアルを開始

HelloSign (Dropbox Sign) およびその他の競合他社

現在 Dropbox Sign である HelloSign は、フォームフィールド抽出のためのシンプルな API（GET /signature_request/{request_id}/details を介して）を提供し、小規模チーム向けの無料層を提供します。SMB には使いやすいですが、DocuSign の自動化の深さがありません。PandaDoc などの他のプレーヤーは、埋め込みフォームを使用した提案に焦点を当てており、SignNow はモバイルファーストのエクスペリエンスを重視しています。

この表は、トレードオフを強調しています。DocuSign は深さを重視し、eSignGlobal はアジア太平洋地域の効率を重視しています。

最終的な考察：適切なソリューションを選択する

API 駆動のデータ抽出を優先する企業にとって、DocuSign は成熟したエコシステムを備えているため、依然として信頼できる選択肢です。ただし、地域的なニーズが高まるにつれて—特にコンプライアンスが厳しい分野では—eSignGlobal などの代替案は、コスト削減とローカライズされたサポートを求める DocuSign ユーザーに、バランスの取れた地域に最適化されたオプションを提供します。容量と地理的な場所に基づいて評価してください。