Utilizza le API VTAP per un accesso, un recupero e un aggiornamento dei dati senza sforzo!

Le API VTAP offrono potenti funzioni che consentono di recuperare dati, aggiornare record, modificare dati, ecc.

Grazie alle API VTAP, gli sviluppatori possono eseguire facilmente attività come il recupero e l'aggiornamento dei dati, garantendo un'integrazione fluida e una gestione efficiente dei dati nell'ambiente CRM.

Ad esempio, puoi recuperare record specifici dell'utente con dettagli completi sull'utente attualmente connesso, concedendo l'accesso a informazioni vitali come preferenze utente, ruoli e permessi. Puoi anche aggiornare i dettagli di contatto o altri dati CRM in tempo reale.

In questa edizione forniamo i due seguenti esempi:

  • Come recuperare i dettagli di un utente attualmente connesso tramite l'API VTAP?
  • Come recuperare i dettagli di gestione fiscale (ad esempio imposte, spese e regioni fiscali) per un modulo inventario utilizzando l'API VTAP?

Diamo uno sguardo.

Esempio 1: visualizzare un pulsante in base ai ruoli degli utenti.

 

  
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:: Otterrai il ruolo dell'utente da VTAP.user() (informazioni utente). In base al ruolo utente puoi limitare il pulsante come mostra/nascondi.

Esempio 2 - Come recuperare i dettagli di gestione fiscale (ad esempio imposte, spese e regioni fiscali) per un modulo inventario utilizzando l'API VTAP?

Utilizza la Describe Core API per recuperare informazioni dettagliate su uno specifico modulo di inventario. Ad esempio, utilizza la Describe Core API per recuperare informazioni dettagliate sul modulo 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::

  • Nella risposta API, tutte le informazioni relative a spese e tasse si trovano sotto la chiave chargesAndItsTaxes.
  • Nella risposta API, le informazioni relative alle regioni fiscali si trovano nella chiave tax_regions.

Esempio 3 - Come aggiornare i campi del blocco Articolo riga inventario Spese e Sconto complessivo?

3a. Come aggiornare gli addebiti utilizzando l'API VTAP?

Per aggiornare gli addebiti, segui questi passaggi:

  • Recupera il record utilizzando il metodo VTAP.API.GET.
  • Accedere all'oggetto chargesAndItsTaxes nella risposta e identificare ogni addebito.
  • Modificare il valore chiave per ogni addebito all'interno dell'oggetto chargesAndItsTaxes.
  • Invia l'oggetto aggiornato nella richiesta Vtap.API.put, assicurandoti di includerlo nella chiave charges.

Esempio per le spese:

 

  
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. Come aggiornare lo sconto complessivo utilizzando l'API VTAP?

Lo sconto complessivo è un importo diretto o una percentuale, pertanto dobbiamo inviare il tipo di sconto insieme all'importo dello sconto.

Esempio di sconto complessivo di tipo importo:

 

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

Esempio di sconto complessivo di tipo percentuale:

 

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

Crediamo che questi esempi miglioreranno la tua esperienza con le API VTAP, assicurandoti di recuperare esattamente i dati di cui hai bisogno. Resta sintonizzato per saperne di più.

Buona programmazione!
 
 

Iscriviti per ricevere gli ultimi aggiornamenti!

 
 

Copyright 2026 Vtiger. Tutti i diritti riservati. Vari marchi registrati dai rispettivi proprietari.