DocuSign API：封筒内の特定の受信者のステータスを取得する方法

DocuSignエンベロープにおける受信者のステータスについて

デジタル契約が急速に進化する世界において、電子署名の進捗状況を追跡することは、DocuSignなどのプラットフォームに依存する企業にとって非常に重要です。DocuSign APIは、特にエンベロープ内の特定の受信者のステータスを確認するために、ワークフローを自動化および監視するための強力なツールを開発者に提供します。この機能により、コンプライアンスが確保され、効率が向上し、チームが遅延や完了に迅速に対応できるようになります。販売契約から人事のオンボーディングまで、受信者がドキュメントを表示、署名、または拒否したかどうかを知ることで、ボトルネックを防ぎ、ユーザーエクスペリエンスを向上させることができます。

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

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

👉 無料トライアルを開始

DocuSign APIを介して受信者のステータスを追跡する理由

企業はDocuSignのAPIを統合して運用を合理化しますが、一般的な課題は、個々の受信者のアクションをリアルタイムで監視することです。DocuSignでは、「エンベロープ」とは、署名のために1つまたは複数のドキュメントを送信するために使用されるコンテナを指し、順次または並行ルーティングで複数の受信者が関与する可能性があります。受信者のステータス（「送信済み」、「配信済み」、「署名済み」、「拒否済み」、または「無効」など）は、ワークフローの健全性に関する洞察を提供します。たとえば、多者間契約では、主要な承認者が応答しない場合、自動通知をトリガーして、彼らに進捗を促すことができます。

ビジネスの観点から見ると、この機能はスケーラビリティをサポートします。金融サービスや不動産会社など、大量の契約を処理する企業は、これを使用して完了率レポートを生成し、手動でのフォローアップを減らし、エラーを最小限に抑えます。業界の観察によると、効率的なステータス追跡により、処理時間が最大30％短縮され、収益サイクルに直接影響します。

ステップバイステップガイド：DocuSign APIを使用して受信者のステータスを取得する

エンベロープ内の特定の受信者のステータスを取得するには、DocuSign eSignature REST API（バージョン2.1以降）を利用します。このプロセスには、OAuth 2.0による認証と、APIエンドポイントの基本的な理解が必要です。以下は、開発者アカウントとAPIアクセストークンを持っていることを前提とした、実用的なチュートリアルです。

前提条件

• APIクレデンシャル：DocuSign開発者センターから、統合キー（クライアントID）、シークレット、およびユーザーIDを取得します。JWTまたはAuth Code Grant認証を設定します。
• ツール：Postman、cURL、またはPython/Node.jsなどのプログラミング言語をDocuSign SDKと組み合わせて使用します。
• エンベロープID：エンベロープの一意のIDが必要です（APIまたはWebアプリケーションを介して作成されたときに生成されます）。
• 受信者IDまたはメール：役割（「signer1」など）またはメールアドレスで特定の受信者を識別します。

ステップ1：認証してアクセストークンを取得する

まず、アクセストークンを取得します。JWT認証の場合（サーバー間アプリケーションに推奨）：

curl -X POST "https://account-d.docusign.com/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&assertion=YOUR_JWT_TOKEN"

YOUR_JWT_TOKENをbase64エンコードされたJWTペイロードに置き換えます。応答には、約1時間有効なaccess_tokenが含まれます。

ステップ2：Envelopes:Recipientsエンドポイントを呼び出す

GET /envelopes/{envelopeId}/recipientsエンドポイントを使用して、ステータスを含むすべての受信者の詳細を取得します。

• エンドポイントURL：https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients
  • {accountId}をDocuSignアカウントIDに置き換えます。
  • {envelopeId}をターゲットエンベロープのIDに置き換えます。
• ヘッダー：
  • Authorization: Bearer {access_token}
  • Accept: application/json

cURLリクエストの例：

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

ステップ3：応答を解析して特定の受信者を取得する

JSON応答は、recipients.signersまたはrecipients.carbonCopiesなどの下に受信者の配列を返します。emailまたはrecipientIdで一致する受信者を探します。

応答スニペットの例：

{
  "recipients": {
    "signers": [
      {
        "email": "recipient@example.com",
        "recipientId": "1",
        "status": "signed",
        "signedDateTime": "2025-01-15T10:30:00Z",
        "deliveryStatus": "delivered"
      }
    ]
  },
  "envelopeId": "{envelopeId}"
}

注意すべき重要なフィールド：

• status：コアインジケーター（「sent」、「viewed」、「signed」、「declined」、「faxpending」など）。
• declineReason：拒否された場合、理由を説明します。
• signedDateTime：操作のタイムスタンプ。
• errorDetails：発生した問題。

特定の受信者の場合、クライアント側で配列をフィルタリングします。recipientIdがわかっている場合は、ターゲットを絞ったエンドポイントGET /envelopes/{envelopeId}/recipients/{recipientId}を使用して、より正確な詳細を取得できます。

ステップ4：エッジケースとベストプラクティスを処理する

