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:
-
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:
-
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. -
Revisa los registros de operaciones para cualquier información escrita durante la ejecución de la operación.
-
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.
-
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.
-
Si se utilizan agentes privados, puede consultar los registros de agentes para obtener más información.
-
Para consideraciones adicionales de solución de problemas, consulte Solución de problemas de operación.