DocuSign API: データでタグを事前入力し、ユーザーが編集できるようにする方法

DocuSign API のナビゲート：事前入力されたタブでユーザー編集を有効にする

デジタルドキュメント管理の進化し続ける状況において、DocuSign のような電子署名プラットフォームは、企業がワークフローを合理化するための不可欠なツールとなっています。DocuSign API はその柔軟性で際立っており、開発者は署名エクスペリエンスを自動化およびカスタマイズできます。ドキュメントに事前入力されたデータを統合する際に、一般的な課題が発生します。それは、フィールド（または DocuSign の用語では「タブ」）が外部ソースから自動的に入力されるようにしながら、必要な調整に対応するために署名者が編集できるようにすることです。このバランスは効率を高めると同時に、ユーザーの制御を損なわないため、金融、不動産、人事などの業界にとって重要な機能となっています。

ビジネスの観点から見ると、この機能は手動でのデータ入力エラーを減らし、契約サイクルを加速させ、業界レポートによると、処理時間を最大 50% 短縮する可能性があります。ただし、実装には、フィールドを早期にロックすることを避けるために、API を慎重に処理する必要があります。

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

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

👉 無料トライアルを開始

DocuSign API での事前入力の習得：技術ガイド

DocuSign eSignature REST API v2.1 は、テキストボックス、チェックボックス、日付フィールドなど、ドキュメントに配置されたインタラクティブな要素であるタブを管理するための強力なツールを提供します。これらのタブを事前入力するには、エンベロープの作成中に API 呼び出しを介してデータを注入すると同時に、署名者が変更できるように属性を設定します。このアプローチは、初期データが CRM システムまたはフォームから取得されるが、署名者が詳細を確認または調整する必要があるシナリオに特に適しています。

重要な概念：タブとその属性

DocuSign のタブは、API ペイロードの signHere または text オブジェクトの tabs 配列で定義されます。事前入力するには、value 属性を使用しますが、編集を有効にするには、タブの documentId と pageNumber が正しく配置されていることを確認し、読み取り専用フラグを避けてください。重要なのは、locked または required 属性で明示的に設定しない限り、タブはデフォルトでロックされないことです。これにより、自然な編集が可能になります。

たとえば、販売契約では、データベースから購入者の名前を事前入力できますが、連絡先の詳細が変更された場合に修正を許可します。これにより、ユーザーをイライラさせ、ドキュメントの放棄につながる可能性のある、硬直したワークフローを防ぐことができます。

ステップバイステップの実装

1. 認証とエンベロープの準備： まず、OAuth 2.0 を介してアクセス トークンを取得します。/envelopes エンドポイントを使用してエンベロープを作成します。ドキュメントを base64 エンコードされたファイルとしてアップロードするか、既存のテンプレートを参照します。

   ペイロードのサンプル（JSON）：

   {
     "status": "sent",
     "emailSubject": "レビューして契約に署名してください",
     "documents": [
       {
         "documentBase64": "<base64-encoded-PDF>",
         "name": "Contract.pdf",
         "fileExtension": "pdf",
         "documentId": "1"
       }
     ],
     "recipients": {
       "signers": [
         {
           "email": "signer@example.com",
           "name": "John Doe",
           "recipientId": "1",
           "tabs": {
             "textTabs": [
               {
                 "tabLabel": "BuyerName",
                 "documentId": "1",
                 "pageNumber": "1",
                 "xPosition": "100",
                 "yPosition": "200",
                 "width": "150",
                 "height": "20",
                 "value": "API から事前入力された名前",  // フィールドを事前に入力します
                 "locked": "false",  // 編集可能であることを確認します
                 "required": "false"  // オプション; 必須の場合は true に設定します
               }
             ]
           }
         }
       ]
     }
   }
   

   ここで、value 属性はデータを注入し、locked: false（デフォルト）は署名者が編集できるようにします。座標（xPosition、yPosition）は、PDF 上のタブを正確に配置します。

