DocuSign API: 未署名のエンベロープのすべての受信者をリスト表示する

封筒を管理するための DocuSign API のナビゲート

デジタル契約が急速に進化する世界において、企業はワークフローを合理化するために電子署名プラットフォームに依存しています。DocuSign はこの分野のリーダーとして、開発者がドキュメントプロセスを自動化および監視できる強力な API 機能を提供しています。一般的な課題の 1 つは、封筒内の受信者のステータスを追跡することです。特に、まだ署名していない受信者を特定することです。この機能は、コンプライアンス、フォローアップ、および運用効率にとって非常に重要であり、特に営業チームや法務部門などの大量の環境では重要です。

DocuSign API と封筒の受信者の理解

DocuSign の eSignature API は、署名が必要なドキュメントのコンテナである封筒を管理するためのエンドポイントを提供します。1 つの封筒には複数の受信者が存在し、各受信者は署名者、承認者、または CC 受信者などの役割を持ちます。API は RESTful アーキテクチャを使用し、JSON ペイロードをサポートし、OAuth 2.0 または JWT 認証による認証が必要です。

まだ封筒に署名していないすべての受信者を一覧表示するために、開発者は通常、封筒のステータスと受信者の詳細を照会します。重要なエンドポイントは、Envelopes API の GET /accounts/{accountId}/envelopes/{envelopeId}/recipients です。これにより、受信者の包括的なリストが返され、ステータス（「送信済み」、「拒否済み」、「署名済み」、または「署名が必要」など）が含まれます。

この機能を実装するためのステップバイステップガイドを以下に示します。

1. 認証の設定：DocuSign の開発者サンドボックスを使用して、アクセストークンを取得します。本番環境では、アプリケーションの IAM（ID およびアクセス管理）システムと統合します。DocuSign の IAM 機能は、Okta や Azure AD などのプロバイダーとの SSO 統合を含む拡張計画の一部であり、資格情報を公開することなく安全な API アクセスを保証します。

2. 封筒の詳細の取得：まず、GET /envelopes/{envelopeId} を使用して封筒を取得します。これにより、封筒のステータス（「送信済み」または「進行中」など）が確認され、作成日や期日などのメタデータが提供されます。

3. 受信者の照会：受信者エンドポイントを呼び出します。応答には、受信者オブジェクトの配列が含まれ、各オブジェクトには以下が含まれます。

   • id：一意の識別子。
   • email：受信者のメールアドレス。
   • status：現在のステータス（署名されていない受信者を識別するために「送信済み」または「署名が必要」でフィルタリングします）。
   • routingOrder：署名プロセスにおける順序。
   • name：受信者の名前。

   API 応答の JSON スニペットの例：

   {
     "recipients": {
       "signers": [
         {
           "email": "john.doe@example.com",
           "status": "sent",
           "name": "John Doe",
           "signedDateTime": null
         },
         {
           "email": "jane.smith@example.com",
           "status": "signed",
           "name": "Jane Smith",
           "signedDateTime": "2025-01-15T10:00:00Z"
         }
       ]
     }
   }
   

4. 署名されていない受信者のフィルタリング：コードで（たとえば、requests ライブラリの Python を使用するか、Axios の Node.js を使用して）、応答を解析し、status != “signed” で signedDateTime が null の場合をフィルタリングします。バッチ操作の場合は、status=sent などのクエリパラメータを指定した GET /envelopes エンドポイントを使用して、複数の封筒を一覧表示します。

   Python コードの例：

   import requests
   
   access_token = "your_access_token"
   account_id = "your_account_id"
   envelope_id = "your_envelope_id"
   base_url = "https://demo.docusign.net/restapi"
   
   headers = {
       "Authorization": f"Bearer {access_token}",
       "Accept": "application/json"
   }
   
   response = requests.get(
       f"{base_url}/v2.1/accounts/{account_id}/envelopes/{envelope_id}/recipients",
       headers=headers
   )
   
   if response.status_code == 200:
       data = response.json()
       unsigned_recipients = [
           r for r in data.get('recipients', {}).get('signers', [])
           if r.get('status') != 'signed' and r.get('signedDateTime') is None
       ]
       print("Unsigned recipients:", unsigned_recipients)
   

5. エラー処理とベストプラクティス：レート制限（たとえば、1 分あたり 1000 回の API 呼び出し）や、404（封筒が見つからない）などのエラーを処理します。エンタープライズユーザーの場合は、リアルタイムのステータス更新のために Connect API の webhook を含む DocuSign の高度な API プランを利用します。これにより、ポーリングを回避し、API 呼び出しを削減できます。

この方法により、署名されていない受信者にプログラムで通知したり、遅延をエスカレートしたり、Salesforce などの CRM システムと統合したりできます。ビジネス環境では、このような自動化により、DocuSign 開発者リソースの業界ベンチマークによると、手動でのフォローアップを最大 70% 削減できます。

