Sử dụng API VTAP để truy cập, tìm kiếm và cập nhật dữ liệu dễ dàng!

API VTAP cung cấp các chức năng mạnh mẽ cho phép bạn truy xuất dữ liệu, cập nhật hồ sơ, thay đổi dữ liệu, v.v.

Với API VTAP, các nhà phát triển có thể dễ dàng thực hiện các tác vụ như truy xuất và cập nhật dữ liệu, đảm bảo tích hợp trơn tru và quản lý dữ liệu hiệu quả trong môi trường CRM.

Ví dụ, bạn có thể lấy các bản ghi cụ thể của người dùng với thông tin chi tiết toàn diện về người dùng hiện đang đăng nhập, cấp quyền truy cập vào thông tin quan trọng như sở thích, vai trò và quyền của người dùng. Bạn cũng có thể cập nhật thông tin liên hệ hoặc dữ liệu CRM khác theo thời gian thực.

Trong phiên bản này, chúng tôi đưa ra hai ví dụ sau:

  • Làm thế nào để lấy thông tin chi tiết của người dùng hiện đang đăng nhập bằng API VTAP?
  • Làm thế nào để lấy thông tin chi tiết về Quản lý thuế (như Thuế, Phí và Khu vực thuế) cho mô-đun Hàng tồn kho bằng API VTAP?

Hãy để chúng tôi xem xét.

Ví dụ 1: Hiển thị nút dựa trên vai trò của người dùng.

 

  
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'
            });
        }
    }
});

Lưu ý: Bạn sẽ lấy được vai trò của người dùng từ VTAP.user() (thông tin người dùng). Dựa trên vai trò người dùng, bạn có thể hạn chế nút như hiển thị/ẩn.

Ví dụ 2 - Làm thế nào để lấy thông tin chi tiết về Quản lý thuế (như Thuế, Phí và Khu vực thuế) cho mô-đun Hàng tồn kho bằng API VTAP?

Sử dụng API Describe Core để lấy thông tin chi tiết về một mô-đun hàng tồn kho cụ thể. Ví dụ: sử dụng API Describe Core để lấy thông tin chi tiết về mô-đun 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);
    } 
});

Lưu ý:

  • Trong phản hồi API, mọi thông tin liên quan đến phí và thuế đều có thể được tìm thấy trong khóa chargesAndItsTaxes.
  • Trong phản hồi API, thông tin liên quan đến vùng thuế có thể được tìm thấy trong khóa tax_regions.

Ví dụ 3 - Làm thế nào để cập nhật các trường khối Mục hàng tồn kho là Phí và Chiết khấu tổng thể?

3a. Làm thế nào để cập nhật phí bằng API VTAP?

Thực hiện theo các bước sau để cập nhật phí:

  • Truy xuất bản ghi bằng phương thức VTAP.API.GET.
  • Truy cập đối tượng chargesAndItsTaxes trong phản hồi và xác định từng khoản phí.
  • Sửa đổi giá trị khóa cho mỗi khoản phí trong đối tượng chargesAndItsTaxes.
  • Gửi đối tượng đã cập nhật trong yêu cầu Vtap.API.put, đảm bảo rằng bạn bao gồm nó trong khóa phí.

Ví dụ về Phí:

 

  
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. Làm thế nào để cập nhật Tổng chiết khấu bằng API VTAP?

Tổng chiết khấu có thể là số tiền trực tiếp hoặc phần trăm nên chúng tôi cần gửi loại chiết khấu cùng với số tiền chiết khấu.

Ví dụ về Chiết khấu tổng thể của loại số tiền:

 

  
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) => {});

Ví dụ về Chiết khấu tổng thể theo loại phần trăm:

 

  
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) => {});

Chúng tôi tin rằng những ví dụ này sẽ cải thiện trải nghiệm của bạn với API VTAP, đảm bảo bạn lấy được chính xác dữ liệu bạn cần. Hãy theo dõi để biết thêm.

Chúc bạn viết mã vui vẻ!
 
 

Đăng ký để nhận thông tin cập nhật mới nhất!

 
 

Bản quyền 2026 Vtiger. Đã đăng ký Bản quyền. Nhãn hiệu khác nhau được tổ chức bởi chủ sở hữu tương ứng của họ.