Gunakan API VTAP untuk akses data, pengambilan, dan pembaruan yang mudah!

API VTAP menawarkan fungsi hebat yang memungkinkan Anda mengambil data, memperbarui catatan, mengubah data, dll.

Dengan API VTAP, pengembang dapat dengan mudah melakukan tugas-tugas seperti pengambilan dan pembaruan data, memastikan integrasi yang lancar dan manajemen data yang efisien dalam lingkungan CRM.

Misalnya, Anda dapat mengambil catatan khusus pengguna dengan detail lengkap tentang pengguna yang saat ini login, yang memberikan akses ke informasi penting seperti preferensi pengguna, peran, dan izin. Anda juga dapat memperbarui detail kontak atau data CRM lainnya secara real-time.

Dalam edisi ini, kami memberikan dua contoh berikut:

  • Bagaimana cara mengambil rincian pengguna yang saat ini masuk menggunakan VTAP API?
  • Bagaimana cara mengambil rincian Manajemen Pajak (seperti Pajak, Biaya, dan Wilayah Pajak) untuk modul Inventaris menggunakan API VTAP?

Mari kita lihat.

Contoh 1: Menampilkan tombol berdasarkan peran pengguna.

 

  
var Contacts_Component_ListViewExamples = VTAP.Component.Core.extend({
    created() {
        var userInfo = VTAP.User();
        var userRole = userInfo.roleid.label;


        // Define the roles allowed to view the button
        var allowedRoles = ['CEO','Sales Manager'];
        if (allowedRoles.includes(userRole)) {
            VTAP.Component.Register('LIST_BASIC_BUTTON', {
                label: 'Custom Page',
                clickHandler: () => {
                    window.location.href = " ";  
                },
                icon: 'fa-check',
                variant: 'primary'
            });
        }
    }
});




  
var Contacts_Component_ListViewExamples = VTAP.Component.Core.extend({
    created() {
        var userInfo = VTAP.User();
        var userRole = userInfo.roleid.label;


        // Define the roles allowed to view the button
        var allowedRoles = ['CEO','Sales Manager'];
        if (allowedRoles.includes(userRole)) {
            VTAP.Component.Register('LIST_BASIC_BUTTON', {
                label: 'Custom Page',
                clickHandler: () => {
                    window.location.href = " ";  
                },
                icon: 'fa-check',
                variant: 'primary'
            });
        }
    }
});

Note: Anda akan mendapatkan peran pengguna dari VTAP.user() (info pengguna). Berdasarkan peran pengguna, Anda dapat membatasi tombol seperti tampilkan/sembunyikan.

Contoh 2 - Bagaimana cara mengambil rincian Manajemen Pajak (seperti Pajak, Biaya, dan Wilayah Pajak) untuk modul Inventaris menggunakan VTAP API?

Gunakan Describe Core API untuk mengambil informasi terperinci tentang modul inventaris tertentu. Misalnya, gunakan Describe Core API untuk mengambil informasi terperinci tentang modul Quotes.

 

  
VTAP.Api.Get("describe", { 
    "module": "Quotes", 
}, (error, response) => {
    if (error) {
        console.error("Error:", error);
    } 
});




  
VTAP.Api.Get("describe", { 
    "module": "Quotes", 
}, (error, response) => {
    if (error) {
        console.error("Error:", error);
    } 
});

Note:

  • Dalam respons API, semua informasi yang terkait dengan biaya dan pajak dapat ditemukan di bawah kunci chargesAndItsTaxes.
  • Dalam respons API, informasi yang terkait dengan wilayah pajak dapat ditemukan di bawah kunci tax_regions.

Contoh 3 - Bagaimana cara memperbarui kolom blok Baris Item Inventaris Biaya dan Diskon Keseluruhan?

3a. Bagaimana cara memperbarui biaya menggunakan VTAP API?

Ikuti langkah-langkah berikut untuk memperbarui biaya:

  • Ambil rekaman menggunakan metode VTAP.API.GET.
  • Akses objek chargesAndItsTaxes dalam respons dan identifikasi setiap biaya.
  • Ubah nilai kunci untuk setiap biaya dalam objek chargesAndItsTaxes.
  • Kirim objek yang diperbarui dalam permintaan Vtap.API.put, pastikan Anda menyertakannya di bawah kunci biaya.

Contoh untuk Biaya:

 

  
VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1:<product_id>,
        totalProductCount: 1,
        charges: {}
    }, (error, response) => {});




  
VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1:<product_id>,
        totalProductCount: 1,
        charges: {}
    }, (error, response) => {});

3b. Bagaimana cara memperbarui Diskon Keseluruhan menggunakan VTAP API?

Diskon Keseluruhan bisa berupa jumlah langsung atau persentase sehingga kami perlu mengirimkan jenis diskon beserta jumlah diskon.

Contoh untuk Diskon Keseluruhan jenis jumlah:

 

  
VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1: 490,
        totalProductCount: 1,
        discount_amount_final: 500,
        discount_type_final: 'amount',
    }, (error, response) => {});




  
VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1: 490,
        totalProductCount: 1,
        discount_amount_final: 500,
        discount_type_final: 'amount',
    }, (error, response) => {});

Contoh untuk Diskon Keseluruhan jenis persentase:

 

  
VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1: 490,
        totalProductCount: 1,
        discount_percentage_final: 10,
        discount_type_final: 'percentage',
    }, (error, response) => {});




  
VTAP.Api.Put('records', {
        module: 'Quotes',
        id: VTAP.Detail.Id(),
        hdnProductId1: 490,
        totalProductCount: 1,
        discount_percentage_final: 10,
        discount_type_final: 'percentage',
    }, (error, response) => {});

Kami yakin contoh-contoh ini akan meningkatkan pengalaman Anda dengan API VTAP, memastikan Anda memperoleh data yang Anda butuhkan. Nantikan informasi lebih lanjut.

Selamat coding!
 
 

Daftar untuk menerima pembaruan terbaru!

 
 

Hak Cipta 2026 Vtiger. Seluruh hak cipta. Berbagai merek dagang dipegang oleh pemiliknya masing-masing.