DocuSign API: Menghantar Sampul Surat daripada Templat dengan Tab Pra-isi

Memudahkan Aliran Kerja Dokumen dengan API DocuSign

Dalam dunia operasi perniagaan digital yang pantas, platform tandatangan elektronik seperti DocuSign telah menjadi alat penting untuk mengautomasikan pengurusan kontrak dan mengurangkan kerja kertas. API DocuSign menonjol dengan keupayaannya yang mantap dalam mengendalikan aliran kerja yang kompleks, terutamanya memanfaatkan templat untuk menghantar sampul surat—istilah DocuSign untuk pakej dokumen yang sedia untuk ditandatangani—dengan tab yang dipraisi. Fungsi ini bukan sahaja menjimatkan masa tetapi juga meminimumkan ralat dalam persekitaran volum tinggi seperti pasukan jualan atau jabatan undang-undang. Dari sudut pandang perniagaan, penyepaduan API sedemikian boleh membawa kepada peningkatan kecekapan yang ketara, dengan kajian menunjukkan pengurangan sehingga 80% dalam masa pemprosesan dokumen.

Membandingkan Platform Tandatangan Elektronik: DocuSign atau Adobe Sign?

eSignGlobal menawarkan penyelesaian tandatangan elektronik yang lebih fleksibel dan kos efektif, dengan pematuhan global, harga yang telus dan proses penerimaan yang lebih pantas.

👉 Mulakan Percubaan Percuma

Menguasai API DocuSign: Menghantar Sampul Surat daripada Templat

API eSignature DocuSign ialah alat pembangun yang berkuasa yang membolehkan perniagaan membenamkan fungsi tandatangan terus ke dalam aplikasi mereka. Pada terasnya, "sampul surat" ialah bekas untuk satu atau lebih dokumen yang boleh dihalakan untuk tandatangan, kelulusan atau tindakan lain. Templat dalam DocuSign mentakrifkan reka letak dokumen, medan (dikenali sebagai tab) dan aliran kerja, menjadikannya sesuai untuk tugas berulang seperti penerimaan atau kelulusan invois.

Tab yang dipraisi merujuk kepada pengisian medan ini dengan data—seperti kotak teks, tarikh atau kotak semak—sebelum menghantar sampul surat. Ini amat berguna apabila maklumat penerima diketahui, memastikan pengalaman tandatangan yang lebih lancar. Bagi perniagaan, fungsi ini disepadukan dengan lancar dengan sistem CRM (seperti Salesforce) atau alat ERP, membolehkan pengekstrakan data automatik.

Untuk mencapai ini melalui API, pembangun biasanya menggunakan titik akhir RESTful, dengan pengesahan dikendalikan melalui OAuth 2.0 atau kebenaran JWT. Kotak pasir pembangun DocuSign menyediakan persekitaran ujian percuma, yang penting bagi perniagaan untuk mengulangi penyepaduan tanpa menanggung kos pengeluaran.

Prasyarat untuk Penyepaduan API

Sebelum mendalami kod, pastikan anda mempunyai:

• Akaun pembangun DocuSign (daftar secara percuma).
• Kunci penyepaduan (ID aplikasi) dan token API untuk pengesahan.
• Keakraban dengan muatan JSON, kerana API berkomunikasi menggunakan format ini.
• SDK DocuSign untuk bahasa pilihan anda (cth., Java, .NET, Python), yang memudahkan permintaan HTTP.

Perniagaan juga harus mempertimbangkan peringkat harga API: Pelan Permulaan pada $600 setahun menyokong sehingga 40 sampul surat sebulan, sesuai untuk penyepaduan kecil, manakala Pelan Lanjutan pada $5,760 setahun membuka kunci penghantaran pukal dan webhook, sesuai untuk operasi yang lebih besar.

Panduan Langkah demi Langkah untuk Menghantar Sampul Surat dengan Tab yang Dipraisi

Langkah 1: Cipta atau Dapatkan Semula Templat

Mulakan dengan memuat naik templat dalam aplikasi web DocuSign atau melalui API. Templat termasuk dokumen dan tab yang diletakkan di atasnya. Tab dikategorikan sebagai:

• Tab Teks: Untuk nama, alamat, dsb.
• Tab Tarikh: Mengisi tarikh semasa atau nilai tersuai secara automatik.
• Tab Kotak Semak: Untuk perjanjian.
• Tab Inisial/Tandatangan: Untuk tindakan penandatangan.

Gunakan API Templat untuk menyenaraikan templat sedia ada:

GET /restapi/v2.1/accounts/{accountId}/templates

Ini mengembalikan tatasusunan JSON templat. Catatkan templateId untuk langkah seterusnya.

