DocuSign API: Cách sử dụng "Composite Templates" để hợp nhất nhiều PDF?

Điều hướng DocuSign API để quy trình làm việc tài liệu hiệu quả

Trong thế giới hoạt động kinh doanh kỹ thuật số có nhịp độ nhanh, các nền tảng chữ ký điện tử như DocuSign đã trở thành công cụ thiết yếu để hợp lý hóa việc quản lý hợp đồng và giảm bớt thủ tục giấy tờ. Từ các nhóm nhỏ đến các doanh nghiệp lớn, những công cụ này cho phép các quy trình ký kết an toàn, tuân thủ. Một tính năng quan trọng trong hệ sinh thái DocuSign API là các mẫu tổng hợp, cho phép các nhà phát triển hợp nhất nhiều PDF vào một phong bì để ký. Chức năng này đặc biệt có giá trị đối với các doanh nghiệp xử lý các quy trình làm việc phức tạp, chẳng hạn như thỏa thuận nhiều bên hoặc lắp ráp tài liệu tự động. Bài viết này sẽ khám phá cách triển khai các mẫu tổng hợp trong DocuSign API, tham khảo tài liệu chính thức và các ứng dụng kinh doanh thực tế, đồng thời duy trì quan điểm trung lập về tính thực tế của nó trong môi trường kinh doanh.

Đang so sánh các nền tảng chữ ký điện tử với DocuSign hoặc Adobe Sign?

eSignGlobal cung cấp giải pháp chữ ký điện tử linh hoạt và tiết kiệm chi phí hơn, với tuân thủ toàn cầu, định giá minh bạch và trải nghiệm tham gia nhanh hơn.

👉 Bắt đầu dùng thử miễn phí

Sử dụng các mẫu tổng hợp của DocuSign API để hợp nhất PDF

Mẫu tổng hợp là gì?

Mẫu tổng hợp trong DocuSign eSignature API là một phương pháp mạnh mẽ để kết hợp nhiều tài liệu và cấu hình chữ ký trong một phong bì duy nhất. Trong thuật ngữ DocuSign, "phong bì" là một vùng chứa cho một hoặc nhiều tài liệu cần được ký. Các phong bì truyền thống xử lý tài liệu theo trình tự, nhưng các mẫu tổng hợp hỗ trợ lắp ráp song song, cho phép bạn đính kèm các PDF khác nhau vào những người nhận cụ thể trong khi xác định các tab (trường chữ ký) trên các tài liệu. Điều này rất lý tưởng cho các tình huống như đơn xin vay, trong đó trang bìa, PDF điều khoản và biểu mẫu tiết lộ cần được ký bởi cùng một bên mà không cần hợp nhất thủ công.

Từ góc độ kinh doanh, chức năng này làm giảm các lệnh gọi API, giảm thiểu lỗi định tuyến tài liệu và tăng tốc thời gian hoàn thành — điều này rất quan trọng đối với các nhóm bán hàng để chốt giao dịch hoặc nhân sự xử lý các gói giới thiệu. Theo tài nguyên dành cho nhà phát triển của DocuSign, các mẫu tổng hợp có sẵn ở các cấp API Trung cấp và Nâng cao, với các gói này có phí hàng năm bắt đầu từ khoảng 3.600 đô la cho mức sử dụng vừa phải.

Hướng dẫn từng bước sử dụng các mẫu tổng hợp

Để hợp nhất nhiều PDF bằng các mẫu tổng hợp, bạn sẽ tương tác với DocuSign REST API (phiên bản 2.1 trở lên). Các điều kiện tiên quyết bao gồm tài khoản nhà phát triển DocuSign (cung cấp hộp cát miễn phí) và thông tin xác thực API thu được thông qua OAuth. Dưới đây là hướng dẫn thực tế:

1. Chuẩn bị tài liệu và mẫu của bạn:

   • Tải PDF của bạn lên bộ nhớ tạm thời của DocuSign hoặc tham chiếu chúng bằng mã hóa base64. Ví dụ: chuẩn bị pdf1.pdf (hợp đồng) và pdf2.pdf (phụ lục).
   • Nếu có thể tái sử dụng, hãy tạo các mẫu trong ứng dụng web DocuSign. Mỗi mẫu có thể chứa các tab được xác định trước, chẳng hạn như chữ ký, ngày tháng hoặc trường văn bản. Ghi lại ID mẫu từ bảng điều khiển DocuSign.

