DocuSign API：以程式方式新增「拒絕」原因註解

透過 DocuSign API 理解程式化拒絕原因

在數碼協議快速發展的世界中，像 DocuSign 這樣的電子簽名平台已成為企業簡化合約工作流程的必不可少工具。當簽署者需要拒絕文件時，一個常見挑戰是往往需要提供原因以用於審計和合規目的。透過 DocuSign API 程式化添加「拒絕」原因註釋，可以增強自動化功能，允許開發者將此功能整合到自訂應用程式中，而無需手動干預。此一能力對於管理高容量交易的企業特別有價值，在這些交易中，追蹤拒絕可以為流程改進提供資訊，並減少銷售或 HR 管道中的摩擦。

從業務角度來看，程式化啟用拒絕原因與 DocuSign 強調的強大審計追蹤和合規性相一致。它確保每個互動都被記錄，這在金融或醫療等受監管行業中至關重要。透過利用 API，組織可以自訂拒絕體驗，提示使用者提供特定回饋——例如「條款與預算不符」或「需要法律審查」——並直接將其附加到信封的狀態日誌中。這不僅提高了透明度，還為團隊提供了可操作的洞見，以優化範本或談判策略。

透過 DocuSign API 實現拒絕原因註釋

要程式化添加「拒絕」原因註釋，開發者通常使用 DocuSign 的 REST API，特別是 Envelopes API 端點。此過程涉及更新信封狀態並在拒絕操作期間附加註釋。以下是基於 DocuSign 開發者文件和企業整合中觀察到的最佳實務的逐步指南。

步驟 1: 認證並準備信封

首先透過 OAuth 2.0 獲取存取令牌，因為所有 API 呼叫都需要它。確保您的開發者帳戶設定在 Intermediate 或 Advanced 等方案下，這些方案支援信封修改（Starter 方案對進階功能有限制）。從初始建立請求中識別信封 ID。對於拒絕情境，您將使用 PUT /envelopes/{envelopeId} 端點來更新狀態。

在程式碼中，這可能看起來像這樣（使用 Python 和 DocuSign eSign SDK 以清晰為主）：

import docusign_esign as docusign

api_client = docusign.ApiClient()
api_client.host = "https://demo.docusign.net/restapi"  # 使用生產環境進行即時操作
api_client.set_default_header("Authorization", f"Bearer {access_token}")

envelopes_api = docusign.EnvelopesApi(api_client)
envelope_id = "your-envelope-id"

此設定認證您的會話，為信封互動做準備。

步驟 2: 定義帶原因的拒絕操作

DocuSign 允許簽署者透過標籤上的 decline 方法或整體信封來拒絕。要程式化添加原因，請將其納入註釋或備註欄位。使用 EnvelopeDefinition 或 RecipientUpdate 來觸發拒絕並附加註釋。關鍵是將 status 欄位設定為 “declined”，並在接收者的更新中結合 declineReason 參數。

對於程式化拒絕（例如，在自動化工作流程中模擬簽署者的操作），更新接收者：

from docusign_esign.models import RecipientUpdateRequest

update_request = RecipientUpdateRequest(
    recipient_id="1",  # 簽署者 ID
    status="declined",
    decline_reason="The proposed terms exceed our current fiscal constraints."  # 自訂原因
)

envelopes_api.update_recipients(envelope_id, update_request)

這將原因附加到信封的審計追蹤中。如果拒絕發生在客戶端（例如，透過嵌入式簽名），請在表單欄位中擷取原因，並透過 POST /envelopes/{envelopeId}/recipients/{recipientId}/decline 端點提交它，將原因作為請求體中的字串參數包含在內。

步驟 3: 處理註釋和審計整合

要使原因作為註釋可見，請將其連結到文件中的 Comment 標籤。在信封建立期間使用 SignHere 或 Note 組件中的 Tabs 陣列預配置標籤。在拒絕時，引用標籤 ID 來填充註釋：

from docusign_esign.models import Document, EnvelopeDefinition, Signer

# 在信封建立期間
signer = Signer(
    email="signer@example.com",
    name="John Doe",
    recipient_id="1",
    tabs=Tabs(
        comment_tabs=[CommentTab(
            tab_label="DeclineReason",
            document_id="1",
            page_number="1",
            x_position="100",
            y_position="100"
        )]
    )
)

envelope_definition = EnvelopeDefinition(
    email_subject="Please review and sign",
    documents=[Document(document_base64=base64_doc, name="contract.pdf", document_id="1")],
    recipients=Recipients(signers=[signer]),
    status="sent"
)

envelope_summary = envelopes_api.create_envelope(account_id, envelope_definition)

在拒絕時，透過 PUT /envelopes/{envelopeId}/tabs/{tabId} 使用原因文字更新註釋標籤值。這確保註釋出現在信封的歷史記錄中，可透過 GET /envelopes/{envelopeId}/audit_events 存取，用於報告。

