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:

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).

Solução de problemas
Se você encontrar problemas com o conector Square, os seguintes passos de solução de problemas são recomendados:
-
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).
-
Verifique os logs de operação para qualquer informação registrada durante a execução da operação.
-
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.
-
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.xmldo 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.
-
Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.
-
Para considerações adicionais de solução de problemas, veja Solução de problemas de operação.