DocuSign API: Bagaimana Menetapkan "Peringatan" dan "Tamat Tempoh" Melalui JSON?

Memahami API DocuSign untuk Pengurusan Sampul Surat

Dalam landskap persaingan penyelesaian tandatangan elektronik, API DocuSign kekal sebagai asas bagi pembangun untuk mengintegrasikan aliran kerja automatik ke dalam proses perniagaan. Apabila syarikat mengembangkan operasi digital mereka, fungsi peringatan dan tamat tempoh memainkan peranan penting dalam memastikan dokumen diselesaikan tepat pada masanya tanpa pengawasan manual. Artikel ini meneroka cara mengkonfigurasi tetapan ini dalam API DocuSign melalui JSON, merujuk kepada dokumentasi rasmi dan pandangan pelaksanaan praktikal. Dari sudut pandang perniagaan, penguasaan elemen API ini boleh mengoptimumkan kitaran kontrak, mengurangkan beban pentadbiran dan meningkatkan pematuhan dalam persekitaran volum tinggi.

Membandingkan platform e-tandatangan yang serupa dengan DocuSign atau Adobe Sign?

eSignGlobal menawarkan penyelesaian e-tandatangan yang lebih fleksibel dan kos efektif dengan pematuhan global, harga yang telus dan proses pendaftaran yang lebih pantas.

👉 Mulakan Percubaan Percuma

Menetapkan Peringatan dan Tamat Tempoh dalam API DocuSign: Panduan Langkah demi Langkah

API eSignature DocuSign membolehkan pembangun membenamkan peraturan peringatan dan tamat tempoh terus ke dalam permintaan penciptaan sampul surat. Fungsi ini penting untuk automasi perniagaan kerana ia mengautomasikan susulan dan menghalang dokumen daripada tergantung selama-lamanya, yang boleh memakan sumber daripada pasukan jualan, HR atau undang-undang. Peringatan memberitahu penandatangan pada selang masa yang ditetapkan jika dokumen itu tidak ditandatangani, manakala tamat tempoh membatalkan sampul surat selepas tempoh yang ditetapkan, memastikan kecekapan aliran kerja.

Prasyarat untuk Integrasi API

Sebelum mendalami muatan JSON, pastikan anda mempunyai:

• Akaun pembangun DocuSign dengan akses API (tersedia melalui Pusat Pembangun).
• Pengesahan yang disediakan menggunakan OAuth 2.0 atau JWT untuk panggilan API yang selamat.
• Keakraban dengan titik akhir Envelopes: create (POST /accounts/{accountId}/envelopes).

API menggunakan titik akhir RESTful, dan semua konfigurasi dihantar melalui badan JSON permintaan. Penggunaan API tertakluk kepada pelan pembangun DocuSign, bermula dari $600/tahun peringkat permulaan, termasuk kuota sampul surat asas yang sesuai untuk ujian awal.

Mengkonfigurasi Peringatan Melalui JSON

Peringatan ditakrifkan dalam objek reminders dalam definisi sampul surat. Objek ini menentukan kekerapan, kelewatan sebelum peringatan pertama dan bilangan percubaan. Perniagaan sering menggunakan fungsi ini untuk menggesa penandatangan dalam senario seperti kontrak pelanggan atau kemasukan pekerja, mengurangkan kadar keciciran.

Berikut ialah contoh coretan JSON untuk permintaan penciptaan sampul surat:

{
  "status": "sent",
  "emailSubject": "Sila tandatangani dokumen ini",
  "documents": [
    {
      "documentBase64": "BASE64_ENCODED_DOCUMENT_CONTENT",
      "name": "Perjanjian Contoh",
      "fileExtension": "pdf",
      "documentId": "1"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "John Doe",
        "recipientId": "1",
        "routingOrder": "1"
      }
    ]
  },
  "reminders": {
    "reminderDelay": 2,  // Hari sebelum peringatan pertama (cth., 2 hari selepas menghantar)
    "reminderFrequency": "daily",  // Pilihan: daily, weekly, monthly
    "reminderOffset": 1,  // Bilangan hari antara peringatan
    "reminderMaxAttempts": 5  // Jumlah peringatan yang dihantar (cth., 5 percubaan)
  }
}

• reminderDelay: Menetapkan tempoh menunggu awal (dalam hari). Nilai 1-3 hari adalah biasa untuk transaksi yang sensitif masa.
• reminderFrequency: Menetapkan selang masa—gunakan harian untuk perkara mendesak, mingguan untuk kontrak standard.
• reminderOffset: Jurang antara peringatan, sejajar dengan rentak perniagaan.
• reminderMaxAttempts: Mengehadkan jumlah untuk mengelakkan spam; DocuSign mengesyorkan 3-7 kali berdasarkan volum sampul surat.

