DocuSign API: Bagaimana Cara Menambahkan Penerima "Carbon Copy" Setelah Pengiriman?

Memahami Penerima Tembusan (CC) di DocuSign

Di ranah tanda tangan elektronik, API DocuSign menyediakan alat yang ampuh untuk mengotomatiskan alur kerja dokumen, tetapi menambahkan penerima setelah amplop dibuat bisa jadi rumit. Penerima "Tembusan" (CC) adalah peran non-penandatangan yang menerima salinan dokumen yang telah ditandatangani untuk dilihat atau disimpan sebagai catatan, tanpa memerlukan tanda tangan atau persetujuan. Dari sudut pandang bisnis, fitur ini sangat berharga bagi tim kepatuhan, departemen hukum, atau manajer penjualan yang perlu diberi tahu tanpa mengubah rantai tanda tangan. Namun, API DocuSign memiliki batasan pada modifikasi setelah amplop dikirim, yang akan kita jelajahi secara rinci.

Artikel ini membahas langkah-langkah praktis untuk menambahkan penerima CC setelah amplop dikirim melalui DocuSign eSignature API. Kami akan membahas prasyarat, panggilan API, potensi jebakan, dan praktik terbaik, dengan referensi ke dokumentasi resmi dan wawasan implementasi dunia nyata. Memahami nuansa ini dapat mencegah gangguan alur kerja dan memastikan proses yang siap diaudit bagi perusahaan yang mengintegrasikan DocuSign.

Dasar-Dasar Manajemen Penerima DocuSign API

Sebelum menambahkan penerima CC setelah pengiriman, memahami siklus hidup amplop DocuSign sangat penting. Amplop mewakili paket dokumen, dan setelah "dikirim", mereka aktif, di mana perubahan dibatasi untuk melindungi pengalaman penandatangan dan integritas hukum. eSignature REST API (v2.1) mengelola interaksi ini, yang memerlukan otentikasi melalui JWT atau OAuth untuk akses aman.

Konsep Utama:

• Penerima: Termasuk penandatangan, pemberi persetujuan, dan CC. CC ditambahkan melalui array carbonCopies dalam objek penerima.
• Status Amplop: Setelah dikirim, amplop berada dalam status "sent" atau "delivered". Modifikasi terbatas; Anda tidak dapat menambahkan penandatangan yang memerlukan tindakan, tetapi CC diizinkan karena mereka tidak mengubah urutan tanda tangan.
• Titik Akhir API: Gunakan /envelopes/{envelopeId}/recipients untuk pembaruan.

Dari sudut pandang komersial, harga API DocuSign mulai dari $600 per tahun untuk paket Starter, mendukung hingga 40 amplop per bulan, cocok untuk integrasi skala kecil, tetapi kebutuhan volume tinggi meningkatkan biaya.

Panduan Langkah demi Langkah: Menambahkan Penerima CC Setelah Pengiriman

Menambahkan CC setelah pengiriman memerlukan penggunaan mode correct atau solusi void-and-resend, karena penambahan langsung setelah pengiriman tidak selalu mudah. DocuSign merekomendasikan untuk merencanakan penerima di muka, tetapi untuk skenario dinamis (misalnya, menambahkan manajer berdasarkan logika bisnis bersyarat), ikuti langkah-langkah ini. Proses ini mengasumsikan Anda memiliki akun pengembang dan token akses API.

Prasyarat

1. Pengaturan API: Integrasikan DocuSign SDK (untuk Java, .NET, PHP, dll.) atau gunakan panggilan REST mentah. Otentikasi menggunakan kunci integrasi dan ID pengguna Anda.
2. ID Amplop: Ambil ID dari respons pengiriman awal (misalnya, melalui POST ke /envelopes).
3. Izin: Pastikan akun Anda mengizinkan koreksi amplop (diaktifkan di "Fitur" di bawah Pengaturan Admin).
4. Pemeriksaan Status Amplop: Kueri /envelopes/{envelopeId} untuk mengonfirmasi bahwa itu dalam status "sent" dan tidak ada penandatangan yang menyelesaikan tindakan yang mengunci perubahan.

Tip Bisnis: Untuk perusahaan, paket Advanced API ($5.760 per tahun) membuka fitur seperti Bulk Send dan webhook, yang dapat secara otomatis memberi tahu CC setelah selesai.

Metode 1: Menggunakan Koreksi Amplop (Direkomendasikan untuk Perubahan Kecil)

Fitur "Correct" DocuSign memungkinkan modifikasi dalam proses tanpa membatalkan amplop, cocok untuk menambahkan CC.

1. Mulai Koreksi:

   • PUT ke /envelopes/{envelopeId}/correct dengan badan:

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

     Ini menangguhkan amplop sementara.

2. Tambahkan Penerima CC:

   • POST ke /envelopes/{envelopeId}/recipients dengan detail CC:

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // Misalnya, "CC1"
           "routingOrder": 0  // CC tidak memengaruhi urutan
         }
       ],
       "resendEnvelope": false  // Jangan kirim ulang notifikasi untuk saat ini
     }
     

     • recipientId harus unik; hindari konflik dengan penerima yang ada.
     • Opsional: Tambahkan accessControl untuk akses CC yang dilindungi kata sandi.

3. Kirim Ulang atau Beri Tahu:

   • PUT lagi ke /envelopes/{envelopeId}/correct untuk melanjutkan:

     {
       "resendEnvelope": true  // Memicu email untuk CC baru
     }
     

     CC akan menerima salinan setelah amplop selesai atau sesuai permintaan.

Potensi Jebakan: Jika amplop "completed", koreksi tidak mungkin dilakukan—gunakan webhook melalui fitur Connect (paket Advanced) untuk memantau status.

