Ir para o conteúdo

Conector Square para Jitterbit Studio

Resumo

O conector Square fornece uma interface para inserir informações fornecidas pelo usuário, como credenciais, para criar uma conexão autenticada com o Square. Essa conexão fornece a base para configurar atividades associadas ao conector Square que interagem com a conexão. Juntas, uma conexão específica do Square e suas atividades são referidas como um endpoint Square.

Nota

Este conector suporta o objeto Customers na API do Square. Para interagir com objetos adicionais, como o Catalog, Customers, Inventory, Invoices, Orders, Payments, Subscriptions e Terminal, use o conector Square v2.

Dica

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

Versões de API suportadas e pré-requisitos

O conector Square utiliza a API REST do Square. Consulte a documentação da API para obter informações sobre os campos do esquema.

O conector Square 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.

Visão geral do conector

Este conector é usado para primeiro configurar uma conexão com o Square, estabelecendo acesso ao Square, e depois é utilizado para configurar uma ou mais atividades do Square associadas a essa conexão como fonte ou destino dentro de uma operação:

  • Atividade de Consulta: Recupera clientes de uma conexão com o Square e é usada como fonte em uma operação.

  • Atividade de Criação: Cria novos clientes em uma conexão com o Square e é usada como destino em uma operação.

  • Atividade de Atualização: Atualiza clientes existentes em uma conexão com o Square e é usada como destino em uma operação.

  • Atividade de Exclusão: Exclui clientes existentes de uma conexão com o Square e é usada como destino em uma operação.

O conector do Square utiliza a API REST do Square. Consulte a documentação da API para informações sobre os campos do esquema.

O conector do Square requer o uso de uma versão do agente 10.1 ou superior.

Juntas, uma conexão específica do Square e suas atividades são referidas como um endpoint do Square. Uma vez que uma conexão é configurada, as atividades associadas ao endpoint estão disponíveis no filtro Endpoints:

Aba Conexões

Nota

Este conector é um conector baseado no SDK de Conector, que pode ser mencionado pela Jitterbit ao comunicar alterações feitas em conectores construídos com o SDK de Conector.

Endpoints criados com este conector estão incluídos na reportagem de uso de endpoints e contam para sua licença.

Registro no Square

Como a conexão será um aplicativo que interage com o Square, você precisará de um Token de Acesso Pessoal para acessar o servidor do Square. Consulte Registro no Square para detalhes.

Acessando o conector

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

Atividades

Solução de problemas

Se você encontrar problemas com o conector Square, os seguintes passos de solução de problemas são recomendados:

  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.verbose.logging.square" level="DEBUG"/>
    

    Para mais informações sobre o registro detalhado do conector, veja 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, veja Solução de problemas de operação.