Isi templat untuk menghasilkan file

POST /esignglobal/v1/templates/createFileByTemplate

Deskripsi Antarmuka

Berdasarkan nomor templat kontraktemplateIddan kontrol dalam templat untuk mengisi konten khusus, dan akhirnya menghasilkan file PDF secara asinkron.

Pastikan status templat diaktifkan sebelum memanggil

Parameter Permintaan

Nama Parameter		Jenis	Wajib Diisi	Keterangan
templateId		string	true	ID Templat Kontrak
fileName		string	false	Nama file yang dihasilkan Catatan: Nama file tidak boleh mengandung 9 karakter khusus berikut: / \ : * " < > \| ？dan semua emoji
fields		array	false	Daftar informasi kontrol dalam templat (pilih salah satu antara ID Kontrol dan Kunci Kontrol untuk mengirim nilai)
	fieldId	string	false	ID Kontrol (dibuat secara otomatis oleh sistem eSignGlobal saat mengatur templat kontrak)
	fieldKey	string	false	Kunci Kontrol (ditetapkan pengguna saat membuat templat kontrak)
	fieldValue	string	false	Nilai isian kontrol (1) Dapat diisi sesuai dengan jenis kontrol; (2) Saat mengisi kontrol tabel dinamis, jika Anda perlu menambahkan baris data baru, nilai parameter insertRow harus true
callBackUrl		string	false	Alamat panggilan balik (panjang maksimum 500), harus berupa alamat https yang valid

Contoh Permintaan

{
    "templateId": "1866fd459647435b98f7d40b2a9bc33e",
    "fields": [
        {
        	"fieldKey": "Number",
        	"fieldValue": "120000100101.001"
        },
        {
        	"fieldKey": "Date",
        	"fieldValue": "2025-07-07"
        },
        {
        	"fieldKey": "Checkbox",
        	"fieldValue": "[0,1,2]"
        },
        {
        	"fieldKey": "Radio",
        	"fieldValue": "1"
        },
        {
        	"fieldKey": "Select",
        	"fieldValue": "0"
        },
        {
        	"fieldKey": "Email",
        	"fieldValue": "test@gmail.com"
        },
        {
        	"fieldKey": "mergeFilling",
        	"fieldValue": "eSignGlobal"
        },
        {
        	"fieldKey": "tabkey",
        	"fieldId": "537c875667f24b9782a7bb42f1dc98b2",
        	"fieldValue": "[{\"row\":{\"column1\":\"Name\"}},{\"row\":{\"column1\":\"Jack\"}},{\"insertRow\":\"true\",\"row\":{\"column1\":\"Mike\"}}]"
        },
        {
        	"fieldId": "4d25013762f042758cdd727a9d4f8029",
        	"fieldKey": "",
        	"fieldValue": "123"
        }
    ]
}

Parameter Respons

Nama Parameter	Jenis	Keterangan
taskId	string	ID tugas penggabungan file

Contoh Respons

{
    "code": "0",
    "data": {
        "taskId": "7e6d1125dc164fa4b2c268f8bb809dea"
    },
    "message": "success"
}

Penjelasan Contoh Pengisian Kontrol

Tipe Kontrol	Contoh Nilai Pengisian Kontrol	Penjelasan Spesifik
Teks Satu Baris	"Teks spesifik XXXXX"	Teks spesifik yang diisi
Teks Multi-baris	"Teks multi-baris\nTeks multi-baris"	Teks spesifik yang diisi,`\n` untuk membuat baris baru
Angka	"12345"	Mendukung bilangan bulat dan desimal
Tanggal	"2025-01-01"	Format default adalah yyyy-MM-dd Mendukung format yang ditentukan: yyyy年MM月dd日 yyyy-MM-dd yyyy/MM/dd dd.MM.yyyy MM dd,yyyy dd MM yyyy
Pilihan tunggal	"1"	Diurutkan mulai dari 0,`0`mewakili pilihan 1,`1`mewakili pilihan 2....
Pilihan ganda	"[0,1,2]"	Diurutkan mulai dari 0,`0`mewakili pilihan 1,`1`mewakili pilihan 2....
Centang	"0" 、"1"、"2"	`0` - Tidak dipilih `1` - Dipilih ✓ `2` - Dicoret ✗ (perlu mengaktifkan opsi "Izinkan dicoret" di konfigurasi templat)
Pilihan tarik-turun	"0"	Diurutkan mulai dari 0,`0`mewakili opsi 1,`1`mewakili opsi 2....
Gambar	"URL"	Perlu mengunggah tautan gambar
Tabel dinamis	[{\"row\":{\"column1\":\"具体内容\"}},{\"row\":{\"column1\":\"具体内容\"}},{\"insertRow\":\"true\",\"row\":{\"column1\":\"Mike\"}}]	row adalah data baris dalam tabel dinamis, jumlah row adalah jumlah baris tabel yang ditambahkan saat membuat tabel dinamis. column1 dalam row adalah nilai Key sel pada kolom column1 di baris saat ini, column2 adalah nilai Key sel pada kolom column2.
Email	"123456@XX.com"	Alamat email