DocuSign API: 送信済みエンベロープから受信者を削除する

DocuSign API のナビゲート: 送信済みエンベロープの受信者の管理

デジタル取引のペースが速い世界では、DocuSign のような電子署名プラットフォームは、企業が契約ワークフローを合理化するための不可欠なツールとなっています。DocuSign API は、開発者にとって強力なツールとして機能し、カスタムアプリケーションへのシームレスな統合を可能にし、エンベロープの作成、送信、管理を自動化します。しかし、一般的な問題点は、エンベロープ (DocuSign が署名準備ドキュメントパッケージを指す用語) が送信された後、エラー、取引条件の変更、またはコンプライアンスの更新のために受信者を削除する必要が生じることです。このシナリオは、API の柔軟性の限界を試すとともに、電子署名プロセスにおける堅牢なエラー処理の重要性を強調します。

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

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

👉 無料トライアルを開始

DocuSign API における削除の課題の理解

DocuSign エコシステムでは、送信済みのエンベロープから受信者を削除することは簡単ではありません。これは主に、エンベロープが転送中の状態になると、監査証跡と法的完全性を維持するように設計されているためです。ビジネスの観点から見ると、この制限は不正な変更を防ぎ、署名を無効にしたり、企業を紛争にさらしたりすることを回避します。API は、ステータスチェックを通じてこれを強制します。「送信済み」状態のエンベロープはロックされ、保管チェーンを保持します。これは、米国の ESIGN 法または EU の eIDAS などの電子署名基準の中核となる原則です。

API を介して直接削除を試みると、通常、「ENVELOPE_IS_SENT」または「送信後に受信者を変更できません」などのエラーが発生します。これは意図的なものであり、DocuSign のコンプライアンスへの取り組みを反映しています。企業は、販売パイプラインでの一括送信など、大量の操作でこの状況に頻繁に遭遇します。受信者リストを迅速に修正する必要がある場合があります。適切に処理しないと、ワークフローのボトルネック、手動介入の増加、および潜在的な収益の遅延につながる可能性があります。

送信後に受信者を削除するためのステップバイステップガイド

この問題に対処するために、DocuSign は API を介して回避策を提供し、直接削除ではなく修正に焦点を当てています。主な方法は、「修正」機能を使用することです。これにより、元のバージョンを無効にするか、受信者を間接的に更新しながら、新しいエンベロープバージョンが作成されます。これは、すべての変更を記録することでコンプライアンスを維持します。API クレデンシャルが設定されていることを前提として、DocuSign eSignature REST API (バージョン 2.1) を使用してこれを実装する方法を以下に示します。

前提条件

• OAuth (JWT または認証コード付与フロー) を介して API トークンを取得します。
• 送信済みのエンベロープからエンベロープ ID を識別します (GET /envelopes/{envelopeId} で取得可能)。
• アカウントにエンベロープ修正権限があることを確認します (Business Pro 以上のプランに適用)。

API ワークフロー

1. エンベロープステータスの取得: まず、エンベロープが「送信済み」状態であることを確認します。

   GET https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   

   応答には、status: "sent" と受信者の詳細が含まれます。

2. 元のエンベロープの無効化 (必要な場合): 削除が不可欠であり、署名がまだ開始されていない場合は、エンベロープを無効にしてすべてのアクティビティを停止します。

   PUT https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   Body: {
     "status": "voided",
     "voidedReason": "受信者の修正が必要です"
   }
   

   これにより、データを削除せずにプロセスが停止し、監査ログが保持されます。

3. 修正エンベロープの作成: 「修正」エンドポイントを使用して、新しいバージョンを生成します。これにより、新しい受信者リストから省略することで受信者を削除できます。

   POST https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/correct
   Body: {
     "envelopeReassign": false,
     "notifyUser": true
   }
   

   次に、/envelopes/{envelopeId}/recipients への後続の PUT を介して受信者を更新します。

   • 本文では、必要な受信者のみをリストし、「削除」する受信者を除外します。
   • JSON スニペットの例:

     {
       "recipients": {
         "signers": [
           {
             "email": "remaining@signer.com",
             "name": "John Doe",
             "recipientId": "1",
             "routingOrder": "1"
           }
         ]
       }
     }
     

   status: "sent" を使用して、修正されたエンベロープを再送信します。

4. エッジケースの処理: 受信者がすでに署名している場合、修正では削除できない場合があります。DocuSign は完了した操作を優先します。この場合、その受信者の「拒否」API を使用するか、まったく新しいエンベロープを作成します。一括シナリオの場合は、一括送信 API (高度なプラン機能) を利用して、事前にエラーを回避します。

