Ir para o conteúdo

Conector Shopify

Resumo

O conector Shopify estabelece acesso ao Shopify.

O conector Shopify fornece uma interface para criar uma conexão Shopify, a base usada 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 da paleta de componentes de design (consulte paleta de componentes de design).

Visão Geral do Conector

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

Juntas, uma conexão específica do Shopify e suas atividades são chamadas de endpoint do Shopify:

Tipos de atividade do Shopify

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

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

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

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

  • Excluir: Exclui dados de objeto do Shopify e deve ser usado como alvo em uma operação.

Nota

Este conector é um Connector SDK, que pode ser referenciado pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.

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 usa a API REST Admin do Shopify versão 2022-04, 2023-01, 2023-04, 2023-07, 2023-10, 2024-01, 2024-04 ou 2024-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

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

O Shopify pode descontinuar certos endpoints com a introdução de uma nova versão da API. Como resultado, você pode precisar alterar seus aplicativos e configurações de atividade devido a recursos alterados ou aposentados.

Versões de API obsoletas e endpoints são anunciados no registro de alterações do Shopify, onde quaisquer detalhes adicionais e quaisquer informações relevantes sobre migração estão disponíveis.

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 obter mais informações sobre o limite de taxa, consulte Limites de taxa da API de administração REST do Shopify.

Solução de Problemas

Se você tiver problemas com o conector do Shopify, estas etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar na configuração de 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 da organização Desativar atualização automática do conector).

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

  3. Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode habilitar conector verbose logging para este conector usando esta entrada de configuração específica de nome e nível do registrador:

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

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