Conector VTEX en Jitterbit Studio

Resumen

El conector VTEX establece acceso a VTEX.

El conector VTEX proporciona una interfaz para crear una conexión VTEX, la base utilizada para generar instancias de actividades VTEX. Estas actividades, una vez configuradas, interactúan con VTEX a través de la conexión.

Se accede al conector VTEX desde la pestaña Puntos finales del proyecto y conectores de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza para configurar primero una conexión VTEX. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que se pretende utilizar como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión VTEX específica y sus actividades se denominan punto final VTEX:

• Leer: Recupera datos de objetos de VTEX y está diseñado para usarse como origen en una operación.

• Actualizar o crear: Actualiza datos de objetos existentes o crea nuevos datos de objetos en VTEX y está diseñado para usarse como destino en una operación.

• Crear: Crea datos de objetos en VTEX y está diseñado para usarse como destino en una operación.

• Actualizar: Actualiza datos de objetos en VTEX y está diseñado para usarse como destino en una operación.

• Eliminar: Elimina datos de objetos de VTEX y está diseñado para usarse como destino en una operación.

Los puntos finales creados con este conector se incluyen en reportes de uso de puntos finales y cuentan para tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede utilizar con agentes en la nube y agentes privados.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Disable Auto Connector Update.

El conector VTEX utiliza la API REST de VTEX. Consulta la documentación de la API para obtener información sobre los nodos de esquema y los campos.

Se requiere una clave de aplicación y un token de aplicación de VTEX para configurar una conexión VTEX.

Para una conexión VTEX exitosa, el perfil de acceso del token de aplicación debe incluir el cliente License Manager con acceso al recurso Get account by identifier (clave de Get_Account_By_Identifier).

Para utilizar todas las actividades y objetos VTEX, se requieren los siguientes roles:

Limitaciones

Limitaciones de la API de VTEX

El conector de VTEX tiene estos problemas debido a limitaciones presentes en la API REST de VTEX:

• La actividad Read del conector de VTEX no puede recuperar precios personalizados del objeto Price Simulation.

Limitaciones del conector de VTEX

El objeto Offer Management de VTEX actualmente no admite las operaciones de API Close interaction y create log. Estas operaciones de API se admiten a través del conector HTTP de Harmony.

Solución de problemas

Si experimentas problemas con el conector de VTEX, se recomiendan estos pasos para la solución de problemas:

1. Haz clic en el botón Test en la configuración de conexión para asegurar que la conexión sea exitosa y para descargar la versión más reciente del conector en el agente (a menos que se use la política de organización Disable Auto Connector Update).

   Nota

   Si recibes el error You don't have permission to access this resource, asegúrate de que el perfil de acceso del token de aplicación incluya la característica License Manager con acceso al recurso Get account by identifier.

2. Revisa los registros de operación para obtener cualquier información escrita durante la ejecución de la operación.

3. Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

4. Si usas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de logger al archivo logback.xml de tu agente privado:

   <logger name="org.jitterbit.connector.vtex" level="DEBUG"/>
   

   Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores que usan agentes privados de Jitterbit.

5. Si usas agentes privados, puedes revisar los registros del agente para obtener más información.

6. Para consideraciones adicionales sobre la solución de problemas, consulta Solución de problemas de operación.

7. Para problemas y resoluciones específicos del conector de VTEX, consulta la guía Solución de problemas del conector:

   • La prueba de conexión falla con "You don't have permission to access this resource"