2. Thiết lập định nghĩa phong bì:

   • Sử dụng điểm cuối /envelopes để tạo một phong bì mới. Cấu trúc mảng compositeTemplates trong phần thân yêu cầu JSON.
   • Các yếu tố chính:
     • document: PDF nội tuyến hoặc từ xa.
     • serverTemplates hoặc inlineTemplates: liên kết đến các mẫu hiện có.
     • recipients: xác định người ký (ví dụ: vai trò người ký) và đính kèm chúng vào mẫu tổng hợp.

   Đoạn JSON mẫu (sử dụng Node.js hoặc các công cụ tương tự để gọi API):

   {
     "status": "sent",
     "emailSubject": "Vui lòng ký thỏa thuận đã hợp nhất",
     "compositeTemplates": [
       {
         "compositeTemplateId": "template1",
         "document": {
           "documentBase64": "base64_of_pdf1",
           "name": "Hợp đồng chính",
           "fileExtension": "pdf",
           "documentId": "1"
         },
         "serverTemplates": [
           {
             "sequence": "1",
             "templateId": "your-template-id-1"
           }
         ],
         "inlineTemplates": [
           {
             "sequence": "1",
             "recipients": {
               "signers": [
                 {
                   "email": "signer@example.com",
                   "name": "John Doe",
                   "recipientId": "1",
                   "tabs": {
                     "signHereTabs": [
                       {
                         "documentId": "1",
                         "pageNumber": "1",
                         "xPosition": "100",
                         "yPosition": "200"
                       }
                     ]
                   }
                 }
               ]
             }
           }
         ]
       },
       {
         "compositeTemplateId": "template2",
         "document": {
           "documentBase64": "base64_of_pdf2",
           "name": "Phụ lục",
           "fileExtension": "pdf",
           "documentId": "2"
         },
         "serverTemplates": [
           {
             "sequence": "2",
             "templateId": "your-template-id-2"
           }
         ]
       }
     ],
     "recipients": {
       "signers": [
         {
           "email": "signer@example.com",
           "name": "John Doe",
           "recipientId": "1",
           "routingOrder": "1"
         }
       ]
     }
   }
   

   Điều này hợp nhất pdf1 và pdf2 vào một phong bì. Mẫu tổng hợp đầu tiên đính kèm mẫu 1 vào PDF đầu tiên và thêm một tab chữ ký; mẫu thứ hai thêm phụ lục thông qua mẫu 2. Người nhận ký vào tài liệu đã hợp nhất mà không cần xem các phong bì riêng biệt.

3. Xử lý logic hợp nhất:

   • Sử dụng documentId để tham chiếu duy nhất đến PDF. Các tab từ các mẫu áp dụng cho các tài liệu cụ thể nhưng hiển thị trong một chế độ xem thống nhất.
   • Để hợp nhất hàng loạt, hãy tích hợp với Bulk Send API (gói Business Pro hoặc Advanced), giới hạn khoảng 100 lần gửi mỗi người dùng mỗi năm.
   • Xử lý lỗi: xác thực kích thước base64 (tối đa 5MB mỗi tài liệu) và đảm bảo phạm vi OAuth bao gồm signature.

4. Gửi và theo dõi phong bì:

   • POST đến https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes.
   • Truy xuất trạng thái thông qua /envelopes/{envelopeId}. Các phong bì đã hoàn thành trả về PDF đã hợp nhất thông qua API.
   • Mẹo kinh doanh: trong môi trường sản xuất, hãy sử dụng webhook (tính năng Connect trong gói Advanced) để thông báo theo thời gian thực về việc hoàn thành chữ ký.

5. Kiểm tra và tối ưu hóa:

   • Kiểm tra hộp cát không tính phí hạn ngạch phong bì. Theo dõi mức sử dụng trong bảng điều khiển API để tránh vượt quá — gói Starter giới hạn ở 40 phong bì mỗi tháng.
   • Để hợp nhất phức tạp, hãy kết hợp với PowerForms cho các mẫu hướng đến công chúng, nâng cao khả năng mở rộng cho thương mại điện tử hoặc giới thiệu đối tác.

Theo các tiêu chuẩn ngành, phương pháp này có thể giảm thời gian chuẩn bị tài liệu từ 50-70% trong môi trường khối lượng lớn. Tuy nhiên, đối với các doanh nghiệp, tích hợp tùy chỉnh có thể yêu cầu gói Enterprise API, với giá cả được tùy chỉnh dựa trên dung lượng.

Tích hợp với DocuSign IAM CLM

