DocuSign API: Làm thế nào để thêm người nhận "Carbon Copy" sau khi gửi?

Hiểu Người nhận Bản sao Carbon trong DocuSign

Trong lĩnh vực chữ ký điện tử, API của DocuSign cung cấp các công cụ mạnh mẽ để tự động hóa quy trình làm việc của tài liệu, nhưng việc thêm người nhận sau khi phong bì đã được tạo có thể khó khăn. Người nhận "Bản sao Carbon" (CC) là một vai trò không ký tên, họ nhận được một bản sao của tài liệu đã ký để xem hoặc lưu giữ hồ sơ mà không cần ký hoặc phê duyệt. Từ góc độ kinh doanh, tính năng này có giá trị đối với các nhóm tuân thủ, bộ phận pháp lý hoặc người quản lý bán hàng, những người cần được thông báo mà không cần thay đổi chuỗi chữ ký. Tuy nhiên, API của DocuSign có những hạn chế đối với việc sửa đổi sau khi phong bì được gửi đi và chúng ta sẽ khám phá những hạn chế này một cách chi tiết.

Bài viết này đi sâu vào các bước thực tế để thêm người nhận CC sau khi phong bì được gửi đi thông qua DocuSign eSignature API. Chúng ta sẽ đề cập đến các điều kiện tiên quyết, lệnh gọi API, các cạm bẫy tiềm ẩn và các phương pháp hay nhất, tham khảo tài liệu chính thức và thông tin chi tiết về triển khai thực tế. Đối với các doanh nghiệp tích hợp DocuSign, việc hiểu những sắc thái này có thể ngăn ngừa sự gián đoạn quy trình làm việc và đảm bảo các quy trình sẵn sàng cho kiểm toán.

Cơ bản về Quản lý Người nhận API DocuSign

Trước khi thêm người nhận CC sau khi gửi, điều quan trọng là phải hiểu vòng đời phong bì của DocuSign. Phong bì đại diện cho một gói tài liệu và một khi chúng được "gửi", chúng sẽ ở trạng thái hoạt động, tại thời điểm đó các thay đổi bị hạn chế để bảo vệ trải nghiệm của người ký và tính toàn vẹn pháp lý. eSignature REST API (v2.1) quản lý các tương tác này, yêu cầu xác thực thông qua JWT hoặc OAuth để truy cập an toàn.

Các khái niệm chính:

• Người nhận: Bao gồm người ký, người phê duyệt và CC. CC được thêm thông qua mảng carbonCopies trong đối tượng người nhận.
• Trạng thái phong bì: Sau khi gửi, phong bì ở trạng thái "sent" hoặc "delivered". Việc sửa đổi bị hạn chế; bạn không thể thêm người ký yêu cầu hành động, nhưng CC được phép vì chúng không thay đổi thứ tự chữ ký.
• Điểm cuối API: Sử dụng /envelopes/{envelopeId}/recipients để cập nhật.

Từ góc độ kinh doanh, giá API của DocuSign bắt đầu từ $600 mỗi năm cho gói Starter, hỗ trợ tối đa 40 phong bì mỗi tháng, phù hợp cho các tích hợp nhỏ, nhưng nhu cầu khối lượng lớn sẽ làm tăng chi phí.

Hướng dẫn Từng bước: Thêm Người nhận CC Sau khi Gửi

Việc thêm CC sau khi gửi yêu cầu sử dụng chế độ correct hoặc giải pháp thay thế void-and-resend, vì việc thêm trực tiếp sau khi gửi không phải lúc nào cũng đơn giản. DocuSign khuyên bạn nên lập kế hoạch trước cho người nhận, nhưng đối với các tình huống động (ví dụ: thêm người quản lý dựa trên logic nghiệp vụ có điều kiện), hãy làm theo các bước sau. Quy trình này giả định rằng bạn có tài khoản nhà phát triển và mã thông báo truy cập API.

Điều kiện tiên quyết

1. Thiết lập API: Tích hợp DocuSign SDK (dành cho Java, .NET, PHP, v.v.) hoặc sử dụng lệnh gọi REST thô. Xác thực bằng khóa tích hợp và ID người dùng của bạn.
2. ID phong bì: Truy xuất ID từ phản hồi gửi ban đầu (ví dụ: thông qua POST /envelopes).
3. Quyền: Đảm bảo tài khoản của bạn cho phép sửa phong bì (được bật trong "Features" trong Cài đặt Quản trị).
4. Kiểm tra trạng thái phong bì: Truy vấn /envelopes/{envelopeId} để xác nhận rằng nó ở trạng thái "sent" và không có người ký nào hoàn thành hành động khóa các thay đổi.

