Conector Square para Jitterbit Integration Studio
Resumo
O conector Square fornece uma interface para inserir informações fornecidas pelo usuário entrada, como credenciais, para criar uma conexão autenticada do 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 chamadas de endpoint do Square.
Nota
Este conector suporta Clientes objeto na API do Square. Para interagir com objetos adicionais, como o Catálogo, Clientes, Inventário, Faturas, Pedidos, Pagamentos, Assinaturas e Terminal objetos, 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 usa a API REST do Square. Consulte a API documentação para obter informações sobre os campos do esquema.
O conector Square requer o uso de uma versão de 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 Square, estabelecendo acesso a Square e, em seguida, usado para configurar uma ou mais atividades do Square associadas a essa conexão como fonte ou alvo dentro de uma operação:
-
Atividade de Consulta: Recupera clientes de uma conexão Square e é usado como fonte em uma operação.
-
Criar atividade: Cria novos clientes em uma conexão Square e é usado como alvo em uma operação.
-
Atualizar atividade: Atualiza os clientes existentes em uma conexão Square e é usado como alvo em uma operação.
-
Excluir atividade: Exclui clientes existentes de uma conexão Square e é usado como alvo em uma operação.
O conector Square usa 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 de agente 10.1 ou mais tarde.
Juntos, uma conexão específica do Square e suas atividades são chamadas de endpoint do Square. Uma vez uma conexão é configurada, as atividades associadas ao endpoint estão disponíveis no filtro Endpoints:
Nota
Este conector é um Connector SDK, que pode ser consultado pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.
Registro Square
Como a conexão será um aplicativo que faz interface com o Square, você precisará de um Token de Acesso Pessoal para acesse o servidor Square. Veja Registro Square para mais detalhes.
Acessando o conector
O conector Square é acessado na aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
Solução de problemas
Se você tiver problemas com o conector Square, estas etapas de solução de problemas são recomendadas:
-
Clique no botão Testar na configuração de 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 Desativar atualização automática do conector política da organização).
-
Verifique os registros de operação para qualquer informação escrita durante a execução da operação.
-
Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.
-
Se estiver usando agentes privados, você pode habilitar registro detalhado do conector para este conector adicionando esta entrada de configuração do registrador ao do seu agente privado
logback.xml
arquivo:<logger name="org.jitterbit.connector.verbose.logging.square" level="DEBUG"/>
Para obter mais informações sobre o registro detalhado de conectores, consulte Registro detalhado para conectores que usam agentes privados Jitterbit.
-
Se estiver usando agentes privados, você pode verificar os registros do agente para obter mais informações.
-
Para considerações adicionais sobre solução de problemas, consulte Solução de problemas de operação.