Ir para o conteúdo

Conexão Coupa

Introdução

Uma conexão Coupa, criada usando o conector Coupa, estabelece acesso ao Coupa. Uma vez que uma conexão é configurada, você pode criar instâncias de atividades Coupa associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

Este conector suporta a Habilitar Reautenticação em Caso de Mudança política organizacional. Se habilitado, uma mudança no Nome do Host ou ID do Cliente nesta conexão requer que os usuários reentrem a Chave da API ou Segredo do Cliente (dependendo do Tipo de Autenticação selecionado) para a conexão.

Criar ou editar uma conexão Coupa

Uma nova conexão Coupa é criada usando o conector Coupa a partir de uma destas localizações:

Uma conexão Coupa existente pode ser editada a partir destas localizações:

Configurar uma conexão Coupa

Cada elemento da interface do usuário da tela de configuração da conexão Coupa é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão Coupa e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint Coupa, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Nome do Host: Insira a URL do host Coupa, no formato https://<instance_name>.<host_name>.com.

  • Tipo de Autenticação: Selecione o tipo de autenticação, seja X-COUPA-API-KEY (Depreciado) ou OAuth 2.0.

    • X-COUPA-API-KEY (Depreciado): Quando selecionado, o campo API key fica visível:

      • API key: Insira a chave da API para a instância Coupa.

        Atenção

        A partir da versão R35 do Coupa (janeiro de 2023), as chaves da API Coupa estão depreciadas e não são mais suportadas para autenticação. Se utilizadas, um erro Forbidden (403) é esperado.

    • OAuth 2.0: Quando selecionado, os seguintes campos ficam visíveis:

      • Client ID: Insira o client ID para a instância Coupa.

      • Client Secret: Insira o client secret para a instância Coupa.

  • Tipo de Concessão: A opção Credenciais do Cliente é preenchida automaticamente como o tipo de concessão.

  • Escopo: Insira uma lista separada por espaços de escopos que o aplicativo requer (opcional).

  • Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar configurações de proxy do agente privado.

  • Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política organizacional Desativar Atualização Automática do Conector.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para confirmar que você deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para confirmar que você deseja excluir a conexão.

Próximas etapas

Após uma conexão Coupa ter sido criada, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis a partir do painel do projeto e da paleta de componentes de design. Para mais detalhes, veja Menus de ações em Noções básicas sobre conectores.

Estes tipos de atividade estão disponíveis:

  • Consulta: Consulta dados de objetos no Coupa e é destinado a ser usado como uma fonte em uma operação.

  • Criar: Cria dados de objetos no Coupa e é destinado a ser usado como um alvo em uma operação.

  • Atualizar: Atualiza dados de objetos no Coupa e é destinado a ser usado como um alvo em uma operação.