Ir para o conteúdo

Conector Shopify no Jitterbit Studio

Resumo

O conector Shopify estabelece acesso ao Shopify.

O conector Shopify fornece uma interface para criar uma conexão Shopify, 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 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 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 referenciado pelo 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.

Este conector suporta autenticação OAuth 2.0 de 3 etapas para versões de agente 10.83 / 11.21 ou posteriores. Para usar a autenticação OAuth, pré-requisitos adicionais são necessários.

O conector Shopify utiliza a versão da Shopify REST Admin API selecionada em uma conexão Shopify. Dependendo dos endpoints da API suportados pelo Shopify na versão da API em uso, os objetos e sub-objetos disponíveis para seleção podem variar. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

Importante

O 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, o 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.

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

API versões e endpoints obsoletos são anunciados no changelog do 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 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 API REST Admin do Shopify.

Solução de problemas

Se você encontrar problemas com o conector do 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 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 solução de problemas, veja Solução de problemas de operação.