Mẹo kinh doanh: Đối với các doanh nghiệp, gói Advanced API ($5,760 mỗi năm) mở khóa các tính năng như Bulk Send và webhook, có thể tự động thông báo cho CC khi hoàn thành.

Phương pháp 1: Sử dụng Sửa phong bì (Được khuyến nghị cho các thay đổi nhỏ)

Tính năng "Correct" của DocuSign cho phép sửa đổi trong quá trình thực hiện mà không cần void phong bì, phù hợp để thêm CC.

1. Bắt đầu Sửa:

   • PUT đến /envelopes/{envelopeId}/correct với nội dung:

     {
       "clientUserId": "optional_client_id",
       "correctInProgress": true
     }
     

     Điều này tạm dừng phong bì.

2. Thêm Người nhận CC:

   • POST đến /envelopes/{envelopeId}/recipients với chi tiết CC:

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // Ví dụ: "CC1"
           "routingOrder": 0  // CC không ảnh hưởng đến thứ tự
         }
       ],
       "resendEnvelope": false  // Không gửi lại thông báo ngay bây giờ
     }
     

     • recipientId phải là duy nhất; tránh xung đột với người nhận hiện có.
     • Tùy chọn: Thêm accessControl để truy cập CC được bảo vệ bằng mật khẩu.

3. Gửi lại hoặc Thông báo:

   • PUT lại đến /envelopes/{envelopeId}/correct để tiếp tục:

     {
       "resendEnvelope": true  // Kích hoạt email cho CC mới
     }
     

     CC sẽ nhận được một bản sao sau khi phong bì hoàn thành hoặc theo yêu cầu.

Cạm bẫy tiềm ẩn: Nếu phong bì đã "completed", bạn không thể sửa nó—sử dụng webhook thông qua tính năng Connect (gói Advanced) để theo dõi trạng thái.

Phương pháp 2: Void và Gửi lại (Phù hợp cho các tình huống phức tạp)

Nếu việc sửa không khả thi (ví dụ: do hành động của người ký), hãy void phong bì và tạo lại nó với CC mới.

1. Void Phong bì:

   • PUT đến /envelopes/{envelopeId}:

     {
       "status": "voided",
       "voidedReason": "Adding CC recipient"
     }
     

2. Tạo lại với CC:

   • POST đến /envelopes với tải trọng ban đầu, cộng với CC trong đối tượng recipients:

     {
       "emailSubject": "Updated Document",
       "documents": [/* original docs */],
       "recipients": {
         "signers": [/* original signers */],
         "carbonCopies": [
           {
             "email": "cc@example.com",
             "name": "John Doe",
             "recipientId": "CC1"
           }
         ]
       },
       "status": "sent"
     }
     

3. Thông báo cho Người ký Ban đầu: Sử dụng /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend cho mỗi người ký để tiếp tục.

Quan sát kinh doanh: Phương pháp này phát sinh chi phí sử dụng phong bì bổ sung (ví dụ: ~100 phong bì mỗi người dùng mỗi năm cho Business Pro, $480/người dùng/năm), vì vậy nó phù hợp cho các sửa chữa khối lượng thấp. Theo dõi hạn ngạch bằng bảng điều khiển thông qua API để quản lý.

Các phương pháp hay nhất và Hạn chế

• Xử lý lỗi: Các lỗi phổ biến bao gồm 400 (người nhận không hợp lệ) hoặc 403 (không đủ quyền). Luôn xác thực trước bằng GET /envelopes/{envelopeId}/recipients.
• Kiểm tra: Sử dụng Developer Sandbox của DocuSign (miễn phí) để mô phỏng mà không tiêu thụ phong bì sản xuất.
• Tuân thủ: Việc thêm CC duy trì dấu vết kiểm toán, tuân thủ các tiêu chuẩn ESIGN/UETA, nhưng ghi lại lý do để tránh tranh chấp.
• Các lựa chọn thay thế tự động hóa: Đối với các nhu cầu sau khi gửi thường xuyên, hãy tích hợp webhook (gói Advanced) để kích hoạt thông báo bên ngoài thay vì sửa đổi API.

