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:
-
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:
-
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. -
Verifique os logs de operação para qualquer informação registrada durante a execução da operação.
-
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.
-
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.
-
Se estiver usando agentes privados, você pode verificar os registros do agente para mais informações.
-
Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.