步驟 4: 錯誤處理和最佳實務

常見陷阱包括配額限制——Advanced 方案每年每個使用者限制自動化發送約 100 次，因此透過 API 使用儀表板監控。始終驗證原因長度（最大 255 個字元）以避免拒絕。為了合規，確保原因被不可變地記錄，與美國 ESIGN 法案等標準一致。

建議在 DocuSign 開發者沙箱中測試，然後再投入生產。企業報告稱，此整合將手動跟進減少 30-40%，因為拒絕原因透過 webhook 饋送到像 Salesforce 這樣的 CRM 系統。然而，對於高規模使用，請考慮企業方案以獲得自訂配額。

限制和注意事項

雖然強大，但 API 在沒有標籤配置的情況下不支援即時拒絕原因。對於批量拒絕（例如，透過 Business Pro 中的 Bulk Send API），原因必須按接收者分批處理。定價影響：Intermediate API 方案每年從 3600 美元起（每月 100 個信封），針對重度自動化擴展成本。

這種程式化方法使開發者能夠建構彈性工作流程，但需要熟悉 DocuSign 的 SDK（適用於 Java、.NET 等）。對於 API 新手團隊，DocuSign 的支援資源或合作夥伴可以加速實施。

正在比較帶有 DocuSign 或 Adobe Sign 的電子簽名平台？

eSignGlobal 提供更靈活且成本效益更高的電子簽名解決方案，具有全球合規性、透明定價和更快的入職。

👉 開始免費試用

導航電子簽名競爭格局

電子簽名市場持續演變，DocuSign 領先，但面臨提供各種定價、合規性和整合選項的平台的競爭。從中立業務觀點來看，選擇解決方案取決於 API 靈活性、區域需求和成本結構等因素。下面，我們概述關鍵參與者，重點關注它們在拒絕處理等功能上的 API 能力。

DocuSign：成熟領導者

DocuSign 以其全面的 API 套件主導市場，支援如前所述的程式化拒絕。其電子簽名方案從個人版每月 10 美元到 Business Pro 每使用者每月 40 美元，API 附加組件從每年 600 美元起。優勢包括深度整合和全球覆蓋，儘管亞太地區延遲和基於座位的定價可能會增加大型團隊的成本。

Adobe Sign：企業級整合焦點

Adobe Sign 作為 Adobe Document Cloud 的一部分，在與 Acrobat 和 Creative Cloud 的無縫連接方面表現出色。對於 API 驅動的拒絕，它使用類似的 REST 端點來更新接收者狀態和原因，通常透過 Adobe 的 Experience Manager。定價從個人每月每使用者 10 美元起，擴展到企業自訂報價。它在創意工作流程中強大，但對於獨立電子簽名需求可能感覺捆綁過多。

eSignGlobal：針對亞太地區的挑戰者

eSignGlobal 將自己定位為成本效益高的替代方案，在全球 100 個主流國家合規，尤其在亞太地區（APAC）具有特別優勢。APAC 的電子簽名格局碎片化，具有高標準和嚴格法規，與美國/歐盟更基於框架的 ESIGN/eIDAS 模型形成對比。在這裡，解決方案需要「生態系統整合」方法，包括與政府對企業（G2B）數碼身份的深度硬體/API 整合——遠遠超過西方常見的簡單電子郵件或自我聲明方法。

eSignGlobal 在全球範圍內與 DocuSign 和 Adobe Sign 直接競爭，包括美洲和歐洲，透過提供更低的進入門檻。其 Essential 方案僅需每年 16.6 美元/月（年度計費），允許最多 100 個文件簽署、無限使用者座位，並透過存取碼驗證——同時保持合規。它與香港的 iAM Smart 和新加坡的 Singpass 無縫整合，使其成為區域跨境交易的理想選擇。這種設定為優先考慮速度和經濟性的團隊提供了高價值，而不犧牲安全性。

正在尋找 DocuSign 的更智能替代方案？

eSignGlobal 提供更靈活且成本效益更高的電子簽名解決方案，具有全球合規性、透明定價和更快的入職。

👉 開始免費試用

HelloSign (Dropbox Sign)：針對中小企業的簡易性

HelloSign（現為 Dropbox Sign）專注於使用者友好的 API 以實現快速設定，包括透過 webhook 回調的拒絕原因。基本方案從每月 15 美元起（20 個文件），吸引小型企業。它輕量級，但缺乏企業級功能如進階批量發送的深度。

電子簽名平台的比較概述

此表格突出了中立權衡：DocuSign 的成熟度、Adobe 的 Adobe 使用者、eSignGlobal 的區域效率，以及 HelloSign 的簡易性。

總之，雖然 DocuSign 的 API 仍是程式化拒絕處理的基準，但探索像 eSignGlobal 這樣的替代方案可以提供區域合規優勢，作為 DocuSign 的平衡替代品。企業應根據特定需求評估以實現最佳 ROI。