Trong thực tế, các doanh nghiệp báo cáo mức tăng hiệu quả từ 20-30% bằng cách viết kịch bản các thao tác này thông qua SDK, nhưng đối với các thao tác quy mô lớn, hãy xem xét các gói tùy chỉnh Enterprise để điều chỉnh không giới hạn.

Đ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 các 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, giá cả minh bạch và quy trình giới thiệu nhanh hơn.

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

So sánh DocuSign với các Đối thủ cạnh tranh Chính

Để cung cấp một quan điểm cân bằng, hãy so sánh các khả năng API của DocuSign với các lựa chọn thay thế như Adobe Sign, eSignGlobal và HelloSign (hiện là Dropbox Sign). Bảng này dựa trên dữ liệu công khai năm 2025, làm nổi bật giá cả, quản lý người nhận và các thế mạnh khu vực để giúp các doanh nghiệp đưa ra quyết định trong việc lựa chọn nhà cung cấp.

So sánh này cho thấy DocuSign vượt trội về độ sâu API trưởng thành nhưng với chi phí cao hơn, trong khi các đối thủ cạnh tranh cung cấp sự linh hoạt cho các phân khúc cụ thể.

Tiêu điểm Adobe Sign

Adobe Sign, một phần của Adobe Document Cloud, cung cấp API liền mạch để quản lý người nhận, bao gồm việc thêm CC sau khi gửi dễ dàng hơn thông qua điểm cuối API "Amend" của nó. Giá cả cạnh tranh, bắt đầu từ $10/người dùng/tháng cho phiên bản cơ bản và mở rộng đến tùy chỉnh Enterprise. Nó phù hợp với các doanh nghiệp đã có trong bộ Adobe, cung cấp xử lý PDF mạnh mẽ và tuân thủ toàn cầu, mặc dù độ trễ APAC có thể là một vấn đề.

Tiêu điểm eSignGlobal

eSignGlobal tự định vị mình là một người chơi toàn cầu, tuân thủ ở hơn 100 quốc gia chính và có sự hiện diện mạnh mẽ đặc biệt ở Châu Á Thái Bình Dương (APAC). Bức tranh chữ ký điện tử ở APAC bị phân mảnh, với các tiêu chuẩn cao và quy định nghiêm ngặt—khác với khuôn khổ ESIGN/eIDAS của Hoa Kỳ/EU, APAC yêu cầu các giải pháp "tích hợp hệ sinh thái". Điều này có nghĩa là kết nối sâu cấp phần cứng/API với danh tính kỹ thuật số của chính phủ (G2B), một rào cản kỹ thuật vượt xa các mô hình xác minh email hoặc tự khai báo phổ biến ở phương Tây. eSignGlobal giải quyết vấn đề này thông qua các tích hợp gốc như iAM Smart của Hồng Kông và Singpass của Singapore, đảm bảo tính hợp lệ về mặt pháp lý mà không phải trả thêm chi phí.

Giá cả phải chăng, với gói Essential của họ ở mức $16,6 mỗi tháng hàng năm, cho phép tối đa 100 chữ ký tài liệu, chỗ ngồi người dùng không giới hạn và xác minh thông qua mã truy cập. Giá trị hướng đến tuân thủ này khiến nó trở nên cạnh tranh so với DocuSign và Adobe Sign, đặc biệt đối với các nhóm xuyên biên giới đang tìm kiếm TCO thấp hơn.

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

eSignGlobal cung cấp các 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, giá cả minh bạch và quy trình giới thiệu nhanh hơn.

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

Suy nghĩ Cuối cùng về Lựa chọn Chữ ký Điện tử

Đối với các doanh nghiệp điều hướng quy trình làm việc dựa trên API, DocuSign vẫn là một lựa chọn đáng tin cậy, mặc dù việc sửa đổi sau khi gửi yêu cầu lập kế hoạch cẩn thận. Với sự trỗi dậy của các lựa chọn thay thế, hãy xem xét các nhu cầu khu vực—eSignGlobal nổi bật như một lựa chọn trung lập, hướng đến tuân thủ cho các hoạt động hướng đến APAC. Đánh giá dựa trên dung lượng, tích hợp và vị trí địa lý của bạn để có sự phù hợp tối ưu.