DocuSign API: プレフィルドタブ付きのテンプレートからエンベロープを送信する

DocuSign API を使用してドキュメントワークフローを効率化する

ペースの速いデジタルビジネス運営の世界では、DocuSign のような電子署名プラットフォームは、契約管理を自動化し、事務処理を削減するための不可欠なツールとなっています。DocuSign API は、特にテンプレートを使用してエンベロープ（署名準備ができたドキュメントパッケージに対する DocuSign の用語）を、事前に入力されたタブ付きで送信する際の、複雑なワークフローを処理する能力において際立っています。この機能は時間を節約するだけでなく、販売チームや法務部門のような大量の環境でのエラーを最小限に抑えます。ビジネスの観点から見ると、このような API を統合することで、ドキュメント処理時間を最大 80% 削減できるという調査結果が示すように、効率が大幅に向上します。

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

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

👉 無料トライアルを開始

DocuSign API の習得：テンプレートからエンベロープを送信する

DocuSign eSignature API は、企業が署名機能をアプリケーションに直接組み込むことを可能にする強力な開発者ツールです。その中心となる「エンベロープ」は、署名、承認、またはその他のアクションのためにルーティングできる 1 つまたは複数のドキュメントのコンテナです。DocuSign のテンプレートは、ドキュメントのレイアウト、フィールド（タブと呼ばれる）、およびワークフローを事前に定義するため、オンボーディングや請求書の承認などの反復タスクに最適です。

事前に入力されたタブとは、エンベロープを送信する前に、テキストボックス、日付、またはチェックボックスなどのこれらのフィールドにデータを入力することを指します。これは、受信者の情報がわかっている場合に特に役立ち、よりスムーズな署名エクスペリエンスを保証します。企業にとって、この機能は Salesforce などの CRM システムや ERP ツールとシームレスに統合され、自動データ抽出を可能にします。

API を介してこれを実現するために、開発者は通常、RESTful エンドポイントを使用し、認証は OAuth 2.0 または JWT 認証を介して処理されます。DocuSign の開発者サンドボックスは無料のテスト環境を提供しており、これは本番環境のコストを発生させることなく統合を反復する企業にとって不可欠です。

API 統合の前提条件

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

• DocuSign 開発者アカウント（無料登録）。
• 認証用の統合キー（アプリ ID）と API トークン。
• API がこの形式で通信するため、JSON ペイロードに精通していること。
• HTTP リクエストを簡素化する、お好みの言語の DocuSign SDK（例：Java、.NET、Python）。

企業は API の価格層も考慮する必要があります。Starter プランは年間 600 ドルで、月あたり最大 40 個のエンベロープをサポートし、小規模な統合に適しています。一方、Advanced プランは年間 5,760 ドルで、大規模な操作に適した一括送信と webhook をアンロックします。

事前に入力されたタブでエンベロープを送信するためのステップバイステップガイド

ステップ 1：テンプレートの作成または取得

まず、DocuSign Web アプリケーションでテンプレートをアップロードするか、API を介してアップロードします。テンプレートには、ドキュメントと、その上に配置されたタブが含まれます。タブは次のように分類されます。

• テキストタブ：名前、住所などに使用されます。
• 日付タブ：現在の日付またはカスタム値を自動的に入力します。
• チェックボックスタブ：契約に使用されます。
• イニシャル/署名タブ：署名者のアクションに使用されます。

Templates API を使用して既存のテンプレートを一覧表示します。

GET /restapi/v2.1/accounts/{accountId}/templates

これにより、テンプレートの JSON 配列が返されます。後続のステップで使用するために templateId をメモしておきます。

ステップ 2：エンベロープ定義の準備

テンプレートを参照するエンベロープオブジェクトを構築します。ペイロードに受信者データとタブの値を含めることで、タブを事前に入力します。

以下は、エンベロープを作成する JSON の例です（Node.js と DocuSign SDK を使用して説明します）。

