DocuSign API：JSONで「リマインダー」と「有効期限」を設定する方法

DocuSign API を使用したエンベロープ管理の理解

電子署名ソリューションの競争環境において、DocuSign の API は、開発者が自動化されたワークフローをビジネスプロセスに統合するための基礎であり続けています。企業がデジタルオペレーションを拡大するにつれて、リマインダーと有効期限の機能は、手動による監視なしにドキュメントがタイムリーに完了することを保証する上で重要な役割を果たします。この記事では、公式ドキュメントと実際の導入事例を参照しながら、JSON を介して DocuSign API でこれらの設定を構成する方法について説明します。ビジネスの観点から見ると、これらの API 要素を習得することで、契約サイクルを最適化し、管理上の負担を軽減し、高容量環境でのコンプライアンスを向上させることができます。

DocuSign や Adobe Sign と同様の電子署名プラットフォームを比較検討していますか？

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

👉 無料トライアルを開始

DocuSign API でのリマインダーと有効期限の設定：ステップバイステップガイド

DocuSign の eSignature API を使用すると、開発者はリマインダーと有効期限のルールをエンベロープ作成リクエストに直接埋め込むことができます。これらの機能は、フォローアップを自動化し、ドキュメントが無期限に保留されるのを防ぐため、ビジネスの自動化に不可欠です。これにより、営業、人事、または法務チームのリソースを占有する可能性があります。リマインダーは、ドキュメントが署名されていない場合に設定された間隔で署名者に通知し、有効期限は指定された期間後にエンベロープを無効にし、ワークフローの効率を確保します。

API 統合の前提条件

JSON ペイロードに入る前に、以下があることを確認してください。

• API アクセス権を持つ DocuSign 開発者アカウント（開発者センターから入手可能）。
• OAuth 2.0 または JWT を使用して設定された認証。安全な API 呼び出し用。
• Envelopes: create エンドポイント（POST /accounts/{accountId}/envelopes）に精通していること。

API は RESTful エンドポイントを使用し、すべての構成はリクエストの JSON 本文を介して渡されます。API の使用料金は DocuSign の開発者プランに該当し、エントリーレベルの年間 600 ドルから始まり、初期テストに適した基本的なエンベロープ割り当てが含まれています。

JSON を介したリマインダーの構成

リマインダーは、エンベロープ定義の reminders オブジェクトで定義されます。このオブジェクトは、頻度、最初のリマインダーまでの遅延、および試行回数を指定します。企業は、顧客契約や従業員のオンボーディングなどのシナリオで署名者を促し、放棄率を下げるためにこの機能を頻繁に使用します。

以下は、エンベロープ作成リクエストの JSON スニペットの例です。

{
  "status": "sent",
  "emailSubject": "このドキュメントに署名してください",
  "documents": [
    {
      "documentBase64": "BASE64_ENCODED_DOCUMENT_CONTENT",
      "name": "サンプル契約",
      "fileExtension": "pdf",
      "documentId": "1"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "John Doe",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ]
  },
  "reminders": {
    "reminderDelay": 2,  // 最初のリマインダーまでの日数（例：送信後 2 日）
    "reminderFrequency": "daily",  // オプション：daily、weekly、monthly
    "reminderOffset": 1,  // リマインダー間の日数
    "reminderMaxAttempts": 5  // 送信されるリマインダーの合計数（例：5 回の試行）
  }
}

• reminderDelay：初期待機期間を日数で設定します。時間的制約のあるトランザクションの場合、1〜3 日の値が一般的です。
• reminderFrequency：間隔を規定します。緊急の場合は daily、標準契約の場合は weekly を使用します。
• reminderOffset：リマインダー間の間隔。ビジネスのリズムに合わせて調整します。
• reminderMaxAttempts：スパムを避けるために合計数を制限します。DocuSign はエンベロープの量に応じて 3〜7 回を推奨しています。

実装するには、この JSON を POST リクエストを介して Envelopes API に送信します。たとえば、cURL を使用します。

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-d '@envelope.json'

実際には、高度な API プラン（年間 5760 ドル）の企業は、より高い割り当ての恩恵を受け、バッチ送信で強力なリマインダーロジックを可能にします。サンドボックス環境でのテストにより、構成が規制対象業界の監査証跡などのコンプライアンス要件を満たしていることが保証されます。

JSON を介した有効期限の実装

有効期限は、期限後に署名されていないエンベロープを自動的に拒否し、API 割り当てを解放し、リソースの浪費を防ぎます。これは、ドキュメントが停滞する可能性のある高速販売パイプラインで特に価値があります。

expireAfter および expireNotify 設定は、エンベロープの最上位属性の下にネストされているか、特定の受信者の構成にネストされており、きめ細かい制御が可能です。

有効期限の JSON の例：

{
  "status": "sent",
  "emailSubject": "アクションが必要です：レビューと署名",
  "documents": [
    // ... (上記と同じ)
  ],
  "recipients": {
    "signers": [
      // ... (上記と同じ)
    ]
  },
  "expireAfter": "30",  // 有効期限までの日数（例：送信日から 30 日）
  "expireNotify": true  // 有効期限が切れたときに送信者にメールを送信するかどうか（true/false）
}

• expireAfter：日単位で指定します（1〜9999）。企業は、勢いを維持するために、緊急の契約に対してより短い期間（7〜14 日）を設定します。
• expireNotify：デフォルトは false です。有効にすると、送信者にフォローアップアクションを警告し、CRM システムとシームレスに統合します。

受信者レベルの有効期限（複数の署名者のワークフローで役立ちます）の場合は、署名者オブジェクトに埋め込みます。

