DocuSign API: Bagaimana Menggunakan "Templat Komposit" untuk Menggabungkan Beberapa PDF?

Menavigasi API DocuSign untuk Aliran Kerja Dokumen yang Cekap

Dalam dunia operasi perniagaan digital yang serba pantas, platform tandatangan elektronik seperti DocuSign telah menjadi alat penting untuk menyelaraskan pengurusan kontrak dan mengurangkan kerja kertas. Daripada pasukan kecil hingga perusahaan besar, alat ini membolehkan proses tandatangan yang selamat dan mematuhi peraturan. Ciri utama dalam ekosistem API DocuSign ialah templat komposit, yang membolehkan pembangun menggabungkan berbilang PDF ke dalam satu sampul surat untuk ditandatangani. Fungsi ini amat berharga untuk perniagaan yang mengendalikan aliran kerja yang kompleks, seperti perjanjian berbilang pihak atau pemasangan dokumen automatik. Artikel ini akan meneroka cara melaksanakan templat komposit dalam API DocuSign, merujuk kepada dokumentasi rasmi dan aplikasi perniagaan praktikal, sambil mengekalkan perspektif neutral tentang kegunaannya dalam persekitaran komersial.

Membandingkan platform tandatangan elektronik dengan DocuSign atau Adobe Sign?

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

👉 Mulakan percubaan percuma

Memanfaatkan Templat Komposit API DocuSign untuk Penggabungan PDF

Apakah itu Templat Komposit?

Templat komposit dalam API eSignature DocuSign ialah kaedah yang berkuasa untuk menggabungkan berbilang dokumen dan konfigurasi tandatangan dalam satu sampul surat. Dalam istilah DocuSign, "sampul surat" ialah bekas untuk satu atau lebih dokumen yang memerlukan tandatangan. Sampul surat tradisional memproses dokumen mengikut urutan, tetapi templat komposit menyokong pemasangan selari, membolehkan anda melampirkan PDF yang berbeza kepada penerima tertentu sambil mentakrifkan tab (medan tandatangan) merentas dokumen. Ini sesuai untuk senario seperti permohonan pinjaman, di mana muka depan, PDF terma dan borang pendedahan perlu ditandatangani oleh pihak yang sama tanpa penggabungan manual.

Dari sudut pandangan perniagaan, ciri ini mengurangkan panggilan API, meminimumkan ralat penghalaan dokumen dan mempercepatkan masa pemprosesan—yang penting untuk pasukan jualan menutup tawaran atau HR mengendalikan pakej orientasi. Menurut sumber pembangun DocuSign, templat komposit tersedia dalam peringkat API Pertengahan dan Lanjutan, yang mempunyai yuran tahunan bermula dari kira-kira $3,600 untuk penggunaan sederhana.

Panduan Langkah demi Langkah untuk Menggunakan Templat Komposit

Untuk menggabungkan berbilang PDF menggunakan templat komposit, anda akan berinteraksi dengan API REST DocuSign (versi 2.1 atau lebih tinggi). Prasyarat termasuk akaun pembangun DocuSign (yang menawarkan kotak pasir percuma) dan bukti kelayakan API yang diperoleh melalui OAuth. Berikut ialah panduan praktikal:

1. Sediakan Dokumen dan Templat Anda:

   • Muat naik PDF anda ke storan sementara DocuSign atau rujuknya melalui pengekodan base64. Contohnya, sediakan pdf1.pdf (kontrak) dan pdf2.pdf (tambahan).
   • Jika boleh digunakan semula, buat templat dalam aplikasi web DocuSign. Setiap templat boleh mengandungi tab yang telah ditetapkan, seperti tandatangan, tarikh atau medan teks. Rekod ID templat daripada papan pemuka DocuSign.

2. Sediakan Definisi Sampul Surat:

   • Buat sampul surat baharu menggunakan titik akhir /envelopes. Strukturkan tatasusunan compositeTemplates dalam badan permintaan JSON.
   • Elemen utama:
     • document: PDF sebaris atau jauh.
     • serverTemplates atau inlineTemplates: Pautan ke templat sedia ada.
     • recipients: Takrifkan penandatangan (cth., peranan penandatangan) dan lampirkannya pada templat komposit.

   Contoh coretan JSON (menggunakan Node.js atau alat yang serupa untuk panggilan API):

   {
     "status": "sent",
     "emailSubject": "Sila tandatangani perjanjian yang digabungkan",
     "compositeTemplates": [
       {
         "compositeTemplateId": "template1",
         "document": {
           "documentBase64": "base64_of_pdf1",
           "name": "Kontrak Utama",
           "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": "Tambahan",
           "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"
         }
       ]
     }
   }
   

   Ini menggabungkan pdf1 dan pdf2 ke dalam satu sampul surat. Templat komposit pertama melampirkan templat 1 pada PDF pertama dan menambah tab tandatangan; yang kedua menambah tambahan melalui templat 2. Penerima menandatangani dokumen yang digabungkan tanpa melihat sampul surat yang berasingan.

3. Kendalikan Logik Penggabungan:

   • Rujuk PDF secara unik menggunakan documentId. Tab daripada templat digunakan pada dokumen tertentu tetapi dipaparkan dalam paparan bersatu.
   • Untuk penggabungan pukal, berintegrasi dengan API Hantar Pukal (pelan Business Pro atau Lanjutan), dihadkan pada kira-kira 100 hantaran setiap pengguna setiap tahun.
   • Pengendalian ralat: Sahkan saiz base64 (had 5MB setiap dokumen) dan pastikan skop OAuth termasuk signature.

