Ir para o conteúdo

Conector Shopify para Jitterbit Studio

Resumo

O conector Shopify estabelece acesso ao Shopify.

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

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

Dica

Receitas de integração e modelos de processo estão disponíveis para este conector através do Jitterbit Marketplace.

Visão geral do conector

Este conector é usado para primeiro configurar uma conexão Shopify. 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 Shopify específica e suas atividades são referidos como um endpoint Shopify:

Tipos de atividades do Shopify

  • Ler: Recupera todos os dados de objeto do Shopify e é destinado a ser usado como uma fonte em uma operação.

  • Consultar: Consulta dados de objeto especificados do Shopify e é destinado a ser usado como uma fonte em uma operação.

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

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

  • Excluir: Exclui dados de objeto do Shopify 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 pelo Jitterbit ao comunicar mudanças feitas em conectores construídos com o Connector SDK.

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

Pré-requisitos e versões de API suportadas

O conector Shopify 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 Shopify utiliza a Shopify REST Admin API nas versões 2022-04, 2023-01, 2023-04, 2023-07, 2023-10, 2024-01, 2024-04, 2024-07, 2024-10, 2025-01, 2025-04 ou 2025-07, dependendo da seleção em uma conexão Shopify. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

Importante

A Shopify lança uma nova versão da API a cada três meses e mantém cada versão lançada por um mínimo de doze meses. Uma vez que uma versão da API é descontinuada, a Shopify não manterá mais essa versão, e quaisquer chamadas de API solicitando essa versão serão automaticamente redirecionadas para a versão estável mais antiga atualmente suportada.

A Shopify pode descontinuar certos endpoints com a introdução de uma nova versão da API. Como resultado, pode ser necessário alterar suas configurações de aplicativos e atividades devido a recursos alterados ou aposentados.

Versões e endpoints da API descontinuados são anunciados no changelog da Shopify, onde estão disponíveis mais detalhes e informações relevantes sobre migração.

Limites de taxa

A Shopify REST Admin API impõe um limite de taxa de 40 solicitações por aplicativo por loja por minuto. Essa cota se repõe a uma taxa de 2 solicitações por segundo. O limite de taxa é aumentado para lojas Shopify Plus. Para mais informações sobre o limite de taxa, consulte limites de taxa da Shopify REST Admin API.

Solução de Problemas

Se você encontrar problemas com o conector Shopify, as seguintes etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar 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).

  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.shopify" level="DEBUG"/>

    Para mais informações sobre o registro detalhado do conector, consulte Registro 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.