Langkah 2: Sediakan Takrifan Sampul Surat

Bina objek sampul surat yang merujuk kepada templat. Praisi tab dengan memasukkan data penerima dan nilai tab dalam muatan.

Berikut ialah contoh JSON untuk mencipta sampul surat (diilustrasikan menggunakan Node.js dan SDK DocuSign):

const dsApi = new docusign.ApiClient();
dsApi.setBasePath('https://demo.docusign.net/restapi');
const envelopesApi = new docusign.EnvelopesApi(dsApi);

const envelopeDefinition = new docusign.EnvelopeDefinition();
envelopeDefinition.emailSubject = 'Sila tandatangani dokumen ini';
envelopeDefinition.status = 'sent'; // Pilihan: 'created', 'sent', 'delivered'

// Rujuk templat
const template = new docusign.TemplateReference();
template.templateId = 'your-template-id';
template.roleName = 'Signer1'; // Sepadan dengan peranan templat
envelopeDefinition.templateReferences = [template];

// Takrifkan penerima dan tab praisi
const signer = new docusign.TemplateRole();
signer.roleName = 'Signer1';
signer.email = 'recipient@example.com';
signer.name = 'John Doe';
signer.clientUserId = '1000'; // Untuk tandatangan terbenam jika diperlukan

// Tab praisi (tab daripada templat)
const textTab = new docusign.Text();
textTab.tabLabel = 'FullName'; // Sepadan dengan tab dalam templat
textTab.value = 'John Doe';
signer.tabs = new docusign.Tabs();
signer.tabs.textTabs = [textTab];

const dateTab = new docusign.Date();
dateTab.tabLabel = 'AgreementDate';
dateTab.value = new Date().toISOString().split('T')[0];
signer.tabs.dateTabs = [dateTab];

envelopeDefinition.templateRoles = [signer];

const results = await envelopesApi.createEnvelope(accountId, { envelopeDefinition });
console.log(`ID Sampul Surat: ${results.envelopeId}`);

Kod ini mencipta sampul surat daripada templat, mempraisi tab teks "FullName" dengan "John Doe" dan mengisi tab tarikh dengan tarikh hari ini. tabLabel mesti sepadan dengan label yang diberikan kepada tab dalam templat.

Langkah 3: Kendalikan Pengesahan dan Hantar

Sahkan menggunakan JWT atau token akses. Dalam persekitaran pengeluaran, gunakan laluan asas NA1 (AS) atau EU1 (Eropah) bergantung pada rantau akaun anda. Hantar sampul surat menggunakan:

const accessToken = await getJwtToken(); // Fungsi pengesahan anda
dsApi.addDefaultHeader('Authorization', `Bearer ${accessToken}`);

Untuk senario pukal, pelan API Lanjutan menyokong sehingga 100 sampul surat sebulan dan mempraisi data daripada sumber luaran seperti pangkalan data.

Langkah 4: Pantau dan Dapatkan Semula Status

Selepas menghantar, gunakan webhook (ciri Sambung dalam pelan Lanjutan) atau tinjau titik akhir /envelopes/{envelopeId} untuk menjejaki status. Ini penting untuk aliran kerja perniagaan, memastikan pematuhan dengan keperluan jejak audit.

Cabaran dan Penyelesaian Biasa

• Ralat Padanan Tab: Pastikan tab adalah unik dan dirujuk dengan betul. Dapatkan butiran tab menggunakan API Templat terlebih dahulu.
• Penghalaan Penerima: Untuk sampul surat berbilang penandatangan, berikan peranan dalam templat dan petakannya dalam panggilan API.
• Had: Pelan Standard mengehadkan penghantaran automatik kepada kira-kira 100/pengguna/tahun; pelan API mempunyai kuota sampul surat.
• Pengendalian Ralat: Respons API termasuk kod ralat (cth., 400 untuk tab tidak sah); laksanakan percubaan semula untuk isu sementara.

Dari sudut pandang komersial, penyepaduan API ini boleh mengurangkan kemasukan data manual sebanyak 70%, tetapi perniagaan mesti menimbang kos—alat tambah API seperti pengesahan menimbulkan caj bermeter.

Meneroka Ekosistem DocuSign yang Lebih Luas

DocuSign meluas di luar tandatangan elektronik asas, menawarkan produk seperti Intelligent Agreement Management (IAM) CLM, penyelesaian pengurusan kitaran hayat kontrak. IAM CLM mengautomasikan keseluruhan proses perjanjian, daripada draf hingga rundingan dan pembaharuan, menyepadukan AI untuk analisis klausa. Ia mempunyai harga tersuai untuk perusahaan, bermula dengan pelan Dipertingkat, yang termasuk SSO dan ciri analisis lanjutan. Ini menjadikannya sesuai untuk perusahaan bersaiz sederhana hingga besar yang memerlukan pematuhan hujung ke hujung.