Untuk melaksanakan, hantar JSON ini melalui permintaan POST ke API Envelopes. Contohnya, menggunakan cURL:

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-d '@envelope.json'

Dalam amalan, perniagaan dengan pelan API lanjutan ($5760/tahun) mendapat manfaat daripada kuota yang lebih tinggi, membenarkan logik peringatan yang mantap dalam penghantaran pukal. Ujian dalam persekitaran kotak pasir memastikan konfigurasi mematuhi keperluan pematuhan, seperti jejak audit dalam industri terkawal.

Melaksanakan Tamat Tempoh Melalui JSON

Tamat tempoh secara automatik menolak sampul surat yang tidak ditandatangani selepas tarikh akhir, membebaskan kuota API dan menghalang pembaziran sumber. Ini amat berharga dalam saluran jualan berkelajuan tinggi di mana dokumen mungkin terbiar.

Tetapan expireAfter dan expireNotify bersarang di bawah sifat peringkat atas sampul surat atau dalam konfigurasi penerima tertentu untuk kawalan terperinci.

Contoh JSON tamat tempoh:

{
  "status": "sent",
  "emailSubject": "Tindakan Diperlukan: Semak dan Tandatangan",
  "documents": [
    // ... (sama seperti di atas)
  ],
  "recipients": {
    "signers": [
      // ... (sama seperti di atas)
    ]
  },
  "expireAfter": "30",  // Hari sehingga tamat tempoh (cth., 30 hari dari tarikh penghantaran)
  "expireNotify": true  // Sama ada untuk menghantar e-mel kepada penghantar apabila tamat tempoh (benar/palsu)
}

• expireAfter: Menentukan dalam hari (1-9999). Perniagaan menetapkan tempoh yang lebih pendek (7-14 hari) untuk perjanjian mendesak untuk mengekalkan momentum.
• expireNotify: Lalai kepada palsu; mendayakannya memberi amaran kepada penghantar untuk tindakan susulan, disepadukan dengan lancar dengan sistem CRM.

Untuk tamat tempoh peringkat penerima (berguna dalam aliran kerja berbilang penandatangan), benamkannya dalam objek penandatangan:

"signers": [
  {
    "email": "signer@example.com",
    "name": "John Doe",
    "recipientId": "1",
    "routingOrder": "1",
    "expireAfter": "15",  // Tamat tempoh setiap penandatangan
    "expireNotify": "1"  // Beritahu penghantar (1 = ya, 0 = tidak)
  }
]

Menggabungkan peringatan dan tamat tempoh boleh mencipta strategi pengurusan kitaran hayat yang komprehensif. Contohnya, tamat tempoh 30 hari ditambah peringatan harian selepas 5 hari boleh meningkatkan kadar penyiapan sebanyak 20-30% berdasarkan penanda aras industri. Ambil perhatian bahawa tetapan ini menggunakan kuota sampul surat—pelan standard dihadkan kepada ~100 sampul surat/pengguna/tahun, jadi pengguna API peringkat pertengahan ($3600/tahun) memperoleh fleksibiliti untuk aliran kerja automatik.

Amalan Terbaik dan Perangkap Biasa

Dari sudut pandang komersial, konfigurasi peringatan yang berlebihan boleh meningkatkan caj SMS/tambahan (dibilkan setiap mesej), manakala tamat tempoh yang longgar menggunakan tempat duduk dalam model harga berasaskan tempat duduk. Sentiasa sahkan JSON terhadap skema API menggunakan dokumentasi Swagger DocuSign. Perangkap termasuk ketidakpadanan zon waktu—pasukan global menggunakan UTC—dan mengabaikan sebab penolakan, yang boleh disesuaikan untuk analitik yang lebih baik.

Di APAC, kependaman dan pematuhan menambah kerumitan, dan integrasi API mesti mengambil kira tambahan serantau seperti penghantaran SMS, yang boleh meningkatkan kos. Ujian dengan muatan sampel dalam kotak pasir DocuSign sebelum penggunaan pengeluaran adalah disyorkan.

Fungsi API ini menyerlahkan kekuatan DocuSign dalam alatan mesra pembangun, walaupun perniagaan harus menilai jumlah kos, termasuk had automasi (~10/pengguna/bulan).

Landskap Persaingan: Perbandingan Platform E-Tandatangan