ベストプラクティスと制限事項

• テスト: 常に、本番環境を使用する前にデモ環境 (demo.docusign.net) を使用してください。
• クォータ: 修正はエンベロープ制限にカウントされます (例: 標準プランでは年間 100 個)。
• エラー処理: API 応答の try-catch を実装します。一般的な問題には、権限の不足やトークンの有効期限切れなどがあります。
• コンプライアンスに関する注意: これらの操作は、GDPR や HIPAA などの規制にとって重要な、不変の監査イベントを生成します。

ビジネスの観点から見ると、この API フローを習得すると、大幅な時間を節約できます。企業は、契約管理サイクルタイムが最大 30% 短縮されたと報告しています。ただし、リスクの高い環境では、DocuSign の ID およびアクセス管理 (IAM) ツールとの統合により、送信前のエラーを最小限に抑えるための検証レイヤーを追加できます。

DocuSign 製品エコシステムの概要

DocuSign のスイートは、基本的な電子署名を超えています。eSignature プラットフォームは、コアドキュメント署名を処理し、API はカスタム統合を可能にします。高度なニーズに対応するために、DocuSign IAM は、SSO、多要素認証、生体認証チェックなどの強力な認証を提供します。これは、規制対象の業界にとって不可欠です。契約ライフサイクル管理 (CLM) は、AI 駆動型の交渉追跡とリポジトリ管理を統合し、ドラフトからアーカイブまでのプロセスを合理化します。価格は、個人プランの月額 10 ドルから始まり、API 集中型のカスタムエンタープライズ版に拡張され、SMS 配信などの追加機能はメッセージごとに課金されます。

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

電子署名市場は競争が激しく、Adobe Sign、HelloSign (現在は Dropbox Sign)、eSignGlobal などのプレーヤーが市場シェアを争っています。各プラットフォームは、受信者管理のための API 機能を提供していますが、その方法は柔軟性、コスト、および地域的な重点において異なります。たとえば、Adobe Sign は、Adobe クリエイティブスイートおよび PDF ツールとのシームレスな統合を強調しており、ドキュメント集約型のワークフローに適しています。その API は同様の修正メカニズムをサポートしていますが、エンタープライズレベルの自動化に優れており、価格は個人向けに月額 10 ドル/ユーザーから始まります。

Dropbox に買収された HelloSign は、シンプルさを優先し、エンベロープ修正のためのユーザーフレンドリーな API を提供し、通常、初期費用が低くなっています (基本版は月額 15 ドル)。これは、深いカスタマイズを必要とせずに迅速なセットアップを必要とする中小企業に人気があります。

意思決定を支援するために、主要なビジネス要因に基づいた中立的な比較表を以下に示します (2025 年の価格設定、年間払い、米国地域)。

この表は、トレードオフを強調しています。DocuSign は成熟度で優れており、代替案はコストまたはニッチな利点を提供します。

eSignGlobal: グローバルな影響力を持つ地域競争者

eSignGlobal は、グローバルなコンプライアンスの代替案として位置付けられており、世界中の 100 以上の主要な国と地域で電子署名をサポートしています。特にアジア太平洋 (APAC) 地域で強みを発揮しており、電子署名規制は断片的で、高水準で、厳しく規制されています。これは、米国と EU のフレームワークベースの ESIGN/eIDAS 基準とは対照的です。APAC は「エコシステム統合」コンプライアンスを要求しており、企業 (G2B) のデジタル ID との深いハードウェアおよび API レベルのドッキングが必要です。これは、西側諸国で一般的な電子メール検証や自己申告モードの技術的な障壁をはるかに超えています。

たとえば、eSignGlobal は香港の iAM Smart とシンガポールの Singpass をシームレスに統合し、これらの市場での法的有効性を保証します。価格は競争力があり、Essential プランは月額わずか 16.6 ドル (年間払い) で、最大 100 個の署名待ちドキュメント、無制限のユーザーシート、およびアクセスコード検証を許可します。これらはすべて、コンプライアンスの基盤の上に構築されています。これにより、DocuSign のシートごとのモデルよりも成長中のチームにとって非常に費用対効果が高く、グローバルな拡張計画において Adobe Sign と直接競合します。

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

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

👉 無料トライアルを開始

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

受信者管理に DocuSign API ソリューションを評価する際、企業は API の堅牢性と運用ニーズを比較検討する必要があります。グローバル企業にとって、DocuSign は依然としてベンチマークです。代替案が勢いを増すにつれて、eSignGlobal は中立的で地域コンプライアンスオプションとして際立っており、APAC に重点を置いた運用を検討する価値があります。