2. テンプレートベースの事前入力の処理： テンプレート（/templates/{templateId}/envelopes 経由）を使用する場合は、まず GET リクエストを使用して /envelopes/{envelopeId}/documents/{documentId}/tabs にタブを抽出します。次に、応答を変更して tabLabel または位置を変更せずに value を追加します。更新されたエンベロープを送信します。この方法は、動的データを注入しながら構造を保持する再利用可能なフォームに適しています。

3. API 呼び出しの実行： ペイロードとともに /accounts/{accountId}/envelopes に POST を使用します。Node.js や Python の DocuSign SDK のようなライブラリは、このプロセスを簡素化します。

   # Python の例：docusign-esign ライブラリを使用
   from docusign_esign import ApiClient, EnvelopesApi, EnvelopeDefinition
   
   api_client = ApiClient()
   api_client.host = 'https://demo.docusign.net/restapi'  # ライブの場合は本番環境を使用
   envelopes_api = EnvelopesApi(api_client)
   
   envelope_definition = EnvelopeDefinition(
       status='sent',
       email_subject='署名してください',
       documents=[/* ドキュメント */],
       recipients=/* 上記のようなタブ付き */
   )
   
   results = envelopes_api.create_envelope(account_id, envelope_definition)
   

   Webhooks を使用して完了を監視し、編集が監査ログにキャプチャされるようにします。

4. 編集性のベストプラクティス：

   • 検証：送信前に validateTabs エンドポイントを使用して、タブの配置とデータの整合性を確認します。
   • 条件付きロジック：高度なケースでは、API を介して Business Pro 機能と統合して、ルールを適用します（たとえば、事前入力された値が条件を満たす場合にのみ編集可能なフィールドを表示します）。
   • エラー処理：事前入力が失敗した場合（たとえば、タブが一致しない場合）、API は 400 エラーを返します。これらを記録してデバッグします。
   • テスト：常に DocuSign 開発者サンドボックスを使用してください。エンベロープの割り当てに注意してください。Starter API プランでは、月あたり約 40 個が許可され、階層に応じて年間 5,760 ドルのプレミアム版まで拡張されます。

5. 一般的な落とし穴と解決策：

   • 過度のロック：タブが編集できない場合は、readOnly またはカスタム検証が適用されていないことを確認します。解決策：タブのプロパティで editable: true を明示的に設定します。
   • データのオーバーライド：署名者の変更は API 値をシームレスにオーバーライドしますが、コンプライアンスが必要な場合は、originalValue を介して追跡します。
   • 複数の署名者のシナリオ：recipientId でタブを割り当てます。関連する署名者のみを事前入力して、混乱を避けます。
   • コンプライアンスに関する注意：事前入力されたデータは、ESIGN Act（米国）または eIDAS（EU）などの規制に準拠している必要があり、監査証跡が編集をキャプチャしていることを確認します。

このプロセスは、基本的な統合では通常 10〜20 分で実装できますが、完全にカスタマイズすると複雑さが増します。企業は、DocuSign の事例研究によると、実装後に署名速度が 30〜40% 向上したと報告しています。

ビジネス環境でのメリット

編集可能なタブの事前入力は、オンボーディング、ローン申請、およびサプライヤー契約を合理化します。たとえば、不動産業界では、エージェントは MLS データから購入者の情報を自動的に入力し、現場での調整を許可できます。また、Salesforce などの CRM とうまく統合され、データのサイロ化を削減します。

DocuSign とそのエコシステムの概要

DocuSign は 2003 年以来、電子署名分野のリーダーであり、eSignature、CLM（契約ライフサイクル管理）、および API ツールを含む包括的なスイートを提供しています。その API はシームレスな統合を可能にし、1,000 を超えるアプリケーションをサポートしています。価格設定は個人版で月額 10 ドルから始まり、Business Pro ではユーザーあたり月額 40 ドルまで拡張され、API プランは年間 600 ドルから始まります。一括送信や認証などの高度な機能は、従量課金コストを追加するため、強力な自動化を必要とする企業に適しています。