DocuSign の API 価格は、Starter プランの年間 600 ドル（月あたり 40 通の封筒）から始まり、カスタムのエンタープライズオプションまで拡張されます。規制対象の業界のチームの場合、これを IAM 機能（高度な監査追跡やロールベースのアクセスなど）と組み合わせることで、カスタム開発なしでコンプライアンスを強化できます。

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

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

👉 無料トライアルを開始

DocuSign のエコシステムと IAM 機能の探索

DocuSign は基本的な署名を超えて拡張され、インテリジェント契約管理 (IAM) スイートの CLM（契約ライフサイクル管理）などの統合ツールを提供します。IAM CLM は、契約の作成、交渉、および実行を自動化し、封筒からデータを抽出して義務を追跡します。API ユーザーの場合、署名セレモニーの埋め込みをサポートし、署名されていない受信者データをダッシュボードに抽出します。

実際には、企業は IAM を使用してエンドツーエンドの可視性を実現します。封筒の署名されていない受信者は、リスクアラートまたは承認ワークフローを入力します。IAM アップグレードの価格はカスタムであり、通常、Business Pro プラン（ユーザーあたり年間 480 ドル）とバンドルされ、ガバナンスおよび分析機能が追加されます。

競争環境：中立的な比較

電子署名市場は競争が激しく、プラットフォームは API の深さ、価格設定、および地域のコンプライアンスで区別されます。以下は、受信者管理の API 機能、コア価格設定、および利点に焦点を当てた、主要なプレーヤーの Markdown 比較テーブルです。データは、中立性を確保するために 2025 年の公開ソースから取得されています。

この表は、トレードオフを強調しています。DocuSign は成熟したエコシステムで優れており、他のプラットフォームは手頃な価格またはニッチな利点を優先しています。

Adobe Sign：統合と API の概要

Adobe Sign は Adobe Document Cloud の一部であり、PDF 中心のプロセスを強調しています。その API は、受信者の追跡に関して DocuSign と同様であり、GET /agreements/{agreementId}/participants を使用して署名されていない当事者を一覧表示します。クリエイティブ業界に適しており、PDF 編集機能が組み込まれています。価格は個人版で月額 10 ドルから始まり、エンタープライズのカスタム料金まで拡張されます。Adobe の強みは、Acrobat およびマーケティングツールとのシームレスな統合ですが、API クォータは大量の使用には制限がある可能性があります。

HelloSign (Dropbox Sign)：SMB 向けのシンプルさ

HelloSign（現在は Dropbox Sign）は、封筒管理のためのシンプルな API を提供します。GET /v3/signature_request/{request_id} を介して署名されていない受信者を取得し、ステータスでフィルタリングします。使いやすさで高く評価されており、組み込みのテンプレートとリマインダー機能があります。Essentials 版は年間 180 ドルで、小規模チームにとっては予算に優しいですが、DocuSign の高度な IAM はありません。

eSignGlobal：APAC 向けに最適化された代替案

eSignGlobal は、100 以上の主要な国と地域でのコンプライアンスをサポートするグローバルな競争相手としての地位を確立しています。特にアジア太平洋地域 (APAC) で強力な存在感を示しており、電子署名規制が細分化され、高水準で厳しく規制されています。通常、米国および EU で一般的なフレームワークベースの ESIGN/eIDAS モデルではなく、エコシステム統合への深いアプローチが必要です。APAC では、政府から企業 (G2B) へのデジタル ID との深いハードウェア/API レベルのドッキングが必要であり、これは西側の市場の電子メール検証や自己申告の方法をはるかに超える技術的なハードルです。

プラットフォームの API には、DocuSign と同様の受信者ステータス照会が含まれており、Professional プランでは一括送信と webhook がサポートされています。価格は競争力があり、Essential バージョンは月額わずか 16.6 ドル（一部のプロモーションでは年間 199 ドルに相当）で、最大 100 個の署名付きドキュメント、無制限のユーザーシート、およびアクセスコード検証を許可しながら、コンプライアンスを維持します。香港の iAM Smart およびシンガポールの Singpass とシームレスに統合されており、国境を越えた APAC 操作に適しています。

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

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

👉 無料トライアルを開始

ビジネスへの影響と推奨事項

ビジネスの観点から見ると、DocuSign の API は、特にグローバル企業にとって、封筒追跡の信頼性のベンチマークであり続けています。ただし、企業が多様な地域に拡大するにつれて、代替案が認識され始めています。DocuSign の代替案を探しているユーザーにとって、eSignGlobal は、特に APAC において、地域コンプライアンスオプションとして際立っており、シートごとの料金なしでコストと機能をバランスさせています。最適な一致を見つけるには、容量、統合、および地理的な場所に基づいて評価してください。