Conectando-se ao Coupa

Editar online

A Coupa é uma plataforma de gestão de despesas empresariais baseada na nuvem que permite gerenciar e analisar as despesas da empresa nas áreas de compras, cadeia de suprimentos e finanças.

Para integrar o Coupa com o IBM watsonx Orchestrate, é necessário estabelecer uma conexão segura que permita que ambos os sistemas se comuniquem sem interrupções. Para obter orientações gerais sobre como gerenciar integrações, consulte " Conectando aplicativos para agentes pré-configurados ".

Importante:

Por padrão, o Single Sign-On (SSO) está desativado para o seu aplicativo. Para ativar essa função, consulte a seção “Configuração do logon único para aplicativos ”.

Passos para conectar

Siga estas etapas para conectar o Coupa ao watsonx Orchestrate :

Vá para Gerenciar > Conexões e procure o ID da conexão Coupa.
Clique em editar ao lado do ID da conexão correspondente.
Selecione o método de autenticação que sua organização utiliza ( OAuth2.0 ou Key Value Pair ).
Insira os campos específicos da Coupa. Consulte a página “Conectando aplicativos a agentes pré-configurados” para obter informações sobre o fluxo de trabalho geral de conexão.
Conclua as etapas de configuração do Draft e Live.
Salve a conexão e teste-a para confirmar que o Coupa está conectado com sucesso.

Métodos de autenticação suportados

O Coupa oferece suporte aos seguintes métodos de autenticação no watsonx Orchestrate :

OAuth 2.0 (Código de autorização) : Recomendado para conexões de produção
Par chave-valor (KVP) : compatível com cenários baseados em chave API e legados

Nota:

Para agentes criados após setembro de 2025, OAuth 2.0 é a única forma de autenticação compatível com o Coupa.

ID da conexão

Use os seguintes IDs de conexão ao localizar sua conexão Coupa na página de configurações de conexões. Para entender como procurar um ID de conexão e abrir uma conexão para edição, consulte Conectando aplicativos para agentes pré-construídos.


Tipo de autenticação	ID da conexão
OAuth2 Código de autorização	```coupa_oauth2_auth_code_ibm_184bdbd3```
Par chave-valor	```coupa_key_value_ibm_184bdbd3``` (obsoleto)

OAuth 2.0 detalhes da conexão

Se sua organização usa autenticação baseada em OAuth, defina o Tipo de autenticação como Código de autorização OAuth2 e preencha os seguintes campos:


Campo	Descrição
`server_url`	A base URL de sua instância Coupa
`authorization_url`	O endereço URL para redirecionar os usuários para login e autorização
`token_url`	O ponto de extremidade para trocar o código de autorização por um token de acesso
`client_id`	O ID do cliente de seu aplicativo Coupa
`client_secret`	O segredo do cliente de seu aplicativo Coupa
`scope`	As permissões de que seu aplicativo precisa (por exemplo, `core.read core.write`) - consulte a documentação da Coupa para obter os escopos válidos

Para obter esses valores, consulte a documentação da API da Coupa.

Detalhes da conexão do par chave-valor

Se sua organização usa chaves API ou uma configuração legada, defina o Tipo de autenticação como Par chave-valor e adicione cada um dos seguintes campos usando Adicionar novo campo :


Chave	Descrição
`base_url`	A base URL de sua instância Coupa
`token_url`	O URL usado para obter o token OAuth
`client_id`	O ID do cliente de seu aplicativo Coupa
`client_secret`	O segredo do cliente de seu aplicativo Coupa

Observação : ao usar o par chave-valor, apenas credenciais de equipe são suportadas.

Para obter esses valores, consulte a documentação da API da Coupa.