DocuSign の IAM（ID およびアクセス管理）は、SSO と監査証跡を通じてセキュリティを強化し、CLM は契約交渉、抽出、および分析を自動化します。これは、大量の契約を処理する法務チームに最適です。

競争環境：Adobe Sign、eSignGlobal、および HelloSign

Adobe Sign：企業向けの統合

Adobe Sign は Adobe Document Cloud の一部であり、PDF 中心のワークフローで優れており、Acrobat と深く結びついています。DocuSign と同様の API を介して事前入力をサポートし、フィールドタグを使用して編集可能な入力を実現します。価格設定は個人向けでユーザーあたり月額 10 ドルから始まり、チーム向けでユーザーあたり月額 40 ドルまで、エンタープライズ版ではカスタム見積もりになります。利点には、AI 駆動のフォーム入力とモバイル署名が含まれますが、API 割り当ては大量の使用では制限される可能性があります。ESIGN や eIDAS などのグローバルスタンダードに準拠しており、クリエイティブでドキュメント集約型の業界に適しています。

eSignGlobal：アジア太平洋地域向けのグローバルプレーヤー

eSignGlobal は、グローバルに 100 の主要国でコンプライアンスを遵守し、特にアジア太平洋（APAC）地域で優れた汎用性の高い代替手段として位置付けています。APAC の電子署名の状況は断片的であり、高い基準と厳格な規制があります。これは、電子メール検証または自己申告に依存する、よりフレームワークベースの ESIGN（米国）または eIDAS（EU）モデルとは異なります。APAC では、「エコシステム統合」アプローチが必要であり、政府から企業（G2B）のデジタル ID との深いハードウェア/API 統合が必要です。これにより、技術的な障壁が西洋の基準をはるかに上回るレベルに引き上げられます。

eSignGlobal は、香港の iAM Smart やシンガポールの Singpass などのシステムをネイティブにサポートすることで、この問題に対処し、シームレスで準拠したワークフローを保証します。DocuSign や Adobe Sign と競合するためにヨーロッパとアメリカで積極的に拡大しており、競争力のある価格設定を提供しています。Essential プランは月額 16.6 ドルで、最大 100 件のドキュメントの送信、無制限のユーザーシート、およびアクセスコード検証が可能です。これは、シートごとの料金を請求せずに高い価値のコンプライアンスを提供します。このモデルは、金融や人事などの規制対象業界の拡張チームにアピールします。

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

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

👉 無料トライアルを開始

HelloSign（現在は Dropbox Sign）：SMB 向けの簡素化

HelloSign は 2019 年に Dropbox に買収され、ユーザーフレンドリーな署名に焦点を当てており、テンプレートを介して API による編集可能なフィールドの事前入力をサポートしています。迅速なセットアップと Google Workspace との統合で高く評価されています。価格設定は無料版（月あたり 3 件のドキュメント）から始まり、次に Essentials が月額 15 ドル、Premium がユーザーあたり月額 25 ドルまでです。ESIGN/UETA に準拠していますが、高度な IAM などの一部のエンタープライズレベルの機能が不足しているため、中小企業に適していますが、グローバルコンプライアンスのニーズには十分ではありません。

電子署名プラットフォームの並列比較

この表は、トレードオフを強調しています。DocuSign は成熟度でリードしており、代替手段はコストや地域への適合などのニッチな利点を提供しています。

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

電子署名プラットフォームの選択は、規模、地域、および統合のニーズによって異なります。DocuSign は、包括的な API 駆動型ワークフローにとって依然として信頼できる選択肢です。特に APAC の複雑な規制環境において、地域のコンプライアンスを重視する代替手段として、eSignGlobal はバランスの取れた費用対効果の高いオプションを提供します。効率とコンプライアンスを最適化するために、ビジネスの優先順位に基づいて評価してください。