Ir para o conteúdo

Conector Shopify para Jitterbit Integration 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 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 do painel de componentes de design (veja Painel 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 se destinam a 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 Shopify

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

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

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

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

  • Excluir: Exclui dados de objetos 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 mencionado pela Jitterbit ao comunicar alterações 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 sua licença.

Pré-requisitos e versões de API suportadas

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

O conector Shopify utiliza a versão 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 da Shopify REST Admin API, 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 direcionadas 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 API REST Admin do Shopify impõe um limite de taxa de 40 solicitações por aplicativo por loja por minuto. Essa cota é reabastecida 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 API REST Admin do Shopify.

Resolução de Problemas

Se você encontrar problemas com o conector do Shopify, as seguintes etapas de resoluçã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 para garantir que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política de organização 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 do Jitterbit.

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

  6. Para considerações adicionais de resolução de problemas, consulte Resolução de Problemas de Operação.