DocuSign API：送信後に「カーボンコピー」受信者を追加する方法

DocuSign におけるカーボンコピー受信者の理解

電子署名分野において、DocuSign の API はドキュメントワークフローを自動化するための強力なツールを提供しますが、エンベロープ作成後に受信者を追加することは難しい場合があります。「カーボンコピー」（CC）受信者は、署名や承認を必要とせずに、署名済みドキュメントのコピーを閲覧または記録保持のために受信する、署名者以外の役割です。ビジネスの観点から見ると、この機能は、署名チェーンを変更することなく通知を必要とするコンプライアンスチーム、法務部門、または営業マネージャーにとって非常に貴重です。ただし、DocuSign の API はエンベロープ送信後の変更に制限があり、これらの制限について詳しく説明します。

この記事では、DocuSign eSignature API を使用して、エンベロープ送信後に CC 受信者を追加する実際の手順について詳しく説明します。前提条件、API 呼び出し、潜在的な落とし穴、およびベストプラクティスについて、公式ドキュメントと実際の導入からの洞察を参照しながら説明します。DocuSign を統合する企業にとって、これらのニュアンスを理解することで、ワークフローの中断を防ぎ、監査対応のプロセスを確保できます。

DocuSign API 受信者管理の基礎

送信後に CC 受信者を追加する前に、DocuSign のエンベロープライフサイクルを理解することが重要です。エンベロープはドキュメントパッケージを表し、「送信」されるとアクティブになり、署名者のエクスペリエンスと法的完全性を保護するために変更が制限されます。eSignature REST API（v2.1）はこれらのインタラクションを管理し、安全なアクセスのために JWT または OAuth による認証が必要です。

重要な概念：

• 受信者：署名者、承認者、および CC が含まれます。CC は、受信者オブジェクトの carbonCopies 配列に追加されます。
• エンベロープステータス：送信後、エンベロープは「sent」または「delivered」ステータスになります。変更には制限があります。アクションを必要とする署名者を追加することはできませんが、CC は署名順序を変更しないため許可されています。
• API エンドポイント：更新には /envelopes/{envelopeId}/recipients を使用します。

ビジネスの観点から見ると、DocuSign の API の価格は、Starter プランの年間 600 ドルから始まり、月あたり最大 40 個のエンベロープをサポートしており、小規模な統合に適していますが、大量の需要にはコストがかかります。

ステップバイステップガイド：送信後に CC 受信者を追加する

送信後に CC を追加するには、直接送信後の追加が常に簡単ではないため、correct モードまたは void-and-resend の回避策を使用する必要があります。DocuSign は受信者を事前に計画することを推奨していますが、条件付きビジネスロジックに基づいてマネージャーを追加するなど、動的なシナリオの場合は、次の手順に従ってください。このプロセスでは、開発者アカウントと API アクセストークンを持っていることを前提としています。

前提条件

1. API 設定：DocuSign SDK（Java、.NET、PHP など用）を統合するか、生の REST 呼び出しを使用します。統合キーとユーザー ID を使用して認証します。
2. エンベロープ ID：最初の送信応答から ID を取得します（例：/envelopes POST を使用）。
3. 権限：アカウントでエンベロープの修正が許可されていることを確認します（[管理] 設定の [機能] で有効にします）。
4. エンベロープステータスチェック：/envelopes/{envelopeId} をクエリして、「sent」ステータスであり、署名者が変更をロックするアクションを完了していないことを確認します。

ビジネスヒント：企業の場合、Advanced API プラン（年間 5,760 ドル）は、完了時に CC に自動的に通知できる Bulk Send や webhook などの機能をアンロックします。

方法 1：エンベロープの修正を使用する（小規模な変更に推奨）

DocuSign の「修正」機能を使用すると、エンベロープを無効にすることなく進行中の変更が可能になり、CC の追加に適しています。

1. 修正を開始する：

   • /envelopes/{envelopeId}/correct に PUT し、本文は次のとおりです。

     {
       "clientUserId": "optional_client_id",
       "correctInProgress": true
     }
     

     これにより、エンベロープが一時的に一時停止されます。

2. CC 受信者を追加する：

   • CC の詳細を含む /envelopes/{envelopeId}/recipients に POST します。

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // 例：「CC1」
           "routingOrder": 0  // CC は順序に影響しません
         }
       ],
       "resendEnvelope": false  // まだ通知を再送信しないでください
     }
     

     • recipientId は一意である必要があります。既存の受信者との競合を避けてください。
     • オプション：パスワード保護された CC アクセスを実現するために accessControl を追加します。

3. 再送信または通知：

   • もう一度 /envelopes/{envelopeId}/correct に PUT して再開します。

     {
       "resendEnvelope": true  // 新しい CC のメールをトリガーします
     }
     

     エンベロープが完了したか、要求に応じて、CC はコピーを受信します。

