DocuSign API: Bagaimana Cara Membatalkan Amplop Tanpa Mengirim Notifikasi Email?

Pengantar DocuSign API dan Manajemen Amplop

Dalam lanskap alur kerja dokumen digital yang terus berkembang, API DocuSign menonjol sebagai alat yang ampuh, membantu pengembang mengintegrasikan fungsionalitas tanda tangan elektronik ke dalam aplikasi bisnis. Amplop (Envelopes), yang merangkum dokumen untuk ditandatangani, adalah inti dari ekosistem ini, memungkinkan pengelolaan perjanjian yang mulus dari pembuatan hingga penyelesaian. Namun, dalam beberapa kasus, pembatalan amplop—baik sebelum atau selama proses penandatanganan—menjadi penting untuk memperbaiki kesalahan atau mengakomodasi kebutuhan bisnis yang berubah. Tantangan utama bagi pengguna API adalah mengendalikan notifikasi, khususnya menghindari peringatan email yang tidak diminta yang dapat membingungkan penerima. Artikel ini mengeksplorasi mekanisme untuk membatalkan amplop melalui DocuSign API sambil meminimalkan gangguan, dengan mengacu pada dokumentasi resmi dan wawasan implementasi praktis.

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 proses orientasi yang lebih cepat.

👉 Mulai Uji Coba Gratis

Membatalkan Amplop di DocuSign: Konsep Inti

Apa itu Amplop di DocuSign?

Amplop di DocuSign mewakili paket lengkap yang berisi satu atau beberapa dokumen, penerima, dan instruksi penandatanganan. Melalui API, pengembang dapat membuat, mengirim, dan mengelola amplop ini secara terprogram. Membatalkan amplop secara efektif membuatnya tidak valid, mencegah tindakan lebih lanjut seperti penandatanganan. Ini sangat berguna dalam proses bisnis di mana transaksi gagal atau dokumen memerlukan revisi, sehingga mencegah proses yang tidak lengkap atau salah untuk dilanjutkan.

REST API DocuSign (versi 2.1) menyediakan titik akhir untuk operasi amplop, termasuk metode voidEnvelope. Secara default, pembatalan memicu notifikasi ke semua penerima, memberi tahu mereka tentang pembatalan melalui email. Ini memastikan transparansi tetapi mungkin tidak ideal dalam sistem otomatis atau koreksi internal pra-pemberitahuan.

Proses Pembatalan Default dan Perilaku Notifikasi

Untuk membatalkan amplop menggunakan DocuSign API, biasanya dilakukan permintaan PUT ke titik akhir /envelopes/{envelopeId}/void. Berikut adalah contoh dasar menggunakan DocuSign eSignature SDK di Python:

from docusign_esign import ApiClient, EnvelopesApi

# Inisialisasi klien API
api_client = ApiClient()
api_client.host = 'https://demo.docusign.net/restapi'
api_client.set_default_header('Authorization', 'Bearer YOUR_ACCESS_TOKEN')

envelopes_api = EnvelopesApi(api_client)

# Batalkan amplop
void_request = {
    'status': 'voided',
    'voidedReason': 'Document needs revision before sending'
}

envelopes_api.update_envelope_status(
    account_id='YOUR_ACCOUNT_ID',
    envelope_id='ENVELOPE_ID',
    envelope=None,  # Tidak diperlukan untuk void
    void_uri=void_request
)

Dalam alur standar ini, DocuSign secara otomatis mengirimkan pemberitahuan email kepada penerima yang terdaftar di amplop, merinci status pembatalan dan alasannya. Email ini mencakup alasan pembatalan dan mungkin menautkan kembali ke amplop untuk referensi. Menurut panduan pengembang DocuSign, ini adalah perilaku yang diharapkan untuk menjaga jejak audit dan kesadaran pengguna, sejalan dengan standar kepatuhan seperti ESIGN dan eIDAS.

Namun, untuk aplikasi yang digerakkan oleh API—seperti integrasi CRM atau alat pemrosesan batch—mengirim email ini dapat memenuhi kotak masuk atau mengungkap perubahan internal terlalu dini. Kabar baiknya adalah DocuSign memungkinkan penyesuaian untuk menekan notifikasi ini, memungkinkan pengalaman yang lebih terkontrol.

Cara Membatalkan Amplop Tanpa Mengirim Pemberitahuan Email