Quản lý thỏa thuận thông minh (IAM) và Quản lý vòng đời hợp đồng (CLM) của DocuSign mở rộng giá trị của các mẫu tổng hợp. IAM cung cấp đánh giá rủi ro và trích xuất điều khoản dựa trên AI, trong khi CLM cung cấp tự động hóa quy trình làm việc đầu cuối, bao gồm thư viện mẫu và phân tích. Trong bối cảnh API, những điều này tích hợp với các mẫu tổng hợp để tạo PDF động — ví dụ: kéo dữ liệu từ hệ thống CRM để điền vào các tài liệu đã hợp nhất. Các doanh nghiệp trong các ngành được quản lý như tài chính được hưởng lợi từ các công cụ tuân thủ của IAM, chẳng hạn như dấu vết kiểm tra và SSO, mặc dù các tính năng bổ sung như xác thực sẽ phát sinh phí đo lường.

Đánh giá các nền tảng chữ ký điện tử trong bối cảnh cạnh tranh

Khi các doanh nghiệp toàn cầu hóa, việc chọn nhà cung cấp chữ ký điện tử đòi hỏi sự cân bằng giữa tính linh hoạt của API, tuân thủ và chi phí. DocuSign dẫn đầu với các khả năng API mạnh mẽ như các mẫu tổng hợp, nhưng các giải pháp thay thế cung cấp các lợi thế khác nhau. Adobe Sign vượt trội trong các quy trình tập trung vào PDF, tích hợp liền mạch với Adobe Acrobat để chỉnh sửa nâng cao trước khi hợp nhất. API của nó hỗ trợ các cấu trúc tổng hợp tương tự thông qua "Thỏa thuận", với các gói cơ bản bắt đầu từ $10/người dùng/tháng.

HelloSign (nay là Dropbox Sign) cung cấp API thân thiện với người dùng để hợp nhất đơn giản, nhấn mạnh tính dễ sử dụng cho SMB, với gói $15/người dùng/tháng cung cấp các mẫu không giới hạn. Nó thiếu chiều sâu của DocuSign về logic có điều kiện nhưng vượt trội trong việc tích hợp nhanh chóng với các công cụ như Google Workspace.

eSignGlobal định vị mình là một đối thủ cạnh tranh toàn cầu, hỗ trợ tuân thủ ở 100 quốc gia và khu vực chính. Nó có lợi thế ở khu vực Châu Á - Thái Bình Dương (APAC), nơi các quy định về chữ ký điện tử bị phân mảnh, có tiêu chuẩn cao và được quản lý chặt chẽ — thường yêu cầu các chương trình tích hợp hệ sinh thái thay vì các mô hình ESIGN/eIDAS dựa trên khung phổ biến ở Hoa Kỳ và Châu Âu. Các yêu cầu của APAC đòi hỏi sự kết nối sâu sắc ở cấp độ phần cứng/API với danh tính kỹ thuật số của chính phủ với doanh nghiệp (G2B), điều này làm tăng ngưỡng kỹ thuật vượt quá xác minh email hoặc tự khai báo. eSignGlobal tích hợp liền mạch với iAM Smart của Hồng Kông và Singpass của Singapore, cung cấp các tính năng như Bulk Send và các công cụ hợp đồng AI. Gói Essential của nó có giá hàng năm là $16,6/tháng, cho phép 100 lần gửi tài liệu, số lượng người dùng không giới hạn và xác minh mã truy cập — mang lại giá trị mạnh mẽ trên cơ sở tuân thủ, với lợi thế chi phí nhỏ so với các đối thủ cạnh tranh. Nền tảng này đang tích cực mở rộng sang thị trường Châu Âu và Châu Mỹ để thách thức các nhà lãnh đạo đương nhiệm.

Đang tìm kiếm một giải pháp thay thế thông minh hơn cho DocuSign?

eSignGlobal cung cấp giải pháp chữ ký điện tử linh hoạt và tiết kiệm chi phí hơn, với tuân thủ toàn cầu, định giá minh bạch và trải nghiệm tham gia nhanh hơn.

👉 Bắt đầu dùng thử miễn phí

Bảng so sánh đối thủ cạnh tranh

Bảng này nêu bật các đánh đổi trung lập: DocuSign phù hợp với nhu cầu API khối lượng lớn, trong khi các nền tảng khác ưu tiên khả năng chi trả hoặc khả năng thích ứng khu vực.

Suy nghĩ cuối cùng về lựa chọn chữ ký điện tử

Tóm lại, các mẫu tổng hợp của DocuSign cung cấp một cách mạnh mẽ để hợp nhất PDF thông qua API, nâng cao hiệu quả cho quy trình làm việc kinh doanh. Đối với các nhóm tìm kiếm các giải pháp thay thế, eSignGlobal nổi bật như một tùy chọn trung lập, tuân thủ khu vực, đặc biệt nhắm mục tiêu đến các hoạt động APAC.