Ir para o conteúdo

Conector Harmony Square

Resumo

O conector Square para Harmony Cloud Studio fornece uma interface para inserir dados fornecidos pelo usuário entrada como credenciais para criar uma conexão Square autenticada. Essa conexão fornece o fundação para configurar atividades associadas do conector Square que interagem com a conexão. Juntos, 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 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.

Versões e Pré-requisitos da API com Suporte

O conector Square usa a API REST 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 do agente 10.1 ou mais tarde. Essas versões do agente baixam automaticamente o 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 o acesso a Square e, em seguida, usado para configurar uma ou mais atividades do Square associadas a essa conexão como origem ou destino em 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 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 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:

aba Conexões

Nota

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

Cadastro Square

Como a conexão será um aplicativo que faz interface com o Square, você precisará de um Personal Access Token para acesse o servidor Square. Veja Registro Square para detalhes.

Acessando o Conector

O conector Square é acessado na aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).

Atividades

Solução de Problemas

Se você tiver problemas com o conector Square, estas 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 garantir que a versão mais recente do conector seja baixada para o agente (a menos que você use a Desativar atualização automática do conector política da organização).

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

  3. Habilite o registro de depurar de 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 registro detalhado do conector para este conector usando esta entrada de configuração específica de nome e nível do criador de logs:

    <logger name="org.jitterbit.connector.verbose.logging.square" level="DEBUG"/>
    
  5. Se estiver usando Agentes Privados, você pode verificar os logs do agente Para maiores informações.