const dsApi = new docusign.ApiClient();
dsApi.setBasePath('https://demo.docusign.net/restapi');
const envelopesApi = new docusign.EnvelopesApi(dsApi);

const envelopeDefinition = new docusign.EnvelopeDefinition();
envelopeDefinition.emailSubject = 'このドキュメントに署名してください';
envelopeDefinition.status = 'sent'; // オプション：'created'、'sent'、'delivered'

// テンプレートを参照する
const template = new docusign.TemplateReference();
template.templateId = 'your-template-id';
template.roleName = 'Signer1'; // テンプレートの役割と一致する
envelopeDefinition.templateReferences = [template];

// 受信者を定義し、タブを事前に入力する
const signer = new docusign.TemplateRole();
signer.roleName = 'Signer1';
signer.email = 'recipient@example.com';
signer.name = 'John Doe';
signer.clientUserId = '1000'; // 必要に応じて埋め込み署名用

// タブを事前に入力する（テンプレートからのタブ）
const textTab = new docusign.Text();
textTab.tabLabel = 'FullName'; // テンプレートのタブと一致する
textTab.value = 'John Doe';
signer.tabs = new docusign.Tabs();
signer.tabs.textTabs = [textTab];

const dateTab = new docusign.Date();
dateTab.tabLabel = 'AgreementDate';
dateTab.value = new Date().toISOString().split('T')[0];
signer.tabs.dateTabs = [dateTab];

envelopeDefinition.templateRoles = [signer];

const results = await envelopesApi.createEnvelope(accountId, { envelopeDefinition });
console.log(`Envelope ID: ${results.envelopeId}`);

このコードは、テンプレートからエンベロープを作成し、「FullName」テキストタブを「John Doe」で事前に入力し、日付タブを今日の日付で入力します。tabLabel は、テンプレート内のタブに割り当てられたラベルと完全に一致する必要があります。

ステップ 3：認証を処理して送信する

JWT またはアクセストークンを使用して認証します。本番環境では、アカウントのリージョンに応じて、NA1（米国）または EU1（ヨーロッパ）のベースパスを使用します。以下を使用してエンベロープを送信します。

const accessToken = await getJwtToken(); // 認証関数
dsApi.addDefaultHeader('Authorization', `Bearer ${accessToken}`);

一括シナリオの場合、Advanced API プランは月あたり最大 100 個のエンベロープをサポートし、データベースなどの外部ソースからデータを事前に入力します。

ステップ 4：ステータスの監視と取得

送信後、webhook（Advanced プランの Connect 機能）または /envelopes/{envelopeId} エンドポイントをポーリングしてステータスを追跡します。これはビジネスワークフローにとって不可欠であり、監査証跡の要件への準拠を保証します。

一般的な課題と解決策

• タブのマッチングエラー：タブが一意であり、正しく参照されていることを確認します。最初に Template API を使用してタブの詳細を取得します。
• 受信者のルーティング：複数の署名者のエンベロープの場合、テンプレートで役割を割り当て、API 呼び出しでそれらをマッピングします。
• 制限：標準プランでは、自動送信は年間約 100 個/ユーザーに制限されています。API プランにはエンベロープの割り当てがあります。
• エラー処理：API 応答にはエラーコードが含まれます（例：400 は無効なタブを示します）。一時的な問題に対する再試行を実装します。

ビジネスの観点から見ると、この API 統合により手動データ入力が 70% 削減される可能性がありますが、企業はコスト（認証などの API アドオンには従量課金が発生します）を検討する必要があります。

DocuSign のより広範なエコシステムを探索する

DocuSign は基本的な電子署名を超えて拡張され、Intelligent Agreement Management (IAM) CLM などの製品を提供しています。これは、契約ライフサイクル管理ソリューションです。IAM CLM は、起草から交渉、更新まで、契約プロセス全体を自動化し、条項分析に AI を統合します。これはエンタープライズカスタム価格設定であり、SSO や高度な分析機能を含む Enhanced プランから始まります。これにより、エンドツーエンドのコンプライアンスを必要とする中規模から大規模の企業に適しています。

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