潜在的な落とし穴：エンベロープが「completed」の場合、修正できません。Connect 機能（Advanced プラン）を使用して webhook でステータスを監視します。

方法 2：無効にして再送信する（複雑なシナリオの場合）

修正が実行不可能な場合（署名者のアクションなど）、エンベロープを無効にして、新しい CC で再作成します。

1. エンベロープを無効にする：

   • /envelopes/{envelopeId} に PUT します。

     {
       "status": "voided",
       "voidedReason": "Adding CC recipient"
     }
     

2. CC で再作成する：

   • 元のペイロードに加えて、recipients オブジェクトに CC を含めて、/envelopes に POST します。

     {
       "emailSubject": "Updated Document",
       "documents": [/* original docs */],
       "recipients": {
         "signers": [/* original signers */],
         "carbonCopies": [
           {
             "email": "cc@example.com",
             "name": "John Doe",
             "recipientId": "CC1"
           }
         ]
       },
       "status": "sent"
     }
     

3. 元の署名者に通知する：各署名者に対して /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend を使用して再開します。

ビジネス上の観察：この方法では、追加のエンベロープ使用コストが発生します（例：Business Pro ではユーザーあたり年間約 100 個のエンベロープ、480 ドル/ユーザー/年）。したがって、低容量の修正に適しています。API を使用してダッシュボードでクォータを追跡して管理します。

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

• エラー処理：一般的なエラーには、400（無効な受信者）または 403（権限の不足）が含まれます。常に最初に /envelopes/{envelopeId}/recipients GET を使用して検証します。
• テスト：DocuSign の Developer Sandbox（無料）を使用して、本番エンベロープを消費せずにシミュレートします。
• コンプライアンス：CC の追加は監査証跡を維持し、ESIGN/UETA 基準に準拠していますが、紛争を避けるために理由を記録します。
• 自動化の代替手段：頻繁な送信後のニーズについては、API 変更ではなく、外部通知をトリガーするために webhook（Advanced プラン）を統合します。

実際には、企業はこれらの操作を SDK スクリプトで実行することで 20〜30％ の効率向上が得られると報告していますが、大規模な操作の場合は、無制限の調整のために Enterprise カスタムプランを検討してください。

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

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

👉 無料トライアルを開始

DocuSign と主要な競合他社との比較

バランスの取れた視点を提供するために、DocuSign の API 機能を、Adobe Sign、eSignGlobal、および HelloSign（現在は Dropbox Sign）などの代替手段と比較してみましょう。この表は、2025 年の公開データに基づいており、価格設定、受信者管理、および地域の強みを強調して、企業がベンダーの選択で意思決定を行うのに役立ちます。

この比較は、DocuSign が成熟した API の深さで優れていることを示していますが、コストが高くなっています。一方、競合他社は特定のセグメントに柔軟性を提供しています。

Adobe Sign の焦点

Adobe Sign は Adobe Document Cloud の一部であり、受信者管理のためのシームレスな API を提供し、その「Amend」API エンドポイントによる送信後の CC 追加を容易にします。価格設定は競争力があり、基本版は月額 10 ドル/ユーザーから始まり、Enterprise カスタムに拡張されます。Adobe スイートにすでに含まれている企業に適しており、強力な PDF 処理とグローバルコンプライアンスを提供しますが、APAC の遅延が問題になる可能性があります。

eSignGlobal の焦点

eSignGlobal は、グローバルプレーヤーとして位置付けられており、100 以上の主要国でコンプライアンスを遵守しており、特にアジア太平洋 (APAC) 地域で強力な存在感を示しています。APAC の電子署名環境は断片化されており、高い基準と厳格な規制があります。米国/EU のフレームワークのような ESIGN/eIDAS とは異なり、APAC には「エコシステム統合」ソリューションが必要です。これは、政府のデジタル ID (G2B) との深いハードウェア/API レベルのドッキングを意味し、これは西洋で一般的なメール検証や自己申告モデルをはるかに超える技術的なハードルです。eSignGlobal は、香港の iAM Smart やシンガポールの Singpass などのネイティブ統合を通じてこの問題に対処し、追加費用なしで法的有効性を確保します。

価格設定は手頃な価格で、Essential プランは年間月額 16.6 ドルで、最大 100 個のドキュメント署名、無制限のユーザーシート、およびアクセスコード検証が可能です。このコンプライアンス指向の価値により、特に TCO の削減を目指す国境を越えたチームにとって、DocuSign および Adobe Sign との競争において競争力があります。

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

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

👉 無料トライアルを開始

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

API 駆動のワークフローをナビゲートする企業にとって、DocuSign は依然として信頼できる選択肢ですが、送信後の変更には慎重な計画が必要です。代替手段の台頭に伴い、地域のニーズを検討してください。eSignGlobal は、APAC 志向の操作の中立的でコンプライアンス志向のオプションとして際立っています。容量、統合、および地理的な場所に基づいて評価し、最適な一致を実現してください。