• エラー処理：HTTP 401（認証失敗）または404（無効なID）に注意してください。レート制限（デモアカウントの場合は100回/分）のために再試行を実装します。
• リアルタイム更新のポーリング：ステータスはすぐに更新されません。30〜60秒ごとにエンドポイントをポーリングするか、DocuSign Connect（Webhook）を使用してイベント駆動型通知を行います。
• セキュリティ：常にHTTPSを使用し、トークンスコープをsignatureに制限します。
• テスト：実際のコストを回避するために、デモ環境（demo.docusign.net）で開始します。本番環境では、na3.docusign.netまたは特定のリージョンURLを使用します。

コードでは、Python SDKのようなライブラリがこのプロセスを簡素化します。

from docusign_esign import ApiClient, EnvelopesApi

api_client = ApiClient()
api_client.host = "https://demo.docusign.net/restapi"
api_client.set_default_header("Authorization", f"Bearer {access_token}")

envelopes_api = EnvelopesApi(api_client)
recipients = envelopes_api.get_recipients(account_id, envelope_id)
specific_recipient = next(r for r in recipients.signers if r.email == "recipient@example.com")
print(specific_recipient.status)

この方法は、SalesforceなどのCRMシステムやカスタムアプリケーションとの統合に非常に効率的であり、企業がアラートまたはレポートダッシュボードを自動化することを可能にします。

ビジネスインサイト：電子署名エコシステムにおけるAPIの使用

DocuSignのAPI価格は、スタータープランの年間600ドルから始まり（月あたり40エンベロープ）、大量のニーズに対応するカスタムエンタープライズオプションまで拡張されます。強力ですが、クォータの慎重な管理が必要です。自動送信などのバッチ操作の上限は約年間100/ユーザーです。アジア太平洋地域の企業の場合、国境を越えた遅延がAPIの応答性に影響を与える可能性があるため、地域の代替案を評価する必要があります。

電子署名プラットフォームの比較：DocuSignと競合他社

バランスの取れた視点を提供するために、以下はDocuSignと、Adobe Sign、eSignGlobal、およびHelloSign（現在はDropboxの一部）などの主要な競合他社との中立的な比較です。この表は、2025年の公開データに基づいており、API機能、コンプライアンス、およびグローバル企業の拡張性に焦点を当てて、価格、機能、および利点を強調しています。

この比較は、エンタープライズレベルのAPIの深さにおけるDocuSignの卓越性を強調しており、代替案はコスト削減または地域の利点を提供します。

Adobe Signは、クリエイティブツールとの統合により際立っており、マーケティングチームに適していますが、そのAPIはDocuSignのエンベロープフォーカスモデルよりもPDFに重点を置いています。

代替案の探索：Adobe Sign、eSignGlobal、およびHelloSign

Adobe Signは、ステータス追跡のためのDocuSignと同様の信頼性の高いAPIを提供し、/agreements/{agreementId}/participantsなどのエンドポイントを使用して署名者のステータスを照会します。ドキュメント集約型業界で高く評価されていますが、複雑なルーティングにはあまり機敏ではないと感じられる場合があります。

eSignGlobalは、アジア太平洋市場の新興企業であり、100の主要な国と地域をサポートするグローバルコンプライアンスを備えており、アジア太平洋地域で特に強みを持っています。この地域の電子署名の状況は断片的であり、高い基準と厳格な規制があり、基本的な検証を超えるものが必要です。米国とEUが電子メールまたは自己申告のフレームワークのようなESIGN/eIDAS標準に依存するのとは異なり、アジア太平洋地域は「エコシステム統合」アプローチを強調しています。これには、政府から企業（G2B）のデジタルIDとの深いハードウェア/APIレベルの統合が含まれており、西洋の規範をはるかに超える技術的な障壁が高まっています。eSignGlobalは、香港のiAM SmartやシンガポールのSingpassなどのツールをネイティブにサポートすることでこれに対処し、シームレスで準拠したワークフローを可能にします。価格は競争力があり、そのエッセンシャルプランは約月額24.9ドル（年間299ドル）で、最大100の署名ドキュメント、無制限のユーザーシート、およびアクセスコードによる検証を許可しながら、高いコンプライアンスを維持します。これにより、規制された市場でチームを拡大するための費用対効果の高いオプションとなり、同社は柔軟な価格設定とより迅速な地域パフォーマンスを提供することで、グローバルにDocuSignおよびAdobe Signと積極的に競争しています。

HelloSignは、/agreement/recipientsを介して受信者のステータスの簡単なAPI呼び出しを提供し、ファイル管理のためにDropboxと適切に統合されています。小規模なチームには使いやすいですが、DocuSignと比較して、エンタープライズ自動化の深さが不足しています。

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

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

👉 無料トライアルを開始

電子署名の選択に関する最終的な考察

API駆動型のエンベロープ管理の精度を優先する企業にとって、DocuSignは依然としてベンチマークです。ただし、ニーズが進化するにつれて、特に多様な地域では、eSignGlobalなどのニュートラルな代替案がDocuSignの代替として浮上し、強力な地域コンプライアンスを提供し、コストと機能を効果的にバランスさせます。