電子署名市場は競争が激しく、DocuSign はグローバルな採用においてリードしていますが、専門的な利点を提供する競合他社に直面しています。Adobe Sign は、Adobe Creative Suite とのシームレスな統合を強調しており、ドキュメント集約型のワークフローに適しています。API を介して事前に入力されたフォームをサポートし、米国の ESIGN/UETA およびヨーロッパの eIDAS に準拠しています。価格設定は個人向けに月額 10 ドルから始まり、モバイル署名や支払い収集などの機能を含むエンタープライズカスタムプランに拡張されます。

eSignGlobal は、特にアジア太平洋地域 (APAC) で、地域の大国としての地位を確立しています。APAC では、電子署名規制が断片化され、高水準であり、厳しく規制されています。米国 (ESIGN 法) またはヨーロッパ (eIDAS) のフレームワーク標準とは異なり、後者は電子メール検証または自己申告に依存していますが、APAC では「エコシステム統合」コンプライアンスが必要です。これには、政府から企業 (G2B) のデジタル ID との深いハードウェア/API レベルの統合が含まれ、技術的な障壁を西洋モデルよりも大幅に高くしています。eSignGlobal は、100 の主要なグローバル国および地域のコンプライアンスをサポートしており、香港とシンガポールのローカルデータセンターを通じて APAC での優位性を持っています。香港の iAM Smart およびシンガポールの Singpass とネイティブに統合されており、強力な認証を可能にしています。価格設定はよりアクセスしやすくなっています。Essential プランは月額 16.6 ドルで、電子署名のために最大 100 個のドキュメントを送信でき、無制限のユーザーシート、およびアクセスコードによるドキュメント/署名検証が可能です。コンプライアンスの基盤で強力な価値を提供します。eSignGlobal は、アメリカ大陸とヨーロッパを含むグローバルに拡大しており、DocuSign および Adobe Sign の競争力のある代替手段として、わずかに低いコストとより高速な地域パフォーマンスを備えています。

HelloSign（現在は Dropbox の一部）は、SMB のシンプルさに焦点を当てており、DocuSign と同様のテンプレートと事前入力 API サポートを提供していますが、開始コストが低くなっています（月額 15 ドル/ユーザー）。Google Workspace との統合に優れていますが、基本プランには一括送信などの高度なエンタープライズ機能がありません。

この表は、中立的なトレードオフを強調しています。DocuSign は規模向け、Adobe は設計ワークフロー向け、eSignGlobal は APAC の効率向け、HelloSign は使いやすさ向けです。

グローバル電子署名の規制のニュアンス

見出しは API メカニズムに焦点を当てていますが、規制を理解することで実装を向上させることができます。米国では、ESIGN 法と UETA は、ほとんどの商取引にウェット署名と同等の法的効力を提供します。ヨーロッパの eIDAS フレームワークでは、高保証のニーズには適格な電子署名が必要です。APAC は異なります。シンガポールの電子取引法は eIDAS と一致していますが、政府関連の事務には Singpass が必要であり、香港の条例では iAM Smart による安全な認証が強調されています。DocuSign API を使用する企業は、これらの基準を満たすために、監査ログなどのコンプライアンスフィールドに準拠するようにタブを構成する必要があります。

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

API 駆動の自動化を優先する企業にとって、DocuSign は成熟したエコシステムを備えているため、依然として堅実な選択肢です。ただし、特に APAC の地域コンプライアンスのニーズについては、eSignGlobal などの代替手段は、グローバルなカバレッジを犠牲にすることなく、調整された費用対効果の高いオプションを提供します。最適な一致を実現するために、規模、統合、および地理的な場所に基づいて評価します。