Apabila e-tandatangan menjadi teras transformasi digital, membandingkan DocuSign dengan alternatif seperti Adobe Sign, eSignGlobal dan HelloSign (kini Dropbox Sign) mendedahkan kekuatan yang berbeza. DocuSign cemerlang dalam keteguhan API global, tetapi kebolehskalaan harganya menghadapi penelitian, terutamanya untuk pengguna intensif API. Adobe Sign disepadukan secara mendalam dengan ekosistem Adobe, sesuai untuk aliran kerja kreatif. eSignGlobal menyasarkan pematuhan setempat di APAC, manakala HelloSign menyediakan kesederhanaan untuk SMB.

Gambaran Keseluruhan Pemain Utama

DocuSign: Peneraju pasaran dengan keupayaan API yang komprehensif, termasuk peringatan dan tamat tempoh yang dibincangkan di atas. Kekuatannya terletak pada keselamatan dan penyepaduan peringkat perusahaan, tetapi harga berasaskan tempat duduk boleh menjadi penghalang untuk peningkatan pasukan. Platform ini menyokong sampul surat tanpa had pada peringkat yang lebih tinggi, walaupun penghantaran automatik dihadkan.

Adobe Sign: Penyelesaian Adobe menekankan penyepaduan lancar dengan alatan PDF dan Acrobat, sesuai untuk industri intensif dokumen. Ia menawarkan kawalan API yang serupa untuk peringatan (melalui tetapan "pemberitahuan") dan tamat tempoh (sehingga 999 hari), dengan muatan JSON mencerminkan struktur DocuSign. Harga bermula pada $10/pengguna/bulan untuk individu, berkembang kepada sebut harga tersuai perusahaan. Ia amat mantap dalam pematuhan AS, tetapi penggunaan API lanjutan mungkin menimbulkan caj tambahan.

eSignGlobal: Pembekal tumpuan APAC ini menyokong pematuhan di 100 negara dan wilayah global arus perdana, dengan kelebihan ketara di APAC. Landskap e-tandatangan di rantau ini berpecah-belah, dengan piawaian tinggi dan peraturan yang ketat—berbeza dengan rangka kerja ESIGN/eIDAS gaya AS/EU. APAC memerlukan pendekatan "penyepaduan ekosistem", memerlukan penyepaduan mendalam peringkat perkakasan/API dengan identiti digital kerajaan (G2B), jauh melangkaui pengesahan e-mel atau model pengisytiharan kendiri yang biasa di Barat. eSignGlobal bersaing secara langsung dengan DocuSign dan Adobe Sign di seluruh dunia, termasuk Amerika dan Eropah, melalui pelan kos efektif. Edisi Essentialnya hanya $16.6/bulan (tahunan), membenarkan sehingga 100 tandatangan dokumen, tempat duduk pengguna tanpa had dan pengesahan kod akses—semuanya berdasarkan asas pematuhan dan bernilai tinggi. Ia disepadukan dengan lancar dengan iAM Smart Hong Kong dan Singpass Singapura, menangani titik kesakitan serantau seperti kediaman data dan kependaman.

HelloSign (Dropbox Sign): Diperoleh oleh Dropbox, ia mengutamakan antara muka mesra pengguna dan sinergi penyimpanan fail. Sokongan API untuk peringatan dan tamat tempoh melalui JSON, dengan kuota yang lebih mudah (cth., 20 sampul surat/bulan pada peringkat percuma). Harga bermula pada $15/bulan untuk Essentials, menarik minat pasukan kecil, tetapi kurang kebolehskalaan untuk keperluan API perusahaan berbanding DocuSign.

Mencari alternatif yang lebih bijak kepada DocuSign?

eSignGlobal menawarkan penyelesaian e-tandatangan yang lebih fleksibel dan kos efektif dengan pematuhan global, harga yang telus dan proses pendaftaran yang lebih pantas.

👉 Mulakan Percubaan Percuma

Jadual Perbandingan Markdown

Jadual ini menyerlahkan pertukaran neutral: DocuSign untuk kedalaman, Adobe untuk penyepaduan, eSignGlobal untuk nilai serantau dan HelloSign untuk kebolehcapaian.

Pemikiran Akhir tentang Pilihan E-Tandatangan

Kesimpulannya, mengkonfigurasi peringatan dan tamat tempoh dalam API DocuSign melalui JSON boleh menyelaraskan operasi perniagaan, tetapi memilih platform yang betul bergantung pada skala, wilayah dan belanjawan. Bagi mereka yang mencari alternatif DocuSign, eSignGlobal menonjol dengan pematuhan serantau dan kehadiran global yang mantap.