Menekan pemberitahuan email selama pembatalan memerlukan konfigurasi di muka baik di tingkat amplop atau akun, karena panggilan API pembatalan itu sendiri tidak memiliki bendera "tanpa pemberitahuan" langsung. Strategi ini melibatkan pemanfaatan pengaturan notifikasi dan peran penerima DocuSign untuk meminimalkan komunikasi eksternal. Pendekatan ini sangat berharga bagi pengguna perusahaan dengan tingkat API Business Pro atau Advanced, di mana volume amplop tinggi dan otomatisasi sangat penting.

Langkah 1: Konfigurasikan Preferensi Notifikasi Amplop

Sebelum membuat atau mengirim amplop, atur aturan notifikasi melalui API. Gunakan objek notification dalam definisi amplop untuk menonaktifkan email penerima untuk perubahan status, termasuk pembatalan. Sertakan dalam titik akhir createEnvelope Envelopes API:

{
  "notification": {
    "reminders": {
      "reminderDelay": 0,
      "reminderOffset": 0,
      "reminderFrequency": "none"
    },
    "expirations": {
      "expireAfter": 0,
      "expireWarn": 0
    },
    "recipientEmailNotification": {
      "emailSubject": "",
      "emailBlurb": "",
      "emailBody": ""
    }
  }
}

Blok recipientEmailNotification dapat dibiarkan kosong atau diatur untuk menekan default. Untuk kontrol pembatalan tertentu, pastikan amplop dibuat dalam status "draf" (status: 'sent' = false), memungkinkan pembatalan tanpa pemberitahuan awal. Setelah dibatalkan dari draf, jika notifikasi dinonaktifkan, email tidak akan dipicu.

Langkah 2: Batalkan dari Status Draf

Membatalkan amplop dalam mode draf (sebelum dikirim) pada dasarnya menghindari notifikasi karena penerima belum menerima peringatan. Gunakan panggilan update_envelope_status yang sama tetapi targetkan amplop draf:

# Buat amplop sebagai draf
envelope_definition = {
    'status': 'created',  # Mode draf
    'emailSubject': 'Internal Review Document',
    'documents': [...],  # Dokumen Anda
    'recipients': {
        'signers': [...]  # Ditentukan tetapi belum diberi tahu
    },
    'notification': {  # Tekan semua
        'recipientEmailNotification': {}
    }
}

envelopes_api.create_envelope(account_id='YOUR_ACCOUNT_ID', envelope_definition=envelope_definition)

# Kemudian, batalkan tanpa mengirim
void_request = {'status': 'voided', 'voidedReason': 'Internal correction'}
envelopes_api.update_envelope_status(account_id='YOUR_ACCOUNT_ID', envelope_id='DRAFT_ENVELOPE_ID', void_uri=void_request)

Metode ini memastikan tidak ada email yang dikirim selama pembatalan. Untuk amplop yang sedang berlangsung (sudah dikirim), pertama-tama tarik kembali ke draf menggunakan API correct, lalu batalkan—menekan notifikasi dalam permintaan koreksi melalui allowReassign: false dan bidang notifikasi kosong.

Langkah 3: Konfigurasi Tingkat Akun dan Lanjutan

Untuk kontrol yang lebih luas, integrasikan kemampuan Identity and Access Management (IAM) DocuSign, yang tersedia dalam paket Enhanced atau Enterprise. IAM memungkinkan notifikasi peristiwa yang disesuaikan melalui webhook Connect API, mengarahkan peristiwa pembatalan ke server Anda daripada email. Siapkan konfigurasi Connect:

• Titik akhir: /accounts/{accountId}/connect
• Sertakan envelopeEvents untuk status "voided" tetapi kecualikan pengiriman email.

Selain itu, untuk paket API (Starter $600/tahun atau Advanced $5.760/tahun), manfaatkan webhook untuk menangani pembatalan secara diam-diam. Pantau pendengar connect untuk peristiwa pembatalan dan respons secara internal tanpa memicu email default DocuSign.

Praktik Terbaik dan Batasan

• Pengujian: Validasi alur kerja menggunakan Lingkungan Demo DocuSign karena pembatalan produksi tidak dapat dibalik.
• Kepatuhan: Menekan notifikasi dapat diterima untuk pembatalan internal, tetapi pastikan log audit menangkap alasan untuk kebutuhan peraturan.
• Kuota: Paket API membatasi volume amplop (misalnya, 100/bulan untuk Intermediate), jadi pembatalan yang efisien membantu melestarikan batas.
• Kasus Tepi: Jika amplop telah ditandatangani sebagian, pembatalan masih dapat memberi tahu penandatangan tersebut kecuali dikonfigurasi sebelumnya.

