Saltar al contenido

Conector VTEX para Jitterbit Integration 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.

El conector VTEX se accede desde la pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza primero para configurar una conexión VTEX. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que están destinadas a ser utilizadas como fuentes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

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

Tipos de actividades VTEX

  • Leer: Recupera datos de objetos de VTEX y está destinado a ser utilizado como fuente en una operación.

  • Upsert: Actualiza datos de objetos existentes o crea nuevos datos de objetos en VTEX y está destinado a ser utilizado como destino en una operación.

  • Crear: Crea datos de objetos en VTEX y está destinado a ser utilizado como destino en una operación.

  • Actualizar: Actualiza datos de objetos en VTEX y está destinado a ser utilizado como destino en una operación.

  • Eliminar: Elimina datos de objetos de VTEX y está destinado a ser utilizado como destino en una operación.

Nota

Este conector es un conector basado en Connector SDK, que puede ser mencionado por Jitterbit al comunicar cambios realizados en conectores construidos con el Connector SDK.

Requisitos y versiones de API soportadas

El conector VTEX requiere el uso de una versión de agente 10.1 o posterior. Estas versiones de agente descargan automáticamente la última versión del conector cuando es necesario.

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

Se requiere una clave de aplicación y un token de aplicación 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 Obtener cuenta por identificador (clave de Get_Account_By_Identifier).

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

ID Nombre del rol
44029 ADM COMPLETO
1129 Admin - Solo página de inicio
14033 Admin CRM
14716 Admin Almacenamiento Dinámico
15885 Admin Lista de Regalos
18053 Admin Portal
20980 Admin SuperV2 (Catálogo - Acceso completo)
23429 Admin Renderizado de Plantillas
5226 Facturación
51 Logística - Acceso completo
46 OMS - Acceso completo
1 Propietario (Admin Super)
33577 Pago - Administrador

Limitaciones

Limitaciones de la API de VTEX

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

  • La actividad VTEX Leer no puede recuperar precios personalizados del objeto Simulación de Precios.

Limitaciones del conector VTEX

El objeto Gestión de Ofertas de VTEX actualmente no soporta las operaciones API de Cerrar interacción y crear registro. Estas operaciones API son soportadas a través del conector HTTP de Harmony.

Solución de Problemas

Si experimentas problemas con el conector VTEX, se recomiendan los siguientes pasos de solución de problemas:

  1. Haz clic en el botón Probar en la configuración de conexión para asegurarte de que la conexión sea exitosa y de que la última versión del conector se haya descargado al agente (a menos que estés utilizando la política de organización Deshabilitar Actualización Automática del Conector).

    Nota

    Si recibes el error No tienes permiso para acceder a este recurso, asegúrate de que el perfil de acceso del token de la aplicación incluya la función de Administrador de Licencias con acceso al recurso Obtener cuenta por identificador.

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

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

  4. Si utilizas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registro 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 de conectores, consulte Registro detallado para conectores que utilizan agentes privados de Jitterbit.

  1. Si se utilizan agentes privados, puede consultar los registros de agentes para obtener más información.

  2. Para consideraciones adicionales de solución de problemas, consulte Solución de problemas de operación.