Conector Square para Jitterbit Integration Studio

Resumo

O conector Square 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 ao conector Square que interagem com a conexão. Juntas, uma conexão Square específica e suas atividades são chamadas de endpoint Square.

Nota

Este conector suporta os 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 de agente baixam automaticamente a última versão 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 Square específica e suas atividades são chamadas de endpoint 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 referenciado 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 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:

1. Clique no botão Testar na configuração de 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 você esteja usando a política da organização Desativar atualização automática do conector).

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 conector verbose logging para este conector usando esta entrada de configuração específica de nome e nível do registrador:

   <logger name="org.jitterbit.connector.verbose.logging.square" level="DEBUG"/>
   

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

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