Metode 2: Void dan Kirim Ulang (Untuk Skenario Kompleks)

Jika koreksi tidak layak (misalnya, karena tindakan penandatangan), batalkan amplop dan buat ulang dengan CC baru.

1. Batalkan Amplop:

   • PUT ke /envelopes/{envelopeId}:

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

2. Buat Ulang dengan CC:

   • POST ke /envelopes dengan muatan asli, ditambah CC di objek recipients:

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

3. Beri Tahu Penandatangan Asli: Gunakan /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend untuk setiap penandatangan untuk melanjutkan.

Pengamatan Bisnis: Metode ini menimbulkan biaya penggunaan amplop tambahan (misalnya, ~100 amplop per pengguna per tahun untuk Business Pro, $480/pengguna/tahun), sehingga cocok untuk koreksi volume rendah. Lacak kuota menggunakan dasbor melalui API untuk mengelola.

Praktik Terbaik dan Batasan

• Penanganan Kesalahan: Kesalahan umum termasuk 400 (penerima tidak valid) atau 403 (izin tidak mencukupi). Selalu validasi menggunakan GET ke /envelopes/{envelopeId}/recipients terlebih dahulu.
• Pengujian: Gunakan DocuSign's Developer Sandbox (gratis) untuk simulasi tanpa menghabiskan amplop produksi.
• Kepatuhan: Penambahan CC mempertahankan jejak audit, sesuai dengan standar ESIGN/UETA, tetapi catat alasan untuk menghindari perselisihan.
• Alternatif Otomatisasi: Untuk kebutuhan pasca-pengiriman yang sering, integrasikan webhook (paket Advanced) untuk memicu notifikasi eksternal daripada modifikasi API.

Dalam praktiknya, perusahaan melaporkan peningkatan efisiensi 20-30% dengan membuat skrip operasi ini melalui SDK, tetapi untuk operasi skala tinggi, pertimbangkan paket kustom Enterprise untuk penyesuaian tanpa batas.

Membandingkan platform tanda tangan elektronik dengan DocuSign atau Adobe Sign?

eSignGlobal menawarkan solusi tanda tangan elektronik yang lebih fleksibel dan hemat biaya dengan kepatuhan global, harga transparan, dan orientasi yang lebih cepat.

👉 Mulai Uji Coba Gratis

Membandingkan DocuSign dengan Pesaing Utama

Untuk memberikan perspektif yang seimbang, mari kita bandingkan kemampuan API DocuSign dengan alternatif seperti Adobe Sign, eSignGlobal, dan HelloSign (sekarang Dropbox Sign). Tabel ini didasarkan pada data publik 2025, menyoroti harga, manajemen penerima, dan kekuatan regional untuk membantu perusahaan dalam keputusan pemilihan vendor.

Perbandingan ini menunjukkan bahwa DocuSign unggul dalam kedalaman API yang matang tetapi dengan biaya yang lebih tinggi, sementara pesaing menawarkan fleksibilitas untuk segmen tertentu.

Fokus Adobe Sign

Adobe Sign, bagian dari Adobe Document Cloud, menawarkan API yang mulus untuk manajemen penerima, termasuk penambahan CC pasca-pengiriman yang lebih mudah melalui titik akhir API "Amend". Harga kompetitif, mulai dari $10/pengguna/bulan untuk dasar, hingga kustom Enterprise. Cocok untuk perusahaan yang sudah berada di suite Adobe, menawarkan pemrosesan PDF yang kuat dan kepatuhan global, meskipun latensi APAC mungkin menjadi perhatian.

Fokus eSignGlobal

eSignGlobal memposisikan dirinya sebagai pemain global, mematuhi 100+ negara arus utama, dengan kekuatan khusus di Asia-Pasifik (APAC). Lanskap tanda tangan elektronik APAC terfragmentasi, dengan standar tinggi dan peraturan ketat—berbeda dengan kerangka kerja ESIGN/eIDAS gaya AS/UE, APAC membutuhkan solusi "integrasi ekosistem". Ini berarti koneksi mendalam tingkat perangkat keras/API dengan identitas digital pemerintah (G2B), penghalang teknologi yang jauh melampaui verifikasi email atau pola deklarasi diri yang umum di Barat. eSignGlobal mengatasi hal ini melalui integrasi asli seperti iAM Smart Hong Kong dan Singpass Singapura, memastikan validitas hukum tanpa biaya tambahan.

Harga terjangkau, dengan paket Essential mereka seharga $16,6/bulan yang ditagih setiap tahun, memungkinkan hingga 100 tanda tangan dokumen, kursi pengguna tak terbatas, dan verifikasi melalui kode akses. Nilai yang digerakkan oleh kepatuhan ini membuatnya kompetitif terhadap DocuSign dan Adobe Sign, terutama untuk tim lintas batas yang mencari TCO yang lebih rendah.

Mencari alternatif yang lebih cerdas daripada DocuSign?

eSignGlobal menawarkan solusi tanda tangan elektronik yang lebih fleksibel dan hemat biaya dengan kepatuhan global, harga transparan, dan orientasi yang lebih cepat.

👉 Mulai Uji Coba Gratis

Pemikiran Akhir tentang Pilihan Tanda Tangan Elektronik

DocuSign tetap menjadi pilihan yang solid untuk perusahaan yang menavigasi alur kerja yang digerakkan oleh API, meskipun modifikasi pasca-pengiriman memerlukan perencanaan yang cermat. Dengan munculnya alternatif, pertimbangkan kebutuhan regional—eSignGlobal menonjol sebagai opsi netral dan digerakkan oleh kepatuhan untuk operasi yang berorientasi pada APAC. Evaluasi berdasarkan kapasitas, integrasi, dan geografi Anda untuk kesesuaian yang optimal.