Conector VTEX no Jitterbit Studio

Resumo

O conector VTEX estabelece acesso à VTEX.

O conector VTEX fornece uma interface para criar uma conexão VTEX, a base utilizada para gerar instâncias de atividades VTEX. Essas atividades, uma vez configuradas, interagem com a VTEX através da conexão.

O conector VTEX é acessado pela aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão VTEX. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Em conjunto, uma conexão VTEX específica e suas atividades são chamadas de endpoint VTEX:

• Read: Recupera dados de objetos da VTEX e é destinada a ser usada como fonte em uma operação.

• Upsert: Atualiza dados de objetos existentes ou cria novos dados de objetos na VTEX e é destinada a ser usada como destino em uma operação.

• Create: Cria dados de objetos na VTEX e é destinada a ser usada como destino em uma operação.

• Update: Atualiza dados de objetos na VTEX e é destinada a ser usada como destino em uma operação.

• Delete: Exclui dados de objetos da VTEX e é destinada a ser usada como destino em uma operação.

Os endpoints criados com este conector são incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes em nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política de organização Disable Auto Connector Update.

O conector VTEX usa a VTEX REST API. Consulte a documentação da API para informações sobre os nós de esquema e campos.

Uma chave de aplicação e um token de aplicação VTEX são necessários para configurar uma conexão VTEX.

Para uma conexão VTEX bem-sucedida, o perfil de acesso do token de aplicação deve incluir o cliente License Manager com acesso ao recurso Get account by identifier (chave Get_Account_By_Identifier).

Para usar todas as atividades e objetos VTEX, as seguintes funções são necessárias:

Limitações

Limitações da API VTEX

O conector VTEX apresenta esses problemas devido a limitações presentes na VTEX REST API:

• A atividade Read do conector VTEX não consegue recuperar preços personalizados do objeto Price Simulation.

Limitações do conector VTEX

O objeto Offer Management do VTEX não suporta atualmente as operações de API Close interaction e create log. Essas operações de API são suportadas através do conector HTTP Harmony.

Solução de problemas

Se você enfrentar problemas com o conector VTEX, recomenda-se seguir estas etapas de solução de problemas:

1. Clique no botão Test na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política de organização Disable Auto Connector Update).

   Nota

   Se você receber o erro You don't have permission to access this resource, certifique-se de que o perfil de acesso do token de aplicação inclua o recurso License Manager com acesso ao recurso Get account by identifier.

2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

3. Ative o log de debug de operação (para agentes em nuvem ou para agentes privados) para gerar arquivos e dados de log adicionais.

4. Se estiver usando agentes privados, você pode ativar o log detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

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

   Para mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

5. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

6. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.

7. Para problemas e resoluções específicas do conector VTEX, consulte o guia Solução de problemas do conector:

   • Teste de conexão falha com "You don't have permission to access this resource"