4. Hantar dan Pantau Sampul Surat:

   • POST ke https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes.
   • Dapatkan semula status melalui /envelopes/{envelopeId}. Sampul surat yang lengkap mengembalikan PDF yang digabungkan melalui API.
   • Petua perniagaan: Dalam persekitaran pengeluaran, gunakan webhook (ciri Sambung dalam pelan Lanjutan) untuk pemberitahuan masa nyata tentang penyelesaian tandatangan.

5. Uji dan Optimumkan:

   • Ujian kotak pasir tidak mengenakan kuota sampul surat. Pantau penggunaan dalam papan pemuka API untuk mengelakkan penggunaan berlebihan—pelan Permulaan dihadkan kepada 40 sampul surat setiap bulan.
   • Untuk penggabungan yang kompleks, gabungkan dengan PowerForms untuk templat yang menghadap orang ramai, meningkatkan kebolehskalaan untuk e-dagang atau orientasi rakan kongsi.

Menurut penanda aras industri, kaedah ini boleh mengurangkan masa penyediaan dokumen sebanyak 50-70% dalam persekitaran volum tinggi. Walau bagaimanapun, untuk perusahaan, penyepaduan tersuai mungkin memerlukan pelan API Perusahaan, dengan harga yang disesuaikan berdasarkan kapasiti.

Penyepaduan dengan DocuSign IAM CLM

Pengurusan Perjanjian Pintar (IAM) dan Pengurusan Kitaran Hayat Kontrak (CLM) DocuSign melanjutkan nilai templat komposit. IAM menyediakan penilaian risiko dan pengekstrakan klausa yang dipacu AI, manakala CLM menawarkan automasi aliran kerja hujung ke hujung, termasuk perpustakaan templat dan analitik. Dalam konteks API, ini berintegrasi dengan templat komposit untuk penjanaan PDF dinamik—contohnya, menarik data daripada sistem CRM untuk mengisi dokumen yang digabungkan. Perusahaan dalam industri terkawal seperti kewangan mendapat manfaat daripada alat pematuhan IAM, seperti jejak audit dan SSO, walaupun ciri tambahan seperti pengesahan identiti menimbulkan caj bermeter.

Menilai Platform Tandatangan Elektronik dalam Landskap Persaingan

Apabila perniagaan menjadi global, memilih pembekal tandatangan elektronik memerlukan keseimbangan fleksibiliti API, pematuhan dan kos. DocuSign menerajui dengan keupayaan API yang mantap, seperti templat komposit, tetapi alternatif menawarkan kelebihan yang berbeza. Adobe Sign cemerlang dalam proses berpusatkan PDF, berintegrasi dengan lancar dengan Adobe Acrobat untuk penyuntingan lanjutan sebelum penggabungan. APInya menyokong struktur komposit yang serupa melalui "Perjanjian," dengan pelan asas bermula pada $10/pengguna/bulan.

HelloSign (kini Dropbox Sign) menawarkan API mesra pengguna untuk penggabungan mudah, menekankan kemudahan penggunaan untuk SMB, dengan pelan $15/pengguna/bulan yang menawarkan templat tanpa had. Ia kekurangan kedalaman DocuSign dalam logik bersyarat tetapi cemerlang dalam penyepaduan pantas dengan alat seperti Google Workspace.

eSignGlobal meletakkan dirinya sebagai pesaing global, menyokong pematuhan di 100 negara dan wilayah arus perdana. Ia mempunyai kelebihan di Asia Pasifik (APAC), di mana peraturan tandatangan elektronik berpecah-belah, berstandard tinggi dan dikawal ketat—selalunya memerlukan skim penyepaduan ekosistem dan bukannya model berasaskan rangka kerja ESIGN/eIDAS yang biasa di AS dan Eropah. Keperluan APAC memerlukan gandingan perkakasan/API peringkat dalam dengan identiti digital Kerajaan kepada Perniagaan (G2B), yang meningkatkan ambang teknikal di luar pengesahan e-mel atau pengisytiharan kendiri. eSignGlobal berintegrasi dengan lancar dengan iAM Smart Hong Kong dan Singpass Singapura, menawarkan ciri seperti Hantar Pukal dan alat kontrak AI. Pelan Essentialnya berharga $16.6/bulan yang dibilkan setiap tahun, membenarkan 100 hantaran dokumen, tempat duduk pengguna tanpa had dan pengesahan kod akses—memberikan nilai yang kukuh berdasarkan pematuhan dengan kelebihan kos yang sedikit berbanding pesaing. Platform ini sedang berkembang secara agresif ke pasaran Eropah dan Amerika untuk mencabar peneraju sedia ada.

Mencari alternatif yang lebih pintar kepada DocuSign?

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

👉 Mulakan percubaan percuma

Jadual Perbandingan Pesaing

Jadual ini menyerlahkan pertukaran neutral: DocuSign sesuai untuk keperluan API volum tinggi, manakala platform lain mengutamakan kemampuan atau penyesuaian serantau.

Pemikiran Akhir tentang Pilihan Tandatangan Elektronik

Kesimpulannya, templat komposit DocuSign menawarkan cara yang boleh dipercayai untuk menggabungkan PDF melalui API, meningkatkan kecekapan aliran kerja perniagaan. Untuk pasukan yang mencari alternatif, eSignGlobal menonjol sebagai pilihan neutral dan mematuhi serantau, terutamanya untuk operasi APAC.