DocuSign API: 処理中のエンベロープの有効期限を更新する方法

DocuSign API におけるエンベロープ管理の理解

デジタル契約が急速に進化する世界において、進行中の（または「飛行中の」）エンベロープの管理は、電子署名ワークフローの重要な側面です。企業は、署名者の応答の遅延、交渉の長期化、またはプロジェクトのスケジュール変更により、エンベロープの有効期限を調整する必要がある状況に頻繁に直面します。DocuSign の API は、これを実現するための強力なツールを提供し、開発者はプロセスを中断することなく、コンプライアンスと効率を維持できます。この記事では、DocuSign API を使用して飛行中のエンベロープの有効期限を更新する方法を検討するとともに、電子署名市場のビジネスの観点からバランスの取れた視点を提供し、その影響と代替案について議論します。

飛行中のエンベロープで有効期限を更新する理由

DocuSign エンベロープの有効期限は、設定された期間後に署名されていないドキュメントを自動的に無効にし、機密情報を保護し、タイムリーな完了を保証する安全対策として機能します。ただし、現実世界のビジネス運営では、厳格な締め切りにより、不要な失効が発生し、再送信が必要になる可能性があり、管理上のオーバーヘッドと潜在的なコストが増加します。ビジネスの観点から見ると、API を介してこれらの日付を延長する機能は、リソースの割り当てを最適化し、エンベロープの数量料金（未使用のエンベロープも割り当てにカウントされます）を削減し、署名者の満足度を高めるのに役立ちます。これらは、不動産、人事、金融などの高容量業界における重要な要素です。

DocuSign の設計では、セキュリティと監査可能性が優先されるため、飛行中のエンベロープの有効期限の更新は必ずしも簡単ではありません。作成後のコアエンベロープ属性の直接的な変更は、改ざんを防ぐために制限されています。代わりに、API は、修正または無効化して再作成するなどの間接的な方法をサポートします。このアプローチは、米国の ESIGN 法や EU の eIDAS 規格などのコンプライアンスに対する DocuSign の重視と一致しており、変更が法的な弁護のために記録されることを保証します。

ステップバイステップガイド：DocuSign API を介して有効期限を更新する

この問題に対処するために、開発者は通常、DocuSign eSignature REST API（バージョン 2.1 以降）を使用します。これには、OAuth 2.0（JWT または承認コード付与）による認証が必要です。API アクセス権を持つ開発者アカウントがあると仮定します。価格は Starter プランの年間 600 ドルからで、月あたり約 40 個のエンベロープが含まれます。以下に、実用的な演習を示します。

1. エンベロープステータスの取得

まず、エンベロープが飛行中の状態（ステータス：「sent」または「in progress」）であることを確認します。GET /accounts/{accountId}/envelopes/{envelopeId} エンドポイントを使用します。

リクエストの例 (cURL):

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

レスポンススニペット:

{
  "status": "sent",
  "expireDateTime": "2025-01-15T12:00:00Z",
  "envelopeId": "abc123"
}

これにより、現在の有効期限が取得されます。ステータスが「voided」または「completed」の場合、更新できません。エンベロープを再作成する必要があります。

2. エンベロープの修正（小規模な変更に推奨される方法）

署名者がまだ操作を行っていない飛行中のエンベロープの場合は、PUT /accounts/{accountId}/envelopes/{envelopeId} を修正リクエストと組み合わせて使用します。有効期限を更新するために個々のフィールドを直接編集することはサポートされていませんが、無効にして新しい日付で再送信するか、「修正」機能を使用してタイマーを間接的にリセットできます。

DocuSign の修正 API を使用すると、署名が発生していない場合に、有効期限などの特定の属性を変更できます。修正エンベロープ定義を準備します。

修正リクエストボディ (JSON):

{
  "status": "sent",
  "expireAfter": "30",  // 現在からの日数。必要に応じて調整（最大 999 日）
  "expireDateTime": "2025-02-15T12:00:00Z"  // または絶対日付を指定
}

cURL の例:

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/correct" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "clientUserId": "signer1",
  "routingOrder": "1",
  "corrector": {
    "email": "admin@company.com",
    "userId": "{userId}"
  },
  "envelopeDefinition": {
    "expireAfter": "60"
  }
}'

これにより、有効期限が 60 日延長されます。注：修正には、エンベロープが修正可能であること（完了したタブがないこと）が必要であり、変更を署名者に通知して、監査証跡を保持する場合があります。

3. 無効化して再送信（複雑な更新の場合）

エンベロープに部分的な進行状況がある場合、または直接編集がブロックされている場合は、まず無効にしてから、更新された有効期限で再作成します。これは、コンプライアンスリスクを回避するために、企業ワークフローでは一般的です。

ステップ 3a: エンベロープの無効化

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "status": "voided",
  "voidedReason": "Extending expiration for ongoing negotiations"
}'

ステップ 3b: 新しい定義で再送信 POST /accounts/{accountId}/envelopes を使用して再作成し、元のドキュメントと受信者をコピーしますが、新しい expireAfter または expireDateTime を設定します。

新しいエンベロープリクエストボディ:

{
  "emailSubject": "Updated Agreement",
  "documents": [ /* 元のドキュメント */ ],
  "recipients": [ /* 元の署名者 */ ],
  "expireAfter": "90",  // 新しい 90 日の有効期限
  "status": "sent"
}

cURL:

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{ /* 更新された有効期限を含む完全なエンベロープ定義 */ }'

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