Teknik ini menyederhanakan integrasi API, mengurangi kebisingan operasional dalam skenario volume tinggi. Dari sudut pandang bisnis, ini meningkatkan efisiensi tim yang mengandalkan DocuSign API untuk sistem CRM atau ERP, meskipun memerlukan perencanaan di muka.

Lanskap Kompetitif: Ikhtisar Platform Tanda Tangan Elektronik

DocuSign memimpin pasar tanda tangan elektronik dengan rangkaian API yang komprehensif, termasuk eSignature untuk penandatanganan inti dan CLM (Contract Lifecycle Management) untuk penanganan perjanjian ujung ke ujung. Integrasi CLM menggabungkan wawasan berbasis AI, manajemen templat, dan analitik, ideal untuk perusahaan yang mengelola kontrak kompleks. Harga mulai dari $10/bulan untuk Personal tetapi meningkat ke Enterprise khusus untuk penggunaan intensif API, dengan tambahan seperti otentikasi yang menambahkan biaya terukur.

Adobe Sign (sekarang Adobe Acrobat Sign) melengkapi ekosistem dokumen Adobe, menampilkan integrasi PDF yang kuat dan penandatanganan seluler. Ini menawarkan akses API untuk otomatisasi, mendukung pembatalan melalui titik akhir REST serupa tetapi dengan kontrol notifikasi eksklusif Adobe. Paket berkisar dari $10/pengguna/bulan untuk Individual hingga $40/pengguna/bulan untuk Enterprise, menekankan alur kerja yang mulus dengan alat Creative Cloud. Namun, untuk pengguna volume tinggi, kuota API dapat membatasi tanpa peningkatan premium.

eSignGlobal memposisikan dirinya sebagai pesaing global, mematuhi 100 negara dan wilayah utama, dengan keunggulan khusus di Asia-Pasifik (APAC). Lanskap tanda tangan elektronik APAC menghadirkan fragmentasi, standar tinggi, dan peraturan ketat, berbeda dengan standar kerangka kerja ESIGN/eIDAS AS/UE. Di APAC, solusi memerlukan pendekatan "integrasi ekosistem", termasuk koneksi perangkat keras/tingkat API yang mendalam dengan identitas digital Pemerintah ke Bisnis (G2B)—hambatan teknis yang jauh melampaui metode berbasis email atau deklarasi sendiri yang umum di Barat. eSignGlobal unggul di sini, terintegrasi secara mulus dengan iAM Smart Hong Kong dan Singpass Singapura untuk validasi yang kuat. Paket Essential-nya seharga $16,6/bulan, memungkinkan hingga 100 dokumen yang dikirim, kursi pengguna tak terbatas, dan validasi kode akses, memberikan nilai yang kuat berdasarkan kepatuhan sambil mengalahkan pesaing dalam harga. Platform ini secara agresif berekspansi di pasar global, termasuk AS dan UE, sebagai alternatif yang layak untuk DocuSign dan Adobe Sign.

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 proses orientasi yang lebih cepat.

👉 Mulai Uji Coba Gratis

HelloSign (sekarang Dropbox Sign) berfokus pada kesederhanaan, menampilkan API intuitif untuk manajemen amplop, termasuk opsi pembatalan yang memungkinkan penekanan notifikasi melalui pengaturan khusus. Ini cocok untuk UKM, dengan paket mulai dari gratis (terbatas) hingga $20/pengguna/bulan (Essentials), tetapi kurang memiliki kedalaman fitur tingkat perusahaan seperti IAM tingkat lanjut.

Perbandingan ini menyoroti trade-off: DocuSign unggul dalam kedalaman, sementara alternatif seperti eSignGlobal menawarkan keunggulan regional.

Nuansa Regional dalam Implementasi Tanda Tangan Elektronik

Meskipun DocuSign API dapat diakses secara global, perbedaan regional memengaruhi adopsi. Di APAC, aturan residensi data dan otentikasi yang lebih ketat memperkuat kebutuhan akan solusi yang dilokalkan, seperti yang dibahas sebelumnya. Perusahaan harus mengevaluasi perilaku API terhadap hukum setempat untuk memastikan proses pembatalan menjaga integritas hukum.

Singkatnya, menguasai API DocuSign untuk pembatalan tanpa pemberitahuan memberdayakan alur kerja yang efisien. Bagi mereka yang mencari alternatif, eSignGlobal layak dipertimbangkan sebagai opsi netral dan patuh secara regional, terutama cocok untuk operasi yang berorientasi pada APAC.