"signers": [
  {
    "email": "signer@example.com",
    "name": "John Doe",
    "recipientId": "1",
    "routingOrder": "1",
    "expireAfter": "15",  // 署名者ごとの有効期限
    "expireNotify": "1"  // 送信者に通知（1 = はい、0 = いいえ）
  }
]

リマインダーと有効期限を組み合わせることで、包括的なライフサイクル管理戦略を作成できます。たとえば、30 日の有効期限に加えて、5 日後の毎日のリマインダーにより、業界のベンチマークに基づいて完了率が 20〜30％向上する可能性があります。これらの設定はエンベロープ割り当てを消費することに注意してください。標準プランでは〜100 エンベロープ/ユーザー/年に制限されているため、中間レベルの API ユーザー（年間 3600 ドル）は自動化されたワークフローの柔軟性を獲得できます。

ベストプラクティスと一般的な落とし穴

ビジネスの観点から見ると、リマインダーを過剰に構成すると、SMS/アドオン料金（メッセージごとに請求）が増加する可能性があり、有効期限が緩いと、シートベースの価格設定モデルでシートが占有される可能性があります。常に DocuSign の Swagger ドキュメントを使用して、JSON が API スキーマに準拠していることを確認してください。落とし穴には、タイムゾーンの不一致（グローバルチームは UTC を使用）や、より良い分析のためにカスタマイズできる拒否理由の無視などがあります。

アジア太平洋地域では、レイテンシとコンプライアンスが複雑さを増しており、API 統合では、コストが増加する可能性のある SMS 配信などの地域アドオンを考慮する必要があります。本番環境にデプロイする前に、DocuSign サンドボックスでサンプルペイロードを使用してテストすることをお勧めします。

この API 機能は、DocuSign の開発者フレンドリーなツールの強みを強調していますが、企業は自動化上限（〜10 個/ユーザー/月）を含む総コストを評価する必要があります。

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

電子署名がデジタルトランスフォーメーションの中核となるにつれて、DocuSign と Adobe Sign、eSignGlobal、HelloSign（現在は Dropbox Sign）などの代替品を比較すると、さまざまな利点が明らかになります。DocuSign はグローバル API の堅牢性で優れていますが、特に API を多用するユーザーの場合、価格設定のスケーラビリティが精査されています。Adobe Sign は Adobe エコシステムとの深い統合を提供し、クリエイティブワークフローに適しています。eSignGlobal はアジア太平洋地域向けにローカライズされたコンプライアンスを提供し、HelloSign は SMB にシンプルさを提供します。

主要なプレーヤーの概要

DocuSign：市場のリーダーであり、上記のリマインダーや有効期限を含む包括的な API 機能を提供しています。その強みは、エンタープライズレベルのセキュリティと統合にありますが、シートベースの価格設定はチームのアップグレードに負担をかける可能性があります。プラットフォームはより高いレベルで無制限のエンベロープをサポートしていますが、自動送信は制限されています。

Adobe Sign：Adobe のソリューションは、PDF ツールと Acrobat とのシームレスな統合を強調しており、ドキュメントを多用する業界に適しています。同様の API 制御を提供し、リマインダー（「notification」設定を介して）と有効期限（最大 999 日）を提供し、JSON ペイロードは DocuSign の構造をミラーリングします。価格設定は個人向けに 10 ドル/ユーザー/月から始まり、エンタープライズカスタム見積もりに拡張されます。米国のコンプライアンスで特に強力ですが、高度な API の使用には追加料金が発生する可能性があります。

eSignGlobal：このアジア太平洋地域に焦点を当てたプロバイダーは、100 の主要なグローバル国および地域のコンプライアンスをサポートしており、アジア太平洋地域で大きな利点があります。この地域の電子署名環境は断片化されており、高い基準と厳格な規制があります。これは、米国/EU のフレームワークスタイルの ESIGN/eIDAS とは対照的です。アジア太平洋地域では、「エコシステム統合」アプローチが必要であり、政府のデジタル ID（G2B）とのハードウェア/API レベルでの深い統合が必要です。これは、西洋で一般的な電子メール検証や自己申告モデルをはるかに超えています。eSignGlobal は、費用対効果の高いプランを通じて、アメリカ大陸やヨーロッパを含むグローバルで DocuSign や Adobe Sign と直接競合しています。その Essential バージョンはわずか 16.6 ドル/月（年間）で、最大 100 個のドキュメント署名、無制限のユーザーシート、およびアクセスコード検証を許可します。これらはすべて、コンプライアンスに準拠した高価値の基盤に基づいています。香港の iAM Smart やシンガポールの Singpass とシームレスに統合されており、データの所在地やレイテンシなどの地域の課題を解決しています。

HelloSign (Dropbox Sign)：Dropbox に買収され、ユーザーフレンドリーなインターフェイスとファイルストレージの連携を優先しています。API は JSON を介したリマインダーと有効期限をサポートしており、よりシンプルな割り当て（例：無料レベルで 20 エンベロープ/月）を提供しています。価格設定は Essentials で 15 ドル/月から始まり、小規模チームにアピールしますが、DocuSign と比較して、エンタープライズ API ニーズのスケーラビリティは低くなっています。

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

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

👉 無料トライアルを開始

Markdown 比較表

この表は、中立的なトレードオフを強調しています。DocuSign は深さ、Adobe は統合、eSignGlobal は地域の価値、HelloSign はアクセシビリティを提供します。

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

結論として、JSON を介して DocuSign の API でリマインダーと有効期限を構成すると、ビジネスオペレーションを合理化できますが、適切なプラットフォームの選択は、規模、地域、および予算によって異なります。DocuSign の代替品を探しているユーザーにとって、eSignGlobal はその地域のコンプライアンスと強力なグローバルプレゼンスで際立っています。