• 割り当てとコスト： 無効化/再送信ごとに、エンベロープの制限にカウントされます（Business Pro プランでは、ユーザーあたり年間約 100 個で、価格はユーザーあたり年間 480 ドルです）。API を介してダッシュボードを使用して監視し、超過を回避します。
• エラー処理： 一般的な問題には、400 Bad Request（無効なステータス）または 401 Unauthorized が含まれます。コードで try-catch（Node.js や Python SDK など）を使用します。
• セキュリティ： すべての変更はエンベロープの監査証跡に記録され、SSO や Enhanced プランの高度なアクセス制御など、DocuSign の IAM 機能をサポートします。
• テスト： サンドボックス環境（開発者向け無料）は、本番環境の前に理想的です。

ビジネスの観点から見ると、このプロセスは運用を簡素化しますが、API の価格階層が強調されます。Advanced プラン（年間 5760 ドル）では、一括送信と自動化のための webhook がロック解除され、手動による介入が削減されます。

DocuSign や Adobe Sign などの電子署名プラットフォームを比較していますか？

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

👉 無料トライアルを開始

DocuSign のより広範なエコシステムと IAM 機能

DocuSign の eSignature プラットフォーム（API を含む）は、セキュリティを強化するために、ID およびアクセス管理 (IAM) ツールとシームレスに統合されています。DocuSign の IAM には、SSO 統合（Okta や Azure AD など）、ロールベースのアクセス制御、および多要素認証が含まれており、これらはエンタープライズレベルのデプロイメントに不可欠です。これらの機能は Enhanced プランで利用でき（50 人以上のユーザー向けのカスタム価格設定）、有効期限の変更などの API 駆動の更新が、機密データを公開することなく、グローバルスタンダードに準拠していることを保証します。価格は Personal プランの年間 120 ドルからエンタープライズカスタムプランまでで、DocuSign はスケーラビリティを重視していますが、SMS 配信や ID 検証などの追加機能には追加料金が発生する場合があります。

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

電子署名市場は競争が激しく、DocuSign はグローバルな採用においてリードしていますが、地域的なニーズが代替案を推進しています。以下は、価格、機能、およびコンプライアンスに基づく主要なプラットフォームの中立的な比較です（2025 年のデータ。実際の値は異なる場合があります）。

この表は、強力な API 機能における DocuSign の卓越性を示していますが、成長中のチームにとってはより高価になる可能性があり、他のプラットフォームは柔軟性を提供しています。

Adobe Sign：PDF 中心のアプローチ

Adobe Sign は Adobe Document Cloud の一部であり、Acrobat などの PDF ツールとの深い統合により際立っており、ドキュメント集約型のワークフローに最適です。DocuSign と同様の API 更新をサポートしており、プロトコルの変更に使用するエンドポイントがありますが、有効期限の変更には通常、プロトコルの改訂が必要です。価格は競争力があり、個人版は月額 10 ドルで、エンタープライズカスタムプランまで拡張され、条件付きフィールドや支払いなどの機能があります。ただし、クリエイティブ業界では輝きを放っていますが、Adobe ユーザー以外にはバンドルされているように感じられる場合があります。

HelloSign：中小企業向けのシンプルさ

HelloSign（現在は Dropbox Sign）は、ユーザーフレンドリーなインターフェイスを優先し、迅速なテンプレート作成と高階層での無制限の送信を備えています。その API は、更新呼び出しによる有効期限の延長など、エンベロープの修正を許可しますが、DocuSign の一括操作の深さがありません。エントリー価格は月額 15 ドルで、中小企業に適しており、エンタープライズコンプライアンスではなく、シームレスな Dropbox 同期に重点を置いています。

eSignGlobal：地域コンプライアンスのリーダー

eSignGlobal は、100 以上の主要な国と地域でコンプライアンスを遵守し、アジア太平洋地域で強力な存在感を示すグローバルな競争相手としての地位を確立しています。この地域の規制は断片的で、基準が高く、監督が厳しく、米国/EU のフレームワークのような ESIGN/eIDAS とは異なり、アジア太平洋地域では「エコシステム統合」ソリューションが必要です。これは、西洋で一般的な電子メール検証や自己申告モードをはるかに超えて、政府のデジタル ID (G2B) との深いハードウェア/API 統合を意味します。eSignGlobal はこの分野で優れており、香港の iAM Smart とシンガポールの Singpass をシームレスに統合して、法的に拘束力のある署名を実現しています。

価格は競争力があり、その Essential プランは年間請求額が月額わずか 16.6 ドルで、最大 100 件の電子署名ドキュメント、無制限のユーザーシート、およびアクセスコード検証を許可します。これらはすべてコンプライアンスに基づいて構築されています。この座席料金なしのモデルは、チームに高い価値を提供し、リスク評価と翻訳のための AI ツールを備えています。米国/EU への拡大に伴い、eSignGlobal は、追加の開発者プランを必要としない一括送信を含め、より低コストでより高速なアジア太平洋地域のパフォーマンスを通じて、DocuSign や Adobe Sign などの既存のプレーヤーに挑戦しています。

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

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

👉 無料トライアルを開始

ビジネスの洞察と最終的な考察

API を介した飛行中のエンベロープの管理は、電子署名分野のより広範な傾向を反映しています。自動化は効率を推進しますが、コンプライアンスとコストが選択を決定します。DocuSign の API は更新には非常に強力ですが、その座席ベースのモデルとアジア太平洋地域での課題により、代替案の検討が促されます。

DocuSign の代替案を探しているユーザーにとって、eSignGlobal は、特にグローバルなニーズとコスト削減のバランスをとるアジア太平洋地域の運用にとって、中立的で地域に準拠したオプションとして際立っています。ワークフローの量と地理的な場所に基づいて評価してください。