¡Utilice las API de VTAP para acceder a datos, recuperarlos y actualizarlos sin esfuerzo!

Las API de VTAP ofrecen funciones potentes que le permiten recuperar datos, actualizar registros, cambiar datos, etc.

Con las API de VTAP, los desarrolladores pueden realizar fácilmente tareas como recuperación y actualizaciones de datos, lo que garantiza una integración fluida y una gestión de datos eficiente dentro del entorno de CRM.

Por ejemplo, puede obtener registros específicos de usuarios con detalles completos sobre el usuario que ha iniciado sesión en ese momento, lo que le otorga acceso a información vital, como preferencias, roles y permisos del usuario. También puede actualizar los detalles de contacto u otros datos de CRM en tiempo real.

En esta edición damos los dos ejemplos siguientes:

  • ¿Cómo recuperar los detalles de un usuario actualmente conectado usando la API VTAP?
  • ¿Cómo recuperar detalles de gestión de impuestos (como impuestos, cargos y regiones impositivas) para un módulo de inventario utilizando la API VTAP?

Echemos un vistazo.

Ejemplo 1: Mostrar un botón según los roles de los usuarios.


  

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'

            });

        }

    }

});

Nota:Obtendrá el rol del usuario desde VTAP.user() (información del usuario). Según el rol del usuario, puede restringir el botón, como mostrar u ocultar.

Ejemplo 2: ¿Cómo recuperar detalles de gestión de impuestos (como impuestos, cargos y regiones impositivas) para un módulo de inventario mediante la API de VTAP?

Utilice la API Describe Core para recuperar información detallada sobre un módulo de inventario específico. Por ejemplo, utilice la API Describe Core para obtener información detallada sobre el módulo Cotizaciones.


  

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

    } 

});

Nota :

  • En la respuesta de la API, toda la información relacionada con cargos e impuestos se puede encontrar bajo la clave chargesAndItsTaxes.
  • En la respuesta de la API, la información relacionada con las regiones fiscales se puede encontrar bajo la clave tax_regions.

Ejemplo 3: ¿Cómo actualizar los campos de bloque de línea de artículo de inventario Cargos y Descuento general?

3a. ¿Cómo actualizar los cargos mediante la API VTAP?

Siga estos pasos para actualizar los cargos:

  • Recupere el registro utilizando el método VTAP.API.GET.
  • Acceda al objeto chargesAndItsTaxes en la respuesta e identifique cada cargo.
  • Modifique el valor de la clave para cada cargo dentro del objeto chargesAndItsTaxes.
  • Envíe el objeto actualizado en la solicitud Vtap.API.put, asegurándose de incluirlo bajo la clave de cargos.

Ejemplo de cargos:


  

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. ¿Cómo actualizar el descuento general mediante la API de VTAP?

El descuento general es un monto directo o un porcentaje, por lo que debemos enviar el tipo de descuento junto con el monto del descuento.

Ejemplo de descuento general de tipo importe:


  

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

Ejemplo de descuento general de tipo porcentaje:


  

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

Creemos que estos ejemplos mejorarán su experiencia con las API de VTAP y le permitirán recuperar exactamente los datos que necesita. Esté atento para obtener más información.

¡Feliz codificación!

 
 

¡Regístrese para recibir las últimas actualizaciones!