Ir para o conteúdo

Conector VTEX para Jitterbit Integration Studio

Resumo

O conector VTEX estabelece acesso ao VTEX.

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

O conector VTEX é acessado na aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).

Visão geral do conector

Este conector é usado para primeiro configurar uma conexão VTEX. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que têm a intenção de ser usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).

Juntos, uma conexão VTEX específica e suas atividades são referidos como um endpoint VTEX:

Tipos de atividades VTEX

  • Ler: Recupera dados de objetos do VTEX e é destinado a ser usado como uma fonte em uma operação.

  • Upsert: Atualiza dados de objetos existentes ou cria novos dados de objetos no VTEX e é destinado a ser usado como um alvo em uma operação.

  • Criar: Cria dados de objetos no VTEX e é destinado a ser usado como um alvo em uma operação.

  • Atualizar: Atualiza dados de objetos no VTEX e é destinado a ser usado como um alvo em uma operação.

  • Excluir: Exclui dados de objetos do VTEX e é destinado a ser usado como um alvo em uma operação.

Nota

Este conector é um conector baseado no Connector SDK, que pode ser referido pela Jitterbit ao comunicar alterações feitas em conectores construídos com o Connector SDK.

Pré-requisitos e versões de API suportadas

O conector VTEX requer o uso de uma versão do agente 10.1 ou posterior. Essas versões do agente baixam automaticamente a versão mais recente do conector quando necessário.

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

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

Para uma conexão VTEX bem-sucedida, o perfil de acesso do token de aplicativo deve incluir o cliente Gerenciador de Licenças com acesso ao recurso Obter conta por identificador (chave de Get_Account_By_Identifier).

Para usar todas as atividades e objetos VTEX, os seguintes papéis são necessários:

ID Nome do papel
44029 ADM COMPLETO
1129 Admin - Apenas página inicial
14033 Admin CRM
14716 Admin Armazenamento Dinâmico
15885 Admin Lista de Presentes
18053 Admin Portal
20980 Admin SuperV2 (Catálogo - Acesso total)
23429 Admin Renderização de Template
5226 Faturamento
51 Logística - Acesso total
46 OMS - Acesso total
1 Proprietário (Admin Super)
33577 Pagamento - Administrador

Limitações

Limitações da API VTEX

O conector VTEX possui essas questões devido a limitações presentes na API REST VTEX:

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

Limitações do conector VTEX

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

Solução de Problemas

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

  1. Clique no botão Test na configuração da conexão para garantir que a conexão seja bem-sucedida e que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política organizacional Desativar Atualização Automática do Conector).

    Nota

    Se você receber o erro You don't have permission to access this resource, verifique se o perfil de acesso do token da aplicação inclui 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 registro de depuração da operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode ativar o registro 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 o registro detalhado do conector, consulte Registro detalhado para conectores usando agentes privados Jitterbit.

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

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