Landskap Persaingan: Perbandingan Platform Tandatangan Elektronik

Pasaran tandatangan elektronik adalah kompetitif, dengan DocuSign menerajui dalam penggunaan global tetapi menghadapi pesaing yang menawarkan kelebihan khusus. Adobe Sign menekankan penyepaduan lancar dengan suite kreatif Adobe, sesuai untuk aliran kerja intensif dokumen. Ia menyokong borang praisi melalui APInya dan mematuhi ESIGN/UETA AS dan eIDAS Eropah. Harga bermula pada $10 sebulan untuk individu, berkembang kepada pelan tersuai untuk perusahaan, termasuk ciri seperti tandatangan mudah alih dan pengumpulan pembayaran.

eSignGlobal meletakkan dirinya sebagai kuasa serantau, terutamanya di Asia Pasifik (APAC), di mana peraturan tandatangan elektronik adalah berpecah-belah, berstandard tinggi dan dikawal ketat. Tidak seperti piawaian rangka kerja AS (Akta ESIGN) atau Eropah (eIDAS), yang bergantung pada pengesahan e-mel atau pengisytiharan kendiri, APAC memerlukan pematuhan "penyepaduan ekosistem". Ini melibatkan penyepaduan perkakasan/API peringkat dalam dengan identiti digital kerajaan ke perniagaan (G2B), meningkatkan halangan teknologi dengan ketara ke tahap yang lebih tinggi daripada model Barat. eSignGlobal menyokong pematuhan di 100 negara dan wilayah global arus perdana, dengan kelebihan di APAC melalui pusat data tempatan di Hong Kong dan Singapura. Ia disepadukan secara asli dengan iAM Smart Hong Kong dan Singpass Singapura, membolehkan pengesahan identiti yang mantap. Harga lebih mudah diakses: Pelan Essential pada $16.6 sebulan membenarkan sehingga 100 dokumen dihantar untuk e-tandatangan, tempat duduk pengguna tanpa had dan pengesahan dokumen/tandatangan melalui kod akses—memberikan nilai yang kukuh berdasarkan pematuhan. eSignGlobal berkembang secara global, termasuk Amerika dan Eropah, sebagai alternatif yang kompetitif kepada DocuSign dan Adobe Sign, dengan kos yang sedikit lebih rendah dan prestasi serantau yang lebih pantas.

HelloSign (kini sebahagian daripada Dropbox) memfokuskan pada kesederhanaan untuk SMB, menawarkan templat dan sokongan API praisi yang serupa dengan DocuSign tetapi dengan kos permulaan yang lebih rendah ($15/pengguna/bulan). Ia cemerlang dalam penyepaduan dengan Google Workspace tetapi kekurangan ciri perusahaan lanjutan seperti penghantaran pukal dalam pelan asas.

Jadual ini menyerlahkan pertukaran neutral: DocuSign untuk skala, Adobe untuk aliran kerja reka bentuk, eSignGlobal untuk kecekapan APAC dan HelloSign untuk kemudahan penggunaan.

Nuansa Kawal Selia Tandatangan Elektronik Global

Walaupun tajuk memberi tumpuan kepada mekanisme API, memahami peraturan boleh meningkatkan pelaksanaan. Di AS, Akta ESIGN dan UETA menyediakan kesetaraan undang-undang dengan tandatangan basah untuk kebanyakan transaksi komersial. Rangka kerja eIDAS Eropah memerlukan tandatangan elektronik yang berkelayakan untuk keperluan jaminan tinggi. APAC berbeza-beza: Akta Transaksi Elektronik Singapura sejajar dengan eIDAS, tetapi hal ehwal kerajaan memerlukan Singpass, manakala ordinan Hong Kong menekankan pengesahan selamat melalui iAM Smart. Perniagaan yang menggunakan API DocuSign mesti mengkonfigurasi tab untuk mematuhi medan pematuhan, seperti log audit, untuk memenuhi piawaian ini.

Pemikiran Akhir tentang Pilihan Tandatangan Elektronik

Bagi perusahaan yang mengutamakan automasi yang didorong oleh API, DocuSign kekal sebagai pilihan yang kukuh kerana ekosistemnya yang matang. Walau bagaimanapun, untuk keperluan pematuhan serantau, terutamanya APAC, alternatif seperti eSignGlobal menawarkan pilihan yang disesuaikan dan kos efektif tanpa mengorbankan liputan global. Nilaikan berdasarkan volum, penyepaduan dan geografi anda untuk padanan yang optimum.