Ir para o conteúdo

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:

aba Conexões

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

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

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

  3. Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

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

  5. Se estiver usando agentes privados, você pode verificar os registros do agente para obter mais informações.

  6. Para considerações adicionais sobre solução de problemas, consulte Solução de problemas de operação.